Icon.png

Documentation

Add-ons

You can enhance your Pier installation through add-ons. Most add-ons are hosted at http://source.lukas-renggli.ch/pier2addons.html. This page describes some of the available add-ons.

Blog

A generic blog extension supporting multiple blogs, RSS feeds, posts with embedded media, public comments, etc.

Repository http://source.lukas-renggli.ch/pier2
Included in Pier image yes

Randomizer

Randomizes the display of specific parts in the page. Useful to display images randomly.

Repository http://source.lukas-renggli.ch/pier2addons
Included in Pier image no

To use it, add a new component to your page and choose PRRandomizer. Add new children to this component, they will be chose randomly. You can change the Keep setting if the same child must be used during the whole session.

Editor enhancement

Repository http://source.lukas-renggli.ch/pier2addons
Included in Pier image yes

Displays a tool-bar on top of wiki text areas to simplify editing.

Google

Repository http://source.lukas-renggli.ch/pier2addons
Included in Pier image yes

Adds Google analytics and webmaster tools to your pages.

ShoutPier

Syntax highlights Smalltalk expressions and methods. The color scheme can be configured using a CSS style-sheet.

Repository http://source.lukas-renggli.ch/pier2addons
Included in Pier image no
Dependency Shout, the Squeak syntax highlighter

To use it, you have to add the SPHighlightedStyle library to your pier application (go to the Seaside configuration page for Pier and select the library from the list). Then, start each line of Smalltalk code with ==.

SyntaxHighlighter

This is a Pier wrapper for SyntaxHighlighter, a multi-language code highlighter written in Javascript by Alex Gorbatchev.

The Javascript code is under the LGPL 3 license. If you like it, please consider donating to his author.

Repository http://source.lukas-renggli.ch/pier2addons
Included in Pier image no

To use it:

  1. you first need to add the PRSyntaxHighlighterFiles library to your Pier application (go to the Seaside configuration page for Pier and select the library from the list);
  2. where you want to have highlighted code in a Pier page, embed a link (using the +sampleCode1+ syntax);
  3. save your page and click on the link;
  4. select the Highlighted code type, give a name and save;
  5. there, you can enter your code and select the language and the options.
  6. press save again.

You should now be able to see your highlighted code.

Another solution is to write your code directly in the page, i.e., without needing an additional structure. The syntax is:

 =sh brush:java; gutter:false; toolbar:false
 =sh public static void main(String [] args) {
 =sh "123" /* abc */ sdfsdf // dfsfsdf
 =sh }

The first line is used to configure the code section. The parameters are the same as the ones found when you add a Highlighted code structure. They are described on the SyntaxHighlighter website.

If you want to add your own syntax, you first have to create a Javascript file. Take a look at the examples.

Once you have your js file (named like the others: shBrushYourLanguage.js), upload it using the Seaside configuration web page:

  • go to /seaside/config;
  • click on the configure link in the files line;
  • select the configure of PRSyntaxHighlighterFiles;
  • browse to your file and add it.

Your language should now be available in the list of languages you can use. If it does not work, check that your js file does not contain errors (check the javascript console of your browser).