hacksalot / hackmyresume Goto Github PK

Description

I had an ampersand in a few places in my resume.json and discovered that the generated Word Document errs upon opening due to a corruption.

Steps

1. My resume.json can be found here: https://gist.github.com/pmbenjamin/b4ba2959bbd036f494a2#file-resume-v2-json (CTRL+F or CMD+F to search for & symbol).
2. hackmyresume build resume.json generates all documents successfully.
3. Opening the doc file throws error:

Illegal name character.
Location: Line: 15, Column: 1593

Resolution

1. Open doc file in a text editor
2. Go to location specified in error message (e.g. line 15, column: 1593)
3. Remove & and save.

I doubt that this is a fault of HackMyResume per se, but thought I should create an issue for it in case others encounter this.

Having author/copyright at the top of each file (even with the MIT designation) is a little aggressive for a wide-open open source project. Remove specific author names (= me) and make sure top-of-file stuff invites collaboration.

Eg, this is fine:

/**
Definition of the TemplateGenerator class.
@module template-generator.js
@license MIT. See LICENSE.md for details.
*/

New to node.js world, super excited to see this project and just getting feet wet. On Ubuntu 15.04 machine, trying to "render all" for the boilerplate richard hendriks resume.json from jsonresume.org site pops up this error.

$fluentcmd resume.json -o out/resume.all -t modern

--other error code above this--
at /home/foouser/.nvm/versions/node/v0.12.7/lib/node_modules/fluentcmd/node_modules/fluentlib/src/core/sheet.js:166:27
Generating HTML resume: out/resume.html
ERROR: Cannot read property 'toLowerCase' of undefined

TIA for any assistance. Googled around but nothin obvious. Looking forward to see where this project goes since I had trouble installing the jsonresume server when I tried to dockerize it and run on a remote server.

I filled the address and languages parts on the json file, but they don't show up when exporting to any format.

Is it possible to change that?

I think it would be nice to put this on the readme (if it's possible).

Great tool, btw :)

I was told I could export my CV as smoke signals but I can't seem to figure out how. Can anybody help? Is this a bug?

using my json file https://gist.github.com/morenoh149/36d2edf0844df7f319aa

and the following command hackmyresume BUILD resume.json TO out/resume.all -t positive

I get the following pdf http://harrymoreno.com/assets/harryMorenoResume.pdf

some hyperlinks are broken and show <a href="https://itunes.apple.com/us/app/temp/id1022731803">https://itunes.apple.com/us/app/temp/id1022731803</a> for example.

This isn't exactly an issue, but I couldn't figure out any other way to contact you.

I built a small docker container that pulls a resume.json file from the latest version of a gist, and uses your tool to turn them into different styles.

https://github.com/Quantumplation/resume-server/
https://hub.docker.com/r/quantumplation/resume-server/

Hi, I thought it would be nice to inform you that this post is on the front page of hacker news:
https://github.com/hacksalot/HackMyResume

cause that would be dope

It is not clear how to generate a LaTeX file, for the supported themes none generates a .tex file. Please add some documentation.

Currently if you do not have wkhtmltopdf installed, a node.js ENOENT is raised in the console. I think that this should be caught intelligently and a warning (by HackMyResume) should be raised warning the user that no PDF will be generated without this library, but everything else is fine and they shouldn't worry. Otherwise, it looks like the resume build has failed or the lib doesn't work...

Validate command exists with 0 status even if the resume is invalid. If the resume is invalid, a non-zero exit status should be used. For example:

This would mean that we could use hackmyresume as part of a CI pipeline so that the lazy ones among us cough me cough could just have CI build the resume and put it online automatically

wkhtmltopdf can return this error when there's no internet access:

events.js:85
      throw er; // Unhandled 'error' event

Error: Exit with code 1 due to network error: HostNotFoundError
    at Socket.<anonymous> (/dev/hmr/node_modules/wkhtmltopdf/index.js:79:17)
    at Socket.g (events.js:199:16)
    at Socket.emit (events.js:107:17)
    at readableAddChunk (_stream_readable.js:163:16)
    at Socket.Readable.push (_stream_readable.js:126:10)
    at Pipe.onread (net.js:538:20)

