Рекомендации по оформлению страниц и разделов

Материал из Forumooo wiki

(Различия между версиями)
Перейти к: навигация, поиск
(initial)
(Пункты меню, контекстного меню и сочетания клавиш)
 
(19 промежуточных версий не показаны.)
Строка 1: Строка 1:
-
{{DISPLAYTITLE:Как оформлять страницы и разделы}}
+
{{DISPLAYTITLE:Рекомендации по оформлению страниц и разделов}}
 +
[[Category:Редакторам]]
 +
Эта вики посвящена, прежде всего, пользователям, ищущим ответы на вопросы по использованию {{Office}}. На этой странице изложены основные рекомендации для редакторов при формировании ответов.
 +
 
 +
==Общие рекомендации==
 +
Используйте как можно меньше нестандартных стилей форматирования, минимум графических изображений и таблиц. Для выделения фрагментов текста пользуйтесь шаблонами, а также '''полужирным''' и ''курсивным'' начертанием. Не пользуйтесь иерархическими списками или другими сложными построениями.
 +
 
 +
Ограничения по произвольному форматированию вызвано необходимостью последующего возможного копирования текстов из этой вики на другие ресурсы, экспорта в PDF или расширение.
 +
 
 +
Для тестов используйте [[Песочница|Песочницу]]
 +
 
 +
==Наименование страниц==
 +
Название страниц пишется в адресной строке латинскими символами. Используйте английские термины, соответствующие теме.
 +
Чтобы отобразить заголовок страницы русскими символами, используйте <nowiki>{{DISPLAYTITLE:Ваше название страницы}}</nowiki>
 +
 
 +
==Оформление вопросов==
 +
Вопросы оформляются заголовками второго, третьего или четвёртого уровней, в зависимости от содержимого страницы. Если на странице не используются разделы, можно оформлять все вопросы заголовками второго уровня.
 +
 
 +
На одной странице могут находиться несколько вопросов соответствующей тематики. Если вопросов слишком много (более двух десятков), лучше разделить их на несколько страниц.
 +
 
 +
==Версии {{Office}}==
 +
Ответы на многие вопросы могут меняться с течением времени. Выходят новые версии {{Office}}, а в них добавляется новая функциональность или исправляются старые баги.
 +
 
 +
Чтобы добавить в свой ответ информацию о версии {{Office}}, которой примерно соответствует текст ответа, используйте шаблон <nowiki>{{version|Номер версии}}</nowiki>. Если ответ соответствует нескольким версиям {{Office}}, указывайте последнюю.
 +
 
 +
==Пункты меню, контекстного меню и сочетания клавиш==
 +
* Когда необходимо указать пункты меню {{Office}}, используйте полужирное начертание, разделяя пункты пробелами и дефисами: '''Формат - Страница'''. Не используйте кавычки.
 +
* Команды контекстного меню также пишутся без кавычек: выберите команду '''Изменить/Создать'''.
 +
 
 +
==Используемые шаблоны==
 +
{|
 +
!Пример и назначение шаблона
 +
!Код для использования
 +
!Примечание
 +
|-
 +
|{{Note|Это примечание}}
 +
|<nowiki>{{Note|Это примечание}}</nowiki>
 +
|Нельзя использовать внутри этого шаблона переводы строк
 +
|-
 +
|{{Warning|Предупреждение}}
 +
|<nowiki>{{Warning|Предупреждение}}</nowiki>
 +
|Нельзя использовать внутри этого шаблона переводы строк
 +
|-
 +
|{{Tip|Совет}}
 +
|<nowiki>{{Tip|Совет}}</nowiki>
 +
|Нельзя использовать внутри этого шаблона переводы строк
 +
|-
 +
|{{Office}}
 +
Шаблон для общего наименование всех офисных пакетов
 +
|<nowiki>{{Office}}</nowiki>
 +
|Нельзя использовать внутри этого шаблона переводы строк
 +
|-
 +
|{{version|3.3}}
 +
Это шаблон, фиксирующий номер версии, для которой данный ответ является актуальным
 +
|<nowiki>{{version|3.3}}</nowiki>
 +
|Нельзя использовать внутри этого шаблона переводы строк
 +
|-
 +
|{{HowToGet|Используйте пункт контекстного меню '''Удалить строку'''}}
 +
|<nowiki>{{HowToGet|Используйте пункт контекстного меню '''Удалить строку'''}}</nowiki>
 +
|Нельзя использовать внутри этого шаблона переводы строк
 +
|-
 +
|
 +
|<nowiki></nowiki>
 +
|
 +
|-
 +
|
 +
|<nowiki></nowiki>
 +
|
 +
|-
 +
|}
 +
 
 +
==Оформление кода==
 +
