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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
|
Fri, Jan 8 2010
* aephea-10-008 released.
* Aephea is a HTML document framework. The name stands, grandiosely, for
Adaptable Exo-skeleton for Practical HTML Extension and Abstraction.
Aephea documents are written in a language called zoem, which is
a macro/programming language with a strict, compact and elegant syntax.
Aephea provides support for a single output device, HTML. It uses CSS to
a great extent to make document styling easily customized and controlled.
* PUD (Portable Unix Documentation) used to be shipped with zoem itself
but is now part of Aephea. PUD provides limited support for two mini
languages (manuals and FAQs) for two output devices, troff and HTML. The
troff device provides full-fledged UNIX manual pages.
* Backwards incompatible changes in PUD require modification of existing
documents.
- The import has changed. It is now \import{pud/man.zmm} rather than
\import{man.zmm}, similarly \import{pud/faq.zmm}.
- \par and \car with no arguments have been removed, and so
are \cpar#1 and \ccar#1.
- The itemize controls have changed.
NEW | OLD | Behaviour
----------------+-----------------+-----------------------------
{flow}{cascade} | {compact}{0} | Description below item
{flow}{compact} | {compact}{1} | Description follows item
----------------+-----------------+-----------------------------
{interitem}{1} | {contiguous}{0} | Skip between item sections
----------------------------------------------------------------
- The document is now itself encoded as an environment. The pre-amble
and post-ambles have gone (\"man::preamble" and \"man::postamble").
The pre-amble now becomes e.g.
\begin{pud::man}{
{name}{apparix}
{html_title}{apparix, augmenting the shell with directory bookmarks}
{keywords}{cd, change directory, bookmarks, command line, cdpath, subdirectory, tab completion}
{author}{Stijn van Dongen}
{section}{1}
{synstyle}{long}
{defstyle}{long}
{year}{2009}
{day}{18}
{month}{Jan}
{stamp}{09-018}
{tag}{Groovy Gazelle}
}
with post-amble
\end{pud::man}
|
