From ed1122fec1fa05ec15de2fbc7c112b507ff40c74 Mon Sep 17 00:00:00 2001 From: Simon Michael Date: Fri, 8 Apr 2016 07:03:23 -0700 Subject: [PATCH] site: new simpler docs page This docs page is less verbose, and should make it easier to know what you should read next, and what you don't need to read. The reference docs are still in flux, with three alternatives presented: 1. the old manual, 2. the new individual man pages, and 3. the new manual which combines the man pages. At this point I think that 2 will get top billing, 3 will also be provided, and 1 will be dropped when 2/3 are a bit better. --- site/docs.md | 151 +++++++++++++++++++++++++++++--------------------- site/docs1.md | 97 ++++++++++++++++++++++++++++++++ 2 files changed, 186 insertions(+), 62 deletions(-) create mode 100644 site/docs1.md diff --git a/site/docs.md b/site/docs.md index 27e0faf50..c3ccd3cb2 100644 --- a/site/docs.md +++ b/site/docs.md @@ -10,88 +10,115 @@ margin-bottom:0.2em;
-
-
-## Intro +
+ +**Getting started** + +#### [Home](index.html) +What is hledger, and what can it do for you ? #### [Download](download.html) -How to get hledger installed. +How to get it. #### [Step by Step Tutorial](step-by-step.html) Small, guided exercises introducing data entry, reporting, and accounting. -#### [FAQ](faq.html) -Some questions and answers, mostly comparing hledger and Ledger. +#### [Release Notes](release-notes.html) -**Examples:** +#### [FAQ](faq.html) + +
+
+ +**Reference** + +Take your pick: + +#### 1. [Old manual](manual.html) + +#### 2. New man pages + +
+ +Tools: + + + + + + + + + +#### [hledger](hledger.html) + + +#### [hledger-ui](hledger-ui.html) + + +#### [hledger-web](hledger-web.html) + + +#### [hledger-api](hledger-api.html) + + +File formats: + + + + + + + + + +#### [Journal](journal.html) + + +#### [CSV](csv.html) + + +#### [Timeclock](timelog.html) + + +#### [Timedot](timedot.html) + + +
+ +#### 3. [New man pages, one page](manual2.html) + +
+
+ +**More** #### [How to read CSV files](how-to-read-csv-files.html) -An example of converting bank data. #### [How to use account aliases](how-to-use-account-aliases.html) -Aliases for account name rewriting. #### [How to use another account separator character](how-to-use-another-account-separator-character.html) -Writing `some.sub.account` instead of `some:sub:account`. - -**General info:** #### [More docs](more-docs.html) -Some useful links, eg on accounting, not yet moved to... +Some useful links not yet moved to.. #### [plaintextaccounting.org](http://plaintextaccounting.org) -A comprehensive collection of resources and practices from the plain text accounting community - - - - -
-
-## Reference - -#### [User Manual](manual.html) -The hledger reference manual, all on one page. - -Or, as man pages (work in progress): - -
- -#### [hledger(1)](hledger.html) -The main reporting tool and command-line interface. - -#### [hledger-ui(1)](hledger-ui.html) -A curses-style UI for quick exploration. - -#### [hledger-web(1)](hledger-web.html) -A web UI for browsing and data entry, personal or shared. - -#### [hledger-api(1)](hledger-api.html) -A REST-y JSON and file server, good for building client-side UIs. - -**File formats:** - -#### [hledger_journal(5)](journal.html) -hledger's primary data format, representing a general journal. - -#### [hledger_csv(5)](csv.html) -How hledger reads Comma Separated Value data. - -#### [hledger_timelog(5)](timelog.html) -Timeclock format, a sequence of clock-in/clock-out records. - -#### [hledger_timedot(5)](timedot.html) -Timedot format, an alternative time logging format. - -**Combined:** - -#### [All man pages](manual2.html) -All hledger man pages on one web page. - -
+More tips and tools from the plain text accounting community
-
+
+
+
+ +
+
+ +** ** + +
+
+
diff --git a/site/docs1.md b/site/docs1.md new file mode 100644 index 000000000..27e0faf50 --- /dev/null +++ b/site/docs1.md @@ -0,0 +1,97 @@ + + +# Documentation + + + +
+ +
+
+## Intro + +#### [Download](download.html) +How to get hledger installed. + +#### [Step by Step Tutorial](step-by-step.html) +Small, guided exercises introducing data entry, reporting, and accounting. + +#### [FAQ](faq.html) +Some questions and answers, mostly comparing hledger and Ledger. + +**Examples:** + +#### [How to read CSV files](how-to-read-csv-files.html) +An example of converting bank data. + +#### [How to use account aliases](how-to-use-account-aliases.html) +Aliases for account name rewriting. + +#### [How to use another account separator character](how-to-use-another-account-separator-character.html) +Writing `some.sub.account` instead of `some:sub:account`. + +**General info:** + +#### [More docs](more-docs.html) +Some useful links, eg on accounting, not yet moved to... + +#### [plaintextaccounting.org](http://plaintextaccounting.org) +A comprehensive collection of resources and practices from the plain text accounting community + + + + +
+
+## Reference + +#### [User Manual](manual.html) +The hledger reference manual, all on one page. + +Or, as man pages (work in progress): + +
+ +#### [hledger(1)](hledger.html) +The main reporting tool and command-line interface. + +#### [hledger-ui(1)](hledger-ui.html) +A curses-style UI for quick exploration. + +#### [hledger-web(1)](hledger-web.html) +A web UI for browsing and data entry, personal or shared. + +#### [hledger-api(1)](hledger-api.html) +A REST-y JSON and file server, good for building client-side UIs. + +**File formats:** + +#### [hledger_journal(5)](journal.html) +hledger's primary data format, representing a general journal. + +#### [hledger_csv(5)](csv.html) +How hledger reads Comma Separated Value data. + +#### [hledger_timelog(5)](timelog.html) +Timeclock format, a sequence of clock-in/clock-out records. + +#### [hledger_timedot(5)](timedot.html) +Timedot format, an alternative time logging format. + +**Combined:** + +#### [All man pages](manual2.html) +All hledger man pages on one web page. + +
+ +
+
+ +
+