-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
99 lines (74 loc) · 3.64 KB
/
readme.txt
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
This repositry contains the html sources for the Free Pascal Home Page.
Some design rules:
------------------
- try to minimize the number of images
- don't use frames
- don't make a page bigger than one or two screens (assuming a
resolution of 800x600)
- each page needs a possibilty to go back
- no page should contain more than 5-7 links in the menu
- don't nest the level of pages deeper than 3
Using .adp files:
-----------------
The pages are marked up in an enhanced html language called adp. Extra
tags are provided to handle server-side preprocessing. The adp syntax is
documented in the file tags.txt.
To convert a .adp file into a .html file, the adp2html tool is used. The
command line opt
To convert a file to a .html file run:
adp2html -o output_file <input_file>
Catalog files:
--------------
Adp2html supports multilingual websites. A multilingual web site is created by
adding <TRN> tags to your adp files and supplying a catalog file to adp2html with
the translated texts.
For Free Pascal the catalog files are downloaded from the Community, you can do
this with the download_catalog script in svn. It doesn't make much sense to
modify these manually, since they are redownloaded regularily.
To modify translated texts, you have to update the website copy the
community has, by visiting
http://community.freepascal.org:10000/website/svn_update , then you modify
the texts by visiting the translatable website or the translation manager,
and run the download_catalog script.
Currently, translated texts get priority over untranslated text; even for
English. So, once a "translated" version of an English message is in the
Community database, the adp2html tool uses that. It is probably more
comfortable to give text in the .adp files prority, which is a future
change to the adp2html tool.
Commandline options:
--------------------
adp2html takes several commandline options
-c catalogfile Speficy the catalog file, the file with translated
texts to use.
-ce catalog_encoding Specify what character encoding the catalog file uses.
-d datasource_prefix This is where adp2html searched datasource files, for the
<MULTIPLE> tag
-ie input_encoding Specify what character encouding the input file uses.
-l locale Specify in what language you would like the html file
-lb fallback_locale If messages are not available in the preffered language
use messages in this language
-m default_master Specify the default master template, the template the
<MASTER> tag will use if no "src" attribute is present.
-p key=value Set a property to a value, which can be expanded in the
.adp file.
-o outputfile Specify the name of the html file
-oe output_encoding Specify the character encoding of the output file
Adding a page:
--------------
* Create the page
* Add it to generate_makefile.conf
* Regenerate the Makefile using "/path/to/generate_makefile > Makefile"
Adding a directory:
-------------------
* Create the directory.
* Create a generate_makefile.conf. Use another directory as example.
* Modify the generate_makefile script by adding a rule to descent into the
subdirectory. Search for "down_all" for an example.
MakeIdx tool:
-------------
makeidx makes a index for the page which is written using <A NAME="anchor></A>
parts. The line below the anchor contains the item name, which may be prefixed
and postfixed with <H3> and/or <LI>. The index is created/updated between the
tags <!-- STARTIDX --> and <!-- ENDIDX -->
It's especially made for the FAQ and Newsletters
Run: makeidx <file> It will update <file>