mirror of https://github.com/TheAnachronism/docspell.git synced 2024-11-13 02:31:10 +00:00

History

martin f. krafft 750be99aaf Add logic to set due date from addons, based on #2362 Signed-off-by: martin f. krafft <madduck@madduck.net>		2023-11-15 10:35:03 +01:00
..
elm	Fixed typo in Main.elm (homepage)	2023-07-05 09:11:19 +02:00
scripts	Addon docs	2022-05-21 00:40:26 +02:00
site	Merge pull request #2369 from madduck/2345-docs	2023-11-12 13:23:16 +01:00
src/main/scala/docspell/website	Add logic to set due date from addons, based on #2362	2023-11-15 10:35:03 +01:00
styles	Add some docs to file backends	2022-03-13 15:20:33 +01:00
elm-analyse.json	Initial website	2020-07-30 20:33:26 +02:00
elm.json	Add search to docs	2020-09-30 00:21:21 +02:00
package.json	Update dependency @fontsource/spectral to v5	2023-05-21 17:21:05 +00:00
postcss.config.js	Website redesign	2022-02-03 21:42:09 +01:00
push-docs.sh	Merge branch 'current-docs'	2022-05-22 13:43:50 +02:00
README.md	Website redesign	2022-02-03 21:42:09 +01:00
shell.nix	Update website build	2023-11-13 17:36:02 +01:00
tailwind.config.js	Website redesign	2022-02-03 21:42:09 +01:00
yarn.lock	Update website build	2023-11-13 17:36:02 +01:00

Website

This is the docspell website and documentation.

Building

The website is created using zola static site generator. The (very minimal) dynamic parts are written in Elm.

Sbt is used to build the site.

Install things by running yarn install.

Open terminal for each script below:

Starting the server

nix-shell --run "cd site && zola serve"

Building the stylesheet

nix-shell --run ./scripts/run-styles.sh

Open browser at localhost:1111.

The above is great when editing, but doesn't fully reflect what will be finally deployed. To see this, start sbt and change into the website project.

nix-shell website/shell.nix --run sbt
sbt> project website

Build everything and check for dead links:

sbt> zolaBuildTest
sbt> zolaCheck

sbt> ghpagesSynchLocal

The final site is now generated and a simple http server can be used to see how it will look when deployed.

cd ~/.sbt/ghpages/<some-hash>/com.github.eikek/docspell-website
python -m http.server 1234