hledger/site/index.md

262 lines
8.9 KiB
Markdown
Raw Normal View History

2018-04-28 21:50:14 +03:00
---
title: home
...
<style>
.highslide img {max-width:200px; float:right; margin:0 0 1em 1em;}
.highslide-caption {color:white; background-color:black;}
a {white-space:nowrap;}
</style>
2018-04-28 23:35:12 +03:00
<!-- INTRO -->
<img src="images/coins2-248.png" width="" height="200" style="float:right; margin:1em 1em 0 1em;" />
2018-04-28 21:50:14 +03:00
<h1 style="/*font-size:4em;*/ ">hledger</h1>
<span style="font-size:xx-large;">
Robust plain text accounting.
<!-- Friendly, robust plain text accounting. -->
2018-04-28 21:50:14 +03:00
<!-- Robust, powerful, plain text accounting. -->
<!-- Robust, precise, plain text accounting. -->
<!-- Plain text accounting for everyone. -->
<!-- Making accounting fun for techies. -->
</span>
<span style="font-size:x-large;">hledger</span>
2019-03-27 23:00:37 +03:00
is an elegant, versatile accounting program, for tracking money, time, or other commodities
2019-03-15 03:47:29 +03:00
using plain text records.
It is a fast, dependable, secure alternative to Quicken, Xero, GnuCash etc.,
<!-- with simple yet powerful functionality, -->
accessible from command line, terminal or web browser.
Compared to other plain text accounting tools, it is more robust and intuitive.
Good docs and real world usefulness are a top priority.
2019-03-15 03:47:29 +03:00
hledger is cross platform GNU GPLv3 free software, written in Haskell.
The project is led by Simon Michael, with 100+ contributors.
I've been building and relying on hledger since 2007;
I hope you too will find it helpful in mastering your time and money.
Let us know!
2018-04-28 23:35:12 +03:00
<!-- DOCS -->
2017-04-28 17:39:19 +03:00
2015-05-26 04:15:02 +03:00
<style>
2018-04-28 21:46:42 +03:00
h2 { font-size:x-large; margin-top:.5em; }
h3 { font-size:large; margin-bottom:.2em; }
tr { border-top:thin solid #bbb; border-bottom:thin solid #bbb; vertical-align:top; }
td:nth-child(1) { padding-right:1em; white-space:nowrap; }
.col-sm-3, .col-sm-4 {
padding:0;
}
.contentbox {
2018-04-28 21:50:14 +03:00
margin:1em .5em .5em 0;
2018-04-28 21:46:42 +03:00
padding:.1em .5em;
border-radius:1em;
}
#introduction {
2018-04-28 21:50:14 +03:00
/* background-color:#ffb; */
2018-04-28 21:46:42 +03:00
}
#help {
background-color:#fdd;
}
#reference {
background-color:#eef;
text-align:left;
}
#reference .subcontent {
margin-left:1em;
}
#dev {
background-color:#eee;
text-align:left;
}
#dev .subcontent {
margin-left:1em;
}
2018-04-28 21:46:42 +03:00
#wiki {
background-color:#efe;
text-align:center;
}
#wiki .subcontent {
}
</style>
<div class="row" style="text-align:center; ">
**[<button type="button" class="btn btn-default btn-success" title="All the ways to install hledger. Get it now!">Install hledger</button>](download.html)**
&nbsp;
[<button type="button" class="btn btn-default" style="border:none; min-width:102;" title="hledger on Github. Star us!"><img src="https://img.shields.io/github/stars/simonmichael/hledger.svg?style=for-the-badge&logo=GitHub&label=Github&color=lightgrey"></button>](https://github.com/simonmichael/hledger/)
<!-- &nbsp; -->
<!-- [![...](https://api.travis-ci.org/simonmichael/hledger.svg?branch=master)](https://travis-ci.org/simonmichael/hledger/builds){title="Travis"} -->
<!-- &nbsp; -->
<!-- [![...](https://ci.appveyor.com/api/projects/status/5vejw0w5n5igdr42?svg=true)](https://ci.appveyor.com/project/simonmichael/hledger/history){title="Appveyor"} -->
</div>
2018-04-28 21:46:42 +03:00
<div class="container">
<div class="row">
<div class="col-sm-3">
2018-04-28 21:46:42 +03:00
<div id=introduction class=contentbox>
## Introduction
2014-11-12 01:55:23 +03:00
**[What is hledger ?](intro.html)**\
More about hledger's features.
2014-11-12 01:55:23 +03:00
**[accounting?](Accounting-links.html)**\
2018-04-28 21:46:42 +03:00
Tracking your use of valuable commodities, such as money or time, for increased awareness and effectiveness.\
**[plain text accounting?](http://plaintextaccounting.org)**&nbsp;&rarr;\
Using plain text data formats and version control for reliable, transparent accounting.\
2018-04-28 21:46:42 +03:00
</div>
2015-11-08 23:24:22 +03:00
2018-04-28 21:46:42 +03:00
<div id=help class=contentbox>
## Help/Feedback
|
|-------------------|----------------------------------------------------------------------------|
| IRC: | <small>[#hledger](http://irc.hledger.org) on Freenode <!-- [chat log](http://ircbrowse.net/browse/hledger); --> <!-- see also [#ledger](http://webchat.freenode.net?channels=ledger&randomnick=1) --> <!-- *Quick help and background chat.* --> <!-- *If you don't get an answer promptly, you can type `sm` to alert me, or leave the window open and check back later.* --></small>
| Twitter: | <small>[#hledger,<br>#plaintextaccounting](#twitter)</small>
| Reddit: | <small>[/r/plaintextaccounting](https://www.reddit.com/r/plaintextaccounting/)</small>
| Hacker News: | <small>[stories](https://hn.algolia.com/?query=hledger&sort=byDate&prefix&page=0&dateRange=all&type=story), [comments](https://hn.algolia.com/?query=hledger&sort=byDate&prefix=false&page=0&dateRange=all&type=comment)</small>
| Mail list: | <small>[list.hledger.org](http://list.hledger.org), [hledger@googlegroups.com](mailto:hledger@googlegroups.com)</small>
| Issues: | <small>[bugs.hledger.org](http://bugs.hledger.org)&nbsp;(bugs), [issues.hledger.org](http://issues.hledger.org)&nbsp;(all), [open issues](CONTRIBUTING.html#open-issues)&nbsp;(overview)</small>
| Other: | <small>[simon@joyful.com](mailto:simon@joyful.com)</small>
2018-04-28 21:46:42 +03:00
</div> <!-- column -->
2018-04-28 21:46:42 +03:00
</div>
<div class="col-sm-3">
2018-04-28 21:46:42 +03:00
<div id=reference class=contentbox>
## Reference
2014-11-12 03:39:22 +03:00
2018-04-28 21:46:42 +03:00
**[Release notes](release-notes.html)**\
What's new in each hledger version.
2018-04-28 21:46:42 +03:00
**[User manual](manual.html)**\
The main hledger manuals combined on one page for easy searching.
Includes:
2014-11-12 03:39:22 +03:00
2018-04-28 21:46:42 +03:00
<div class=subcontent>
[hledger](hledger.html)\
the command-line UI
2018-04-28 21:46:42 +03:00
[hledger-ui](hledger-ui.html)\
a curses-style UI
2014-11-12 03:39:22 +03:00
2018-04-28 21:46:42 +03:00
[hledger-web](hledger-web.html)\
a web UI
2014-11-12 01:55:23 +03:00
2018-04-28 21:46:42 +03:00
[hledger-api](hledger-api.html)\
a HTTP JSON server
2014-11-12 01:55:23 +03:00
2018-04-28 21:46:42 +03:00
[journal format](journal.html)\
hledger's native file format
2018-04-28 21:46:42 +03:00
[csv format](csv.html)\
hledger's CSV import system
2018-04-28 21:46:42 +03:00
[timeclock format](timeclock.html)\
a file format for precise time logging
2018-04-28 21:46:42 +03:00
[timedot format](timedot.html)\
a file format for human-friendly approximate time logging
</div>
</div>
<div id=dev class=contentbox>
## Contribute
**[Contributor Guide](CONTRIBUTING.html)**\
What's to do and how to do it
**Help fund hledger!**\
Making good software and documentation costs a lot.
<a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&amp;hosted_button_id=5J33NLXYXCYAY"><img width=62 height=31 border=0 src="https://www.paypal.com/en_US/i/btn/x-click-but04.gif" title="Give one time or recurringly with Paypal" alt="paypal"></a>
<a href="https://opencollective.com/hledger#support"><img border="0" src="https://opencollective.com/hledger/backers/badge.svg" title="Back us with a monthly donation at Open Collective" alt="open collective backers"></a>
<a href="https://opencollective.com/hledger#support"><img border="0" src="https://opencollective.com/hledger/sponsors/badge.svg" title="Sponsor us with a $100+ monthly donation at Open Collective and get your organization's logo on our README" alt="open collective sponsors"></a>
\
<a href="https://www.bountysource.com/trackers/536505-simonmichael-hledger"><img border=0 src="https://www.bountysource.com/badge/tracker?tracker_id=536505" title="Contribute or claim issue bounties via Bountysource" alt="bountysource"></a>
<!-- <a href="https://flattr.com/submit/auto?user_id=simonmichael&amp;url=http%3A%2F%2Fhledger.org" target="_blank"><img border="0" src="//api.flattr.com/button/flattr-badge-large.png" alt="" title="Give monthly with Flattr" alt="flattr"></a> -->
</div>
2018-04-28 21:46:42 +03:00
</div> <!-- column -->
<div class="col-sm-4">
2015-05-26 04:15:02 +03:00
2018-04-28 21:46:42 +03:00
<div id=wiki class=contentbox>
<div class=subcontent>
<!-- WIKICONTENT -->
## [[Cookbook|Home]]
2019-01-20 03:49:36 +03:00
### Getting started
[[hledger basics tutorial]]
[[hledger terminology]]
[[Create a journal]]
[[hledger accounting concepts]]
[[Common journal entries]]
[[FAQ]]
2019-02-12 04:25:42 +03:00
[[Accounting links]]
2019-01-20 03:49:36 +03:00
### Managing data
2019-01-20 03:49:36 +03:00
[[Convert CSV files]]
[[Customize default CSV accounts]]
[[Track changes with version control]]
[[Use another account separator character]]
2019-01-20 03:49:36 +03:00
### Reporting
[[Queries]]
[[hledger tags tutorial]]
[[Rewrite account names]]
2019-01-20 03:49:36 +03:00
2019-03-16 03:41:33 +03:00
### Real world setups
2019-03-06 20:46:37 +03:00
2019-03-09 00:00:12 +03:00
[[About real world setup docs]]
2019-03-06 20:46:37 +03:00
["Full-fledged Hledger" tutorial](https://github.com/adept/full-fledged-hledger)&nbsp;&rarr;
2019-04-07 00:00:04 +03:00
["Hledger Flow" tutorial & slideshow](https://github.com/apauley/hledger-flow)&nbsp;&rarr;
2019-03-09 00:26:03 +03:00
[[Simons setup]]
2019-03-06 20:46:37 +03:00
2019-01-20 03:49:36 +03:00
### Accounting tasks
[[hledger multicurrency tutorial]]
[[Foreign trip expenses]]
[[Budgeting and forecasting]]
[[Project accounting]]
[[Track investments]]
[[Time planning]]
2019-01-20 03:49:36 +03:00
### Usage tips
[[Addons]]
2019-02-12 23:13:24 +03:00
[[Command-line completion]]
2019-02-12 20:51:51 +03:00
[[Editor configuration]]
2019-02-25 08:33:00 +03:00
[[hledger-web tips]]
[[Mobile apps]]
[[Save frequently used options]]
2019-02-12 04:25:42 +03:00
[[Scripting]]
2019-01-20 03:49:36 +03:00
2019-02-12 04:25:42 +03:00
### See also...
2019-01-20 03:49:36 +03:00
2019-02-12 04:25:42 +03:00
[plaintextaccounting.org](http://plaintextaccounting.org)
([software](http://plaintextaccounting.org/#software),
[docs](http://plaintextaccounting.org/#docs),
[common&nbsp;tasks](http://plaintextaccounting.org/#common-tasks),
2019-02-12 04:25:42 +03:00
[discussion](http://plaintextaccounting.org/#discussion))
&nbsp;&rarr;
[Ledger](http://ledger-cli.org)
([docs](https://www.ledger-cli.org/docs.html),
2019-02-12 04:25:42 +03:00
[wiki](https://github.com/ledger/ledger/wiki))
&nbsp;&rarr;
[Beancount](http://furius.ca/beancount)
([docs](http://furius.ca/beancount/doc/index))
&nbsp;&rarr;
2018-04-28 21:46:42 +03:00
<!-- ENDWIKICONTENT -->
</div>
</div>
2018-04-28 21:46:42 +03:00
</div> <!-- column -->
</div> <!-- row -->
</div> <!-- container -->