simonmichael/hledger
1
1
Fork 0
mirror of https://github.com/simonmichael/hledger.git synced 2024-12-26 11:52:43 +03:00
Code Issues Projects Releases Wiki Activity
da165bf121
hledger/doc/tldr
History
Simon Michael 5c17a7e069 ;doc:tldr:hledger: sync with upstream
2024-12-09 15:34:41 -10:00
..
hledger-accounts.md doc: tldr: copy tldr pages to the hledger repo for robustness 2024-05-29 15:32:19 -10:00
hledger-add.md doc: tldr: copy tldr pages to the hledger repo for robustness 2024-05-29 15:32:19 -10:00
hledger-aregister.md ;doc: sync with tldr docs 2024-05-29 17:30:50 -10:00
hledger-balance.md doc: tldr: copy tldr pages to the hledger repo for robustness 2024-05-29 15:32:19 -10:00
hledger-balancesheet.md ;doc: sync command summaries between manuals and tldr, updating both 2024-05-29 17:00:11 -10:00
hledger-import.md imp: cli: rename --rules-file to --rules; tweak options help 2024-06-25 18:37:55 +01:00
hledger-incomestatement.md ;doc: sync command summaries between manuals and tldr, updating both 2024-05-29 17:00:11 -10:00
hledger-print.md doc: tldr: copy tldr pages to the hledger repo for robustness 2024-05-29 15:32:19 -10:00
hledger-ui.md ;doc: sync command summaries between manuals and tldr, updating both 2024-05-29 17:00:11 -10:00
hledger-web.md ;doc: sync command summaries between manuals and tldr, updating both 2024-05-29 17:00:11 -10:00
hledger.md ;doc:tldr:hledger: sync with upstream 2024-12-09 15:34:41 -10:00
README.md ;doc: tldr/README updates 2024-12-09 15:34:35 -10:00

README.md

tldr-pages provides very short, example-focussed doc pages for many command line tools, which can be viewed quickly with a tldr client (such as tealdeer).

tldr pages are short but high value, and a great counterbalance to PTA's verbose docs. So they are worth prioritising and maintaining. gutjuri made the first hledger tldr page in 2022, and sm added more in 2024. We currently have 11 hledger-related tldr pages, covering hledger, hledger-ui, hledger-web, and some of the most useful hledger commands.

Contributing

The files in this directory (doc/tldr/) are copied periodically from the tldr-pages repo (.../tldr-pages/pages/common/hledger-*). The tldr-pages repo has the master copies, and the pages are kept compliant with their style rules.

At the above github search, you can configure preferred languages, in the gear icon. If you speak another language besides english, please consider contributing a few translations ! It is relatively easy. You can do it entirely in your web browser if you have a Github account:

  1. Starting with eg https://tldr.inbrowser.app/pages/common/hledger
  2. click "Find this page on GitHub"
  3. click the "Copy raw file" icon (two squares)
  4. navigate to eg https://github.com/tldr-pages/tldr/tree/main/pages.de/common
  5. click "Add file" > "Create new file"
  6. reuse the original file name, paste the original content
  7. translate the content
  8. commit
  9. send a pull request

Here is the tldr translations status. At the time of writing, translations have been contributed by

  • kant (es)
  • CodePsy-2001 (ko)

Usage tips

Some of these pages are embedded in hledger, hledger-ui and hledger-web, accessible with --tldr. We may find other ways to use them in future.

https://tldr.inbrowser.app is an online (& offline) tldr viewer, where you can search for hledger command examples. You can also make a web browser keyword for it (firefox & chrome; safari), like tldr CMD = https://tldr.inbrowser.app/search?query=CMD. Then in your browser's address bar you can type tldr, tldr hledger, tldr hledger-web, tldr hledger-balancesheet, etc.