Site-Specific Syntax

Selene Code

"seleneCode" is a bbcode-like syntax used for this Pale Moon Developer Site. Unlike Phoebus Code it does not automatically translate new lines. As such it is more akin to HTML and much more advanced.

Headings

  • [title] and [/title]: Page Title (direct equivalent to the html h1 tag)
    • Alternative syntax: [title="Page Title"] with no end tag.
    • DPMO Usage: Page titles use "title capitalization" where as all words except articles such as "the" "a" "of" etc are capitalized. Articles are capitalized if they are the first word.
    • DPMO Note: This is automatically added to the top of every page by the software (as a value in the PAGES array) and is not normally added to content files.
  • [header] and [/header]: Header text (direct equivalent to the html h2 tag)
    • Alternative syntax: [header="Header text"] with no end tag.
    • DPMO Usage: Headers use "chapter capitalization" where as the first word is capitalized and the rest are not unless they are a proper noun (or proper technical term such as Complete Themes or Language Packs).
  • [section] and [/section]: Section text (direct equivalent to the html h3 tag)
    • Alternative syntax: [section="Section text"] with no end tag.
    • DPMO Usage: Headers use "chapter capitalization" where as the first word is capitalized and the rest are not unless they are a proper noun (or proper technical term such as Complete Themes or Language Packs).

Text formatting

  • [b] and [/b]: Bold text
  • [i] and [/i]: Italic text
  • [u] and [/u]: Underlined text
  • [p] and [/p]: Paragraph block (direct equivalent to the html p tag)
  • [span] and [/span]: Span block (direct equivalent to the html span tag)
  • [hr]: Horizontal rule (direct equivalent to the html hr tag)
  • [br]: Single line break (direct equivalent to the xhtml br tag)
  • [brake]: Single line break (a single xhtml br tag)
  • [dblbreak]: Two line breaks (two xhtml br tags)

The [p] and [span] tags do allow html attributes.

Pre-formatted text and code snippets

  • [code] and [/code]: Pre-formatted text or highlighted code block
    • Syntax and usage: [code=language]Some code or pre-formatted text[/code]
  • [codeline] and [/codeline]: In-line pre-formatted text or highlighted code
    • Syntax and usage: [p]Example code is [code=language]Some code or pre-formatted text[/code].[/p]

The languages that can be used for syntax highlighting are documented at the highlight.js project. If in doubt use "bash" or "plain".

Hyperlinks

  • [link] and [/link]: Internal hyperlink (normal navigation)
    • Syntax and usage: [link]http://example.com/[/link] or [link=http://example.com/]Example Test[/link]
    • DPMO Usage: All links on this sub-domain should use this tag.
  • [url] and [/url]: External hyperlink (opens a new window/tab)
    • Syntax and usage: [url]http://example.com/[/url] or [url=http://example.com/]Example Test[/url]
    • DPMO Usage: All links that go to another site outside of this sub-domain should use this tag.

Lists

  • [ul] and [/ul]: Unordered list
  • [ol] and [/ol]: Ordered list
  • [li] and [/li]: List item

These list related tags work exactly as they do in html and accept html attributes.

Tables

  • [table] and [/table]
  • [th] and [/th]
  • [tr] and [/tr]
  • [td] and [/td]
  • [caption] and [/caption]
  • [col] and [/col]
  • [colgroup] and [/colgroup]
  • [thead] and [/thead]
  • [tbody] and [/tbody]
  • [tfoot] and [/tfoot]

These table related tags work exactly as they do in html and accept html attributes.

Example

The best examples are the existing content files that exist in the repository.

Live preview

We understand that since the Developer Site has a greater degree of freedom regarding content layout and because of it being git controlled without a web panel it may be difficult to visualize how seleneCode tags will be translated to a live html form. To assist in this endevor we have written a test case to allow you to paste (or even compose) an arbitrary page and preview it live in your browser before commiting and submitting a pull request.

Just use this testing tool to enter your content and press the test button.

Phoebus Code

"phoebusCode" is a bbcode-like syntax used for the Add-on Page Content on the Pale Moon Add-ons Site and other Phoebus-powered Add-on Sites.

It isn't perfect but it tends to do the job.

Syntax

  • [b] and [/b]: Bold text
  • [i] and [/i]: Italic text
  • [u] and [/u]: Underlined text
  • [ul] and [/ul]: Unordered list (combine with [li] as below to create a bulletted list)
  • [ol] and [/ol]: Ordered list (combine with [li] as below to create a numerical ordered list)
  • [li] and [/li]: List item
  • [section] and [/section]: Denotes individual sections
  • [url] and [/url]: Provides links. Also accepted is [url=http://example.com/]Example Test[/url]

Example

An example of a phoebus.content file using some of the most common syntax.

Pale Moon Commander is an extension designed for the [url=http://www.palemoon.org/]Pale Moon web browser[/url]. It is a configurator, meaning it will provide a user-friendly interface to advanced preferences that would otherwise require manual editing of parameters, which can be cumbersome and time-consuming to do.
[section]How to access the add-on's settings[/section]
The add-on, when installed, adds a menu item 'Advanced Options...' in two locations:
[ul]
  [li]In the Application Menu (Pale Moon) under Options -> Advanced Options...[/li]
  [li]In the classic menu under Tools -> Advanced Options...[/li]
[/ul]
Clicking this menu item will open the preferences window that has been added by installing the add-on.
[section]There be dragons here![/section]
Using Pale Moon Commander to change advanced preferences is potentially dangerous and can leave your browser profile in a potentially unusable state. If you don't know what a setting is for, don't touch it. A number of the preferences made accessible through the add-on can prevent proper operation of the browser.

You can reset Pale Moon Commander's controlled settings from within the last category of the extension.
Because all the add-on does is change preferences, you can, at all times, reset the preferences by starting Pale Moon with the SHIFT key depressed, and selecting 'Reset preferences to Pale Moon defaults'. Of course this will also reset any other modified preferences you may have. Using the Reset feature in the add-on itself will have a similar result.

Use of this add-on is at all times at your own risk. I do not give warranty or guarantees, and it is provided 'as-is' although I've done my best to make sure it works as-intended.

You can [url=https://forum.palemoon.org/viewtopic.php?f=50&t=16081]go to the forum thread[/url] for this add-on to provide feedback.
[section]Documentation[/section]
The add-on currently has a basic manual in PDF format, applicable to the previous version 1.7. An update will be made as time permits, but most of the options are explained.

You can get the manual by [url=http://rm-eu.palemoon.org/tools/Pale%20Moon%20Commander_v1.7.0.pdf]clicking here[/url].

Site design and Branding © 2021 Moonchild Productions - All rights reserved
Any other content, brand names or logos are copyright or trademark to their respective owners.
Policies: Cookies - User Content - Privacy.

The Pale Moon Developer Site is powered by Project Selene 1.0.0a1.