Skip to content
This repository has been archived by the owner on Aug 14, 2024. It is now read-only.

Adding Sphinx for Documentation #36

Open
wants to merge 59 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 53 commits
Commits
Show all changes
59 commits
Select commit Hold shift + click to select a range
bdac78a
New Grovers Benchmark
Lementknight Jul 12, 2022
855d33e
Grover Benchmark Code Adopted from SRI-International
Lementknight Jul 14, 2022
4a83be1
Passes Tox Test
Lementknight Jul 18, 2022
b919fd1
Implementing Pytest
Lementknight Jul 19, 2022
d915172
Necessary File
Lementknight Jul 19, 2022
677a657
Pytest Works [Attribution Revisions Needed]
Lementknight Jul 21, 2022
6ab5288
Pytest Works [Attribution Revisions Needed]
Lementknight Jul 21, 2022
a15cfb4
Line Error Corrected
Lementknight Jul 21, 2022
0f496c6
CLA is not ready for testing
Lementknight Jul 21, 2022
0dac57a
Update games/applications/grovers.py
Lementknight Jul 22, 2022
7496ca9
Update games/applications/grovers.py
Lementknight Jul 22, 2022
e267029
Update games/applications/grovers.py
Lementknight Jul 22, 2022
32a4422
Recommended Revisions to Header Applied
Lementknight Jul 22, 2022
0170422
Local Changes Saved
Lementknight Jul 22, 2022
2f6455b
Merge branch 'main' of github.com:Qiskit/red-queen
Lementknight Jul 26, 2022
0378672
Merge branch 'main' into main
Lementknight Jul 28, 2022
dc58ada
Merge branch 'Qiskit:main' into main
Lementknight Jul 28, 2022
2a48cfb
Should be Ready to Merge
Lementknight Jul 28, 2022
8f7ea7b
Red Queen CLI
Lementknight Jul 18, 2022
d4bc135
Updated Benchmark Retrieval Code
Lementknight Jul 18, 2022
d06ecff
Implementing Pytest Execution
Lementknight Jul 19, 2022
3674a76
Test out the CLA
Lementknight Jul 21, 2022
d8d1b3a
Updated ReadMe with New CLI Instructions
Lementknight Jul 28, 2022
59572ad
Revised ReadMe with CLI Instruction
Lementknight Jul 22, 2022
d30ed96
Corrected Code
Lementknight Jul 28, 2022
8d05a31
Merge Fix
Lementknight Jul 28, 2022
81ea3b1
Fixed Merge Issue
Lementknight Jul 28, 2022
399eb69
Merge Fix
Lementknight Jul 28, 2022
3d1e8fb
Reworking CLI with Click
Lementknight Jul 25, 2022
dac4e65
CLI is Ready For Testing
Lementknight Jul 26, 2022
a0fd3da
Red Queen CLI Now Compatible w/ Red Queen Package
Lementknight Jul 29, 2022
dc07f05
Have At Thee
Lementknight Jul 29, 2022
e33aca3
Belong in Another Branch
Lementknight Jul 29, 2022
317e392
Adding Entry Point
Lementknight Jul 29, 2022
6849246
Added Back ReadMe
Lementknight Jul 29, 2022
af330d0
Fixed Setup File
Lementknight Jul 29, 2022
d6bb8c8
Deleted test.py
Lementknight Jul 29, 2022
9a28304
Delete setup.py
Lementknight Jul 29, 2022
7ff2d41
Delete README.md
Lementknight Jul 29, 2022
6fd35a9
Merge Issue Fix
Lementknight Jul 29, 2022
174080f
Merge branch 'main' into main
Lementknight Jul 29, 2022
595af6b
Update red_queen/games/applications/grovers.py
Lementknight Jul 29, 2022
45f6478
Removed Unnecessary Code
Lementknight Jul 29, 2022
d03e0cb
Small Formatting Fix
Lementknight Jul 29, 2022
105861f
Update red_queen/games/applications/grovers.py
Lementknight Jul 29, 2022
b0403a0
Added Proper Permalink
Lementknight Aug 1, 2022
d7dc858
Deleted whitespace in README.MD
raynelfss Aug 1, 2022
589f0d1
Starting Sphinx Integration
Lementknight Aug 10, 2022
85d9bbc
Merge branch 'main' into sphinx
Lementknight Aug 10, 2022
ed4c90e
Replacing qiskit-neko w/ red-queen
Lementknight Aug 10, 2022
85b2104
Removed Unneeded Files
Lementknight Aug 10, 2022
101755c
Removed Unneeded Code
Lementknight Aug 10, 2022
8900e47
Merge branch 'main' into sphinx
Lementknight Aug 12, 2022
b96d9f3
Removed Unneeded Lines
Lementknight Aug 12, 2022
e86576d
Merge branch 'main' into sphinx
Lementknight Aug 12, 2022
8fe9984
Added New Package to Requirements:
Lementknight Aug 12, 2022
de226de
Passes Tox -edocs:
Lementknight Aug 12, 2022
447b5fe
Removed Sphinx from Requirements.txt:
Lementknight Aug 12, 2022
2fbd6ea
Added Sphinx to Dependencies for Testenv:docs:
Lementknight Aug 12, 2022
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions docs/_static/custom.css
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
.toggle .header {
display: block;
clear: both;
background-color: #785EF0;
color: #f9f9f9;
height: 40px;
padding-top: 10px;
padding-left: 5px;
margin-bottom: 20px;
}

