Rewrite to static site
With a complete reorganisation of the directory structure and most of the content converted to pandoc-flavoured markdown. Some TODO's left before this can go live: - Main page - Atom feeds - Bug tracker
This commit is contained in:
parent
5c85a7d32f
commit
6242b2ee9c
291 changed files with 4346 additions and 6141 deletions
156
dat/ncdc/install.md
Normal file
156
dat/ncdc/install.md
Normal file
|
|
@ -0,0 +1,156 @@
|
|||
% Ncdc Installation Instructions
|
||||
|
||||
# General instructions
|
||||
|
||||
## Building from source
|
||||
|
||||
In theory, the following instructions should work everywhere:
|
||||
|
||||
- Install the required dependencies: ncurses, bzip2, zlib, sqlite3, glib2 and gnutls,
|
||||
- Download and extract the source tarball from the [homepage](/ncdc),
|
||||
- `./configure`
|
||||
- `make`
|
||||
- And then run `make install` with superuser permissions.
|
||||
|
||||
In practice, however, this does not always work and may not always be the
|
||||
prefered method of installation. On this page I try to collect instructions for
|
||||
each OS and distribution to make the installation process a bit easier for
|
||||
everyone.
|
||||
|
||||
If your system is missing from this page or if you're still having trouble,
|
||||
don't hesitate to join the support hub at `adc://dc.blicky.net/` or send me a
|
||||
mail at [projects@yorhel.nl](mailto:projects@yorhel.nl). Contributions to this
|
||||
page are of course highly welcomed as well. :-)
|
||||
|
||||
## Statically linked binaries
|
||||
|
||||
If you just want to get ncdc running without going through the trouble of
|
||||
compiling and/or installing it, I also offer statically linked binaries:
|
||||
|
||||
- [Linux, 64-bit](/download/ncdc-linux-x86_64-1.20-6-g5111a.tar.gz)
|
||||
- [Linux, 32-bit](/download/ncdc-linux-i486-1.20-6-g5111a.tar.gz)
|
||||
- [Linux, ARM](/download/ncdc-linux-arm-1.20-6-g5111a.tar.gz)
|
||||
|
||||
To use them, simply download and extract the tarball, and then run `./ncdc` on
|
||||
the command line.
|
||||
|
||||
The binaries include all the required dependencies and are linked against
|
||||
[musl](http://www.etalabs.net/musl/), so they should run on any Linux machine
|
||||
with the right architecture. If you want binaries for an other OS or
|
||||
architecture, please bug me and I'll see what I can do.
|
||||
|
||||
# System-specific instructions
|
||||
|
||||
## Android
|
||||
|
||||
An [convenient installer](http://code.ivysaur.me/ncdcinstaller.html) is
|
||||
available for Android 2.3 and later, which makes use of the static binary.
|
||||
|
||||
## Arch Linux
|
||||
|
||||
Ncdc is available on [AUR](https://aur.archlinux.org/packages/ncdc/), to
|
||||
install it you can use your favorite AUR-installer. If you don't have a
|
||||
favorite, go for the manual approach:
|
||||
|
||||
wget https://aur.archlinux.org/cgit/aur.git/snapshot/ncdc.tar.gz
|
||||
tar -xf ncdc.tar.gz
|
||||
cd ncdc
|
||||
makepkg -si
|
||||
|
||||
## Fedora
|
||||
|
||||
There's a [package](https://apps.fedoraproject.org/packages/ncdc/overview/)
|
||||
available for Fedora.
|
||||
|
||||
## FreeBSD
|
||||
|
||||
Ncdc is available in the Ports Collection. To install, [make sure your
|
||||
collection is
|
||||
up-to-date](http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html)
|
||||
and install the Port as any other:
|
||||
|
||||
cd /usr/ports/net-p2p/ncdc
|
||||
make install clean
|
||||
|
||||
## Gentoo
|
||||
|
||||
Ncdc is available in the Portage tree, so installation is trivial:
|
||||
|
||||
emerge ncdc
|
||||
|
||||
## Mac OS X
|
||||
|
||||
Ncdc is available in [Homebrew](http://braumeister.org/formula/ncdc).
|
||||
|
||||
## OpenIndiana
|
||||
|
||||
This has been tested on OpenIndiana Build 151a Server, but may work on other
|
||||
versions as well. Compiling from source is your only option at the moment.
|
||||
First install some required packages (as root):
|
||||
|
||||
pkg install gcc-3 glib2 gnutls gettext header-math perl-510/extra
|
||||
|
||||
Then, fetch the ncdc source tarball, extract and build as follows:
|
||||
|
||||
wget https://dev.yorhel.nl/download/ncdc-1.20.tar.gz
|
||||
tar -xf ncdc-1.20.tar.gz
|
||||
cd ncdc-1.20
|
||||
export PATH="$PATH:/usr/perl5/5.10.0/bin"
|
||||
./configure --prefix=/usr LDFLAGS='-L/usr/gnu/lib -R/usr/gnu/lib'
|
||||
make
|
||||
|
||||
And finally, to actually install ncdc, run `make install` as root. You can
|
||||
safely revert `$PATH` back to its previous value if you wish, it was only
|
||||
necessary in order for `./configure` and `make` to find `pod2man`.
|
||||
|
||||
## OpenSUSE
|
||||
|
||||
Get the package from [PackMan](http://packman.links2linux.org/package/ncdc):
|
||||
Select your openSUSE release and hit the "1 click install" button.
|
||||
|
||||
## Ubuntu & Debian
|
||||
|
||||
The preferred way of installing ncdc on Ubuntu or Debian is to use the static
|
||||
binaries provided above.
|
||||
|
||||
Alternatively, you can also try to compile ncdc from source. To do so, first
|
||||
install the required libraries:
|
||||
|
||||
sudo apt-get install libbz2-dev libsqlite3-dev libncurses5-dev\
|
||||
libncursesw5-dev libglib2.0-dev libgnutls-dev zlib1g-dev
|
||||
|
||||
Then run the following commands to download and install ncdc:
|
||||
|
||||
wget https://dev.yorhel.nl/download/ncdc-1.20.tar.gz
|
||||
tar -xf ncdc-1.20.tar.gz
|
||||
cd ncdc-1.20
|
||||
./configure --prefix=/usr
|
||||
make
|
||||
sudo make install
|
||||
|
||||
## Windows (Cygwin)
|
||||
|
||||
Surprisingly enough, ncdc can be used even on Windows, thanks to Cygwin. If
|
||||
you haven't done so already, get `setup.exe` from the [Cygwin
|
||||
website](http://cygwin.com/) and use it to install the following packages:
|
||||
|
||||
- make
|
||||
- gcc4
|
||||
- perl
|
||||
- pkg-config
|
||||
- wget
|
||||
- zlib-devel
|
||||
- libncursesw-devel
|
||||
- libbz2-devel
|
||||
- libglib2.0-devel
|
||||
- libsqlite3-devel
|
||||
- gnutls-devel
|
||||
|
||||
Then open a Cygwin terminal and run the following commands to download,
|
||||
compile, and install ncdc:
|
||||
|
||||
wget https://dev.yorhel.nl/download/ncdc-1.20.tar.gz
|
||||
tar -xf ncdc-1.20.tar.gz
|
||||
cd ncdc-1.20
|
||||
./configure --prefix=/usr
|
||||
make install
|
||||
Loading…
Add table
Add a link
Reference in a new issue