Add handbook files to /usr/share/calculate/doc.

netsetup
Mike Hiretsky 14 years ago
parent 585781d934
commit 42bfbeed39

@ -0,0 +1,206 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<title>handbook</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<style>
body { font:80% Verdana,Tahoma,Arial,sans-serif; }
h1, h2, h3, h4 { font-family: "Trebuchet MS",Georgia,"Times New Roman",serif; }
ul.toc { padding: 4px; margin-left: 0; }
ul.toc li { list-style-type:none; }
ul.toc li.heading2 { margin-left: 1em; }
ul.toc li.heading3 { margin-left: 2em; }
a.wiki-anchor { display: none; margin-left: 6px; text-decoration: none; }
a.wiki-anchor:hover { color: #aaa !important; text-decoration: none; }
h1:hover a.wiki-anchor, h2:hover a.wiki-anchor, h3:hover a.wiki-anchor { display: inline; color: #ddd; }
pre {font-size:133% }
</style>
</head>
<body>
<h1 id="Handbook">Handbook<a href="#Handbook" class="wiki-anchor">&para;</a></h1>
<h2 id="Thank-you-for-using-Calculate-Linux">Thank you for using Calculate Linux!<a href="#Thank-you-for-using-Calculate-Linux" class="wiki-anchor">&para;</a></h2>
<p>We have done for you the most convenient system for work using the tremendous opportunities which are incorporated in the package management system Portage. The system applies an administrative image, which collected the best software. Most programs have an open license, which allows you to install, distribute and modify the source code.</p>
<h2 id="Network-configuration">Network configuration<a href="#Network-configuration" class="wiki-anchor">&para;</a></h2>
<p>Configure the network Calculate Linux Desktop GNOME performs <em>Networkmanager</em>, in versions with the desktop KDE and XFCE using <em>Wicd</em>. Both programs have a graphical interface through which you can configure both wired and wireless network. When you load the program tries to raise the network interface and obtain an IP address from a DHCP server. Call the program using the icon in the upper right corner of the screen.</p>
<p>Network Configuration Calculate Directory Server and Calculate Linux Scratch is performed through a configuration file <em>/etc/conf.d/net</em>, help on setting up a network can be found in the file <em>/usr/share/doc/openrc/net.example</em>. After changing the settings, restart the network interface:</p>
<pre>
/etc/init.d/net.eth0 restart
</pre>
<h2 id="Partitioning">Partitioning<a href="#Partitioning" class="wiki-anchor">&para;</a></h2>
<p>The easiest way to install the distro - use an auto partitioning. If you plan to use the Calculate Linux in conjunction with other systems, you may need to allocate partitions on your hard drive by selecting the partition for installation.</p>
<p>Calculate Linux is installed in one section, a minimum capacity of 6 GB for the version with KDE and not less than 3 GB for XFCE. Recommended to use the partition in 10 GB. As a rule, need to allocate a swap partition (swap) with a size roughly equal to the amount of RAM. If the swap is already selected, then create a new one is not necessary. Good to have a separate partition for personal files (/home).</p>
<p>In Calculate Linux Desktop for partitioning a program <em>Partitionmanager</em> (a version of KDE) or <em>Gparted</em> (a version of XFCE). To Calculate Linux Scratch and Calculate Directory Server, use console utilities <em>fdisk</em> or <em>cfdisk</em>.</p>
<p>In order to view a list of available partitions, open a console as root user and type:</p>
<pre>
fdisk -l
</pre>
<p>If you have never used Linux, you need a little time trying to get used to the name of partition as <em>sda1, sda2,</em> ... instead of the usual <em>c:, d:</em>.</p>
<p>You can also use already created partition, or create it from Windows. Try to identify it correctly in Linux by means of its location and size. Typically the <em>C:</em> drive corresponds to <em>sda1</em>, the <em>D:</em> drive, respectively <em>sda2</em>.</p>
<h2 id="Installation">Installation<a href="#Installation" class="wiki-anchor">&para;</a></h2>
<h3 id="Version-109">Version 10.9<a href="#Version-109" class="wiki-anchor">&para;</a></h3>
<p><strong>cl-install</strong></p>
<p>The utility is executed from the command line under the user <code>root</code>. For help, launch <code>cl-install --help</code>.<br />To install a second hard disk partition, run:</p>
<pre>
cl-install -d /dev/sda2
</pre>
<p><strong>cl-install-gui</strong></p>
<p>For convenience, use the graphical installation utility on the hard disk. The program can be run from the menu or by running under the user <code>root</code>:</p>
<pre>
cl-install-gui
</pre>
<h3 id="Version-104-and-below">Version 10.4 and below<a href="#Version-104-and-below" class="wiki-anchor">&para;</a></h3>
<p>During the installation of the system meets the program <em>Calculate</em>. If you do not <em>calculate</em> the parameters, the program will ask you to specify the partition on which to install the system. <em>Calculate</em> can perform a partition of the disk only if you are willing to allocate the entire hard disk for the system.</p>
<p>To install a second hard disk partition, you can simply do:</p>
<pre>
calculate -d /dev/sda2
</pre>
<p>To install the hard drive and removing the old data:</p>
<pre>
calculate -d /dev/sda
</pre>
<p>Program expands stage4 system image and adjusts through the template files. Essentially it is the same configuration files that contain program variables. Calculate determines the type of equipment and machinery fills these variable values. You can view a list of variables following the "calculate -v". The values of variables that can change noted in the list of flag [w], variables are read-only labeled [r]. To change the values of variables, use the option --set-variable-name.</p>
<p><strong>List of most frequently used options installed</strong></p>
<p>--disk=/dev/sda2 - partition to install (default will be offered part sda2);<br />--set-format = reiserfs (ext4, ext3, ext2, xfs, jfs) - format file system;<br />--set-composite = on (off) - the inclusion of a composite mode;<br />--set-type = hdd (flash, usb-hdd) - media type, set in the case of incorrect identification.</p>
<p><strong>Other options</strong></p>
<p>--set-hostname = linux - computer's network name, the default 'calculate';<br />--set-video_resolution = 1280x1024 (1024x768, 1152x864, 1280x800, etc.) - the screen resolution, if you use the screen resolution misidentified;<br />--set-mbr = off - do not modify the MBR during installation;<br />--set-erase = off - do not format the partition before installing;<br />--set-march = i686 (x86_64) - set the distribution for 32 or 64-bit processor architecture, is not true for CD installation disk.</p>
<h2 id="Installing-on-USB-Flash">Installing on USB-Flash<a href="#Installing-on-USB-Flash" class="wiki-anchor">&para;</a></h2>
<p>When installing the system, you can specify the device USB-Flash and the system will be installed on your stick. Example:</p>
<pre>
calculate -d /dev/sdb
</pre><br /><em><br />Note that when you install quests, conundrums will be formatted to the file system FAT32. Before installing the need to save all your data.</em>
<p>In this example, quests, conundrums listed as disk sdb. To know that there is a hard drive, run the command <em>fdisk -l</em> to see all the available devices and partitions.</p>
<p>If your quests, conundrums defined as ssd drive, you can add an option "--set-type=flash" - change the type of media to Flash</p>
<h2 id="The-first-launch">The first launch<a href="#The-first-launch" class="wiki-anchor">&para;</a></h2>
<p>After installing the CLD, CLDX and CLSG in the system are two users: <em>root</em> and <em>guest</em>. Access to the graphical session can get the user guest. Use the username guest with password guest to login.</p>
<p>In CLS default no graphical invitation to enter the password. After installation you can log in as root, run the graphical session tvm can use the command <em>startx</em>.</p>
<p>For <em>root</em> user, use the command "su". Create users described in detail on the project site.</p>
<p>By default, you can log into the system remotely using ssh only by root. You can add a space to other users or to replace the root user edit the options AllowUsers file <em>/etc/ssh/sshd_config</em>.</p>
<h2 id="Update">Update<a href="#Update" class="wiki-anchor">&para;</a></h2>
<p>You can update the system virtually unlimited number of times, using Portage manager install programs <em>emerge</em>. First update Portage and <em>Calculate overlay</em> by running:</p>
<pre>
eix-sync
</pre>
<p>After that, you can upgrade existing or install new versions of programs, using the program emerge.</p>
<p>New versions Calculate Linux come with an interval of 2-3 months. If you used the disk to install a nutshell, or have a second partition free for at least 6 GB, you can download an ISO file system in directory <em>/usr/calculate/share/linux</em> and run update.</p>
<p><strong>Version 10.9</strong></p>
<pre>
cl-install -d /dev/sdaX
</pre>
<p><strong>Version 10.4 and below</strong></p>
<pre>
calculate -d /dev/sdaX
</pre>
<p>Where instead <em>sdaX</em> free substitute for the installation partition.</p>
<p>Most of the configuration of the current system, such as user accounts, network settings, mount point, the screen resolution and others will be transferred to the new system.</p>
<h2 id="Help">Help<a href="#Help" class="wiki-anchor">&para;</a></h2>
<p>If your installation has any difficulties, or you want to share their impressions, visit the IRC channel <em>#calculate</em> (server FreeNode) user community Calculate Linux. It's enough to use Xchat icon on your desktop.</p>
<p>Website: <a class="external" href="http://www.calculate-linux.org">http://www.calculate-linux.org</a><br />Newsletter: <a class="external" href="http://www.calculate-linux.org/main/en/maillist">http://www.calculate-linux.org/main/en/maillist</a><br />IRC chat: <a class="external" href="http://www.calculate-linux.org/irc">http://www.calculate-linux.org/irc</a></p>
<p><em>Enjoy!</em><br /><em>Team Calculate Linux.</em></p>
</body>
</html>

@ -0,0 +1,181 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<title>handbook</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<style>
body { font:80% Verdana,Tahoma,Arial,sans-serif; }
h1, h2, h3, h4 { font-family: "Trebuchet MS",Georgia,"Times New Roman",serif; }
ul.toc { padding: 4px; margin-left: 0; }
ul.toc li { list-style-type:none; }
ul.toc li.heading2 { margin-left: 1em; }
ul.toc li.heading3 { margin-left: 2em; }
a.wiki-anchor { display: none; margin-left: 6px; text-decoration: none; }
a.wiki-anchor:hover { color: #aaa !important; text-decoration: none; }
h1:hover a.wiki-anchor, h2:hover a.wiki-anchor, h3:hover a.wiki-anchor { display: inline; color: #ddd; }
pre {font-size:133% }
</style>
</head>
<body>
<h1 id="Руководство">Руководство<a href="#Руководство" class="wiki-anchor">&para;</a></h1>
<h2 id="Благодарим-за-использование-Calculate-Linux">Благодарим за использование Calculate Linux!<a href="#Благодарим-за-использование-Calculate-Linux" class="wiki-anchor">&para;</a></h2>
<p>Мы постарались сделать максимально удобную для работы систему, используя поистине потрясающие возможности системы управления пакетами Portage. Система распространяется в виде установочного образа, содержащего лучшее программное обеспечение. Большая часть программ имеет открытую лицензию, позволяющую устанавливать, распространять и модифицировать исходный код.</p>
<h2 id="Настройка-сети">Настройка сети<a href="#Настройка-сети" class="wiki-anchor">&para;</a></h2>
<p>За настройку сети в CLD GNOME отвечает <em>Networkmanager</em>, а в версиях с рабочим окружением KDE и XFCE - <em>Wicd</em>. Обе программы имеют графический интерфейс, при помощи которого можно настроить как проводную, так и беспроводную сеть. При загрузке программа попытается настроить сетевой интерфейс и получить IP-адрес от DHCP-сервера. Программу можно запустить, кликнув по иконке в правом верхнем углу экрана.</p>
<p>Настройка сети в CDS и CLS осуществляется с помощью конфигурационного файла <em>/etc/conf.d/net</em>. Справку по настройке сети можно найти в файле <em>/usr/share/doc/openrc/net.example</em>. После изменения настроек нужно перезапустить сетевой интерфейс:<br /><pre>
/etc/init.d/net.eth0 restart
</pre></p>
<h2 id="Разбиение-диска">Разбиение диска<a href="#Разбиение-диска" class="wiki-anchor">&para;</a></h2>
<p>Наиболее простой способ установить дистрибутив - воспользоваться функцией авторазбиения диска. Если вы планируете использовать Calculate Linux совместно с другими системами, то может возникнуть необходимость в разбиении жесткого диска.</p>
<p>Calculate Linux устанавливается в один раздел ёмкостью не менее 6 Гб для версии с KDE и не менее 3 Гб для XFCE. Рекомендуется использовать раздел в 10 Гб. Как правило, потребуется выделить раздел подкачки (swap) с размером, примерно равным объему оперативной памяти. Если раздел под swap уже существует, то создавать новый не нужно. Полезно иметь отдельный раздел для личных файлов (/home).</p>
<p>В CLD для разбиения используются программы <em>Partitionmanager</em> (в версии KDE) и <em>Gparted</em> (в версии XFCE). Для CLS и CDS имеются консольные утилиты: <em>fdisk</em> или <em>cfdisk</em>.</p>
<p>Для того, чтобы просмотреть список существующих разделов, откройте консоль с правами пользователя root и наберите:<br /><pre>
fdisk -l
</pre><br />Если вы никогда не использовали Linux, то вам понадобится немного времени на то, чтобы привыкнуть к другому наименованию разделов.<br />В Linux разделы обозначаются как <em>sda1, sda2, ...</em> вместо привычных <em>c:, d:</em>, ...</p>
<p>Вы также можете воспользоваться уже готовым разделом либо создать его из <em>Windows</em>. Чтобы правильно определить выбранный раздел в Linux, запомните очередность его расположения и размер. Как правило, диску <em>C:</em> соответствует <em>sda1</em>, диску <em>D:</em> - <em>sda2</em>.</p>
<h2 id="Установка">Установка<a href="#Установка" class="wiki-anchor">&para;</a></h2>
<h3 id="Версия-109">Версия 10.9<a href="#Версия-109" class="wiki-anchor">&para;</a></h3>
<p><strong>cl-install</strong></p>
<p>Утилита выполняется из командной строки с правами пользователя <code>root</code>. Для справки наберите <code>cl-install --help</code>.</p>
<p>Для установки во второй раздел жесткого диска выполните:<br /><pre>
cl-install -d /dev/sda2
</pre></p>
<p><strong>cl-install-gui</strong></p>
<p>Для удобства, воспользуйтесь графической утилитой установки системы на жесткий диск. Программу можно запустить из меню, либо выполнив с правами пользователя <code>root</code>:<br /><pre>
cl-install-gui
</pre></p>
<h3 id="Версия-104-и-ниже">Версия 10.4 и ниже<a href="#Версия-104-и-ниже" class="wiki-anchor">&para;</a></h3>
<p>За установку системы отвечает программа <em>Calculate</em>. Если вы выполните <em>calculate</em> без параметров, программа предложит указать раздел, на который следует установить систему. <em>Calculate</em> может выполнить разбиение диска только если вы готовы выделить весь жесткий диск для системы.</p>
<p>Для установки во второй раздел жесткого диска, вам достаточно будет выполнить:<br /><pre>
calculate -d /dev/sda2
</pre><br />Для установки на жесткий диск с удалением прежних данных:<br /><pre>
calculate -d /dev/sda
</pre></p>
<p>Программа разворачивает <em>stage4</em> - образ системы - и выполняет первичную настройку с помощью файлов шаблонов. По сути, это те же файлы настройки, содержащие некоторые (заранее неизвестные) переменные. <em>Calculate</em> определит тип оборудования машины и присвоит значения этим переменным. Список переменных можно просмотреть, выполнив "calculate -v". Значения, которые можно изменить, отмечены флагом [w], переменные только для чтения помечены как [r]. Для изменения значений используйте опцию --set-имя_переменной.</p>
<p><strong>Список наиболее часто используемых опций установки</strong><br />--disk=/dev/sda2 - <em>раздел для установки (по умолчанию будет предложен раздел sda2);</em><br />--set-format=reiserfs (ext4, ext3, ext2, xfs, jfs) - <em>формат файловой системы;</em><br />--set-composite=on (off) - <em>включение композитного режима;</em><br />--set-type=hdd (flash, usb-hdd) - <em>тип носителя, устанавливается в случае неправильного определения.</em></p>
<p><strong>Дополнительные параметры</strong><br />--set-hostname=linux - <em>сетевое имя компьютера, по умолчанию 'calculate';</em><br />--set-video_resolution=1280x1024 (1024x768, 1152x864, 1280x800 <em>и т.д.</em>) - <em>разрешение экрана, для случая неверного определения разрешения экрана;</em><br />--set-mbr=off - <em>не изменять MBR во время установки;</em><br />--set-erase=off - <em>не выполнять форматирование раздела перед установкой;</em><br />--set-march=i686 (x86_64) - <em>установить дистрибутив для 32 или 64-битной архитектуры процессора, не актуально для установки с CD диска.</em></p>
<h3 id="Установка-на-USB-Flash">Установка на USB-Flash<a href="#Установка-на-USB-Flash" class="wiki-anchor">&para;</a></h3>
<p>При инсталляции системы вы можете указать устройство USB-Flash. В этом случае система будет установлена на вашу флешку. Пример:<br /><pre>
calculate -d /dev/sdb
</pre><br /><em>Обратите внимание, что при установке флешка будет отформатирована в файловую систему FAT32. Перед установкой обязательно сохраните все свои данные.</em></p>
<p>В приведенном примере флешка указана как диск <em>sdb</em>. Чтобы узнать, тот ли это диск, выполните команду <em>fdisk -l</em> для отображения всех доступных устройств и разделов.</p>
<p>В случае, если ваша флешка определилась как <em>ssd</em> диск, вы можете добавить параметр "--set-type=flash" - изменить тип носителя на Flash.</p>
<h2 id="Первый-запуск">Первый запуск<a href="#Первый-запуск" class="wiki-anchor">&para;</a></h2>
<p>После установки CLD, CLDX и CLSG в системе существуют два пользователя: <em>root</em> и <em>guest</em>. Доступ к графическому сеансу может получить только пользователь <em>guest</em>. Используйте логин <em>guest</em> с паролем <em>guest</em> для входа в систему.</p>
<p>В CLS по умолчанию нет графического приглашения к вводу пароля. После установки вы можете зайти в систему пользователем <em>root</em> и запустить графический сеанс tvm с помощью команды <em>startx</em>.</p>
<p>Для получения прав пользователя <em>root</em> используйте команду "su". Добавление новых пользователей подробно описано на сайте проекта.</p>
<p>По умолчанию вы можете зайти в систему удаленно (по протоколу ssh) только как пользователь root. В файле <em>/etc/ssh/sshd_config</em> в значении параметра <em>AllowUsers можно добавить других пользователей или заменить пользователя _root</em>.</p>
<h2 id="Обновление">Обновление<a href="#Обновление" class="wiki-anchor">&para;</a></h2>
<p>Вы можете обновлять систему практически неограниченное количество раз, используя портежи с менеджером установки программ <em>emerge</em>. Для начала обновите портежи и <em>Calculate overlay</em> выполнив:<br /><pre>
eix-sync
</pre></p>
<p>После этого вы можете обновить или установить новые программы с помощью команды emerge.</p>
<p>Новые версии Calculate Linux выходят с интервалом в 2-3 месяца. Если вы использовали функцию авторазбиения диска при установке, или у вас есть второй свободный раздел не менее 6 Гб, вы можете загрузить ISO файл с системой в директорию <em>/usr/calculate/share/linux</em> и выполнить обновление.</p>
<p><strong>Версия 10.9</strong></p>
<pre>
cl-install -d /dev/sdaX
</pre>
<p><strong>Версия 10.4 и ниже</strong></p>
<pre>
calculate -d /dev/sdaX
</pre>
<p>Где вместо <em>sdaX</em> подставьте свободный для установки раздел.</p>
<p>Большинство настроек текущей системы, такие как учетные записи пользователей, настройки сети, точки монтирования, разрешение экрана и прочие, будут перенесены в новую систему.</p>
<h2 id="Помощь">Помощь<a href="#Помощь" class="wiki-anchor">&para;</a></h2>
<p>Если установка системы вызвала сложности или вы хотите поделиться своим впечатлением, заходите в <em>IRC</em> канал <em>#calculate-ru</em> (сервер FreeNode) сообщества пользователей Calculate Linux. Для этого достаточно воспользоваться иконкой <em>Xchat</em> на вашем рабочем столе.</p>
<p>Сайт проекта: <a class="external" href="http://www.calculate-linux.ru">http://www.calculate-linux.ru</a><br />Рассылка: <a class="external" href="http://www.calculate-linux.ru/main/ru/maillist">http://www.calculate-linux.ru/main/ru/maillist</a><br />IRC чат: <a class="external" href="http://www.calculate-linux.ru/irc">http://www.calculate-linux.ru/irc</a></p>
<p><em>Приятной работы!<br />Команда разработчиков Calculate Linux.</em></p>
</body>
</html>

@ -29,7 +29,9 @@ var_data_files = []
#data_dirs_template = ['templates']
share_calculate_dir = "/usr/share/calculate"
data_dirs_share = ['i18n']
data_files += [('/etc/init.d', ['data/calculate'])]
data_files += [('/etc/init.d', ['data/calculate']),
('/usr/share/calculate/doc', ['data/handbook-en.html',
'data/handbook-ru.html'])]
#template_calculate_dir = os.path.join(share_calculate_dir, "templates")
#template_replace_dirname = "install"

Loading…
Cancel
Save