Igor Laborie
d3f727099d
|
5 years ago | |
---|---|---|
content | 5 years ago | |
data | 5 years ago | |
layouts/kids | ||
static | 5 years ago | |
themes | 5 years ago | |
tools | 5 years ago | |
.firebaserc | ||
.gitignore | ||
.gitlab-ci.yml | 5 years ago | |
.gitmodules | ||
LICENSE | ||
README.md | ||
config.toml | 5 years ago | |
firebase.json | ||
package.json | 5 years ago | |
yarn.lock | 5 years ago |
README.md
Site DevFest 2019
Requirement
-
Install Hugo Note: you need to install the extended version.
-
If you need to use tools, or deploy, you also need NodeJS and Yarn.
Install Theme
git submodule init
git submodule update themes/devfest-theme-hugo
Commit theme update
When you have made changes on the theme, you need to add the
git add themes/devfest-theme-hugo
Run Local site
Just run
hugo server -D
Notice that the -D
flag is used to rendrer draft elements.
More information here
Build
Just run
hugo
More information here
Edit data
You can edit
- general information about the site into the
config.toml
file. - some data into
data/*.yml
files, like header or footer information - some content into
content/**
files. - some static assets like images into the
static/*
folder
Create a new blog entry
You can use hugo new blog/i-create-a-new-entry.md
command and then edit it.
Or just copy an already existing blog entry, and update the content.
Update the theme
If you need to touch file of the theme (i.e. into ./themes/devfest-theme-hugo/
) you to know one more thing:
The theme is in another Git repository https://github.com/GDGToulouse/devfest-theme-hugo, it's using git submodules, so you need to handle this two repository.
So this is an example of workflow:
- install last NodeJS and yarn, see here and yarn
- go into the theme folder
./themes/devfest-theme-hugo/
- install dependencies with
yarn
- run
npm start
to launch automatically the build when a file change - (you still need to launch
hugo server
into the site folder) - HACK, HACK, HACK
- then build an optimized version with
npm run build
- then create the PR (or push)
- into the site folder,
git add themes/devfest-theme-hugo
- then create the PR (or push)
Publish
To publish the site on firebase, just run firebase deploy
.
Note that you need to authenticate once with firebase login
YOU DON'T NEED to publish manually the website, it's already done by pushing on develop
or master
branches.
You could take a look at the .gitlab-ci.yml
file
Extract data from CFP
TODO...