Draft: First draft of new fiber based server #7
2 changed files with 17 additions and 8 deletions
17
README.md
17
README.md
|
@ -3,13 +3,14 @@
|
||||||
[![Actions Status](https://github.com/baez90/goveal/workflows/Go/badge.svg)](https://github.com/baez90/goveal/actions)
|
[![Actions Status](https://github.com/baez90/goveal/workflows/Go/badge.svg)](https://github.com/baez90/goveal/actions)
|
||||||
|
|
||||||
Goveal is very small and very simple tool that reads Markdown from a given file, renders it into an HTML template and serves it as local HTTP server.
|
Goveal is very small and very simple tool that reads Markdown from a given file, renders it into an HTML template and serves it as local HTTP server.
|
||||||
Right now Goveal uses Reveal.js 4.2.1 to create presentations and therefore also includes all features of Reveal.js 4.2.1.
|
Right now Goveal uses Reveal.js 4.3.0 to create presentations and therefore also includes all features of Reveal.js.
|
||||||
|
|
||||||
In contrary to Reveal.js `goveal` ships with its own Markdown parser and renderer which is why some features are working slightly different from Reveal.js.
|
In contrary to Reveal.js `goveal` ships with its own Markdown parser and renderer which is why some features are working slightly different from Reveal.js.
|
||||||
See [Markdown](#markdown) for further details.
|
See [Markdown](#markdown) for further details.
|
||||||
|
|
||||||
Besides all features from Reveal.js `goveal` comes with first class support for [mermaid-js](https://mermaid-js.github.io/).
|
Besides all features from Reveal.js `goveal` comes with first class support for [mermaid-js](https://mermaid-js.github.io/).
|
||||||
Just inline your diagrams as code and enjoy!
|
Just inline your diagrams as code and enjoy!
|
||||||
|
An example can be found in the [examples](examples/slides.md).
|
||||||
|
|
||||||
## Install
|
## Install
|
||||||
|
|
||||||
|
@ -42,7 +43,7 @@ goveal serve ./slides.md
|
||||||
```
|
```
|
||||||
|
|
||||||
| Param | Description | Default value |
|
| Param | Description | Default value |
|
||||||
| ---------------- | --------------------------------------------- | ----------------------- |
|
|------------------|-----------------------------------------------|-------------------------|
|
||||||
| `--host` | Hostname the binary is listening on | `127.0.0.1` |
|
| `--host` | Hostname the binary is listening on | `127.0.0.1` |
|
||||||
| `--port` | Port the binary is listening on | `2233` |
|
| `--port` | Port the binary is listening on | `2233` |
|
||||||
| `--config` | Path to the config file see [config](#config) | `$HOME/goveal:./goveal` |
|
| `--config` | Path to the config file see [config](#config) | `$HOME/goveal:./goveal` |
|
||||||
|
@ -58,7 +59,7 @@ this:
|
||||||
podman/docker run --rm -ti -v `pwd`:/work -w /work -p 2233:2233 ghcr.io/baez90/goveal:0 serve --host 0.0.0.0 slides.md
|
podman/docker run --rm -ti -v `pwd`:/work -w /work -p 2233:2233 ghcr.io/baez90/goveal:0 serve --host 0.0.0.0 slides.md
|
||||||
```
|
```
|
||||||
|
|
||||||
By default `goveal` only listens on `127.0.0.1`. To allow traffic from outside of the container you've to change the
|
By default `goveal` only listens on `127.0.0.1`. To allow traffic from outside the container you've to change the
|
||||||
binding to `0.0.0.0`.
|
binding to `0.0.0.0`.
|
||||||
|
|
||||||
## Config
|
## Config
|
||||||
|
@ -78,7 +79,7 @@ I try to keep the example up to date to cover **all** supported config options a
|
||||||
## Markdown
|
## Markdown
|
||||||
|
|
||||||
A good point to start is the [slides.md](examples/slides.md) in the `examples` directory.
|
A good point to start is the [slides.md](examples/slides.md) in the `examples` directory.
|
||||||
I try to showcase everyting possible with `goveal` in this presentation.
|
I try to showcase everything possible with `goveal` in this presentation.
|
||||||
|
|
||||||
The most remarkable difference between `goveal` and the `marked` driven Reveal.js markdown is how line numbers in listings are working:
|
The most remarkable difference between `goveal` and the `marked` driven Reveal.js markdown is how line numbers in listings are working:
|
||||||
|
|
||||||
|
@ -114,4 +115,10 @@ Changes in the custom CSS files are monitored and propagated via SSE to the pres
|
||||||
No page reload necessary!
|
No page reload necessary!
|
||||||
|
|
||||||
The sample configuration file [`./examples/goveal.yaml`](./examples/goveal.yaml) also contains a sample how to add
|
The sample configuration file [`./examples/goveal.yaml`](./examples/goveal.yaml) also contains a sample how to add
|
||||||
custom CSS.
|
custom CSS.
|
||||||
|
|
||||||
|
## Emojis
|
||||||
|
|
||||||
|
Aside of UTF character emojis `goveal` also supports emoji references like Github flavored markdown supports them.
|
||||||
|
For example`:winking_face:` becomes :winking_face: .
|
||||||
|
All supported keywords can be found [here](https://unpkg.com/emojilib@latest).
|
|
@ -2,8 +2,8 @@ version: '3'
|
||||||
|
|
||||||
vars:
|
vars:
|
||||||
DEBUG_PORT: 2345
|
DEBUG_PORT: 2345
|
||||||
REVEALJS_VERSION: 4.2.1
|
REVEALJS_VERSION: 4.3.0
|
||||||
HIGHLIGHTJS_VERSION: 11.4.0
|
HIGHLIGHTJS_VERSION: 11.5.0
|
||||||
MERMAID_VERSION: 8.14.0
|
MERMAID_VERSION: 8.14.0
|
||||||
BINARY_NAME: goveal
|
BINARY_NAME: goveal
|
||||||
OUT_DIR: ./out
|
OUT_DIR: ./out
|
||||||
|
@ -33,6 +33,8 @@ tasks:
|
||||||
- "{{ .GOBIN }}goimports -w -local github.com/baez90/goveal ./."
|
- "{{ .GOBIN }}goimports -w -local github.com/baez90/goveal ./."
|
||||||
|
|
||||||
deps:
|
deps:
|
||||||
|
deps:
|
||||||
|
- download-assets
|
||||||
sources:
|
sources:
|
||||||
- go.mod
|
- go.mod
|
||||||
- go.sum
|
- go.sum
|
||||||
|
@ -99,7 +101,7 @@ tasks:
|
||||||
- rm -f ./assets/reveal/plugin/menu/{bower.json,CONTRIBUTING.md,LICENSE,package.json,README.md,.gitignore,gulpfile.js,package-lock.json}
|
- rm -f ./assets/reveal/plugin/menu/{bower.json,CONTRIBUTING.md,LICENSE,package.json,README.md,.gitignore,gulpfile.js,package-lock.json}
|
||||||
- curl -L https://github.com/highlightjs/highlight.js/archive/{{ .HIGHLIGHTJS_VERSION }}.tar.gz | tar -xvz --strip-components=3 -C ./assets/reveal/plugin/highlight --wildcards "*.css" highlight.js-{{ .HIGHLIGHTJS_VERSION }}/src/styles/
|
- curl -L https://github.com/highlightjs/highlight.js/archive/{{ .HIGHLIGHTJS_VERSION }}.tar.gz | tar -xvz --strip-components=3 -C ./assets/reveal/plugin/highlight --wildcards "*.css" highlight.js-{{ .HIGHLIGHTJS_VERSION }}/src/styles/
|
||||||
- curl -L https://registry.npmjs.org/mermaid/-/mermaid-{{ .MERMAID_VERSION }}.tgz | tar -xvz -C ./assets/mermaid/ package/dist --strip-components=2
|
- curl -L https://registry.npmjs.org/mermaid/-/mermaid-{{ .MERMAID_VERSION }}.tgz | tar -xvz -C ./assets/mermaid/ package/dist --strip-components=2
|
||||||
- curl -L -o rendering/emoji/emoji.json https://raw.githubusercontent.com/muan/emojilib/main/dist/emoji-en-US.json
|
- curl -L -o rendering/emoji/emoji.json https://unpkg.com/emojilib@latest
|
||||||
|
|
||||||
go-get-tool:
|
go-get-tool:
|
||||||
vars:
|
vars:
|
||||||
|
|
Loading…
Reference in a new issue