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.
Files changed (93) hide show
  1. data/ChangeLog +300 -0
  2. data/Rakefile +149 -27
  3. data/TODO +3 -4
  4. data/VERSION +1 -1
  5. data/data/webgen/gallery_styles/slides/collage.rb +7 -4
  6. data/data/webgen/sipttra_styles/default/README +7 -0
  7. data/data/webgen/sipttra_styles/default/css/sipttra.rcss +71 -0
  8. data/data/webgen/sipttra_styles/default/js/sipttra.js +7 -0
  9. data/data/webgen/sipttra_styles/default/sipttra.template +105 -0
  10. data/data/webgen/website_styles/1024px/README +3 -0
  11. data/data/webgen/website_styles/1024px/default.css +3 -3
  12. data/data/webgen/website_styles/andreas00/README +4 -1
  13. data/data/webgen/website_styles/andreas00/default.css +2 -2
  14. data/data/webgen/website_styles/andreas01/README +3 -0
  15. data/data/webgen/website_styles/andreas01/default.css +3 -3
  16. data/data/webgen/website_styles/andreas03/README +4 -1
  17. data/data/webgen/website_styles/andreas03/default.css +2 -2
  18. data/data/webgen/website_styles/andreas04/README +3 -0
  19. data/data/webgen/website_styles/andreas04/default.css +2 -2
  20. data/data/webgen/website_styles/andreas05/README +3 -0
  21. data/data/webgen/website_styles/andreas05/default.css +2 -2
  22. data/data/webgen/website_styles/andreas06/README +3 -0
  23. data/data/webgen/website_styles/andreas06/default.css +3 -2
  24. data/data/webgen/website_styles/andreas07/README +3 -0
  25. data/data/webgen/website_styles/andreas07/default.css +4 -4
  26. data/data/webgen/website_styles/andreas08/README +4 -1
  27. data/data/webgen/website_styles/andreas08/default.css +2 -2
  28. data/data/webgen/website_styles/andreas08/default.template +1 -1
  29. data/data/webgen/website_styles/andreas09/README +3 -0
  30. data/data/webgen/website_styles/andreas09/default.css +2 -2
  31. data/data/webgen/website_styles/default/README +1 -1
  32. data/data/webgen/website_styles/default/default.css +1 -1
  33. data/data/webgen/website_styles/plain/README +7 -2
  34. data/data/webgen/website_styles/plain/default.css +2 -2
  35. data/doc/config.yaml +3 -0
  36. data/doc/metainfo.yaml +20 -3
  37. data/doc/src/css/sipttra.rcss +71 -0
  38. data/doc/src/default.template +10 -5
  39. data/doc/src/documentation/howto.page +221 -0
  40. data/doc/src/documentation/plugins/contentconverter/default.page +1 -0
  41. data/doc/src/documentation/plugins/contentconverter/xmlbuilder.page +2 -2
  42. data/doc/src/documentation/plugins/core/configuration.page +6 -0
  43. data/doc/src/documentation/plugins/core/resourcemanager.page +4 -10
  44. data/doc/src/documentation/plugins/file/defaulthandler.page +1 -0
  45. data/doc/src/documentation/plugins/file/sipttrahandler.page +18 -0
  46. data/doc/src/documentation/plugins/file/templatehandler.page +27 -10
  47. data/doc/src/documentation/plugins/file/thumbnailwriter.page +5 -2
  48. data/doc/src/documentation/plugins/htmlvalidator/default.page +1 -0
  49. data/doc/src/documentation/plugins/index.page +2 -2
  50. data/doc/src/documentation/plugins/menustyle/default.page +1 -0
  51. data/doc/src/documentation/plugins/tag/breadcrumbtrail.page +12 -0
  52. data/doc/src/documentation/plugins/tag/customvar.page +11 -0
  53. data/doc/src/documentation/plugins/tag/default.page +1 -0
  54. data/doc/src/documentation/references/index.page +8 -0
  55. data/doc/src/documentation/references/meta_info_reference.page +35 -16
  56. data/doc/src/documentation/references/resource_reference.page +18 -0
  57. data/doc/src/documentation/references/sipttra_format.page +241 -0
  58. data/doc/src/documentation/references/webpage_format.page +4 -0
  59. data/doc/src/examples/example_sites/index.page +41 -0
  60. data/doc/src/examples/example_sites/personal.zip +0 -0
  61. data/doc/src/examples/example_sites/photo_gallery.zip +0 -0
  62. data/doc/src/examples/index.page +2 -1
  63. data/doc/src/js/sipttra.js +7 -0
  64. data/doc/src/news.page +25 -0
  65. data/doc/src/project.todo +91 -0
  66. data/doc/src/sipttra.template +105 -0
  67. data/lib/webgen/cli.rb +31 -1
  68. data/lib/webgen/config.rb +2 -2
  69. data/lib/webgen/plugin.rb +7 -3
  70. data/lib/webgen/plugins/coreplugins/configuration.rb +3 -1
  71. data/lib/webgen/plugins/filehandlers/filehandler.rb +6 -5
  72. data/lib/webgen/plugins/filehandlers/sipttra.rb +73 -0
  73. data/lib/webgen/plugins/filehandlers/template.rb +2 -1
  74. data/lib/webgen/plugins/miscplugins/treewalker.rb +40 -4
  75. data/lib/webgen/plugins/tags/breadcrumbtrail.rb +14 -1
  76. data/lib/webgen/plugins/tags/customvar.rb +54 -0
  77. data/lib/webgen/sipttra_format.rb +343 -0
  78. data/lib/webgen/website.rb +25 -1
  79. data/man/man1/webgen.1 +75 -0
  80. data/setup.rb +861 -607
  81. data/test/fixtures/sample_site/src/test.todo +7 -0
  82. data/test/fixtures/tc_plugin/plugin1.rb +2 -0
  83. data/test/fixtures/tc_sipttra_format/test.sipttra +46 -0
  84. data/test/unittests/tc_filehandler_sipttra.rb +26 -0
  85. data/test/unittests/tc_filehandler_template.rb +2 -1
  86. data/test/unittests/tc_plugin.rb +8 -1
  87. data/test/unittests/tc_sipttra_format.rb +58 -0
  88. data/test/unittests/tc_tags_breadcrumbtrail.rb +34 -0
  89. data/test/unittests/tc_tags_customvar.rb +24 -0
  90. data/test/unittests/tc_tags_date.rb +1 -0
  91. data/test/unittests/tc_tags_includefile.rb +6 -13
  92. data/test/unittests/tc_treewalker.rb +8 -1
  93. metadata +37 -3
