From f1cfb4824061288702e88ffb13cb24206f34da28 Mon Sep 17 00:00:00 2001 From: Micah Ellison <4383304+micahellison@users.noreply.github.com> Date: Sat, 5 Oct 2019 15:50:04 -0700 Subject: [PATCH] [GH-666] updating documentation to reflect v2 behavior: * new config location and file type * removing mentions of DayOne support * removing mention of pip install jrnl[encrypted] --- docs/advanced.md | 80 ++++++++++++++----------------------------- docs/installation.md | 17 +-------- docs/overview.md | 4 --- docs/recipes.md | 40 ++++++++++------------ docs/theme/index.html | 5 --- docs/usage.md | 28 ++------------- 6 files changed, 47 insertions(+), 127 deletions(-) diff --git a/docs/advanced.md b/docs/advanced.md index 6a78da95..648ae6bd 100644 --- a/docs/advanced.md +++ b/docs/advanced.md @@ -3,15 +3,19 @@ ## Configuration File You can configure the way jrnl behaves in a configuration file. By -default, this is `~/.jrnl_config`. If you have the `XDG_CONFIG_HOME` +default, this is `~/.config/jrnl/jrnl.yaml`. If you have the `XDG_CONFIG_HOME` variable set, the configuration file will be saved as -`$XDG_CONFIG_HOME/jrnl/.jrnl_config`. +`$XDG_CONFIG_HOME/jrnl/jrnl.yaml`. !!! note - On Windows, The configuration file is typically found at `C:\Users\[Your Username]\.jrnl_config`. + On Windows, the configuration file is typically found at `%USERPROFILE%\.config\jrnl\jrnl.yaml`. -The configuration file is a simple JSON file with the following options -and can be edited with any plain text editor. +The configuration file is a YAML file with the following options +and can be edited with a plain text editor. + +!!! note + Backup your config file before editing. Changes to the config file + have destructive effects on your journal! - `journals` paths to your journal files @@ -51,46 +55,16 @@ and can be edited with any plain text editor. Or use the built-in prompt or an external editor to compose your entries. -## DayOne Integration - -Using your DayOne journal instead of a flat text file is dead simple -- -instead of pointing to a text file, change your `.jrnl_config` to point -to your DayOne journal. This is a folder named something like -`Journal_dayone` or `Journal.dayone`, and it's located at - - - `~/Library/Application Support/Day One/` by default - - `~/Dropbox/Apps/Day One/` if you're syncing with Dropbox and - - `~/Library/Mobile - Documents/5U8NS4GX82~com~dayoneapp~dayone/Documents/` if you're - syncing with iCloud. - -Instead of all entries being in a single file, each entry will live in a -separate `plist` file. So your `.jrnl_config` should look like this: - -``` javascript -{ - ... - "journals": { - "default": "~/journal.txt", - "dayone": "~/Library/Mobile Documents/5U8NS4GX82~com~dayoneapp~dayone/Documents/Journal_dayone" - } -} -``` - ## Multiple journal files You can configure `jrnl`to use with multiple journals (eg. -`private` and `work`) by defining more journals in your `.jrnl_config`, +`private` and `work`) by defining more journals in your `jrnl.yaml`, for example: -``` javascript -{ -... - "journals": { - "default": "~/journal.txt", - "work": "~/work.txt" - } -} +``` yaml +journals: + default: ~\journal.txt + work: ~\work.txt ``` The `default` journal gets created the first time you start `jrnl` @@ -106,26 +80,22 @@ will both use `~/work.txt`, while `jrnl -n 3` will display the last three entries from `~/journal.txt` (and so does `jrnl default -n 3`). You can also override the default options for each individual journal. -If you `.jrnl_config` looks like this: +If your `jrnl.yaml` looks like this: -``` javascript -{ - ... - "encrypt": false - "journals": { - "default": "~/journal.txt", - "work": { - "journal": "~/work.txt", - "encrypt": true - }, - "food": "~/my_recipes.txt", -} +``` yaml +encrypt: false +journals: +default: ~/journal.txt +work: + journal: ~/work.txt + encrypt: true +food: ~/my_recipes.txt ``` Your `default` and your `food` journals won't be encrypted, however your `work` journal will! You can override all options that are present at -the top level of `.jrnl_config`, just make sure that at the very least -you specify a `"journal": ...` key that points to the journal file of +the top level of `jrnl.yaml`, just make sure that at the very least +you specify a `journal: ...` key that points to the journal file of that journal. !!! note diff --git a/docs/installation.md b/docs/installation.md index 36b694ce..8bf29bb0 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -15,27 +15,12 @@ On other platforms, install *jrnl* using pip pip install jrnl ``` -Or, if you want the option to encrypt your journal, - -``` sh -pip install jrnl[encrypted] -``` - -to install the dependencies for encrypting journals as well. - - -!!! note - Installing the encryption library, `pycrypto`, requires a `gcc` compiler. For this reason, jrnl will - not install `pycrypto` unless explicitly told so like this. You can [install PyCrypto manually](https://www.dlitz.net/software/pycrypto/) - first or install it with `pip install pycrypto` if you have a `gcc` compiler. - Also note that when using zsh, the correct syntax is `pip install "jrnl[encrypted]"` (note the quotes). - The first time you run `jrnl` you will be asked where your journal file should be created and whether you wish to encrypt it. ## Quickstart -to make a new entry, just type +To make a new entry, just type ``` sh jrnl yesterday: Called in sick. Used the time to clean the house and spent 4h on writing my book. diff --git a/docs/overview.md b/docs/overview.md index c634ae8e..4388d0ee 100644 --- a/docs/overview.md +++ b/docs/overview.md @@ -8,10 +8,6 @@ files - you can put them into a Dropbox folder for instant syncing and you can be assured that your journal will still be readable in 2050, when all your fancy iPad journal applications will long be forgotten. -`jrnl` also plays nice with the fabulous -[DayOne](http://dayoneapp.com) and can read and write directly from and -to DayOne Journals. - Optionally, your journal can be encrypted using the [256-bit AES](http://en.wikipedia.org/wiki/Advanced_Encryption_Standard). diff --git a/docs/recipes.md b/docs/recipes.md index 1c272e05..d39e54d0 100644 --- a/docs/recipes.md +++ b/docs/recipes.md @@ -96,17 +96,17 @@ log_question 'What did I make progress with?' ## External editors To use external editors for writing and editing journal entries, set -them up in your `.jrnl_config` (see `advanced usage ` for +them up in your `jrnl.yaml` (see `advanced usage ` for details). Generally, after writing an entry, you will have to save and close the file to save the changes to jrnl. ### Sublime Text To use Sublime Text, install the command line tools for Sublime Text and -configure your `.jrnl_config` like this: +configure your `jrnl.yaml` like this: -``` javascript -"editor": "subl -w" +``` yaml +editor: "subl -w" ``` Note the `-w` flag to make sure jrnl waits for Sublime Text to close the @@ -118,18 +118,18 @@ Similar to Sublime Text, MacVim must be started with a flag that tells the the process to wait until the file is closed before passing control back to journal. In the case of MacVim, this is `-f`: -``` javascript -"editor": "mvim -f" +``` yaml +editor: "mvim -f" ``` ### iA Writer On OS X, you can use the fabulous [iA Writer](http://www.iawriter.com/mac) to write entries. Configure your -`.jrnl_config` like this: +`jrnl.yaml` like this: -``` javascript -"editor": "open -b pro.writer.mac -Wn" +``` yaml +editor: "open -b pro.writer.mac -Wn" ``` What does this do? `open -b ...` opens a file using the application @@ -150,10 +150,10 @@ $ grep -A 1 CFBundleIdentifier /Applications/iA\ Writer.app/Contents/Info.plist ### Notepad++ on Windows To set [Notepad++](http://notepad-plus-plus.org/) as your editor, edit -the jrnl config file (`.jrnl_config`) like this: +the jrnl config file (`jrnl.yaml`) like this: -``` javascript -"editor": "C:\\Program Files (x86)\\Notepad++\\notepad++.exe -multiInst -nosession", +``` yaml +editor: "C:\\Program Files (x86)\\Notepad++\\notepad++.exe -multiInst -nosession" ``` The double backslashes are needed so jrnl can read the file path @@ -162,12 +162,10 @@ its own Notepad++ window. ### Visual Studio Code -To set [Visual Studo Code](https://code.visualstudio.com) as your editor on Linux, edit `.jrnl_config` like this: +To set [Visual Studo Code](https://code.visualstudio.com) as your editor on Linux, edit `jrnl.yaml` like this: -```javascript -{ - "editor": "/usr/bin/code --wait", -} +``` yaml +editor: "/usr/bin/code --wait" ``` The `--wait` argument tells VS Code to wait for files to be written out before handing back control to jrnl. @@ -181,10 +179,8 @@ to your `.bash_profile`, or by running the **Install 'code' command in PATH** co Then you can add: -```javascript -{ - "editor": "code --wait", -} +``` yaml +editor: "code --wait" ``` -to ``.jrnl_config``. See also the [Visual Studio Code documentation](https://code.visualstudio.com/docs/setup/mac) +to ``jrnl.yaml``. See also the [Visual Studio Code documentation](https://code.visualstudio.com/docs/setup/mac) diff --git a/docs/theme/index.html b/docs/theme/index.html index 0c179210..a0f620fb 100755 --- a/docs/theme/index.html +++ b/docs/theme/index.html @@ -82,11 +82,6 @@

