The following programs and libraries are required, see their respective documentation for installation instructions.
Chart uses an ExtUtils::MakeMaker
build system. A basic build and
install can be made as follows. This will install under ‘/usr/local’.
perl Makefile.PL make make install
The usual ExtUtils::MakeMaker
options and build targets are available.
Here are some other notes,
Various optional features and their required Perl modules are set out in the
optional_features
section of META.yml. Some of the smart Perl
install tools might offer them in an automated way, otherwise look at
META.yml or Makefile.PL and install desired things manually.
The most interesting options include Finance::Quote
(see Finance Quote), Genius Trader and TA-Lib (see Other Indicator Packages).
If suitable modules are available then LWP is set to request compression in
HTTP downloads. Various servers will do this and it saves download size when
the server does. Gzip is the most common and its decompression uses
IO::Uncompress::Gunzip
which comes with Perl so should be available
always.
For https
protocol the LWP::Protocol::https
module is required.
In libwww 6 and up it comes separately and expresses its required supporting
modules. In libwww 5 see its README.SSL on the recommended
Crypt::SSLeay
module (using OpenSSL). Many data sources need
https
, including Yahoo Finance.
The source for the manual you’re now reading is doc/chart.texi, in Texinfo format (see Texinfo in Texinfo).
HTML format chart.html is installed as
lib/App/Chart/doc/chart.html with the source code. It can be viewed
with the Help commands within Chart, or with any browser. The following
make
targets can build other formats,
make info # Info make dvi # TeX DVI make ps # PostScript make pdf # PDF
producing files doc/chart.info, doc/chart.dvi, etc. They need
enough of Chart’s Perl dependencies installed to run the doc/weights.pl
script, then Info requires makeinfo
(see Creating an Info File in Texinfo) and DVI, PS and PDF require various TeX and Texinfo
tools. PDF also requires either epstopdf
from Texlive or TeTeX, or
ps2pdf
from Ghostscript.
makeinfo
can produce other formats, including DocBook and XML
(see Options for makeinfo
in Texinfo).
A Scrollkeeper entry
(http://scrollkeeper.sourceforge.net) doc/chart.omf is included
for the manual (HTML form). It can be used by Gnome help (Yelp) and similar
programs. Currently it’s not automatically installed but you can copy to
/usr/share/omf/chart/chart.omf and run scrollkeeper-update
.
The default directory for Chart downloaded data and configurations is
~/Chart, ie. a Chart subdirectory of the user’s home
directory. The CHART_DIRECTORY
environment variable can be set to a
different directory if something else is preferred, or perhaps to experiment
or keep some things separate.
Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2014, 2015, 2016, 2017, 2019, 2023, 2024 Kevin Ryde
Chart is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.