webgen 0.3.4 → 0.3.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/ChangeLog +201 -0
- data/Rakefile +3 -2
- data/TODO +31 -4
- data/VERSION +1 -1
- data/data/webgen/example/config.yaml +2 -0
- data/data/webgen/example/src/default.css +84 -0
- data/data/webgen/example/src/default.template +32 -0
- data/data/webgen/example/src/index.page +8 -0
- data/{doc/src → data/webgen/images}/generated_by_webgen.png +0 -0
- data/data/webgen/images/valid-css.gif +0 -0
- data/data/webgen/images/valid-xhtml11.png +0 -0
- data/data/webgen/images/webgen_logo.png +0 -0
- data/doc/config.yaml +2 -0
- data/doc/plugin/extension.rb +8 -4
- data/doc/plugin/resources.rb +30 -0
- data/doc/src/default.css +251 -149
- data/doc/src/default.template +8 -8
- data/doc/src/documentation/gettingstarted.page +1 -1
- data/doc/src/documentation/index.page +6 -2
- data/doc/src/documentation/plugins/filehandler/backing.page +22 -9
- data/doc/src/documentation/plugins/filehandler/galleryhandler.page +1 -1
- data/doc/src/documentation/plugins/filehandler/index.page +9 -4
- data/doc/src/documentation/plugins/filehandler/pagehandler.page +33 -10
- data/doc/src/documentation/plugins/index.page +9 -1
- data/doc/src/documentation/plugins/menustyles/horizontal-dropdown.page +42 -0
- data/doc/src/documentation/plugins/menustyles/horizontal.page +21 -0
- data/doc/src/documentation/plugins/menustyles/index.page +12 -0
- data/doc/src/documentation/plugins/menustyles/partial.page +27 -0
- data/doc/src/documentation/plugins/menustyles/vertical-dropdown.page +23 -0
- data/doc/src/documentation/plugins/menustyles/vertical.page +32 -0
- data/doc/src/documentation/plugins/resourcemanager.page +30 -0
- data/doc/src/documentation/plugins/tags/index.page +2 -2
- data/doc/src/documentation/plugins/tags/langbar.page +4 -4
- data/doc/src/documentation/plugins/tags/menu.page +6 -17
- data/doc/src/documentation/plugins/tags/navbar.page +2 -1
- data/doc/src/documentation/plugins/tags/resource.page +22 -0
- data/doc/src/download.page +1 -1
- data/doc/src/features.page +32 -9
- data/doc/src/index.page +24 -10
- data/doc/src/meta.info +16 -6
- data/install.rb +1 -1
- data/lib/webgen/configuration.rb +24 -2
- data/lib/webgen/node.rb +29 -5
- data/lib/webgen/plugin.rb +1 -5
- data/lib/webgen/plugins/contenthandler/textile.rb +3 -3
- data/lib/webgen/plugins/filehandler/backing.rb +5 -4
- data/lib/webgen/plugins/filehandler/directory.rb +3 -3
- data/lib/webgen/plugins/filehandler/filehandler.rb +8 -4
- data/lib/webgen/plugins/filehandler/page.rb +33 -18
- data/lib/webgen/plugins/filehandler/picturegallery.rb +10 -8
- data/lib/webgen/plugins/menustyles/defaultmenustyle.rb +73 -0
- data/lib/webgen/plugins/menustyles/horizontal.rb +93 -0
- data/lib/webgen/plugins/menustyles/horizontal_dropdown.rb +113 -0
- data/lib/webgen/plugins/menustyles/partial.rb +95 -0
- data/lib/webgen/plugins/menustyles/vertical.rb +107 -0
- data/lib/webgen/plugins/menustyles/vertical_dropdown.rb +107 -0
- data/lib/webgen/plugins/resourcemanager.rb +264 -0
- data/lib/webgen/plugins/tags/langbar.rb +9 -5
- data/lib/webgen/plugins/tags/menu.rb +4 -66
- data/lib/webgen/plugins/treewalker.rb +7 -6
- data/lib/webgen/webgen.rb +72 -161
- metadata +37 -6
- data/doc/src/logo.png +0 -0
@@ -73,7 +73,7 @@ Just add page files and other content to your website and let it grow!
|
|
73
73
|
h2. Using Meta Information in Pages
|
74
74
|
|
75
75
|
Meta information is specified at the beginning of a page file. Have a look at the
|
76
|
-
<a href="{relocatable: plugins/filehandler/pagehandler.
|
76
|
+
<a href="{relocatable: plugins/filehandler/pagehandler.page}">documentation</a> to see how that is done
|
77
77
|
in detail!
|
78
78
|
|
79
79
|
We are now going to use meta information to customize our website! Open the file @default.template@
|
@@ -48,9 +48,13 @@ If you want to get the configuration values you can run webgen like this
|
|
48
48
|
$ webgen show config
|
49
49
|
</pre>
|
50
50
|
|
51
|
+
(This information is also provided on this website, have a look at the
|
52
|
+
<a href="{relocatable: plugins}">plugins section</a>!)
|
53
|
+
|
51
54
|
The list shows sorted by the plugin name the current values and the default values for each
|
52
|
-
|
53
|
-
plugin name as top level key and each
|
55
|
+
parameter. Each parameter can be overridden in the configuration file by specifing the
|
56
|
+
plugin name as top level key and each parameter and value as a key/value pair. A configuration file
|
54
57
|
looks like this:
|
55
58
|
|
56
59
|
<pre class="webgen-file">{includeFile: /../../../testsite/config.yaml}</pre>
|
60
|
+
|
@@ -16,18 +16,31 @@ h2. File Format
|
|
16
16
|
|
17
17
|
The files are written in YAML and have a very easy structure:
|
18
18
|
<pre>
|
19
|
-
filename1.en.
|
20
|
-
|
21
|
-
|
22
|
-
|
23
|
-
|
19
|
+
filename1.en.page:
|
20
|
+
title: File one
|
21
|
+
orderInfo: 45
|
22
|
+
additional_metainfo: my_used_value
|
23
|
+
|
24
|
+
filename1.de.page:
|
25
|
+
title: German version of File one
|
26
|
+
|
27
|
+
docu/external.html:
|
28
|
+
dest: http://www.my-homepage.com
|
29
|
+
title: My external homepage
|
30
|
+
inMenu: true
|
24
31
|
</pre>
|
25
32
|
|
26
|
-
|
27
|
-
information
|
33
|
+
As you can see, you use the name of a file as top level key and then you specify every meta
|
34
|
+
information you want. You can use relative and absolute paths in the filenames. However, you cannot
|
35
|
+
specify meta information for files which are in one of the parent directories of the backing file.
|
36
|
+
|
37
|
+
If you want to set meta information for an existing page description file, you have to use the
|
38
|
+
<a href="{relocatable: pagehandler.page#naming}">standardified name</a> of that page description
|
39
|
+
file (e.g. @filename1.page@ or @filename1.de.page@).
|
28
40
|
|
29
41
|
Using backing files you can add virtual files and directories. If the file specified in the entry
|
30
42
|
does not exist, a node for that file will be created. This will also create the whole directory tree
|
31
|
-
this virtual node is in. It allows you, for example, to add external items to the menu.
|
32
|
-
to specify the +dest+ meta information which points to the actual location of the
|
43
|
+
this virtual node is in. It allows you, for example, to add external items to the menu. In this case
|
44
|
+
you need to specify the +dest+ meta information which points to the actual location of the
|
45
|
+
referenced page.
|
33
46
|
|
@@ -10,14 +10,19 @@ h2. Description
|
|
10
10
|
File handlers are used to handle different types of input files. You can see the currently exisiting
|
11
11
|
file handlers in the menu. Choose one to get a description for it!
|
12
12
|
|
13
|
-
Each file handler specifies path patterns
|
14
|
-
|
15
|
-
|
13
|
+
Each file handler specifies path patterns for the files he handles (you can see which paths are
|
14
|
+
handled by a file handler in its information section). During the processing of the website, the
|
15
|
+
FileHandler instance calls the approriate file handler for each file and builds the internal
|
16
|
+
representation of the source directory.
|
16
17
|
|
17
18
|
h2. Path Patterns
|
18
19
|
|
19
20
|
Path patterns are more like shell globs than regular expressions. One can use any path pattern that
|
20
|
-
the @Dir.glob@ method understands.
|
21
|
+
the @Dir.glob@ method understands. If two path patterns would match the same path, the one with
|
22
|
+
fewer asterisks and question marks is used because that one "seems" to be more specific.
|
23
|
+
|
24
|
+
|
25
|
+
Here are some examples:
|
21
26
|
|
22
27
|
table{border: 1px solid black}.
|
23
28
|
|^. <notextile><code>*/*.html</code></notextile>|^. All files with the extension @html@ in the subdirectories of the root source directory|
|
@@ -8,7 +8,7 @@ h2. Information
|
|
8
8
|
|
9
9
|
h2. Description
|
10
10
|
|
11
|
-
Page description files are used to specify the actual content for the website.
|
11
|
+
Page description files are used to specify the actual content for the website. They contain the
|
12
12
|
content for the webpage and, optionally, meta information.
|
13
13
|
|
14
14
|
h2(#structure). File format
|
@@ -35,7 +35,8 @@ This is the content of the file
|
|
35
35
|
In this example, meta information is specified ("more info":#meta). Note the three dashes at the
|
36
36
|
beginning of the file. This indicates that the following 'block' is used for meta information. If
|
37
37
|
the three dashes at the beginning are omitted, then the parser won't know that the following block
|
38
|
-
contains meta information and thinks it is content.
|
38
|
+
contains meta information and thinks it is content. If not specified, the default name for the
|
39
|
+
content block is @content@.
|
39
40
|
|
40
41
|
If you want to include a line in your file which only has three dashes, you have to write this:
|
41
42
|
<pre>
|
@@ -111,28 +112,50 @@ If meta information is specified in a page description file, the default values
|
|
111
112
|
|
112
113
|
The following defaults are used:
|
113
114
|
|
114
|
-
* Content format
|
115
|
+
* Content format and name
|
115
116
|
|
116
117
|
If there is only one content in a page description file, its formatting defaults to the parameter
|
117
|
-
value @defaultContentFormat@.
|
118
|
+
value @defaultContentFormat@ and it is named @content@.
|
118
119
|
|
119
120
|
* Title, ordering and language
|
120
121
|
|
121
122
|
These values are taken from the filename, so the filename of a page description file has to be
|
122
|
-
formatted like this: @[ordering.]
|
123
|
+
formatted like this: @[ordering.]name[.language].page@ (the values in square brackets are
|
123
124
|
optional). In detail:
|
124
125
|
* ordering: The ordering is a number which is used for menu generation and the like, where it is
|
125
126
|
necessary to order the items. If not specified, defaults to @0@.
|
126
|
-
*
|
127
|
-
|
127
|
+
* name: This is used for the title of the page. Hyphens and underscores are replaced with spaces
|
128
|
+
and @name@ must not contain any dots. Also: if two page descriptions files have the same
|
129
|
+
@name@ part, they should define the same content for different languages as webgen consideres
|
130
|
+
them as "one" page file in two languages.
|
128
131
|
* language: This is the language code for this file. It is the international two letter acronym
|
129
132
|
and if it is not specified, it defaults to @en@.
|
130
133
|
|
131
134
|
Consider the following examples:
|
132
|
-
|
133
|
-
|
134
|
-
|
135
|
+
* @name.page@ -> title: Name, language: en, ordering: 0
|
136
|
+
* @name.de.page@ -> title: Name, language: de, ordering: 0
|
137
|
+
* @01.name_of-file.de.page@ -> Title: Name of file, language: de, ordering: 01
|
135
138
|
|
139
|
+
Notice: The first two examples define content for two different languages (en and de) as they have
|
140
|
+
the same @name@ part.
|
141
|
+
|
142
|
+
|
143
|
+
h2(#naming). Referencing page description files
|
144
|
+
|
145
|
+
The output name of page description files can be specified using the parameter @outputNameStyle@. If
|
146
|
+
you want to reference a page description file, you can use this output name (e.g. @name.de.html@).
|
147
|
+
However, if you want to change the @outputNameStyle@ parameter later or set the parameter
|
148
|
+
@defaultLangInFilename@, this link (@name.de.html@) will not work anymore.
|
149
|
+
|
150
|
+
Therefore, each page description file can be referenced by specifing the name
|
151
|
+
<code>[name_of_page_desc_file].[language].page</code> (e.g. @name.de.page@ instead of
|
152
|
+
@name.de.html@). However, most of the time, you do not want to explicitly specify the @lang@ part in
|
153
|
+
this standardified name because you want to reference the page description file and display it in
|
154
|
+
the currently used language. Thus you can also use <code>[name_of_page_desc_file].page</code> (e.g.
|
155
|
+
@name.page@). This will always reference the page description file in the correct language!
|
156
|
+
|
157
|
+
I could have used the extension @html@ instead of @page@, but I think the latter is better because
|
158
|
+
the output files need not have to have the extension @html@.
|
136
159
|
|
137
160
|
h2(#meta). Meta Information
|
138
161
|
|
@@ -17,4 +17,12 @@ Writing your own plugins is not difficult, too! If you need a specific functiona
|
|
17
17
|
plugin and put it under the site specific @plugin@ directory - then the plugin gets loaded with the
|
18
18
|
others. It's so easy!
|
19
19
|
|
20
|
-
For more information have a look at the <a href="{relocatable: /rdoc/index.html}">API documentation</a>!
|
20
|
+
For more information have a look at the <a href="{relocatable: /rdoc/index.html}">API documentation</a>!
|
21
|
+
|
22
|
+
h2. Parameters
|
23
|
+
|
24
|
+
Each plugin can define parameters which can be used to configure the plugin. These parameters are
|
25
|
+
listed in the "Information" section of each plugin page. Also note that plugins can use the
|
26
|
+
parameters from their "super plugins" - this allows a group of plugins which have similar
|
27
|
+
functionality (e.g. the menu style plugins) to share common configuration values. The names of the
|
28
|
+
"super plugins" are enclosed in parentheses after the plugin name in the "Information" section.
|
@@ -0,0 +1,42 @@
|
|
1
|
+
---
|
2
|
+
title: Horizontal Dropdown
|
3
|
+
inMenu: true
|
4
|
+
---
|
5
|
+
h2. Information
|
6
|
+
|
7
|
+
<notextile>{describe: HorizontalDropdownMenuStyle}</notextile>
|
8
|
+
|
9
|
+
h2. Description
|
10
|
+
|
11
|
+
Builds a horizontal menu with CSS drop down menus. This menu should work fine in any browser
|
12
|
+
supporting CSS and the @:hover@ selector (Mozilla based browsers like Firefox, Opera and Konqueror
|
13
|
+
are fine, does NOT work in IE 6 on Windows XP).
|
14
|
+
|
15
|
+
h2. Style Advice
|
16
|
+
|
17
|
+
The menu works by only using CSS, not DHTML or anything else. Here is a list of CSS selectors and
|
18
|
+
descriptions how these selectors can be used to style various parts of the menu. You have to pay
|
19
|
+
attention to the last element in the selector (@ul@, @li@, or @a@). When you want to style menu
|
20
|
+
items, you normally want to use @a@. You should also be aware of the use of the @>@ sign, there is a
|
21
|
+
dramatic difference between writing @li a@ and @li > a@ (the former selecting ALL @a@ elements of
|
22
|
+
the list item, i.e. all @a@ elements in submenus too; and the latter only selecting the direct
|
23
|
+
descendant)!
|
24
|
+
|
25
|
+
table{border: 1px solid black}.
|
26
|
+
|<code>.webgen-menu-horiz-dd ul > li > a</code>|Style the top level menu items (the ones that are always shown)|
|
27
|
+
|<code>.webgen-menu-horiz-dd ul ul</code>|Style the drop down menus|
|
28
|
+
|<code>.webgen-menu-horiz-dd ul ul > li > a</code>|Style the drop down menu items|
|
29
|
+
|<code>.webgen-menu-horiz-dd li:hover > a</code>|Style the hovered-over menu item|
|
30
|
+
|
31
|
+
h2. Example
|
32
|
+
|
33
|
+
Basic menu as it appears by default, nothing styled additionally with CSS:
|
34
|
+
|
35
|
+
<notextile>{menu: {menuStyle: horizontal-dropdown}}</notextile>
|
36
|
+
|
37
|
+
<br />
|
38
|
+
The same menu with a little CSS magic:
|
39
|
+
|
40
|
+
<notextile>{menu: {menuStyle: horizontal-dropdown, options: {divClass: horiz-dd-menu}}}</notextile>
|
41
|
+
|
42
|
+
<br/>
|
@@ -0,0 +1,21 @@
|
|
1
|
+
---
|
2
|
+
title: Horizontal
|
3
|
+
inMenu: true
|
4
|
+
---
|
5
|
+
h2. Information
|
6
|
+
|
7
|
+
<notextile>{describe: HorizontalMenuStyle}</notextile>
|
8
|
+
|
9
|
+
h2. Description
|
10
|
+
|
11
|
+
Builds a horizontal menu; each menu level gets its own menu bar.
|
12
|
+
|
13
|
+
h2. Example
|
14
|
+
|
15
|
+
Basic menu as it appears by default, nothing styled additionally with CSS:
|
16
|
+
|
17
|
+
<notextile>{menu: {menuStyle: horizontal}}</notextile>
|
18
|
+
|
19
|
+
The same menu with a little CSS magic:
|
20
|
+
|
21
|
+
<notextile>{menu: {menuStyle: horizontal, options: {divClass: horiz-menu}}}</notextile>
|
@@ -0,0 +1,12 @@
|
|
1
|
+
---
|
2
|
+
directoryName: Menu Styles
|
3
|
+
---
|
4
|
+
h2. Information
|
5
|
+
|
6
|
+
<notextile>{describe: DefaultMenuStyle}</notextile>
|
7
|
+
|
8
|
+
h2. Description
|
9
|
+
|
10
|
+
Menu Styles are used to build different types of menus. Some web sites use vertical menus on the
|
11
|
+
left or right side, some horizontal menus at the top. It's up to you to chose the best suited
|
12
|
+
menu style for your website!
|
@@ -0,0 +1,27 @@
|
|
1
|
+
---
|
2
|
+
title: Partial
|
3
|
+
inMenu: true
|
4
|
+
---
|
5
|
+
h2. Information
|
6
|
+
|
7
|
+
<notextile>{describe: PartialMenuStyle}</notextile>
|
8
|
+
|
9
|
+
h2. Description
|
10
|
+
|
11
|
+
Builds a simple menu showing only the menu levels under the current page. This means that if you are
|
12
|
+
in the third level of the hierarchy, the first two menu levels are not shown.
|
13
|
+
|
14
|
+
h2. Style Advice
|
15
|
+
|
16
|
+
The menu is constructed using HTML lists with @ul@ and @li@ tags. However, the menu looks better if
|
17
|
+
no discs are shown for the menu items (using <code>list-style-type: none</code>).
|
18
|
+
|
19
|
+
h2. Examples
|
20
|
+
|
21
|
+
Basic menu as it appears by default, nothing styled additionally with CSS:
|
22
|
+
|
23
|
+
<notextile>{menu: {menuStyle: partial}}</notextile>
|
24
|
+
|
25
|
+
The same menu with a little CSS magic:
|
26
|
+
|
27
|
+
<notextile>{menu: {menuStyle: partial, options: {divClass: partial-menu}}}</notextile>
|
@@ -0,0 +1,23 @@
|
|
1
|
+
---
|
2
|
+
title: Vertical Dropdown
|
3
|
+
inMenu: true
|
4
|
+
---
|
5
|
+
h2. Information
|
6
|
+
|
7
|
+
<notextile>{describe: VerticalDropdownMenuStyle}</notextile>
|
8
|
+
|
9
|
+
h2. Description
|
10
|
+
|
11
|
+
Builds a vertical menu with CSS drop down menus. This one is similar to the horizontal dropdown menu
|
12
|
+
and the information on the <a href="{relocatable: horizontal-dropdown.page}">Horizontal
|
13
|
+
Dropdown</a> page also applies for this menu style.
|
14
|
+
|
15
|
+
h2. Example
|
16
|
+
|
17
|
+
Basic menu as it appears by default, nothing styled additionally with CSS:
|
18
|
+
|
19
|
+
<notextile>{menu: {menuStyle: vertical-dropdown}}</notextile>
|
20
|
+
|
21
|
+
The same menu with a little CSS magic:
|
22
|
+
|
23
|
+
<notextile>{menu: {menuStyle: vertical-dropdown, options: {divClass: vert-dd-menu}}}</notextile>
|
@@ -0,0 +1,32 @@
|
|
1
|
+
---
|
2
|
+
title: Vertical
|
3
|
+
inMenu: true
|
4
|
+
---
|
5
|
+
h2. Information
|
6
|
+
|
7
|
+
<notextile>{describe: VerticalMenuStyle}</notextile>
|
8
|
+
|
9
|
+
h2. Description
|
10
|
+
|
11
|
+
Builds a simple vertical menu. This is the most basic of all menus. Use the various parameters to
|
12
|
+
change how many menu levels should be shown.
|
13
|
+
|
14
|
+
h2. Style Advice
|
15
|
+
|
16
|
+
The menu is constructed using HTML lists with @ul@ and @li@ tags. However, the menu looks better if
|
17
|
+
no discs are shown for the menu items (using <code>list-style-type: none</code>).
|
18
|
+
|
19
|
+
h2. Examples
|
20
|
+
|
21
|
+
Basic menu as it appears by default, nothing styled additionally with CSS:
|
22
|
+
|
23
|
+
<notextile>{menu: {menuStyle: vertical}}</notextile>
|
24
|
+
|
25
|
+
The same menu with a little CSS magic:
|
26
|
+
|
27
|
+
<notextile>{menu: {menuStyle: vertical, options: {divClass: vert-menu}}}</notextile>
|
28
|
+
|
29
|
+
Examples of the menu with other parameter settings
|
30
|
+
|
31
|
+
table{border: 1px solid black}.
|
32
|
+
|^. \{menu: {menuStyle: vertical, options: {subtreeLevel: 1}}}{menu: {menuStyle: vertical, options: {subtreeLevel: 1}}}|^. \{menu: {menuStyle: vertical, options: {subtreeLevel: 4, showCurrentSubtreeOnly: false}}} {menu: {menuStyle: vertical, options: {subtreeLevel: 4, showCurrentSubtreeOnly: false}}}|
|
@@ -0,0 +1,30 @@
|
|
1
|
+
---
|
2
|
+
title: Resource Manager
|
3
|
+
inMenu: true
|
4
|
+
---
|
5
|
+
h2. Information
|
6
|
+
|
7
|
+
<notextile>{describe: ResourceManager}</notextile>
|
8
|
+
|
9
|
+
h2. Description
|
10
|
+
|
11
|
+
The ResourceManager plugin is used to define and access various resources. A resource is identified
|
12
|
+
via the resource name and is written to a certain output path (relative to the output directory).
|
13
|
+
There are two different types of resources: file resources and memory resources.
|
14
|
+
|
15
|
+
* A *file* resources references a certain file which gets copied to its output path when webgen is
|
16
|
+
writing out all files. These files resources can refernce any kind of file (images, videos,
|
17
|
+
audio files, HTML files,...).
|
18
|
+
|
19
|
+
* A *memory* resource only exists during a run of webgen. Plugins can use such resources to provide
|
20
|
+
additional information, such as CSS formatting rules or Javascript.
|
21
|
+
|
22
|
+
Resources are only written to the output path if they are referenced (i.e. their output path is
|
23
|
+
included in a page file) at least once by the <a href="{relocatable: tags/resource.page}">resource
|
24
|
+
tag</a>.
|
25
|
+
|
26
|
+
h2. Predefined Resources
|
27
|
+
|
28
|
+
webgen provides some predefined resources which can be used by any website created with it.
|
29
|
+
|
30
|
+
<notextile>{predefinedResources:}</notextile>
|
@@ -19,9 +19,9 @@ Tags are defined by a special markup code. A tag has the following structure:
|
|
19
19
|
|
20
20
|
Every time a tag is found in a source file, the registered plugin for the tag is called. The plugin
|
21
21
|
returns a string which is put into the output file instead of the tag. The output a tag plugin can
|
22
|
-
produce ranges from something simple to something complex. For example, the <a href="{relocatable: meta.
|
22
|
+
produce ranges from something simple to something complex. For example, the <a href="{relocatable: meta.page}">
|
23
23
|
Meta Tag</a> plugin copies any additional info specified in the source file verbatim
|
24
|
-
into the correct place in the output file. And in contrast, the <a href="{relocatable: menu.
|
24
|
+
into the correct place in the output file. And in contrast, the <a href="{relocatable: menu.page}">
|
25
25
|
Menu Tag</a> plugin generates a whole menu tree.
|
26
26
|
|
27
27
|
If you want to use the markup code used for tags, you need to escape the tag, like this:
|
@@ -4,18 +4,17 @@ inMenu: true
|
|
4
4
|
---
|
5
5
|
h2. Information
|
6
6
|
|
7
|
-
<notextile>{describe:
|
7
|
+
<notextile>{describe: LangbarTag}</notextile>
|
8
8
|
|
9
9
|
h2. Description
|
10
10
|
|
11
11
|
The language tag is used to display a list of languages for a page. Take a look at the lower right
|
12
12
|
corner of the header. There you will find a link titled 'en'. This is the link to the english (=en)
|
13
|
-
version of this page.
|
14
|
-
item.
|
13
|
+
version of this page.
|
15
14
|
|
16
15
|
h2. Examples
|
17
16
|
|
18
|
-
Here is a <a href="{relocatable: multilang.
|
17
|
+
Here is a <a href="{relocatable: multilang.page}">link</a> to a page which is translated to several
|
19
18
|
languages (more or less ;-). Have a look at it and don't forget to view the page in the other
|
20
19
|
languages!
|
21
20
|
|
@@ -24,4 +23,5 @@ table{border:1px solid black}.
|
|
24
23
|
|<notextile>\{langbar: }</notextile>|<notextile>{langbar: }</notextile>|
|
25
24
|
|\{langbar: {separator: Hallo}}|{langbar: {separator: Hallo}}|
|
26
25
|
|\{langbar: {showSingleLang: false}}|{langbar: {showSingleLang: false}}|
|
26
|
+
|\{langbar: {showOwnLang: false}}|{langbar: {showOwnLang: false}}|
|
27
27
|
|
@@ -9,22 +9,11 @@ h2. Information
|
|
9
9
|
h2. Description
|
10
10
|
|
11
11
|
The menu tag is used to generate a menu for the website. You can see such a menu on the left of this
|
12
|
-
page.
|
13
|
-
documentation.
|
12
|
+
page.
|
14
13
|
|
15
|
-
This page is available in <a href="menu.de.html">German</a>. Try and go to
|
16
|
-
|
17
|
-
change their names.
|
14
|
+
This page is available in <a href="menu.de.html">German</a>. Try and go to the german version of
|
15
|
+
this page. You will see that the menu items for which translations exist change their names.
|
18
16
|
|
19
|
-
|
20
|
-
|
21
|
-
|
22
|
-
* subtreeLevel = 3
|
23
|
-
* showCurrentSubtreeOnly = true
|
24
|
-
|
25
|
-
h2. Examples
|
26
|
-
|
27
|
-
Below are some other menus generated from the same source but with different settings:
|
28
|
-
|
29
|
-
table{border: 1px solid black}.
|
30
|
-
|^. \{menu: {subtreeLevel: 1}}{menu: {subtreeLevel: 1}}|^. \{menu: {showCurrentSubtreeOnly: false}} {menu: {showCurrentSubtreeOnly: false}}|
|
17
|
+
There exist serveral different predefined styles of menus (vertical, horizontal, ...). Have a look
|
18
|
+
at the <a href="{relocatable: ../menustyles}">Menu Styles</a> section to see which menu styles are
|
19
|
+
available.
|