mirror of
https://github.com/jrnl-org/jrnl.git
synced 2025-05-10 08:38:32 +02:00
5b029e6117
* Applying doc changes based on reviews of past several documentation PRs
* Update docs
Clean up encryption docs
Clean up security docs
Delete export.md
Make new formats.md and add to sidebar. Also add all of the built-in formats, and examples for each.
Update mkdocs config for new files
* Fix broken docs links
* Correct incomplete sentences and markdown formatting issues
* Make overview a little more concise
* Update some command line arguments to latest version and make it a bit more concise
* Clean up unneeded TOML modifications and other scaffolding not needed for 3.9
* Revert "Clean up unneeded TOML modifications and other scaffolding not needed for 3.9"
This reverts commit 13b4266ed1.
* Specify that brew is also the easiest way to install jrnl on Linux
* Update docs/security.md
* Update docs/recipes.md
* Doc updates:
- Remove import/export page, fold it into formats
- Rename security to privacy-and-security.md to avoid conflation w/ github security issues
- Various small cleanup and edits from PR review
Co-authored-by: Jonathan Wren <jonathan@nowandwren.com>
40 lines
1.1 KiB
Markdown
40 lines
1.1 KiB
Markdown
# Getting started
|
|
|
|
## Installation
|
|
|
|
On Mac and Linux, the easiest way to install `jrnl` is using
|
|
[Homebrew](http://brew.sh/):
|
|
|
|
``` sh
|
|
brew install jrnl
|
|
```
|
|
|
|
On other platforms, install `jrnl` using [Python](https://www.python.org/) 3.6+ and [pipx](https://pipxproject.github.io/pipx/):
|
|
|
|
``` sh
|
|
pipx install jrnl
|
|
```
|
|
|
|
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
|
|
|
|
``` sh
|
|
jrnl yesterday: Called in sick. Used the time to clean the house and spent 4h on writing my book.
|
|
```
|
|
|
|
and hit return. `yesterday:` will be interpreted as a time stamp.
|
|
Everything until the first sentence mark (`.?!:`) will be interpreted as
|
|
the title, the rest as the body. In your journal file, the result will
|
|
look like this:
|
|
|
|
``` output
|
|
2012-03-29 09:00 Called in sick.
|
|
Used the time to clean the house and spent 4h on writing my book.
|
|
```
|
|
|
|
If you just call `jrnl`, you will be prompted to compose your entry -
|
|
but you can also [configure](advanced.md) *jrnl* to use your external editor.
|