Представление данных

Операционная система Linux очень многогранна и для того, чтобы описать большинство ее аспектов, понадобится изложить огромное количество информации, относящейся к огромному количеству разных категорий.
При этом понадобится приводить примеры кода на разных языках программирования, а так же примеры команд Linux. А также придется употреблять различные специфические термины.
Для того, что бы было меньше путаницы, мы попробуем описать, каким образом информация будет изложена на нашем сайте и по возможности, следовать собственным правилам описанным здесь.

Итак…

Примеры.

Примеры команд linux могут выглядеть так:

command parameters

или так:

command parameters

Где «command» является командой, а «parameters» ее параметрами (агрументами). Заметьте — команды могут запускаться и без параметров. А если мы захотим употребить имя команды в тексте — скорее всего, мы выделим его жирным:
Например команда man в системах Linux отвечает за получение справочной информации.
Так же, мы можем захотеть наглядно изобразить, как команда ведет себя команда, при запуске в консоли. Это может выглядеть так:

xakep@xakep ~ $ whois man-linux.ru
% By submitting a query to RIPN's Whois Service
% you agree to abide by the following terms of use:
% http://www.ripn.net/about/servpol.html#3.2 (in Russian)
% http://www.ripn.net/about/en/servpol.html#3.2 (in English).

domain:     MAN-LINUX.RU
type:       CORPORATE
nserver:    ns1.man-linux.ru. 209.160.73.4
nserver:    ns2.man-linux.ru. 209.61.252.95
state:      REGISTERED, DELEGATED
person:     Private person
registrar:  REGRU-REG-RIPN
created:    2008.02.15
paid-till:  2009.02.15
source:     TC-RIPN


Last updated on 2008.08.24 01:04:54 MSK/MSD

xakep@xakep ~ $

Примеры кода, могут быть изображены с подсветкой синтаксиса, например так:

<?
$var='это пример php-кода для сайта http://man-linux.ru <br>'."\n";
	for($i=0; $i<=100; $i++){
	echo $var;
	}
echo '<hr>спасибо за внимание';
?>

А так же с нумерацией строк:

1
2
3
4
5
6
7
<?
$var='это пример php-кода для сайта http://man-linux.ru <br>'."\n";
	for($i=0; $i<=100; $i++){
	echo $var;
	}
echo '<hr>спасибо за внимание';
?>

Навигация

Данный сайт имеет несколько разделов, число которых может увеличиваться со временем.
Однако основные категории построены по неизменному принципу:

  • Вступление — здесь находится информация непосредственно о сайте, а также важная для новых пользователей сайта.
  • Заметки линуксоида — в большинстве, это личные заметки автора собираемые на основе собственного опыта, различные статьи и другая информация, которая может оказаться весьма полезной и которой может не оказаться в стандартных справочниках. Обратите внимание — в данной категории может использоваться специфический сленг, жаргонные выражения, термины и т.д.
    Так же обратите внимание, что информация в данном разделе представлена именно в виде заметок, т.е. есть вероятность, что отдельные заметки будут понятны только самому автору :) Однако именно такие заметки могут оказаться просто бесценными для вас, в какой-то конкретной ситуации. В этом разделе, вы можете не обнаружить описание стандартных процедур и решений, поскольку все это сотни раз описано в стандартных мануалах (документации) — этот раздел посвящен в основном рецептам, созданным на основе собственного опыта.
  • Справочник команд — в данном разделе находится описание огромного количества команд Linux на русском языке. В категории «список команд», в алфавитном порядке, перечислены все команды Linux описанные на нашем сайте. В остальных категориях, те же команды разбиты на области применения, для вашего удобства. Например если вам понадобится узнать что-то о работе с файлами (в том числе создание, редактирование, удаление и поиск файлов, навигация по файловым системам и т.п.), вам подойдет раздел «Файлы, навигация»
  • Метки — на метках стоит остановиться по подробнее. Дело в том, что различная информация, может относиться как к большинству ОС Linux, так и к ОС относящихся к какой-то определенной платформе.
    Например, определенная статья, может относиться исключительно к ОС Linux Gentoo или ко всем Linux на которых установлена контрольная панель Cpanel. При этом, статья может находиться сразу в нескольких категориях и относиться сразу к нескольким платформам. Для того, чтобы было меньше путаницы, чтобы легче было найти нужную информацию по определенному признаку, существуют метки. Статьи могут быть помечены, как относящиеся к конкретным платформам и/или системам.
    Однако обратите внимание: статьи могут быть не помечены никак (например универсальные статьи относящиеся к большинство систем и платформ) — такие статьи вы не найдете в метках, однако вы можете найти их в стандартных разделах сайта, а также с помощью поиска.

Терминология

На сайте могут быть использованы различные, специфичные термины, а также может употребляться «сисадминский» жаргон (сленг). Если вам будет непонятно значение какого-либо слова — попробуйте воспользоваться поисковой системой Google.
В дальнейшем, может быть, мы создадим на сайте словарь терминов и жаргонных выражений.

Ответить