Document PEEK command.

Add preliminary docs around PEEK.
2024-12-23 05:37:23 +00:00 · 2016-01-15 14:46:13 -05:00 · 2016-01-15 14:46:13 -05:00 · 88879257e6
commit 88879257e6
parent fff45e1431
2 changed files with 71 additions and 19 deletions
--- a/README.md
+++ b/README.md
@ -107,7 +107,7 @@ Use it when you need to submit, upload, print, or email resumes in specific
 formats.

    ```bash
-    # hackmyresume BUILD <INPUTS> TO <OUTPUTS> [-t THEME]
+    # hackmyresume BUILD <INPUTS...> TO <OUTPUTS...> [-t THEME]
    hackmyresume BUILD resume.json TO out/resume.all
    hackmyresume BUILD r1.json r2.json TO out/rez.html out/rez.md foo/rez.all
    ```
@ -115,7 +115,7 @@ formats.
 - **new** creates a new resume in FRESH or JSON Resume format.

    ```bash
-    # hackmyresume NEW <OUTPUTS> [-f <FORMAT>]
+    # hackmyresume NEW <OUTPUTS...> [-f <FORMAT>]
    hackmyresume NEW resume.json
    hackmyresume NEW resume.json -f fresh
    hackmyresume NEW r1.json r2.json -f jrs
@ -123,12 +123,18 @@ formats.

 - **analyze** inspects your resume for keywords, duration, and other metrics.

+    ```bash
+    # hackmyresume ANALYZE <INPUTS...>
+    hackmyresume ANALYZE resume.json
+    hackmyresume ANALYZE r1.json r2.json
+    ```
+
 - **convert** converts your source resume between FRESH and JSON Resume
 formats. Use it to convert between the two formats to take advantage of tools
 and services.

    ```bash
-    # hackmyresume CONVERT <INPUTS> TO <OUTPUTS>
+    # hackmyresume CONVERT <INPUTS...> TO <OUTPUTS...>
    hackmyresume CONVERT resume.json TO resume-jrs.json
    hackmyresume CONVERT 1.json 2.json 3.json TO out/1.json out/2.json out/3.json
    ```
@ -137,11 +143,22 @@ and services.
 Resume schema. Use it to make sure your resume data is sufficient and complete.

    ```bash
-    # hackmyresume VALIDATE <INPUTS>
+    # hackmyresume VALIDATE <INPUTS...>
    hackmyresume VALIDATE resume.json
    hackmyresume VALIDATE r1.json r2.json r3.json
    ```

+- **peek** echoes your resume or any field, property, or object path on your
+resume to standard output.
+
+    ```bash
+    # hackmyresume PEEK <INPUTS...> [OBJECT-PATH]
+    hackmyresume PEEK rez.json # Echo the whole resume
+    hackmyresume PEEK rez.json info.brief # Echo the "info.brief" field
+    hackmyresume PEEK rez.json employment.history[1] # Echo the 1st job
+    hackmyresume PEEK rez.json rez2.json info.brief # Compare value
+    ```    
+
 ## Supported Output Formats

 HackMyResume supports these output formats:
@ -209,24 +226,36 @@ Generating YAML resume: out/resume.yml

 ### Applying a theme

-HackMyResume can work with any FRESH or JSON Resume theme. To specify a theme
-when generating your resume, use the `-t` or `--theme` parameter:
+HackMyResume can work with any FRESH or JSON Resume theme (the latter must be
+installed first). To specify a theme when generating your resume, use the `-t`
+or `--theme` parameter:

 ```bash
 hackmyresume BUILD resume.json TO out/rez.all -t [theme]
 ```

-The `[theme]` parameter can be the name of a predefined theme or the path to any
+The `[theme]` parameter can be the name of a predefined theme OR the path to any
 FRESH or JSON Resume theme folder:

 ```bash
 hackmyresume BUILD resume.json TO out/rez.all -t modern
 hackmyresume BUILD resume.json TO OUT.rez.all -t ../some-folder/my-custom-theme/
