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.
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:
- 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);
- where you want to have highlighted code in a Pier page, embed a link (using the
+sampleCode1+
syntax); - save your page and click on the link;
- select the
Highlighted code
type, give a name and save; - there, you can enter your code and select the language and the options.
- 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 thefiles
line; - select the
configure
ofPRSyntaxHighlighterFiles
; - 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).