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) atdiscretize.eu/cms.
  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.
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.
  • The editor is slightly laggy at the moment.
  • 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:
  • Sections
    • Sections are rendered in the order they are created.
    • If the title is set, a divider with the title as text is rendered.
  • 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"/>Tin of Fruitcake
affix, typestringItem affix + type<Item affix="Berserker" type="Longbow"/>Zojja's Greatbow
sizeone of tiny, small, medium, large, bigIcon size<Item name="Delicious Rice Ball" size="large"/>Delicious Rice Ball
disableTextbooleanDisables the text<Item affix="Viper" type="Back Item" disableText/>Ad Infinitum
idnumberItem id<Item id="49940"/>Executioner Axe Toy

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 "To the Limit!".

ParameterTypeDescriptionExampleOutput
namestringSkill/trait name<Trait name="Pyromancers Training"/>Pyromancer's Training
professionstringSkill/trait profession<Skill name="Stab" profession="Mesmer"/>Stab
sizeone of tiny, small, medium, large, bigIcon size<Trait name="King of Fires" size="large"/>King of Fires
disableTextbooleanDisables the text<Skill name="Epidemic" disableText/>
idnumberSkill/trait id<Skill id="13113"/>Black Powder

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

    force

  • berserker

    impact

  • Empty
  • Berserker

    paralyzation

Skills:
Heal
Utilities
Elite
Legends:
Notes
- Change Bull's Charge to Throw Bolas if you dont need the additional CC - Play Smash Brawler!
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="fractals/sunqua-peak/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.

Example image caption
Example image caption
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

    Force

  • Seraph

    Impact

  • Berserker

    Severance

  • Viper

    Paralyzation

<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