General info

Locations of key files/directories

  • Color: change \$gray and \$primary-color in _sass/_variables.scss. The current primary color is #296dab; the original was #7a8288.
  • Basic config options: _config.yml
  • Top navigation bar config: _data/navigation.yml, _includes/masthead.html
  • Sidebar: _includes/author-profile.html
  • Footer: _includes/footer.html and _includes/footer/custom.html
  • Single pages: _pages/
  • Collections of pages are .md or .html files in:
    • _meetings/
    • _posts/
    • _projects/
    • _publications/
    • _talks/
  • Static files (like PDFs): /files/
  • Maps: What you need is in the /map/ directory. Prepare a CSV file (columns: label,latitude,longitude,[icon style]). Then run python map.py mapfile.csv center_lat center_lon zoom_level (e.g., python map.py TEAMx_map.csv 45.23 11.4 6). This will generate mapfile.html and mapfile.kml. Then include mapfile.html in your Markdown page using an iframe, e.g.: <iframe src="http://www.teamx-programme.org/map/TEAMx_map.html" width="100%" height="620px" style="border:none;"></iframe>

Tips and hints

  • Name a file “.md” to have it render in markdown, name it “.html” to render in HTML.

Resources

Markdown

This is an example of a link. This is another example: http://github.com.

This is an example of a [link](http://github.com "Github").
This is another example: <http://github.com>.

Line breaks

First line ending with double blank.
Second line.

First line ending with double blank.  
Second line.

Useful tags

Strike Tag

This tag will let you strikeout text.

This tag will let you <strike>strikeout text</strike>.

Emphasize Tag

The emphasize tag should italicize text.

The emphasize tag should _italicize_ text.

Insert Tag

This tag should denote inserted text.

This tag should denote <ins>inserted</ins> text.

Strong Tag

This tag shows bold text.

This tag shows **bold text**.

Subscript Tag

H2O.

H<sub>2</sub>O.

Superscript Tag

E = MC2.

E = MC<sup>2</sup>.

Comments

In Kramdown (one flavour of Markdown):

{::comment}
THIS IS A COMMENT
{:/comment}

Headers

Header three

Header four

Header five
Header six
### Header three

#### Header four

##### Header five

###### Header six

Use of colors in headers

Coloured part of header

### <span style="color:red">Coloured part</span> of header

Blockquotes

Single line blockquote:

Quotes are cool.

> Quotes are cool.

Paragraph quote (can also be coloured):

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

<blockquote style="padding: 10px; background-color: #FFD700;">
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p>
</blockquote>

Pictures

Aligned left:

TEAMx

![TEAMx](http://www.teamx-programme.org/images/logo_TEAMx.png)

Centered:

TEAMx

<div style="text-align:center" markdown="1">
![TEAMx](http://www.teamx-programme.org/images/logo_TEAMx.png)
</div>

To control image size:

TEAMx

![TEAMx](http://www.teamx-programme.org/images/logo_TEAMx.png){:height="40%" width="40%"}

To add blank space above an image:

TEAMx

<div style="text-align:center" markdown="1">
![TEAMx](http://www.teamx-programme.org/images/logo_GEWEX.png){:height="40%" width="40%" style="padding-top:20px"}
</div>

Image with link:

alt text

[![alt text](https://upload.wikimedia.org/wikipedia/commons/thumb/3/35/Tux.svg/500px-Tux.svg.png){:height="15%" width="15%"}](https://en.wikipedia.org/wiki/Tux_(mascot))

With caption, figure size scales with page width:

TEAMx logo
TEAMx logo

{% include image.html url="logo_TEAMx.png" description="TEAMx logo" %}

Tables

Table 1

Entry Item  
John Doe 2016 Description of the item in the list
Jane Doe 2019 Description of the item in the list
Doe Doe 2022 Description of the item in the list
| Entry            | Item   |                                                              |
| --------         | ------ | ------------------------------------------------------------ |
| [John Doe](#)    | 2016   | Description of the item in the list                          |
| [Jane Doe](#)    | 2019   | Description of the item in the list                          |
| [Doe Doe](#)     | 2022   | Description of the item in the list                          |

Table 2

Header1 Header2 Header3
cell1 cell2 cell3
cell4 cell5 cell6
cell1 cell2 cell3
cell4 cell5 cell6
Foot1 Foot2 Foot3
| Header1 | Header2 | Header3 |
|:--------|:-------:|--------:|
| cell1   | cell2   | cell3   |
| cell4   | cell5   | cell6   |
|-----------------------------|
| cell1   | cell2   | cell3   |
| cell4   | cell5   | cell6   |
|=============================|
| Foot1   | Foot2   | Foot3   |

Definition Lists

Item 1
Definition 1.
Item 2
Definition 2.
Item 3
Definition 3.
Item 1
:   Definition 1.

Item 2
:   Definition 2.

Item 3
:   Definition 3.

Unordered Lists (Nested)

  • List item one
    • List item one
      • List item one
      • List item two
      • List item three
      • List item four
    • List item two
    • List item three
    • List item four
  • List item two
  • List item three
  • List item four
  * List item one 
      * List item one 
          * List item one
          * List item two
          * List item three
          * List item four
      * List item two
      * List item three
      * List item four
  * List item two
  * List item three
  * List item four

Ordered List (Nested)

  1. List item one
    1. List item one
      1. List item one
      2. List item two
      3. List item three
      4. List item four
    2. List item two
    3. List item three
    4. List item four
  2. List item two
  3. List item three
  4. List item four
  1. List item one 
      1. List item one 
          1. List item one
          2. List item two
          3. List item three
          4. List item four
      2. List item two
      3. List item three
      4. List item four
  2. List item two
  3. List item three
  4. List item four

Buttons

Make any link standout more when applying the .btn class.

Make any link standout more when applying the `.btn` class.

Notices

Watch out! You can also add notices by appending {: .notice} to a paragraph.

**Watch out!** You can also add notices by appending `{: .notice}` to a paragraph.
{: .notice}

Other HTML Tags

Address Tag

Address line 1
Address line 2
Address line 3
<address>
  Address line 1<br /> Address line 2<br /> Address line 3
</address>

Abbreviation Tag

The abbreviation CSS stands for “Cascading Style Sheets”.

*[CSS]: Cascading Style Sheets

Cite Tag

“Code is poetry.” —Automattic

"Code is poetry." ---<cite>Automattic</cite>

Code Tag

You will learn later on in these tests that word-wrap: break-word; will be your best friend.

You will learn later on in these tests that `word-wrap: break-word;` will be your best friend.

Keyboard Tag

This scarcely known tag emulates keyboard text, which is usually styled like the <code> tag.

This scarcely known tag emulates <kbd>keyboard text</kbd>, which is usually styled like the `<code>` tag.

Preformatted Tag

This tag styles large blocks of code.

.post-title {
  margin: 0 0 5px;
  font-weight: bold;
  font-size: 38px;
  line-height: 1.2;
  and here's a line of some really, really, really, really long text, just to see how the PRE tag handles it and to find out how it overflows;
}
<pre>
.post-title {
  margin: 0 0 5px;
  font-weight: bold;
  font-size: 38px;
  line-height: 1.2;
  and here's a line of some really, really, really, really long text, just to see how the PRE tag handles it and to find out how it overflows;
}
</pre>

Quote Tag

Developers, developers, developers… –Steve Ballmer

<q>Developers, developers, developers&#8230;</q> &#8211;Steve Ballmer

Variable Tag

This allows you to denote variables.

This allows you to denote <var>variables</var>.