Respond to this gracefully and figure out why wkhtmltopdf is dialing home.

Given the version # > 1.0, are the themes stated on the description page assumed to be fully functional? I am getting:

1. strange alignment issues when I render contact info (name, phone, email, other links) for the themes positive and minimist in html. I have verified the json file against general and jsonresume schema.

2. Also apostrophe "s" is rendering as pure HTML I think. I.E. "Chairman's Council Award"

TIA

P.S. Haa, github is recogizing the html tag for question #2. after I save it. Suffice to say, when I build html , I get ampersand-number sign-pound-39.

I'm having an issue where a job listing, a personal business, started many years ago and is ongoing until the present. When I give it no end date it is sent to near the bottom rather than the top where I want it.

Is there a way to force the order or instead sort by end date where 'null' entries are first?

I don't know if I am posting this issue in the correct place but it seems The education details is not displayed on the final draft of the PDF:

It just returns the name and dates

education": [
    {
      "institution": "King Williams University",
      "area": "Brandonsberg",
      "studyType": "Bachelor",
      "startDate": "2009-01",
      "endDate": "2011-12",
      "gpa": "",
      "courses": [
        "Minors: Accounting 1, Economics 1, Management 1, Mathematics 102, Electrical Physics, Economics 202, Statistics 1D",
        "Majors: Computer Science and Information Systems"
      ]
    },

Add support for using YAML or XML, in addition to JSON, as the resume source format.

(YAML is almost as parse-friendly as JSON, with better in-editor readability, and XML is too common not to support.)

I tried running the standard --help command and got the following:

*** HackMyResume v1.3.1 ***
ERROR: Cannot read property 'warn' of undefined
TypeError: Cannot read property 'warn' of undefined
    at main (/usr/local/lib/node_modules/hackmyresume/src/index.js:59:44)
    at Object.<anonymous> (/usr/local/lib/node_modules/hackmyresume/src/index.js:27:3)
    at Module._compile (module.js:460:26)
    at Object.Module._extensions..js (module.js:478:10)
    at Module.load (module.js:355:32)
    at Function.Module._load (module.js:310:12)
    at Function.Module.runMain (module.js:501:10)
    at startup (node.js:129:16)
    at node.js:814:3

I realized after the fact that I should run hackmyresume help, but I don't think that should throw a Node error. Ideally, it should output something to the effect of --help is an invalid command. Did you mean 'help'?.

HMR automagically subs today for present/now/current @ fluent-date.js:32. That means my current job always ends this month.

I tried to use hackmyresume to generate a PDF resume.
So I installed wkhtmltopdf and created a new empty resume with

hackmyresume NEW resume.json

The I tried to build this resume with

hackmyresume BUILD resume.json TO out/resume.pdf

And I got the following error

*** HackMyResume v1.2.2 ***
Reading SOURCE resume: resume.json
Applying MODERN theme (7 formats)
Generating PDF resume: out/resume.pdf

events.js:72
        throw er; // Unhandled 'error' event
              ^
Error: loaded the Generic plugin
    at Socket.<anonymous> (/usr/lib/node_modules/hackmyresume/node_modules/wkhtmltopdf/index.js:79:17)
    at Socket.g (events.js:180:16)
    at Socket.emit (events.js:95:17)
    at Socket.<anonymous> (_stream_readable.js:765:14)
    at Socket.emit (events.js:92:17)
    at emitReadable_ (_stream_readable.js:427:10)
    at emitReadable (_stream_readable.js:423:5)
    at readableAddChunk (_stream_readable.js:166:9)
    at Socket.Readable.push (_stream_readable.js:128:10)
    at Pipe.onread (net.js:529:21)

Is it an error from hackmyresume ? Or is it only related to the wkhtmltopdf node module ?

Thanks !

I am unsure if this is correct for the JSON format.

"meta": {
  "format": "[email protected]",
  "version": "0.1.0"
}

Is it possible to modify the words used in each heading, such as "About", "Skills", etc? I would like to translate them to my native language.

Not sure whether this is a HackMyResume or jsonresume issue.

Thanks :)

Seems like a ton of feature overlap with Latex, pdf, text etc being the same options for org.

