Calculate Forum

Вики-форматирование текста, сюда посылать тех кто постит нечитаемые вопросы

Привет всем.
Если вы читаете этот пост, значит, либо вас послали грамотно оформить свой вопрос, либо вам просто интересно о чем же тут написано :wink:

На форуме порой встречаются вопросы типа:

я пробую установить несколько пакетов, и получаю вот что

calculate vf # emerge google-chrome
Calculating dependencies… done!
[ebuild N ~] www-client/google-chrome-23.0.1271.40_beta162221 USE=“plugins” LINGUAS=“am ar bg bn ca cs da de el en_GB es es_LA et fa fi fil fr gu he hi hr hu id it ja kn ko lt lv ml mr ms nb nl pl pt_BR pt_PT ro ru sk sl sr sv sw ta te th tr uk vi zh_CN zh_TW”
The following keyword changes are necessary to proceed:
#required by google-chrome (argument)
=www-client/google-chrome-23.0.1271.40_beta162221:beta ~x86
NOTE: This --autounmask behavior can be disabled by setting
EMERGE_DEFAULT_OPTS="–autounmask=n" in make.conf.
Use -autounmask-write to write changes to config files (honoring CONFIG_PROTECT).

calculate vf # emerge firefox
Calculating dependencies… done!
[binary N ] media-libs/libjpeg-turbo-1.2.1 USE=“static-libs -java”

А теперь сравните с подобным оформлением:

я получил следующее выполнив команду
# emerge google-chrome

Calculating dependencies... done!
[ebuild N ~] www-client/google-chrome-23.0.1271.40_beta162221 USE="plugins" LINGUAS="am ar bg bn ca cs da de el en_GB es es_LA et fa fi fil fr gu he hi hr hu id it ja kn ko lt lv ml mr ms nb nl pl pt_BR pt_PT ro ru sk sl sr sv sw ta te th tr uk vi zh_CN zh_TW"
The following keyword changes are necessary to proceed:
#required by google-chrome (argument)
=www-client/google-chrome-23.0.1271.40_beta162221:beta ~x86 
NOTE: This --autounmask behavior can be disabled by setting
EMERGE_DEFAULT_OPTS="--autounmask=n" in make.conf.
Use --autounmask-write to write changes to config files (honoring CONFIG_PROTECT).

а вот это я получил выполнив команду
# emerge firefox

Calculating dependencies... done!
[binary N ] media-libs/libjpeg-turbo-1.2.1 USE="static-libs -java" 
 ...

Вам тоже кажется второй вариант более читаемым?
Вы тоже думаете, что чем легче другим прочитать ваш вопрос тем выше шанс, что вы получите помощь?
Вы тоже хотите оформлять свои посты “красиво”?

Тогда пройдемся по основым правилам оформления:

Для начала *почитайте помощь по Форматированию текста хотя бы “по диагонали”
Ссылка на него всегда есть прямо над правым верхним углом поля ввода сообщения

Для читающих “по диагонали” вот “шпаргалка”:
calculate_new_message.png

Вы наверняка заметили кнопки
[ ] - код и
[ ] - Заранее форматированный текст

Первая нужна чтоб вставить
моноширинный +текст+ _включающий_ -символы- *форматирования*
для примера - тот же текст не обрамленный в код ниже:
моноширинный текст включающий символы форматирования

Это удобно чтоб описать одну-две строки кода содержащего те самые символы форматирования.
Кстати, “код” находящийся "внутри" символов форматированя, форматируется также.

Кнопка [ ] создает блок кода.
В него можно вставить десяток другой строк кода (пример вы видели выше).
Но не стоит его сильно нагружать, подобные “простыни” кода/логов посреди поста сильно отвлекают от основной темы.
Если вы решили явить миру последнюю тысячу строк /var/log/message, или те “матюки” которые вам вернул emerge когда вы что-то сделали, лучше воспользуйтесь сервисом wgetpaste.
К примеру на ЭТОМ ресурсе.
Кстати, копировать/вставлять нужный текст совсем не обязательно.
Просто воспользуйтесь командой wgetpaste
# emerge --info | wgetpaste
или
tail -n1000 /var/log/messages | wgetpaste
идущей в стандартном наборе кальки.
Кому интересно - этот пакет называется app-text/wgetpaste
Детали по команде:
# wgetpaste --help

И еще, пусть и последнее, но пожалуй самое важное - обязательно нажимайте Предварительный просмотр.
По мере набора этого поста я нажимал его пожалуй не менее десятка раз.
Лучше сразу заметить сбившуюся разметку или огромный кусок плохо читаемого текста.
Глаз человека привык цепляться за “опорные точки”.
И чем грамотнее вы их расставите по тексту (без фанатизма), допустим выделением или переносом строки подчеркивая ключевые слова или разные смысловые блоки, тем легче будет вникнуть в смысл ваших слов.

[>]{style=“text-align:left;”}
Пишите в комментариях, что еще стоит добавить в это “послание к начинающим”
[>]{style=“text-align:left;”}
Кстати, картинки постить можно так

Наверное стоит упомянуть про пасту, wgetpaste, так как спойлеров на сайте нет, длинные простыни листинга отталкивают от желания вникать в суть вопроса. Использование пасты, позволяет читающему сосредоточится на сути вопроса, и лишь потом смотреть пасту…

2 Aleksey
Спасибо, добавил.

Mastodon Mastodon