Hopiu/linkchecker
1
0
Fork 0
mirror of https://github.com/Hopiu/linkchecker.git synced 2026-03-16 22:10:26 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
linkchecker/doc/documentation.md
Chris Mayo c7989eb058 Turn all warnings into errors when building website 
Drop code target, sphinx-autogen is not using conf.py, and since Sphinx
4.0 autosummary is generating stub pages by default anyway.

Mock ctypes and linkcheck.__main__: colorama.py imports MS Windows
libraries, autosummary executes __main__.py.
2022-11-02 19:24:35 +00:00

1.4 KiB
Raw Blame History

LinkChecker Documentation

LinkChecker is documented with man pages and HTML that is used for the project web site. Both are generated using Sphinx, with Makefiles provided to simplify the process.

Sources are found in doc/src. Stand-alone .rst files from doc/ are also included.

In addition to Sphinx the dependencies for building the documentation are:

graphviz

sphinx_epytext

sphinx_rtd_theme

sphinx_sitemap

Configuration

Before building either man pages or HTML, generate linkcheck/_release.py containing copyright, author and version with:

hatchling build -t sdist --hooks-only

Man Pages

Source files are in doc/src/man.

The pages can be built with:

linkchecker/doc $ make man

The files are saved in doc/man.

See translations.md for information about creating localised man pages.

Published man pages are included in the LinkChecker repository.

HTML

Build the HTML files with:

linkchecker/doc $ make html

The files are saved in doc/html.

Publishing the Web Site

The Web Site is hosted by GitHub Pages from the gh-pages branch.

A .nojekyll file is present to ensure folders beginning with an underscore are published.

When updates to LinkChecker are pushed, the web site is built and published automatically by a GitHub action .github/workflows/publish-pages.yml.