Contribution Guide

Tooltip Language

October 3, 2021
20 min to read

Contributing to the Discretize website has never been easier before! All you need to get started is a Github account, a little bit of brain power, and the ability to read.

Get started:

Create a free Github account at github.com. The sign-up is free, does not require any personal information except for an e-mail address and should only take 2 minutes.
Sign into our CMS (=content management system) at discretize.eu/cms and accept the creation of a fork.
Navigate to any site you want to edit. It is recommended to disable "Sync scrolling" on the very right side of the screen for an optimal experience. Make your changes, and click "Publish" to save your changes. Please be aware that clicking "Publish" does not actually publish your changes but saves them. After a review your changes will appear first on staging.discretize.eu , and later on the main website.

The CMS requires access to your full account because it acts on your behalf (oauth). This is a static page, there are no server components and no outgoing requests are made that could possibly steal your oauth token. Your login never leaves your PC. More information.
As an alternative you can copy-paste the guide files into the editor.

Important information:

Adding new sites from the CMS is not possible. Please ask on the discord server for help. An admin will create the page for you and it will appear in the cms.
In case there are elements, that are not rendering as intended on the staging site, please add an enter before and after the component. That should fix all rendering issues given the component is correctly set up.
Pictures are not rendering in the cms!

Documentation CMS:

Equipment
- To create the gear display it is recommended to study an existing example first. Copy-paste it, and replace the gear sections as follows.
- Go to the Gear Optimizer . Insert the build you want to get the equipment for (including the correct Agony Resistance), hit calculate and click the button at the bottom of the screen to copy the equipment.

Markdown Components

Inline components

Inline components can be used as standalone elements or within block components like paragraphs or tables.

Standard markdown components

Code	Output
`_Italic_` or `_Italic_`	Italic
`Bold` or `Bold`	Bold
`~~Strikethrough~~`	~~Strikethrough~~
`[External Link](http://a.com)`	External Link
`[Internal Link](/builds)`	Internal Link
`Inline code` with backticks	`Inline code` with backticks

Guild Wars 2 components

Most of our Gw2 components are created with the help of the official game API. In general it should not be necessary to research IDs, as we resolve them automatically with the help of other identifiers like name or affix.

Our current mapping can be queried using the ID Helper tool. As we keep its size as small as possible, some special items might not be present - in those cases you can still specify a fixed ID. You can find a specific ID by searching for the desired Item/Skill/whatever in the wiki and then clicking on "API".

Items

Items can be created by specifying either a name or a type and affix combination. If there are multiple results for the query, the one with the lowest id will be taken.

Special characters like ', spaces and capital letters are normalized for the mapping.

Parameter	Type	Description	Example
name	`string`	Item name	`<Item name="Tin of Fruitcake"/>`
affix, type	`string`	Item affix + type	`<Item affix="Berserker" type="Longbow"/>`
size	one of `tiny, small, medium, large, big`	Icon size	`<Item name="Delicious Rice Ball" size="large"/>`
disableText	`boolean`	Disables the text	`<Item affix="Viper" type="Back Item" disableText/>`
id	`number`	Item id	`<Item id="49940"/>`

Skills and traits

Skills and traits are resolved using a name and a profession (optional). The profession theme color is automatically applied to the link, even if you don't specify one.

Again - special characters, case sensitivity and spaces don't matter. <Skill name="TotHe LiMiT!"/> will be resolved as

Parameter	Type	Description	Example
name	`string`	Skill/trait name	`<Trait name="Pyromancers Training"/>`
profession	`string`	Skill/trait profession	`<Skill name="Stab" profession="Mesmer"/>`
size	one of `tiny, small, medium, large, big`	Icon size	`<Trait name="King of Fires" size="large"/>`
disableText	`boolean`	Disables the text	`<Skill name="Epidemic" disableText/>`
id	`number`	Skill/trait id	`<Skill id="13113"/>`

Other Gw2 components

Some other game-related components can be created with a simple name identifier. Check the reference column for the proper spelling.

Note that you can use the size and disableText parameters with those as well.

