Оформление статей

Материал из BiTel WiKi

(Различия между версиями)
Перейти к: навигация, поиск
(Категории (теги))
Строка 60: Строка 60:
Вот как она выглядит:{{Модуль}}
Вот как она выглядит:{{Модуль}}
При добавлении нового модуля администраторам wiki необходимо добавить новые записи в этот шаблон "Модуль", через его редактирование.
При добавлении нового модуля администраторам wiki необходимо добавить новые записи в этот шаблон "Модуль", через его редактирование.
 +
 +
== Указание актуальности статьи номеру версии ==
 +
При выкладывании каких-то решений чаще всего они соответствуют какой-то версии системы. При особенно строгом соответствии можно пользоваться шаблоном <tt><nowiki>{{Актуальность Версии}}</nowiki></tt>, чтобы обратить особое внимание, что на других версиях скорее всего работать не будет, во избежании многочисленных тем на форуме "сделал как wiki, не работает". Вот как выглядит эта плашка:
 +
{{Актуальность Версии}}

Версия 11:47, 13 января 2011

Содержание

Форматирование исходного кода скриптов

Используйте тег source (только без пробела в конце):

<source lang="java"> скрипт < /source>

Пример:

check = event.getCheck();
 
check.addString( "Приходите ещё" );
check.addString( "С новым годом!" );

Форматирование исходного кода SQL-запросов

Здесь также поможет тег source:

<source lang="sql"> запрос < /source>

Пример:

SELECT * FROM contract

Ссылки на другие статьи

Общий синтаксис:

[[Имя_страницы#секция|текст ссылки]]

Просто на страницу:

[[Имя_страницы|текст ссылки]] или [[Имя_страницы]]

Решётка позволяет указать подраздел (секцию) на странице. Если подраздел на той же странице, то название страницы можно опустить:

[[#секция|текст ссылки]] или [[#секция]]

Категории (теги)

Помогают лучше структурировать информацию и разбивать статьи по модулям, например. Категории рисуются внизу страницы (см. ниже категория "Помощь"). Чтобы отнести статью к одной или нескольким категориям, надо добавить в текст статьи одну или несколько записей вида

[[Категория:Имя категории]]

Захламлять категории разными похожими категориями не стоит, предпочтительнее брать готовые категории, список существующих категорий можно посмотреть здесь: Служебная:Categories

Оформление страницы модулей и плагинов

Для каждой главной страницы модулей и плагинов внизу полезно добавить табличку со всеми модулями и плагинами. Это делается вставкой внизу страницы кода:

{{Модуль}}

Вот как она выглядит:

Другие модули и плагины:
Ядро: Ядро системы
Модули: DialUp | VoIP | IPN | Card | Pay | Phone | E-Mail | Bill | Reports | CerberCrypt | NPAY | RSCM | WebMoney | MPS | Assist | DBA | GOROD | TrayInfo | DrWeb
Плагины: CRM | CashCheck | Documents | HelpDesk | КЛАДР | Organizer

При добавлении нового модуля администраторам wiki необходимо добавить новые записи в этот шаблон "Модуль", через его редактирование.

Указание актуальности статьи номеру версии

При выкладывании каких-то решений чаще всего они соответствуют какой-то версии системы. При особенно строгом соответствии можно пользоваться шаблоном {{Актуальность Версии}}, чтобы обратить особое внимание, что на других версиях скорее всего работать не будет, во избежании многочисленных тем на форуме "сделал как wiki, не работает". Вот как выглядит эта плашка:

Внимание! Данное решение/метод/статья относится к версии и для других версий может быть неактуальна! Вам нужно самостоятельно поправить решение под свои нужды или воспользоваться помощью на форуме. Будем признательны, если внизу страницы или отдельной статьёй вы разместите исправленное решение для другой версии или подсказки что надо исправить.

Личные инструменты