1038 lines
72 KiB
HTML
1038 lines
72 KiB
HTML
<html><head><title>Editing</title><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><link type='text/css' href='wiki.css' rel='stylesheet'></head><body><h1>Editing</h1><span class="mw-redirectedfrom">(Redirected from <a href="https://www.freecadweb.org/wiki/index.php?title=Editing&redirect=no" class="mw-redirect" title="Editing">Editing</a>)</span></div>
|
||
|
||
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><div class="mw-parser-output"><div style="clear:right; margin-bottom: .5em; float: right; padding: .5em 0 .8em 1.4em; background: none;"><div id="toc" class="toc"><div class="toctitle"><h2>Contents</h2></div>
|
||
<ul>
|
||
<li class="toclevel-1 tocsection-1"><a href="#Before_Starting"><span class="tocnumber">1</span> <span class="toctext">Before Starting</span></a></li>
|
||
<li class="toclevel-1 tocsection-2"><a href="#General_Guidelines"><span class="tocnumber">2</span> <span class="toctext">General Guidelines</span></a>
|
||
<ul>
|
||
<li class="toclevel-2 tocsection-3"><a href="#Concise_Descriptions"><span class="tocnumber">2.1</span> <span class="toctext">Concise Descriptions</span></a></li>
|
||
<li class="toclevel-2 tocsection-4"><a href="#Centralized_Information"><span class="tocnumber">2.2</span> <span class="toctext">Centralized Information</span></a></li>
|
||
<li class="toclevel-2 tocsection-5"><a href="#Styling"><span class="tocnumber">2.3</span> <span class="toctext">Styling</span></a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-1 tocsection-6"><a href="#Examples"><span class="tocnumber">3</span> <span class="toctext">Examples</span></a></li>
|
||
<li class="toclevel-1 tocsection-7"><a href="#Structure"><span class="tocnumber">4</span> <span class="toctext">Structure</span></a>
|
||
<ul>
|
||
<li class="toclevel-2 tocsection-8"><a href="#General"><span class="tocnumber">4.1</span> <span class="toctext">General</span></a></li>
|
||
<li class="toclevel-2 tocsection-9"><a href="#Page_Names"><span class="tocnumber">4.2</span> <span class="toctext">Page Names</span></a>
|
||
<ul>
|
||
<li class="toclevel-3 tocsection-10"><a href="#Bad_name"><span class="tocnumber">4.2.1</span> <span class="toctext">Bad name</span></a></li>
|
||
<li class="toclevel-3 tocsection-11"><a href="#Good_name"><span class="tocnumber">4.2.2</span> <span class="toctext">Good name</span></a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-2 tocsection-12"><a href="#Links"><span class="tocnumber">4.3</span> <span class="toctext">Links</span></a>
|
||
<ul>
|
||
<li class="toclevel-3 tocsection-13"><a href="#Bad_link"><span class="tocnumber">4.3.1</span> <span class="toctext">Bad link</span></a></li>
|
||
<li class="toclevel-3 tocsection-14"><a href="#So-so_link"><span class="tocnumber">4.3.2</span> <span class="toctext">So-so link</span></a></li>
|
||
<li class="toclevel-3 tocsection-15"><a href="#Good_link"><span class="tocnumber">4.3.3</span> <span class="toctext">Good link</span></a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-2 tocsection-16"><a href="#Workbench_pages"><span class="tocnumber">4.4</span> <span class="toctext">Workbench pages</span></a></li>
|
||
<li class="toclevel-2 tocsection-17"><a href="#Command_.28tool.29_pages"><span class="tocnumber">4.5</span> <span class="toctext">Command (tool) pages</span></a></li>
|
||
<li class="toclevel-2 tocsection-18"><a href="#Tutorials"><span class="tocnumber">4.6</span> <span class="toctext">Tutorials</span></a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-1 tocsection-19"><a href="#Language"><span class="tocnumber">5</span> <span class="toctext">Language</span></a>
|
||
<ul>
|
||
<li class="toclevel-2 tocsection-20"><a href="#Expressions"><span class="tocnumber">5.1</span> <span class="toctext">Expressions</span></a></li>
|
||
<li class="toclevel-2 tocsection-21"><a href="#Conciseness"><span class="tocnumber">5.2</span> <span class="toctext">Conciseness</span></a>
|
||
<ul>
|
||
<li class="toclevel-3 tocsection-22"><a href="#Bad_description"><span class="tocnumber">5.2.1</span> <span class="toctext">Bad description</span></a></li>
|
||
<li class="toclevel-3 tocsection-23"><a href="#Good_description"><span class="tocnumber">5.2.2</span> <span class="toctext">Good description</span></a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-1 tocsection-24"><a href="#Style"><span class="tocnumber">6</span> <span class="toctext">Style</span></a>
|
||
<ul>
|
||
<li class="toclevel-2 tocsection-25"><a href="#Templates"><span class="tocnumber">6.1</span> <span class="toctext">Templates</span></a></li>
|
||
<li class="toclevel-2 tocsection-26"><a href="#Code"><span class="tocnumber">6.2</span> <span class="toctext">Code</span></a>
|
||
<ul>
|
||
<li class="toclevel-3 tocsection-27"><a href="#Example_of_bad_code_description"><span class="tocnumber">6.2.1</span> <span class="toctext">Example of bad code description</span></a></li>
|
||
<li class="toclevel-3 tocsection-28"><a href="#Example_of_good_code_description"><span class="tocnumber">6.2.2</span> <span class="toctext">Example of good code description</span></a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-1 tocsection-29"><a href="#Graphics_content"><span class="tocnumber">7</span> <span class="toctext">Graphics content</span></a>
|
||
<ul>
|
||
<li class="toclevel-2 tocsection-30"><a href="#General_2"><span class="tocnumber">7.1</span> <span class="toctext">General</span></a></li>
|
||
<li class="toclevel-2 tocsection-31"><a href="#Screen_capture"><span class="tocnumber">7.2</span> <span class="toctext">Screen capture</span></a>
|
||
<ul>
|
||
<li class="toclevel-3 tocsection-32"><a href="#Text"><span class="tocnumber">7.2.1</span> <span class="toctext">Text</span></a>
|
||
<ul>
|
||
<li class="toclevel-4 tocsection-33"><a href="#Good_picture_text_dimension"><span class="tocnumber">7.2.1.1</span> <span class="toctext">Good picture text dimension</span></a></li>
|
||
<li class="toclevel-4 tocsection-34"><a href="#Bad_picture_text_dimension"><span class="tocnumber">7.2.1.2</span> <span class="toctext">Bad picture text dimension</span></a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-2 tocsection-35"><a href="#Icons_and_graphics"><span class="tocnumber">7.3</span> <span class="toctext">Icons and graphics</span></a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-1 tocsection-36"><a href="#Models"><span class="tocnumber">8</span> <span class="toctext">Models</span></a></li>
|
||
<li class="toclevel-1 tocsection-37"><a href="#Translations"><span class="tocnumber">9</span> <span class="toctext">Translations</span></a></li>
|
||
<li class="toclevel-1 tocsection-38"><a href="#Some_tips_for_translators"><span class="tocnumber">10</span> <span class="toctext">Some tips for translators</span></a>
|
||
<ul>
|
||
<li class="toclevel-2 tocsection-39"><a href="#Setting_Docnav"><span class="tocnumber">10.1</span> <span class="toctext">Setting Docnav</span></a></li>
|
||
<li class="toclevel-2 tocsection-40"><a href="#Using_special_pages"><span class="tocnumber">10.2</span> <span class="toctext">Using special pages</span></a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-1 tocsection-41"><a href="#Robots"><span class="tocnumber">11</span> <span class="toctext">Robots</span></a></li>
|
||
<li class="toclevel-1 tocsection-42"><a href="#Discussion"><span class="tocnumber">12</span> <span class="toctext">Discussion</span></a></li>
|
||
<li class="toclevel-1 tocsection-43"><a href="#Brainstorming"><span class="tocnumber">13</span> <span class="toctext">Brainstorming</span></a>
|
||
<ul>
|
||
<li class="toclevel-2 tocsection-44"><a href="#Workflow.2C_Roadmap"><span class="tocnumber">13.1</span> <span class="toctext">Workflow, Roadmap</span></a>
|
||
<ul>
|
||
<li class="toclevel-3 tocsection-45"><a href="#Content_and_Appearance:"><span class="tocnumber">13.1.1</span> <span class="toctext">Content and Appearance:</span></a></li>
|
||
<li class="toclevel-3 tocsection-46"><a href="#Templates_2"><span class="tocnumber">13.1.2</span> <span class="toctext">Templates</span></a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-2 tocsection-47"><a href="#Forum"><span class="tocnumber">13.2</span> <span class="toctext">Forum</span></a></li>
|
||
<li class="toclevel-2 tocsection-48"><a href="#Documentation_structure:"><span class="tocnumber">13.3</span> <span class="toctext">Documentation structure:</span></a></li>
|
||
<li class="toclevel-2 tocsection-49"><a href="#Documentation_schemes"><span class="tocnumber">13.4</span> <span class="toctext">Documentation schemes</span></a></li>
|
||
<li class="toclevel-2 tocsection-50"><a href="#Repository"><span class="tocnumber">13.5</span> <span class="toctext">Repository</span></a></li>
|
||
<li class="toclevel-2 tocsection-51"><a href="#Who_are_the_users:"><span class="tocnumber">13.6</span> <span class="toctext">Who are the users:</span></a></li>
|
||
<li class="toclevel-2 tocsection-52"><a href="#What_the_users_needs:"><span class="tocnumber">13.7</span> <span class="toctext">What the users needs:</span></a></li>
|
||
<li class="toclevel-2 tocsection-53"><a href="#Translations_2"><span class="tocnumber">13.8</span> <span class="toctext">Translations</span></a></li>
|
||
<li class="toclevel-2 tocsection-54"><a href="#Some_notes_taken_from_the_forum"><span class="tocnumber">13.9</span> <span class="toctext">Some notes taken from the forum</span></a></li>
|
||
<li class="toclevel-2 tocsection-55"><a href="#Examples_of_CAD_documentation"><span class="tocnumber">13.10</span> <span class="toctext">Examples of CAD documentation</span></a></li>
|
||
<li class="toclevel-2 tocsection-56"><a href="#Next_actions"><span class="tocnumber">13.11</span> <span class="toctext">Next actions</span></a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-1 tocsection-57"><a href="#Terminology_-_Naming_policy"><span class="tocnumber">14</span> <span class="toctext">Terminology - Naming policy</span></a>
|
||
<ul>
|
||
<li class="toclevel-2 tocsection-58"><a href="#English"><span class="tocnumber">14.1</span> <span class="toctext">English</span></a></li>
|
||
<li class="toclevel-2 tocsection-59"><a href="#Other_languages"><span class="tocnumber">14.2</span> <span class="toctext">Other languages</span></a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-1 tocsection-60"><a href="#Start_Center"><span class="tocnumber">15</span> <span class="toctext">Start Center</span></a></li>
|
||
<li class="toclevel-1 tocsection-61"><a href="#Sandbox_for_Macro_Dimensions"><span class="tocnumber">16</span> <span class="toctext">Sandbox for Macro Dimensions</span></a>
|
||
<ul>
|
||
<li class="toclevel-2 tocsection-62"><a href="#Description"><span class="tocnumber">16.1</span> <span class="toctext">Description</span></a></li>
|
||
<li class="toclevel-2 tocsection-63"><a href="#How_to_install"><span class="tocnumber">16.2</span> <span class="toctext">How to install</span></a></li>
|
||
<li class="toclevel-2 tocsection-64"><a href="#Start"><span class="tocnumber">16.3</span> <span class="toctext">Start</span></a></li>
|
||
<li class="toclevel-2 tocsection-65"><a href="#Use"><span class="tocnumber">16.4</span> <span class="toctext">Use</span></a></li>
|
||
<li class="toclevel-2 tocsection-66"><a href="#Limitations_and_things_to_improve"><span class="tocnumber">16.5</span> <span class="toctext">Limitations and things to improve</span></a></li>
|
||
<li class="toclevel-2 tocsection-67"><a href="#Script"><span class="tocnumber">16.6</span> <span class="toctext">Script</span></a></li>
|
||
<li class="toclevel-2 tocsection-68"><a href="#Links_2"><span class="tocnumber">16.7</span> <span class="toctext">Links</span></a></li>
|
||
<li class="toclevel-2 tocsection-69"><a href="#Other_similar_instruments"><span class="tocnumber">16.8</span> <span class="toctext">Other similar instruments</span></a></li>
|
||
</ul>
|
||
</li>
|
||
<li class="toclevel-1 tocsection-70"><a href="#Sandbox_for_PartDesign_Fillet"><span class="tocnumber">17</span> <span class="toctext">Sandbox for PartDesign Fillet</span></a>
|
||
<ul>
|
||
<li class="toclevel-2 tocsection-71"><a href="#Links_3"><span class="tocnumber">17.1</span> <span class="toctext">Links</span></a></li>
|
||
<li class="toclevel-2 tocsection-72"><a href="#Others"><span class="tocnumber">17.2</span> <span class="toctext">Others</span></a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</div>
|
||
</div>
|
||
<p>This page gives common guidelines on the best practices to be followed when writing or updating FreeCAD documentation.
|
||
</p><p>It also has the goal to bring together the threads that are dispersed in the forum and try to make order, being a single point of reference for FreeCAD documentation discussion and brainstorming, to better organize the wiki.
|
||
</p>
|
||
<h2><span class="mw-headline" id="Before_Starting">Before Starting</span></h2>
|
||
<p>Editing wiki pages is easy. Before starting editing FreeCAD wiki pages, be sure to be familiar with the <a href="https://www.freecadweb.org/wiki/index.php?title=Help:Editing" title="Help:Editing">Wiki editing basics</a>.
|
||
</p>
|
||
<h2><span class="mw-headline" id="General_Guidelines">General Guidelines</span></h2>
|
||
<h3><span class="mw-headline" id="Concise_Descriptions">Concise Descriptions</span></h3>
|
||
<p>When describing FreeCAD functionality try to be concise and to the point. Also, please describe what FreeCAD does, <b>NOT</b> what FreeCAD does not do. There might be exceptions for justifying why FreeCAD does not support a certain functionality, in case for instance there is a different philosophy or way to achieve the result with respect to traditional CAD systems, but these cases must be the exception.
|
||
</p>
|
||
<h3><span class="mw-headline" id="Centralized_Information">Centralized Information</span></h3>
|
||
<p>Ideally, you should try to avoid duplicating the same information in different places. While it is simple to copy & paste some text, it will eventually lead to misaligned information when a page is updated and the other not. You should insert the information in one place only, and make reference to this single point.
|
||
</p><p>A possible solution for the above problem is the use of templates and transclusions (see <a href="/wiki/Help:Editing#Templates_and_transcluding_pages" title="Help:Editing">Templates and transcluding pages</a> if you are not familiar with this concept), but their usage for this goal is strongly discouraged. The reason is that in the printed manual created from the Wiki help you will have the same information printed over and over again; but even a reader using the Wiki can be confused by finding the same text in different pages.
|
||
In case you need the same explanations in more than one point of the documentation, please consider creating a new page topic, and make explicit references (links) to this page.
|
||
</p>
|
||
<h3><span class="mw-headline" id="Styling">Styling</span></h3>
|
||
<p><a href="#Templates">Templates</a> are heavily used, instead, for styling the text. For instance, there is a template for styling menu commands, like <b>File->Save</b>, another template to style keys to be pressed, like <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">SHIFT</span>, etc.. This allows to have a consistent look and feel of the documentation, as well as to be able to update the style by simply changing the template. Please get familiar with the <a href="#Templates">templates</a> used in FreeCAD Wiki Help documentation before writing help pages.
|
||
</p>
|
||
<h2><span class="mw-headline" id="Examples">Examples</span></h2>
|
||
<p>Working by examples will help you keep the right track, and be ahead on the learning curve. So even if reading the following sections is highly recommended, you can quickly get familiar with the structure and style of FreeCAD wiki looking at the following pages, that can be considered reference for best style practices of FreeCAD documentation.
|
||
</p><p>If you are consistent with this look & feel, you won't be far from a correct FreeCAD documentation page, and your contribution will blend more easily in the wiki.
|
||
</p>
|
||
<ul><li> <a href="Draft_ShapeString.html" title="Draft ShapeString">Draft ShapeString</a></li>
|
||
<li> <a href="Draft_Line.html" title="Draft Line">Draft Line</a></li></ul>
|
||
<h2><span class="mw-headline" id="Structure">Structure</span></h2>
|
||
<h3><span class="mw-headline" id="General">General</span></h3>
|
||
<p>You should normally not use a <b>=header=</b> for a page, since the page title is automatically added.
|
||
</p><p>The User's hub provides a <a href="Online_Help_Toc.html" title="Online Help Toc">Table of Contents</a>. This is used as the main reference for (automatically) building the offline help you can reach from FreeCAD, as well as the offline pdf documentation. The <a href="https://www.freecadweb.org/wiki/index.php?title=Template:Docnav" title="Template:Docnav">Template:Docnav</a>, which is used to link a page with the previous and the next page of the same section (see <a href="#Templates">#Templates</a> section below for a list of all templates, including <a href="https://www.freecadweb.org/wiki/index.php?title=Template:Docnav" title="Template:Docnav">Docnav</a>) should be aligned with the structure in the <a href="Online_Help_Toc.html" title="Online Help Toc">Table of Contents</a>.
|
||
</p>
|
||
<h3><span class="mw-headline" id="Page_Names">Page Names</span></h3>
|
||
<p>Page names should be short, and every word should begin with a capital letter, unless they are articles, prepositions, conjunctions (e.g. 'of', 'on', 'and')
|
||
</p>
|
||
<h4><span class="mw-headline" id="Bad_name">Bad name</span></h4>
|
||
<p><a href="https://www.freecadweb.org/wiki/index.php?title=Working_with_architecture_walls&action=edit&redlink=1" class="new" title="Working with architecture walls (page does not exist)">Working with architecture walls</a>
|
||
</p>
|
||
<h4><span class="mw-headline" id="Good_name">Good name</span></h4>
|
||
<p><a href="Arch_Wall.html" title="Arch Wall">Arch Wall</a>
|
||
</p><p><br />
|
||
Workbench pages must have the format <b>XYZ Workbench</b>, where <b>XYZ</b> is the name of the referred workbench.
|
||
</p><p>Pages describing the tools of a workbench must have the format <b>XYZ MyTool</b>, where <b>MyTool</b> is the name of the specific tool.
|
||
</p>
|
||
<h3><span class="mw-headline" id="Links">Links</span></h3>
|
||
<p>You should use the original link name for the links whenever possible. This clarifies the referenced chapter in printed / pdf documentation. You must anyway avoid the usage of non-meaningful words for the link.
|
||
</p>
|
||
<h4><span class="mw-headline" id="Bad_link">Bad link</span></h4>
|
||
<p>For more information on this topic, click <a href="Draft_Workbench.html" class="mw-redirect" title="Draft Workbench">here</a>.
|
||
</p>
|
||
<h4><span class="mw-headline" id="So-so_link">So-so link</span></h4>
|
||
<p>For more information on this topic, refer to <a href="Draft_Workbench.html" class="mw-redirect" title="Draft Workbench">drafting 2D objects</a>.
|
||
</p>
|
||
<h4><span class="mw-headline" id="Good_link">Good link</span></h4>
|
||
<p>For more information on this topic, see how to draft 2D objects in the <a href="Draft_Workbench.html" class="mw-redirect" title="Draft Workbench">Draft Workbench</a>.
|
||
</p>
|
||
<h3><span class="mw-headline" id="Workbench_pages">Workbench pages</span></h3>
|
||
<p>Every page of a workbench should start with:
|
||
</p>
|
||
<ul><li> the name of the workbench</li>
|
||
<li> an image of (an example) of the look of the workbench. Not necessary to show a model (see anyway the <a href="#Screen_capture">#Screen capture</a> section for rules), but the menu and toolbar should be visible, in their default position</li>
|
||
<li> a description of what the workbench is used for</li></ul>
|
||
<h3><span class="mw-headline" id="Command_.28tool.29_pages">Command (tool) pages</span></h3>
|
||
<p>The command pages describing workbench tools should not be too long, they should only explain what a command can do and what it can't, and how to use it. You should keep pictures to a minimum, and not give too many examples - tutorials is where we should go in step-by-step details.
|
||
</p><p>Restrictions should be documented right in the command page itself rather than elsewhere, possibly under a "restrictions" chapter.
|
||
</p><p>Please refer to the <a href="Gui_Command.html" title="Gui Command">Gui Command</a> page for specific indications on Gui Command rules (naming, documenting, etc.).
|
||
</p>
|
||
<h3><span class="mw-headline" id="Tutorials">Tutorials</span></h3>
|
||
<p>Good tutorial examples are available at <a rel="nofollow" class="external text" href="http://freecad-tutorial.blogspot.it">FreeCAD tutorial - Unofficial tutorial blog</a>.
|
||
Though they are not styled as FreeCAD wiki pages, they are a valid example of how a written tutorial should look like.
|
||
</p>
|
||
<h2><span class="mw-headline" id="Language">Language</span></h2>
|
||
<h3><span class="mw-headline" id="Expressions">Expressions</span></h3>
|
||
<p>You should avoid colloquial generic expressions as 'a couple'. Please re-phrase as 'some' if indeterminate, or with the correct cardinality.
|
||
</p>
|
||
<h3><span class="mw-headline" id="Conciseness">Conciseness</span></h3>
|
||
<p>Try to avoid repetitions to keep descriptions short.
|
||
</p>
|
||
<h4><span class="mw-headline" id="Bad_description">Bad description</span></h4>
|
||
<p><a href="PartDesign_Workbench.html" title="PartDesign Workbench">Part Design Workbench</a>: the Part Design Workbench is a workbench for part design that aims to provide tools for modelling complex solid parts.
|
||
</p>
|
||
<h4><span class="mw-headline" id="Good_description">Good description</span></h4>
|
||
<p><a href="PartDesign_Workbench.html" title="PartDesign Workbench">Part Design Workbench</a>: aims to provide tools for modelling complex solid parts.
|
||
</p>
|
||
<h2><span class="mw-headline" id="Style">Style</span></h2>
|
||
<h3><span class="mw-headline" id="Templates">Templates</span></h3>
|
||
<p>Styling of FreeCAD Wiki pages is mainly achieved through the usage of templates. The table here below reports the templates that should be used in FreeCAD Wiki pages. Please use the templates listed below as much as possible, since these allows to re-style the whole Wiki in one shot by updating the template, and is the preferred method in the Wiki. For special cases <b>only</b> you can resort to direct HTML tags.
|
||
</p><p>Remark: you can see the complete list of defined templates accessing <a href="https://www.freecadweb.org/wiki/index.php?title=Special:PrefixIndex/Template:" title="Special:PrefixIndex/Template:">Special:PrefixIndex/Template:</a>. However, not all the templates defined here are used for styling the text, and others are deprecated. Please refer to the table below for the list of templates you should use when documenting FreeCAD in the Wiki.
|
||
</p>
|
||
<table border="2" cellspacing="0" cellpadding="4" rules="all" class="hintergrundfarbe1 rahmenfarbe1" style="margin:1em 1em 1em 0; border-style:solid; border-width:1px; border-collapse:collapse; empty-cells:show;">
|
||
<tr>
|
||
<th>Template
|
||
</th>
|
||
<th>Appearance
|
||
</th>
|
||
<th>Description
|
||
</th></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:Emphasis" title="Template:Emphasis">Emphasis</a>
|
||
</td>
|
||
<td><i>emphasis</i>
|
||
</td>
|
||
<td>Text to emphasize
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:KEY" title="Template:KEY">KEY</a>
|
||
</td>
|
||
<td><span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">ALT</span>
|
||
</td>
|
||
<td>Show a keyboard key
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:FALSE" title="Template:FALSE">FALSE</a>
|
||
</td>
|
||
<td><span style="color: #990000; background-color: #f1cece;"><b>FALSE</b></span>
|
||
</td>
|
||
<td>False value (e.g. of a <a href="Property_editor.html" title="Property editor">property</a>)
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:TRUE" title="Template:TRUE">TRUE</a>
|
||
</td>
|
||
<td><span style="color: #009900; background-color: #cef1ce;"><b>TRUE</b></span>
|
||
</td>
|
||
<td>False value (e.g. of a <a href="Property_editor.html" title="Property editor">property</a>)
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:MenuCommand" title="Template:MenuCommand">MenuCommand</a>
|
||
</td>
|
||
<td><b>File->Save</b>
|
||
</td>
|
||
<td>GUI menu text
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:FileName" title="Template:FileName">FileName</a>
|
||
</td>
|
||
<td><b> <i>File name</i> </b>
|
||
</td>
|
||
<td>Names of files or directories
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:Code" title="Template:Code">Code</a>
|
||
</td>
|
||
<td><pre>import FreeCAD </pre>
|
||
</td>
|
||
<td>Style source code. Default language is Python, other languages can be specified.
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:SystemInput" title="Template:SystemInput">SystemInput</a>
|
||
</td>
|
||
<td><span style="font-weight: bold; font-family:Courier New, Courier, monospace;">Type this text</span>
|
||
</td>
|
||
<td>User typed input text
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:SystemOutput" title="Template:SystemOutput">SystemOutput</a>
|
||
</td>
|
||
<td><span style="font-family:Courier New, Courier, monospace;">Output text</span>
|
||
</td>
|
||
<td>Text output from the system
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:Variable" title="Template:Variable">Variable</a>
|
||
</td>
|
||
<td><span style="font-size: 0.6em;padding-right:10px;">TYPE</span><b>MyAttribute</b>
|
||
</td>
|
||
<td>Value or parameter, optionally with a type
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:Optional" title="Template:Optional">Optional</a>
|
||
</td>
|
||
<td>[InsertThis..OrNot]
|
||
</td>
|
||
<td>Optional text or value
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:Choice" title="Template:Choice">Choice</a>
|
||
</td>
|
||
<td>{ This | That }
|
||
</td>
|
||
<td>Choice of values from which one is used
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:Prettytable" title="Template:Prettytable">Prettytable</a>
|
||
</td>
|
||
<td>this table
|
||
</td>
|
||
<td>Create tables
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:Clear" title="Template:Clear">Clear</a>
|
||
</td>
|
||
<td>
|
||
</td>
|
||
<td>Clear columns. Follow the hyperlink for a detailed explanation. Often used to stop text from flowing next to unrelated images.
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:Fake_heading" title="Template:Fake heading">Fake heading</a>
|
||
</td>
|
||
<td><div style="color: black; background: none; margin: 0; overflow: hidden; padding-top: .5em; padding-bottom: .17em; font-size: 150%; margin-bottom: .6em; border-bottom: 1px solid #aaa; page-break-after: avoid;">Heading</div>
|
||
</td>
|
||
<td>Heading that will not be included in the automatic TOC
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:GuiCommand" title="Template:GuiCommand">GuiCommand</a>
|
||
</td>
|
||
<td>See example <a href="GuiCommand_model.html" title="GuiCommand model">GuiCommand model</a>
|
||
</td>
|
||
<td>Main template for creating right side box for documenting GuiCommands
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:Macro" title="Template:Macro">Macro</a>
|
||
</td>
|
||
<td>See example <a href="Macro_FlattenWire.html" title="Macro FlattenWire">Macro FlattenWire</a>
|
||
</td>
|
||
<td>Main template for creating right side box for documenting macros
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:PropertyView" title="Template:PropertyView">PropertyView</a>
|
||
</td>
|
||
<td><span style="font-size: 0.6em;padding-right:10px;">VIEW</span><b>Color</b>
|
||
</td>
|
||
<td>Show a View <a href="Property_editor.html" title="Property editor">property</a>
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:PropertyData" title="Template:PropertyData">PropertyData</a>
|
||
</td>
|
||
<td><span style="font-size: 0.6em;padding-right:10px;">DATA</span><b>Position</b>
|
||
</td>
|
||
<td>Show a Data <a href="Property_editor.html" title="Property editor">property</a>
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:Properties_Title" title="Template:Properties Title">Properties Title</a> / <a href="https://www.freecadweb.org/wiki/index.php?title=Template:TitleProperty" title="Template:TitleProperty">TitleProperty</a>
|
||
</td>
|
||
<td><span style="color: #ffffff; background-color: #a0a0a0; font-size: 132%; font-weight: bold; margin-bottom: .3em; page-break-after: avoid;">Base</span>
|
||
</td>
|
||
<td>Title for a <a href="Property_editor.html" title="Property editor">property</a> group. Will not be included in the automatic TOC.
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:PropertyTasks" title="Template:PropertyTasks">PropertyTasks</a> / <a href="https://www.freecadweb.org/wiki/index.php?title=Template:TasksTag" title="Template:TasksTag">TasksTag</a>
|
||
</td>
|
||
<td><span style="background: #eec8aa; border: 1px solid #bbbbbb; padding: 0px 5px 1px 5px;"><small>TASKS</small> <b>Tasks</b></span>
|
||
</td>
|
||
<td>Argument for Tasks
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:TitleTasks" title="Template:TitleTasks">TitleTasks</a>
|
||
</td>
|
||
<td>===<span style="color: #485dc6; background-color: #d5dff9; font-weight: bold;">Tasks Title</span>===
|
||
</td>
|
||
<td>Title for Tasks
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:Docnav" title="Template:Docnav">Docnav</a>
|
||
</td>
|
||
<td>
|
||
</td>
|
||
<td>Used to create the 'next', 'previous' and 'index' links (usually at the bottom of a page)
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:Version" title="Template:Version">Version</a>
|
||
</td>
|
||
<td><span style="font-size:x-small;"><a href="Release_notes_0.13.html" class="mw-redirect" title="Release notes 0.13">available in version 0.13</a></span>
|
||
</td>
|
||
<td>Indicate that a feature is available only starting with a specific FreeCAD version
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:VeryImportantMessage" title="Template:VeryImportantMessage">VeryImportantMessage</a>
|
||
</td>
|
||
<td><div id="itsfree" style="text-align:center;color:black;background:#FDE0A8;margin:1em 7em;padding:0.5em 2em;border:2px solid #FF5706;">Important Message</div>
|
||
</td>
|
||
<td>Used to highlight very important messages. Use sparingly.
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:Softredirect" title="Template:Softredirect">Softredirect</a>
|
||
</td>
|
||
<td>
|
||
</td>
|
||
<td>Use it instead of the normal redirect, when you are redirecting to a special page (such as Media: or Category:), in which cases the normal redirect is disabled.
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:UnfinishedDocu" title="Template:UnfinishedDocu">UnfinishedDocu</a>
|
||
</td>
|
||
<td><div id="itsfree" style="text-align:center; background:#FDE0A8;margin:1em 7em;padding:0.5em 2em;border:2px solid #FF5706;">
|
||
<p>This documentation is not finished. Please help and contribute documentation.
|
||
</p><p>See <a href="Draft_ShapeString.html" title="Draft ShapeString">Draft ShapeString</a> for good documented Command. <a href="Gui_Command.html" title="Gui Command">Gui Command</a> gives an overview over commands. And see <a href="List_of_Commands.html" class="mw-redirect" title="List of Commands">List of Commands</a> for other commands.
|
||
</p><p>Go to <a rel="nofollow" class="external text" href="Help_FreeCAD.html">Help FreeCAD</a> to contribute.
|
||
</p>
|
||
</div>
|
||
</td>
|
||
<td>Marks work in progress on a documentation page.
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=Template:Quote" title="Template:Quote">Quote</a>
|
||
</td>
|
||
<td><blockquote class="templatequote">Cry "Havoc" and let slip the dogs of war.<div class="templatequotecite">—<a href="https://www.freecadweb.org/wiki/index.php?title=William_Shakespeare&action=edit&redlink=1" class="new" title="William Shakespeare (page does not exist)">William Shakespeare</a>, <cite><i><a href="/wiki/index.php?title=Julius_Caesar_(play)&action=edit&redlink=1" class="new" title="Julius Caesar (play) (page does not exist)">Julius Caesar</a></i>, act III, scene I</cite></div>
|
||
</blockquote>
|
||
</td>
|
||
<td>Quote for citations.
|
||
</td></tr>
|
||
<tr>
|
||
<td>Click
|
||
</td>
|
||
<td><b>Deprecated</b>
|
||
</td>
|
||
<td>Superimpose an invisible link on an image. You should use the native Wiki picture inclusion method instead.
|
||
</td></tr>
|
||
<tr>
|
||
<td>DASH
|
||
</td>
|
||
<td><b>Deprecated</b>
|
||
</td>
|
||
<td>Text box type code, colorful background. You should use the style you obtain starting the source line with a space.
|
||
</td></tr>
|
||
<tr>
|
||
<td>Disambig
|
||
</td>
|
||
<td><b>Deprecated</b>
|
||
</td>
|
||
<td>Not used.
|
||
</td></tr>
|
||
<tr>
|
||
<td>Information
|
||
</td>
|
||
<td><b>Deprecated</b>
|
||
</td>
|
||
<td>Not used. A standardized table providing complete information about the file, including description of what it shows and how it was made, copyright status and source.
|
||
</td></tr>
|
||
<tr>
|
||
<td>Languages
|
||
</td>
|
||
<td><b>Deprecated</b>
|
||
</td>
|
||
<td>Obsolete with the new wiki, translations and languages are managed via a dedicated tool.
|
||
</td></tr>
|
||
<tr>
|
||
<td>Message
|
||
</td>
|
||
<td><b>Deprecated</b>
|
||
</td>
|
||
<td>For not very important messages. Not used.
|
||
</td></tr>
|
||
<tr>
|
||
<td>Powerdocnavi, Devdocnavi, Userdocnavi
|
||
</td>
|
||
<td><b>Deprecated</b>
|
||
</td>
|
||
<td>Bottom page navigation. Not to be used, redundant.
|
||
</td></tr>
|
||
<tr>
|
||
<td>Screenshot
|
||
</td>
|
||
<td><b>Deprecated</b>
|
||
</td>
|
||
<td>See <a href="#Screen_capture">#Screen capture</a> instead.
|
||
</td></tr></table>
|
||
<p>To have a global view on the chromatic aspect, see <a href="WikiPagesBasicColors.html" title="WikiPagesBasicColors">Basic Graphic Template</a>.
|
||
</p>
|
||
<h3><span class="mw-headline" id="Code">Code</span></h3>
|
||
<p>Code must be styled using the <a href="https://www.freecadweb.org/wiki/index.php?title=Template:Code" title="Template:Code">Code</a> template.
|
||
</p><p>Code description should follow the text box generated by the <a href="https://www.freecadweb.org/wiki/index.php?title=Template:Code" title="Template:Code">Code</a> template, so that the description is structured according to the content. Accentuation should be strictly used <i>only</i> on the word or lines that must be accentuated.
|
||
</p>
|
||
<h4><span class="mw-headline" id="Example_of_bad_code_description">Example of bad code description</span></h4>
|
||
<pre>makeAngularDimension (center,[angle1,angle2],p3): creates an angular Dimension from the given center,
|
||
with the given list of angles, passing through p3. Returns the newly created object. </pre>
|
||
<h4><span class="mw-headline" id="Example_of_good_code_description">Example of good code description</span></h4>
|
||
<pre>makeAngularDimension (center,[angle1,angle2],p3) </pre>
|
||
<ul><li> Creates an angular Dimension from the given center, with the given list of angles, passing through p3.</li>
|
||
<li> Returns the newly created object.</li></ul>
|
||
<h2><span class="mw-headline" id="Graphics_content">Graphics content</span></h2>
|
||
<h3><span class="mw-headline" id="General_2">General</span></h3>
|
||
<p>Avoid thumbnails whenever possible. Pictures should be shown in their original size, to avoid the need for the user to continuously navigate back and forth between different pages. Most important even, in the automatically generated printed manual (e.g. pdf version), thumbnails may not be readable. Thumbnails should be used only as last resource.
|
||
</p><p>For the same reason, you should avoid animated pictures (i.e. gif). Animation should be reserved for tutorials not intended to be read as static content (e.g. video).
|
||
</p><p>Pictures must be uploaded through the <a href="https://www.freecadweb.org/wiki/index.php?title=Special:Upload" title="Special:Upload">Special:Upload</a> page.
|
||
</p>
|
||
<h3><span class="mw-headline" id="Screen_capture">Screen capture</span></h3>
|
||
<p>Recommended size for screen captures, to avoid any resizing when showing the picture, should be:
|
||
</p>
|
||
<ul><li> native 400x200 (or width=400 and height<=200), for <a href="Gui_Command.html" title="Gui Command">Gui Command</a> pages, to allow the picture to fit in the left part of the page, and for other standard snapshots</li>
|
||
<li> native 600x400 (or width=600 and height<=400), for <a href="Gui_Command.html" title="Gui Command">Gui Command</a> pages, when you really need a bigger picture, and still allow the picture to fit in the left part of the page, and for other standard snapshots</li>
|
||
<li> native 1024x768 (or width=1024 and height<=768), only for full screen images</li>
|
||
<li> Smaller sizes are possible when showing details, however use native resolution, not resizing or thumbnails, unless you have a very good reason to do so.</li>
|
||
<li> Avoid larger resolutions, as they won't be much portable to any kind of display or in printed (pdf) documentation.</li></ul>
|
||
<p>If possible, you shouldn't depend too much on any OS. While of course achieving 100% independency from the underlying OS is not possible, you should use visual defaults whenever possible.
|
||
</p>
|
||
<h4><span class="mw-headline" id="Text">Text</span></h4>
|
||
<p>To ease documentation translations, if you put a screenshot showing the interface, you should not show the 3D model view in the same screenshot. In this way, the translator will not have to hunt for the model used to create the screenshot, and can simply take a screenshot of the localized interface. If there are drop down menus in the taskbar, the options should be listed in the text content.
|
||
</p><p>If your screen capture contains text (e.g. a menu), use the same resolution of the original interface item in FreeCAD. This avoids to have images containing very large or very small text, and keeps the same look and feel of the FreeCAD native interface.
|
||
</p>
|
||
<h5><span class="mw-headline" id="Good_picture_text_dimension">Good picture text dimension</span></h5>
|
||
<p><a href="https://www.freecadweb.org/wiki/index.php?title=File:Partdesign_revolution_parameters.png" class="image"><img alt="Partdesign revolution parameters.png" src="Partdesign_revolution_parameters.png" width="325" height="333" /></a>
|
||
</p>
|
||
<h5><span class="mw-headline" id="Bad_picture_text_dimension">Bad picture text dimension</span></h5>
|
||
<p><a href="https://www.freecadweb.org/wiki/index.php?title=File:Partdesign_revolution_parameters.png" class="image"><img alt="Partdesign revolution parameters.png" src="190px-Partdesign_revolution_parameters.png" width="190" height="195" srcset="/wiki/images/thumb/0/00/Partdesign_revolution_parameters.png/285px-Partdesign_revolution_parameters.png 1.5x, Partdesign_revolution_parameters.png 2x" /></a>
|
||
</p><p>In this picture, note that the text dimension is acceptable, but there still are visual artifacts due to rescaling (the original width is 307px, rescaled to 190px)
|
||
You should use native resolution to avoid visual artifacts due to rescaling.
|
||
</p>
|
||
<h3><span class="mw-headline" id="Icons_and_graphics">Icons and graphics</span></h3>
|
||
<p>Refer to this page for ready-to-use <a href="Artwork.html" title="Artwork">Artwork</a> and Icon creation rules.
|
||
</p>
|
||
<h2><span class="mw-headline" id="Models">Models</span></h2>
|
||
<p>The following pages contain models for FreeCAD documentation.
|
||
</p>
|
||
<ul><li> <a href="GuiCommand_model.html" title="GuiCommand model">GuiCommand_model</a></li>
|
||
<li> <a href="Boiler_NonCommand.html" title="Boiler NonCommand">Boiler_NonCommand</a></li></ul>
|
||
<h2><span class="mw-headline" id="Translations">Translations</span></h2>
|
||
<p>As per general consensus, the reference page is the English page, that should be created first. Moreover, if you want to change or add content in a page, you should do it in the the English page first, and only once the update is completed, port the modification to the translated page.
|
||
</p><p>The FreeCAD wiki supports a Translation plugin which allows to manage translations between pages.
|
||
</p><p>For details on translation, see FreeCAD Wiki Translation Process under <a href="Localisation.html" title="Localisation">Localisation</a>.
|
||
</p><p>Other useful resources are:
|
||
</p>
|
||
<ul><li> Language Codes: <a rel="nofollow" class="external free" href="http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes">http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes</a></li>
|
||
<li> Country Flags: <a rel="nofollow" class="external free" href="http://en.wikipedia.org/wiki/Gallery_of_sovereign_state_flags">http://en.wikipedia.org/wiki/Gallery_of_sovereign_state_flags</a></li>
|
||
<li> Google Translate: <a rel="nofollow" class="external free" href="http://translate.google.com/">http://translate.google.com/</a></li></ul>
|
||
<h2><span class="mw-headline" id="Some_tips_for_translators">Some tips for translators</span></h2>
|
||
<h3><span class="mw-headline" id="Setting_Docnav">Setting Docnav</span></h3>
|
||
<p>See this link in the forum: <a rel="nofollow" class="external free" href="http://forum.freecadweb.org/viewtopic.php?f=21&t=6716">http://forum.freecadweb.org/viewtopic.php?f=21&t=6716</a>
|
||
</p>
|
||
<h3><span class="mw-headline" id="Using_special_pages">Using special pages</span></h3>
|
||
<ul><li><a href="https://www.freecadweb.org/wiki/index.php?title=Special:LonelyPages" title="Special:LonelyPages">Orphaned pages</a> list those pages that are not linked from or transcluded into other pages in FreeCAD Documentation. These pages are not accessible via links (no one sees them). If you find in your native language, try to create the connection that exists in the English page, otherwise no one can read them.</li>
|
||
<li><a href="https://www.freecadweb.org/wiki/index.php?title=Special:UncategorizedPages" title="Special:UncategorizedPages">Uncategorized pages</a> pages without category. They do not appear when you browse the categories. Assign a category.</li>
|
||
<li><a href="https://www.freecadweb.org/wiki/index.php?title=Special:WantedPages" title="Special:WantedPages">Wanted pages</a> pages that are called, but that do not exist. Red link in the texts. Deprecated and very annoying. </li>
|
||
<li>Others Wanted (files and templates) </li>
|
||
<li><a href="https://www.freecadweb.org/wiki/index.php?title=Special:WantedCategories" title="Special:WantedCategories">Wanted categories</a> they exist always, not only has been edited text. Skip.</li>
|
||
<li><a href="https://www.freecadweb.org/wiki/index.php?title=Special:Categories" title="Special:Categories">Categories</a> allow you to compare the number of pages of a given type of the original version with those translated into the specified language.</li>
|
||
<li><a href="https://www.freecadweb.org/wiki/index.php?title=Special:ListRedirects" title="Special:ListRedirects">List of redirects</a> allows you to control the correct redirection pages. If there are any red links, something does not work well. Investigate. Light blue links lead to pages outside the site, no problem.</li>
|
||
<li><a href="https://www.freecadweb.org/wiki/index.php?title=Special:RecentChanges" title="Special:RecentChanges">Recent changes</a> track the most recent changes to the wiki.</li>
|
||
<li><a href="https://www.freecadweb.org/wiki/index.php?title=Special:LanguageStats" title="Special:LanguageStats">Language statistics</a> shows translation statistics for all message groups for a language. Shows the parts not translated in a given language, only for those pages marked for translation. To see what has not been translated, set the language code and press Show statistic. It also contains the link to see what has been recently translated into that language. Note: If entering code en pages appear, it is likely that the original page contains markup errors (Sidebar apart).</li>
|
||
<li><a href="https://www.freecadweb.org/wiki/index.php?title=Special:PageTranslation" title="Special:PageTranslation">Page translation</a> allows you to see all the pages marked for translation, but also the updated and unmarked pages. Only administrators can mark pages for translation.</li>
|
||
<li>Category:Pages to delete: list of pages to be deleted, created by mistake or unnecessary. </li></ul>
|
||
<h2><span class="mw-headline" id="Robots">Robots</span></h2>
|
||
<p>At the page <a href="WikiRobots.html" title="WikiRobots">WikiRobots</a> you can find instructions on how to set-up and use robots to automate repetitive tasks on the FreeCAD Wiki.
|
||
</p>
|
||
<h2><span class="mw-headline" id="Discussion">Discussion</span></h2>
|
||
<p>The Forum provides a dedicated section for discussing <a rel="nofollow" class="external text" href="http://forum.freecadweb.org/viewforum.php?f=21">documentation wiki</a> topics. Direct your questions there.
|
||
</p><p><br />
|
||
</p>
|
||
<h2><span class="mw-headline" id="Brainstorming">Brainstorming</span></h2>
|
||
<div id="itsfree" style="text-align:center;color:black;background:#FDE0A8;margin:1em 7em;padding:0.5em 2em;border:2px solid #FF5706;">All that follows from now on is only for open discussion. You can stop reading here if you don't intend to brainstorm modifications of the FreeCAD WikiPages style rules. You can anyway post and discuss any Wiki-related topic on the [<a rel="nofollow" class="external text" href="http://forum.freecadweb.org/viewforum.php?f=21">Forum</a>]. Contributions are welcome.</div>
|
||
<p><br />
|
||
</p>
|
||
<h3><span class="mw-headline" id="Workflow.2C_Roadmap">Workflow, Roadmap</span></h3>
|
||
<p>Organize pages in the wiki
|
||
</p>
|
||
<h4><span class="mw-headline" id="Content_and_Appearance:">Content and Appearance:</span></h4>
|
||
<ul><li><ul><li> Renato: <i>width of the page, now much space is unused (only for monitor 16:10)</i></li>
|
||
<li> Renato: <i>white background, text more readable</i></li>
|
||
<li> Renato: <i> links to similar commands, similar tools, scripts, examples, discussions, insights, forum, other... On all pages or only on some pages?</i></li></ul></li></ul>
|
||
<h4><span class="mw-headline" id="Templates_2">Templates</span></h4>
|
||
<p>I think the things like this are also templates? {{PartDesign Tools}}
|
||
This template contains headlines, icons, short textual description, long textual description, list elements. May be easier to handle when splitted in pieces (at least: icon list, description list, "full featured": array of someWorkbenchTools[icon|description,{2-4}]...) ?
|
||
</p>
|
||
<ul><li> Basic Template that would be useful</li></ul>
|
||
<table border="2" cellspacing="0" cellpadding="4" rules="all" class="hintergrundfarbe1 rahmenfarbe1" style="margin:1em 1em 1em 0; border-style:solid; border-width:1px; border-collapse:collapse; empty-cells:show;">
|
||
<tr>
|
||
<th>Template
|
||
</th>
|
||
<th>Note
|
||
</th>
|
||
<th>Note
|
||
</th></tr>
|
||
<tr>
|
||
<td>suggestion
|
||
<p>caution
|
||
</p>
|
||
</td>
|
||
<td>useful?
|
||
</td>
|
||
<td>as Message?
|
||
</td></tr>
|
||
<tr>
|
||
<td>alert
|
||
</td>
|
||
<td>useful?
|
||
</td>
|
||
<td>as VeryImportantMessage?
|
||
</td></tr>
|
||
<tr>
|
||
<td>idea
|
||
</td>
|
||
<td>useful?
|
||
</td>
|
||
<td>
|
||
</td></tr>
|
||
<tr>
|
||
<td>shortcut
|
||
</td>
|
||
<td>
|
||
</td>
|
||
<td>as KEY?
|
||
</td></tr></table>
|
||
<p><br />
|
||
</p>
|
||
<table border="2" cellspacing="0" cellpadding="4" rules="all" class="hintergrundfarbe1 rahmenfarbe1" style="margin:1em 1em 1em 0; border-style:solid; border-width:1px; border-collapse:collapse; empty-cells:show;">
|
||
<tr>
|
||
<th>Template
|
||
</th>
|
||
<th>Appearance
|
||
</th>
|
||
<th>Description
|
||
</th></tr>
|
||
<tr>
|
||
<td>Clear
|
||
</td>
|
||
<td>ok
|
||
</td>
|
||
<td>Template for clearing columns
|
||
</td></tr>
|
||
<tr>
|
||
<td>Click
|
||
</td>
|
||
<td>rarely used
|
||
</td>
|
||
<td>superimpose an invisible link on an image
|
||
</td></tr>
|
||
<tr>
|
||
<td>DASH
|
||
</td>
|
||
<td>rarely used
|
||
</td>
|
||
<td>text box type code, colorful background
|
||
</td></tr>
|
||
<tr>
|
||
<td>Disambig
|
||
</td>
|
||
<td>not used
|
||
</td>
|
||
<td>
|
||
</td></tr>
|
||
<tr>
|
||
<td>Docnav
|
||
</td>
|
||
<td>ok
|
||
</td>
|
||
<td>
|
||
</td></tr>
|
||
<tr>
|
||
<td>FALSE
|
||
</td>
|
||
<td>color or black and gray?
|
||
</td>
|
||
<td><span style="color: #990000; background-color: #f1cece;"><b>FALSE</b></span> <span style="color: #990000; background-color: #DDDDDD;"><b>FALSE</b></span> <span style="color: #990000; background-color: #DDDDDD;">FALSE</span> <span style="color: #990000; background-color: #DDDDDD;"><b>False</b></span> <span style="color: #990000; background-color: #DDDDDD;">False</span> <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">False</span> <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;"><b>False</b></span> <span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;"><b>False</b></span> <span style="background: #FFFFFF; border: 1px solid #888888; padding: 0px 5px 1px 5px;"><b>False</b></span>
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="Gui_Command.html" title="Gui Command">Gui Command</a>
|
||
</td>
|
||
<td>ok
|
||
</td>
|
||
<td>the main anchor on documenting GuiCommands
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=MenuCommand&action=edit&redlink=1" class="new" title="MenuCommand (page does not exist)">MenuCommand</a>
|
||
</td>
|
||
<td><b>File->Save</b>
|
||
</td>
|
||
<td>Text that is displayed in a GUI command menu
|
||
</td></tr>
|
||
<tr>
|
||
<td>Information
|
||
</td>
|
||
<td>not used
|
||
</td>
|
||
<td>A standardized table providing complete information about the file, including description of what it shows and how it was made, copyright status and source.
|
||
</td></tr>
|
||
<tr>
|
||
<td><a href="https://www.freecadweb.org/wiki/index.php?title=KEY&action=edit&redlink=1" class="new" title="KEY (page does not exist)">KEY</a>
|
||
</td>
|
||
<td><span style="background: #DDDDDD; border: 1px solid #888888; padding: 0px 5px 1px 5px;">ALT</span>
|
||
</td>
|
||
<td>Show a keyboard key
|
||
</td></tr>
|
||
<tr>
|
||
<td>Languages
|
||
</td>
|
||
<td>ok
|
||
</td>
|
||
<td>obsolete with the new wiki
|
||
</td></tr>
|
||
<tr>
|
||
<td>Macro
|
||
</td>
|
||
<td>ok, used
|
||
</td>
|
||
<td>the main anchor on documenting macros
|
||
</td></tr>
|
||
<tr>
|
||
<td>Message
|
||
</td>
|
||
<td>rarely used
|
||
</td>
|
||
<td>for message not very important
|
||
</td></tr>
|
||
<tr>
|
||
<td>VeryImportantMessage
|
||
</td>
|
||
<td>ok, used
|
||
</td>
|
||
<td>for message very important
|
||
</td></tr>
|
||
<tr>
|
||
<td>Prettytable
|
||
</td>
|
||
<td>used for this table
|
||
</td>
|
||
<td>could have different colors
|
||
</td></tr>
|
||
<tr>
|
||
<td>PropertyView
|
||
</td>
|
||
<td>background green or gray?
|
||
</td>
|
||
<td><span style="background: #C2EEAA; border: 1px solid #bbbbbb; padding: 0px 5px 1px 5px;"><small>VIEW</small> <b>Property</b></span> <span style="background: #DDDDDD; border: 1px solid #bbbbbb; padding: 0px 5px 1px 5px;"><small>View</small> <b>Property</b></span>
|
||
</td></tr>
|
||
<tr>
|
||
<td>Properties Title
|
||
</td>
|
||
<td>spelling. color or black and gray?
|
||
</td>
|
||
<td><span style="color: #ffffff; background-color: #a0a0a0; font-size: 132%; font-weight: bold; margin-bottom: .3em; page-break-after: avoid;">Base</span>
|
||
</td></tr>
|
||
<tr>
|
||
<td>PropertyTasks
|
||
</td>
|
||
<td>color or black and gray?
|
||
</td>
|
||
<td><span style="background: #eec8aa; border: 1px solid #bbbbbb; padding: 0px 5px 1px 5px;"><small>TASKS</small> <b>Length</b></span> Renato: <i>serve but too many disturbing reading</i>
|
||
</td></tr>
|
||
<tr>
|
||
<td>Screenshot
|
||
</td>
|
||
<td>link
|
||
</td>
|
||
<td><small>{{{2}}} - see more <a href="Screenshots.html" title="Screenshots">screenshots</a></small>
|
||
</td></tr>
|
||
<tr>
|
||
<td>Softredirect
|
||
</td>
|
||
<td>
|
||
</td>
|
||
<td>Use it instead of the normal redirect, when you are redirecting to a special page (such as Media: or Category:), in which cases the normal redirect is disabled.
|
||
</td></tr>
|
||
<tr>
|
||
<td>TasksTag
|
||
</td>
|
||
<td>color or black and gray?
|
||
</td>
|
||
<td><span style="background: #eec8aa; border: 1px solid #bbbbbb; padding: 0px 5px 1px 5px;"><small>TASKS</small> <b>Text</b></span>
|
||
</td></tr>
|
||
<tr>
|
||
<td>TRUE
|
||
</td>
|
||
<td>color or black and gray?
|
||
</td>
|
||
<td><span style="color: #009900; background-color: #cef1ce;"><b>TRUE</b></span>
|
||
</td></tr>
|
||
<tr>
|
||
<td>UnfinishedDocu
|
||
</td>
|
||
<td>ok
|
||
</td>
|
||
<td>mark not finished documentation.
|
||
</td></tr>
|
||
<tr>
|
||
<td>Version
|
||
</td>
|
||
<td>FreeCAD version, small text
|
||
</td>
|
||
<td>
|
||
</td></tr>
|
||
<tr>
|
||
<td>
|
||
</td>
|
||
<td>
|
||
</td>
|
||
<td>
|
||
</td></tr></table>
|
||
<p><br />
|
||
</p>
|
||
<ul><li> Other Template</li></ul>
|
||
<pre>* PartDesignTools
|
||
* _______________
|
||
</pre>
|
||
<h3><span class="mw-headline" id="Forum">Forum</span></h3>
|
||
<ul><li> Reflect on requests for help made in the forum and use the given examples (if it is required an aid often means that the manual is not exhaustive, in the forum there are good examples, but hard to find)
|
||
<ul><li> Renato: <i>Insert a link on the document page or insert the example or insert nothing?</i>
|
||
<ul><li>Ralf: insert link(s) always in a field/area which is always there on every page. If there is nothing to link, there should be a text in this area as "There is currently no link to forum examples."</li>
|
||
<li>Ralf #2 examples: no examples at pages which are describing more than exactly the use of (probably mostly) a tool. If there would be examples (at different pages) which differ in various ways and are not comparable are confusing.</li>
|
||
<li> Ralf #3 examples: But beside of existing examples: defining a "standard model" (or some of them if needed for fairly different tasks as p.e. Part-Design vs. Arch) for really every example would promise a lot of advantages. The first one: if one like to try an example the related model file is available right there with the next click. Whatever the "standard model" could be - the most important condition it have to be usable for all examples/task from to simplest up to the most complex (FEM,assembly?!) </li>
|
||
<li> May be such an <i>standard model</i> and his incarnations could be also a kind of a "figurehead" for FC.<br /></li>
|
||
<li> <a href="https://www.freecadweb.org/wiki/index.php?title=User:Ediloren&action=edit&redlink=1" class="new" title="User:Ediloren (page does not exist)">Ediloren</a> (<a href="https://www.freecadweb.org/wiki/index.php?title=User_talk:Ediloren&action=edit&redlink=1" class="new" title="User talk:Ediloren (page does not exist)">talk</a>) 18:01, 3 September 2013 (CEST) : looks like a good idea but not too practical; I expect that the burden of adding examples for everything would be very high. I would prefer to resort on tutorials, videos, and forum unless somebody has really the time and commitment to follow this part (me not, sorry :) )</li></ul></li></ul></li></ul>
|
||
<p><a href="WikiPagesFromForum.html" title="WikiPagesFromForum">Some useful examples taken from the forum</a>
|
||
</p>
|
||
<h3><span class="mw-headline" id="Documentation_structure:">Documentation structure:</span></h3>
|
||
<ul><li> Links between pages (tree and hierarchy linear, orderly, full)
|
||
<ul><li> Renato: <i>If there is an index the docnav does not serves.</i></li></ul></li>
|
||
<li> Page titles descriptive
|
||
<ul><li> Renato: <i>Translated or not translated? With the new translator seems outdated</i></li></ul></li>
|
||
<li> Structure of the documentation (depending on the type of user and the type of documentation). <i>Group some things? - If possible in any way: group everything to maximal seven (7) entrys (per group)(Ralf).</i>:
|
||
<ul><li> Reference (needs indicate precise criteria) (Ralf: for me for advanced users/using, #3)</li>
|
||
<li> How to (Ralf: additional, #4)</li>
|
||
<li> Tutorial (Ralf: additional, #5)
|
||
<ul><li> External links</li></ul></li>
|
||
<li> Themed (Ralf: 1st thing / start point while using the documentation? - for me #1)</li>
|
||
<li> examples - in relevant cases - the most basic example for using the tool / workbench /feature (is that possible with complex tools?) ; may be one "standard" example case for the most examples, if possible (so the fcstd file can be supplied and re-used for a lot of uses) for me #2 or to #1<br /></li>
|
||
<li> linear (all, as now)</li>
|
||
<li> structured with sub-structures (very clear if there are no more than 5..7 entrys per structure layer)</li>
|
||
<li> task - specific (features is other than transform than handle mouse etc.)</li>
|
||
<li> FAQ</li>
|
||
<li> Books</li>
|
||
<li> Plugins</li>
|
||
<li> Macro</li></ul></li></ul>
|
||
<h3><span class="mw-headline" id="Documentation_schemes">Documentation schemes</span></h3>
|
||
<p>See <a href="WikiPagesDocSchemes.html" title="WikiPagesDocSchemes">Documentation schemes</a>
|
||
</p>
|
||
<h3><span class="mw-headline" id="Repository">Repository</span></h3>
|
||
<ul><li> fcstd file </li>
|
||
<li> pics, images</li>
|
||
<li> icons (there are almost all)</li>
|
||
<li> "Show your FreeCAD projects here!" archives</li></ul>
|
||
<h3><span class="mw-headline" id="Who_are_the_users:">Who are the users:</span></h3>
|
||
<ul><li> New users FreeCAD:
|
||
<ul><li> Users without CAD experience -> not the job of the FreeCAD doc to teach them CAD - the job to teach them how to use FreeCAD? <i>Renato: I think that FreeCAD is currently the only free CAD program with a professional approach. Many people exactly look for this to begin.</i></li>
|
||
<li> Users with CAD experience (2D/3D/parametric); users with 3D experience - no CAD</li>
|
||
<li> Users who know how to program (version?)</li></ul></li></ul>
|
||
<ul><li> Users who know FreeCAD:
|
||
<ul><li> Users</li>
|
||
<li> Advanced users</li>
|
||
<li> Developers</li></ul></li></ul>
|
||
<h3><span class="mw-headline" id="What_the_users_needs:">What the users needs:</span></h3>
|
||
<ul><li> According to the category of the previous point they need different things (to be determined).</li>
|
||
<li> Renato: <i>In my opinion the beginners to FreeCAD (or to CAD?) needs:</i>
|
||
<ul><li> <i>find the information immediately</i> + Ralf: in the expected, consistent way</li>
|
||
<li> <i>know what are the workbenches, when and how to use them,</i> + Ralf: is this one workbench all I need or do I need more than one? </li>
|
||
<li> <i>the commands that are available,</i> + Ralf: in the workbench - for the task - all</li>
|
||
<li> <i>the workflow to use,</i> - Ralf: workflow sounds specific - may be the most basic way to use this - may be especially for tools there could be more than page per tool (as above: basic for beginners, extended use for advanced users)</li>
|
||
<li> ....</li></ul></li></ul>
|
||
<h3><span class="mw-headline" id="Translations_2">Translations</span></h3>
|
||
<ul><li> Consistent (the reference page is the English page, see the various discussions regarding the rules in the forum)</li>
|
||
<li> Updated (how?) + Ralf: 1st: Version, 2nd: frozen state of doc page - "this is the actual version of the documentation of ... for FC version xxx"; 3rd linked archiv pages of other versions (and maybe other frozen states), all with corresponding "tags" / marks
|
||
<ul><li> <i>Use a document type that including at least one complete section of the manual (not just one page at a time). Comparable off line with an previous version. With "Recent changes" is difficult to follow all the changes, when they are frequent.</i></li></ul></li>
|
||
<li> FCSTD files for Documentation <i>(wandererfan wrote: It would be nice to have a repository for the fcstd files +Ralf and it would be very helpful - used to generate screenshots, etc. Then the 2nd author/translator could just open the fcstd with a different locale to generate the new screenshot. This would also for standardization of background colours, font sizes, etc. )</i></li>
|
||
<li> Renato. My personal:</li></ul>
|
||
<p><i>- The wiki, is the best way to create documentation FreeCAD? Would not it be better to reserve it for some issues and create a comprehensive manual for each version?</i><br />
|
||
<i>- About updates, this is a crucial point, I've seen that you do not like docboock, and I do not intend to return to this theme, but docboock allows translators to easily work on documents. Allows you to download the entire document and compare it with the previous one. With this way changes are made always and only in the original document. Then the translators periodically (even daily if they want) downloading the document and compares with an earlier version and update it indicating the upgrade version. I've experienced that this procedure is very good. Can I do a similar thing with the wiki? In this way there is no need to continuously monitor Recent Changes and updates are easier to control.</i>
|
||
</p>
|
||
<h3><span class="mw-headline" id="Some_notes_taken_from_the_forum">Some notes taken from the forum</span></h3>
|
||
<p>yorikvanhavre wrote: <i>Actually we could do a little brainstorming, see things that should be changed on the wiki...</i>
|
||
<i>I already thought of a couple of things: - a new wiki homepage with a clear view of the contents - better formatting of the 3 principal sections, for user (basically the command pages), for power users (everything about python) and the higher-level stuff (compiling, etc) - more professional aspect of the wiki pages - build a better and more strict model for command pages - find a good system to handle translations</i>
|
||
</p><p>gdo wrote: <i>But maybe a survey to freecad users could help to understand precisely what is the beginners needs.</i>
|
||
</p><p>Ralf wrote: <i>Even for the ones who are trying FreeCAD the first times, it's essential to find a consistent documentation otherwise they weren't motivated to give even some first tries.</i>
|
||
</p><p><br />
|
||
And many more ... dispersed and mixed in:
|
||
</p>
|
||
<ul><li><a rel="nofollow" class="external text" href="http://forum.freecadweb.org/viewtopic.php?f=8&t=3167">SF hosted app retairement & call for help</a></li>
|
||
<li><a rel="nofollow" class="external text" href="http://forum.freecadweb.org/viewtopic.php?f=10&t=3899">doc - some detail questions about changing, display, structure</a>: Misalignment of ToC (left menu vs. ToC and page titles), links should be called as the pages</li>
|
||
<li><a rel="nofollow" class="external text" href="http://forum.freecadweb.org/viewtopic.php?f=8&t=3988">wiki pages</a>: Best pages examples (long) discussion, propose to establish clear rules, minimize screenshots, don't use thumbnails, English pages are master, Navigation bar at the bottom like in Sketcher_Point (my view: no; use ToC), image dimensions, misalignment of ToC (Each information is linked to an index directly from the main page. The main menu expands into sub-menu. You can clearly see the hierarchy of the entire document. The documentation must be so.), how to manage docs for different FC versions, (OT: is there a timeout for editing a post? On-again some of my posts are lost in space)</li>
|
||
<li> <a rel="nofollow" class="external text" href="http://forum.freecadweb.org/viewtopic.php?f=21&t=1805">Online Help (Wiki) TODO List</a>: Misalignment and importance of ToC (it is what gets in FreeCAD Help), grouping of workbenches (alphabetically says normandc) topic left in April 10</li>
|
||
<li><a rel="nofollow" class="external text" href="http://forum.freecadweb.org/viewtopic.php?f=21&t=3818">Wiki for New Functions?</a>: How to mark versions in the Wiki</li>
|
||
<li><a rel="nofollow" class="external text" href="http://forum.freecadweb.org/viewtopic.php?f=12&t=3959">Règles a suivre pour le nouveau wiki</a></li>
|
||
<li><a rel="nofollow" class="external text" href="http://forum.freecadweb.org/viewtopic.php?f=13&t=4025">Tutorials auf Deutsch für FreeCAD</a></li></ul>
|
||
<h3><span class="mw-headline" id="Examples_of_CAD_documentation">Examples of CAD documentation</span></h3>
|
||
<p><a rel="nofollow" class="external free" href="http://help.solidworks.com/2013/English/SolidWorks/sldworks/c_Sketch_Fillets.htm?id=cb1f4dfbe23245aeb58d17af808ee10c#Pg0">http://help.solidworks.com/2013/English/SolidWorks/sldworks/c_Sketch_Fillets.htm?id=cb1f4dfbe23245aeb58d17af808ee10c#Pg0</a> <br />
|
||
</p><p>Ralf: good: you can see where you are ; bad: a huge lot of entrys in the navigation / summary at left - the opposite of structured; sorry: pieces of the forum at the documentation page: what is the documentation page good for than? (but the link to the forum / forum search - ok.)<br />
|
||
<a rel="nofollow" class="external free" href="http://www.gcad3d.org/">http://www.gcad3d.org/</a> <br />
|
||
Ralf: thumbs up. clear, well structured. sometimes long but I don't know how to avoid that at some themes. Maybe the tree structure layers could be separated in two directions at the page for more place for the content. They have "last updates" I prefer "this version of the documentation is xxx and depend the program version xxy"
|
||
</p><p>Reported by wandererfan<br />
|
||
guidelines for wiki authors:<br />
|
||
<a rel="nofollow" class="external free" href="http://wiki.blender.org/index.php/Meta:Guides/Writer_Guide">http://wiki.blender.org/index.php/Meta:Guides/Writer_Guide</a><br />
|
||
<a rel="nofollow" class="external free" href="http://wiki.blender.org/index.php/Meta:Guides/Style_Guide">http://wiki.blender.org/index.php/Meta:Guides/Style_Guide</a><br />
|
||
Manual TOC:<br />
|
||
<a rel="nofollow" class="external free" href="http://docs.gimp.org/2.8/en/">http://docs.gimp.org/2.8/en/</a><br />
|
||
<a rel="nofollow" class="external free" href="http://wiki.blender.org/index.php/Doc:2.6/Manual">http://wiki.blender.org/index.php/Doc:2.6/Manual</a><br />
|
||
</p><p>Reported by Ralf:<br />
|
||
<a rel="nofollow" class="external free" href="http://opensourceecology.org/wiki/FreeCAD">http://opensourceecology.org/wiki/FreeCAD</a><br />
|
||
</p><p>For the Italian translation also:<br />
|
||
<a rel="nofollow" class="external free" href="http://tp.linux.it/">http://tp.linux.it/</a>
|
||
</p>
|
||
<h3><span class="mw-headline" id="Next_actions">Next actions</span></h3>
|
||
<ol><li> gather ideas</li>
|
||
<li> build Table of Contents</li>
|
||
<li> build good models (in the template created by Wandererfan)</li>
|
||
<li> edit the master page in English (updated until a new FreeCAD version is released then freeze the document in pdf or doc or other)</li>
|
||
<li> translate (updated until a new FreeCAD version is released then freeze)</li>
|
||
<li> continue to develop the documentation for the new version of FreeCAD (repeats 4) </li>
|
||
<li> continue to develop the translation for the new version of FreeCAD (repeats 5)</li></ol>
|
||
<h2><span class="mw-headline" id="Terminology_-_Naming_policy">Terminology - Naming policy</span></h2>
|
||
<h3><span class="mw-headline" id="English">English</span></h3>
|
||
<p>See <a href="Glossary.html" title="Glossary">Glossary</a>
|
||
</p>
|
||
<h3><span class="mw-headline" id="Other_languages">Other languages</span></h3>
|
||
<ul><li><a href="Italian_Translation.html" title="Italian Translation">Italiano</a></li>
|
||
<li></li></ul>
|
||
<p><br />
|
||
</p><p><br />
|
||
</p><p><b>proposal to create the page:</b>
|
||
</p>
|
||
<h2><span class="mw-headline" id="Start_Center"><a href="Start_Workbench.html" title="Start Workbench">Start Center</a></span></h2>
|
||
<p>When you start FreeCAD for the first time, you are presented with the start center:
|
||
</p><p><br />
|
||
</p>
|
||
<div class="center"><div class="floatnone"><a href="https://www.freecadweb.org/wiki/index.php?title=File:Startcenter.jpg" class="image"><img alt="Startcenter.jpg" src="1024px-Startcenter.jpg" width="1024" height="574" srcset="/wiki/images/6/66/Startcenter.jpg 1.5x" /></a></div></div>
|
||
<p><br />
|
||
</p><p>The Start Center allows you to quickly jump to one of the most common workbenches, open one of the recent files, or see the latest news from the FreeCAD world. You can change the default workbench in the <a href="Preferences_Editor.html" title="Preferences Editor">preferences</a>.
|
||
</p><p><b>Use this part of <a href="Getting_started.html" title="Getting started">Getting started</a> then add more information</b>
|
||
</p><p><br />
|
||
</p>
|
||
<h1><span class="mw-headline" id="Sandbox_for_Macro_Dimensions">Sandbox for Macro Dimensions</span></h1>
|
||
<p> {{Macro|Icon=Text-x-python|Name=Dimensions|Description=Dimensioning |Author=eason}}
|
||
</p>
|
||
<h2><span class="mw-headline" id="Description">Description</span></h2>
|
||
<p>Macro for easy add dimension to Draft ... objects ...
|
||
</p><p><a href="https://www.freecadweb.org/wiki/index.php?title=File:DM.png" class="image"><img alt="DM.png" src="DM.png" width="810" height="493" /></a>
|
||
</p>
|
||
<h2><span class="mw-headline" id="How_to_install">How to install</span></h2>
|
||
<ul><li> Copy and paste the code into a macro (see <a rel="nofollow" class="external text" href="Macro_Install_HowTo.html">Ho to install macro</a>)</li>
|
||
<li> Save with a meaningful name (for me "dm")</li></ul>
|
||
<p><br />
|
||
</p>
|
||
<h2><span class="mw-headline" id="Start">Start</span></h2>
|
||
<ul><li> In FreeCAD Python Console digit "import dm" -> Return</li>
|
||
<li> In FreeCAD Python Console digit "dm.showup()" -> Return</li>
|
||
<li> set path for .ttf
|
||
<ul><li> in its latest tested version, the path must be defined on line 1112, replacing <i>path = "/usr/share/fonts/truetype/ubuntu-font-family/Ubuntu-B.ttf" </i></li></ul></li>
|
||
<li> set other options</li></ul>
|
||
<h2><span class="mw-headline" id="Use">Use</span></h2>
|
||
<ul><li> Auto: Vertical + parallel. Point1 and point2 you click decide the string, and the point3 decide direction and the position.</li>
|
||
<li> 2Point: The string is the distance of the point1 and point2. Point3 decide the position of the string.</li>
|
||
<li> Vertical: Just like auto, but the direction must be vertical.</li>
|
||
<li> <del>Parallel: Just like auto, but the direction must be parallel.</del></li>
|
||
<li> Orthogonal:</li>
|
||
<li> Angle: To click line1 and line2. They will decide a angle. And last point decide the position of the string.</li>
|
||
<li> Custom: Mmake a String what you enter. Point1 is the start. point2 is the end.</li>
|
||
<li> Del obj: It can delete the dimension you make. Just click it and what you clicked will be deleted.</li>
|
||
<li> </li>
|
||
<li> </li></ul>
|
||
<h2><span class="mw-headline" id="Limitations_and_things_to_improve">Limitations and things to improve</span></h2>
|
||
<ul><li> When lines are moved, the dimensions do not follow the design</li>
|
||
<li> <del>parallel functions as "orthogonal" (to me)</del> <i>solved, parallel has been removed</i></li>
|
||
<li> <del>path for .ttf is lost when exit, or Freecad is closed</del> <i>solved, now the path is set in the code</i></li>
|
||
<li> It can not be paused, but it is always active, or exit</li>
|
||
<li> It works only in the xy plane, or planes parallel to the xy</li>
|
||
<li> When you break a dimension, disappear all properties</li></ul>
|
||
<h2><span class="mw-headline" id="Script">Script</span></h2>
|
||
<ul><li> download from the forum, here it is not accepted</li>
|
||
<li> if it is present, remove the line 9 "import GSDraftGeomUtils"</li></ul>
|
||
<p><br />
|
||
</p>
|
||
<h2><span class="mw-headline" id="Links_2">Links</span></h2>
|
||
<ul><li> <a rel="nofollow" class="external text" href="http://forum.freecadweb.org/viewtopic.php?f=22&t=13814">Discussion in the forum</a> </li></ul>
|
||
<h2><span class="mw-headline" id="Other_similar_instruments">Other similar instruments</span></h2>
|
||
<p><br /><br /><br /><br /><br />
|
||
</p>
|
||
<h1><span class="mw-headline" id="Sandbox_for_PartDesign_Fillet">Sandbox for PartDesign Fillet</span></h1>
|
||
<p>Some considerations about Part Design Fillet.
|
||
</p><p>Fillet is a useful tool, very agile for certain operations, but subject to certain limitations.
|
||
</p><p>The examples are based on a cube 10x10x20.
|
||
</p><p><b>First case. Fillet on an edge.</b>
|
||
</p><p><a href="https://www.freecadweb.org/wiki/index.php?title=File:Imm1.png" class="image"><img alt="Imm1.png" src="Imm1.png" width="454" height="333" /></a>
|
||
</p><p>In appearance this tool acts on an edge, but in reality creates a curved surface that joins two other surfaces.
|
||
Therefore it uses two faces as references, for example the side face and the upper face of a cube.
|
||
At the edge that separates them can be applied a rounding with a radius equal to the limit dimension of the smaller face less a "residual safety value" of 0.0001 (according to the value of decimal set).
|
||
The "security value" serves to maintain existing a small surface, in this case large 0.0001.
|
||
</p><p><a href="https://www.freecadweb.org/wiki/index.php?title=File:Imm2.png" class="image"><img alt="Imm2.png" src="Imm2.png" width="521" height="285" /></a>
|
||
</p><p>When one of the two surfaces that are connected disappears completing the operation fails because it lacks one of the references used by the function, and the result is unpredictable.
|
||
</p><p><b>Second case. Fillet applied on two opposite edges of the same face.</b>
|
||
</p><p><a href="https://www.freecadweb.org/wiki/index.php?title=File:Imm3.png" class="image"><img alt="Imm3.png" src="Imm3.png" width="530" height="320" /></a>
|
||
</p><p>In this case, there is not a limit radius, but the limit is (R1 + R2 <thickness-0.0001).
|
||
The limit is valid if R1 or R2 are not superior to others thicknesses involved in the operation (eg. The height of the cube).
|
||
The "residual safety value" is positioned at the junction of the fillets.
|
||
</p><p><a href="https://www.freecadweb.org/wiki/index.php?title=File:Imm4.png" class="image"><img alt="Imm4.png" src="Imm4.png" width="416" height="296" /></a>
|
||
<a href="https://www.freecadweb.org/wiki/index.php?title=File:Imm5.png" class="image"><img alt="Imm5.png" src="Imm5.png" width="423" height="271" /></a>
|
||
</p><p><br />
|
||
It is recommended to use this function only when modeling is ended, to eliminate "sharp corners", and instead use alternative tools to produce the model.
|
||
</p><p><b>Alternative methods of rounding.</b>
|
||
</p><p>A simple method to create the rounded surfaces in a continuous manner, without the "surface residue" is, for example, to create a "cleaner" sketch on the front face as in this figure
|
||
</p><p><a href="https://www.freecadweb.org/wiki/index.php?title=File:Imm6.png" class="image"><img alt="Imm6.png" src="Imm6.png" width="642" height="291" /></a>
|
||
</p><p>and then apply a Pocket -> Through all.
|
||
It returns a completely clean solid, without any interruption of the rounding surface.
|
||
Adequately shaping the sketch you can create any profile, even eccentric.
|
||
</p><p><a href="https://www.freecadweb.org/wiki/index.php?title=File:Imm7.png" class="image"><img alt="Imm7.png" src="Imm7.png" width="624" height="326" /></a>
|
||
</p><p>Even the Boolean operations allow to obtain the same result, but the dependence of the elements is different.
|
||
</p><p>Since version 0.16_pre 6692 FreeCAD has been equipped with an extra check if fillet and chamfer operation returns valid shape.
|
||
</p>
|
||
<h2><span class="mw-headline" id="Links_3">Links</span></h2>
|
||
<p><a rel="nofollow" class="external free" href="http://forum.freecadweb.org/viewtopic.php?f=21&t=15141">http://forum.freecadweb.org/viewtopic.php?f=21&t=15141</a>
|
||
</p><p><br />
|
||
</p>
|
||
<h2><span class="mw-headline" id="Others">Others</span></h2>
|
||
<p><b>PartDesign</b>
|
||
</p><p>Lines created by a PartDesign Fillet can not be selected for an additional fillet or a chamfer.
|
||
</p><p>PartDesign Chamfer has the same behavior.
|
||
</p><p>Lines created by a Chamfer can be selected for an additional chamfer or fillet.
|
||
</p><p>PartDesign fillet and chamfer on tangent edges..........
|
||
</p><p><b>Part</b> .......... many things are similar.
|
||
</p><p><br />
|
||
</p><p><br />
|
||
</p>
|
||
|
||
|
||
|
||
|
||
</div>
|
||
|
||
</div><div class="printfooter">
|
||
Online version: "<a dir="ltr" href="https://www.freecadweb.org/wiki/index.php?title=WikiPages&oldid=227548">http://www.freecadweb.org/wiki/index.php?title=WikiPages&oldid=227548</a>"</div>
|
||
<div id="catlinks" class="catlinks" data-mw="interface"></div><div class="visualClear"></div>
|
||
</div>
|
||
</div>
|
||
<div id="mw-navigation">
|
||
<h2>Navigation menu</h2>
|
||
|
||
</body></html> |