When using multiple sources on Windows 10 I receive the following error.

*** HackMyResume v1.2.2 ***
Reading SOURCE resume: .\basics.json
Reading SOURCE resume: .\education.json
ERROR: extend is not defined
ReferenceError: extend is not defined
    at C:\Users\Alex\AppData\Roaming\npm\node_modules\hackmyresume\src\verbs\generate.js:48:14
    at iterator (C:\Users\Alex\AppData\Roaming\npm\node_modules\hackmyresume\node_modules\underscore\underscore.js:184:16)
    at Function.<anonymous> (C:\Users\Alex\AppData\Roaming\npm\node_modules\hackmyresume\node_modules\underscore\underscore.js:199:14)
    at generate (C:\Users\Alex\AppData\Roaming\npm\node_modules\hackmyresume\src\verbs\generate.js:45:13)
    at main (C:\Users\Alex\AppData\Roaming\npm\node_modules\hackmyresume\src\index.js:75:22)
    at Object.<anonymous> (C:\Users\Alex\AppData\Roaming\npm\node_modules\hackmyresume\src\index.js:22:3)
    at Module._compile (module.js:398:26)
    at Object.Module._extensions..js (module.js:405:10)
    at Module.load (module.js:344:32)
    at Function.Module._load (module.js:301:12)

Whenever I run hackmyresume build resume.json I get an error saying Cannot read property 'map' of undefined. I feel like I'm missing something really obvious...

none of the generated .doc formats are opening. Tested in osx says resume.doc cannot be opened.

Line-endings in Node CLI are causing issues on OS X 10.9.5.

Would it be possible to autogenerate a Scribus .sla using HackMyResume?

When i'm using json resume theme, the pdf version isn't generated:

$ hackmyresume BUILD resume.json to out/resume.all -t node_modules/jsonresume-theme-elegant-leonth

*** HackMyResume v1.3.0 ***
Applying JSONRESUME-THEME-ELEGANT-LEONTH theme (1 formats)
Reading resume: resume.json
Generating HTML resume: out/resume.html
Deprecation warning: moment construction falls back to js Date. This is discouraged and will be removed in upcoming major release. Please refer to https://github.com/moment/moment/issues/1407 for more info.
Error
    at Function.createFromInputFallback (/Volumes/diskE/Users/n27/Documents/resume/node_modules/moment/moment.js:746:36)
    at configFromString (/Volumes/diskE/Users/n27/Documents/resume/node_modules/moment/moment.js:826:32)
    at configFromInput (/Volumes/diskE/Users/n27/Documents/resume/node_modules/moment/moment.js:1353:13)
    at prepareConfig (/Volumes/diskE/Users/n27/Documents/resume/node_modules/moment/moment.js:1340:13)
    at createFromConfig (/Volumes/diskE/Users/n27/Documents/resume/node_modules/moment/moment.js:1307:44)
    at createLocalOrUTC (/Volumes/diskE/Users/n27/Documents/resume/node_modules/moment/moment.js:1385:16)
    at local__createLocal (/Volumes/diskE/Users/n27/Documents/resume/node_modules/moment/moment.js:1389:16)
    at utils_hooks__hooks (/Volumes/diskE/Users/n27/Documents/resume/node_modules/moment/moment.js:16:29)
    at humanizeDate (/Volumes/diskE/Users/n27/Documents/resume/node_modules/jsonresume-theme-elegant-leonth/index.js:18:10)
    at processDates (/Volumes/diskE/Users/n27/Documents/resume/node_modules/jsonresume-theme-elegant-leonth/index.js:28:40)
    at Function._.each._.forEach (/Volumes/diskE/Users/n27/Documents/resume/node_modules/underscore/underscore.js:153:9)
    at JRSTheme.render (/Volumes/diskE/Users/n27/Documents/resume/node_modules/jsonresume-theme-elegant-leonth/index.js:32:4)
    at single (/usr/local/lib/node_modules/hackmyresume/src/verbs/generate.js:148:31)
    at /usr/local/lib/node_modules/hackmyresume/src/verbs/generate.js:78:17
    at Array.forEach (native)
    at build (/usr/local/lib/node_modules/hackmyresume/src/verbs/generate.js:77:13)
