Редактирование: ESyr's Wiki pages:Editing conventions
Материал из eSyr's wiki.
Внимание: Вы не представились системе. Ваш IP-адрес будет записан в историю изменений этой страницы.
Правка может быть отменена. Пожалуйста, просмотрите сравнение версий, чтобы убедиться, что это именно те изменения, которые вас интересуют, и нажмите «Записать страницу», чтобы изменения вступили в силу.
| Текущая версия | Ваш текст | ||
| Строка 35: | Строка 35: | ||
=====Оформление текста===== | =====Оформление текста===== | ||
| - | Главный принцип — стараться использовать синтаксис вики там, где это возможно. То есть, использование <p>…</p>, <ul>, <strong> и прочих тегов оформления является излишним. Тем не менее, если же средств вики не хватает для достижения необходимого форматирования (например, для верхнего или нижнего регистра) использование средств HTML и CSS допускается и поощряется. | + | Главный принцип — стараться использовать синтаксис вики там, где это возможно. То есть, использование <p>…</p>, <ul>, <strong> и прочих тегов оформления является излишним. Тем не менее, если же средств вики не хватает для достижения необходимого форматирования (например, для верхнего или нижнего регистра) использование средств HTML и CSS допускается и поощряется. |
| - | Ещё один главный принцип — соответствие правилам типографики. То есть, там, где должно стоять длинное тире, должно стоять длинное тире, там, где кавычки, должны стоять кавычки (причём их вид зависит от языка, | + | Ещё один главный принцип — соответствие правилам типографики. То есть, там, где должно стоять длинное тире, должно стоять длинное тире, там, где кавычки, должны стоять угловые кавычки (причём их вид зависит от языка, на котором написан входящий в них текст; например, для русского текста это угловые кавычки — « и »). Для простановки различных спецсимволов надо использовать возможности HTML. Ниже приведена таблица некоторых наиболее часто встречающихся символов, которою мне лень делать (а здесь [http://html.manual.ru/book/info/specialchars.php внешняя ссылка] на полную таблицу) |
=====Заголовки===== | =====Заголовки===== | ||
| Строка 55: | Строка 55: | ||
===Статьи, посвящённые понятиям и терминам=== | ===Статьи, посвящённые понятиям и терминам=== | ||
| - | Данные статьи создаются для того, чтобы можно было | + | Данные статьи создаются для того, чтобы можно было поучить информацию по понятию, не перерывая весь курс лекций (так как обычно всё, связанное с некоторым понятием, растягивается на несколько лекций). |
====Название==== | ====Название==== | ||
| - | Название статьи должно совпадать с названием понятия. Также, должны быть проставлены переходы со всех возможных альтернативных названий. Например, на статью «целостность» можно сделать переходы с названий «ссылочная целостность», «integrity». | + | Название статьи должно совпадать с названием понятия. Также, должны быть проставлены переходы со всех возможных альтернативных названий. Например, на статью «целостность» можно сделать переходы с названий «ссылочная целостность», «integrity». |
====Оформление==== | ====Оформление==== | ||
| Строка 65: | Строка 65: | ||
=====Стуктурное оформление===== | =====Стуктурное оформление===== | ||
| - | В начале любой статьи, посвящённой понятию, должно присутствовать определение этого понятия. Оно не должно предваряться никаким заголовком. После определения могут рассматриваться некоторые аспекты понятия (например, для теорем — их доказательства и применение, для класса понятий — отдельные представители понятия (например, для понятия «нормализация», «нормальная форма» можно кратко рассмотреть в статье шесть нормальных форм, хотя, конечно, для них также должны быть отдельные статьи), и так далее), которые уже предваряются отдельными заголовками. Если есть какие-то | + | В начале любой статьи, посвящённой понятию, должно присутствовать определение этого понятия. Оно не должно предваряться никаким заголовком. После определения могут рассматриваться некоторые аспекты понятия (например, для теорем — их доказательства и применение, для класса понятий — отдельные представители понятия (например, для понятия «нормализация», «нормальная форма» можно кратко рассмотреть в статье шесть нормальных форм, хотя, конечно, для них также должны быть отдельные статьи), и так далее), которые уже предваряются отдельными заголовками. Если есть какие-то аспеты понятия, специфичные для отдельного курса (например, роль БЭСМ-6 в становлении современных языков программирования специфична для курса Языков Программирования), то это нужно указать в заголовке. |
=====Оформление текста===== | =====Оформление текста===== | ||
| Строка 73: | Строка 73: | ||
====Ссылки==== | ====Ссылки==== | ||
| - | Должны присутствовать ссылки на места в курсе, где | + | Должны присутствовать ссылки на места в курсе, где встречаютмся данные понятия, а также на смежные понятия. |
