blob: beb8d637d3b6a48d33192f317b9f6e006ee9eec2 (
plain)
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
All HTML files are generated from WML source.
If you wish to generate/view the HTML files locally, you'll need to
have wml and texi2html installed. To make the HTML files, just
type "make".
Quick and dirty "How To"
How to create a webpage:
1. When working in a subdirectory, begin the page with:
#!wml --include=..
2. Add:
#include "include/layout.wml"
3. Add <subject "page title">
this will set the page title to:
"page title - GNU Project -Free Software Foundation (FSF)"
4. Write your contents. Use the following pattern:
<box>
<boxtitle>...section title...</boxtitle>
<boxitem>...section contents...</boxitem>
<boxtitle>...section title...</boxtitle>
<boxitem>...section contents...</boxitem>
</box>
5. To change the menu entries, edit include/layout.wml
6. Call make to build the pages.
7. Set "CLASSPATH_WEBROOT" to a directory before calling "make publish"
to deploy the pages locally
A few useful tags (defined in layout.wml)
* <createlink name="name" url="url>
creates a <a href="url">name</a> entry
Some pages define their own tags (e.g. faq.wml, tools.wml, downloads.wml)
to organize their content.
Guide to the custom-defined tags
--------------------------------
Links
Description:
creates a <a href="url">name</a> entry; if name is missing, uses the url
as name
Availability:
everywhere (defined in macros.wml)
Format:
<createlink name="name" url="url>
<createlink url="url>
Commented code
Description:
creates a commented code example
Availability:
everywhere (defined in macros.wml)
Format:
<commented-code>
<code-line code="1st code-line">comment to 1st line of code</code-line>
<code-line code="2nd code-line">comment to 2nd line of code</code-line>
<code-line code="3rd code-line" />
</commented-code>
FAQ-Lists
<faq-section name="section name">
<faq question="1st question">
1st answer
</faq>
<faq question="2nd question">
2nd answer
</faq>
</faq-section>
<faq-section name="section name">
<faq question="1st question">
1st answer
</faq>
</faq-section>
Project Tables
Description:
Define a project in a project table
Example:
stories.wml
Availability:
everywhere (defined in macros.wml)
Format:
<project-list>
<project name="proj name" url="proj url">
project description
</project>
<project name="proj name" url="proj url">
project description
</project>
</project-list>
|
