webgen 0.4.1 → 0.4.2
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 +300 -0
- data/Rakefile +149 -27
- data/TODO +3 -4
- data/VERSION +1 -1
- data/data/webgen/gallery_styles/slides/collage.rb +7 -4
- data/data/webgen/sipttra_styles/default/README +7 -0
- data/data/webgen/sipttra_styles/default/css/sipttra.rcss +71 -0
- data/data/webgen/sipttra_styles/default/js/sipttra.js +7 -0
- data/data/webgen/sipttra_styles/default/sipttra.template +105 -0
- data/data/webgen/website_styles/1024px/README +3 -0
- data/data/webgen/website_styles/1024px/default.css +3 -3
- data/data/webgen/website_styles/andreas00/README +4 -1
- data/data/webgen/website_styles/andreas00/default.css +2 -2
- data/data/webgen/website_styles/andreas01/README +3 -0
- data/data/webgen/website_styles/andreas01/default.css +3 -3
- data/data/webgen/website_styles/andreas03/README +4 -1
- data/data/webgen/website_styles/andreas03/default.css +2 -2
- data/data/webgen/website_styles/andreas04/README +3 -0
- data/data/webgen/website_styles/andreas04/default.css +2 -2
- data/data/webgen/website_styles/andreas05/README +3 -0
- data/data/webgen/website_styles/andreas05/default.css +2 -2
- data/data/webgen/website_styles/andreas06/README +3 -0
- data/data/webgen/website_styles/andreas06/default.css +3 -2
- data/data/webgen/website_styles/andreas07/README +3 -0
- data/data/webgen/website_styles/andreas07/default.css +4 -4
- data/data/webgen/website_styles/andreas08/README +4 -1
- data/data/webgen/website_styles/andreas08/default.css +2 -2
- data/data/webgen/website_styles/andreas08/default.template +1 -1
- data/data/webgen/website_styles/andreas09/README +3 -0
- data/data/webgen/website_styles/andreas09/default.css +2 -2
- data/data/webgen/website_styles/default/README +1 -1
- data/data/webgen/website_styles/default/default.css +1 -1
- data/data/webgen/website_styles/plain/README +7 -2
- data/data/webgen/website_styles/plain/default.css +2 -2
- data/doc/config.yaml +3 -0
- data/doc/metainfo.yaml +20 -3
- data/doc/src/css/sipttra.rcss +71 -0
- data/doc/src/default.template +10 -5
- data/doc/src/documentation/howto.page +221 -0
- data/doc/src/documentation/plugins/contentconverter/default.page +1 -0
- data/doc/src/documentation/plugins/contentconverter/xmlbuilder.page +2 -2
- data/doc/src/documentation/plugins/core/configuration.page +6 -0
- data/doc/src/documentation/plugins/core/resourcemanager.page +4 -10
- data/doc/src/documentation/plugins/file/defaulthandler.page +1 -0
- data/doc/src/documentation/plugins/file/sipttrahandler.page +18 -0
- data/doc/src/documentation/plugins/file/templatehandler.page +27 -10
- data/doc/src/documentation/plugins/file/thumbnailwriter.page +5 -2
- data/doc/src/documentation/plugins/htmlvalidator/default.page +1 -0
- data/doc/src/documentation/plugins/index.page +2 -2
- data/doc/src/documentation/plugins/menustyle/default.page +1 -0
- data/doc/src/documentation/plugins/tag/breadcrumbtrail.page +12 -0
- data/doc/src/documentation/plugins/tag/customvar.page +11 -0
- data/doc/src/documentation/plugins/tag/default.page +1 -0
- data/doc/src/documentation/references/index.page +8 -0
- data/doc/src/documentation/references/meta_info_reference.page +35 -16
- data/doc/src/documentation/references/resource_reference.page +18 -0
- data/doc/src/documentation/references/sipttra_format.page +241 -0
- data/doc/src/documentation/references/webpage_format.page +4 -0
- data/doc/src/examples/example_sites/index.page +41 -0
- data/doc/src/examples/example_sites/personal.zip +0 -0
- data/doc/src/examples/example_sites/photo_gallery.zip +0 -0
- data/doc/src/examples/index.page +2 -1
- data/doc/src/js/sipttra.js +7 -0
- data/doc/src/news.page +25 -0
- data/doc/src/project.todo +91 -0
- data/doc/src/sipttra.template +105 -0
- data/lib/webgen/cli.rb +31 -1
- data/lib/webgen/config.rb +2 -2
- data/lib/webgen/plugin.rb +7 -3
- data/lib/webgen/plugins/coreplugins/configuration.rb +3 -1
- data/lib/webgen/plugins/filehandlers/filehandler.rb +6 -5
- data/lib/webgen/plugins/filehandlers/sipttra.rb +73 -0
- data/lib/webgen/plugins/filehandlers/template.rb +2 -1
- data/lib/webgen/plugins/miscplugins/treewalker.rb +40 -4
- data/lib/webgen/plugins/tags/breadcrumbtrail.rb +14 -1
- data/lib/webgen/plugins/tags/customvar.rb +54 -0
- data/lib/webgen/sipttra_format.rb +343 -0
- data/lib/webgen/website.rb +25 -1
- data/man/man1/webgen.1 +75 -0
- data/setup.rb +861 -607
- data/test/fixtures/sample_site/src/test.todo +7 -0
- data/test/fixtures/tc_plugin/plugin1.rb +2 -0
- data/test/fixtures/tc_sipttra_format/test.sipttra +46 -0
- data/test/unittests/tc_filehandler_sipttra.rb +26 -0
- data/test/unittests/tc_filehandler_template.rb +2 -1
- data/test/unittests/tc_plugin.rb +8 -1
- data/test/unittests/tc_sipttra_format.rb +58 -0
- data/test/unittests/tc_tags_breadcrumbtrail.rb +34 -0
- data/test/unittests/tc_tags_customvar.rb +24 -0
- data/test/unittests/tc_tags_date.rb +1 -0
- data/test/unittests/tc_tags_includefile.rb +6 -13
- data/test/unittests/tc_treewalker.rb +8 -1
- metadata +37 -3
|
@@ -80,11 +80,12 @@ margin:0;
|
|
|
80
80
|
padding:0;
|
|
81
81
|
}
|
|
82
82
|
|
|
83
|
-
#nav a{
|
|
83
|
+
#nav a, #nav span {
|
|
84
84
|
background:url(images/tabs.gif) no-repeat 100% 0;
|
|
85
85
|
color:#808080;
|
|
86
86
|
display:block;
|
|
87
87
|
font-size:1.2em;
|
|
88
|
+
font-weight: 700;
|
|
88
89
|
letter-spacing:-1px;
|
|
89
90
|
padding:7px 20px 4px 11px;
|
|
90
91
|
text-decoration:none;
|
|
@@ -105,7 +106,7 @@ padding:0 0 0 9px;
|
|
|
105
106
|
background:url(images/tabs.gif) no-repeat 0 -41px;
|
|
106
107
|
}
|
|
107
108
|
|
|
108
|
-
#nav li.webgen-menu-item-selected a, #nav li.webgen-menu-submenu-inhierarchy a {
|
|
109
|
+
#nav li.webgen-menu-item-selected a, #nav li.webgen-menu-submenu-inhierarchy a, #nav li.webgen-menu-item-selected span {
|
|
109
110
|
background:url(images/tabs.gif) no-repeat 100% -41px;
|
|
110
111
|
color:#303030;
|
|
111
112
|
padding:7px 20px 5px 11px;
|
|
@@ -65,16 +65,16 @@ body > #sidebar
|
|
|
65
65
|
#menu .webgen-menu li
|
|
66
66
|
{margin: 0px; padding: 0px}
|
|
67
67
|
|
|
68
|
-
#menu .webgen-menu a
|
|
68
|
+
#menu .webgen-menu a, #menu .webgen-menu span
|
|
69
69
|
{display:block; width:202px; padding:5px 18px 5px 0; color:#606060; background:#e0e0e0 url(images/sidebarbg.gif) top right repeat-y; font-size:1.8em; font-weight:normal; text-decoration:none; letter-spacing:-2px;}
|
|
70
70
|
|
|
71
|
-
#menu .webgen-menu a:hover
|
|
71
|
+
#menu .webgen-menu a:hover, #menu .webgen-menu span:hover
|
|
72
72
|
{color:#303030; background:#f0f0f0 url(images/sidebarbg.gif) top right repeat-y;}
|
|
73
73
|
|
|
74
|
-
#menu .webgen-menu li.webgen-menu-item-selected a
|
|
74
|
+
#menu .webgen-menu li.webgen-menu-item-selected a, #menu .webgen-menu li.webgen-menu-item-selected span
|
|
75
75
|
{padding:5px 18px 5px 0; background:#fafafa; border-top:2px solid #c0c0c0; border-bottom:2px solid #c0c0c0;}
|
|
76
76
|
|
|
77
|
-
#menu .webgen-menu li.webgen-menu-item-selected a:hover
|
|
77
|
+
#menu .webgen-menu li.webgen-menu-item-selected a:hover, #menu .webgen-menu li.webgen-menu-item-selected span:hover
|
|
78
78
|
{color:#505050; background:#fafafa;}
|
|
79
79
|
|
|
80
80
|
/**************** Content area styles ****************/
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
description:
|
|
2
|
-
Open source web design template by Andreas Viklund. Very simple and basic template without
|
|
2
|
+
Open source web design template by Andreas Viklund. Very simple and basic template without
|
|
3
3
|
images in light blue and white.
|
|
4
4
|
Have a look at the available styles in the CSS file and visit the homepage to see the original
|
|
5
5
|
template and what can be done with it.
|
|
@@ -7,5 +7,8 @@ description:
|
|
|
7
7
|
author:
|
|
8
8
|
Andreas Viklund (adapted for webgen by Thomas Leitner)
|
|
9
9
|
|
|
10
|
+
copyright:
|
|
11
|
+
http://andreasviklund.com/about/copyright/
|
|
12
|
+
|
|
10
13
|
homepage:
|
|
11
14
|
http://andreasviklund.com/templates
|
|
@@ -89,7 +89,7 @@ border-right:1px solid #ffffff;
|
|
|
89
89
|
white-space:nowrap;
|
|
90
90
|
}
|
|
91
91
|
|
|
92
|
-
#navigation li a{
|
|
92
|
+
#navigation li a, #navigation li span {
|
|
93
93
|
display:block;
|
|
94
94
|
padding:0 10px;
|
|
95
95
|
font-size:0.8em;
|
|
@@ -102,7 +102,7 @@ color: #ffffff;
|
|
|
102
102
|
|
|
103
103
|
* html #navigation a {width:1%;}
|
|
104
104
|
|
|
105
|
-
#navigation .webgen-menu-item-selected a, #navigation a:hover {
|
|
105
|
+
#navigation .webgen-menu-item-selected a, #navigation .webgen-menu-item-selected span, #navigation a:hover {
|
|
106
106
|
background:#80b0da;
|
|
107
107
|
color:#ffffff;
|
|
108
108
|
text-decoration:none;
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
|
7
7
|
<meta name="description" content="Your website description goes here" />
|
|
8
8
|
<meta name="keywords" content="your,keywords,goes,here" />
|
|
9
|
-
<meta name="
|
|
9
|
+
<meta name="generator" content="webgen - http://webgen.rubyforge.org" />
|
|
10
10
|
<link rel="stylesheet" href="{relocatable: default.css}" type="text/css" media="screen,projection" />
|
|
11
11
|
<link rel="stylesheet" type="text/css" href="{resource: webgen-css}" />
|
|
12
12
|
<title>{title:}</title>
|
|
@@ -83,7 +83,7 @@ margin:0;
|
|
|
83
83
|
padding:0;
|
|
84
84
|
}
|
|
85
85
|
|
|
86
|
-
#mainmenu a {
|
|
86
|
+
#mainmenu a, #mainmenu span {
|
|
87
87
|
border-right:1px solid #b0b0b0;
|
|
88
88
|
color:#606060;
|
|
89
89
|
display:block;
|
|
@@ -98,7 +98,7 @@ color:#505050;
|
|
|
98
98
|
text-decoration:none;
|
|
99
99
|
}
|
|
100
100
|
|
|
101
|
-
#mainmenu .webgen-menu-item-selected a {
|
|
101
|
+
#mainmenu .webgen-menu-item-selected a, #mainmenu .webgen-menu-item-selected span {
|
|
102
102
|
background:#f0f0f0 url(images/menuhover.jpg) top left repeat-x;
|
|
103
103
|
color:#505050;
|
|
104
104
|
text-decoration:none;
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
description:
|
|
2
2
|
Open source web design template by James Koster.
|
|
3
|
-
As the name says a simple and plain template in olive and white with a main content part and a
|
|
3
|
+
As the name says a simple and plain template in olive and white with a main content part and a
|
|
4
4
|
side menu. This template makes much use of whitespace.
|
|
5
5
|
Have a look at the available styles in the CSS file and visit the homepage to see the original
|
|
6
6
|
template and what can be done with it.
|
|
@@ -8,5 +8,10 @@ description:
|
|
|
8
8
|
author:
|
|
9
9
|
James Koster (adapted for webgen by Thomas Leitner)
|
|
10
10
|
|
|
11
|
+
copyright:
|
|
12
|
+
Creative Commons Attribution v2.5 http://creativecommons.org/licenses/by/2.5/
|
|
13
|
+
(see section Licenses on the homepage - basically you need to leave a link to the site of the
|
|
14
|
+
author in the template footer)
|
|
15
|
+
|
|
11
16
|
homepage:
|
|
12
|
-
http://
|
|
17
|
+
http://www.sixshootermedia.com/free-templates/
|
|
@@ -60,7 +60,7 @@ a:hover {
|
|
|
60
60
|
padding: 0px;
|
|
61
61
|
}
|
|
62
62
|
|
|
63
|
-
#menu a {
|
|
63
|
+
#menu a, #menu span {
|
|
64
64
|
color:#FFFFFF;
|
|
65
65
|
text-decoration:none;
|
|
66
66
|
padding:10px;
|
|
@@ -68,7 +68,7 @@ a:hover {
|
|
|
68
68
|
padding-bottom:20px;
|
|
69
69
|
}
|
|
70
70
|
|
|
71
|
-
#menu a:hover, #menu .webgen-menu-item-selected a, #menu li.webgen-menu-submenu-inhierarchy a {
|
|
71
|
+
#menu a:hover, #menu .webgen-menu-item-selected a, #menu .webgen-menu-item-selected span, #menu li.webgen-menu-submenu-inhierarchy a {
|
|
72
72
|
border-bottom:1px solid #ffffff;
|
|
73
73
|
border-left:1px solid #728d40;
|
|
74
74
|
border-right:1px solid #e9ffb7;
|
data/doc/config.yaml
CHANGED
data/doc/metainfo.yaml
CHANGED
|
@@ -17,6 +17,13 @@ examples/:
|
|
|
17
17
|
orderInfo: 10
|
|
18
18
|
inMenu: true
|
|
19
19
|
|
|
20
|
+
examples/example_sites:
|
|
21
|
+
inMenu: true
|
|
22
|
+
orderInfo: 20
|
|
23
|
+
|
|
24
|
+
project.page:
|
|
25
|
+
orderInfo: 11
|
|
26
|
+
|
|
20
27
|
images:
|
|
21
28
|
indexFile: ~
|
|
22
29
|
|
|
@@ -27,6 +34,9 @@ documentation/basics.page:
|
|
|
27
34
|
documentation/tutorial.page:
|
|
28
35
|
orderInfo: 3
|
|
29
36
|
|
|
37
|
+
documentation/howto.page:
|
|
38
|
+
orderInfo: 4
|
|
39
|
+
|
|
30
40
|
documentation/extending_webgen.page:
|
|
31
41
|
orderInfo: 5
|
|
32
42
|
|
|
@@ -40,12 +50,19 @@ documentation/plugins/:
|
|
|
40
50
|
documentation/references/webpage_format.page:
|
|
41
51
|
orderInfo: 5
|
|
42
52
|
|
|
43
|
-
documentation/references/
|
|
44
|
-
orderInfo:
|
|
53
|
+
documentation/references/sipttra_format.page:
|
|
54
|
+
orderInfo: 8
|
|
45
55
|
|
|
46
56
|
documentation/references/meta_info_reference.page:
|
|
47
57
|
orderInfo: 10
|
|
48
58
|
|
|
59
|
+
documentation/references/resource_reference.page:
|
|
60
|
+
orderInfo: 13
|
|
61
|
+
|
|
62
|
+
documentation/references/parameter_reference.page:
|
|
63
|
+
orderInfo: 15
|
|
64
|
+
|
|
65
|
+
|
|
49
66
|
|
|
50
67
|
documentation/plugins/file:
|
|
51
68
|
indexFile: defaulthandler.page
|
|
@@ -84,5 +101,5 @@ wiki.html:
|
|
|
84
101
|
url: http://webgen.rubyforge.org/wiki/wiki.pl
|
|
85
102
|
title: WikiWiki Web
|
|
86
103
|
inMenu: true
|
|
87
|
-
orderInfo:
|
|
104
|
+
orderInfo: 15
|
|
88
105
|
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
<%
|
|
2
|
+
copen = "#e0baba"
|
|
3
|
+
cclosed = "#bae0ba"
|
|
4
|
+
%>
|
|
5
|
+
|
|
6
|
+
div.milestone h2.milestone-name {
|
|
7
|
+
padding-bottom: 0px;
|
|
8
|
+
margin-bottom: 0px;
|
|
9
|
+
border-bottom: 1px solid gray;
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
div.milestone h2.milestone-name span {
|
|
13
|
+
font-size: 110%;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
div.milestone p.milestone-info {
|
|
17
|
+
padding-top: 0px;
|
|
18
|
+
margin-top: 0px;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
div.milestone div.milestone-summary {
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
div.milestone div.milestone-description {
|
|
25
|
+
padding-left: 20px;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
div.milestone div.progress-info {
|
|
29
|
+
padding-left: 20px;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
div.milestone div.progress-bar {
|
|
33
|
+
margin-top: 10px;
|
|
34
|
+
height: 20px;
|
|
35
|
+
width: 400px;
|
|
36
|
+
background-color: <%= copen %>;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
div.milestone div.progress-indicator {
|
|
40
|
+
background-color: <%= cclosed %>;
|
|
41
|
+
height: 100%;
|
|
42
|
+
width: 0px;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
div.milestone p.progress-text {
|
|
46
|
+
font-size: 60%;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
div.milestone ul.assigned-tickets, div.milestone ul.sub-milestones {
|
|
50
|
+
display: none;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
div.ticket table.tickets {
|
|
54
|
+
width: 100%;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
div.ticket table.tickets tr {
|
|
58
|
+
background-color: <%= copen %>;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
div.ticket table.tickets tr.header {
|
|
62
|
+
background-color: inherit;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
div.ticket table.tickets tr.closed {
|
|
66
|
+
background-color: <%= cclosed %>;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
div.ticket table.tickets div.ticket-description {
|
|
70
|
+
display: none;
|
|
71
|
+
}
|
data/doc/src/default.template
CHANGED
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
--- content, html
|
|
2
1
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
3
2
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
|
|
4
3
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="{lang:}">
|
|
@@ -10,6 +9,8 @@
|
|
|
10
9
|
<meta name="author" content="Thomas Leitner / Original design by Andreas Viklund - http://andreasviklund.com" />
|
|
11
10
|
<link rel="stylesheet" href="{relocatable: default.css}" type="text/css" media="screen" />
|
|
12
11
|
<link rel="stylesheet" href="{resource: {name: webgen-css, insert: :path}}" type="text/css" media="screen" />
|
|
12
|
+
<link rel="stylesheet" href="{relocatable: css/sipttra.css}" type="text/css" media="screen" />
|
|
13
|
+
<script type="text/javascript" src="{relocatable: js/sipttra.js}" />
|
|
13
14
|
</head>
|
|
14
15
|
|
|
15
16
|
<body>
|
|
@@ -47,6 +48,10 @@
|
|
|
47
48
|
|
|
48
49
|
<div id="rightside">
|
|
49
50
|
<h1>Latest news</h1>
|
|
51
|
+
<p><strong>2007-02-28: </strong>
|
|
52
|
+
webgen 0.4.2 released! Bugs fixed and some feature added!
|
|
53
|
+
<a href="{relocatable: news.en.page#news-2007-02-28}">More...</a>
|
|
54
|
+
</p>
|
|
50
55
|
<p><strong>2007-01-12: </strong>
|
|
51
56
|
webgen 0.4.1 released! Bug fix for running webgen on Windows and other small updates!
|
|
52
57
|
<a href="{relocatable: news.en.page#news-2007-01-12}">More...</a>
|
|
@@ -69,15 +74,15 @@
|
|
|
69
74
|
|
|
70
75
|
<form action="https://www.paypal.com/cgi-bin/webscr" method="post"><div class="center" style="margin-top: 15px">
|
|
71
76
|
<input type="hidden" name="cmd" value="_s-xclick" />
|
|
72
|
-
<input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but04.gif" style="border:0px" name="submit" alt="Donate
|
|
73
|
-
<img alt="" style="border:0px" src="https://www.paypal.com/
|
|
74
|
-
<input type="hidden" name="encrypted" value="-----BEGIN PKCS7-----
|
|
77
|
+
<input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but04.gif" style="border:0px" name="submit" alt="Donate via PayPal!" />
|
|
78
|
+
<img alt="" style="border:0px" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1" />
|
|
79
|
+
<input type="hidden" name="encrypted" value="-----BEGIN PKCS7-----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-----END PKCS7-----
|
|
75
80
|
" />
|
|
76
81
|
</div></form>
|
|
77
82
|
</div>
|
|
78
83
|
|
|
79
84
|
<div id="navbar" class="content">
|
|
80
|
-
<span class="leftbox">Location: {breadcrumbTrail: } </span>
|
|
85
|
+
<span class="leftbox">Location: {breadcrumbTrail: {omitIndexFile: true}} </span>
|
|
81
86
|
<span class="rightbox">Language: {langbar: }</span>
|
|
82
87
|
<span class="rightbox">Feedback: {wikilink: {rootURL: http://webgen.rubyforge.org/wiki/wiki.pl?, linkText: Click here}}</span>
|
|
83
88
|
<div style="clear: both"> </div>
|
|
@@ -0,0 +1,221 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Howto...?
|
|
3
|
+
inMenu: true
|
|
4
|
+
|
|
5
|
+
howtos:
|
|
6
|
+
- - create a website?
|
|
7
|
+
- |
|
|
8
|
+
You can create the needed structure by hand (which would be not so much to do). However, it's
|
|
9
|
+
still easier using the @webgen@ command line tool:
|
|
10
|
+
|
|
11
|
+
webgen create -t project -s andreas07 my_site
|
|
12
|
+
|
|
13
|
+
This will create a webgen website in the directory @my_site@ using the specified template and
|
|
14
|
+
style.
|
|
15
|
+
|
|
16
|
+
- - use a website/gallery/sipttra style?
|
|
17
|
+
- |
|
|
18
|
+
Just use the @webgen@ command line tool:
|
|
19
|
+
|
|
20
|
+
webgen use website_style STYLE_NAME
|
|
21
|
+
webgen use gallery_style STYLE_NAME
|
|
22
|
+
webgen use sipttra_style STYLE_NAME
|
|
23
|
+
|
|
24
|
+
Be aware that destination files may be overwritten!
|
|
25
|
+
|
|
26
|
+
- - set plugin parameters?
|
|
27
|
+
- |
|
|
28
|
+
You can set plugin parameters for all plugins via the configuration file. For example, say you
|
|
29
|
+
want to set the {param: File/DefaultHandler:linkToCurrentPage} parameter to @true@, then you
|
|
30
|
+
would add the following to the configuration file:
|
|
31
|
+
|
|
32
|
+
File/DefaultHandler:
|
|
33
|
+
linkToCurrentPage: true
|
|
34
|
+
|
|
35
|
+
There is a second possibility for tags: you can set the parameters directly in the tag
|
|
36
|
+
definition, like this:
|
|
37
|
+
|
|
38
|
+
\{breadcrumbTrail: {omitLast: true, separator: ' | '}}
|
|
39
|
+
|
|
40
|
+
- - change the default language?
|
|
41
|
+
- |
|
|
42
|
+
To use, for example, German as the default language, put the following into the configuration file:
|
|
43
|
+
|
|
44
|
+
Core/Configuration:
|
|
45
|
+
lang: de
|
|
46
|
+
|
|
47
|
+
- - set a different content format for page files?
|
|
48
|
+
- |
|
|
49
|
+
If you want to change the default content format, you need to add the following to your
|
|
50
|
+
configuration file (assuming you didn't set the {param: Core/FileHandler:defaultMetaInfo} parameter):
|
|
51
|
+
|
|
52
|
+
File/PageHandler:
|
|
53
|
+
defaultMetaInfo:
|
|
54
|
+
blocks: [[content, FORMAT_NAME]]
|
|
55
|
+
|
|
56
|
+
This will set the default format to FORMAT_NAME.
|
|
57
|
+
|
|
58
|
+
If you just want to change the format for a block, you should do it like this:
|
|
59
|
+
|
|
60
|
+
<notextile><pre><code>--- content, FORMAT_NAME
|
|
61
|
+
This is the block
|
|
62
|
+
</code></pre></notextile>
|
|
63
|
+
|
|
64
|
+
- - set the default meta information for files created by a specific file handler?
|
|
65
|
+
- |
|
|
66
|
+
Use the configuration file! For example, to change the default content format
|
|
67
|
+
to markdown and @inMenu@ to @true@ for page files use the following in your configuration file:
|
|
68
|
+
|
|
69
|
+
File/PageHandler:
|
|
70
|
+
defaultMetaInfo:
|
|
71
|
+
blocks: [[content, markdown]]
|
|
72
|
+
inMenu: true
|
|
73
|
+
|
|
74
|
+
- - ignore files in the source directory?
|
|
75
|
+
- |
|
|
76
|
+
This can be done using the {param: Core/FileHandler:ignorePaths} parameter. For example, to
|
|
77
|
+
ignore all files starting in @core@, you would put the following in the configuration file:
|
|
78
|
+
|
|
79
|
+
Core/FileHandler:
|
|
80
|
+
ignorePaths: [**/core*]
|
|
81
|
+
|
|
82
|
+
Be aware that the parameter overwrites the default setting. For more information on which
|
|
83
|
+
path patterns are supported, have a look a the
|
|
84
|
+
<a href="{relocatable: plugins/core/filehandler.page#pathpattern}">path pattern documentation</a>!
|
|
85
|
+
|
|
86
|
+
- - change the output name format of page file?
|
|
87
|
+
- |
|
|
88
|
+
Set the {param: File/PageHandler:outputNameStyle} in the configuration file to globally change
|
|
89
|
+
how the output names for page files are constructed or use the @outputNameStyle@ meta
|
|
90
|
+
information to change it only for individual page files!
|
|
91
|
+
|
|
92
|
+
For more information have a look at the documentation of the
|
|
93
|
+
{param: File/PageHandler:outputNameStyle} parameter!
|
|
94
|
+
|
|
95
|
+
- - use embedded ruby in page/template files?
|
|
96
|
+
- |
|
|
97
|
+
Have a look at the <a href="{relocatable: references/webpage_format.page#proc-erb}">ERB section</a> of
|
|
98
|
+
the WebPage Format reference!
|
|
99
|
+
|
|
100
|
+
- - modify the template chain?
|
|
101
|
+
- |
|
|
102
|
+
First, have a look at the {plugin: File/TemplateHandler} documentation!
|
|
103
|
+
|
|
104
|
+
To stop the template chain at a specific template or even at the page file itself, specify a
|
|
105
|
+
null template in the meta information, like this:
|
|
106
|
+
|
|
107
|
+
template: ~
|
|
108
|
+
|
|
109
|
+
To nest templates, you just need to specify the template in the meta information section:
|
|
110
|
+
|
|
111
|
+
template: my_special.template
|
|
112
|
+
|
|
113
|
+
Be aware that if no @template@ meta information is specified for a page or template file, the
|
|
114
|
+
template handler automatically searches for a default template in directory and the parent
|
|
115
|
+
directories of the file!
|
|
116
|
+
|
|
117
|
+
- - localize a directory name?
|
|
118
|
+
- |
|
|
119
|
+
Just set the @directoryName@ meta information on the localized directory index files!
|
|
120
|
+
|
|
121
|
+
- - provide additional attributes on links to a page file?
|
|
122
|
+
- |
|
|
123
|
+
You can specify additional attributes for a page file using the @linkAttrs@ meta information.
|
|
124
|
+
Take the following page file:
|
|
125
|
+
|
|
126
|
+
<notextile><pre><code>---
|
|
127
|
+
title: Tutorial
|
|
128
|
+
inMenu: true
|
|
129
|
+
linkAttrs:
|
|
130
|
+
title: This is a rather large tutorial
|
|
131
|
+
accesskey: D
|
|
132
|
+
tabindex: 5
|
|
133
|
+
---
|
|
134
|
+
Yippieh, this is my tutorial!
|
|
135
|
+
</code></pre></notextile>
|
|
136
|
+
|
|
137
|
+
When a link to this page is created the specified attributes always get set on this link!
|
|
138
|
+
|
|
139
|
+
- - add page specific sidebar content?
|
|
140
|
+
- |
|
|
141
|
+
There are many ways to accomplish this, I will show only one way here using blocks. Add the
|
|
142
|
+
following to the sidebar in your @default.template@:
|
|
143
|
+
|
|
144
|
+
<% if node.node_info[:pagedata].blocks.has_key?( 'sidebar' ) %>
|
|
145
|
+
\{block: sidebar}
|
|
146
|
+
<% end %>
|
|
147
|
+
|
|
148
|
+
This will include the contents of the block @sidebar@ in the sidebar if such a block exists
|
|
149
|
+
for a page. Then just add a sidebar block to each page file which needs it. Following is such
|
|
150
|
+
a sample page file:
|
|
151
|
+
|
|
152
|
+
<notextile><pre><code>This is the main content block
|
|
153
|
+
--- sidebar
|
|
154
|
+
This is the sidebar block and everything in here goes to the sidebar!
|
|
155
|
+
</code></pre></notextile>
|
|
156
|
+
|
|
157
|
+
- - use global variables?
|
|
158
|
+
- |
|
|
159
|
+
First you need to set some global variables in your configuration file:
|
|
160
|
+
|
|
161
|
+
Core/Configuration:
|
|
162
|
+
customVars:
|
|
163
|
+
myVar: This is really nice!
|
|
164
|
+
myOtherVar: another content
|
|
165
|
+
|
|
166
|
+
Then you can use the {plugin: Tag/CustomVar} to output the variables:
|
|
167
|
+
|
|
168
|
+
\{customVar: myVar}
|
|
169
|
+
|
|
170
|
+
- - create XML output?
|
|
171
|
+
- |
|
|
172
|
+
This can be achieved manually (by setting the content format of the page file to @html@ and
|
|
173
|
+
then directly creating the XML elements) or by using the {plugin: ContentConverter/XmlBuilder}
|
|
174
|
+
plugin !
|
|
175
|
+
|
|
176
|
+
- - use emoticons instead of ASCII smileys?
|
|
177
|
+
- |
|
|
178
|
+
Either globally enable an emoticon pack in the configuration file, like this:
|
|
179
|
+
|
|
180
|
+
Misc/SmileyReplacer:
|
|
181
|
+
emoticonPack: crystal
|
|
182
|
+
|
|
183
|
+
Or enable smiley replacement only on a specific page file using the meta information, like
|
|
184
|
+
this:
|
|
185
|
+
|
|
186
|
+
emoticonPack: crystal
|
|
187
|
+
|
|
188
|
+
- - syntax highlight an included file?
|
|
189
|
+
- |
|
|
190
|
+
This can be done using the {plugin: Tag/IncludeFile} plugin. Make sure you have @coderay@
|
|
191
|
+
installed! Here is an example which includes a syntax highlighted ruby file:
|
|
192
|
+
|
|
193
|
+
\{includeFile: {filename: happy.rb, highlight: ruby}}
|
|
194
|
+
|
|
195
|
+
- - create a static menu?
|
|
196
|
+
- |
|
|
197
|
+
Have a look at the <a href="{relocatable: plugins/core/filehandler.page#metainfo-file}">meta information backing file</a> documentation!
|
|
198
|
+
|
|
199
|
+
You can use virtual nodes in the output backing section to define virtually any menu structure
|
|
200
|
+
you like, including things like having menu entries that point to the same page and links to
|
|
201
|
+
external pages!
|
|
202
|
+
|
|
203
|
+
---
|
|
204
|
+
h1. How to...?
|
|
205
|
+
|
|
206
|
+
|
|
207
|
+
This is a collection of some commonly asked questions on how to accomplish certain things with
|
|
208
|
+
webgen. If you have an idea for a new howto, don't hestitate to write me a
|
|
209
|
+
<a href="mailto:t_leitner@gmx.at">email</a>!
|
|
210
|
+
|
|
211
|
+
<notextile>
|
|
212
|
+
<ul>
|
|
213
|
+
<% node['howtos'].each_with_index do |howto, h_index| %>
|
|
214
|
+
<li><a href="javascript: toogle('howto-<%= h_index %>')"><%= howto[0] %></a>
|
|
215
|
+
<div id="howto-<%= h_index %>" style="display: none">
|
|
216
|
+
<%= @plugin_manager['ContentConverter/Textile'].call( howto[1].to_s ) %>
|
|
217
|
+
</div>
|
|
218
|
+
</li>
|
|
219
|
+
<% end %>
|
|
220
|
+
</ul>
|
|
221
|
+
</notextile>
|