Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/appuio/website

The APPUiO Website
https://github.com/appuio/website

hacktoberfest hugo vshn-project-ignore

Last synced: 4 days ago
JSON representation

The APPUiO Website

Awesome Lists containing this project

README

        

# APPUiO.ch website

## Local development

To start an auto-reloading local server:

`docker run --rm -v $(pwd):/src -p 1313:1313 klakegg/hugo:ext-alpine server`

Then open http://localhost:1313 in your browser. Whenever you save a file the website in the browser reloads.

## Installation
```
oc create sa github-workflow
oc policy add-role-to-user admin -z github-workflow
oc sa get-token github-workflow
```
Add the token to the secret `OPENSHIFT_TOKEN`

## Secrets

The following secrets must be configured:
- `OPENSHIFT_TOKEN`
- `OAUTH_CLIENT_ID` Github Oauth App for CMS
- `OAUTH_CLIENT_SECRET`

## Open Issues
[ indentation in partial/shortcode wrapped in `

`](https://github.com/gohugoio/hugo/issues/6553)

Workaround: use `{{- -}}` everywhere and remove all empty lines

[Shortcodes are not reloading when inner resources are changed](https://github.com/gohugoio/hugo/issues/6177)

Workaround: restart `hugo serve` after changes

Unclosed shortcode uses rest of page as `.Inner` (`{{}}` vs `{{}}`)

Workaround: be careful

Non-closing shortcodes with `.Inner` use the rest of the page instead of throwing an error

Workaround: count the opening and closing tags and throw an error if not the same. Add shortcode to `mustCloseShortcodes` in `config.toml`. [themes/appuio/layouts/partials/check-must-close-shortcodes.html](https://github.com/appuio/website-new/blob/master/themes/appuio/layouts/partials/check-must-close-shortcodes.html).

TODO: report issue to Hugo or [create pull request](https://github.com/gohugoio/hugo/blob/fdfa4a5fe62232f65f1dd8d6fe0c500374228788/hugolib/shortcode.go#L518)