File: README

package info (click to toggle)
aephea 12-248-3
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, buster, forky, sid, trixie
  • size: 1,092 kB
  • sloc: sh: 774; makefile: 66
file content (34 lines) | stat: -rw-r--r-- 1,389 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

   Aephea is an HTML authoring framework.  It enforces HTML well-formedness
   with a simpler and stricter syntax, provides useful extensions and
   abstractions as well as facilities for adding new ones, all in a single
   unified approach that stays close to HTML itself.

   PUD (Portable Unix Documentation) is shipped with Aephea.  It provides
   mini-languages for authoring Unix manual pages and FAQ documents with output
   both in HTML and troff.

   Both Aephea and PUD are written in zoem, a high-level macro/programming
   language with character filtering capabilities. It is recommended to install
   Aephea with

      ./configure --prefix=$PREFIX.

   Files will be installed in $PREFIX/share/aephea, e.g.

      $PREFIX/share/aephea/aephea/simpledocument.zmm
      $PREFIX/share/aephea/aephea/simpledocument.css
      $PREFIX/share/aephea/pud/man.zmm
      $PREFIX/share/aephea/pud/faq.zmm

   Files with suffix zmm are loaded in Aephea documents like this:

      \import{aephea/simpledocument.zmm}     \: for HTML document.
      \import{pud/man.zmm}                   \: for (Unix) manual page.
      \import{pud/faq.zmm}                   \: for FAQ.

   In order to have zoem find the Aephea definition and CSS files
   automatically, install it (from the unpacked zoem sources) with

      ./configure --with-includepath=$PREFIX/share/aephea --prefix=$OTHERPREFIX