Configure the make call
PerlPointCD configurations are mostly done by makefile
macros. As usual with make
, those macros can be modified in the makefile
or overwritten by assignments passed to make
.
Here is a list of the available settings.
Macro | Description |
PERL | the command to invoke perl |
PPCD | the directory of PerlPointCD tools, usually PerlPointCD |
PREPARE | the directory of user preparations, usually prepare |
BUILD | the directory to build the CD in, usually build |
STYLES | the root directory of PerlPoint styles (or layouts), usually ${PREPARE}/styles |
DEFAULTS | the directory of defaults, usually ${PREPARE}/defaults |
IMAGESRCDIR | the directory to find images in when parsing the PerlPoint sources, relative to the tool start directory, usually ${BUILD}/images |
IMAGEREFDIR | the directory to display images from in generated pages, relative to the CD root, usually images |
DATA | the base directory of the talk directory structure, usually ${BUILD}/data |
CONFERENCE | the title of the current workshop, used when building links to the workshop startup page in author and module index entries |
PROJECT | the base name of the PerlPointCD script, demo-cd in this distribution |
TITLE | the title displayed in generated pages |
TOCTITLE | the title of the TOC page, usually "Contents" |
CDAUTHORMAIL | the mail address of the conference organizers, stored in generated meta tags |
CDDESCRIPTION | CD description string, stored in generated meta tags |
CDINITIALURL | initial startup URL of the CD - used when linking to the startup page and only working if the CD is installed on a Webserver, usually /index.html |
CDSTARTURL | CD start URL (including server name), used when generating validation links |
TALKSTYLEORDER | talk style order configuration |
INITFILE | initial PerlPoint file to declare macros, variables, code etc. available to all team members and contributing speakers |
INTROTITLE | title of the optional intro page |
INTROFILE | an optional intro page |
IMPRESSUM | an optional impressum |
IMPORTFILTERDIR | directory of pluggable import filters |
IMPORTORDER | the order alternative formats should be taken into account if a PerlPoint source is missing (e.g. if author.pod or author.wiki should be chosen if there is no author.pp , both files exist and filters were defined for both) |
DEFAULT_LANGUAGE | configures the default language of generated texts |
CHECKLOG | the logfile written in check mode, overwritten by each checking call |
CHECKDATA | a data file used in check mode, overwritten by each checking call |
TRACE | PerlPoint trace level, see the documentation of pp2html for details |
INDEXREL_READDEPTH | index based cross references: number of sublevels to be searched for index entries on referencing pages, defaults to full |
INDEXREL_RELDEPTH | index based cross references: number of sublevels to be taken into account on referenced pages, defaults to full |
INDEXREL_THRESHOLD | index based cross references: threshold, defaults to 20% |