pkic.org website

Make and preview changes

You can make simple changes in the GitHub editor. For more advanced changes you might want to run a local copy of the website.

Some basic git knowledge is required, please check https://guides.github.com/ to get started from scratch. An editor such as Visual Studio Code can help you to simplify most of these tasks and help you with editing the content.

1. Install hugo
2. Create a fork of this repository
3. Clone your fork
4. Run hugo server -D in the root directory of your fork
5. Open the shown URL http://localhost:xxxx/ in your browser to preview your local version
6. Make changes until you are satisfied; the preview will update automatically
7. Commit and push your changes
8. Create a pull request

Adding a new member

1. Create a new-member-name.yaml in the data/members folder.
2. Create a new-member-name.md in the content/members folder.
3. Add the logo in SVG format in the folder assets/images/members, the filename must correspondent with id of the member (e.g., member.svg)

Adding a new author

• For member authors, add a representative in the data/members/member.yaml file.
• For authors that are not associated with a member, add a listing in data/authors.yaml.

Formatting content

The content lives in content/ and is written as markdown because of it's simple content format. We do not allow the usage of HTML, this to enforce uniform and structured content, but there are times when Markdown falls short. For some of these reusable cases you can use built-in shortcodes or use/create a custom shortcode.

• Basic Markdown Syntax
• Diagrams
  • GoAT (rendered on server)
  • Mermaid (rendered using JavaScript on client)

You can add attributes (e.g. CSS classes) to Markdown blocks, e.g. tables, lists, paragraphs etc.

A blockquote with a CSS class:

> **Warning**
> This is an important message
{.callout-warning}

All Bootstrap styles are available, to change the default table style you can use for example the following attributes:

| table header | column |
| ------------ | ------ |
| first row    |        |
| second row   |        |
{.table .table-bordered .table-striped .table-hover}

Update content from other repositories

Some content is managed in external repositories through git submodules, include the remote remote branch in your local preview run the following command.

git submodule init
git submodule update --remote

The update command can be run to update your local copy when the remote branch changes. Submodules are managed in the file .gitmodules.