diff options
author | Darrell Anderson <darrella@hushmail.com> | 2014-01-21 22:06:48 -0600 |
---|---|---|
committer | Timothy Pearson <kb9vqf@pearsoncomputing.net> | 2014-01-21 22:06:48 -0600 |
commit | 0b8ca6637be94f7814cafa7d01ad4699672ff336 (patch) | |
tree | d2b55b28893be8b047b4e60514f4a7f0713e0d70 /tde-i18n-ru/docs/tdesdk/umbrello/code_import_and_generation.docbook | |
parent | a1670b07bc16b0decb3e85ee17ae64109cb182c1 (diff) | |
download | tde-i18n-0b8ca6637be94f7814cafa7d01ad4699672ff336.tar.gz tde-i18n-0b8ca6637be94f7814cafa7d01ad4699672ff336.zip |
Beautify docbook files
Diffstat (limited to 'tde-i18n-ru/docs/tdesdk/umbrello/code_import_and_generation.docbook')
-rw-r--r-- | tde-i18n-ru/docs/tdesdk/umbrello/code_import_and_generation.docbook | 157 |
1 files changed, 37 insertions, 120 deletions
diff --git a/tde-i18n-ru/docs/tdesdk/umbrello/code_import_and_generation.docbook b/tde-i18n-ru/docs/tdesdk/umbrello/code_import_and_generation.docbook index 40f2382780b..53bf84024b9 100644 --- a/tde-i18n-ru/docs/tdesdk/umbrello/code_import_and_generation.docbook +++ b/tde-i18n-ru/docs/tdesdk/umbrello/code_import_and_generation.docbook @@ -1,165 +1,82 @@ <chapter id="code-import-generation"> -<title ->Импорт и генерация кода</title> -<para ->&umbrello; является средством &UML;-моделирования, и его главной целью является помощь в <emphasis ->анализе и проектировании</emphasis -> ваших систем. Тем не менее, для перехода от вашего проекта к его <emphasis ->реализации</emphasis ->, &umbrello; позволяет вам сгенерировать исходный код для различных языков программирования . Если вам понадобится использовать &UML; для существующего проекта на C++, &umbrello; может помочь в создании модели вашей системы на основе исходного кода, с помощью его анализа и импорта обнаруженных классов. </para> +<title>Импорт и генерация кода</title> +<para>&umbrello; является средством &UML;-моделирования, и его главной целью является помощь в <emphasis>анализе и проектировании</emphasis> ваших систем. Тем не менее, для перехода от вашего проекта к его <emphasis>реализации</emphasis>, &umbrello; позволяет вам сгенерировать исходный код для различных языков программирования . Если вам понадобится использовать &UML; для существующего проекта на C++, &umbrello; может помочь в создании модели вашей системы на основе исходного кода, с помощью его анализа и импорта обнаруженных классов. </para> <sect1 id="code-generation"> -<title ->Генерация кода</title> -<para ->&umbrello; может генерировать исходный код для различных языков программирования на основе вашей модели &UML;, помогая вам начать реализацию вашего проекта. Сгенерированный код состоит из объявлений классов с их методами и атрибутами, вам остаётся только <quote ->заполнить пустые места</quote -> для реализации функциональности вашего класса. </para> -<para ->&umbrello; 1.2 поставляется с поддержкой генерации кода для ActionScript, Ada, C++, CORBA IDL, &Java;, JavaScript, <acronym ->PHP</acronym ->, Perl, Python, SQL и XMLSchema. </para> +<title>Генерация кода</title> +<para>&umbrello; может генерировать исходный код для различных языков программирования на основе вашей модели &UML;, помогая вам начать реализацию вашего проекта. Сгенерированный код состоит из объявлений классов с их методами и атрибутами, вам остаётся только <quote>заполнить пустые места</quote> для реализации функциональности вашего класса. </para> +<para>&umbrello; 1.2 поставляется с поддержкой генерации кода для ActionScript, Ada, C++, CORBA IDL, &Java;, JavaScript, <acronym>PHP</acronym>, Perl, Python, SQL и XMLSchema. </para> <sect2 id="generate-code"> -<title ->Генерация кода</title> -<para ->Для генерации кода с помощью &umbrello; вам сперва необходимо создать или загрузить модель, содержащую хотя бы один класс. При необходимости работы с исходным кодом выберите элемент <guimenuitem ->Мастер генерации кода</guimenuitem -> меню <guimenuitem ->Код</guimenuitem -> для запуска мастера, который проведёт вас через процесс генерации кода. </para> -<para ->Первым шагом будет указание классов, для которых требуется сгенерировать код. По умолчанию выбираются все классы вашей модели, вы имеете возможность убрать выделение с ненужных классов, перемещая их на левую сторону списка. </para> -<para ->Следующим шагом будет модификация параметров генератора кода. Доступны следующие опции: </para> +<title>Генерация кода</title> +<para>Для генерации кода с помощью &umbrello; вам сперва необходимо создать или загрузить модель, содержащую хотя бы один класс. При необходимости работы с исходным кодом выберите элемент <guimenuitem>Мастер генерации кода</guimenuitem> меню <guimenuitem>Код</guimenuitem> для запуска мастера, который проведёт вас через процесс генерации кода. </para> +<para>Первым шагом будет указание классов, для которых требуется сгенерировать код. По умолчанию выбираются все классы вашей модели, вы имеете возможность убрать выделение с ненужных классов, перемещая их на левую сторону списка. </para> +<para>Следующим шагом будет модификация параметров генератора кода. Доступны следующие опции: </para> <para> <screenshot> -<screeninfo ->Опции генерации кода</screeninfo> +<screeninfo>Опции генерации кода</screeninfo> <mediaobject> <imageobject> <imagedata fileref="generation-options.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Опции для генерации кода в &umbrello;</phrase> + <phrase>Опции для генерации кода в &umbrello;</phrase> </textobject> <caption> - <para ->Опции для генерации кода в &umbrello; </para> + <para>Опции для генерации кода в &umbrello; </para> </caption> </mediaobject> </screenshot> </para> <sect3 id="generation-options"> -<title ->Опции генерации</title> +<title>Опции генерации</title> <!-- LW; to rearrange --> <sect4> -<title ->Автокомментирование кода</title> -<para ->В режиме <guilabel ->Записывать пустые комментарии</guilabel -> генератор кода будет писать комментарии вида /** тра-ля-ля */, даже если комментируемые блоки пустые. Если вы добавите документацию в классы, методы или атрибуты вашей модели, генератор кода запишет эти комментарии как документацию для <application ->Doxygen</application -> независимо от этой опции. Но если вы включили данную опцию, &umbrello; запишет блоки комментариев для всех классов, методов и атрибутов, даже если никакой документации в модели не было. В этом случае вам следует задокументировать ваши классы позднее прямо в исходном коде. </para> -<para ->Опция <guilabel ->Записывать комментарии для пустых секций</guilabel -> указывает &umbrello; записывать комментарии в исходный код для разграничения различных секций класса. Например, <quote ->public methods</quote -> или <quote ->Attributes</quote -> перед соответствующими секциями. Если вы включите данную опцию, &umbrello; будет записывать комментарии для всех секций класса, даже если некоторые из них будут пустыми. Например, будет записан комментарий <quote ->protected methods</quote ->, даже если в вашем классе нет методов, объявленных как <quote ->protected</quote ->. </para> +<title>Автокомментирование кода</title> +<para>В режиме <guilabel>Записывать пустые комментарии</guilabel> генератор кода будет писать комментарии вида /** тра-ля-ля */, даже если комментируемые блоки пустые. Если вы добавите документацию в классы, методы или атрибуты вашей модели, генератор кода запишет эти комментарии как документацию для <application>Doxygen</application> независимо от этой опции. Но если вы включили данную опцию, &umbrello; запишет блоки комментариев для всех классов, методов и атрибутов, даже если никакой документации в модели не было. В этом случае вам следует задокументировать ваши классы позднее прямо в исходном коде. </para> +<para>Опция <guilabel>Записывать комментарии для пустых секций</guilabel> указывает &umbrello; записывать комментарии в исходный код для разграничения различных секций класса. Например, <quote>public methods</quote> или <quote>Attributes</quote> перед соответствующими секциями. Если вы включите данную опцию, &umbrello; будет записывать комментарии для всех секций класса, даже если некоторые из них будут пустыми. Например, будет записан комментарий <quote>protected methods</quote>, даже если в вашем классе нет методов, объявленных как <quote>protected</quote>. </para> </sect4> <sect4> -<title ->Каталоги</title> -<para ->Опция <guilabel ->Сохранять сгенерированные файлы в каталог</guilabel ->. Здесь вам следует указать каталог, куда &umbrello; поместит сгенерированный исходный код. </para> -<para ->Опция <guilabel ->Подключать заголовочные файлы из каталога</guilabel -> позволяет вам вставить заголовки в начало каждого сгенерированного файла. Заголовочные файлы могут содержать сведения об авторских правах или лицензии, а также переменные, вычисляемые во время генерации кода. Вы можете ознакомиться с заголовочными файлами, поставляемыми с &umbrello;, чтобы понять, как использовать эти переменные для указания вашего имени или текущей даты во время генерации кода. </para> +<title>Каталоги</title> +<para>Опция <guilabel>Сохранять сгенерированные файлы в каталог</guilabel>. Здесь вам следует указать каталог, куда &umbrello; поместит сгенерированный исходный код. </para> +<para>Опция <guilabel>Подключать заголовочные файлы из каталога</guilabel> позволяет вам вставить заголовки в начало каждого сгенерированного файла. Заголовочные файлы могут содержать сведения об авторских правах или лицензии, а также переменные, вычисляемые во время генерации кода. Вы можете ознакомиться с заголовочными файлами, поставляемыми с &umbrello;, чтобы понять, как использовать эти переменные для указания вашего имени или текущей даты во время генерации кода. </para> </sect4> <sect4> -<title ->Правила перезаписи</title> +<title>Правила перезаписи</title> <!-- FIXME update for Umbrello 1.2's new C++ and Java code generators --> -<para ->Данная опция указывает Umbrello, что следует делать, если создаваемый файл уже существует. Umbrello <emphasis ->не может изменять существующие исходные файлы</emphasis ->, таким образом, вы должны выбрать между перезаписью существующего файла, отменой генерации конкретного файла или позволить Umbrello выбрать другое имя файла. Если вы предпочли выбрать другое имя файла, Umbrello добавит суффикс к текущему имени файла. </para> +<para>Данная опция указывает Umbrello, что следует делать, если создаваемый файл уже существует. Umbrello <emphasis>не может изменять существующие исходные файлы</emphasis>, таким образом, вы должны выбрать между перезаписью существующего файла, отменой генерации конкретного файла или позволить Umbrello выбрать другое имя файла. Если вы предпочли выбрать другое имя файла, Umbrello добавит суффикс к текущему имени файла. </para> </sect4> <sect4> -<title ->Язык</title> -<para ->По умолчанию &umbrello; будет генерировать код на языке, который вы указали в качестве активного языка, но мастер генерации кода позволяет указать другой язык. </para> +<title>Язык</title> +<para>По умолчанию &umbrello; будет генерировать код на языке, который вы указали в качестве активного языка, но мастер генерации кода позволяет указать другой язык. </para> </sect4> -</sect3 -><!--generation-options--> +</sect3><!--generation-options--> <sect3 id="generation-wizard-generation"> -<title ->Мастер генерации</title> -<para ->Третий и последний шаг помощника показывает состояние процесса генерации кода. Вам надо только нажать на кнопку Сгенерировать, чтобы получить ваши классы в виде исходного кода. </para> -<para ->Следует отметить, что опции, которые вы выбрали в мастере генерации кода, верны только для текущего момента. При следующем запуске мастера вам потребуется заново указать все опции (каталог с заголовочными файлами, правила перезаписи и так далее). Можно настроить значения по умолчанию в разделе <guilabel ->Генерация кода</guilabel -> настроек Umbrello, доступной через <menuchoice -><guimenu ->Настройка</guimenu -> <guimenuitem ->Настроить Umbrello...</guimenuitem -></menuchoice -> </para> -<para ->Если вы настроили опции генерации кода и хотите сгенерировать код без использования помощника, можете выбрать <guimenuitem ->Генерировать весь код</guimenuitem -> из меню Код. При этом сгенерируется код для всех классов вашей модели с использованием текущих настроек (включая каталог назначения и правила перезаписи, так что будьте осторожны). </para> +<title>Мастер генерации</title> +<para>Третий и последний шаг помощника показывает состояние процесса генерации кода. Вам надо только нажать на кнопку Сгенерировать, чтобы получить ваши классы в виде исходного кода. </para> +<para>Следует отметить, что опции, которые вы выбрали в мастере генерации кода, верны только для текущего момента. При следующем запуске мастера вам потребуется заново указать все опции (каталог с заголовочными файлами, правила перезаписи и так далее). Можно настроить значения по умолчанию в разделе <guilabel>Генерация кода</guilabel> настроек Umbrello, доступной через <menuchoice><guimenu>Настройка</guimenu> <guimenuitem>Настроить Umbrello...</guimenuitem></menuchoice> </para> +<para>Если вы настроили опции генерации кода и хотите сгенерировать код без использования помощника, можете выбрать <guimenuitem>Генерировать весь код</guimenuitem> из меню Код. При этом сгенерируется код для всех классов вашей модели с использованием текущих настроек (включая каталог назначения и правила перезаписи, так что будьте осторожны). </para> </sect3> -</sect2 -><!--generate-code--> -</sect1 -> <!--code-generation--> +</sect2><!--generate-code--> +</sect1> <!--code-generation--> <sect1 id="code-import"> -<title ->Импорт кода</title> -<para ->Umbrello может импортировать исходный код ваших существующих проектов для помощи в построении моделей для ваших систем. &umbrello; 1.2 поддерживает исходный код на языке C++ , но поддержка других будет добавлена в будущих версиях. </para> -<para ->Для импортирования классов в вашу модель выберите <guimenuitem ->Импортировать классы...</guimenuitem -> из меню <guimenu ->Код</guimenu ->. В диалоге выбора файлов укажите файлы, содержащие объявления классов C++, и нажмите OK. Классы будут импортированы и появятся в виде элементов модели в дереве модели. Следует отметить, что Umbrello не создаёт никакой диаграммы для отображения ваших классов, они просто импортируются в модель, и вы можете их использовать при построении любых диаграмм. </para> +<title>Импорт кода</title> +<para>Umbrello может импортировать исходный код ваших существующих проектов для помощи в построении моделей для ваших систем. &umbrello; 1.2 поддерживает исходный код на языке C++ , но поддержка других будет добавлена в будущих версиях. </para> +<para>Для импортирования классов в вашу модель выберите <guimenuitem>Импортировать классы...</guimenuitem> из меню <guimenu>Код</guimenu>. В диалоге выбора файлов укажите файлы, содержащие объявления классов C++, и нажмите OK. Классы будут импортированы и появятся в виде элементов модели в дереве модели. Следует отметить, что Umbrello не создаёт никакой диаграммы для отображения ваших классов, они просто импортируются в модель, и вы можете их использовать при построении любых диаграмм. </para> <para> <screenshot> -<screeninfo ->Импорт кода</screeninfo> +<screeninfo>Импорт кода</screeninfo> <mediaobject> <imageobject> <imagedata fileref="code-import.png" format="PNG"/> </imageobject> <textobject> - <phrase ->Меню для импорта исходного кода в Umbrello</phrase> + <phrase>Меню для импорта исходного кода в Umbrello</phrase> </textobject> <caption> - <para ->Меню для импорта исходного кода в Umbrello </para> + <para>Меню для импорта исходного кода в Umbrello </para> </caption> </mediaobject> </screenshot> </para> </sect1> -</chapter -> <!--code-import-generation--> +</chapter> <!--code-import-generation--> |