Для оформления кода можно использовать теги <code><nowiki><source lang="oobas">код</source></nowiki></code>, где параметр <code>lang</code> может меняться в зависимоти от языка кода. Например, {{Office}} Basic имеет параметр <code>lang="oobas"</code>. Например,
 +
{| style="border-spacing:0;"
 +
| style="background-color:transparent;border:none;padding:0.097cm;"|
 +
<pre><nowiki><source lang="oobas">
 +
Dim Doc As Object
 +
Dim Cursor As Object
 +
Doc = ThisComponent
 +
Cursor = Doc.Text.createTextCursor()
 +
</source></nowiki></pre>
 +
| style="background-color:transparent;border:none;padding:0.097cm;"|→→→
 +
| style="background-color:transparent;border:none;padding:0.097cm;"|
 +
<source lang="oobas">
 +
Dim Doc As Object
 +
Dim Cursor As Object
 +
Doc = ThisComponent
 +
Cursor = Doc.Text.createTextCursor()
 +
</source>
 +
 
 +
|}
 +
 
 +
Список поддерживаемых языков можно посмотреть тут: [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi#Supported_languages Supported languages]. Например, Java - <code>lang="java"</code>, JavaScript - <code>lang="javascript"</code>, XML - <code>lang="xml"</code>, SQL - <code>lang="sql"</code>, Python - <code>lang="python"</code> и т.д.

Текущая версия на 05:18, 8 ноября 2010

Эта вики посвящена, прежде всего, пользователям, ищущим ответы на вопросы по использованию LibreOffice/OpenOffice. На этой странице изложены основные рекомендации для редакторов при формировании ответов.

Содержание

Общие рекомендации

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

Ограничения по произвольному форматированию вызвано необходимостью последующего возможного копирования текстов из этой вики на другие ресурсы, экспорта в PDF или расширение.

Для тестов используйте Песочницу

Наименование страниц

Название страниц пишется в адресной строке латинскими символами. Используйте английские термины, соответствующие теме. Чтобы отобразить заголовок страницы русскими символами, используйте {{DISPLAYTITLE:Ваше название страницы}}

Оформление вопросов

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

На одной странице могут находиться несколько вопросов соответствующей тематики. Если вопросов слишком много (более двух десятков), лучше разделить их на несколько страниц.

Версии LibreOffice/OpenOffice

Ответы на многие вопросы могут меняться с течением времени. Выходят новые версии LibreOffice/OpenOffice, а в них добавляется новая функциональность или исправляются старые баги.

Чтобы добавить в свой ответ информацию о версии LibreOffice/OpenOffice, которой примерно соответствует текст ответа, используйте шаблон {{version|Номер версии}}. Если ответ соответствует нескольким версиям LibreOffice/OpenOffice, указывайте последнюю.

Пункты меню, контекстного меню и сочетания клавиш

Используемые шаблоны

Пример и назначение шаблона Код для использования Примечание
Note.pngЭто примечание
{{Note|Это примечание}} Нельзя использовать внутри этого шаблона переводы строк
Warning.pngПредупреждение
{{Warning|Предупреждение}} Нельзя использовать внутри этого шаблона переводы строк
Tip.pngСовет
{{Tip|Совет}} Нельзя использовать внутри этого шаблона переводы строк
LibreOffice/OpenOffice

Шаблон для общего наименование всех офисных пакетов

{{Office}} Нельзя использовать внутри этого шаблона переводы строк

3.3

Это шаблон, фиксирующий номер версии, для которой данный ответ является актуальным

{{version|3.3}} Нельзя использовать внутри этого шаблона переводы строк
Доступ к этой команде

Используйте пункт контекстного меню Удалить строку

{{HowToGet|Используйте пункт контекстного меню '''Удалить строку'''}} Нельзя использовать внутри этого шаблона переводы строк

Оформление кода

Для оформления кода можно использовать теги <source lang="oobas">код</source>, где параметр lang может меняться в зависимоти от языка кода. Например, LibreOffice/OpenOffice Basic имеет параметр lang="oobas". Например,

<source lang="oobas">
Dim Doc As Object
Dim Cursor As Object
Doc = ThisComponent
Cursor = Doc.Text.createTextCursor()
</source>
→→→
Dim Doc As Object
Dim Cursor As Object
Doc = ThisComponent
Cursor = Doc.Text.createTextCursor()

Список поддерживаемых языков можно посмотреть тут: Supported languages. Например, Java - lang="java", JavaScript - lang="javascript", XML - lang="xml", SQL - lang="sql", Python - lang="python" и т.д.

Личные инструменты
Пространства имён
Варианты
Действия
Компоненты
Общие вопросы
Совместимость
Навигация
Инструменты