Справка:Консоль

Материал из Национальной библиотеки им. Н. Э. Баумана
Последнее изменение этой страницы: 16:13, 22 июля 2016.

Тэг console

Ни для кого не секрет, что кусок кода, вырванного из контекста, весьма сложно прочесть. Но и приводить в статье весь код - не самое приятное занятие. Поэтому, для удобочитаемости, был придуман тэг console.

Правильный пример оформления тегом

Тэг <console> позволяет воссоздать некое подобие linux-консоли, а также "раскрасить" код таким образом, чтобы смысл приведенного кода был понятен даже тому, кто ни разу не сталкивался с языками, используемыми в консолях Linux и UNIX.

power on          #оранжевым цветом обозначается та часть кода, которая вводится пользователем.
loading...          #белый цвет - части кода, которые выдает нам машина, которые не содержат важной информации.
successfully          #зеленый цвет - операция завершилась успешно.
Enter your login: My_name          #желтый цвет - компьютер запрашивает у пользователя какую-то информацию - логин, пароль, код и т.д.
Enter your password: My_password                                                            
Hello, My_name! You have some unread messages. 
Show them?
yes
Message 1:
From: My_friend
Date: 07.15.16
Body:
Hello,My_name! How are u? Hope 2 see u soon!          #синий цвет - сообщение от компьютера, требующее внимания.
delete
Error:message cant be deleted.          #Красный - цвет ошибок, предупреждений.
power off

#И,наконец, текст белого цвета после значка # - это текст комментариев.

Установка

Тэг console не входит в стандартный набор тэгов в MediaWiki. Это отдельное расширение, написанное Дэниэлом Роббинсоном. Скачать его можно здесь. Переходим непосредственно к установке.

  • После того, как вы скачали расширение, вам нужно распаковать архив. Распаковывать его нужно в папку root/mediawiki-1.xx.x/extensions/ConsoleOutput, где root - путь на сервере до папки с wiki.
    • В результате распаковки, вы должны получить папку ConsoleOutput с тремя файлами:
      • ConsoleOutput.css
      • ConsoleOutput.php
      • COPYRIGHT.txt
  • Переходим ко второму этапу установки. Для того, чтобы наше расширение заработало, нам нужно сообщить wiki ссылку на него. Делается это следующим образом:
    • Открываем файл LocalSettings.php, в котором хранятся настройки нашей wiki, и листаем в самый конец. В конце самой последней строки нажимаем Enter и вставляем следующую строчку:
    •  require_once( "$IP/extensions/мояпапка/ConsoleOutput.php" );
      з.ы. не забудьте про точку с запятой в конце строчки!!!
    • Где мояпапка - это название папки в каталоге расширений, в которую вы разархивировали скачанный файл (если вы следовали инструкции, то эта папка называется ConsoleOutput)
  • И, наконец, последний этап установки. Для того, чтобы расширение могло использовать цвета, нам нужно передать wiki информацию из файла ConsoleOutput.css. Делается это следующим образом:
    • У любой wiki есть свои стандартные стили, обычно их 4 :Современный, Векторный, Моно и Кельнский.
    • Приведем пример с использованием стиля Современный (Modern). В папке root/mediawiki-1.xx.x/skins/Modern/resources есть файл main.css.
    • Открываем его, и вставляем информацию из файла ConsoleOutput.css. Закрываем, сохраняем.
  • Установка завершена!

Использование

Теперь поговорим об использовании. Здесь все просто. Для того, чтобы применить консольное форматирование используются два тэга - открывающий и закрывающий: <console>Мой текст</console>. Внутри этих тэгов существуют несколько подтэгов.

  • Для того, чтобы показать, что текст был написан пользователем, используют конструкцию:
    • <console>##i##Это пользовательский текст##!i##</console>
      • Это пользовательский текст
      • Также можно использовать без закрывающего тэга ##!i## для того, чтобы окрасить всю последующую строчку целиком.
  • Для жирного выделения используют:
    • <console>##b##Это жирный текст##!b##</console>
      • Это жирный текст
      • Также можно использовать без закрывающего тэга.
  • И теперь цвета:
    • <console>##g## зеленый, ##!g####y##желтый, ##!y####r##красный, ##!r####c##циан. ##!c##</console>
      •  зеленый, желтый, красный, циан.