Custom Markup

Cards / Decks / Settings

<card ></card><deck></deck><setting></setting>

Attributes

Name Description Example
format Format of the card - "mini". "monster", "list". See below for details.
css
cssraw
type
name
ref
cardsperrow Controls the layout of the table containing the cards. Meaningless on Card tags.
rowsperpage Controls the layout of the table containing the cards. Meaningless on Card tags.
sort Field name to sort a list of cards by.
list A comma separated dist of fields to display when format="list". The list can contain any Property names plus 'type' for the card's type and 'ref' for the card's reference.
search Provides additional parameters when creating an automatic setting list. See below.
points Totals the number of character points used in a deck. See below.
scale % size the card image compared to standard. E.g. scale="200" is twice the size, scale="50" is half the size. Note the difference between format, which controls the layout and basic size of the card and scale which magnifies or shrinks the card's size. When applied to a deck or setting tag, scale is applied to all the cards in the deck or setting.

Format

There are four different formats that cards can be displayed in. These are 'mini', 'monster', 'list' and the default.

The default format, which is used if no format is specified, displayed the card ready to be printed. For most cards this is 85mm x 54mm. In 'mini' format, the card is shrunk and the card's summary is not included on the card.

'Monster' format is used for creating monster stat sheets. Like the 'mini' format it leaves of the summary property and is smaller than a default card. However it has an extra 'Usage' property on the right to record if the card is in a pool or stack.

The 'list' format does what is says, displaying the card as a list. Unlike the other formats, in list mode, the card's properties are displayed as text, not as a graphic. Only in the 'list' format do the 'sort' and 'list' properties have any meaning.

The 'sort' property defines a card property which is used to sort the resulting list. e.g. format="list" sort="title" will list all the cards in the deck or setting in order of their title.

By default, the 'list' format will display the cards title, type, keywords, summary, dice, character points and reference. This can be changed using the the 'list' attribute. e.g. format="list" list="title, ref, characterpoints" will just display the title, reference and character points value of the card.

If the format attribute is specified to a deck, it is applied to all the cards in that deck. This can be overridden for a specific card by specify the format attribute on a card in a deck. Likewise, a format attribute to a setting will apply to all the decks and cards in that setting except where a format is specified on a deck or card included in the setting.

Automatic Settings

A setting can automatically include all the cards in a specified name space. e.g all the cards in the :open:cards area. Sub-areas are not included so cards in :open:cards are included but anything in :open:cards:outbreak or :open:cards:quantum_flux are excluded.

To create an automatic setting list, use a wildcard in the ref attribute. e.g. ref=":open:cards:*" or ref="open:cards:outbreak:*". The system will find all the cards in the namespace and display them according to the format attribute.

The automatic list can be refined further by specifying the search attribute. e.g. ref=":open:cards:*" search="life" will only list cards in the :open:cards namespace that include the word life. This field uses the Dokuwiki search format (see search).

Break Text

Unformatted text can be placed in Decks to split the cards. This is handy on monster decks where it is useful to divide static and dynamic cards into two sections. This is not recommend in decks that will be used to create cards for players as the break text will disturb the layout.

Example:

<deck name="My Deck">

<card ref="some card" />

<card ref="some other card" />

MY BREAK TEXT

<card ref="Another card" />

</deck>

Points

In Deck tags a points attribute can be set:

<deck points="yes" >

In the deck's title row, alongside the deck's name, the character points total of the cards in the deck will be displayed.

Note that the value of the points attribute is not important. If it has a value, the character points total added to the name.

Property Tag

<property name="property name">Property Value Here</property><nowiki> The Property tag is exclusively used inside the <nowiki><card></card> tags to set the values for a card. It only has one attributed, 'name', which must be specified and controls which part of the card it defines. The text between the property open and close tags is what appears on the card.

Property Name Description
title The card's title.
summary Short descriptive text.
keywords The keywords that appear below the title.
dice The dice value of the card, e.g. 1d6+1
characterpoints The character point (CP) value of the card.
charactername The name of the character or deck the card belongs to.
effect The effect keywords, only on effect cards.
usage Only displayed when the card is in monster format. Used to identify whether a card is in the monster's pool or stack at the start of combat.

PDF Tag

<pdf> </pdf>

Attributes

Name Description Example
pdfstyle Can be overridden via the URL. See below for options.
marginleft
marginright
margintop
marginbottom
marginheader
marginfooter
marginmirror
defaultfontsize
title Name of the Document.
author Sets the writer's name for the PDF meta-information.
css
cssraw
footeron Specify a different style footer for those page types with footers. Valid options are: "alt" and "blank" for no footers.
footeroff Specify a different, no blank footer for those page types that normally do not have footers. Valid options are: "standard" and "alt"
PDF Style Left Margin Right Margin Top Margin Bottom Margin Mirror Margin
A5 A5 (the default) 10 10 6 10 No
A5S A5 single sided, large left hand margin for binding. 15 5 6 10 No
A5D A5 double sided. As per A5S except the margins are mirrored to ensure suitable margin for binding on both sides. 15 5 6 10 Yes
A52 Format for two A5 pages on a single A4 page 7 11 6 10 Yes
A4 A4 page with no margins. 0 0 0 0 No
A4S A4 single sided. 10 10 6 10 No
A4SL A4 single sided - Landscape 10 10 6 10 No
C32011 A4, formatted for 6d6's card cutter and pre-printed business cards Avery C32011 15 5 14 0 No

Include Tags

<chapter /> <subchapter /> <flypage /> <blurb />

All four of these tags will pull the contents from the 'ref' page and include it in the pdf. The differences between the four relate to formatting and how they behave on screen and in a PDF.

Chapter

On screen it acts as a link and list header to the subchapters after it. In the PDF, it always starts on a new page.

Subchapter

These are displayed on screen as a link and sub-entry to a chapter. In the pdf, the page's content are included with no additional formatting.

Flypage

A flypage is the copyright page or similar page at the front of the book. On screen this is display as a link, positioned left of the main list of chapters and sub-chapters. In the PDF, it appears on a new page and without any page footers.

Blurb

Brief explanatory text that does not appear in the PDF. On screen, the 'ref' page is pulled in an displayed to the left of the table of contents.

Attributes

All four include tags have the same parameters.

Name Description Example
ref Page to include / link to.
CSS
CSSRaw
rev Which revision of the page to include.

Cover Tag

<cover />

Attributes

Name Description Example
ref Large, top quality image to be used in PDFs.
medium 353 pixels wide by 500 pixels high image, used on screen.
small 200 pixels high image used for icons.
You could leave a comment if you were logged in.
open/custom_markup.txt · Last modified: 2012/03/08 12:10 by tregenza
Recent changes RSS feed

The 6d6 RPG tabletop store is owned and operated by Chris Tregenza. Who also owns and runs Myomancy, a site about ADD / ADHD medication, Autism and Dyslexia Treatments and also site called Poosk. Chris also provides copy-writing, web design SEO advice to sites like Dingles' Games pathfinder rpg resources.