WikiPages/ru

This page is an extension of the Help:Editing page and gives common guidelines for writing and updating the FreeCAD wiki documentation. It summarizes several discussions and brainstorming sessions

Прежде чем начать

 * Эта вики - документация основана на MediaWiki, это программное обеспечение, абсолютно аналогичное Википедии. Если вы до этого вносили правки в Википедию, то редактирование вики-страниц FreeCAD для вас должно быть легкой задачей.
 * В отличие от Википедии, вики FreeCAD защищена от записи, чтобы избежать спама. Вы должны запросить учетную запись на форуме.
 * Если вы никогда раньше не использовали программное обеспечение wiki, пожалуйста, прочитайте Help:Editing, чтобы ознакомиться с используемой разметкой.
 * Для расширенного использования программного обеспечения wiki см. MediaWiki Справка:Содержание. Не все функции MediaWiki доступны в этой вики FreeCAD, но многие из них доступны.
 * Нам нравится, чтобы документация была легкой для чтения, поэтому избегайте использования сложных функций. Пусть все будет просто.
 * Используйте песочницу для тестирования кода, например, FreeCADDocu:Sandbox или конкретную страницу с вашим именем Sandbox:Yourname.
 * Пожалуйста, обратите внимание на переводы. Вики FreeCAD использует поддержку автоматического перевода для предоставления страниц на многих языках. Для каждой страницы может существовать несколько языковых версий. На многих страницах вы увидите теги, такие как  и множество отдельных тегов, таких как  . Последние создаются системой перевода. Они связывают заголовки и абзацы со своими переведенными версиями. Вы не должны изменять их, так как это разрушит эти ссылки. Однако можно перемещать абзацы или изменять формулировки до тех пор, пока теги остаются с ними. Если вы удаляете заголовок или абзац, вы также должны удалить принадлежащий ему тег. Пожалуйста, имейте в виду, что изменения в существующих заголовках и абзацах влияют на текущие переводы. Ваши изменения должны быть действительно важны, чтобы этого стоить. Не беспокойтесь при добавлении нового материала, потому что система автоматически добавит новые теги после ваших изменений. Для получения дополнительной информации см. Локализация и оригинал Mediawiki:Пример страницы для перевода.

Краткие описания
При описании FreeCAD старайтесь быть краткими, избегать повторений и излагать свои мысли по существу. Опишите, то что FreeCAD "может сделать", а не то, что он "не может". Также избегайте разговорных выражений, таких напримаер как "пара","около того","вроде". Когда имеете дело с неопределенным числом, пишите "некоторое значение" или укажите корректное количество.


 * Пример плохого описания
 * Верстак PartDesign: верстак PartDesign, это верстак для проектирования деталей который предоставляет инструменты для моделирования сложных твердых деталей.


 * Пример хорошего описания
 * Верстак PartDesign: предоставляет инструменты для проектирования сложных твердых тел.

Централизованная информация
Избегайте дублирования одной и той же информации в разных местах. Вставьте информацию на новую страницу и добавьте ссылку на эту страницу с других страниц, которым требуется эта информация.

