Template Overview

Main.TemplateOverview History

Hide minor edits - Show changes to output

Changed line 2 from:
%define=yellowbox box bgcolor=#fff7cb border='1px solid #ffad80'%
to:
%define=yellowbox box bgcolor=#fdfaea border='1px solid #ffad80'%
Changed line 4 from:
%define=bluebox box bgcolor=#f0f0ff border='1px solid #c6c9ff'%
to:
%define=bluebox box bgcolor=#f4fbff border='1px solid #a1cae6'%
Changed lines 6-7 from:
%define=greybox box bgcolor=#f9f9f9 border='1px solid #aaaaaa'%
%define=greenbox box bgcolor=#e3f0e1 border='1px solid #60a457'%
to:
%define=greybox box bgcolor=#fbfbfb border='1px solid #aaaaaa'%
%define=greenbox box bgcolor=#e6f3e5 border='1px solid #8fd586'%
Changed lines 9-10 from:
to:
\\
%rfloat% Attach:projectimage.jpg
Abstract text about the project.
Changed lines 15-35 from:
# [[#about | About Toolkit]]
# [[#download | Download and Installation]]
# [[#recipes | Recipes, How-To's]]
# [[#tutorials | Tutorials and Examples]]
# [[#links | Links]]
# [[#bugreports | Bug Reports]]






