summaryrefslogtreecommitdiffstats
path: root/doc/tools
Commit message (Collapse)AuthorAgeFilesLines
* Adds a meta on top of every generated class to hide 'Edit on Github' linkStraToN2019-07-251-0/+1
| | | | Linked docs issue https://github.com/godotengine/godot-docs/pull/2656
* Add default values to the editor help, docs, and generated RSTBojidar Marinov2019-06-271-39/+46
| | | | | Also, make spacing of "=" in the editor help a bit more consistent. Closes #16086
* makerst: Fix format of [url] links in reSTRémi Verschelde2019-06-111-21/+26
| | | | | | Moved some logic to make_url in an attempt to reuse it in the parser, but it proved too complex so I ended up not using it. I kept it as a separate method nevertheless.
* Add support for [url=] tag to makerst.pyStanislav2019-05-161-2/+13
| | | | Fixes #28904
* doc: Drop unused <demos> tagRémi Verschelde2019-04-191-1/+1
|
* Remove unused importsHendrikto2019-04-061-2/+1
|
* ClassRef: Replace [code]CurrentClass[/code] with [CurrentClass]Ignacio Etcheverry2019-03-291-1/+5
| | | | Modified makerst to generate code tags for these to avoid hyperlinks to the same class.
* EditorHelp, makerst: Improve enum ref resolving and constant ref supportIgnacio Etcheverry2019-03-291-7/+21
| | | | | Enum reference resolving will now search in the @GlobalScope if no class is specified and the enum cannot be resolved in the current class. Added support for constant references in EditorHelp, e.g.: [constant KEY_ENTER] or [constant Control.FOCUS_CLICK]. It supports enum constants (the enum name must not be included).
* doc: Fix style for vararg in makerstRémi Verschelde2019-03-101-1/+1
|
* makerst: make vararg methods look the same as in editor helpmerumelu2019-03-051-0/+6
|
* makerst.py refactor.Pieter-Jan Briers2018-12-281-353/+601
| | | | | | | | | | | | | | | It's now smart and keeps track of every entity in the doc files. Now it can pick up on broken references and such inside the doc files. Eventually we'll be able to run it on Travis and check for errors automatically. General file cleanup. References to elements of classes now have a prefix for their type. class_Control_minimum_size_changed becomes class_Control_method_minimum_size_changed, or signal_, because the reason I did this was to fix reference conflicts. You can also reference constants now with BBCode. Also made it use argparse, adding an --output and a --dry-run argument. I did not fix all the errors it's reporting in the documentation files, there's about 150+ of them but that's outside of the scope of this commit.
* Clean up & improve makerst.pyPieter-Jan Briers2018-12-271-171/+169
| | | | | | | | | | | | | | Man this file even had some semicolons in it. I cleaned up the entire file, while it's still pretty ugly it's much better now. I also added type checks so it passes mypy --strict. make_type now throws a warning on unresolved type references, which there are a bunch of. I'm not responsible for fixing those though. Also some more hardening against crashes. For example XML tags without content won't cause crashes now. Functionality has not been modified as far as I can tell. Update Makefile for Python 3 Fix ordering issues related to enums & constants
* Enabled rst files to escape for parentheses after bracketsJoão Álvaro Ferreira2018-12-111-1/+1
|
* doc: Use HTTPS for docs.godotengine.org and point to latest branchRémi Verschelde2018-11-051-2/+2
| | | | Fixes #23509.
* Dont use equality operators with None singleton in python fileslupoDharkael2018-10-272-5/+5
|
* Add extra newline after enum members and constants, to ensure they'll format ↵LikeLakers22018-10-021-4/+2
| | | | properly after a multi-line description
* doc: Drop obsolete makemd.py, dates back to GitHub Wiki daysRémi Verschelde2018-10-021-360/+0
| | | | | It has not been kept in sync with makerst.py, so it does not serve much purpose nowadays.
* doc: Fixes to rst converterRémi Verschelde2018-09-211-7/+8
|
* Fix the weird method linking issue when the previous method's description ↵LikeLakers22018-09-201-1/+1
| | | | ends with a code block
* doc: Make property sections in rst similar to editor docsRémi Verschelde2018-09-131-69/+98
| | | | | | | | | There is now an overview table with hyperlinks, and further down a detailed list of properties with their setter/getter and description. Theme items are now also included in the rst output. Refactored make_method() a bit.
* Doc: Use PascalCase names in hyperlinksRémi Verschelde2018-09-131-2/+2
| | | | | | We were not consistently applying .lower() every time we construct an hyperlink, so there would be case mismatch. It works fine to keep the natural case for those links.
* Doc: Use same headers and order in-editor and onlineRémi Verschelde2018-09-121-38/+57
|
* Add support for tutorial links to makerst.pyrobojumper2018-06-121-0/+30
| | | | Also change the <tutorials> structure to make use of individual <link> tags
* makerst.py: Properly escape \ for rstRémi Verschelde2018-05-311-1/+11
| | | | Fixes godotengine/godot-docs#1486.
* Makes doc methods display enums.Pieter-Jan Briers2018-05-121-9/+28
|
* Properly closing all files in Python codeViktor Ferenczi2018-03-112-0/+7
|
* fixed md scriptYan Pas2018-02-181-8/+13
|
* Documentation tool does not add escapes to code and codeblocksAnish2018-02-161-4/+26
| | | | | | | Instead of adding the escapes to all * and _ the tool now excludes the characters inside [code] and [codeblock]. Resolves: #15156
* Enums get listed in the docs and enum members now also link to theJoachim Meyer2017-12-221-2/+43
| | | | | corresponding enum in the webdocs Fixes #13254
* doc status: Partial revert of e23454d, setgets are no longer listedRémi Verschelde2017-11-241-18/+2
|
* Fix the class docs for the rst-syntax errors.Martin Capitanio2017-11-191-0/+1
| | | | | | | | | | | | | | | | | | | | | | | - Generate a correkt rst-syntax for the [/code] inline markup. (http://www.sphinx-doc.org/en/1.6.5/rest.html#inline-markup) - Fix xml souce bugs for the sphinx's rst syntax werrors: class_area.rst:319: WARNING: Inline literal start-string without end-string. class_area2d.rst:287: WARNING: Inline literal start-string without end-string. class_audioserver.rst:287: WARNING: Inline literal start-string without end-string. class_control.rst:509: WARNING: Inline literal start-string without end-string. class_image.rst:422: WARNING: Inline literal start-string without end-string. class_image.rst:434: WARNING: Inline literal start-string without end-string. class_inputevent.rst:74: WARNING: Inline literal start-string without end-string. class_inputeventaction.rst:45: WARNING: Inline literal start-string without end-string. class_inputmap.rst:47: WARNING: Inline literal start-string without end-string. class_kinematicbody.rst:80: WARNING: Inline interpreted text or phrase reference start-string without end-string. class_kinematicbody2d.rst:80: WARNING: Inline interpreted text or phrase reference start-string without end-string. class_line2d.rst:182: WARNING: Inline literal start-string without end-string. class_thread.rst:51: WARNING: Inline literal start-string without end-string. class_treeitem.rst:160: WARNING: Inline literal start-string without end-string.
* Fix class docs, improve error handling of the rst generator.Martin Capitanio2017-11-181-3/+7
| | | | | | | | | | The rst-generator gives you now a hint what's going on: Bad reference: 'method.RegEx.search_all' in file: ../modules/regex/doc_classes/RegExMatch.xml grep 'method.RegEx.search_all' ../modules/regex/doc_classes/RegExMatch.xml Contains the results of a single regex match returned by [method RegEx.search] and [method.RegEx.search_all]. It can be used to find the position and range of the match and its capturing groups, and it can extract its sub-string for you.
* makerst: Remove stray spaces in method signaturesRémi Verschelde2017-10-211-6/+2
|
* makerst: Add support for [member] and [signal]Rémi Verschelde2017-10-211-2/+5
| | | | Part of #11137. [enum] is still missing, and none are implemented in the engine itself yet.
* makerst: Fix rst-ization of members and escaping of [Class]sRémi Verschelde2017-10-211-2/+12
| | | | Fixes #11517.
* Merge pull request #12053 from Grosskopf/audiodocs-fixRémi Verschelde2017-10-191-5/+6
|\ | | | | filtering getters&setters over strings works for AudioStreamPlayer*
| * filtering getters&setters over strings works for AudioStreamPlayer*Grosskopf2017-10-151-5/+6
| |
* | makerst: Fix support for module classesRémi Verschelde2017-10-141-12/+8
|/ | | | | | | | | Previous code expected only one XML per module, which is not the case for e.g. mono or gdnative. Also add newline after signal description to fix rst warning, and make the script Python 3-compatible. [ci skip]
* doc_status.py: Error message for unknown CLI flag, switch shebang to pythonmhilbrunner2017-10-071-12/+16
|
* doc_status.py: Add -e (--empty) option to hide items with nothing left to domhilbrunner2017-10-031-0/+15
|
* Merge pull request #11757 from mhilbrunner/doc_status_py27Andreas Haas2017-10-021-4/+14
|\ | | | | doc_status.py Python 2.7 backwards compatibility & Windows support
| * doc_status.py Python 2.7 backwards compatibilitymhilbrunner2017-10-011-4/+14
| |
* | Merge pull request #11654 from bojidar-bg/docstatus-fnmatchPoommetee Ketson2017-10-021-5/+8
|\ \ | |/ |/| Allow using wildcards to filter docstatus class names
| * Allow using wildcards to filter docstatus class namesBojidar Marinov2017-09-281-5/+8
| | | | | | | | [ci skip]
* | makerst.py: Support split classes XML and use folders and/or single files as ↵Alexander Meerhoff2017-09-231-24/+30
| | | | | | | | | | | | | | | | | | input The new syntax is (from `doc/`): `tools/makerst.py classes/ ../modules/`. Also adapted `make rst` target accordingly. [ci skip]
* | Make doc_status output a bit more markdown-friendly, hide some printsBojidar Marinov2017-09-161-4/+7
|/
* Update doc status generator.Daniel J. Ramirez2017-09-151-13/+30
| | | | [ciskip]
* Docs: ignore tags inside code,codeblock tagPoommetee Ketson2017-07-221-8/+17
|
* Add Signals descriptions when they exist.Julian Murgia2017-06-142-0/+12
|
* Doc: Drop unmainted converters for html, textile, dokuwikiRémi Verschelde2017-05-066-1825/+0
|