Generating JSON resume: out/resume.json
Generating YML resume: out/resume.yml
Generating PNG resume: out/resume.png

If you annotate your tags (with -a or, better yet, -s), they will show up in git describe which is used by various package managers.

Hello HackMyResume staff,

This is just a friendly reminder that a few things on your README.MD are a bit sexist and triggering. For example, the screenshot here: https://github.com/hacksalot/HackMyResume/raw/master/assets/resume-bouqet.png assumes that all females are out of a job and are submitting resumes, and shows that they must put in the extra effort in order to achieve equality over their male counterparts. You should change this to be more welcoming to women who do not want to use this because they are hurt by this obvious display of the patriarchy.

Also, the name "HackMyResume" is a bit confrontational due to the word "hack" being used as a word for not only scaring people by taking over their computers, but by it meaning the harming of individuals. Trans/gender-fluid people are often confronted by cis oppressors who threaten to do things like hack their legs off or "make them cis." It's truly awful and it would be great if non-cis people could use this without getting frightened by the hostile language.

Finally, the scariest thing about this project are the headers of the README.MD

1. Multiple Targets is a term used for murdering multiple people by the US military. People with PTSD from wars (some of which we murdered innocent people but thats another story) as well as trans/gener-fluid people can be scared by this language.

2. Validating is a term that gay/trans/gender-fluid people are afraid of as they fear they will not be validated in their choices of becoming who they really are.

3. Converting is a term for what the parents/friends of these oppressed peoples do in order to try to change the way these minorities function and appear. It's a terrible, awful, thing.

4. Prettifying is what already-beautiful women attempt to do to make themselves more desirable to males, furthering the patriarchy.

5. Silent mode is a slang term for what cis oppressors do to trans/oppressed people in order to silence them from the outside world.

Please fix these things ASAP and be more welcoming of all people. (◡‿◡✿)

On http://please.hackmyresume.com/ it says "THEMES: CHOOSE FROM ANY FRESH OR JSON RESUME THEME OR"

I want to apply slick theme.

What I tried so far:

$ npm install jsonresume-theme-slick

$ hackmyresume BUILD resume.json TO resume.html -t slick

*** HackMyResume v1.2.2 ***
Reading SOURCE resume: resume.json
ERROR: The specified theme couldn't be found: slick

$ hackmyresume BUILD resume.json TO resume.html -t node_modules/jsonresume-theme-slick/

*** HackMyResume v1.2.2 ***
Reading SOURCE resume: resume.json
ERROR: ENOENT, no such file or directory '/home/umpirsky/Projects/resume/node_modules/jsonresume-theme-slick/jsonresume-theme-slick.json'

What is the proper way to do it?

Add a feature to help job-hunters track resume submissions, interview requests, etc. Use JSON-compatible schema, command-line support, and GUI support through FD.

Would be useful to have a line number in the error.

*** HackMyResume v1.2.2 ***
Reading SOURCE resume: resume.json
Validating resume.json against FRESH/JRS schema: ERROR!
--> RESUME.JSON contains invalid JSON. Unable to validate.
    INTERNAL: SyntaxError: Unexpected token ]

First of all, thanks so much for all of the effort that has gone into this!

One thing I'm not crazy about with the FRESH and JSON Resume formats is the top-level about or summary field. It's modeled as a single string with no formatting, but it would be great if some support for formatting were possible.

The buzzword-cloud that's generated from the skills section is terrific for younger developers without a lot of job history. However, my anecdotal experience is that for older professionals with a career under their belts... you're better off with a summary section that simply lists a few free-form bullet-point highlight sentences.

The skills model forces you into a "category -> buzzwords" structure, while the summary model forces you into a "paragraph with no line breaks or formatting" structure. Bummer.

My proposal would simply be to add support for HTML or Markdown formatting within the summary field (at least newlines and bullet-points, if nothing else). Of course, there would be some challenges here:

1. You'd have to parse newlines in the summary field (I'm not sure if JSON has any support for multi-line string fields, or if you'd have to just embed \n characters within a single line).
2. More importantly, templates would have to recognize and parse formatting as appropriate for the target format. The HTML template would have to replace \n's with <br/>'s, and bullet-points with <ul><li>...</li></ul>. The MS Word one would have to replace them with the correct Word XML constructs, etc.

