Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Temp #3

Draft
wants to merge 33 commits into
base: base
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
33 commits
Select commit Hold shift + click to select a range
666ef42
feat: add `go.mod`
KieranKaelin Jul 26, 2024
7476b66
feat: add `go.mod`
KieranKaelin Jul 26, 2024
9309465
feat: add `go.mod`
KieranKaelin Jul 26, 2024
f944063
feat: enable `geekdocCollapseAllSections`
KieranKaelin Jul 26, 2024
da52b44
chore: add gitignore file
KieranKaelin Jul 26, 2024
1906b45
chore: remove unused images
KieranKaelin Jul 26, 2024
ddb535f
docs: update readme
KieranKaelin Jul 26, 2024
5157ea3
feat: use cybertec logo as `brand.svg`
KieranKaelin Jul 26, 2024
f77e048
feat: replace favicon
KieranKaelin Jul 26, 2024
c64bb62
feat: replace favicon
KieranKaelin Jul 26, 2024
c94b8fd
fix: move color in favicon link
KieranKaelin Jul 26, 2024
64d7d49
fix: add custom CSS
Schmaetz Jul 26, 2024
f5bffb1
change header_background
Schmaetz Jul 31, 2024
d5abc67
change header_background
Schmaetz Jul 31, 2024
7b7564f
Merge pull request #1 from cybertec-postgresql/mod_css
Schmaetz Jul 31, 2024
b2e283a
updated css
Schmaetz Jul 31, 2024
a743588
updated css
Schmaetz Jul 31, 2024
576866b
Merge pull request #2 from cybertec-postgresql/mod_css
Schmaetz Jul 31, 2024
34331a8
fix: typo in german localization
KieranKaelin Aug 8, 2024
a184a9e
feat: add `A product of CYBERTEC` between prevnext
KieranKaelin Aug 8, 2024
0f50584
feat: style page headings with the big-data circle
KieranKaelin Aug 8, 2024
6ad2c0d
feat: add products to `More` menu
KieranKaelin Aug 8, 2024
8db926b
feat: use `h4` in navigation
KieranKaelin Aug 8, 2024
3e6a7d1
fix: replace fonts
KieranKaelin Aug 8, 2024
9114c2f
feat: add support button
KieranKaelin Aug 8, 2024
564f996
fix: use white fidget spinner in header
KieranKaelin Aug 8, 2024
8aec4e0
feat: customize footer
KieranKaelin Aug 8, 2024
aba7369
feat: style according to CI
KieranKaelin Aug 8, 2024
e7265bf
fix: use `Roboto` for `body`
KieranKaelin Aug 9, 2024
938533d
feat: `more` section with product links
KieranKaelin Aug 9, 2024
9599f5c
docs: describe build
KieranKaelin Aug 9, 2024
0512ad3
fix: `$$` code highlighting in dark mode
KieranKaelin Aug 20, 2024
f80a0f5
fix: replace `overflow: scroll` with `auto` for code
KieranKaelin Aug 20, 2024
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
.idea
76 changes: 49 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,46 +1,68 @@
# Geekdoc
# Hugo documentation

