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% |
