Logiweb(TM)

6.3.6 User rendering

Prev Up Next Page 65 of 800 Search internet


In the previous step, when you did cd foo and ls base, you saw that the rendering directory base contained a subdirectory named page. The page subdirectory contains the user rendering. Thus, the rendering directory contains all of the rendering and the page subdirectory contains the part of the rendering which is under user control.

Now do cd foo/base to get to the rendering directory of the base page and then ls page to list the contents of the user rendering subdirectory. The user rendering subdirectory contains the following:

page.tex
The latex source of the main document of the rendering. This file is generated by the lgc compiler during rendering according to instructions in base.lgs.
page.pdf
The page.tex source translated to pdf. The index.html file in the rendering directory points to page.pdf. The page.pdf file is not generated directly by the lgc compiler. Rather, lgc generates it by invoking latex, bibtex, makeindex, latex, makeindex, latex, and dvipdfm in that order. That sequence is specified in base.lgs.
page.bib
The bibliography used when translating page.tex. page.bib is generated by the lgc compiler during rendering. The contents are defined in base.lgs.
page.*
All the other files starting with 'page' are temporary files generated by latex, bibtex, and makeindex. You may find these files handy if something goes wrong during rendering. As an example, if you get an Error running latex message, then the .log file will tell what went wrong.
chores.*
Same as page.* except that the contents are less interesting to the intended reader. Rendering can result in any number of documents in any number of formats. By convention, page.pdf should contain the information which is of most interest to the intended reader.
diagnose.*
When the page is incorrect, diagnose.pdf contains a typeset version of the error message. The index.html file in the rendering directory points to diagnose.pdf.
index.html
A file generated during rendering. The contents are defined in base.lgs. The index.html file in the rendering directory points to index.html in the user rendering subdirectory. By convention, index.html in the user rendering subdirectory should point to all pdf files, possibly except diagnose.pdf.
logiweb.eps
Logo in eps format used in diagnose.pdf. It can also be used from the other pdf files.
lgwinclude.tex
File which one can \input{lgwinclude} in .tex files. Among other, it defines \today on basis of the timestamp of the page being rendered.
bin/
Executable programs defined by base.lgs as explained in the next section. By convention, such programs are collected in the bin subdirectory of the user rendering subdirectory.

You may also view the user rendering directory using the an html browser. As an example, if you use Firefox, you may cd to foo and start it thus:

   firefox base/index.html &

Doing so will get you to a page which looks like this. The three links under the 'Rendering' heading are links to page.pdf, index.html, and diagnose.pdf in the user rendering directory.

Prev Up Next Page 65 of 800 Search logiweb.eu

Copyright © 2010 Klaus Grue, GRD-2010-01-05