-hackmyresume BUILD resume.json TO OUT.rez.all -t npm_modules/jsonresume-theme-classy
+hackmyresume BUILD resume.json TO OUT.rez.all -t node_modules/jsonresume-theme-classy
 ```

-As of v1.4.0, available predefined themes are `positive`, `modern`, `compact`,
-`minimist`, and `hello-world`.
+FRESH themes are currently pre-installed with HackMyResume. JSON Resume themes
+can be installed prior to use:
+
+```bash
+# Install a JSON Resume theme into a local node_modules subfolder:
+npm install jsonresume-theme-[name]
+# Use it with HackMyResume
+hackmyresume build resume.json -t node_modules/jsonresume-theme-[name]
+```
+
+As of v1.6.0, available predefined FRESH themes are `positive`, `modern`,
+`compact`, `minimist`, and `hello-world`. For a list of JSON Resume themes,
+check the [NPM Registry](https://www.npmjs.com/search?q=jsonresume-theme).

 ### Merging resumes

@ -281,6 +310,9 @@ hackmyresume BUILD me.json TO out/resume.all

 ### Building PDFs

+*Users who don't care about PDFs can turn off PDF generation across all themes
+and formats with the `--pdf none` switch.*
+
 HackMyResume takes a unique approach to PDF generation. Instead of enforcing
 a specific PDF engine on users, HackMyResume will attempt to work with whatever
 PDF engine you have installed through the engine's command-line interface (CLI).
@ -289,10 +321,10 @@ Currently that means one or both of...
 - [wkhtmltopdf][3]
 - [Phantom.js][3]

-..with support for other engines planned in the future. **One or both of these
-engines must be installed and accessible on your PATH in order to generate PDF
-resumes with HackMyResume**. That means you should be able to invoke either of
-these tools directly from your shell or terminal without error:
+..with support for other engines planned in the future. But for now, **one or
+both of these engines must be installed and accessible on your PATH in order to
+generate PDF resumes with HackMyResume**. That means you should be able to
+invoke either of these tools directly from your shell or terminal without error:

 ```bash
 wkhtmltopdf input.html output.pdf
@ -437,10 +469,17 @@ where <INPUTS> is one or more resumes in FRESH or JSON Resume format, and
 autodetect the format (FRESH or JRS) of each input resume and convert it to the
 other format (JRS or FRESH).

-### External options
+### File-based Options

-Starting in v1.4.x you can pass options into HackMyResume via an external
-options or ".hackmyrc" file.
+You can pass options into HackMyResume via an external options or ".hackmyrc"
+file with the `--options` or `-o` switch:
+
+```bash
+hackmyresume BUILD resume.json -o path/to/options.json
+```
+
+The options file can contain any documented HackMyResume option, including
+`theme`, `silent`, `debug`, `pdf`, `css`, and other settings.

 ```javascript
 {
@ -453,6 +492,18 @@ options or ".hackmyrc" file.
 }
 ```

+If a particular option is specified both on the command line and in an external
+options file, the explicit command-line option takes precedence.
+
+```bash
+# path/to/options.json specifes the POSITIVE theme
+# -t parameter specifies the COMPACT theme
+# The -t parameter wins.
+hackmyresume BUILD resume.json -o path/to/options.json -t compact
+> Reading resume: resume.json
+> Applying COMPACT theme (7 formats)
+```
+
 ### Prettifying

 HackMyResume applies [js-beautify][10]-style HTML prettification by default to
--- a/src/cli/use.txt
+++ b/src/cli/use.txt
@ -9,6 +9,7 @@ Available commands:
  VALIDATE      Validate your resume for errors and typos.
  CONVERT       Convert your resume between FRESH and JSON Resume.
  NEW           Create a new resume in FRESH or JSON Resume format.
+  PEEK          View a specific field or element on your resume.

 Available options:

@ -33,6 +34,7 @@ Examples:
  hackmyresume  NEW my-new-resume.json --format JRS
  hackmyresume  CONVERT resume-fresh.json TO resume-jrs.json
  hackmyresume  VALIDATE resume.json
+  hackmyresume  PEEK resume.json employment[2].summary

 Tips:

@ -46,5 +48,4 @@ Tips:
    listing of all available JSON Resume themes.
  - Visit https://github.com/fluentdesk/fresh-themes for a complete
    listing of all available FRESH themes.
-  - Report bugs to https://githut.com/hacksalot/HackMyResume/issues
-    for a quick fix, often within 24 hours.
+  - Report bugs to https://githut.com/hacksalot/HackMyResume/issues.