.toggle .header:before {
float: left;
content: "▶ ";
font-size: 20px;

}

.toggle .header.open:before {
float: left;
content: "▼ ";
font-size: 20px;
}

.toggle{
background: #FBFBFB;
}
195 changes: 195 additions & 0 deletions docs/_static/gallery.css
Original file line number Diff line number Diff line change
@@ -0,0 +1,195 @@
/*
Sphinx-Gallery has compatible CSS to fix default sphinx themes
Tested for Sphinx 1.3.1 for all themes: default, alabaster, sphinxdoc,
scrolls, agogo, traditional, nature, haiku, pyramid
Tested for Read the Docs theme 0.1.7 */
.sphx-glr-thumbcontainer {
background: #fff;
border: solid #fff 1px;
-moz-border-radius: 5px;
-webkit-border-radius: 5px;
border-radius: 5px;
box-shadow: none;
float: left;
margin: 5px;
min-height: 230px;
padding-top: 5px;
position: relative;
}
.sphx-glr-thumbcontainer:hover {
border: solid #6200EE 1px;
box-shadow: 0 0 15px rgba(163, 142, 202, 0.5);
}
.sphx-glr-thumbcontainer a.internal {
bottom: 0;
display: block;
left: 0;
padding: 150px 10px 0;
position: absolute;
right: 0;
top: 0;
}
/* Next one is to avoid Sphinx traditional theme to cover all the
thumbnail with its default link Background color */
.sphx-glr-thumbcontainer a.internal:hover {
background-color: transparent;
}

.sphx-glr-thumbcontainer p {
margin: 0 0 .1em 0;
}
.sphx-glr-thumbcontainer .figure {
margin: 10px;
width: 160px;
}
.sphx-glr-thumbcontainer img {
display: inline;
max-height: 112px;
max-width: 160px;
}
.sphx-glr-thumbcontainer[tooltip]:hover:after {
background: rgba(0, 0, 0, 0.8);
-webkit-border-radius: 5px;
-moz-border-radius: 5px;
border-radius: 5px;
color: #fff;
content: attr(tooltip);
left: 95%;
padding: 5px 15px;
position: absolute;
z-index: 98;
width: 220px;
bottom: 52%;
}
.sphx-glr-thumbcontainer[tooltip]:hover:before {
border: solid;
border-color: #333 transparent;
border-width: 18px 0 0 20px;
bottom: 58%;
content: '';
left: 85%;
position: absolute;
z-index: 99;
}

