gregandev/hugo-site
gregandev/hugo-site
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

maj readme

Browse Source
This commit is contained in:
greglebreton 2021-07-24 11:37:02 +02:00
parent ae79133b69
commit d0bcf0c70a
1 changed files with 25 additions and 48 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

73
README.md
View File

@ -1,64 +1,41 @@
# HUGO SITE
![Build Status](https://gitlab.com/pages/hugo/badges/master/build.svg) Hugo est un framework open source pour générer facilement des sites webs (https://gohugo.io/)
---
Example [Hugo] website using GitLab Pages. ### HUGO INSTALL
Learn more about GitLab Pages at https://pages.gitlab.io and the official Voir sur le site https://gohugo.io/ selon vtre OS et distribution
documentation https://docs.gitlab.com/ce/user/project/pages/.
--- ### UTILISATION
## GitLab CI ```bash
hugo new site monsite
```
This project's static Pages are built by [GitLab CI][ci], following the steps #### Installer un thème:
defined in [`.gitlab-ci.yml`](.gitlab-ci.yml).
## Building locally ```bash
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
echo theme = \"ananke\" >> config.toml
```
To work locally with this project, you'll have to follow the steps below: #### Ajouter un nouveau post:
1. Fork, clone or download this project ```bash
1. [Install][] Hugo hugo new posts/my-first-post.md
1. Preview your project: `hugo server` ```
1. Add content
1. Generate the website: `hugo` (optional)
Read more at Hugo's [documentation][].
### Preview your site #### lancer le serveur en local:
If you clone or download this project to your local computer and run `hugo server`, ```bash
your site can be accessed under `localhost:1313/hugo/`. hugo server -D
```
The theme used is adapted from http://themes.gohugo.io/beautifulhugo/. Visiter http://localhost:1313
## GitLab User or Group Pages #### Déployer via Docker:
To use this project as your user/group website, you will need one additional Visiter la branch docker
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**.
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"`.
Read more about [user/group Pages][userpages] and [project Pages][projpages].
## Troubleshooting
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.
[ci]: https://about.gitlab.com/gitlab-ci/
[hugo]: https://gohugo.io
[install]: https://gohugo.io/overview/installing/
[documentation]: https://gohugo.io/overview/introduction/
[userpages]: http://doc.gitlab.com/ee/pages/README.html#user-or-group-pages
[projpages]: http://doc.gitlab.com/ee/pages/README.html#project-pages
[post]: https://about.gitlab.com/2016/04/07/gitlab-pages-setup/#custom-domains