Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve generated HTML for module directive #22

Open
cgay opened this issue Sep 20, 2020 · 1 comment
Open

Improve generated HTML for module directive #22

cgay opened this issue Sep 20, 2020 · 1 comment

Comments

@cgay
Copy link
Member

cgay commented Sep 20, 2020

The HTML generated for the module directive (:mod:`foo`) looks exactly like the HTML for other Dylan language entities. Given that we will normally use .. module:: foo to start a module reference section I think we have two choices:

  1. Generate a section header for the module:

    The Foo Module

  2. Just create an anchor to reference but leave the section header to be created manually. I'm thinking this might be necessary because we don't know what section level to use. (i.e., what character to use for underlining)

@cgay
Copy link
Member Author

cgay commented Sep 20, 2020

I didn't check, but I wonder if .. library:: has the same problem.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant