Skip to content

Latest commit

 

History

History
111 lines (80 loc) · 2.38 KB

README.md

File metadata and controls

111 lines (80 loc) · 2.38 KB

ApacheCon hugo site

This repository contains a Hugo based site for ApacheCon.

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

FAQ

How to fix the typos in Session page

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.

How can I publish the website to ApacheCon

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"

How can I modify the content of the main page:

It's under content/_index.md

How can I have translations:

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

How can I modify the menu?

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.