Usage	Output	Reference
`<Boon name="Might"/>`	Might	List of boons
`<Condition name="Burning"/>`	Burning	List of conditions
`<Control name="Stun"/>`	Stun	List of control effects
`<Effect name="Stealth"/>`	Stealth	List of other effects
`<Instability name="No Pain, No Gain"/>`	Mistlock Instability: No Pain, No Gain	List of mistlock instabilities
`<Specialization name="Weaver"/>`	Weaver	List of specializations

Other components

Code	Output
`<Label>Example label</Label>`	Example label
`<BuildLink build="Condi Firebrand" specialization="Firebrand"/>`	Condi Firebrand

Compositions

Shows a composition with tooltip and link to the meta page. Predefined compositions can be selected starting with an underscore. The size parameter is optional.

Available pregenerated: _Rainbow, _Rainbearbow, _RGB

<Composition name="MAMA Specialized" composition="Soulbeast,Soulbeast,Dragonhunter,Berserker,Renegade" roles="DPS,DPS(frost spirit),Quickness/DPS,CC/Banner/DPS,Alacrity/CC/DPS" size="small"/>
<Composition name="_Rainbow"/>

MAMASpecialized Rainbow

Boss Header component

Use the option hideRotation to hide the rotation text divider underneath the header.

<Boss name="mama" video="rM2uB5yprLc" foodId="43360" utilityId="50082" healId="14401" utility1Id="29941" utility2="outrage" utility3="bullscharge" eliteId="30343" weapon1MainAffix="Berserker" weapon1MainType="axe" weapon1MainSigil1="force" weapon1MainInfusion1Id="37131" weapon1OffAffix="berserker" weapon1OffType="axe"  weapon1OffSigil="impact" weapon1OffInfusionId="37131" weapon2OffAffix="Berserker" weapon2OffType="mace" weapon2OffSigil="paralyzation" weapon2OffInfusionId="37131" >

- Change <Skill name="bullscharge"/> to <Skill name="throwbolas"/> if you dont need the additional CC
- Play <Trait name="Smashbrawler"/>!

</Boss>

MAMA 5,200,519 HP

$Picture of fractal boss M.A.M.A.$

by undefined

Weapons

Berserker
1x
Berserker
1x

Empty
Berserker
1x

Skills

Heal

Utilities

Elite

Legends:

Notes

- Change

if you dont need the additional CC - Play

Skill usage

Block components

Block elements always take up the entire width of their parent element.

Paragraphs

Plain text is automatically wrapped in a paragraph element.
Use four spaces to force a new line.

Inserting a blank line between passages results in two distinct paragraphs.

Plain text is automatically wrapped in a paragraph element. Use four spaces to force a new line.

Inserting a blank line between passages results in two distinct paragraphs.

Headings


# Heading 1

## Heading 2

### Heading 3

#### Heading 4

##### Heading 5

###### Heading 6

Heading 1

Heading 2

Heading 3

Heading 4

Heading 5

Heading 6

Lists

Unordered lists

- Item one
- Item two
  - Nested item one
  - Nested item two
- Item three with a new line using four spaces
- Item four

Note that using - instead of the \* character works as well.

Item one
Item two
- Nested item one
- Nested item two
Item three with a new line using four spaces
Item four

Ordered list

1. Item one
2. Item two
   1. Nested ordered items need to be indexed with **three** spaces
   2. Nested item two
3. Item three with a new line
   using four spaces
4. Item four

Item one
Item two
1. Nested ordered items need to be indexed with three spaces
2. Nested item two
Item three with a new line using four spaces
Item four

Tables


| Column header 1 | Column header 2            |
| --------------- | -------------------------- |
| Cell 1          | Cell 2 with a<br/>new line |
| Cell 3          | Cell 4                     |

If you want to create a head-less table, simply leave the column header cells blank.

Column header 1	Column header 2
Cell 1	Cell 2 with a new line
Cell 3	Cell 4

Dividers

---

<Divider text="Divider text"/>

Divider text

Blockquote

> Lorem ipsum is placeholder text commonly used in the graphic, print, and publishing industries for previewing layouts and visual mockups.

Lorem ipsum is placeholder text commonly used in the graphic, print, and publishing industries for previewing layouts and visual mockups.

Grids

Our grid system is based on a 12-column grid layout. You can use <Grid> for the container and <GridItem> for the item components. There are five grid breakpoints:

xs, extra-small: 0px or larger
sm, small: 600px or larger
md, medium: 960px or larger
lg, large: 1280px or larger
xl, extra-large: 1920px or larger

You can define multiple widths per column, causing the layout to change at the defined breakpoint. If not specified otherwise, a <GridItem> will have the attributes xs="12" and sm="6" by default, causing the item to be 100% wide at mobile resolutions and 50% wide above.

<Grid>
  <GridItem>
    Left content
  </GridItem>

  <GridItem>
    Right content
  </GridItem>

  <GridItem>
    This item will be placed in a new row
  </GridItem>
</Grid>

Left content

Right content

This item will be placed in a new row

<Grid>
  <GridItem sm="4">
    `sm="4"`
  </GridItem>

  <GridItem sm="6">
    `sm="6"`
  </GridItem>

  <GridItem sm="2">
    `sm="2"`
  </GridItem>

  <GridItem sm="11">
    `sm="11"`
  </GridItem>
</Grid>

`sm="4"`

`sm="6"`

`sm="2"`

`sm="11"`

Cards

<Card title="Example card title">
Example card content
</Card>

Example card title

Example card content

Tabs

<Tabs>
<Tab title="Tab 1">
Tab content 1
</Tab>

<Tab title="Tab 2">
Tab content 2
</Tab>

<Tab title="Tab 3">
Tab content 3
</Tab>
</Tabs>

You can also use the specialization property instead of title to create themed tabs.

Tab content 1

Tab content 2

Tab content 3

Messages

<Warning>
This is an important message.
</Warning>

This is an important message.

<Information>
This is an important message.
</Information>

This is an information message.

Images

<MDImage src="images/hero_sunqua2.jpg" caption="Example image caption"/>

Image paths need to be absolute to the actual markdown file within our GitHub repository. Sadly this does not work in the editor.

Image images/hero_sunqua2.jpg not found

Although the above syntax is the preferred variant, you can use the standard Markdown image syntax to preview images in editor context or to embed external images. Keep in mind that images are not minified this way!

![Mythwright Gambit](https://cdn.discordapp.com/attachments/143473968639246345/489469167851012136/MythwrightGambit_02.png)

Mythwright Gambit

Videos

<Video title="Example video title" youtube="xcJtL7QggTI" timestamp={12} />

Example video title

Build guide components

Writing build summaries has never been easier thanks to our automatic ID resolving. Note that you suffix Id behind parameters if you want to use a fixed ID, like glovesRuneId="76491".

<Weapons weapon1MainType="Axe" weapon1MainAffix="Assassin" weapon1MainSigil1="Force" weapon1OffType="Dagger" weapon1OffAffix="Seraph" weapon1OffSigil="Impact" weapon2MainType="Scepter" weapon2MainAffix="Berserker" weapon2MainSigil1="Severance" weapon2OffType="Mace" weapon2OffAffix="Viper" weapon2OffSigil="Paralyzation"/>

Use the option "unembossed" to remove the card.

Assassin
Seraph

Berserker
Viper

<Traits traits1="Strength" traits1Selected="Peak Performance,Body Blow,Berserkers Power" traits2="Tactics" traits2Selected="Leg Specialist,Empower Allies,Phalanx Strength" traits3="Discipline" traits3Selected="Warriors Sprint,Doubled Standards,Axe Mastery"/>

Use the option "unembossed" to remove the card.

Traits

Strength
Tactics
Discipline

<Skills heal="Water Spirit" utility1="Frost Spirit" utility2="Vulture Stance" utility3="Signet of the Wild" elite="One Wolf Pack"/>

Use the option "unembossed" to remove the card.

Heal

Utilities

Elite

Contribution Guide

Get started:

Important information:

Documentation CMS:

Inline components

Standard markdown components

Guild Wars 2 components

Items

Skills and traits

Other Gw2 components

Other components

Compositions

Boss Header component

MAMA 5,200,519 HP

Legends:

Block components

Paragraphs

Headings

Heading 1

Heading 2

Heading 3

Heading 4

Heading 5

Heading 6

Lists

Unordered lists

Ordered list

Tables

Dividers

Blockquote

Grids

Cards

Tabs

Messages

Images

Videos

Example video title

Build guide components

Strength

Tactics

Discipline

About Discretize

Contribute

Legal