Skip to content

Commit cee10c2

Browse files
authored
Create README
1 parent 504d0a7 commit cee10c2

File tree

1 file changed

+35
-0
lines changed

1 file changed

+35
-0
lines changed

README.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Code FREAK Documentation
2+
[![](https://images.microbadger.com/badges/version/cfreak/homepage-docs.svg)](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

Comments
 (0)