Skip to content

Migration to sphinx #2

@rafalkrupinski

Description

@rafalkrupinski

Because of problems with mkdocs I'm trying to migrate to sphinx with myst and autodoc2.

One of the problems seems to be the fact that I'm trying this weird setup of building three projects (lapidary, lapidary-render and docs) as one.

Currently far autodoc2 doesn't support namespace packages. There's a patch for this, but it still doesn't support namespace packages spread across multiple directories (lapidary/src/lapidary, lapidary-render/src/lapidary). Also the plugin is abandoneed, wth the latest release late 2023.

Since the two project technically share only the name and a landing page, I should rather build their docs separately and just push build files to the correct subdiretory in docs repo, gh-pages branch.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions