Improved templates: GuiCommand and TutorialInfo

Discussions about the wiki documentation of FreeCAD and its translation.
Post Reply
User avatar
Roy_043
Posts: 3749
Joined: Thu Dec 27, 2018 12:28 pm

Improved templates: GuiCommand and TutorialInfo

Post by Roy_043 »

I have made some modifications to Template:GuiCommand and Template:TutorialInfo:

GuiCommand:
  1. Removed the dummy icon. If the Name icon is not found no icon is shown. There is no need to add Empty=1. But Empty=1 can still be used to suppress the Name icon (which is rarely required of course).
  2. Empty optional parameters can be left in place without affecting the layout. So there is no longer a need to delete f.e. SeeAlso=.
  3. The categories in the template are now translatable. This has the advantage that semi-translated pages that still reference this template no longer end up in https://wiki.freecadweb.org/Category:Command_Reference. This has reduced the list from ca. 3600 to ca. 1000 entries, making it more usable.
TutorialInfo:
  1. Updated the icon to SVG.
  2. Empty optional parameters can be left in place without affecting the layout. See above.
  3. The categories in the template are now translatable. See above.
I have removed the usage info from the translated templates. Duplicating this info, or even translating it, seem unnecessary to me. A link to the main, untranslated, template is enough.
Post Reply