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="https://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
- Liquid syntax guide. Liquid allows to automate the creation of HTML code parts.
Markdown
Links
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:

Centered:
<div style="text-align:center" markdown="1">

</div>
To control image size:
{:height="40%" width="40%"}
To add blank space above an image:
<div style="text-align:center" markdown="1">
{:height="40%" width="40%" style="padding-top:20px"}
</div>
Image with link:
[{:height="15%" width="15%"}](https://en.wikipedia.org/wiki/Tux_(mascot))
With caption, figure size scales with page width:

{% 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 one
- 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)
- 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 one
- List item two
- List item three
- 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 1Address 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…</q> –Steve Ballmer
Variable Tag
This allows you to denote variables.
This allows you to denote <var>variables</var>.