Activities/Help/Contribute: Difference between revisions
No edit summary |
|||
| (3 intermediate revisions by the same user not shown) | |||
| Line 21: | Line 21: | ||
Users actively involved, who are prepared to review the work of contributors: | Users actively involved, who are prepared to review the work of contributors: | ||
[[User: | * [[User:Quozl]] | ||
Please add | Please add your name ... | ||
== TODO == | == TODO == | ||
| Line 93: | Line 93: | ||
You can install it in your development environment doing: | You can install it in your development environment doing: | ||
cd | cd help-activity | ||
./setup.py dev | ./setup.py dev | ||
(if you have the activity already installed, uninstall it first) | (if you have the activity already installed, uninstall it first) | ||
| Line 107: | Line 107: | ||
* In any other Linux environment | * In any other Linux environment | ||
The output | The output directory {{Code|html/}}, and is opened by opening | ||
index.html in a browser, it is easy to see the changes as you work. | {{Code|html/index.html}} in a browser, so it is easy to see the changes as you work. | ||
== Further reading == | == Further reading == | ||
| Line 130: | Line 130: | ||
b. or in the event you wish to make changes to the index, over and above, adding a new line to the bottom a table of contents as described in the tutorials, | b. or in the event you wish to make changes to the index, over and above, adding a new line to the bottom a table of contents as described in the tutorials, | ||
you may delete all the output files, that is, {{Code|~/ | you may delete all the output files, that is, {{Code|~/help-activity/html/}} and {{Code|~/help-activity/doctrees/}}. They will be regenerated by {{Code|make html}}. | ||
=== Reconfigure Help to show View source === | === Reconfigure Help to show View source === | ||
| Line 136: | Line 136: | ||
In Sugar as we already have a View source button in the Frame. | In Sugar as we already have a View source button in the Frame. | ||
If you are working with the Help software in a browser, you can add a ''View source'' button, which will appear in the navigation panel. You need to alter three lines in {{Code|~/ | If you are working with the Help software in a browser, you can add a ''View source'' button, which will appear in the navigation panel. You need to alter three lines in {{Code|~/help-activity/source/conf.py}}. Each of the entries listed below comprise a comment line, starting with a "#" followed by the code line. Find each pair of lines in {{Code|conf.py}} and change the value in the code line like this. | ||
# Custom sidebar templates, maps document names to template names. ## Edit: Sugar default is without 'sourcelink.html' | # Custom sidebar templates, maps document names to template names. ## Edit: Sugar default is without 'sourcelink.html' | ||