[![Build Status](https://ci.thegeeklab.de/api/badges/thegeeklab/hugo-geekdoc/status.svg)](https://ci.thegeeklab.de/repos/thegeeklab/hugo-geekdoc)
[![Hugo Version](https://img.shields.io/badge/hugo-0.112-blue.svg)](https://gohugo.io)
[![GitHub release](https://img.shields.io/github/v/release/thegeeklab/hugo-geekdoc)](https://github.com/thegeeklab/hugo-geekdoc/releases/latest)
[![GitHub contributors](https://img.shields.io/github/contributors/thegeeklab/hugo-geekdoc)](https://github.com/thegeeklab/hugo-geekdoc/graphs/contributors)
[![License: MIT](https://img.shields.io/github/license/thegeeklab/hugo-geekdoc)](https://github.com/thegeeklab/hugo-geekdoc/blob/main/LICENSE)
A CYBERTEC themed "fork" of the [geekdoc](https://github.com/thegeeklab/hugo-geekdoc) theme for hugo.

Geekdoc is a simple Hugo theme for documentations. It is intentionally designed as a fast and lean theme and may not fit the requirements of complex projects. If a more feature-complete theme is required there are a lot of good alternatives out there. You can find a demo and the full documentation at [https://geekdocs.de](https://geekdocs.de).
## Requirements

![Desktop and mobile preview](https://raw.githubusercontent.com/thegeeklab/hugo-geekdoc/main/images/readme.png)
- `go`
- `hugo`

## Build and release process
## Usage

This theme is subject to a CI driven build and release process common for software development. During the release build, all necessary assets are automatically built by [webpack](https://webpack.js.org/) and bundled in a release tarball. You can download the latest release from the GitHub [release page](https://github.com/thegeeklab/hugo-geekdoc/releases).
Initialize a new hugo site:

Due to the fact that `webpack` and `npm scripts` are used as pre-processors, the theme cannot be used from the main branch by default. If you want to use the theme from a cloned branch instead of a release tarball you'll need to install `webpack` locally and run the build script once to create all required assets.
```shell
hugo new site <site-name>
cd <site-name>
```

Initialize the site as a go module:

```shell
# install required packages from package.json
npm install
hugo mod init github.com/cybertec-postgresql/<repository-name>
```

Add the following to your `hugo.toml` to use this theme, including functional code-highlighting:

```toml
# hugo.toml
pygmentsCodeFences = true
pygmentsUseClasses = true

[module]
[[module.imports]]
path = 'github.com/cybertec-postgresql/hugo_documentation'
```

# run the build script to build required assets
npm run build
Fetch the module

# build release tarball
npm run pack
```shell
hugo mod get -u
```

See the [Getting Started Guide](https://geekdocs.de/usage/getting-started/) for details about the different setup options.
Build your page
```shell
hugo --minify
# You may optionally overwrite the `baseURL`
hugo --minify -b "/docs/"
```

## Contributors
## Update

Special thanks to all [contributors](https://github.com/thegeeklab/hugo-geekdoc/graphs/contributors). If you would like to contribute, please see the [instructions](https://github.com/thegeeklab/hugo-geekdoc/blob/main/CONTRIBUTING.md).
To retrieve the latest version of this theme, simply run

```shell
hugo mod get -u
hugo mod tidy
```

Geekdoc is inspired and partially based on the [hugo-book](https://github.com/alex-shpak/hugo-book) theme, thanks [Alex Shpak](https://github.com/alex-shpak/) for your work.
## "Fork"

## License
This repository uses the built release, taken from https://github.com/thegeeklab/hugo-geekdoc/releases/latest/download/hugo-geekdoc.tar.gz.

This project is licensed under the MIT License - see the [LICENSE](https://github.com/thegeeklab/hugo-geekdoc/blob/main/LICENSE) file for details.
The following customizations have been done to achieve a CYBERTEC look and feel:

The used SVG icons and generated icon fonts are licensed under the license of the respective icon pack:
- Use the CYBERTEC logo in `./static/brand.svg`
- Add the `./config/_default/hugo.toml` config

- Font Awesome: [CC BY 4.0 License](https://github.com/FortAwesome/Font-Awesome#license)
- IcoMoon Free Pack: [GPL/CC BY 4.0](https://icomoon.io/#icons-icomoon)
- Material Icons: [Apache License 2.0](https://github.com/google/material-design-icons/blob/main/LICENSE)
In case that `geekdoc` is updated, we will have to fetch the latest release, merge those files into this repository, and handle possible merge conflicts.
2 changes: 1 addition & 1 deletion VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
v0.47.0
v0.48.0
44 changes: 44 additions & 0 deletions assets/sprites/cpo.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
67 changes: 67 additions & 0 deletions assets/sprites/cybertec.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
61 changes: 61 additions & 0 deletions assets/sprites/cypex.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
48 changes: 48 additions & 0 deletions assets/sprites/migrator.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
23 changes: 23 additions & 0 deletions assets/sprites/pgwatch.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading