This is the user documentation for darktable. The content is authored in markdown and rendered to HTML using Hugo as well as to PDF and ePub.
This repository tracks the current darktable development version. The auto-built website for the development user manual can be found at https://darktable-org.github.io/dtdocs/.
The user manual for the current stable release of darktable can be found at darktable.org.
Please see https://darktable-org.github.io/dtdocs/en/special-topics/contributing/ for information about contributing content
For a complete list of the outstanding work please see the issues in this repository and a list of undocumented pull requests in the darktable repository.
The themes for the site and PDF use hugo-darktable-docs-theme and hugo-darktable-docs-pdf-theme as git submodules.
In order to clone these submodules along with the site you just need to add the flag --recurse-submodules
to the clone command:
git clone --recurse-submodules https://github.com/darktable-org/dtdocs.git
If you already have the site cloned, but haven't included the submodules before:
git submodule update --init --recursive
This site is built with the static site generator Hugo (extended). Currently v0.75.1 extended:
$ ./hugo version
Hugo Static Site Generator v0.73.0/extended windows/amd64 BuildDate: unknown
If cloning the repo fresh, remember to build the bootstrap assets locally:
$ cd ./themes/hugo-darktable-docs-theme/assets/
$ yarn install (or alternatively `npm install`)
$ cd ../../hugo-darktable-docs-pdf-theme/assets/
$ yarn install
If you have the repo cloned but need to update things, it helps to make sure everything is up to date (since we are also using a submodule for the base theme).
As normal, from the project root directory, update things like normal:
git pull
Double check that the submodule is being updated as well:
git submodule update --init --recursive
And finally make sure the assets are built:
cd themes/hugo-darktable-docs-theme/assets/
yarn install (or alternatively `npm install`).
This should get things up and running.
You can build the HTML website locally, the production site to deploy to hosting, or the PDF.
Building the site to test locally can be done from the root of the repo.
$ hugo server -D --disableFastRender
The site should then be available at http://localhost:1313/usermanual/development/ (you can see the URL in the output of the hugo server
command).
Run the hugo
command:
hugo
The static files are now available to deploy to a webhost in the public
directory. This is currently performed automatically when new changes are pushed to the master branch, via github Actions.
Ensure you have the weasyprint
application installed; this will transform the generated HTML to PDF.
mkdir -p public
hugo server --disableFastRender --config config-pdf.yaml
weasyprint http://localhost:1313/dtdocs/index.html public/darktable_user_manual.pdf
pkill hugo
The PDF is available in the public
directory.