mirror of
https://github.com/JuanCanham/HackMyResume.git
synced 2024-11-05 01:56:21 +00:00
Update README.
This commit is contained in:
parent
15a74587bc
commit
c96d37b7f1
84
README.md
84
README.md
@ -2,7 +2,7 @@ fluentCV
|
|||||||
========
|
========
|
||||||
*Generate beautiful, targeted resumes from your command line or shell.*
|
*Generate beautiful, targeted resumes from your command line or shell.*
|
||||||
|
|
||||||
FluentCV 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.
|
FluentCV is a **hackable, data-driven, dev-friendly resume authoring tool** with support for HTML, Markdown, Word, PDF, YAML, plain text, smoke signal, carrier pigeon, and other resume formats.
|
||||||
|
|
||||||
![](assets/fluentcv_cli_ubuntu.png)
|
![](assets/fluentcv_cli_ubuntu.png)
|
||||||
|
|
||||||
@ -11,21 +11,22 @@ Looking for a desktop GUI version with pretty timelines and graphs? Check out [F
|
|||||||
## Features
|
## Features
|
||||||
|
|
||||||
- Runs on OS X, Linux, and Windows.
|
- Runs on OS X, Linux, and Windows.
|
||||||
- Store your resume data as a durable, versionable JSON, YML, or XML document.
|
- Store your resume data as a durable, versionable JSON or YAML document.
|
||||||
- Generate multiple targeted resumes in multiple formats, based on your needs.
|
- Generate polished resumes in multiple formats without violating DRY.
|
||||||
- Output to HTML, PDF, Markdown, Word, JSON, YAML, XML, or a custom format.
|
- Output to HTML, PDF, Markdown, MS Word, JSON, YAML, plain text, or XML.
|
||||||
- Never update one piece of information in four different resumes again.
|
- Compatible with [FRESH][fresh], [JSON Resume][6], [FRESCA][fresca], and [FCV Desktop][7].
|
||||||
- Compatible with the [JSON Resume standard][6] and [authoring tools][7].
|
- Validate resumes against the FRESH or JSON Resume schema.
|
||||||
|
- Support for multiple input and output resumes.
|
||||||
- Free and open-source through the MIT license.
|
- Free and open-source through the MIT license.
|
||||||
- Forthcoming: StackOverflow and LinkedIn support.
|
- Forthcoming: StackOverflow and LinkedIn support.
|
||||||
- Forthcoming: More themes!
|
- Forthcoming: More themes.
|
||||||
|
|
||||||
## Install
|
## Install
|
||||||
|
|
||||||
FluentCV requires a recent version of [Node.js][4] and [NPM][5]. Then:
|
FluentCV requires a recent version of [Node.js][4] and [NPM][5]. Then:
|
||||||
|
|
||||||
1. (Optional, for PDF support) Install the latest official [wkhtmltopdf][3] binary for your platform.
|
1. Install the latest official [wkhtmltopdf][3] binary for your platform.
|
||||||
2. Install **fluentCV** by running `npm install fluentcv -g`.
|
2. Install **fluentCV** with `[sudo] npm install fluentcv -g`.
|
||||||
3. You're ready to go.
|
3. You're ready to go.
|
||||||
|
|
||||||
## Use
|
## Use
|
||||||
@ -33,32 +34,32 @@ FluentCV requires a recent version of [Node.js][4] and [NPM][5]. Then:
|
|||||||
Assuming you've got a JSON-formatted resume handy, generating resumes in different formats and combinations easy. Just run:
|
Assuming you've got a JSON-formatted resume handy, generating resumes in different formats and combinations easy. Just run:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
fluentcv [inputs] [outputs] [-t theme].
|
fluentcv generate [inputs] [outputs] [-t theme].
|
||||||
```
|
```
|
||||||
|
|
||||||
Where `[inputs]` is one or more .json resume files, separated by spaces; `[outputs]` is one or more destination resumes, each prefaced with the `-o` option; and `[theme]` is the desired theme. For example:
|
Where `[inputs]` is one or more .json resume files, separated by spaces; `[outputs]` is one or more destination resumes, each prefaced with the `-o` option; and `[theme]` is the desired theme. For example:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Generate all resume formats (HTML, PDF, DOC, TXT, YML, etc.)
|
# Generate all resume formats (HTML, PDF, DOC, TXT, YML, etc.)
|
||||||
fluentcv resume.json -o out/resume.all -t modern
|
fluentcv generate resume.json -o out/resume.all -t modern
|
||||||
|
|
||||||
# Generate a specific resume format
|
# Generate a specific resume format
|
||||||
fluentcv resume.json -o out/resume.html
|
fluentcv generate resume.json -o out/resume.html
|
||||||
fluentcv resume.json -o out/resume.pdf
|
fluentcv generate resume.json -o out/resume.pdf
|
||||||
fluentcv resume.json -o out/resume.md
|
fluentcv generate resume.json -o out/resume.md
|
||||||
fluentcv resume.json -o out/resume.doc
|
fluentcv generate resume.json -o out/resume.doc
|
||||||
fluentcv resume.json -o out/resume.json
|
fluentcv generate resume.json -o out/resume.json
|
||||||
fluentcv resume.json -o out/resume.txt
|
fluentcv generate resume.json -o out/resume.txt
|
||||||
fluentcv resume.json -o out/resume.yml
|
fluentcv generate resume.json -o out/resume.yml
|
||||||
|
|
||||||
# Specify 2 inputs and 3 outputs
|
# Specify 2 inputs and 3 outputs
|
||||||
fluentcv in1.json in2.json -o out.html -o out.doc -o out.pdf
|
fluentcv generate in1.json in2.json -o out.html -o out.doc -o out.pdf
|
||||||
```
|
```
|
||||||
|
|
||||||
You should see something to the effect of:
|
You should see something to the effect of:
|
||||||
|
|
||||||
```
|
```
|
||||||
*** FluentCV v0.7.2 ***
|
*** FluentCV v0.9.0 ***
|
||||||
Reading JSON resume: foo/resume.json
|
Reading JSON resume: foo/resume.json
|
||||||
Applying MODERN Theme (7 formats)
|
Applying MODERN Theme (7 formats)
|
||||||
Generating HTML resume: out/resume.html
|
Generating HTML resume: out/resume.html
|
||||||
@ -77,11 +78,11 @@ Generating YAML resume: out/resume.yml
|
|||||||
You can specify a predefined or custom theme via the optional `-t` parameter. For a predefined theme, include the theme name. For a custom theme, include the path to the custom theme's folder.
|
You can specify a predefined or custom theme via the optional `-t` parameter. For a predefined theme, include the theme name. For a custom theme, include the path to the custom theme's folder.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
fluentcv resume.json -t modern
|
fluentcv generate resume.json -t modern
|
||||||
fluentcv resume.json -t ~/foo/bar/my-custom-theme/
|
fluentcv generate resume.json -t ~/foo/bar/my-custom-theme/
|
||||||
```
|
```
|
||||||
|
|
||||||
As of v0.7.2, available predefined themes are `modern`, `minimist`, and `hello-world`, and `compact`.
|
As of v0.9.0, available predefined themes are `modern`, `minimist`, and `hello-world`, and `compact`.
|
||||||
|
|
||||||
### Merging resumes
|
### Merging resumes
|
||||||
|
|
||||||
@ -89,13 +90,13 @@ You can **merge multiple resumes together** by specifying them in order from mos
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Merge specific.json onto base.json and generate all formats
|
# Merge specific.json onto base.json and generate all formats
|
||||||
fluentcv base.json specific.json -o resume.all
|
fluentcv generate base.json specific.json -o 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()][9]-style behavior and there's no arbitrary limit to how many resumes you can merge:
|
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()][9]-style behavior and there's no arbitrary limit to how many resumes you can merge:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
fluentcv in1.json in2.json in3.json in4.json -o out.html -o out.doc
|
fluentcv generate in1.json in2.json in3.json in4.json -o out.html -o out.doc
|
||||||
Reading JSON resume: in1.json
|
Reading JSON resume: in1.json
|
||||||
Reading JSON resume: in2.json
|
Reading JSON resume: in2.json
|
||||||
Reading JSON resume: in3.json
|
Reading JSON resume: in3.json
|
||||||
@ -111,14 +112,14 @@ You can specify **multiple output targets** and FluentCV will build them:
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Generate out1.doc, out1.pdf, and foo.txt from me.json.
|
# Generate out1.doc, out1.pdf, and foo.txt from me.json.
|
||||||
fluentcv me.json -o out1.doc -o out1.pdf -o foo.txt
|
fluentcv generate me.json -o out1.doc -o out1.pdf -o foo.txt
|
||||||
```
|
```
|
||||||
|
|
||||||
You can also omit the output file(s) and/or theme completely:
|
You can also omit the output file(s) and/or theme completely:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Equivalent to "fluentcv resume.json resume.all -t modern"
|
# Equivalent to "fluentcv resume.json resume.all -t modern"
|
||||||
fluentcv resume.json
|
fluentcv generate resume.json
|
||||||
```
|
```
|
||||||
|
|
||||||
### Using .all
|
### Using .all
|
||||||
@ -127,17 +128,36 @@ The special `.all` extension tells FluentCV to generate all supported output for
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Generate all resume formats (HTML, PDF, DOC, TXT, etc.)
|
# Generate all resume formats (HTML, PDF, DOC, TXT, etc.)
|
||||||
fluentcv me.json -o out/resume.all
|
fluentcv generate me.json -o out/resume.all
|
||||||
```
|
```
|
||||||
|
|
||||||
..tells FluentCV to read `me.json` and generate `out/resume.md`, `out/resume.doc`, `out/resume.html`, `out/resume.txt`, `out/resume.pdf`, and `out/resume.json`.
|
..tells FluentCV to read `me.json` and generate `out/resume.md`, `out/resume.doc`, `out/resume.html`, `out/resume.txt`, `out/resume.pdf`, and `out/resume.json`.
|
||||||
|
|
||||||
|
### Validating
|
||||||
|
|
||||||
|
FluentCV can also validate your resumes against either the [FRESH /
|
||||||
|
FRESCA][fresca] or [JSON Resume][6] formats. To validate one or more existing
|
||||||
|
resumes, use the `validate` command:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Validate myresume.json against either the FRESH or JSON Resume schema.
|
||||||
|
fluentcv validate resumeA.json resumeB.json
|
||||||
|
```
|
||||||
|
|
||||||
|
FluentCV will validate each specified resume in turn:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
*** FluentCV v0.9.0 ***
|
||||||
|
Validating JSON resume: resume.json (INVALID)
|
||||||
|
Validating JSON resume: resume.json (VALID)
|
||||||
|
```
|
||||||
|
|
||||||
### Prettifying
|
### Prettifying
|
||||||
|
|
||||||
FluentCV applies [js-beautify][10]-style HTML prettification by default to HTML-formatted resumes. To disable prettification, the `--nopretty` or `-n` flag can be used:
|
FluentCV applies [js-beautify][10]-style HTML prettification by default to HTML-formatted resumes. To disable prettification, the `--nopretty` or `-n` flag can be used:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
fluentcv resume.json out.all --nopretty
|
fluentcv generate resume.json out.all --nopretty
|
||||||
```
|
```
|
||||||
|
|
||||||
### Silent Mode
|
### Silent Mode
|
||||||
@ -145,8 +165,8 @@ fluentcv resume.json out.all --nopretty
|
|||||||
Use `-s` or `--silent` to run in silent mode:
|
Use `-s` or `--silent` to run in silent mode:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
fluentcv resume.json -o someFile.all -s
|
fluentcv generate resume.json -o someFile.all -s
|
||||||
fluentcv resume.json -o someFile.all --silent
|
fluentcv generate resume.json -o someFile.all --silent
|
||||||
```
|
```
|
||||||
|
|
||||||
## License
|
## License
|
||||||
@ -163,3 +183,5 @@ MIT. Go crazy. See [LICENSE.md][1] for details.
|
|||||||
[8]: https://youtu.be/N9wsjroVlu8
|
[8]: https://youtu.be/N9wsjroVlu8
|
||||||
[9]: https://api.jquery.com/jquery.extend/
|
[9]: https://api.jquery.com/jquery.extend/
|
||||||
[10]: https://github.com/beautify-web/js-beautify
|
[10]: https://github.com/beautify-web/js-beautify
|
||||||
|
[fresh]: https://github.com/fluentdesk/FRESH
|
||||||
|
[fresca]: https://github.com/fluentdesk/FRESCA
|
||||||
|
Loading…
Reference in New Issue
Block a user