|
| 1 | +# Code FREAK Documentation |
| 2 | +[](https://hub.docker.com/r/cfreak/homepage-docs) |
| 3 | + |
| 4 | +> :warning: **This is only the static site generator for docs.codefreak.org**: If you look for the actual content for [docs.codefreak.org](https://docs.codefreak.org) please head over to the [`/docs`](https://github.com/codefreak/codefreak/tree/master/docs) directory in our main repository. |
| 5 | +
|
| 6 | +This is our repository to convert [Code FREAK](https://codefreak.org)'s documentation to static HTML. We use [Antora](https://antora.org/) to covert AsciiDoc to an accessible HTML site and deploy it as Docker image. |
| 7 | + |
| 8 | +## Editing |
| 9 | +Editing of the page contents is done in the main repository's [`/docs` direcotry](https://github.com/codefreak/codefreak/tree/master/docs). This repository only contains the Antora configuration and some additional styling. Check out the official [Antora documentation](https://docs.antora.org/) to find out more about its internals. |
| 10 | + |
| 11 | +## Installation |
| 12 | +You can either use Docker to build the static pages, or if you would like to create a manual build outside of Docker check out [Antora's installation guide](https://docs.antora.org/antora/2.0/install/install-antora/#install-antora-globally-using-npm). |
| 13 | + |
| 14 | +## Build |
| 15 | +You can create a local build with Docker by using `docker build -t cfreak/homepage-docs .` inside the root direcoty of this repository. Afterwards you can start the container with `docker run --rm -it -p8080:80 cfreak/homepage-docs`. |
| 16 | + |
| 17 | +## Deployment |
| 18 | +or image deployment we use Docker Hub's Autodeployment feature. It is connected to this repository. The official image is deployed as [`cfreak/homepage-docs`](https://hub.docker.com/r/cfreak/homepage-docs) |
| 19 | +## License |
| 20 | + |
| 21 | + Code FREAK | Code Feedback Review & Evaluation Kit |
| 22 | + Copyright (C) 2020 Kiel University of Applied Sciences |
| 23 | + |
| 24 | + This program is free software: you can redistribute it and/or modify |
| 25 | + it under the terms of the GNU Affero General Public License as published |
| 26 | + by the Free Software Foundation, either version 3 of the License, or |
| 27 | + (at your option) any later version. |
| 28 | + |
| 29 | + This program is distributed in the hope that it will be useful, |
| 30 | + but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 31 | + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 32 | + GNU Affero General Public License for more details. |
| 33 | + |
| 34 | + You should have received a copy of the GNU Affero General Public License |
| 35 | + along with this program. If not, see <https://www.gnu.org/licenses/>. |
0 commit comments