[[#about]]
>>greybox<<
!!! 1. About Toolkit

%rfloat% Attach:picture.jpg
Describe your toolkit and the features very briefly. You can add a small image (max. dimensions are 200x150 pixel) on the right side, e.g. a screenshot of your toolkit interface.

>><<
to:
* [[#download | Download and Installation]]
* [[#recipes | Recipes, How-To's]]
* [[#tutorials | Tutorials and Examples]]
* [[#links | Links]]
\\
\\
Changed lines 25-32 from:
!!! 2. Download and Installation

Describe the installation of the toolkit, and add images where necessary.

[@
Code block example
@]
to:
!!! Download and Installation

* (Under Construction)
Changed lines 33-39 from:
!!! 3. Recipes and How-To's

* Add here the short recipes for your toolkit
* Maybe small code examples
* or common solutions
* and other short explanations
to:
!!! Recipes and How-To's

* (Under Construction)
Changed lines 42-48 from:
!!! 4. Tutorials and Examples

Add links to tutorials and examples, and also add the links to the source code ZIP files for each of the tutorials.

* Tutorial 1
* Tutorial 2
to:
!!! Tutorials and Examples

* (Under Construction)
Changed lines 50-62 from:
!!! 5. Links

Links to PDF and ZIP files, as well as other sites about the projects.

>><<

[[#bugreports]]
>>greybox<<
!!! 6. Bug Reports

Please add bug reports here:


>><<
to:
!!! Links

* (Under Construction)

>><<
Changed lines 13-24 from:
# About Toolkit
# Download and Installation
# Recipes, How-To's
# Tutorials and Examples
# Links
# Bug Reports




to:
# [[#about | About Toolkit]]
# [[#download | Download and Installation]]
# [[#recipes | Recipes, How-To's]]
# [[#tutorials | Tutorials and Examples]]
# [[#links | Links]]
# [[#bugreports | Bug
Reports]]






[[#about]]
Changed line 34 from:
to:
[[#download]]
Changed line 46 from:
to:
[[#recipes]]
Changed line 58 from:
to:
[[#tutorials]]
Changed line 69 from:
to:
[[#links]]
Changed line 77 from:
to:
[[#bugreports]]
Added lines 22-24:

Added line 30:
Changed line 17 from:
# Other Links
to:
# Links
Changed lines 21-22 from:
!!! About Toolkit
to:
>>greybox<<
!!! 1. About Toolkit
Changed lines 27-29 from:
to:
>><<
Changed lines 31-32 from:
!!! Download and Installation
to:
!!! 2. Download and Installation
Changed lines 43-44 from:
!!! Recipes and How-To's
to:
!!! 3. Recipes and How-To's
Changed lines 55-56 from:
!!! Tutorials and Examples
to:
!!! 4. Tutorials and Examples
Changed lines 66-67 from:
!!! Other Links
to:
!!! 5. Links
Changed lines 74-75 from:
!!! Bug Reports
to:
!!! 6. Bug Reports
Changed line 7 from:
%define=greenbox box bgcolor=#d9eed6 border='1px solid #60a457'%
to:
%define=greenbox box bgcolor=#e3f0e1 border='1px solid #60a457'%
Changed line 7 from:
%define=greenbox box bgcolor=#D9EED6 border='1px solid #60a457'%
to:
%define=greenbox box bgcolor=#d9eed6 border='1px solid #60a457'%
Changed line 7 from:
%define=greenbox box bgcolor=#d0ebcd border='1px solid #60a457'%
to:
%define=greenbox box bgcolor=#D9EED6 border='1px solid #60a457'%
Changed lines 8-9 from:
to:
%define=whitebox box bgcolor=#ffffff border='1px solid #999999'%
Changed line 26 from:
to:
>>greenbox<<
Added lines 35-37:
>><<
Added line 45:
Changed lines 49-72 from:
!!! Technical hints (advanced user/admin.)

>>redbox<<
!!!! Notebook tabs customization

The skin uses the list of action links stored into @@[[{$Group}.PageActions|[={$Group}.PageActions=]]]@@ or @@[[Site.PageActions]]@@ pages to generate the notebook tabs (as PmWiki default skin does to display available actions).

In order to restore the previous skin specific behavior, each action link definition may be followed by a secondary (hidden) link for the rendering of the currently selected tab (aka. for the current action).

Skin previous default behavior would be restored with following sample [[(Site.)PageActions]] customization:

[@
* [[$[View] -> {$FullName}]] %comment%[[{$Group}|{$Groupspaced}/&hellip;]]%%
* [[$[Edit Page] -> {$FullName}?action=edit]]
* [[$[Page Attributes] -> {$FullName}?action=attr]]
* [[$[Page History] -> {$FullName}?action=diff]]
* [[$[Upload] -> {$FullName}?action=upload]]
@]
where the first tab is rendered as a link to either:
:'[[{$Group}|{$Groupspaced}/&hellip;]]': current page group when browsing a page,
:'[[$[View] -> {$FullName}]]': browse current page when performing another action on it.
>><<
to:
Changed lines 51-74 from:
!!!! External link decoration

Sometimes, the decoration applied to external links (whose not generated from group/pages) leads to bad looking rendered output (especially when using images as links)
. The following image link:

[@
[[http://www.pmwiki.org|http://www.pmichaud.com/img/misc/gem.jpg]]
@]
is (poorly) rendered as: [[http://www.pmwiki.org|http://www.pmichaud.com/img/misc/gem.jpg]]

The solution is to explicitly qualify the link with the [@%wikilink%@] style as if it was "internally" generated. The tweaked image link:

[@
%wikilink% [[http://www.pmwiki.org|http://www.pmichaud.com/img/misc/gem.jpg]]
@]
is (better) rendered as: %wikilink% [[http://www.pmwiki.org|http://www.pmichaud.com/img/misc/gem.jpg]]

'''Nota (PmWiki version <
2.1 beta 10)''': when applying this trick to already ''class-defined'' elements (such as [@%lframe%@] enclosed images), you need to write explicitely the style definition using atomic class elements (as [@%class='lfloat frame wikilink'%@] in this case):

[@
%class='frame wikilink'% [[http://www.pmwiki.org|http://www.pmichaud.com/img/misc/gem.jpg]]
@]
renders as:

%class='frame wikilink'% [[http://www.pmwiki.org|http://www.pmichaud.com/img/misc/gem.jpg]]
to:
!!! Tutorials and Examples

Add links to tutorials and examples, and also add the links to the source code ZIP files for each of the tutorials
.

* Tutorial 1
* Tutorial
2
Changed lines 62-70 from:
!!!! Header customization

Like [[Grease(Skin)]] skin does, several "fixed" parts of the skin (title, wikititle) may be customized from the configuration file via the [@$SkinPartFmt@] array variable, and with regular markup definitions. The skin defaults are:
[@
$SkinPartFmt['wikititle'] = "$WikiTitle - {\$Titlespaced}";

$SkinPartFmt['title'] = '{$Titlespaced}';@]
As a side effect, the [@(:title ...:)@] directive will handle regular markup (emphasis, links, ...)
.
to:
!!! Other Links

Links to PDF and ZIP files, as well as other sites about the projects
.
Added lines 67-74:


>>greybox<<
!!! Bug Reports

Please add bug reports here:

>><<
Changed lines 7-17 from:
!!! About

%rfloat% Attach:monobook.jpg
This skin is massively inspired from MediaWiki default skin (also originally named @@monobook@@).
MediaWiki is the software used for [[Wikipedia -> http
://www.wikipedia.org]] and the other Wikimedia Foundation websites.

!!! Installation

To use the Monobook skin for your own Wiki, just download [[(Attach:)monobook.zip]], extract it into @@/path/to/pmwiki/pub/skins/@@ and add the following code to your local configuration file:
to:
%define=greenbox box bgcolor=#d0ebcd border='1px solid #60a457'%


!!! Contents

# About Toolkit
# Download and Installation
# Recipes, How-To's
# Tutorials and Examples
# Other Links
# Bug Reports


!!! About Toolkit

%rfloat% Attach
:picture.jpg
Describe your toolkit and the features very briefly
. You can add a small image (max. dimensions are 200x150 pixel) on the right side, e.g. a screenshot of your toolkit interface.


!!! Download and Installation

Describe the installation of the toolkit, and add images where necessary.
Changed lines 31-33 from:
# Specifies the name of the template file
# to be used to generate pages.
$Skin = 'monobook';
to:
Code block example
Deleted lines 33-42:
!!! Features

The skin current features are:
* Full CSS driven (no tables),
* Wiki actions as notebook tabs,
* Zoom support (fixed size fonts used only for Wiki actions),
* Smooth handling of [@(:noheader:)@], [@(:nofooter:)@] and [@(:notitle:)@] directives,
* Extra directives [@(:noleft:)@] and [@(:notabs:)@] available to hide unwanted sections
* %green%Developed and tested under IE6 and Firefox.%%
Changed lines 35-40 from:
:Note:The original layout is supposed to handle a 135x135 pixels logo. This explains why the PmWiki logo looks a bit alone in its corner.
to:
!!! Recipes and How-To's

* Add here the short recipes for your toolkit
* Maybe small code examples
* or common solutions
* and other short explanations
Added line 43:
Changed lines 59-61 from:
to:
>><<
Changed lines 87-89 from:
to:
>><<
Deleted line 0:
(:nogroupheader:)<<|[[(Cookbook.)Skins]]|>>(:nolinkwikiwords:)
Deleted line 11:
Added lines 60-61:
Added lines 88-89:
Changed line 1 from:
to:
(:nogroupheader:)<<|[[(Cookbook.)Skins]]|>>(:nolinkwikiwords:)
Changed line 1 from:
(:nogroupheader:)<<|[[(Cookbook.)Skins]]|>>(:nolinkwikiwords:)
to:
Added lines 1-98:
(:nogroupheader:)<<|[[(Cookbook.)Skins]]|>>(:nolinkwikiwords:)
%define=box padding-left=1em padding-right=1em margin='3px 3px 0'%
%define=yellowbox box bgcolor=#fff7cb border='1px solid #ffad80'%
%define=redbox box bgcolor=#fff3f3 border='1px solid #ffc9c9'%
%define=bluebox box bgcolor=#f0f0ff border='1px solid #c6c9ff'%
%define=skybox box bgcolor=#f8fcff border='1px solid #aaaaaa'%
%define=greybox box bgcolor=#f9f9f9 border='1px solid #aaaaaa'%

!!! About

%rfloat% Attach:monobook.jpg
This skin is massively inspired from MediaWiki default skin (also originally named @@monobook@@).

MediaWiki is the software used for [[Wikipedia -> http://www.wikipedia.org]] and the other Wikimedia Foundation websites.

!!! Installation

To use the Monobook skin for your own Wiki, just download [[(Attach:)monobook.zip]], extract it into @@/path/to/pmwiki/pub/skins/@@ and add the following code to your local configuration file:

[@
# Specifies the name of the template file
# to be used to generate pages.
$Skin = 'monobook';
@]

!!! Features

The skin current features are:
* Full CSS driven (no tables),
* Wiki actions as notebook tabs,
* Zoom support (fixed size fonts used only for Wiki actions),
* Smooth handling of [@(:noheader:)@], [@(:nofooter:)@] and [@(:notitle:)@] directives,
* Extra directives [@(:noleft:)@] and [@(:notabs:)@] available to hide unwanted sections
* %green%Developed and tested under IE6 and Firefox.%%

>>yellowbox<<
:Note:The original layout is supposed to handle a 135x135 pixels logo. This explains why the PmWiki logo looks a bit alone in its corner.
>><<

!!! Technical hints (advanced user/admin.)

>>redbox<<
!!!! Notebook tabs customization

The skin uses the list of action links stored into @@[[{$Group}.PageActions|[={$Group}.PageActions=]]]@@ or @@[[Site.PageActions]]@@ pages to generate the notebook tabs (as PmWiki default skin does to display available actions).

In order to restore the previous skin specific behavior, each action link definition may be followed by a secondary (hidden) link for the rendering of the currently selected tab (aka. for the current action).

Skin previous default behavior would be restored with following sample [[(Site.)PageActions]] customization:

[@
* [[$[View] -> {$FullName}]] %comment%[[{$Group}|{$Groupspaced}/&hellip;]]%%
* [[$[Edit Page] -> {$FullName}?action=edit]]
* [[$[Page Attributes] -> {$FullName}?action=attr]]
* [[$[Page History] -> {$FullName}?action=diff]]
* [[$[Upload] -> {$FullName}?action=upload]]
@]
where the first tab is rendered as a link to either:
:'[[{$Group}|{$Groupspaced}/&hellip;]]': current page group when browsing a page,
:'[[$[View] -> {$FullName}]]': browse current page when performing another action on it.

>>bluebox<<
!!!! External link decoration

Sometimes, the decoration applied to external links (whose not generated from group/pages) leads to bad looking rendered output (especially when using images as links). The following image link:

[@
[[http://www.pmwiki.org|http://www.pmichaud.com/img/misc/gem.jpg]]
@]
is (poorly) rendered as: [[http://www.pmwiki.org|http://www.pmichaud.com/img/misc/gem.jpg]]

The solution is to explicitly qualify the link with the [@%wikilink%@] style as if it was "internally" generated. The tweaked image link:

[@
%wikilink% [[http://www.pmwiki.org|http://www.pmichaud.com/img/misc/gem.jpg]]
@]
is (better) rendered as: %wikilink% [[http://www.pmwiki.org|http://www.pmichaud.com/img/misc/gem.jpg]]

'''Nota (PmWiki version < 2.1 beta 10)''': when applying this trick to already ''class-defined'' elements (such as [@%lframe%@] enclosed images), you need to write explicitely the style definition using atomic class elements (as [@%class='lfloat frame wikilink'%@] in this case):

[@
%class='frame wikilink'% [[http://www.pmwiki.org|http://www.pmichaud.com/img/misc/gem.jpg]]
@]
renders as:

%class='frame wikilink'% [[http://www.pmwiki.org|http://www.pmichaud.com/img/misc/gem.jpg]]

>>greybox<<
!!!! Header customization

Like [[Grease(Skin)]] skin does, several "fixed" parts of the skin (title, wikititle) may be customized from the configuration file via the [@$SkinPartFmt@] array variable, and with regular markup definitions. The skin defaults are:
[@
$SkinPartFmt['wikititle'] = "$WikiTitle - {\$Titlespaced}";

$SkinPartFmt['title'] = '{$Titlespaced}';@]
As a side effect, the [@(:title ...:)@] directive will handle regular markup (emphasis, links, ...).

>><<