mirror of
https://github.com/Hopiu/linkchecker.git
synced 2026-03-16 22:10:26 +00:00
c7989eb058
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.
63 lines
1.4 KiB
Markdown
63 lines
1.4 KiB
Markdown
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``.
|