If this is too large of a feature request, then my fallback proposal would be to simply add some search-and-replace helper functions for Handlebars in src/eng/generic-helpers.js. I imagine that only two would be needed:

1. replaceSubstring : function( txt, target, replacement ) - returns a copy of txt, with all occurrences of substring target replaced by substring replacement. A Handlebars template for generating HTML output could then use {{ replaceSubstring summary '\n' "<br/>" }}.
2. enclosePrefixedString : function( txt, prefix, open, close ) - returns a copy of txt. If txt is prefixed by prefix, then that prefix is stripped and the string is instead enclosed by open and close. For the more tricky task of recognizing Markdown formatting at the beginning of a string, and replacing it with HTML formatting that must enclose the string. A Handlebars template could then use {{ enclosePrefixedString summary "/^ \* /" "<ul><li>" "</li></ul>" }}.

This fallback is a bit ugly, but it does take the responsibility for my feature request and push onto template authors who want to deal with it. I'm more than happy to submit a pull request for this myself if there is interest.

However, I am wondering if you don't already have a solution for this in the works now? When I look at the screenshot on the FluentCV website, the text shown in the summary field explicitly mentions support for HTML and Markdown formatting! Assuming that is legit, then will that support include line-breaks and bullet-point lists?

Platform: Ubuntu 15.10
Node version v0.10.25,
HackMyResume v1.2.0

I am observing below error when trying to BUILD r1.json file to any format.
*** HackMyResume v1.2.0 ***
Reading SOURCE resume: r1.json
ERROR: Object # has no method 'parse'

Also, getting error when validating json file.
[~/Downloads] $ hackmyresume VALIDATE r1.json
*** HackMyResume v1.2.0 ***
ERROR: Cannot find module 'FRESCA'
Why do I need FRESCA module even if I am using jrs format?

As discussed.

@hacksalot as we discussed before in separate places, i think the pdf and png generator should work like this:

• if therer is LaTeX on the user's computer, generate pdf and png by LaTeX for better quality, easier workflow etc.
• if there is no LaTeX, user phantomjs instead.

do i understand this right?

and other questions:

• looks like we have to install phantomjs, maybe ditch pdf/png, or create another tool(plugin) for this two format?
• do we still need wkhtmltopdf? if so, where it stands?

Some users won't like the colors, some terminals won't display them properly. Add an option to turn off or customize output colorization.

I tried just putting random json, but I get this error:

ERROR: Cannot read property 'history' of undefined

It's not immediately clear from the command line what the available themes are.

More of an observation vs. criticism but it will be a future impediment. In many professional resume writing circles, the current thinking is to shorten dates down to years only as for longer resumes, specific months and days often do not matter. It also helps the candidate if there were gaps in employment.

Running a test resume through with years only for jobs, education and awards raises the following errors:

$fluentcmd foo_resume.json -o out_foo/resume.doc -t modern

at /home/foo/.nvm/versions/node/v0.12.7/lib/node_modules/fluentcmd/node_modules/fluentlib/src/core/sheet.js:215:27
ERROR: Invalid date format encountered.

Also, for many in between undergrad and grad school, they may want to reflect summer positions simply as "Summer" for start date and "20xx" for end date. TIA.

*** cross-posted this to jsonresume-cli git issues page.

I found that adding this to my json made it easier to edit in VS Code.

"$schema": "https://raw.githubusercontent.com/fluentdesk/FRESCA/master/schema/fresh-resume-schema.json"

[Fixed]

There's no way to load custom external themes via -t and no easy way for users to integrate them into the app.

It'd be great if you could give an example of how to create a theme (or even just show the source of the current themes) so that other people can build off of those. Thanks!

The mention of FluentCV Desktop is prominent, maybe overbearing, on the HackMyResume home page.

When we follow that link, it's very evident that FluentCV Desktop isn't released yet.

So it's a bit of a bum steer. It takes up about 60% of the home page by area, which is probably excessive and inadvisable at this juncture.