Do not use transclusion of pages (Help:Editing#Templates and transcluding pages), as this makes the wiki difficult to translate. Use only the templates described below in #Templates.

Стиллизирование
Templates are used to style the help pages. They give the documentation a consistent look and feel. There is a template for menu commands,, a template to style keys to be pressed, , to show a Boolean value, , etc. Please get familiar with the #Templates section before writing help pages.

Temporary flags
If you are working on a large page it is advisable to mark the page either as a work in progress or as unfinished. This assures that wiki admins don't mark your page as ready for translation while you are still changing it.

To flag a page add either  or   as the first line. With  you invite others to join you in finishing the page, while   indicates that you will do the work yourself and others should give you some time.

Once the work is done, please don't forget to remove the flags!

Примеры
To quickly get familiar with the structure and style of the FreeCAD wiki look at the model page: GuiCommand model.

Structure
The User hub provides a Table of Contents. 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 Template:Docnav is used to sequentially link pages, following to the structure of the Table of Contents. See #Templates for a list of all templates.

Названия Страниц
Page names should be short, and they should use sentence case: all words except the first one and proper names, should be in lowercase. This is the style used by Wikipedia for their articles.


 * Плохое название для страницы:
 * Конструкция Аэропланов AeroCompany


 * Хорошее название:
 * Конструкция аэропланов AeroCompany

The names of top level workbench pages must have this format:, where   is the name of the workbench, for example PartDesign Workbench. And the names of pages describing the commands (or tools) belonging to a workbench must have this format:, for example PartDesign Pad. Note that you should use the command name as it occurs in the source code.

A previous convention was to use title case: every word should begin with a capital letter, unless they are articles, prepositions, conjunctions, or other grammatical particles (f.e. 'of', 'on', 'in', 'a', 'an', 'and'). There are many existing pages using this style, but it is discouraged for new pages. This was discussed in the forum thread (Lowercase links) Use a lower case title for a wiki page.

Заголовки
Like page names, paragraph headings should be short and use sentence case. You should not use  headings  in your wiki markup since the page title is automatically added as the main   heading.

Ссылки
Вы должны использовать оригинальное название ссылки, если это возможно. Это уточняет страницу, на которую ссылается печатная или offline документация. Пожалуйста, избегайте бессмысленных слов для ссылки.


 * Плохая ссылка
 * Для получения более подробной информации по рисованию 2D объектов кликните тута.


 * Хорошая ссылка
 * Для получения более подробной информации о рисовании 2D обратитесь к верстаку Draft.

Предпочтительным форматом для ссылки является:

После перевода:

Note that for the part before the  character, the actual link, case is relevant. If your page name is  the link will fail if you type   (upper case P). Before the  character all spaces should be replaced by underscores. This is to assist translators using translation software, without the underscores the link would be translated by the software which is undesirable.

To link to a certain paragraph add a  sign and its headings to the page name. Example:

После перевода:

Within the same page you can omit the page name. Example:

To link to the top of the page you can use:

This link will even work if there is no 'Top' paragraph on the page. It is especially useful for long pages as it allows the user to quickly jump back to the table of content. You can put it at the end of each paragraph. Make sure there is an empty line before and after the link.

Страницы верстаков
A top level workbench page should start with:
 * A description of what the workbench is used for.
 * An image to illustrate the description.

See #Screen capture for conventions on including images.

Command pages
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 and examples to a minimum. Tutorials can expand on how to use the tool and provide step-by-step details.

Please refer to the GuiCommand model page for more details.

Руководства
A well written tutorial should teach how to achieve certain practical results quickly. It shouldn't be too long, but should include sufficient step-by-step instructions and images to guide the user. As FreeCAD evolves, tutorials may become obsolete, so it is important to mention the FreeCAD version used in, or required for, a tutorial.

For examples visit the Tutorials page.

Шаблоны
Styling of the FreeCAD wiki pages is achieved through the use of templates (Help:Editing). They ensure a standardized look and feel across all pages, and also make it possible to re-style the wiki. You can see the complete list of defined templates by accessing Special:PrefixIndex/Template:. But please only use the templates listed in the tables below. Only in very special cases should you use HTML tags directly.

Click on the template link to see the usage instructions for a template, and to see its implementation. Templates are a powerful feature of the MediaWiki software. You should be an experienced wiki user if you wish to propose additions and modifications to existing templates. If implemented incorrectly, templates make it difficult to translate pages into other languages, so their use should be limited to text formatting, page transclusion should be avoided. See MediaWiki Help:Templates to learn more.

Простейшие шаблоны
Эти шаблоны форматируют простой текстовый параметр в определенном стиле.

Сборные шаблоны
These templates require more input parameters, or produce a block of text with a particular format.

Графика
Изображения и скриншоты необходимы для создания полной документации FreeCAD. Они особенно полезны для иллюстрации примеров и учебных пособий. Изображения должны быть показаны в их оригинальном размере, чтобы они представляли достаточную детализацию и были читабельны, если они содержат в себе текст. Размеры растровых изображений не могут быть изменены.

Избегайте анимированных картинок (GIF) на страницах общей справки. Анимации и видео следует зарезервировать для учебных пособий, не предназначенных для использования в качестве offline документации в формате PDF.

Изображения можно загрузить через Special:Upload страницу.

Name
Give meaningful names to your images. If you have an image that showcases the characteristics of a particular command, you should use the name of that command with at the end. For example for the command Draft Offset the image should be called.

Снимки с экрана
Рекомендуемые размеры для снимков экрана::
 * 400x200 (или ширина=400 и высота<=200) для страниц описывающих команнды Gui, чтобы изображение помещалось в левой части страницы, а также для других стандартных снимков.
 * 600x400 (или ширина=600 и высота<=400), для страниц описывающих команнды Gui, только когда вам действительно нужно изображение большего размера, и при этом старйтесь уместить изображение в левой части страницы, а также для других стандартных снимков.
 * 1024x768 (или ширина=1024 и высота<=768), только для полноэкранных изображений.
 * При отображении деталей возможны меньшие размеры.
 * Избегайте изображений с большим разрешением, так как они не будут очень переносимыми для других видов дисплеев или печатной документации в формате PDF.

Вы не должны зависеть от пользовательской конфигурации вашего рабочего стола или операционной системы при создании скриншотов, по возможности рекомендуется использовать визуальные настройки интерфейса FreeCAD по умолчанию.

To create a screenshots you can use the options provided by your operating system, or one of these macros: Macro Snip and  Macro Screen Wiki.

Text
To ease documentation translations, try to avoid screenshots that contain texts. If you cannot avoid this, consider taking separate screenshots of the interface and the 3D view. The image of the 3D view can be reused in every translation, while a translator can take a screenshot of the localized interface if necessary.

Иконки и графика
Refer to the Artwork page for all artwork and icons that have been created for FreeCAD, and which can also be used in documentation pages. If you would like to contribute icons, please read the Artwork Guidelines.

Переводы
As per general consensus, the reference page in the wiki is the English page, which should be created first. If you want to change or add content to a page, you should do it to the English page first, and only once the update is completed, port the modification to the translated page.

The FreeCAD wiki supports a translation extension that allows managing translations between pages easier; for details, see Localisation Translating the wiki.

Other useful resources are:
 * ISO language codes to identify the two-letter code for a particular language that you want to translate to.
 * Google Translate for help with translations.
 * Deepl translator for help with translations.

Translate GuiCommand
Translated:

Translate navi
Translated:

Translate link
Part Module

Translated:

Atelier Pièces /

Translate Docnav
Translated:

Example with icons:

Translated:

Rename pages
Since FreeCAD is a project under permanent development, it is sometimes necessary to revise the content of the wiki. If the names of commands are changed in the source code, the wiki pages documenting them have to be renamed as well. This can only be done by wiki administrators. To inform them, open a topic in the Wiki forum and list the necessary renaming operation in this form:

old name        new name Old_page_name_1 New_page_name_1 Old_page_name_2 New_page_name_2 ...

Delete files and pages
In case you need to delete a file, go to its page and edit it. No matter if the page is blank or not, add this as the first element:  and directly below it describe why the page should be deleted. Additionally, open a topic in the Wiki forum.

For pages the procedure is the same.

Discussion
The Development/Wiki subforum in the FreeCAD forum provides a dedicated space for discussing wiki topics, the wiki appearance and anything else related to the wiki. Direct your questions and suggestions there.

English
See Glossary.

Other languages

 * Italiano
 * Français
 * Deutsch
 * Polish