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

docs: Use new Quantinuum docs theme #519

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

docs: Use new Quantinuum docs theme #519

wants to merge 4 commits into from

Conversation

mark-koch
Copy link
Collaborator

@mark-koch mark-koch commented Oct 1, 2024

@mark-koch mark-koch requested a review from a team as a code owner October 1, 2024 14:44
@mark-koch mark-koch requested a review from acl-cqc October 1, 2024 14:44
@codecov-commenter
Copy link

codecov-commenter commented Oct 1, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 91.39%. Comparing base (9cbb917) to head (6c3b03e).

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #519   +/-   ##
=======================================
  Coverage   91.39%   91.39%           
=======================================
  Files          59       59           
  Lines        6481     6481           
=======================================
  Hits         5923     5923           
  Misses        558      558           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

Copy link
Contributor

@acl-cqc acl-cqc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry, missed the notification for this one. I am completely not a docs expert, in fact the complete opposite, but the guide at the URL you've added was good :-) :-)

html_static_path = ["../_static"]
html_css_files = ["custom.css"]
templates_path = ["_templates", "../quantinuum-sphinx/_templates"]
html_static_path = ["../_static", "../quantinuum-sphinx/_static"]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

super-nit: according to https://github.com/CQCL/quantinuum-sphinx, these should be ordered the other way around

html_title = "Guppy compiler development docs"
html_theme_options = {}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Necessary or just good for explicitness? (Happy either way, but if the latter, might be good to add a comment at line end)

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure, I copied this from CQCL/hugr#1267

@@ -19,26 +19,15 @@
"sphinx.ext.intersphinx",
]

html_theme = "sphinx_book_theme"

html_theme = "furo"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also I think you are supposed to add html_favicon??

@@ -0,0 +1,13 @@
const navConfig = {
"navTextLinks": [

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No "title" or "href" ?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure what we should have in the navbar. Any ideas what to put here?

uv.lock Outdated
@@ -1,24 +1,16 @@
version = 1
requires-python = ">=3.10, <3.13"
resolution-markers = [
"python_full_version < '3.13'",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks odd, given requires-python explicitly excludes 3.13 (<3.13 not <=3.13) ??

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was confused about it, but it seems okay according to astral-sh/uv#6795

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

Successfully merging this pull request may close these issues.

Use new quantinuum-sphinx theme for API docs
4 participants