You can enhance your Pier installation through add-ons. This page describes them.

• 1. Blog
• 2. Randomizer
• 3. Editor enhancement
• 4. Google
• 5. Links
• 6. ShoutPier
• 7. SyntaxHighlighter
• 8. CiteZen
• 9. Sitemap
• 10. Gallery

Blog

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

Randomizer

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

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

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

Google

Adds Google analytics and webmaster tools to your pages.

Links

Insert youtube, slideshare, isbn and vimo elements into your pages.

Here is the syntax for each kind of link:

ShoutPier

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

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.

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.

CiteZen

Offers bib parsing and rendering capabilities

To install this add-on, look at the wiki page on the website.

Once installed, use the ’Add’ link and add a ’Bib File’ structure to your installation. Enter the location of a BibTeX file and validate.

Looking at the new structure, you have a search box to look for entries in your bibliography. You can link or embed part of the bibliography using the following properties in the value link:

Here is an example:

Look at my *list of publications>Publications|query=Damien Pollet|sortBy=category|hideControls=true*

Sitemap

Gallery

Pier-Gallery is a picture gallery with the following features:

• import pictures simply by uploading a zip
• create a gallery, and point to an existing directory on your server to fill it
• square rendering of thumbnails
• thumbnail creation and image resize is automatic and modifiable any time
• files in a gallery directory that are not images are skipped
• when you are logged, simply click on a thumbnail to go to a picture-specific page, where you can do small modifications (hide/show the image, rotate it)
• create a page with Gallery-Randomizer component embedded, and it will pick an image randomly from your galleries

Note that Pier-Gallery depends on Rio, you need to install it first.

Installer ss
  project: 'Rio';
  install: 'Rio-Kernel';
  install: 'Rio-Grande'.