Two consecutive newlines in the body of an article are treated as the start of a new paragraph, and a <p> element is inserted in their place.
The current list of allowed HTML elements and attributes can be viewed in the CLiki source code: https://gitlab.common-lisp.net/vsedach/cliki2/blob/master/src/markup.lisp
Special CLiki Markup
- Internal links: _(Foo) renders as Foo. Cliki page titles aren't case-sensitive, but Cliki will remember the way the title was written when you first created the page, and formats it that way forevermore. So, please make some effort to use capitals where appropriate.
- Topic markers: *(Foo) declares this page to be relevant to topic Foo. The page will then show up in any topic lists (see below) for Foo. Topic markers are the main tool to organize CLiki, and are critical to making your article easy to find. Usually there will be a topic page called Foo that contains a list of all the pages in topic Foo.
- CLHS references: _H(FOO), where FOO is a standard CL symbol, will expand into a link to the appropriate Hyperspec page. Thanks to Eric Marsden for the code that does this. For example _H(destructuring-bind) becomes a link to destructuring-bind.
- Topic lists: /(SLIME) renders a list of all pages with the topic marker *(SLIME) as:
- ABCL - Armed Bear Common Lisp (aka ABCL) is a
- cl-syntax - CL-SYNTAX provides Reader Syntax Conventions for Common Lisp and SLIME
- Editing Lisp Code with Emacs - Keyboard tips
- Mark Davidson - I have been working with these infernal machines for over 22 years, and have dabbled with Lisp over time..
- reattatchabe slime - Here is a little makedef file to start/stop a lisp application and allow the developer to attach to the running process with attachtty or slime
- SLIME Features - This is an evolving description of the features available in SLIME
- SLIME-HOWTO - This is a collection of information about using SLIME - a proto-manual
- Swank - Swank is distributed as part of SLIME
<pre> and <code> tags
HTML <pre> and <code> tags are treated specially. All text occuring in these elements is treated literally, including any other HTML markup. So:
<a href="foo.com">links</a> cannot be inserted in <pre> tags, for example
<code> tags can be used to colorize code (via the colorize library) by providing the lang attribute, like so:
<code lang="common-lisp"> ...code... </code>
Some example code looks like:
The currently supported language types are: lisp, scheme, elisp, common-lisp, basic-c, c, c++, java
Escaping
To escape the special CLiki markup, e.g., on this page when describing how to use the search tag, e.g.
/(SLIME)
where we don't actually want the search results to be displayed, you must insert some text between the special markup character and the open paren. HTML comments work well. For example, the following:
/<!-- -->(SLIME)
will be rendered as
/(SLIME)
Characters like ampersands and pointy brackets that have special meaning in HTML can be encoded using regular HTML escape codes: < is < and & is &. HTML pound-escaping is also supported: % renders as %.
Article conventions
When linking to libraries and software packages, please specify the license under which the software is distributed using SPDX license identifiers.