Skip to content

dylan-lang/gendoc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

3c7d747 · Jan 27, 2025

History

52 Commits
Nov 28, 2024
May 16, 2022
May 18, 2024
May 14, 2024
May 18, 2024
May 18, 2024
May 14, 2024
May 14, 2024
Jan 27, 2025
Jun 15, 2024

Repository files navigation

gendoc

This is a tool to generate the docs for all packages in the Dylan package catalog. How it works, in a nutshell:

  • Load the package catalog.
  • Download each package to a temp directory.
  • Copy package ResTructured Text docs into a combined directory tree.
  • Modify :file:`docs/source/index.rst` to list each package in the top-level toctree directive.

Note

The "docs" subdirectory in this repository is intentionally not named "documentation" in order to prevent gendoc itself from showing up in the package catalog since it has no documentation other than this README. Eventually we should have a setting in :file:`dylan-package.json` to exclude the package from combined docs.

Usage

To generate package docs in the :file:`docs/source` directory:

.. code-block:: shell
$ git clone https://github.com/dylan-lang/gendoc $ cd gendoc $ dylan update $ dylan build -a $ _build/bin/gendoc --excludes-file exclude-list.txt docs/source/index.rst $ cd docs $ make html $ rsync -av _build/html/ /var/www/package.opendylan.org/