Руководство по стилистике статей Сравнение версий

Различия

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

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
terms:стилистика_статей [2009/08/10 00:08]
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]] браузером по-умолчанию,​ а во-вторых далеко не у каждого посетителя ресурса есть возможность смотреть его с тем же разрешением,​ что и у вас.
  
 ===== Названия приложений ===== ===== Названия приложений =====