Fix APA and docutills issue #207
Merged
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
The prior method for using APA referencing pinned
docutils==0.17.1, which was causing virtual environments to not resolve in some cases (unclear why, but it had to do with low versions of sphinx being endlessly attempted).Rather than solve dependency issues, we choose to unpin docutils, which will cause brackets
[]to appear for each item on the references page. It is easier to remove these with CSS customization than.This fix was originally created by @douden in repo https://github.com/TeachBooks/apa-test as commits TeachBooks/apa-test@704d04e
and TeachBooks/apa-test@fa80deaThe fix is being implemented in this Manual (as it uses refernces) and the APA page is being updated to document and recommend the new fix.
The fix hides any span element with the class label (e.g., every
<span class="label">.....</span>). We hope it doesn't cause issues elsewhere.The fix will be released as a sphinx extension in the future, with a possible improvement on how the brackets are hidden.