Различия
Здесь показаны различия между двумя версиями данной страницы.
| Следующая версия | Предыдущая версия | ||
|
terms:стилистика_статей [2009/08/07 02:28] создано |
terms:стилистика_статей [2012/06/04 19:44] (текущий) |
||
|---|---|---|---|
| Строка 3: | Строка 3: | ||
| <note important> Из-за глюка вики при преобразовании кавычек в "ёлочки" подобная конструкция отображается неверно: %%"//test//"%%, поэтому если необходимо, вставляйте кавычки-"ёлочки" явно (копирование-вставка - хорошая вещь)</note> | <note important> Из-за глюка вики при преобразовании кавычек в "ёлочки" подобная конструкция отображается неверно: %%"//test//"%%, поэтому если необходимо, вставляйте кавычки-"ёлочки" явно (копирование-вставка - хорошая вещь)</note> | ||
| <note>Вы всегда можете просмотреть исходный код статьи чтоб понять что к чему</note> | <note>Вы всегда можете просмотреть исходный код статьи чтоб понять что к чему</note> | ||
| - | <note important> Внимание! Чтобы статья не потерялась,настоятельно рекомендуется использовать тэги,о том,как это делать,смотрите ниже.</note> | + | <note important> Внимание! Чтобы статья не потерялась, настоятельно рекомендуется использовать тэги.\\ О том, как это делать, смотрите ниже.</note> |
| ===== Оформление команд ===== | ===== Оформление команд ===== | ||
| Строка 12: | Строка 12: | ||
| Однако не выделяйте таким образом команды вместе с выводом или с приглашением командной строки (кроме символов # и $, если кто ещё помнит различие между ними). | Однако не выделяйте таким образом команды вместе с выводом или с приглашением командной строки (кроме символов # и $, если кто ещё помнит различие между ними). | ||
| - | Кроме того, если необходимо включить в команду некое собирательное понятие, например, "файл", то заключайте его в треугольные скобки. Например: | + | Кроме того, если необходимо включить в команду некое собирательное понятие, например, "файл", то можно, дабы не возникало путаницы, заключить его в треугольные скобки. Например: |
| ls -ld <директория> | ls -ld <директория> | ||
| Строка 45: | Строка 45: | ||
| <note warning> Не используйте теги ''<code>'' и ''<file>'' ни для каких других целей, кроме вышеобозначенных </note> | <note warning> Не используйте теги ''<code>'' и ''<file>'' ни для каких других целей, кроме вышеобозначенных </note> | ||
| + | |||
| + | Существует баг [[wiki:firefox|Firefox'а]], связанный с тем, что элементы %%<file>%% и %%<code>%%, содержащие длинные строки, растягивают пространство статьи в горизонтальном направлении. Такой же эффект получается если добавить на страницу изображение большого размера. Т. к. текст масштабируется в зависимости от размеров страницы, такие статьи очень неудобно читать, особенно тем, у кого маленькие мониторы (например, пользователям нетбуков). Для того, чтобы растягивания не происходило, разбивайте такие строки на несколько строк. Например, команду | ||
| + | <code> | ||
| + | cat /home/user/folder1/folder2/folder3/folder4/folder5/folder6/folder7/folder8/folder9/folder10/folder11/folder12/folder13/folder14/folder15/some_file | ||
| + | </code> | ||
| + | можно записать: | ||
| + | <code> | ||
| + | cat /home/user/folder1/folder2/folder3/ \ | ||
| + | folder4/folder5/folder6/folder7/folder8/ \ | ||
| + | folder9/folder10/folder11/folder12/folder13/ \ | ||
| + | folder14/folder15/some_file | ||
| + | </code> | ||
| + | И она, после копирования ее в терминал все равно будет работать, т. к. в конце каждой строки стоит символ \, экранирующий переход на новую строку. Аналогично можно поступать со скриптами, а в случае с листингом файлов или вывода результатов работы какой-либо программы можно просто разбивать строки. Например: | ||
| + | <file> | ||
| + | Это очень-очень-очень длинная строка, в которой написано что-то совсем не важное. Но мы то с вами знаем, что важна тут в первую очередь именно длина строки. | ||
| + | А это короткая строка. | ||
| + | </file> | ||
| + | Может быть записано как: | ||
| + | <file> | ||
| + | Это очень-очень-очень длинная строка, в | ||
| + | которой написано что-то совсем не важное. | ||
| + | Но мы то с вами знаем, что важна тут в | ||
| + | первую очередь именно длина строки. | ||
| + | А это короткая строка. | ||
| + | </file> | ||
| + | Данное требование в оформлении не обязательное, но желательное, т. к. во-первых [[wiki:firefox|Firefox]] является в [[wiki:ubuntu|Ubuntu]] браузером по-умолчанию, а во-вторых далеко не у каждого посетителя ресурса есть возможность смотреть его с тем же разрешением, что и у вас. | ||
| ===== Названия приложений ===== | ===== Названия приложений ===== | ||
| Строка 75: | Строка 101: | ||
| А выглядит это так: <key>C-A-F1</key> | А выглядит это так: <key>C-A-F1</key> | ||
| - | ===== Добавление тэгов к статье ====== | ||
| - | Важно добавлять к статье тэги - ключевые слова,позволяющие определить,к какой теме или темам относится статья.Если этого не сделать,то есть риск,что Ваша статья просто потеряется в общей массе.Например,для статьи об установке видеодрайвера nVidia подойдут тэги "HOWTO,Администрирование ,Видеоаппаратура ,Драйвера ,NVIDIA". | ||
| - | Тэги писать нужно в самом конце кода страницы,чтобы они не мешали чтению.Движок Вики не различает большие буквы,поэтому,напишите Вы nVidia или NVIDIA большой разницы не имеет,главное-это чтобы слова тэгов совпадали по буквам с уже существующими тэгами по данной тематике.Например,слова "видео" и "видио" будут трактованы по-разному,поэтому сверяйтесь с общим набором тэгов на заглавной странице.Итак,для статьи по установке драйвера nVidia в конце статьи будет следующая строка : | ||
| - | <code>{{tag>HOWTO Администрирование Видеоаппаратура Драйвера NVIDIA}}</code> | ||
| ====== Общая сводка стилей ====== | ====== Общая сводка стилей ====== | ||
