tazpkg diff doc/tazpkg.ru.html @ rev 571

doc: add some clear markup to en, providing it in css (do we need 88% letters size? its small; auto-hyphenation added), add ru doc
author Aleksej Bobylev <al.bobylev@gmail.com>
date Thu Mar 22 16:40:10 2012 +0200 (2012-03-22)
parents
children 7d8d81c885c3
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/doc/tazpkg.ru.html	Thu Mar 22 16:40:10 2012 +0200
     1.3 @@ -0,0 +1,468 @@
     1.4 +<!DOCTYPE html>
     1.5 +<html xmlns="http://www.w3.org/1999/xhtml" lang="ru">
     1.6 +<head>
     1.7 +	<title>Руководство TazPKG</title>
     1.8 +	<meta charset="utf-8" />
     1.9 +	<link rel="shortcut icon" href="favicon.ico" />
    1.10 +	<link rel="stylesheet" type="text/css" href="style.css" />
    1.11 +</head>
    1.12 +<body>
    1.13 +
    1.14 +<!-- Header -->
    1.15 +<div id="header">
    1.16 +	<h1>Руководство TazPKG</h1>
    1.17 +</div>
    1.18 +
    1.19 +<!-- Start content -->
    1.20 +<div id="content">
    1.21 +
    1.22 +<h2>НАЗВАНИЕ</h2>
    1.23 +
    1.24 +<p>TazPKG — менеджер пакетов в системе SliTaz GNU/Linux.</p>
    1.25 +
    1.26 +
    1.27 +<h2>СИНТАКСИС</h2>
    1.28 +
    1.29 +<pre>
    1.30 +tazpkg [команда] [пакет|папка|шаблон|список|категория|--опции] [папка|--опции]
    1.31 +</pre>
    1.32 +
    1.33 +
    1.34 +<h2>ОПИСАНИЕ</h2>
    1.35 +
    1.36 +<p>TazPKG — это сверхлегкий (~ 80 КБ) менеджер пакетов, позволяющий
    1.37 +устанавливать, выдавать список, загружать, обновлять и удалять бинарные пакеты
    1.38 +в системе GNU/Linux. TazPKG предоставляет команды для поиска и создания пакетов,
    1.39 +он был создан независимо от проекта. Пакеты с расширением *.tazpkg — это архивы
    1.40 +CPIO, содержащие сжатую при помощи GZip файловую систему, рецепт и
    1.41 +дополнительное описание. TazPKG также управляет зависимостями на основе
    1.42 +рецептов, находящихся в пакетах. Каждый рецепт содержит полную информацию
    1.43 +о пакете, а также может содержать пре- и пост-установочные функции. Тот же самый
    1.44 +рецепт использует TazWok для компиляции исходников и создания пакетов
    1.45 +<tt>.tazpkg</tt>.</p>
    1.46 +
    1.47 +<p>TazPKG разработан полностью с нуля, он написан на скрипте, совместимом
    1.48 +с Bash. TazPKG работает под управлением Ash, который входит в состав проекта
    1.49 +BusyBox. TazPKG распространяется под свободной лицензией GNU GPL v3.</p>
    1.50 +
    1.51 +
    1.52 +<h2>КОМАНДЫ</h2>
    1.53 +
    1.54 +
    1.55 +<h3 id="list">list</h3>
    1.56 +
    1.57 +<p>Список пакетов, установленных в системе. Эта команда может выводить список
    1.58 +всех установленных пакетов, список категорий, список пакетов определенной
    1.59 +категории, и список пакетов заблокированных от обновления. Вы можете также
    1.60 +использовать команду <tt><a href="#search">search</a></tt> для вывода списка
    1.61 +на основе условия или названия пакета:</p>
    1.62 +
    1.63 +<pre>
    1.64 +# tazpkg list
    1.65 +# tazpkg list cat
    1.66 +# tazpkg list <em>категория</em>
    1.67 +# tazpkg list blocked
    1.68 +</pre>
    1.69 +
    1.70 +
    1.71 +<h3 id="xhtml-list">xhtml-list</h3>
    1.72 +
    1.73 +<p>Эта команда сохраняет список всех пакетов, установленных в системе, в файл
    1.74 +формата xHTML для просмотра в браузере. Команду может запускать обычный
    1.75 +пользователь, она создает файл <tt>installed-packages.html</tt> в той папке,
    1.76 +откуда она была запущена. Обратите внимание, что вы можете изменить имя файла
    1.77 +с помощью командной строки:</p>
    1.78 +
    1.79 +<pre>
    1.80 +# tazpkg xhtml-list
    1.81 +# tazpkg xhtml-list <em>имя-списка.html</em>
    1.82 +</pre>
    1.83 +
    1.84 +
    1.85 +<h3 id="list-mirror">list-mirror</h3>
    1.86 +
    1.87 +<p>Список пакетов, доступных на зеркале. Эта команда покажет файл
    1.88 +<tt>packages.list</tt>, загруженный с зеркала. Если этого файла нет, вам будет
    1.89 +предложено запустить <code>tazpkg <a href="#recharge">recharge</a></code>
    1.90 +с правами администратора (root), чтобы получить список доступных пакетов.
    1.91 +Параметр <tt>--diff</tt> позволяет отобразить различия между новым и текущим
    1.92 +списками пакетов:</p>
    1.93 +
    1.94 +<pre>
    1.95 +# tazpkg list-mirror
    1.96 +# tazpkg list-mirror --diff
    1.97 +</pre>
    1.98 +
    1.99 +
   1.100 +<h3 id="info">info</h3>
   1.101 +
   1.102 +<p>Показать всю информацию по интересующему вас пакету. Информация содержится
   1.103 +в рецепте пакета — его версия, категория, разработчик, сайт и все зависимости
   1.104 +(см. также Tazwok для получения дополнительной информации по рецептам):</p>
   1.105 +
   1.106 +<pre>
   1.107 +# tazpkg info <em>busybox</em>
   1.108 +</pre>
   1.109 +
   1.110 +
   1.111 +<h3 id="desc">desc</h3>
   1.112 +
   1.113 +<p>Описание пакета (если оно существует). Эта команда выводит файл
   1.114 +<tt>description.txt</tt> из каждого пакета (простой текстовый файл, шириной до
   1.115 +80 символов, чтобы поместиться в стандартном терминале):</p>
   1.116 +
   1.117 +<pre>
   1.118 +# tazpkg desc <em>busybox</em>
   1.119 +</pre>
   1.120 +
   1.121 +
   1.122 +<h3 id="list-config">list-config</h3>
   1.123 +
   1.124 +<p>Список конфигурационных системных файлов. Параметр <tt>--box</tt> отображает
   1.125 +список в виде таблицы:</p>
   1.126 +
   1.127 +<pre>
   1.128 +# tazpkg list-config
   1.129 +# tazpkg list-config --box
   1.130 +</pre>
   1.131 +
   1.132 +
   1.133 +<h3 id="list-files">list-files</h3>
   1.134 +
   1.135 +<p>Список всех файлов, которые устанавливаются при установке пакета. Эта команда
   1.136 +просто читает и отображает файл <tt>files.list</tt> каждого пакета (он создается
   1.137 +автоматически при создании пакета, а также используется для удаления файлов при
   1.138 +удалении пакета). Чтобы получить список файлов, установленных пакетом bc:</p>
   1.139 +
   1.140 +<pre>
   1.141 +# tazpkg list-files <em>bc</em>
   1.142 +</pre>
   1.143 +
   1.144 +
   1.145 +<h3 id="search">search</h3>
   1.146 +
   1.147 +<p>Поиск пакета по имени владельца или названию пакета. Эта команда будет искать
   1.148 +в списке установленных пакетов и в списке пакетов, доступных на зеркале. Для
   1.149 +того, чтобы получить новейший список пакетов с зеркала, просто запустите
   1.150 +<code>tazpkg recharge</code> перед началом проведения поиска:</p>
   1.151 +
   1.152 +<pre>
   1.153 +# tazpkg search <em>gcc</em>
   1.154 +</pre>
   1.155 +
   1.156 +
   1.157 +<h3 id="search-file">search-file</h3>
   1.158 +
   1.159 +<p>Эта команда ищет файл среди всех файлов, которые были установлены с пакетами.
   1.160 +Это бывает очень полезно, когда нужно найти полный путь к файлу или определить,
   1.161 +присутствует ли файл в системе. Пример:</p>
   1.162 +
   1.163 +<pre>
   1.164 +$ tazpkg search-file <em>libnss</em>
   1.165 +</pre>
   1.166 +
   1.167 +
   1.168 +<h3 id="install">install</h3>
   1.169 +
   1.170 +<p>Эта команда позволяет устанавливать ранее загруженный пакет с расширением
   1.171 +<tt>.tazpkg</tt>. См. <tt><a href="#get-install">get-install</a></tt>, если вы
   1.172 +хотите установить пакет из интернета. Обратите внимание, что вы можете выполнить
   1.173 +принудительную установку с параметром <tt>--forced</tt>, удалить и
   1.174 +переустановить пакет с параметрами <tt>uninstall</tt> и <tt>reinstall</tt>
   1.175 +соответственно. Также вы можете указать путь к корню файловой системы, в которую
   1.176 +вы хотите установить пакет, с помощью параметра <tt>--root=…</tt>:</p>
   1.177 +
   1.178 +<pre>
   1.179 +# tazpkg install <em>пакет-1.0.tazpkg</em>
   1.180 +# tazpkg install <em>путь/к/пакету-1.0.tazpkg</em> --forced
   1.181 +# tazpkg install <em>путь/к/пакету-1.0.tazpkg</em> --root=<em>/mnt/rootfs</em>
   1.182 +</pre>
   1.183 +
   1.184 +
   1.185 +<h3 id="install-list">install-list<br />
   1.186 +<span id="get-install-list">get-install-list</span></h3>
   1.187 +
   1.188 +<p>Установить набор пакетов, перечисленных в файле. Команда
   1.189 +<tt>install-list</tt> позволяет вам установить за один раз несколько ранее
   1.190 +загруженных пакетов, а команда <tt>get-install-list</tt> перед установкой списка
   1.191 +пакетов предварительно загружает их из интернета. Эти команды также понимают
   1.192 +параметр форсированной установки:</p>
   1.193 +
   1.194 +<pre>
   1.195 +# tazpkg install-list <em>мои-пакеты.list</em>
   1.196 +# tazpkg get-install-list <em>мои-пакеты.list</em> --forced
   1.197 +</pre>
   1.198 +
   1.199 +
   1.200 +<h3 id="link">link</h3>
   1.201 +
   1.202 +<p>Эта команда позволяет установить пакет, уже установленный на другом носителе.
   1.203 +Установка заключается в создании символьных ссылок и требует очень мало памяти.
   1.204 +Обычно это применяется, когда система работает в оперативной памяти и нужно
   1.205 +установить дополнения с USB-флэш:</p>
   1.206 +
   1.207 +<pre>
   1.208 +# tazpkg link <em>openoffice /media/usbdisk</em>
   1.209 +</pre>
   1.210 +
   1.211 +
   1.212 +<h3 id="remove">remove</h3>
   1.213 +
   1.214 +<p>Удалить пакет. Вас спросят о подтверждении (y/N). Эта команда удаляет все
   1.215 +файлы, которые устанавливались в составе пакета. Для просмотра списка файлов,
   1.216 +используйте команду <tt><a href="#list-files">list-files</a></tt> с названием
   1.217 +пакета. Пример удаления пакета bc:</p>
   1.218 +
   1.219 +<pre>
   1.220 +# tazpkg remove <em>bc</em>
   1.221 +</pre>
   1.222 +
   1.223 +
   1.224 +<h3 id="extract">extract</h3>
   1.225 +
   1.226 +<p>Распаковать пакет в папку. Если вы не укажете папку назначения, то пакет
   1.227 +будет распакован в папку с именем <tt><em>пакет-версия</em></tt>, которая будет
   1.228 +создана в текущей папке:</p>
   1.229 +
   1.230 +<pre>
   1.231 +# tazpkg extract <em>пакет.tazpkg</em>
   1.232 +# tazpkg extract <em>пакет.tazpkg папка/назначения</em>
   1.233 +</pre>
   1.234 +
   1.235 +
   1.236 +<h3 id="pack">pack</h3>
   1.237 +
   1.238 +<p>Эта команда создаст пакет из заранее подготовленной папки или из
   1.239 +распакованного пакета. Используя эту команду вы можете создать пакет .tazpkg
   1.240 +вручную (см. документацию Tazwok по вопросу автоматического создания пакетов).
   1.241 +Упаковать пакет:</p>
   1.242 +
   1.243 +<pre>
   1.244 +# tazpkg pack <em>пакет-версия</em>
   1.245 +</pre>
   1.246 +
   1.247 +
   1.248 +<h3 id="repack">repack</h3>
   1.249 +
   1.250 +<p>Эта команда позволяет восстановить пакет из файлов в системе, где он был
   1.251 +ранее установлен. Переупаковать пакет:</p>
   1.252 +
   1.253 +<pre>
   1.254 +# tazpkg repack <em>пакет</em>
   1.255 +</pre>
   1.256 +
   1.257 +
   1.258 +<h3 id="repack-config">repack-config</h3>
   1.259 +
   1.260 +<p>Эта команда воссоздает пакет с конфигурационными системными файлами (см.
   1.261 +<tt><a href="#list-config">list-config</a></tt>). Для того, чтобы восстановить
   1.262 +текущую конфигурацию, потом достаточно будет установить созданный пакет.
   1.263 +Упаковать конфигурационные файлы:</p>
   1.264 +
   1.265 +<pre>
   1.266 +# tazpkg repack-config
   1.267 +</pre>
   1.268 +
   1.269 +
   1.270 +<h3 id="recharge">recharge</h3>
   1.271 +
   1.272 +<p>Обновление списка пакетов, доступных на зеркале. Эта команда загрузит с
   1.273 +зеркала самый последний список устанавливаемых пакетов <tt>packages.list</tt> и,
   1.274 +прежде чем продолжить, сохранит старый список. После обновления списка, вы
   1.275 +можете использовать команды <tt><a href="#list">list</a></tt> и
   1.276 +<tt><a href="#search">search</a></tt>. Для просмотра списка различий используйте
   1.277 +команду <code>list-mirror --diff</code>, а для просмотра и обновления пакетов
   1.278 +просто скомандуйте <tt><a href="#upgrade">upgrade</a></tt>. Обновить список
   1.279 +пакетов:</p>
   1.280 +
   1.281 +<pre>
   1.282 +# tazpkg recharge
   1.283 +</pre>
   1.284 +
   1.285 +
   1.286 +<h3 id="up">up<br />
   1.287 +<span id="upgrade">upgrade</span></h3>
   1.288 +
   1.289 +<p>Команда позволяет обновить все установленные пакеты, доступные на текущем
   1.290 +зеркале. Обновление пакетов — важная составляющая безопасности системы, и вы
   1.291 +можете чувствовать себя в безопасности с последними обновлениями и
   1.292 +исправлениями. Хотя проект SliTaz и крохотный, но он обеспечивает регулярные
   1.293 +обновления по безопасности и как правило, предоставляет последние версии ПО.
   1.294 +Обратите внимание, что эта функция предназначена для людей, установивших SliTaz
   1.295 +на жесткий диск. Обновленные пакеты в режиме LiveCD, будут потеряны при
   1.296 +выключении системы. Обновить или показать все параметры команды <tt>up</tt>:</p>
   1.297 +
   1.298 +<pre>
   1.299 +# tazpkg up
   1.300 +# tazpkg --help-up
   1.301 +# tazpkg up --recharge --install
   1.302 +# tazpkg up -r -i
   1.303 +</pre>
   1.304 +
   1.305 +
   1.306 +<h3 id="check">check</h3>
   1.307 +
   1.308 +<p>Эта команда может проверить зависимости установленных пакетов и определить,
   1.309 +все ли файлы, необходимые для переупаковки пакета присутствуют:</p>
   1.310 +
   1.311 +<pre>
   1.312 +# tazpkg check <em>пакет</em>
   1.313 +</pre>
   1.314 +
   1.315 +
   1.316 +<h3 id="block">block<br />
   1.317 +<span id="unblock">unblock</span></h3>
   1.318 +
   1.319 +<p>Команды позволяют вам блокировать и разблокировать установленную версию
   1.320 +пакета. Заблокированный пакет не будет обновляться командой
   1.321 +<tt><a href="#upgrade">upgrade</a></tt>. Список заблокированных пакетов
   1.322 +находится в файле <tt>/var/lib/tazpkg/blocked-packages.list</tt>. Этот файл
   1.323 +также можно отредактировать вручную. Для блокирования или разблокирования пакета
   1.324 +Grub:</p>
   1.325 +
   1.326 +<pre>
   1.327 +# tazpkg block <em>grub</em>
   1.328 +# tazpkg unblock <em>grub</em>
   1.329 +</pre>
   1.330 +
   1.331 +
   1.332 +<h3 id="get">get</h3>
   1.333 +
   1.334 +<p>Загрузить пакет с зеркала (если он существует). Загруженный пакет сохраняется
   1.335 +в текущей папке. Чтобы узнать текущий путь, вы можете использовать команду
   1.336 +<code>pwd</code>. Для загрузки пакета Grub:</p>
   1.337 +
   1.338 +<pre>
   1.339 +# tazpkg get <em>grub</em>
   1.340 +</pre>
   1.341 +
   1.342 +
   1.343 +<h3 id="get-install">get-install</h3>
   1.344 +
   1.345 +<p>Загрузить и установить пакет с зеркала в интернете. Эта команда сначала
   1.346 +проверяет, существует ли пакет на зеркале и был ли он уже загружен. Для
   1.347 +получения списка пакетов на зеркале, используйте команду
   1.348 +<tt><a href="#list-mirror">list-mirror</a></tt>. Для установки пакета Grub:</p>
   1.349 +
   1.350 +<pre>
   1.351 +# tazpkg get-install <em>grub</em>
   1.352 +</pre>
   1.353 +
   1.354 +
   1.355 +<h3 id="clean-cache">clean-cache</h3>
   1.356 +
   1.357 +<p>Удалить пакеты *.tazpkg, загруженные в кэш. Во время установки TazPKG
   1.358 +сохраняет копии пакетов, загруженных из интернета. Это сделано для того, чтобы
   1.359 +сохранить трафик в случае переустановки, но вы можете захотеть освободить место
   1.360 +на жестком диске или повторно загрузить пакеты:</p>
   1.361 +
   1.362 +<pre>
   1.363 +# tazpkg clean-cache
   1.364 +</pre>
   1.365 +
   1.366 +
   1.367 +<h3 id="setup-mirror">setup-mirror</h3>
   1.368 +
   1.369 +<p>Установка адреса зеркала. Эта команда запросит URL нового зеркала. Можно
   1.370 +указать несколько адресов, разделенных пробелами. Обратите внимание, что вы
   1.371 +также можете изменить основной файл <tt>/var/lib/tazpkg/mirror</tt>. URL-адрес
   1.372 +должен указывать на папку, содержащую пакеты и файл <tt>packages.list</tt>:</p>
   1.373 +
   1.374 +<pre>
   1.375 +# tazpkg setup-mirror
   1.376 +</pre>
   1.377 +
   1.378 +
   1.379 +<h3 id="reconfigure">reconfigure</h3>
   1.380 +
   1.381 +<p>Повторяет пост-установочный скрипт из пакета. Пример использования для
   1.382 +GCC:</p>
   1.383 +
   1.384 +<pre>
   1.385 +# tazpkg reconfigure <em>gcc</em>
   1.386 +</pre>
   1.387 +
   1.388 +
   1.389 +<h3 id="depends">depends<br />
   1.390 +<span id="rdepends">rdepends</span></h3>
   1.391 +
   1.392 +<p>Отображает дерево зависимостей и обратное дерево зависимостей пакета,
   1.393 +соответственно. Пример использования для MPD:</p>
   1.394 +
   1.395 +<pre>
   1.396 +# tazpkg depends <em>mpd</em>
   1.397 +# tazpkg rdepends <em>mpd</em>
   1.398 +</pre>
   1.399 +
   1.400 +
   1.401 +<h3 id="add-undigest">add-undigest<br />
   1.402 +<span id="setup-undigest">setup-undigest</span></h3>
   1.403 +
   1.404 +<p>Устанавливает адрес дополнительного неофициального зеркала для тестирования
   1.405 +пакетов, которые еще не присутствуют на официальных зеркалах. Обратите внимание,
   1.406 +вы можете также вручную редактировать файлы в
   1.407 +<tt>/var/lib/tazpkg/undigest/<em>имя_репозитория</em></tt>. URL-адрес должен
   1.408 +указывать на папку, содержащую пакеты и файл <tt>packages.list</tt>:</p>
   1.409 +
   1.410 +<pre>
   1.411 +# tazpkg add-undigest <em>public-repository http://my.home.org/slitaz</em>
   1.412 +# tazpkg setup-undigest <em>local-repository /home/slitaz/packages</em>
   1.413 +</pre>
   1.414 +
   1.415 +
   1.416 +<h3 id="remove-undigest">remove-undigest</h3>
   1.417 +
   1.418 +<p>Удаляет адрес неофициального зеркала:</p>
   1.419 +
   1.420 +<pre>
   1.421 +# tazpkg remove-undigest <em>my-repository</em>
   1.422 +</pre>
   1.423 +
   1.424 +
   1.425 +<h3 id="list-undigest">list-undigest</h3>
   1.426 +
   1.427 +<p>Список дополнительных неофициальных зеркал:</p>
   1.428 +
   1.429 +<pre>
   1.430 +# tazpkg list-undigest
   1.431 +</pre>
   1.432 +
   1.433 +
   1.434 +<h3 id="convert">convert</h3>
   1.435 +
   1.436 +<p>Преобразует пакеты Debian (.deb), Redhat (.rpm), Slackware (.tgz) и Archlinux
   1.437 +(.pkg.tar.gz) в пакеты SliTaz (.tazpkg):</p>
   1.438 +
   1.439 +<pre>
   1.440 +# tazpkg convert <em>чужой-пакет</em>
   1.441 +</pre>
   1.442 +
   1.443 +
   1.444 +<h3 id="set-release">set-release</h3>
   1.445 +
   1.446 +<p>Эта команда меняет текущую версию и обновляет все пакеты до последнего релиза
   1.447 +выбранной версии:</p>
   1.448 +
   1.449 +<pre>
   1.450 +# tazpkg set-release <em>cooking</em>
   1.451 +</pre>
   1.452 +
   1.453 +
   1.454 +<h3 id="bugs">bugs</h3>
   1.455 +
   1.456 +<p>Генерирует список известных ошибок в пакетах:</p>
   1.457 +
   1.458 +<pre>
   1.459 +# tazpkg bugs
   1.460 +</pre>
   1.461 +
   1.462 +
   1.463 +<h2>МЭЙНТЕЙНЕР</h2>
   1.464 +
   1.465 +<p>Christophe Lincoln &lt;pankso at slitaz.org&gt;</p>
   1.466 +
   1.467 +</div>
   1.468 +<!-- End content -->
   1.469 +</body>
   1.470 +</html>
   1.471 +