GitLab now enforces expiry dates on tokens that originally had no set expiration date. Those tokens were given an expiration date of one year later. Please review your personal access tokens, project access tokens, and group access tokens to ensure you are aware of upcoming expirations. Administrators of GitLab can find more information on how to identify and mitigate interruption in our documentation.
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**Table of Contents***generated with [DocToc](https://github.com/thlorenz/doctoc)*
-[GitLab CI](#gitlab-ci)
-[Building locally](#building-locally)
-[GitLab User or Group Pages](#gitlab-user-or-group-pages)
-[Did you fork this project?](#did-you-fork-this-project)
-[Troubleshooting](#troubleshooting)
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
## GitLab CI
This project's static Pages are built by [GitLab CI][ci], following the steps
defined in [`.gitlab-ci.yml`](.gitlab-ci.yml).
Ceci est un exemple de site web construit grâce à [Hugo](https://gohugo.io) et à [GitLab Pages](https://about.gitlab.com/features/pages/).
## Building locally
L'adresse du site web construit est la suivante : https://misha.pages.unistra.fr/hugo/ .
To work locally with this project, you'll have to follow the steps below:
La documentation officielle d'Hugo se trouve [à cette adresse](https://gohugo.io/documentation/).
Vous pouvez en apprendre davantage sur les GitLab Pages [sur cette page](https://pages.gitlab.io) ; la documentation officielle se trouve [à cette adresse](https://docs.gitlab.com/ce/user/project/pages/).
1. Fork, clone or download this project
1.[Install][] Hugo
1. Preview your project: `hugo server`
1. Add content
1. Generate the website: `hugo` (optional)
Read more at Hugo's [documentation][].
### Preview your site
If you clone or download this project to your local computer and run `hugo server`,
your site can be accessed under `localhost:1313/hugo/`.
The theme used is adapted from http://themes.gohugo.io/beautifulhugo/.
## GitLab User or Group Pages
---
To use this project as your user/group website, you will need one additional
step: just rename your project to `namespace.gitlab.io`, where `namespace` is
your `username` or `groupname`. This can be done by navigating to your
project's **Settings**.
### Créer votre propre site
You'll need to configure your site too: change this line
in your `config.toml`, from `"https://pages.gitlab.io/hugo/"` to `baseurl = "https://namespace.gitlab.io"`.
Proceed equally if you are using a [custom domain][post]: `baseurl = "http(s)://example.com"`.
Pour créer très simplement votre propre site web, suivez les étapes suivantes :
Read more about [user/group Pages][userpages] and [project Pages][projpages].
1. Faites un clone de ce dépôt en un nouveau dépôt vous appartenant, que vous nommerez par exemple `hugo`, ou le nom de votre projet.
Pour cela, cliquez sur le bouton « _fork_ » en haut à droite de cette page, ou sur [ce lien](https://git.unistra.fr/misha/hugo/-/forks/new).
2.**Ne lisez pas la suite de ce texte ici !** Allez la lire sur votre dépôt à vous.
3. Modifiez la première ligne du fichier `config.yaml`.
Corrigez l'adresse web qui s'y trouve (originellement `https://misha.pages.unistra.fr/hugo/`) en fonction de ce que vous avez indiqué à l'étape 1.
Par exemple, si vous vous appelez `moi` et avez nommé votre dépôt `hugo`, il vous faut indiquer `https://moi.pages.unistra.fr/hugo/`.
4. C'est tout ! Votre site est en ligne à l'adresse que vous venez de renseigner ! Au cas où, elle est indiquée aussi sur [cette page](../../../pages).
## Did you fork this project?
---
If you forked this project for your own use, please go to your project's
**Settings** and remove the forking relationship, which won't be necessary
unless you want to contribute back to the upstream project.
### Aller plus loin
## Troubleshooting
* Le fichier `content/_index.md` correspond à la page d'accueil de votre site.
Comme tous les fichiers se terminant par `.md`, c'est un [fichier Markdown](https://docs.framasoft.org/fr/grav/markdown.html).
* Chaque fichier du répertoire `content/page` correspond à une page « statique » de votre site.
* Chaque fichier du répertoire `content/post` correspond à un article de blog de votre site.
* Le [fichier YAML](https://fr.wikipedia.org/wiki/YAML)`config.yaml` contient les paramètres de configuration de votre site.
* Le fichier `README.md` correspond à ce que vous êtes en train de lire.
1. CSS is missing! That means two things:
---
Either that you have wrongly set up the CSS URL in your templates, or
your static generator has a configuration option that needs to be explicitly
set in order to serve static assets under a relative URL.
Régis Witz authored
