Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/apache/apachecon-acasia

Community Over Code Asia - Asia edition of the flagship ASF conference
https://github.com/apache/apachecon-acasia

apache community-over-code conference

Last synced: 2 days ago
JSON representation

Community Over Code Asia - Asia edition of the flagship ASF conference

Awesome Lists containing this project

README

        

# ApacheCon hugo site

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 -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](https://svn.apache.org/repos/infra/apachecon/www.apachecon.com/acasia2022/)

Checking out the this repo
```
[email protected]:alc-beijing/acasia-website.git
```

Checking out the content of website to
```
svn co https://svn.apache.org/repos/infra/apachecon/www.apachecon.com/acasia2022/
```

After doing some modifications on the markdown files, you can use hugo command to generate the website from the source directory
```
cd
hugo -b https://apachecon.com/acasia2022/ -d -F
```

Publishing the website
```
cd
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.