Add sphinx to the documentation section #319
Closed
+79
−71
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sphinx is already described under tech/languages/python/sphinx,
but IMHO it should be available even through documentation/sphinx.
There is a question, how to do it. YAML `section` property is only
string not list, but even then, the file structure wouldn't
correspond. Copy-pasting is just bad and `relative_import` macro
doesn't support ../ path.
Therefore I've created `sphinx_content.md` file and symlinked it,
so it is available for both
tech/languages/python/sphinx.md
start/tips/documentation/sphinx.md
|
Good Idea, but symlinks in Jekyll have to be created differently. Please keep one page, and symlink the other(explained in this Issue). |
|
Please make appropriate changes. |
|
Please give it a look, so we can merge it (it does not have to be perfect, just give it a byte of love). Note: The release will be soon (~1-2weeks), and after that there will be maintenance (decomissioning) of the release infrastucture(no updates for some time). The website updates still need some manual handling, but openshift will change that. |
|
Ping... @FrostyX Are you still interested in advancing with this PR? |
|
Sorry guys for keeping the PR hanging here. I am closing since I don't have the time to finish it now. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Sphinx is already described under tech/languages/python/sphinx,
but IMHO it should be available even through documentation/sphinx.
There is a question, how to do it. YAML
sectionproperty is onlystring not list, but even then, the file structure wouldn't
correspond. Copy-pasting is just bad and
relative_importmacrodoesn't support ../ path.
Therefore I've created
sphinx_content.mdfile and symlinked it,so it is available for both