Background picture

Contribution Guide

  • 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:
  1. 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.
  2. Sign into our CMS (=content management system) at discretize.eu/cms and accept the creation of a fork.
  3. 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
CodeOutput
_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 backticksInline 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.
ParameterTypeDescriptionExampleOutput
namestringItem name<Item name="Tin of Fruitcake"/>
affix, typestringItem affix + type<Item affix="Berserker" type="Longbow"/>
sizeone of tiny, small, medium, large, bigIcon size<Item name="Delicious Rice Ball" size="large"/>
disableTextbooleanDisables the text<Item affix="Viper" type="Back Item" disableText/>
idnumberItem 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
.
ParameterTypeDescriptionExampleOutput
namestringSkill/trait name<Trait name="Pyromancers Training"/>
professionstringSkill/trait profession<Skill name="Stab" profession="Mesmer"/>
sizeone of tiny, small, medium, large, bigIcon size<Trait name="King of Fires" size="large"/>
disableTextbooleanDisables the text<Skill name="Epidemic" disableText/>
idnumberSkill/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.
UsageOutputReference
<Boon name="Might"/>MightList of boons
<Condition name="Burning"/>BurningList of conditions
<Control name="Stun"/>StunList of control effects
<Effect name="Stealth"/>StealthList of other effects
<Instability name="No Pain, No Gain"/>Mistlock Instability: No Pain, No GainList of mistlock instabilities
<Specialization name="Weaver"/>WeaverList of specializations

Other components
CodeOutput
<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
to
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
  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

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 1Column header 2
Cell 1Cell 2 with a
new line
Cell 3Cell 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
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