From 27f9b0b00099f2190dceabcdbb4d9a31f13eb699 Mon Sep 17 00:00:00 2001 From: Simon Michael Date: Sun, 30 Oct 2016 06:38:33 -0700 Subject: [PATCH] doc, site: announcement, download page updates The latest install instructions, 2016/10 edition. [ci skip] --- doc/ANNOUNCE | 67 +++++++++-------------- site/download.md | 137 +++++++++++++++++++++++------------------------ 2 files changed, 94 insertions(+), 110 deletions(-) diff --git a/doc/ANNOUNCE b/doc/ANNOUNCE index 8b82d5e01..0c36401a1 100644 --- a/doc/ANNOUNCE +++ b/doc/ANNOUNCE @@ -1,6 +1,6 @@ -Attention, attention hledger-folk! Once again, Happy Hallowe'en. After -almost 10 years of steady development, I am very pleased to announce: -hledger's 1.0 release! +Attention, attention hledger-folk! Once again, Happy Hallowe'en. +After almost ten years of steady development, and one year since +our last major release, I am very pleased to announce.. _ _ _ _ ___ _ | |__ | | ___ __| | __ _ ___ _ __ / | / _ \ | | @@ -9,21 +9,18 @@ hledger's 1.0 release! |_| |_|_|\___|\__,_|\__, |\___|_| |_(_)___/ (_) |___/ -About the project: hledger is a cross-platform program for tracking -money, time, or any other commodity using double-entry accounting and -a simple plain text file format. Inspired by Ledger CLI, hledger -provides command-line, curses and web interfaces, and aims to be a -reliable, practical tool for daily use. +hledger's 1.0 release! It's about time! -Contributors to this release, one year in the making, include: -Simon Michael, Dominik Süß, Thomas R. Koll, Moritz Kiefer, -jungle-boogie, Sergei Trofimovich, Malte Brandy, Sam Doshi, -Mitchell Rosen, Hans-Peter Deifel, Brian Scott, and Andrew Jones. +hledger (http://hledger.org) is a cross-platform program for tracking +money, time, or any other commodity using double-entry accounting +and a simple plain text file format. +Inspired by Ledger CLI, hledger provides command-line, curses +and web interfaces, and aims to be a reliable, practical tool +for daily use. Notable changes since 0.27: -- the hledger.org website is simpler, clearer, and more - mobile-friendly +- the hledger.org website is simpler, clearer, and more mobile-friendly - docs have been reorganized, with more focussed manuals available in multiple versions, formats and as built-in help @@ -53,39 +50,27 @@ Notable changes since 0.27: - the project continues to grow. A call for help was sent out last month, and contributor activity is increasing -- the website http://plaintextaccounting.org was created as a portal - and knowledge base for hledger, Ledger, beancount and related tools - and practices. +- a new website, http://plaintextaccounting.org, has been created as a + portal and knowledge base for hledger, Ledger, beancount and related + tools and practices. -For full release notes see http://hledger.org/release-notes#hledger-1.0 +Full release notes: http://hledger.org/release-notes#hledger-1.0 -How to install hledger: +Contributors to this release include: +Simon Michael, Dominik Süß, Thomas R. Koll, Moritz Kiefer, +jungle-boogie, Sergei Trofimovich, Malte Brandy, Sam Doshi, +Mitchell Rosen, Hans-Peter Deifel, Brian Scott, and Andrew Jones. -See http://hledger.org/download for all links and install options, -including Windows binaries. For example, +How to install: -$ stack install hledger [hledger-ui] [hledger-web] [hledger-api] +(Get stack, eg from http://haskell-lang.org/get-started) +$ stack install --resolver=nightly hledger [hledger-ui] [hledger-web] [hledger-api] $ ~/.local/bin/hledger --version -or: +or see http://hledger.org/download for more install options, +including cabal, OS packages and Windows binaries. -$ cabal sandbox init -$ cabal install hledger [hledger-ui] [hledger-web] [hledger-api] -$ .cabal-sandbox/bin/hledger --version - -or: - -$ apt install hledger [hledger-ui] [hledger-web] [hledger-api] -$ hledger --version - -or: - -$ brew install hledger -$ hledger --version - - -I hope you enjoy these tools and resources, and find them helpful in -achieving your goals. If you like hledger, your participation and -support is welcome. Onward and upward! +I hope you find these tools helpful in achieving your goals. +If you like hledger, your support and participation is welcome! -Simon diff --git a/site/download.md b/site/download.md index 5072b3cf5..01cb60801 100644 --- a/site/download.md +++ b/site/download.md @@ -7,10 +7,9 @@   # Download - + ## A. I want to download a packaged version - +Packaged versions may lag behind the latest release, but are the quickest to install. + | -|--------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ -| **Windows** | Download and run [hledger-0.26-win64.exe](http://hledger.org/downloads/hledger-0.26-win64.exe) & [hledger-web-0.26-win64.exe](http://hledger.org/downloads/hledger-web-0.26-win64.exe) (old), or the [latest development builds](developer-guide.html). hledger-ui does not run on Windows. -| **Mac** | `brew install hledger`
hledger-ui/hledger-web have not yet been added to homebrew. -| **Debian, Ubuntu** | `sudo apt install hledger hledger-ui hledger-web` -| **Fedora, RHEL** | `sudo dnf install hledger`
hledger-ui/hledger-web have not yet been added to Fedora. -| **Gentoo** | `sudo layman -a haskell && sudo emerge hledger hledger-ui hledger-web` -| **NixOS** | `nix-env -iA nixpkgs.haskellPackages.hledger \`
  `nixpkgs.haskellPackages.hledger-ui \`
  `nixpkgs.haskellPackages.hledger-web` +|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ +| **Windows:** | Download and run [hledger-0.26-win64.exe](http://hledger.org/downloads/hledger-0.26-win64.exe) & [hledger-web-0.26-win64.exe](http://hledger.org/downloads/hledger-web-0.26-win64.exe) (old), or the [latest development builds](developer-guide.html). hledger-ui does not run on Windows. +| **Mac:** | `brew install hledger`
hledger-ui/web/api have not yet been added to homebrew. +| **Debian, Ubuntu:** | `sudo apt install hledger hledger-ui hledger-web` +| **Fedora, RHEL:** | `sudo dnf install hledger`
hledger-ui/web/api have not yet been added to Fedora. +| **Gentoo:** | `sudo layman -a haskell && sudo emerge hledger hledger-ui hledger-web` +| **NixOS:** | `nix-env -iA nixpkgs.haskellPackages.hledger \`
  `nixpkgs.haskellPackages.hledger-ui \`
  `nixpkgs.haskellPackages.hledger-web` - + - +## B. I want to build the latest release - +The latest release (see [release notes](release-notes.html)) is a good choice. +You have to build it, but that's pretty easy. -## B. I want to build the latest released version - -The latest release may be newer than your OS's packaged version. -Here are the latest [release notes](release-notes.html). - -1. Install [`stack`](http://haskellstack.org) to make building easier. +1. Install [`stack`](http://haskell-lang.org/get-started). On Windows, the 64-bit version is [recommended](https://github.com/simonmichael/hledger/issues/275#issuecomment-123834252). -2. `stack setup`\ - to ensure you have a suitable version of [GHC](https://www.haskell.org/ghc). +2. `stack install --resolver=nightly hledger [hledger-ui] [hledger-web] [hledger-api]`\ + On Windows, hledger-ui is [not yet available](https://github.com/coreyoconnor/vty/pull/1).\ + If stack says you need to run `stack setup`, do that first.\ + Warnings about "No packages found in snapshot which provide a "hsc2hs" executable" can be ignored.\ + If required C libraries (like curses) are not installed, you might need to install those manually and try again, eg: -3. `stack install hledger [hledger-ui] [hledger-web]`\ - hledger-ui and hledger-web take longer to build. hledger-ui is not buildable on Windows. + | + |--------------------|----------------------------------- + | **Debian, Ubuntu:** | `sudo apt install libncurses5-dev` + | **Fedora, RHEL:** | `sudo dnf install ncurses-devel` -4. If stack warns that `~/.local/bin` or the Windows equivalent is not in your `$PATH`, - configure that, so that commands like `hledger` will work. +3. If stack warns that `~/.local/bin` (or the Windows equivalent) is not in `$PATH`, fix that. Eg if you're a bash user:\ - `echo "export PATH=$PATH:~/.local/bin" >> ~/.bashrc && source ~/.bashrc` - -Or use [`cabal`](https://www.haskell.org/cabal/) if you prefer and know how. -It's harder to use and to support, so these docs focus on stack. - -Haskell builds can fail due to missing C libraries or headers, which stack/cabal can not install. -If you have this problem, here are some C libs you might need (please send updates): - -| -|--------------------|----------------------------------- -| **Debian, Ubuntu** | `sudo apt install ... ?` -| **Fedora, RHEL** | `sudo dnf install ncurses-devel` - - - - -## C. I want to build the [latest development version](https://github.com/simonmichael/hledger/commits/master) - -This includes the latest features and is normally stable enough for daily use (it's what I use). - - -1. Install stack and GHC (steps 1 and 2 above) and [git](https://en.wikipedia.org/wiki/Git) -2. `git clone http://code.hledger.org hledger` -3. `cd hledger` -4. `stack install [hledger] [hledger-ui] [hledger-web] [hledger-api]` - -cabal users, try `./cabal-install.sh` instead. + `echo "export PATH=$PATH:~/.local/bin" >> ~/.bashrc && source ~/.bashrc`\ + Now you can run `hledger --version`, `hledger-ui --version` etc. +Installing with [`cabal`](https://www.haskell.org/cabal/) is similar, if you're familiar with that. + + + + + + +## C. I want to build the [development version](https://github.com/simonmichael/hledger/commits/master) + +The dev version includes not-yet-released features and is stable enough for daily use. + +1. Install [`stack`](http://haskell-lang.org/get-started) and [git](https://en.wikipedia.org/wiki/Git) +2. `git clone http://code.hledger.org hledger` +3. `cd hledger` +4. `stack install` + +cabal users can use the `./cabal-install.sh` or `cabal.project` instead. + +The same caveats as above apply: + +- if stack says you need to run `stack setup`, do that first, +- if building fails due to missing C libs, install those first +- if stack warns that `~/.local/bin` (or the Windows equivalent) is not in `$PATH`, fix that +- warnings about "No packages found in snapshot which provide a hsc2hs executable" can be ignored + +