diff options
author | Manuel Ebert <manuel@1450.me> | 2019-08-23 18:38:05 -0700 |
---|---|---|
committer | Manuel Ebert <manuel@1450.me> | 2020-04-10 11:51:55 -0700 |
commit | 328faa401cf74f342f34a0fd7d70d7c2aa7d41f2 (patch) | |
tree | 3af696e75fab8d588d3d26663fb00d150644ba88 | |
parent | 623fa6c3072f79f598d0392f50d61ed9b31e2df3 (diff) |
Smaller doc fixes, fixes #486
Found and removed another angsty teenager
-rw-r--r-- | README.md | 2 | ||||
-rw-r--r-- | docs/advanced.md | 18 | ||||
-rw-r--r-- | docs/overview.md | 2 | ||||
-rw-r--r-- | docs/recipes.md | 49 | ||||
-rw-r--r-- | docs/usage.md | 17 |
5 files changed, 47 insertions, 41 deletions
@@ -9,7 +9,7 @@ Optionally, your journal can be encrypted using the [256-bit AES](http://en.wiki ### Why keep a journal? -Journals aren't just for angsty teenagers and people who have too much time on their summer vacation. A journal helps you to keep track of the things you get done and how you did them. Your imagination may be limitless, but your memory isn't. For personal use, make it a good habit to write at least 20 words a day. Just to reflect what made this day special, why you haven't wasted it. For professional use, consider a text-based journal to be the perfect complement to your GTD todo list - a documentation of what and how you've done it. +Journals aren't just for people who have too much time on their summer vacation. A journal helps you to keep track of the things you get done and how you did them. Your imagination may be limitless, but your memory isn't. For personal use, make it a good habit to write at least 20 words a day. Just to reflect what made this day special, why you haven't wasted it. For professional use, consider a text-based journal to be the perfect complement to your GTD todo list - a documentation of what and how you've done it. In a Nutshell ------------- diff --git a/docs/advanced.md b/docs/advanced.md index 6a78da95..2a6fd6b4 100644 --- a/docs/advanced.md +++ b/docs/advanced.md @@ -135,13 +135,11 @@ that journal. this option will most likely result in your journal file being impossible to load. -### Known Issues - - - The Windows shell prior to Windows 7 has issues with unicode - encoding. If you want to use non-ascii characters, change the - codepage with `chcp 1252` before using - `jrnl` (Thanks to Yves Pouplard for - solving this!) - - `jrnl`relies on the PyCrypto - package to encrypt journals, which has some known problems with - installing on Windows and within virtual environments. +## Known Issues + +### Unicode on Windows + +The Windows shell prior to Windows 7 has issues with unicode encoding. +To use non-ascii characters, first tweak Python to recognize the encoding by adding `'cp65001': 'utf_8'`, to `Lib/encoding/aliases.py`. Then, change the codepage with `chcp 1252` before using `jrnl`. + +(Related issue: [#486](https://github.com/jrnl-org/jrnl/issues/486)) diff --git a/docs/overview.md b/docs/overview.md index c634ae8e..8a0ec10f 100644 --- a/docs/overview.md +++ b/docs/overview.md @@ -17,7 +17,7 @@ AES](http://en.wikipedia.org/wiki/Advanced_Encryption_Standard). ## Why keep a journal? -Journals aren't just for angsty teenagers and people who have too much +Journals aren't just for people who have too much time on their summer vacation. A journal helps you to keep track of the things you get done and how you did them. Your imagination may be limitless, but your memory isn't. diff --git a/docs/recipes.md b/docs/recipes.md index 1c272e05..7af5b246 100644 --- a/docs/recipes.md +++ b/docs/recipes.md @@ -15,9 +15,8 @@ And will get something like `@melo: 9`, meaning there are 9 entries where both `@alberto` and `@melo` are tagged. How does this work? First, `jrnl @alberto` will filter the journal to only entries containing the tag `@alberto`, and then the `--tags` option will print out how often -each tag occurred in this <span class="title-ref">filtered</span> -journal. Finally, we pipe this to `grep` which will only display the -line containing `@melo`. +each tag occurred in this filtered journal. Finally, we pipe this to +`grep` which will only display the line containing `@melo`. ### Combining filters @@ -66,17 +65,19 @@ If you do that often, consider creating a function in your `.bashrc` or ``` sh jrnlimport () { - echo `stat -f %Sm -t '%d %b %Y at %H:%M: ' $1` `cat $1` | jrnl + echo `stat -f %Sm -t '%d %b %Y at %H:%M: ' $1` `cat $1` | jrnl } ``` ### Using templates Say you always want to use the same template for creating new entries. -If you have an `external editor <advanced>` set up, you can use this : +If you have an [external editor](../advanced) set up, you can use this: - jrnl < my_template.txt - $ jrnl -1 --edit +```sh +jrnl < my_template.txt +jrnl -1 --edit +``` Another nice solution that allows you to define individual prompts comes from [Jacobo de @@ -105,8 +106,10 @@ close the file to save the changes to jrnl. To use Sublime Text, install the command line tools for Sublime Text and configure your `.jrnl_config` like this: -``` javascript -"editor": "subl -w" +``` json +{ + "editor": "subl -w" +} ``` Note the `-w` flag to make sure jrnl waits for Sublime Text to close the @@ -118,8 +121,10 @@ 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" +``` json +{ + "editor": "mvim -f" +} ``` ### iA Writer @@ -128,8 +133,10 @@ On OS X, you can use the fabulous [iA Writer](http://www.iawriter.com/mac) to write entries. Configure your `.jrnl_config` like this: -``` javascript -"editor": "open -b pro.writer.mac -Wn" +``` json +{ + "editor": "open -b pro.writer.mac -Wn" +} ``` What does this do? `open -b ...` opens a file using the application @@ -142,9 +149,7 @@ you can find the right string to use by inspecting iA Writer's `Info.plist` file in your shell: ``` sh -$ grep -A 1 CFBundleIdentifier /Applications/iA\ Writer.app/Contents/Info.plist - <key>CFBundleIdentifier</key> - <string>pro.writer.mac</string> +grep -A 1 CFBundleIdentifier /Applications/iA\ Writer.app/Contents/Info.plist ``` ### Notepad++ on Windows @@ -152,8 +157,10 @@ $ grep -A 1 CFBundleIdentifier /Applications/iA\ Writer.app/Contents/Info.plist To set [Notepad++](http://notepad-plus-plus.org/) as your editor, edit the jrnl config file (`.jrnl_config`) like this: -``` javascript -"editor": "C:\\Program Files (x86)\\Notepad++\\notepad++.exe -multiInst -nosession", +``` json +{ + "editor": "C:\\Program Files (x86)\\Notepad++\\notepad++.exe -multiInst -nosession", +} ``` The double backslashes are needed so jrnl can read the file path @@ -164,9 +171,9 @@ its own Notepad++ window. To set [Visual Studo Code](https://code.visualstudio.com) as your editor on Linux, edit `.jrnl_config` like this: -```javascript +```json { - "editor": "/usr/bin/code --wait", + "editor": "/usr/bin/code --wait", } ``` @@ -183,7 +190,7 @@ Then you can add: ```javascript { - "editor": "code --wait", + "editor": "code --wait", } ``` diff --git a/docs/usage.md b/docs/usage.md index 0ad8e056..fa5050a0 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -37,7 +37,8 @@ jrnl today at 3am: I just met Steve Buscemi in a bar! He looked funny. !!! note Most shell contains a certain number of reserved characters, such as `#` and `*`. Unbalanced quotes, parenthesis, and so on will also get into - the way of your editing. For writing longer entries, just enter `jrnl` + the way of your editing. + For writing longer entries, just enter `jrnl` and hit `return`. Only then enter the text of your journal entry. Alternatively, `use an external editor <advanced>`). @@ -75,9 +76,9 @@ The following options are equivalent: - `jrnl Best day of my life.*` !!! note - Just make sure that the asterisk sign is **not** surrounded by - whitespaces, e.g. `jrnl Best day of my life! *` will **not** work (the - reason being that the `*` sign has a special meaning on most shells). + Just make sure that the asterisk sign is **not** surrounded by + whitespaces, e.g. `jrnl Best day of my life! *` will **not** work (the + reason being that the `*` sign has a special meaning on most shells). ## Viewing @@ -126,9 +127,9 @@ You can change which symbols you'd like to use for tagging in the configuration. !!! note - `jrnl @pinkie @WorldDomination` will switch to viewing mode because - although **no** command line arguments are given, all the input strings - look like tags - *jrnl* will assume you want to filter by tag. + `jrnl @pinkie @WorldDomination` will switch to viewing mode because + although **no** command line arguments are given, all the input strings + look like tags - *jrnl* will assume you want to filter by tag. ## Editing older entries @@ -164,7 +165,7 @@ 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 +```md # 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. |