mirror of https://github.com/CGAL/cgal
76 lines
3.3 KiB
Plaintext
76 lines
3.3 KiB
Plaintext
========================================================================
|
|
Installation of the Manual package
|
|
========================================================================
|
|
|
|
In order to be able to create CGAL's manuals you need to do the following:
|
|
|
|
(1) install the manual conversion tools (available as package Manual_tools
|
|
on the CVS server or from http://www.cgal.org/Members/Manual_tools)
|
|
|
|
(2) make the style files in 'sty/' accessible for LaTeX, e.g.,
|
|
by adding the path to the TEXINPUTS environment variable (colon
|
|
seperated list of paths).
|
|
|
|
make the style files in 'htmlsty/' accessible for the latex_to_html
|
|
converter, e.g., by adding the path the to the LATEX_CONV_INPUTS
|
|
environment variable (colon seperated list of paths).
|
|
|
|
make 'doc_tex/cgal_manual.bib' accessible for BiBTeX, e.g., by
|
|
adding the path to the BIBINPUTS environment variable (colon seperated
|
|
list of paths).
|
|
|
|
(3) make the scripts in 'scripts/' accessible via the standard execution path.
|
|
as well as the ps2pdf program (used in scripts/to_pdf).
|
|
|
|
Most of the scripts are shell scripts, which assume sh to be located in
|
|
/bin/sh. If this is not the case(!), edit the scripts to indicate the
|
|
proper location. The scripts bibmerge and rmbibcomments (which you
|
|
probably won't need to use) are Perl scripts and should also be edited
|
|
to indicate the proper location of your Perl installation.
|
|
|
|
|
|
(4) Set the following environment variables:
|
|
BIBINPUTS should include the path of geom.bib
|
|
TEXINPUTS should include the path of cc_manual.sty,
|
|
cc_manual_index.sty, etc.
|
|
LATEX_CONV_CONFIG should be set the location of config files
|
|
for HTML conversion
|
|
LATEX_CONV_BIN should be set to the location of bin files for
|
|
for HTML conversion
|
|
|
|
(5) Edit the following lines in the doc_tex_skel/makefile as necessary to
|
|
indicate the correct destination of the results
|
|
|
|
TEST_DESTINATION=/www/pub/www.cgal.org/Members/Manual_test
|
|
TEST_SUBDIR=test_manual
|
|
DESTINATION=/www/pub/www.cgal.org/Manual
|
|
DOC_PS_DESTINATION=$(DESTINATION)
|
|
DOC_PDF_DESTINATION=$(DESTINATION)
|
|
DOC_HTML_DESTINATION=$(DESTINATION)
|
|
DOC_DOWNLOAD_DIR=/ftp/pub/outgoing/CGAL
|
|
|
|
(6) Edit these lines in doc_tex_skel/makefile to indicate the correct source
|
|
for frame set and include files needed when creating a final release
|
|
manual:
|
|
|
|
HTML_FRAME_SOURCE=/KM/usr3/cgal/web_pages/Manual
|
|
INCLUDE_SOURCE=/KM/usr3/cgal/releases/CGAL-2.3/
|
|
|
|
(7) In the file scripts/install_manual_files, edit the following line as
|
|
necessary to indicate the source of the doc_tex directory
|
|
|
|
SOURCE_DIR="/KM/projects/CGAL/Work_in_Progress/CGAL_autotest/$VERSION"
|
|
|
|
(8) In the file scripts/autotest_cgal_manual, edit the following lines
|
|
CGAL_MANUAL_TEST_DIR="/KM/usr3/cgal/manual"
|
|
MANUAL_TEST_URL="http://www.cgal.org/Members/Manual_test/${CGAL_RELEASE_ID}.manual_test.html"
|
|
|
|
(9) Edit the following line in scripts/to_pdf
|
|
|
|
DISTILL="/opt/adobe/AcroDist_2.1/bin/distill"
|
|
|
|
to indicate the proper location of your local distill installation.
|
|
|
|
|
|
Follow the directions in the README file in this directory to create a manual.
|