sharpetronics/callirhoe
1
0
Fork 0
mirror of https://github.com/oDinZu/callirhoe.git synced 2025-02-22 00:04:52 -05:00
Code Issues Projects Releases Wiki Activity

documentation

Browse Source 
git-svn-id: https://callirhoe.googlecode.com/svn/branches/phantome@232 81c8bb96-aa45-f2e2-0eef-c4fa4a15c6df
This commit is contained in:
geortz@gmail.com 2014-11-06 17:02:32 +00:00
parent 7cd1161aef
commit c0f65af504
1 changed files with 28 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
INSTALL
View File

@ -9,7 +9,7 @@ QUICK INSTALLATION GUIDE
CONTENTS
1) FROM COMPRESSED ARCHIVE
2) FROM SVN
3) INVOKING callirhoe FROM PATH
3) INSTALLING INTO BINARY PATH
4) INSTALLATION FOR ARCH LINUX
(rough installation guide for novice users...)
@ -20,7 +20,8 @@ Download the latest version from the project's page,
or directly from:
https://callirhoe.googlecode.com/svn/wiki/releases/
You end up with a file named callirhoe-X.Y.Z.7z where X.Y.Z the version number (for example 0.4.0).
You end up with a file named callirhoe-X.Y.Z.7z where X.Y.Z the version
number (for example 0.4.0).
Extract the contents of the archive
$ 7z x callirhoe-X.Y.Z.7z
@ -32,7 +33,8 @@ Now you can launch the program, e.g.
$ ./callirhoe.py foo.pdf
See section 3 for how to install callirhoe so that it lies in your executable path.
See section 3 for how to install callirhoe so that it lies in your
executable path.
2) FROM SVN
@ -52,48 +54,48 @@ You can launch the program as usual:
$ ./callirhoe.py foo.pdf
3) INVOKING callirhoe FROM PATH
3) INSTALLING INTO BINARY PATH
You can add a link to your path, $HOME/bin or /usr/local/bin:
$ ln -s `pwd`/callirhoe.py $HOME/bin/callirhoe
You can do the same with calmagick.py. You may also install it system-wide,
for example in /opt. In this case, keep in mind, that ~/.callirhoe/ is also
searched for additional definitions, styles etc.
You can do the same with calmagick.py. You may also install it
system-wide, for example in /opt. In this case, keep in mind, that
~/.callirhoe/ is also searched for additional definitions, styles etc.
If you do not plan to mess with the source, you may create a binary python package.
This is not exactly a binary, it is a zip archive containing compiled python bytecode,
which is quite compact. To do so, go to the scripts directory:
If you do not plan to mess with the source, you may create a binary
python package. This is not exactly a binary, it is a zip archive
containing compiled python bytecode, which is quite compact. To do so,
simply run:
$ cd scripts
$ make
and run
This will create two executables, 'callirhoe' and 'calmagick'. Now you
can install them into your binary path as follows:
$ ./make_pkg
$ make install
This will create in the parent directory two executables, 'callirhoe' and 'calmagick'.
Now copy them to your binary path. And you can remove the source dir, as it is no longer
needed. You might want to copy the holiday data files first, if you want to use them
(callirhoe takes a full path to them, so you can store them wherever you want).
this will typically install to /usr/local/bin (and the holiday files into
/usr/local/share/callirhoe/holidays). You can specify another prefix:
On a linux system, you will additionally see a Makefile created, which you can alternatively
run with 'make install' to install the files in the standard places,
instead of manually copying them.
$ make install DESTDIR=/my/other/dir
Now you can remove the source dir, as it is no longer needed.
4) INSTALLATION FOR ARCH LINUX
There is a PKGBUILD file you can use to install.
You can get the PKGBUILD either from SVN or compressed archive or from AUR.
For the first two options, the method to get the source tree is described in sections 1 and 2,
while for the third option you can get it from here: <INSERT LINK HERE>
There is a PKGBUILD file you can use to install. Normally you get just
the PKGBUILD from the webpage from AUR (<INSERT LINK HERE>). It is also
included in the source distribution, but this is a bit redundant (see
below).
Place the PKGBUILD into a directory and run:
$ makepkg -si
( -s will automatically install missing depedencies )
( -s will automatically install missing depedencies; also note that this
will redownload the source from the svn )
Arch will do the rest for you.
@ -101,4 +103,3 @@ In the unlikely event that you don't have "makepkg" already installed
you can find information about it's installation here:
https://wiki.archlinux.org/index.php/Arch_User_Repository