Skip to content
This repository has been archived by the owner on Mar 8, 2021. It is now read-only.

Contributing to the Documentation

modxuser edited this page Feb 22, 2017 · 14 revisions

If you would like to add to the general documentation, Extras (Snippets + Modules) documentation and tutorials then please use the following as a guide:

Headlines

In general if you want to create a page or add information to an existing page, headlines need to be nested as:

  • H2 - Main section heading
  • H3 - Sub-heading

Note: H1 is declared by the system and shouldn't be used within the page content

Sectioning

"Section"s and "Article"s are not required and as such shouldn't be used

Tables

Tables when used should use the following set-up:

<table>
  <thead>
    <tr>
      <th></th>
      <th></th>
      <th></th>
      <th></th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td></td>
      <td></td>
      <td></td>
      <td></td>
    </tr>
  </tbody>
</table>

If headers are not used, the following applies:

<table>
  <tbody>
    <tr>
      <td></td>
      <td></td>
      <td></td>
      <td></td>
    </tr>
  </tbody>
</table>

Code / Code Blocks

Code can be displayed in two ways: using HTML "pre" or "code"

In general, "code" is used inline whereas "pre" is used for blocks of code.

When creating snippet calls, php code, css etc. the code elements need to be changed to their entity numbers. This is to ensure that Evo doesn't run the code that is on the page. If for example a call is made to Ditto, to demonstrate a call and Ditto is installed, Evo will run the call and not render the code, it will where possible render the output to the page. This is why certain elements need to be changed.

! &#33; ` &#96;
@ &#64; = &#61;
+ &#43; ~ &#126;
[ &#91; ] &#93;
{ &#123; } &#125;
( &#40; ) &#41;
Clone this wiki locally