FPDoc Editor/ru: what changed
Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | - | ||
| 2 | - | ||
| 3 | - | ||
| 4 | - | ||
| 5 | - | ||
| 6 | - | ||
| 7 | - | ||
| 8 | - | ||
| 9 | - | ||
| 10 | 1 | ## Вступление | |
| 11 | 2 | ||
| 12 | - | ||
| 3 | + | FPDoc это встроенное в Lazarus средство для формирования документации к модулям Free Pascal. Подробное описание FPDoc есть на английском языке: [Free Pascal documentation tool manual](http://www.freepascal.org/docs-html/fpdoc/fpdoc.html). | |
| 13 | 4 | ||
| 14 | - | ||
| 5 | + |  | |
| 15 | 6 | ||
| 16 | - | ||
| 7 | + | Lazarus включает средство просмотра FPDoc-справки во всплывающих подсказках к именам в исходном коде и два редактора FPDoc, которые могут использоваться для создания и поддержки документации к исходникам. Более простой редактор интегрирован в Lazarus IDE так и называется, **FPDoc Editor** (Редактор FPDoc), и именно он описан на этой странице. Для его работы достаточнов настройках Lazarus в разделе FPDoc добавить пути к папкам с документацией. | |
| 17 | 8 | ||
| 18 | - | ||
| 9 | + | Существует также более мощный редактор, который называется [[Lazarus Documentation Editor|LazDE]]. **LazDE** - старший брат **FPDoc Editor**, и полностью называется Lazarus Documentation Editor. Это самостоятельное приложение, оно не интегрировано в Lazarus IDE. Поставляется в исходниках, проект расположен в папке (\$LazDir)/doceditor/lazde.lpi. Скомпилируйте проект lazde однажды (используя Lazarus), и затем запускайте LazDE независимо. Можно добавить его в меню Tools (Сервис) как "внешнее средство". | |
| 19 | 10 | ||
| 20 | 11 | ## Использование редактора FPDoc | |
| 21 | 12 | ||
| 22 | - | ||
| 13 | + | Чтоб воспользоваться FPDoc Editor достаточно: | |
| 23 | 14 | ||
| 24 | - | ||
| 15 | + | 1\. Открыть пункт FPDoc Editor (Редактор FPDoc) в меню View (Вид). | |
| 25 | 16 | ||
| 26 | - | ||
| 17 | + | 2\. В редакторе исходного кода Lazarus поставить курсор на нужный элемент кода. Вы заметите, что заголовок окна редактора FPDoc изменился, и показывает имя этого элемента вместе с именем файла документации. В редакторе FPDoc Вы можете перейти на подходящую вкладку чтобы редактировать соответствующий тег документации. И естественно, Вы можете использовать редактор FPDoc и для просмотра имеющейся документации, не начиная менять её. | |
| 27 | 18 | ||
| 28 | - | ||
| 19 | + | 3\. Нажать кнопку Create Help (Создать элемент справки). Если Вы ещё не настроили пути для файлов FPDoc, IDE спросит, где хранить генерируемые файлы. Обычно у каждого проекта создают свою папку 'docs'. | |
| 29 | 20 | ||
| 30 | - | ||
| 21 | + | 4\. Вписать краткое описание | |
| 31 | 22 | ||
| 32 | - | ||
| 23 | + | 5\. Нажать кнопку Save слева или просто перейти к следующему элементу исходников (редактор автоматически сохраняет внесённые изменения по элементу, когда курсор с него уходит). | |
| 33 | 24 | ||
| 34 | 25 | ## FPDoc для поставляемых исходников LCL и самого Lazarus | |
| 35 | 26 | ||
| 36 | - | ||
| 27 | + | Лежат в папке (\$LazDir)\docs\xml, добавьте её в пути редактора FPDoc в Tools / Options / Environment / FPDoc Editor (Сервис / Параметры / Окружение / Редактор FPDoc) | |
| 37 | 28 | ||
| 38 | 29 | ## Редактирование FPDoc для поставляемых исходников FPC, RTL and FCL | |
| 39 | 30 | ||
| 40 | - | ||
| 41 | - | ||
| 31 | + | Файлы FPDoc для исходников FPC могут быть взяты из svn: | |
| 32 | + | ||
| 33 | + | ``` bash | |
| 42 | 34 | cd /home/username/yourchoice/ | |
| 43 | - | ||
| 35 | + | svn co http://svn.freepascal.org/svn/fpcdocs/trunk fpcdocs | |
| 44 | 36 | ``` | |
| 45 | 37 | ||
| 46 | - | ||
| 38 | + | Добавьте путь */home/username/yourchoice/fpcdocs* в Tools / Options / Environment / FPDoc Editor (Сервис / Параметры / Окружение / Редактор FPDoc) | |
| 47 | 39 | ||
| 48 | - | ||
| 40 | + | Для проверки результата можно посмотреть, например, на FPDoc для *TComponent.Name*. | |
| 49 | 41 | ||
| 50 | 42 | ## Планы на будущее | |
| 51 | 43 | ||
| 52 | - | ||
| 44 | + | Список todo сейчас содержит следующие пункты (расположены не в порядке приоритетности): | |
| 53 | 45 | ||
| 54 | - | ||
| 55 | - | ||
| 56 | - | ||
| 46 | + | - Write a help editor for topics. | |
| 47 | + | - Create nicer HTML output for the hint windows. | |
| 48 | + | - Support Operators | |
| 57 | 49 | ||
| 58 | 50 | ### Уже сделано | |
| 59 | 51 | ||
| 60 | - | ||
| 61 | - | ||
| 62 | - | ||
| 63 | - | ||
| 64 | - | ||
| 65 | - | ||
| 66 | - | ||
| 67 | - | ||
| 68 | - | ||
| 69 | - | ||
| 70 | - | ||
| 71 | - | ||
| 72 | - | ||
| 73 | - | ||
| 74 | - | ||
| 75 | - | ||
| 76 | - | ||
| 77 | - | ||
| 78 | - | ||
| 52 | + | - Extend the link editor to show packages and identifiers | |
| 53 | + | - Add documentation tags "example" to FPDoc Editor | |
| 54 | + | - Add documentation tags "topic" to FPDoc Editor | |
| 55 | + | - Make FPDoc Editor create new elements in documentation | |
| 56 | + | - Make FPDoc Editor create new documentation files | |
| 57 | + | - Adding a small toolbar makes it possible to use the available markup tags | |
| 58 | + | - Make FPDoc Editor work on keydown in source code editor | |
| 59 | + | - Add FPDoc Editor to IDE settings (showing and position in IDE) | |
| 60 | + | - Make it work for fpc sources (rtl files already exist) | |
| 61 | + | - Add settings to environment menu | |
| 62 | + | - Make it work on project files also | |
| 63 | + | - Propose to expand documentation tags with: "todo" and "notes" (no need for that, as there are alternatives) | |
| 64 | + | - Reduce overhead even further | |
| 65 | + | - All source elements are interpreted by FPDoc Editor using codetools | |
| 66 | + | - Find inherited entries. For example TControl.Align of TButton.Align | |
| 67 | + | - Optimization: inherited Entries are parsed on idle | |
| 68 | + | - Optimization: xml files are cached, and only parsed once or if they changed on disk | |
| 69 | + | - Add a HTML viewer. This is available by installing the turbopoweriprodsgn package | |
| 70 | + | - Checks for invalid xml tags and auto repairs them | |
| 79 | 71 | ||
| 80 | 72 | --- | |
| 81 | - | ||
| 73 | + | *From the Free Pascal wiki, page "FPDoc Editor/ru", as it stood on 2020-08-22 after a change by Nashev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* | |
| 74 | + | Category: Russian (unfinished translation) |