.sphx-glr-script-out {
color: #888;
margin: 0;
}
p.sphx-glr-script-out {
padding-top: 0.7em;
}
.sphx-glr-script-out .highlight {
background-color: transparent;
margin-left: 2.5em;
margin-top: -2.1em;
}
.sphx-glr-script-out .highlight pre {
background-color: #fafae2;
border: 0;
max-height: 30em;
overflow: auto;
padding-left: 1ex;
margin: 0px;
word-break: break-word;
}
.sphx-glr-script-out + p {
margin-top: 1.8em;
}
blockquote.sphx-glr-script-out {
margin-left: 0pt;
}
.sphx-glr-script-out.highlight-pytb .highlight pre {
color: #000;
background-color: #ffe4e4;
border: 1px solid #f66;
margin-top: 10px;
padding: 7px;
}

div.sphx-glr-footer {
text-align: center;
}

div.sphx-glr-download {
margin: 1em auto;
vertical-align: middle;
}

div.sphx-glr-download a {
background-color: #ffc;
background-image: linear-gradient(to bottom, #FFC, #d5d57e);
border-radius: 4px;
border: 1px solid #c2c22d;
color: #000;
display: inline-block;
font-weight: bold;
padding: 1ex;
text-align: center;
}

div.sphx-glr-download code.download {
display: inline-block;
white-space: normal;
word-break: normal;
overflow-wrap: break-word;
/* border and background are given by the enclosing 'a' */
border: none;
background: none;
}

div.sphx-glr-download a:hover {
box-shadow: inset 0 1px 0 rgba(255,255,255,.1), 0 1px 5px rgba(0,0,0,.25);
text-decoration: none;
background-image: none;
background-color: #d5d57e;
}

.sphx-glr-example-title > :target::before {
display: block;
content: "";
margin-top: -50px;
height: 50px;
visibility: hidden;
}

ul.sphx-glr-horizontal {
list-style: none;
padding: 0;
}
ul.sphx-glr-horizontal li {
display: inline;
}
ul.sphx-glr-horizontal img {
height: auto !important;
}

.sphx-glr-single-img {
margin: auto;
display: block;
max-width: 100%;
}

.sphx-glr-multi-img {
max-width: 42%;
height: auto;
}

p.sphx-glr-signature a.reference.external {
-moz-border-radius: 5px;
-webkit-border-radius: 5px;
border-radius: 5px;
padding: 3px;
font-size: 75%;
text-align: right;
margin-left: auto;
display: table;
}

.sphx-glr-clear{
clear: both;
}

a.sphx-glr-backref-instance {
text-decoration: none;
}
12 changes: 12 additions & 0 deletions docs/_static/style.css
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
.wy-nav-content {
max-width: 90% !important;
}

.wy-side-scroll {
background:#8c8c8c;
}

.pre
{
color:#BE8184;
}
41 changes: 41 additions & 0 deletions docs/_templates/autosummary/class.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
{#
The general principle of this is that we manually document attributes here in
the same file, but give all methods their own page. By default, we document
all methods, including those defined by parent classes.
-#}

{{ objname | escape | underline }}

.. currentmodule:: {{ module }}

.. autoclass:: {{ objname }}
{#-
Avoid having autodoc populate the class with the members we're about to
summarize to avoid duplication.
#}
:no-members:
:show-inheritance:
{#
Methods all get their own separate page, with their names and the first lines
of their docstrings tabulated. The documentation from `__init__` is
automatically included in the standard class documentation, so we don't want
to repeat it.
-#}
{% block methods_summary %}{% set wanted_methods = (methods | reject('==', '__init__') | list) %}{% if wanted_methods %}
.. rubric:: Methods

.. autosummary::
:nosignatures:
:toctree: ../apiref/
{% for item in wanted_methods %}
~{{ name }}.{{ item }}
{%- endfor %}
{% endif %}{% endblock %}

{% block attributes_summary %}{% if attributes %}
.. rubric:: Attributes
{# Attributes should all be summarized directly on the same page. -#}
{% for item in attributes %}
.. autoattribute:: {{ item }}
{%- endfor %}
{% endif %}{% endblock -%}
Loading