Wiki Help Single Species

One major addition to the wiki coding done for the PBS is the handling of "single species" pages (short: SSPs). Historically, they have grown from extra pages which were created when there was so much information on certain favorite species that would have made the overview pages too big in times of slow internet connections - Galanthus nivalis would be a typical example from that era.

Over time, features were added including tagging of species and the automated building of tables and overview pages as well as a tag search - not everything being visible to the normal visitor. Transforming classic overview pages to SSP-style is a time consuming job, which is one of the reason both systems coexist on the wiki.

Features for the reader

Wiki readers can reach single species pages (if they exist for that species) both from following the linkified species names in the genus overview pages as well as from species image tables (also called Photo tables) for some of the bigger genera. On a tagged single species page, some of the tags are displayed in a "quick characteristics" section. Mirabilis jalapa shows many of the currently implemented features.

Another tool for the reader is the (experimental) Tag search, which will filter a basic name search using the well-known "*" and "?" wildcards, by the selected tags. Of course, this will only find species which have been tagged.

Features for the editor

The toolbar

Nobody can be expected to memorize all the commands and tags, so we've added a toolbar to the editor window:

The first drop down menu "Includes" offers structuring commands and utility functions, while the others provide with standardized tags to ensure the automated functions will recognize them. The tag menus may have sub-menus marked by bold text, which will open to the right of the menu.

Basic setup and naming conventions

SSPs are named using the "Genus_species" convention. Note the capital Genus, the separating underscore and the lower case species name.

The structure of a single species page looks like this:


[[#from]]
(:comment markup-single-species-page:)
room for tags, one per line


[Speciesname] Description of the species, including all images etc.

[[#to]]
----
->Return to the PBS wiki [[Genus|//Genus// index]]
->Return to the PBS wiki [[Photographs and Information]] page 

Lets have a look at the elements:

Optional sections

Parts of text enclosed in

[HideOnInclude]
[EndHideOnInclude]

will be hidden in a "show more" link when in included in a page. On a direct call to a SSP, those commands will ignored and the whole text will be displayed. Most editors remove these now unless in very excessive cases like in Tigridia Species M-Z / Tigridia pavonia

Tips for tagging

Many functions which take a tag as input also allow for logical combinations, using the following conventions:

Examples:

AND_Orange_Tuberous: All species with tubers and orange flowers
OR_Pink_Purple: All species with pink or purple flowers (or both)
White_NOT_Red_Pink_Purple_Blue_Yellow_Green_Brown_Pattern_Orange: only pure white flowered species with no other color forms

Building from Single Species Pages

Overview pages

IncludeSingleSpecies: species=Filter attributes= tags
will include the texts from the specified SSP pages into a normal overview page. * Filter can be used for ranges of species: Genus_* will include all species of that Genus, Genus_[c-f]* will only include species starting with c,d,e or f. The definition of attribute tags is optional and can be omitted.

IncludeSingleHybrids: species=Filter attributes= tags
will do the same for hybrid pages.

The system is also able to generate automatic page splits - "pagination" as it is often called in web editing. This behavior is completely managed by php link parameters, which can be added to an URL after an introducing "?" and with "&" as a delimiter between parameters. Example:

https://www.pacificbulbsociety.org/pbswiki/index.php/GladiolusRedI?SpecPerPage=8&SPSOffset=3

The site linked contains an include command for red or orange Gladiolus and would, without the link parameters, add all by the time of this text 36 species to one page. Adding SpecPerPage=8 splits the display into 5 pages (36/8 = 4.5), all containing the same header and footer and generating a link table to the subpages which names the first species on that sub page. The parameter SPSOffset=3 sends the reader to page Nr. 4 by skipping the first 3, starting with Gladiolus regineae. Please note that the offset is in pages, not in species, so GladiolusRedI?SpecPerpage=10&SPSOffset=3 will send you to the 4th site of a four site set, starting with Gladiolus stefaniae.

Tables

IncludeSpeciesTable: species=Filter attributes= tags
Creates a table of links according to filter and attribute tags. Single tags will be part of the table header description, complex tags will result in the keyword "filtered".

Example:

IncludeSpeciesTable: species=Kniphofia_* attributes=Yellow

will result in

Jump to: A B C F G H I L M N P R S T U

Yellow Kniphofia species
Kniphofia acraea Kniphofia baurii Kniphofia bruceae Kniphofia caulescens Kniphofia citrina Kniphofia fibrosa
Kniphofia galpinii Kniphofia hirsuta Kniphofia ichopensis Kniphofia linearifolia Kniphofia multiflora Kniphofia northiae
Kniphofia parviflora Kniphofia pauciflora Kniphofia praecox Kniphofia ritualis Kniphofia rooperi Kniphofia stricta
Kniphofia thodei Kniphofia thomsonii Kniphofia uvaria

likewise,

IncludeSpeciesTable: species=Kniphofia_* attributes=AND_Yellow_Red

will result in

Jump to: C H L P R

Filtered Kniphofia species
Kniphofia caulescens Kniphofia hirsuta Kniphofia linearifolia Kniphofia praecox Kniphofia ritualis Kniphofia rooperi

Image Tables
(also called Photo tables)

IncludeSpeciesImageTable: species=Filter attributes= tags
Will add a link table with species images, Filter and tag syntax as seen above. This will always use the first image of a species page. If no image is present, a pbs-logo will be displayed.

Example:

IncludeSpeciesImageTable: species=Tigridia_* attributes=Red

will result in

Jump to: F I O P

Red Tigridia species
Image not available [Shift+click to enlarge, Click to go to wiki entry]
T. flammea
Tigridia immaculata, Martin Bohnet [Shift+click to enlarge, Click to go to wiki entry]
T. immaculata
Image not available [Shift+click to enlarge, Click to go to wiki entry]
T. inusitata
Tigridia orthantha, Rob Hamilton [Shift+click to enlarge, Click to go to wiki entry]
T. orthantha
Tigridia pavonia, red color variant, Dennis Szeszko [Shift+click to enlarge, Click to go to wiki entry]
T. pavonia

Return to Wiki Changes

Page last modified on May 03, 2020, at 12:49 AM