Accessible anywhere.

Sync your journals with Dropbox and capture your thoughts where ever you are

-
- -

DayOne compatible.

-

Read, write and search your DayOne journal from the command line.

-

Free & Open Source.

diff --git a/docs/usage.md b/docs/usage.md index 0ad8e056..854f55c4 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -133,9 +133,9 @@ configuration. ## Editing older entries You can edit selected entries after you wrote them. This is particularly -useful when your journal file is encrypted or if you're using a DayOne -journal. To use this feature, you need to have an editor configured in -your journal configuration file (see `advanced usage `) +useful when your journal file is encrypted. To use this feature, you need +to have an editor configured in your journal configuration file (see +`advanced usage `) ``` sh jrnl -until 1950 @texas -and @history --edit @@ -157,25 +157,3 @@ jrnl @girlfriend -until 'june 2012' --edit ``` Just select all text, press delete, and everything is gone... - -### Editing DayOne Journals - -DayOne journals can be edited exactly the same way, however the output -looks a little bit different because of the way DayOne stores its -entries: - -``` output -# af8dbd0d43fb55458f11aad586ea2abf -2013-05-02 15:30 I told everyone I built my @robot wife for sex. -But late at night when we're alone we mostly play Battleship. - -# 2391048fe24111e1983ed49a20be6f9e -2013-08-10 03:22 I had all kinds of plans in case of a @zombie attack. -I just figured I'd be on the other side. -``` - -The long strings starting with hash symbol are the so-called UUIDs, -unique identifiers for each entry. Don't touch them. If you do, then the -old entry would get deleted and a new one written, which means that you -could lose DayOne data that jrnl can't handle (such as as the entry's -geolocation).