www.itix.fr

Netlify CLI

npm install -g netlify-cli
netlify login
netlify link
netlify status

How to update this website

Create a new branch:

git checkout -b "$(date +%F)-update"

Create a new page (in english or in french):

hugo new content content/english/speaking/my-wonderful-event.md
hugo new content content/french/speaking/my-wonderful-event.md

English pages that are not translated are automatically published in the french site too (see the module.mounts section of config.yaml).

Check locally that your changes are OK:

hugo server -D &

Commit your changes:

git add .
git commit -m "$(date +%F) update"
git push --set-upstream origin "$(date +%F)-update"

Go on GitHub and create a new pull request based on this new branch.

Netlify will provision a dedicated instance for this new pull request. The URL will be posted in a comment in the PR.

Check that the modifications are OK.

Merge the pull request

Delete the remote branch.

Change back to the master branch locally:

git checkout master
git pull

Delete the old branch:

git branch -d "$(date +%F)-update"

Writing content

Standard Markdown is used, rendered by the render hooks in layouts/_markup.

Images (a standalone image is rendered as a figure, the title is the caption; JPEG, PNG and WebP images are served as WebP in several widths):

![Alternative text](image.png "Caption, *Markdown* allowed")
[![Tweet by @someone](tweet-someone.png)](https://twitter.com/someone/status/123)

Links to pages (with a flag when the target is in the other language; an empty text is replaced by the title of the page) and to attached files:

[](/blog/my-article.md)
[Some text](/blog/my-article.md#some-section)
[The slides](slides.pdf)

Code blocks, optionally with a file name or a title:

```yaml {filename="config.yaml" hl_lines="3-5"}
```
```sh {title="CoreOS"}
```

Shortcodes: youtube, embeddedVideo (videos attached to the page) and attachedFileLink (URL of an attached file, e.g. in a code block).

The old shortcodes (attachedFigure, screenshotOf, internalLink, highlightFile, highlightWithTitle, highlight, relref) can be converted with scripts/convert-shortcodes.py FILE.md.

Theme

The theme lives directly in this repository (layouts, assets, i18n and static directories). It was previously maintained as a git submodule in hugo-theme-itix, whose history has been merged in this repository.

It is derived from hugo-theme-diary and released under the MIT license (see LICENSE-theme).

How to change the Chroma style for syntax highlighting

hugo gen chromastyles --style=borland > assets/css/chroma.css