@@ -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
@@ -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;
@@ -8,5 +8,8 @@ description:
8
8
  author:
9
9
  Andreas Viklund (adapted for webgen by Thomas Leitner)
10
10
 
11
+ copyright:
12
+ http://andreasviklund.com/about/copyright/
13
+
11
14
  homepage:
12
15
  http://andreasviklund.com/templates
@@ -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="generato" content="webgen - http://webgen.rubyforge.org" />
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>
@@ -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
@@ -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;
@@ -3,4 +3,4 @@ description:
3
3
  the breadcrumb trail and the language menu, then a menu on the left and a footer.
4
4
 
5
5
  author:
6
- Thomas Leitner
6
+ Thomas Leitner
@@ -52,7 +52,7 @@
52
52
 
53
53
  /* styling the menu */
54
54
 
55
- #menu a {
55
+ #menu a, #menu span {
56
56
  text-decoration: none;
57
57
  font-weight: bold;
58
58
  font-size: 130%;
@@ -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://xij.p0wned.org/prettyasapicture/
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;
@@ -1,3 +1,6 @@
1
+ File/CopyHandler:
2
+ paths: ["**/*.css", "**/*.js", "**/*.jpg", "**/*.png", "**/*.gif", "**/*.zip"]
3
+
1
4
  File/PageHandler:
2
5
  validator: xmllint
3
6
 
@@ -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/parameter_reference.page:
44
- orderInfo: 15
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: 11
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
+ }
@@ -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 with PayPal!" />
73
- <img alt="" style="border:0px" src="https://www.paypal.com/de_DE/i/scr/pixel.gif" width="1" height="1" />
74
- <input type="hidden" name="encrypted" value="-----BEGIN PKCS7-----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-----END 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">&nbsp;</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>