2e5a68d942
Allow output files to be explicitly specified via -o, for ex: fluentcmd resume.json -o out/resume.html -o out/resume.pdf |
||
---|---|---|
assets | ||
src | ||
.gitattributes | ||
.gitignore | ||
LICENSE.md | ||
package.json | ||
README.md |
fluentcmd
Generate beautiful, targeted resumes from your command line or shell.
FluentCMD is a hackable, data-driven, dev-friendly resume authoring tool with support for HTML, Markdown, Word, PDF, plain text, smoke signal, carrier pigeon, and other arbitrary-format resumes and CVs.
Looking for a desktop GUI version with pretty timelines and graphs? Check out FluentCV Desktop.
Features
- Runs on OS X, Linux, and Windows.
- Store your resume data as a durable, versionable JSON, YML, or XML document.
- Generate multiple targeted resumes in multiple formats, based on your needs.
- Output to HTML, PDF, Markdown, Word, JSON, XML, or other arbitrary formats.
- Never update one piece of information in four different resumes again.
- Compatible with the JSON Resume standard and authoring tools.
- Free and open-source through the MIT license.
- Forthcoming: StackOverflow and LinkedIn support.
- Forthcoming: More themes!
Install
FluentCMD requires a recent version of Node.js and NPM. Then:
- (Optional, for PDF support) Install the latest official wkhtmltopdf binary for your platform.
- Install fluentcmd by running
npm install fluentcmd -g
. - You're ready to go!
Use
Assuming you've got a JSON-formatted resume handy, generating resumes in different formats and combinations easy. Just run:
fluentcmd [inputs] [outputs] [-t theme]
.
Where [inputs]
is one or more .json resume files, [outputs]
is one or more destination resumes, and [theme]
is the desired theme. For example:
# Generate all resume formats (HTML, PDF, DOC, TXT)
fluentcmd resume.json resume.all -t modern
# Generate a specific resume format
fluentcmd resume.json resume.html -t modern
fluentcmd resume.json resume.txt -t modern
fluentcmd resume.json resume.pdf -t modern
fluentcmd resume.json resume.doc -t modern
You should see something to the effect of:
*** FluentCMD v0.3.0 ***
Reading JSON resume: foo/resume.json
Generating HTML resume: out/resume.html
Generating TXT resume: out/resume.txt
Generating DOC resume: out/resume.doc
Generating PDF resume: out/resume.pdf
Advanced
Applying a theme
You can specify a predefined or custom theme via the -t
parameter. For a predefined theme, include the theme name. For a custom theme, include the path to the custom theme's folder.
fluentcmd resume.json -t modern
fluentcmd resume.json -t ~/foo/bar/my-custom-theme/
As of v0.3.0, available predefined themes are modern
, minimist
, informatic
, and hello-world
.
Merging resumes
You can merge multiple resumes together by specifying them in order from most generic to most specific:
# Merge specific.json onto base.json and generate all formats
fluentcmd base.json specific.json resume.all
This can be useful for overriding a base (generic) resume with information from a specific (targeted) resume. For example, you might override your generic catch-all "software developer" resume with specific details from your targeted "game developer" resume, or combine two partial resumes into a "complete" resume. Merging follows conventional extend()-style behavior and there's no arbitrary limit to how many resumes you can merge:
fluentcmd in1.json in2.json in3.json in4.json out.html out.doc
Reading JSON resume: in1.json
Reading JSON resume: in2.json
Reading JSON resume: in3.json
Reading JSON resume: in4.json
Merging in4.json onto in3.json onto in2.json onto in1.json
Generating HTML resume: out.html
Generating WORD resume: out.doc
Multiple targets
You can specify multiple output targets and FluentCMD will build them:
# Generate out1.doc, out1.pdf, and foo.txt from me.json.
fluentcmd me.json out1.doc out1.pdf foo.txt
You can also omit the output file(s) and/or theme completely:
# Equivalent to "fluentcmd resume.json resume.all -t modern"
fluentcmd resume.json
Using .all
The special .all
extension tells FluentCMD to generate all supported output formats for the given resume. For example, this...
# Generate all resume formats (HTML, PDF, DOC, TXT, etc.)
fluentcmd input.json output.all
..tells FluentCV to read input.json
and generate output.doc
, output.html
, output.txt
, output.pdf
. That's more or less equivalent to:
# Generate all resume formats (HTML, PDF, DOC, TXT)
fluentcmd input.json output.doc output.html output.txt output.pdf
License
MIT. Go crazy. See LICENSE.md for details.