PowerShell DevOps and Cloud Conference 2021

Forked from https://github.com/GDGToulouse/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.

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

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.

sunishsurendrank/PDCConf2021