AaronFiore/plaintextaccounting
1
0
Fork 0
Code Activity

Updates HTML based on previous commit

Browse Source
This commit is contained in:
Colin Dean
2019-10-16 23:11:38 -04:00
committed by Simon Michael
parent 341d4fc5e7
commit 2879a46555
2 changed files with 8 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
index.html
View File

@@ -112,7 +112,7 @@ h5 {
}
</style>
<div style="float:right; position:fixed; top:.5em; right:.5em;">
<p><a href="https://github.com/plaintextaccounting/plaintextaccounting.github.io"><img src="https://img.shields.io/github/stars/plaintextaccounting/plaintextaccounting.github.io.svg?style=social&amp;label=Github" alt="github" title="send pull requests, bug reports, blog posts, star us, tweet with #plaintextaccounting tag" /></a></p>
<p><a href="https://github.com/plaintextaccounting/plaintextaccounting.github.io"><img src="https://img.shields.io/github/stars/plaintextaccounting/plaintextaccounting.github.io.svg?style=social&amp;label=Github" title="send pull requests, bug reports, blog posts, star us, tweet with #plaintextaccounting tag" alt="github" /></a></p>
</div>
<div id="section1">
<h1 id="plain-text-accounting">plain text accounting</h1>
@@ -121,7 +121,7 @@ h5 {
</div>
<div class="row">
<div class="faq eight columns">
<h2 id="faq">FAQ</h2><p>(A work in progress; improvements always welcome.)</p><h3 id="what-and-why">What and why</h3><h5 id="what-is-accounting-and-what-can-it-do-for-me">What is Accounting, and what can it do for me?</h5><p><a href="https://en.wikipedia.org/wiki/Accounting">Accounting</a> is tracking the flow of valuable commodities, such as money or time. It clarifies activity, priorities, obligations, opportunities. It can <a href="http://podcastle.org/2009/10/09/pc-miniature-38-accounting-for-dragons">reduce stress</a> and even be enjoyable.</p><h5 id="what-is-plain-text-accounting">What is Plain Text Accounting?</h5><p>In 2003, John Wiegley invented Ledger: a command-line reporting tool and a plain text data format and for efficient double-entry-style accounting. Ledger's ideas appealed to many software developers and technical folk. In 2007 and 2008 it was joined by hledger and Beancount respectively, and as of 2019 there are more than a dozen <a href="#plain-text-accounting-apps">Ledger-likes</a>, many add-on tools and an active community. This site was started in 2016 to help keep track of it all.</p><h5 id="what-is-double-entry">What is double-entry?</h5><p><a href="https://en.wikipedia.org/wiki/Double-entry_bookkeeping_system">Double-entry bookkeeping</a> is a process for keeping accounting records reliably. For every movement of value (a <a href="https://en.wikipedia.org/wiki/Financial_transaction">transaction</a>), both the source and destination are recorded. Simple arithmetic invariants help prevent errors.</p><p>Value at any point in time is tracked in various <a href="https://en.wikipedia.org/wiki/Account_(accountancy)">accounts</a>, classified as <a href="https://en.wikipedia.org/wiki/Asset">asset</a> (owned), <a href="https://en.wikipedia.org/wiki/Liability_(financial_accounting)">liability</a> (owed) or <a href="https://en.wikipedia.org/wiki/Equity_(finance)">equity</a> (invested). Two more classifications track changes during some period: <a href="https://en.wikipedia.org/wiki/Revenue">revenues</a> (inflows) and <a href="https://en.wikipedia.org/wiki/Expense">expenses</a> (outflows).</p><p>Transactions consist of <a href="https://en.wikipedia.org/wiki/Debits_and_credits">debits</a> (increases to asset or expense accounts, or decreases to liability or equity accounts) or <a href="https://en.wikipedia.org/wiki/Debits_and_credits">credits</a> (decreases to asset or expense accounts, or increases to liability or equity accounts).</p><h5 id="what-are-some-characteristics-of-plain-text-accounting">What are some characteristics of Plain Text Accounting ?</h5><p>Accounting data is valuable; we want to know that it will be accessible for ever - even without software. We want to know when it changes, and revision-control it. We want to search and manipulate it efficiently. So, we store it as human-readable <a href="http://ledger-cli.org/3.0/doc/ledger3.html#The-Most-Basic-Entry">plain</a> <a href="https://hledger.org/journal.html">text</a>.</p><p>We simplify debits and credits by using <a href="http://ledger-cli.org/3.0/doc/ledger3.html#Stating-where-money-goes">signed numbers</a> - positive for inflows to an account, negative for outflows from an account.</p><p>We define arbitrary <a href="http://ledger-cli.org/3.0/doc/ledger3.html#Structuring-your-Accounts">account</a> <a href="https://hledger.org/journal.html#account-names">hierarchy</a> to suit our needs. This scales smoothly from simple to complex scenarios, and from high-level overview to fine detail.</p><p>Ledger-likes are, at least in part, <a href="#software">command-line tools</a>. This makes them efficient to use and very scriptable and flexible.</p><p>Ledger-likes also, at their core, tend towards <a href="https://en.wikipedia.org/wiki/Function_(mathematics)">functional operation</a>: they read the input data without changing it, and output a report. This simple model makes them easy to understand and rely on.</p>
<h2 id="faq">FAQ</h2><p>(A work in progress; improvements always welcome.)</p><h3 id="what-and-why">What and why</h3><h5 id="what-is-accounting-and-what-can-it-do-for-me">What is Accounting, and what can it do for me?</h5><p><a href="https://en.wikipedia.org/wiki/Accounting">Accounting</a> is tracking the flow of valuable commodities, such as money or time. It clarifies activity, priorities, obligations, opportunities. It can <a href="http://podcastle.org/2009/10/09/pc-miniature-38-accounting-for-dragons">reduce stress</a> and even be enjoyable.</p><h5 id="what-is-plain-text-accounting">What is Plain Text Accounting?</h5><p>In 2003, John Wiegley invented Ledger: a command-line reporting tool and a plain text data format and for efficient double-entry-style accounting. Ledger's ideas appealed to many software developers and technical folk. In 2007 and 2008 it was joined by hledger and Beancount respectively, and as of 2019 there are more than a dozen <a href="#plain-text-accounting-apps">Ledger-likes</a>, many add-on tools and an active community. This site was started in 2016 to help keep track of it all.</p><h5 id="what-is-double-entry">What is double-entry?</h5><p><a href="https://en.wikipedia.org/wiki/Double-entry_bookkeeping_system">Double-entry bookkeeping</a> is a process for keeping accounting records reliably. For every movement of value (a <a href="https://en.wikipedia.org/wiki/Financial_transaction">transaction</a>), both the source and destination are recorded. Simple arithmetic invariants help prevent errors.</p><p>Value at any point in time is tracked in various <a href="https://en.wikipedia.org/wiki/Account_(accountancy)">accounts</a>, classified as <a href="https://en.wikipedia.org/wiki/Asset">asset</a> (owned), <a href="https://en.wikipedia.org/wiki/Liability_(financial_accounting)">liability</a> (owed) or <a href="https://en.wikipedia.org/wiki/Equity_(finance)">equity</a> (invested). Two more classifications track changes during some period: <a href="https://en.wikipedia.org/wiki/Revenue">revenues</a> (inflows) and <a href="https://en.wikipedia.org/wiki/Expense">expenses</a> (outflows).</p><p>Transactions consist of <a href="https://en.wikipedia.org/wiki/Debits_and_credits">debits</a> (increases to asset or expense accounts, or decreases to liability or equity accounts) or <a href="https://en.wikipedia.org/wiki/Debits_and_credits">credits</a> (decreases to asset or expense accounts, or increases to liability or equity accounts).</p><h5 id="what-are-some-characteristics-of-plain-text-accounting">What are some characteristics of Plain Text Accounting ?</h5><p>Accounting data is valuable; we want to know that it will be accessible for ever - even without software. We want to know when it changes, and revision-control it. We want to search and manipulate it efficiently. So, we store it as human-readable <a href="https://www.ledger-cli.org/3.0/doc/ledger3.html#The-Most-Basic-Entry">plain</a> <a href="https://hledger.org/journal.html">text</a>.</p><p>We simplify debits and credits by using <a href="https://www.ledger-cli.org/3.0/doc/ledger3.html#Stating-where-money-goes">signed numbers</a> - positive for inflows to an account, negative for outflows from an account.</p><p>We define arbitrary <a href="https://www.ledger-cli.org/3.0/doc/ledger3.html#Structuring-your-Accounts">account</a> <a href="https://hledger.org/journal.html#account-names">hierarchy</a> to suit our needs. This scales smoothly from simple to complex scenarios, and from high-level overview to fine detail.</p><p>Ledger-likes are, at least in part, <a href="#software">command-line tools</a>. This makes them efficient to use and very scriptable and flexible.</p><p>Ledger-likes also, at their core, tend towards <a href="https://en.wikipedia.org/wiki/Function_(mathematics)">functional operation</a>: they read the input data without changing it, and output a report. This simple model makes them easy to understand and rely on.</p>
</div>
<!-- column -->
<div id="sitemap" class="three columns" style="white-space:nowrap;">
@@ -349,7 +349,7 @@ th, td { border:none; padding-top:0; padding-bottom:0; border-bottom:thin solid
</thead>
<tbody>
<tr class="odd">
<td><a href="http://ledger-cli.org">Ledger</a></td>
<td><a href="https://www.ledger-cli.org">Ledger</a></td>
<td>2003</td>
<td style="text-align: center;">2019-03</td>
<td><a href="https://github.com/ledger/ledger">C++</a></td>
@@ -574,7 +574,7 @@ th, td { border:none; padding-top:0; padding-bottom:0; border-bottom:thin solid
<p>Next, related add-ons and helpers by category (note: <code>*ledger</code> below means Ledger and hledger-style journal format):</p>
<h3 id="data-importconversion">data import/conversion</h3>
<ul>
<li><a href="http://ledger-cli.org/3.0/doc/ledger3.html#Comma-Separated-Values-files">Ledger</a> and <a href="https://hledger.org/csv.html">hledger</a> have CSV conversion built in. Also:</li>
<li><a href="https://www.ledger-cli.org/3.0/doc/ledger3.html#Comma-Separated-Values-files">Ledger</a> and <a href="https://hledger.org/csv.html">hledger</a> have CSV conversion built in. Also:</li>
<li>bean-identify, bean-extract, bean-file - Beancount built-in tools</li>
<li><a href="https://github.com/tomszilagyi/banks2ledger">banks2ledger</a> - CSV to *ledger converter</li>
<li><a href="https://github.com/jbms/beancount-import">beancount-import</a> web app/framework for converting various formats to beancount (python)</li>
@@ -755,7 +755,7 @@ other console/curses tools
<!-- official docs & useful intro docs -->
<!-- XXX reorg -->
<ul>
<li><a href="http://ledger-cli.org/docs.html">Ledger manuals</a></li>
<li><a href="https://www.ledger-cli.org/docs.html">Ledger manuals</a></li>
<li><a href="https://github.com/ledger/ledger/wiki">Ledger wiki</a></li>
<li><a href="https://devhints.io/ledger">Ledger CLI cheatsheet</a></li>
<li><a href="https://rolfschr.github.io/gswl-book/latest.html">Getting Started With Ledger</a></li>
@@ -939,7 +939,7 @@ other console/curses tools
</ul>
<h3 id="time-tracking">time tracking</h3>
<ul>
<li><a href="http://ledger-cli.org/3.0/doc/ledger3.html#Time-Keeping">Ledger: Time Keeping</a></li>
<li><a href="https://www.ledger-cli.org/3.0/doc/ledger3.html#Time-Keeping">Ledger: Time Keeping</a></li>
<li><a href="https://hledger.org/timeclock.html">hledger: Timeclock files</a></li>
<li><a href="https://hledger.org/timedot.html">hledger: Timedot files</a></li>
<li><a href="https://github.com/anarcat/ledger-timetracking">Timetracking and billing with (h)ledger</a></li>
@@ -966,7 +966,7 @@ other console/curses tools
</ul>
<h3 id="api-access">API access</h3>
<ul>
<li><a href="http://ledger-cli.org/3.0/doc/ledger3.html#Extending-with-Python">Ledger: Extending with Python</a></li>
<li><a href="https://www.ledger-cli.org/3.0/doc/ledger3.html#Extending-with-Python">Ledger: Extending with Python</a></li>
<li><a href="https://groups.google.com/forum/#!topic/ledger-cli/C99w-79Jq8o">Ledger Python 3 Support</a> Python</li>
<li><a href="https://github.com/Rudd-O/ledgerhelpers">ledgerhelpers</a> Python</li>
<li><a href="http://hackage.haskell.org/package/hledger-lib">hledger-lib</a>, <a href="http://hackage.haskell.org/package/hledger">hledger</a>, <a href="http://stefanorodighiero.net/posts/2015-01-04-hledger-find-duplicate-accounts.html">an example</a></li>

2
quickref/quickref-ledger.html
View File

@@ -35,7 +35,7 @@
<div class="container">
<h1 id="ledger">Ledger</h1>
<p><a href="http://ledger-cli.org/3.0/doc/ledger3.html#Journal-Format" class="uri">http://ledger-cli.org/3.0/doc/ledger3.html#Journal-Format</a><br />
<p><a href="https://www.ledger-cli.org/3.0/doc/ledger3.html#Journal-Format" class="uri">https://www.ledger-cli.org/3.0/doc/ledger3.html#Journal-Format</a><br />
<a href="http://ricostacruz.com/cheatsheets/ledger.html" class="uri">http://ricostacruz.com/cheatsheets/ledger.html</a></p>
<h2 id="basic-example">Basic example</h2>
<pre><code>; a comment