EPUB3 for LinuxFr.org contents

This daemon creates on the fly epub3 from a content on LinuxFr.org and its comments.

How to use it? (outside Docker)

Install Go and don't forget to set $GOPATH

# aptitude install libonig-dev libxml2-dev pkg-config
$ go get -u github.com/linuxfrorg/epub-LinuxFr.org
$ epub-LinuxFr.org [-addr addr] [-l logs] [-H host]

And, to display the help:

$ epub-LinuxFr.org -h

How to use it? (with Docker)

Build and run Docker image:

$ docker build -t linuxfr.org-epub .
$ docker run --publish 9000:9000 linuxfr.org-epub
or
$ docker run --publish 9000:9000 --env HOST=somewebserver linuxfr.org-epub

How it works?

Accepted requests are:

• GET /status (expected answer is HTTP 200 with "OK" body)
• get the corresponding content + comments on host site, converted into EPUB
  • GET /news/<slug>.epub (news)
  • GET /users/<user>/journaux/<slug>.epub (diary)
  • GET /forums/<forum>/posts/<slug>.epub (post / forum entry)
  • GET /sondages/<slug>.epub (poll)
  • GET /suivi/<slug>.epub (tracker entry)
  • GET /wiki/<slug>.epub (wiki page)
• otherwise HTTP 404

Caveats

• require https for host
• not statically built (so libxml2, libonig2 and probably ca-certificates needed for deployment)
• answers HTTP 404 when something is wrong (unable to fetch, bad HTTP verb, bad content type, etc.)
• base64 inline images are not supported (log "Error: Get data:image/svg+xml;base64,...%0A: unsupported protocol scheme "data")

Testsuite

Testsuite requires docker-compose.

cd tests/
docker-compose up --build
DEBUG=1 ./epub-tests.sh

Extra checks (linter for Dockefile and vulnerability/secret scan):

for image in Dockerfile tests/Dockerfile tests/cert-web/Dockerfile
do
  docker run --rm --interactive hadolint/hadolint < "$image"
  docker run --rm --volume $(pwd)/$image:/app/Dockerfile --workdir /app replicated/dockerfilelint Dockerfile
done
# (already embedded in Dockerfile due to prerequisites)
# docker run --rm --tty --volume $(pwd):/app --workdir /app golangci/golangci-lint:v1.62.0 golangci-lint run -v
docker run --rm --volume $(pwd):/app --workdir /app aquasec/trivy repo --skip-files cert-web/private/web.key .

See also

• Git repository

Copyright

The code is licensed as GNU AGPLv3. See the LICENSE file for the full license.

♡2013 by Bruno Michel. Copying is an act of love. Please copy and share.

2024 by Benoît Sibaud and Adrien Dorsaz.