This repository contains a Hugo based site for ApacheCon.
NOTE: Please use hugo v0.92.2 to avoid the website build error.
To install Hugo :
brew install hugo
# or
port install hugo
Please chose hugo below v0.93, otherwise the build will failed.
To test it locally, run:
hugo server -b http://localhost:1313/acasia2023 -F
To generate final site, use:
hugo -b https://apachecon.com/acasia2023/ -d <destination_directory> -F
If you want to fix session typos of https://apachecon.com/acasia2023/sessions/1155.html You just need to go the file 1155.md in content/sessions directory. If it is chinese version, you just need to update the file of 1155.zh.md.
First you need to write access right of ApacheCon website
Checking out the this repo
[email protected]:alc-beijing/acasia-website.git <source-directory>
Checking out the content of website to
svn co https://svn.apache.org/repos/infra/apachecon/www.apachecon.com/acasia2022/ <site-directory>
After doing some modifications on the markdown files, you can use hugo command to generate the website from the source directory
cd <source-directory>
hugo -b https://apachecon.com/acasia2022/ -d <site-directory> -F
Publishing the website
cd <site-directory>
svn ci -m "Publish the website of acasia2022"
It's under content/_index.md
Add new language to the config.toml
:
[languages.zh]
languageName = "中文"
weight = 2
And create language specific version for each content file:
content/_index.md
content/_index.zh.md
content/cfp.md
content/cfp.zh.md
For simple links, add the menu entry to the config.toml
:
(Note: add it for all the active languages)
[[languages.en.menu.main]]
name = "t-shirt"
url = "https://s.apache.org/apache-tshirt"
weight = -110
The most page links of the menu are generated from the markdown files of content directory.
For a page, it's enough to add a menu entry to the markdown (For example content/cfp.md
):
---
title: Call for Presentations
menu:
main:
weight: -300
---
...
...
You can add or remove the links from navigation bar by adding or removing this menu entry.