docs/wiki/geda-gaf_utility.ru.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   2  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   3 <html>
   4 <head>
   5   <link rel="stylesheet" media="screen" type="text/css" href="./style.css" />
   6   <link rel="stylesheet" media="screen" type="text/css" href="./design.css" />
   7   <link rel="stylesheet" media="print" type="text/css" href="./print.css" />
   8
   9   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  10 </head>
  11 <body>
  12
  13 <p>
  14 <em>На других языках:</em> <a href="geda-gaf_utility.html" class="wikilink1" title="geda-gaf_utility.html">English</a>
  15 </p>
  16
  17 <h1 class="sectionedit1" id="gaf_-_утилита_командной_строки_geda_gaf">gaf - утилита командной строки gEDA/gaf</h1>
  18 <div class="level1">
  19
  20 <p>
  21 Программа <strong>gaf</strong> предоставляет в распоряжение пользователя несколько маленьких утилит
  22 командной строки для работы с файлами схем и символов. Её назначение —
  23 пакетная обработка данных проектов, созданных с помощью редактора схем
  24 <a href="geda-gschem_ug.ru.html" class="wikilink1" title="geda-gschem_ug.ru.html">gschem</a>. В настоящее время программа поддерживает три
  25 встроенных команды:
  26 </p>
  27 <ul>
  28 <li class="level1"><div class="li"> <a href="#gaf_export" title=":geda:gaf_utility.ru.txt ↵" class="wikilink1">gaf export</a> используется для конвертации файлов схем и символов в форматы SVG, PDF, PNG, PS и EPS с целью распечатки или внедрения в другую документацию.</div>
  29 </li>
  30 <li class="level1"><div class="li"> <a href="#gaf_config" title=":geda:gaf_utility.ru.txt ↵" class="wikilink1">gaf config</a> предназначена для чтения текущих и записи новых параметров настройки в файлы настроек проектов, пользовательские и системные файлы настроек gEDA.</div>
  31 </li>
  32 <li class="level1"><div class="li"> <a href="#gaf_shell" title=":geda:gaf_utility.ru.txt ↵" class="wikilink1">gaf shell</a> предоставляет интерфейс командной строки с «циклом чтения-вычисления-вывода» Scheme (REPL) для пакетной обработки данных принципиальных схем.</div>
  33 </li>
  34 </ul>
  35
  36 <p>
  37 Подробное описание опций утилиты см. в справочной странице <em>gaf(1)</em>.
  38 </p>
  39
  40 </div>
  41 <!-- EDIT1 SECTION "gaf - утилита командной строки gEDA/gaf" [62-1656] -->
  42 <h2 class="sectionedit2" id="gaf_export">gaf export</h2>
  43 <div class="level2">
  44
  45 <p>
  46 Подробное описание команды <strong>gaf export</strong> можно найти в справочной странице
  47 <em>gaf(1)</em>.
  48 </p>
  49
  50 </div>
  51 <!-- EDIT2 SECTION "gaf export" [1657-1821] -->
  52 <h2 class="sectionedit3" id="gaf_config">gaf config</h2>
  53 <div class="level2">
  54
  55 <p>
  56 В данном разделе приводится описание настройки <strong>gschem</strong> и <strong>gnetlist</strong> с
  57 помощью команды <strong>gaf config</strong>.
  58 </p>
  59
  60 <p>
  61 Подробное описание опций утилиты см. в справочной странице <em>gaf(1)</em>.
  62 </p>
  63
  64 </div>
  65 <!-- EDIT3 SECTION "gaf config" [1822-2131] -->
  66 <h3 class="sectionedit4" id="файлы_настроек">Файлы настроек</h3>
  67 <div class="level3">
  68
  69 <p>
  70 Параметры настройки записываются в файлы настроек
  71 gEDA.
  72 Это следующие файлы:
  73 </p>
  74 <ul>
  75 <li class="level1 node"><div class="li"> <em><code>geda-system.conf</code></em> для системных настроек. Файл системных настроек последовательно ищется в трёх местах:</div>
  76 <ul>
  77 <li class="level2"><div class="li"> в <em><code>${XDG_CONFIG_DIRS}/gEDA</code></em>, подробности об этой переменной окружения см. в <a href="http://standards.freedesktop.org/basedir-spec/latest/" class="urlextern" title="http://standards.freedesktop.org/basedir-spec/latest/" rel="nofollow">XDG Base Directory Specification</a>;</div>
  78 </li>
  79 <li class="level2"><div class="li"> если системных настроек там не найдено, то в традиционном местоположении rc-файлов gEDA, то есть в каталоге <em><code>${PREFIX}/share/gEDA</code></em>, где <code>${PREFIX}</code> является скомпилированным умолчанием, обычно <em><code>/usr</code></em> или <em><code>/usr/local</code></em> (но в дистрибутивах на основе Debian вместо этого используется каталог <em><code>/etc/gEDA</code></em>),</div>
  80 </li>
  81 <li class="level2"><div class="li"> и наконец, если файл настроек так и не был пока найден, в каталоге по умолчанию XDG или, если таковой не определён, в каталоге <em><code>/etc/xdg/gEDA</code></em>.</div>
  82 </li>
  83 </ul>
  84 </li>
  85 <li class="level1"><div class="li"> <em><code>$HOME/.gEDA/geda-user.conf</code></em> для пользовательских настроек.</div>
  86 </li>
  87 <li class="level1"><div class="li"> <em><code>путь/к/проекту/geda.conf</code></em> для локальных настроек проекта.</div>
  88 </li>
  89 </ul>
  90
  91 <p>
  92 Примечание: эти файлы можно также редактировать вручную в текстовом
  93 редакторе.
  94 </p>
  95
  96 <p>
  97 Формат файла настроек приводится в этом
  98 <a href="http://standards.freedesktop.org/desktop-entry-spec/1.0/" class="urlextern" title="http://standards.freedesktop.org/desktop-entry-spec/1.0/" rel="nofollow">стандарте
  99 freedesktop.org</a>.
 100 </p>
 101
 102 <p>
 103 Все файлы настроек состоят из разделов, называемых группами, содержащих пары
 104 ключ-значение.
 105 </p>
 106
 107 <p>
 108 Значениями ключей в файлах настроек gEDA могут быть отдельные числа или списки.
 109 Обратите внимание, что в отличие от команды <a href="#gaf_export" title=":geda:gaf_utility.ru.txt ↵" class="wikilink1">gaf export</a>, для которой
 110 можно использовать несколько разделителей списка, единственным разделителем между значениями
 111 списка в файлах настроек является точка с запятой &#039;;&#039;. Другое отличие заключается
 112 в том, что при использовании команды <strong>gaf config</strong> всегда необходимо указывать
 113 все параметры используемого списка. Таким образом, например, следующая
 114 команда не будет работать должным образом:
 115 </p>
 116 <pre class="code">gaf config --project export size 1000</pre>
 117
 118 <p>
 119 Правильная команда будет выглядеть так:
 120 </p>
 121 <pre class="code">gaf config --project export size &quot;1000;1000&quot;</pre>
 122
 123 <p>
 124 Все размеры должны задаваться в пунктах Adobe (72 пункта = 1 дюйму).
 125 Суффиксы, такие как “pt”, “mm” и другие, которые могут использоваться с
 126 командой <a href="#gaf_export" title=":geda:gaf_utility.ru.txt ↵" class="wikilink1">gaf export</a>, в файлах настроек не работают.
 127 </p>
 128
 129 <p>
 130 В следующих разделах приводятся все существующие группы.
 131 </p>
 132
 133 </div>
 134 <!-- EDIT4 SECTION "Файлы настроек" [2132-5708] -->
 135 <h3 class="sectionedit5" id="группа_export">Группа export</h3>
 136 <div class="level3">
 137
 138 <p>
 139 <em><strong>Таблица 1.</strong></em> Параметры группы <strong>export</strong>
 140 </p>
 141 <div class="table sectionedit6"><table class="inline">
 142         <thead>
 143         <tr class="row0">
 144                 <th class="col0 centeralign">  Ключ       </th><th class="col1 leftalign"> Формат                                                                </th><th class="col2 centeralign">  По умолчанию          </th>
 145         </tr>
 146         </thead>
 147         <tr class="row1">
 148                 <td class="col0 leftalign"> align       </td><td class="col1 leftalign"> строка «auto» или список из двух целых вида <code>ГОРИЗ_ВЫРАВНИВАНИЕ;ВЕРТ_ВЫРАВНИВАНИЕ</code>  </td><td class="col2 centeralign">  auto  </td>
 149         </tr>
 150         <tr class="row2">
 151                 <td class="col0 leftalign"> dpi         </td><td class="col1 leftalign"> целое                                                                 </td><td class="col2 centeralign">  96                    </td>
 152         </tr>
 153         <tr class="row3">
 154                 <td class="col0 leftalign"> font        </td><td class="col1 leftalign"> строка                                                                </td><td class="col2 centeralign">  Arial                 </td>
 155         </tr>
 156         <tr class="row4">
 157                 <td class="col0 leftalign"> layout      </td><td class="col1 leftalign"> предопределённая строка: «portrait», «landscape» или «auto»     </td><td class="col2 centeralign">  auto                  </td>
 158         </tr>
 159         <tr class="row5">
 160                 <td class="col0 leftalign"> margins     </td><td class="col1 leftalign"> список из четырёх целых вида <code>TOP;LEFT;BOTTOM;RIGHT</code>                </td><td class="col2 centeralign">  18;18;18;18           </td>
 161         </tr>
 162         <tr class="row6">
 163                 <td class="col0 leftalign"> monochrome  </td><td class="col1 leftalign"> логическое значение                                                   </td><td class="col2 centeralign">  true                  </td>
 164         </tr>
 165         <tr class="row7">
 166                 <td class="col0 leftalign"> paper       </td><td class="col1 leftalign"> строка, определяющая предопределённый формат                 </td><td class="col2 centeralign">  <em>зависит от текущей локали</em>  </td>
 167         </tr>
 168         <tr class="row8">
 169                 <td class="col0 leftalign"> size        </td><td class="col1 leftalign"> строка «auto» или список из двух целых вида <code>ВЫСОТА;ШИРИНА</code>         </td><td class="col2 centeralign">  auto                  </td>
 170         </tr>
 171 </table></div>
 172 <!-- EDIT6 TABLE [5808-7094] -->
 173 </div>
 174
 175 <h4 id="align">align</h4>
 176 <div class="level4">
 177
 178 <p>
 179 Настройка выравнивания изображения на странице. <code>ГОРИЗ_ВЫРАВНИВАНИЕ</code>
 180 управляет горизонтальным выравниванием, а <code>ВЕРТ_ВЫРАВНИВАНИЕ</code> —
 181 вертикальным.  Оба значения должны быть в диапазоне 0.0 — 1.0. Значение
 182 выравнивания <code>auto</code> эквивалентно значению <code>0.5:0.5</code>, т. е. изображение
 183 будет центрировано.
 184 </p>
 185
 186 <p>
 187 Для команды <a href="#gaf_export" title=":geda:gaf_utility.ru.txt ↵" class="wikilink1">gaf export</a> при отсутствии кавычек можно использовать
 188 разделитель своей локали. В этом случае числа будут интерпретироваться вашей
 189 оболочкой. Для <strong>gaf config</strong> так делать нельзя, поскольку значение ключа
 190 <code>align</code> является строкой. При записи в файл настроек чисел с плавающей
 191 запятой в качестве разделителя используется точка, и точка также должна
 192 использоваться для чисел, содержащихся в строках. См. <a href="#примеры" title=":geda:gaf_utility.ru.txt ↵" class="wikilink1">примеры</a> ниже.
 193 </p>
 194
 195 </div>
 196
 197 <h4 id="dpi">dpi</h4>
 198 <div class="level4">
 199
 200 <p>
 201 Количество пикселов на дюйм для вывода в формате PNG.
 202 </p>
 203
 204 </div>
 205
 206 <h4 id="font">font</h4>
 207 <div class="level4">
 208
 209 <p>
 210 Настройка шрифта для вывода текста.
 211 </p>
 212
 213 <p>
 214 Подробную информацию о выборе шрифтов см. ниже в разделе <a href="#шрифты" title=":geda:gaf_utility.ru.txt ↵" class="wikilink1">Шрифты</a>.
 215 </p>
 216
 217 </div>
 218
 219 <h4 id="layout">layout</h4>
 220 <div class="level4">
 221
 222 <p>
 223 Настройка ориентации вывода при задании размера бумаги. При задании «auto»
 224 используется та ориентация, которая лучше соответствует размерам
 225 изображения.
 226 </p>
 227
 228 </div>
 229
 230 <h4 id="margins">margins</h4>
 231 <div class="level4">
 232
 233 <p>
 234 Установка ширины полей.
 235 </p>
 236
 237 <p>
 238 Фактические размеры полей могут быть больше значений, записанных в файлах
 239 настроек, так как эти значения определяют только минимальные расстояния от
 240 краёв листа, а размеры выбранной бумаги могут не соответствовать размерам
 241 печатаемой схемы с полями. Если значение не определено, размер полей по
 242 умолчанию составляет 18pt для каждого поля.
 243 </p>
 244
 245 <p>
 246 Примечание: задание менее четырёх чисел для данного ключа или использование
 247 каких-либо суффиксов для указания единиц измерения работать не будет.
 248 </p>
 249
 250 </div>
 251
 252 <h4 id="monochrome">monochrome</h4>
 253 <div class="level4">
 254
 255 <p>
 256 Переключение монохромного/цветного вывода.
 257 </p>
 258
 259 </div>
 260
 261 <h4 id="paper">paper</h4>
 262 <div class="level4">
 263
 264 <p>
 265 Задание размера вывода в виде конкретного формата листа.
 266 </p>
 267
 268 <p>
 269 Легальные размеры бумаги описаны в стандарте
 270 <a href="ftp://ftp.pwg.org/pub/pwg/candidates/cs-pwgmsn10-20020226-5101.1.pdf" class="urlextern" title="ftp://ftp.pwg.org/pub/pwg/candidates/cs-pwgmsn10-20020226-5101.1.pdf" rel="nofollow"> PWG 5101.1-2002</a> (<code>iso_a4</code>, <code>iso_a3</code>,
 271 <code>na_letter</code>, <code>na_legal</code> и т. д.).
 272 Формат бумаги по умолчанию зависит от текущей локали. Например,
 273 это <code>A4</code>, когда используется <code>ru_RU.UTF-8</code>, в то время как
 274 для локали <code>en_US.UTF-8</code> это <code>letter</code>.
 275 </p>
 276
 277 </div>
 278
 279 <h4 id="size">size</h4>
 280 <div class="level4">
 281
 282 <p>
 283 Задание определённых размеров для вывода изображения. При задании «auto»,
 284 выбирается тот размер, при котором изображение размещается наилучшим
 285 образом.
 286 </p>
 287
 288 <p>
 289 Размер бумаги, заданный ключом <code>size</code>, переопределит размер, заданный
 290 ключом <code>paper</code>. Примечание: задание только одного числа для данного ключа
 291 или использование каких-либо суффиксов для указания единиц измерения
 292 работать не будет.
 293 </p>
 294
 295 </div>
 296 <!-- EDIT5 SECTION "Группа export" [5709-11418] -->
 297 <h3 class="sectionedit7" id="группа_gnetlist">Группа gnetlist</h3>
 298 <div class="level3">
 299
 300 <p>
 301 <em><strong>Таблица 2.</strong></em> Параметры группы <strong>gnetlist</strong>
 302 </p>
 303 <div class="table sectionedit8"><table class="inline">
 304         <thead>
 305         <tr class="row0">
 306                 <th class="col0 centeralign">  Ключ                </th><th class="col1 centeralign">  Формат                                                   </th><th class="col2 centeralign">  По умолчанию         </th>
 307         </tr>
 308         </thead>
 309         <tr class="row1">
 310                 <td class="col0 leftalign"> default-bus-name     </td><td class="col1 leftalign"> строка                                                    </td><td class="col2 centeralign">  unnamed_bus          </td>
 311         </tr>
 312         <tr class="row2">
 313                 <td class="col0 leftalign"> default-net-name     </td><td class="col1 leftalign"> строка                                                    </td><td class="col2 centeralign">  unnamed_net          </td>
 314         </tr>
 315         <tr class="row3">
 316                 <td class="col0 leftalign"> net-naming-priority  </td><td class="col1"> предопределённая строка: «net-attribute» или «netname-attribute» </td><td class="col2 centeralign">  net-attribute  </td>
 317         </tr>
 318         <tr class="row4">
 319                 <td class="col0 leftalign"> traverse-hierarchy   </td><td class="col1 leftalign"> логическое значение                                       </td><td class="col2 centeralign">  true                 </td>
 320         </tr>
 321 </table></div>
 322 <!-- EDIT8 TABLE [11522-12147] -->
 323 </div>
 324
 325 <h4 id="default-bus-name">default-bus-name</h4>
 326 <div class="level4">
 327
 328 <p>
 329 Имя шины по умолчанию для именования шин, не имеющих имён в схеме.
 330 </p>
 331
 332 <p>
 333 Шины пока ещё не используются ни в одном из низкоуровневых драйверов
 334 <strong>gnetlist</strong>, поэтому данный параметр пока бесполезен.
 335 </p>
 336
 337 </div>
 338
 339 <h4 id="default-net-name">default-net-name</h4>
 340 <div class="level4">
 341
 342 <p>
 343 Имя соединения по умолчанию для именования соединений, не имеющих имён в
 344 схеме.
 345 </p>
 346
 347 <p>
 348 Оно используется для создания имён соединений вида «unnamed_netN», где <code>N</code>
 349 является числом.
 350 </p>
 351
 352 </div>
 353
 354 <h4 id="net-naming-priority">net-naming-priority</h4>
 355 <div class="level4">
 356
 357 <p>
 358 Настройка приоритета одного из атрибутов <code>net</code> или <code>netname</code> для
 359 случаев, когда обнаруживаются соединения с двумя именами. Все конфликты имён
 360 соединений будут разрешаться с использованием указанного атрибута.
 361 </p>
 362
 363 <p>
 364 Этот параметр используется, когда какие-нибудь соединения схемы имеют и
 365 атрибут <code>net</code>, и атрибут <code>netname</code>, и нужно указать, какой из них должен
 366 определять имена соединений, которые <strong>gnetlist</strong> будет использовать для
 367 создания списка соединений. Подробности использования этих атрибутов см. в
 368 <a href="geda-na_howto.ru.html" class="wikilink1" title="geda-na_howto.ru.html">Мини-HOWTO по атрибуту net= </a> и в
 369 <a href="geda-master_attributes_list.ru.html" class="wikilink1" title="geda-master_attributes_list.ru.html">Перечне основных атрибутов</a>.
 370 </p>
 371
 372 </div>
 373
 374 <h4 id="traverse-hierarchy">traverse-hierarchy</h4>
 375 <div class="level4">
 376
 377 <p>
 378 Настройка разрешения обхода иерархии. При отключении <strong>gnetlist</strong> не будет
 379 спускаться вниз по иерархии для поиска низлежащих источников данных.
 380 </p>
 381
 382 </div>
 383 <!-- EDIT7 SECTION "Группа gnetlist" [11419-14200] -->
 384 <h3 class="sectionedit9" id="группа_gschem">Группа gschem</h3>
 385 <div class="level3">
 386
 387 <p>
 388 <em><strong>Таблица 3.</strong></em> Параметры группы <strong>gschem</strong>
 389 </p>
 390 <div class="table sectionedit10"><table class="inline">
 391         <thead>
 392         <tr class="row0">
 393                 <th class="col0 centeralign">  Ключ             </th><th class="col1 centeralign">  Формат  </th><th class="col2 rightalign">  По умолчанию </th>
 394         </tr>
 395         </thead>
 396         <tr class="row1">
 397                 <td class="col0 leftalign"> default-filename  </td><td class="col1 leftalign"> строка   </td><td class="col2 centeralign">  untitled     </td>
 398         </tr>
 399 </table></div>
 400 <!-- EDIT10 TABLE [14300-14424] -->
 401 </div>
 402
 403 <h4 id="default-filename">default-filename</h4>
 404 <div class="level4">
 405
 406 <p>
 407 Имя файла по умолчанию для новых файлов схем, создаваемых в <strong>gschem</strong>.
 408 </p>
 409
 410 <p>
 411 Оно используется для создания имён файлов вида «untitled_N.sch», где <code>N</code>
 412 является числом.
 413 </p>
 414
 415 </div>
 416 <!-- EDIT9 SECTION "Группа gschem" [14201-14725] -->
 417 <h3 class="sectionedit11" id="группа_gschemlibrary">Группа gschem.library</h3>
 418 <div class="level3">
 419
 420 <p>
 421 <em><strong>Таблица 4.</strong></em> Параметры группы <strong>gschem.library</strong>
 422 </p>
 423 <div class="table sectionedit12"><table class="inline">
 424         <thead>
 425         <tr class="row0">
 426                 <th class="col0 centeralign">  Ключ                   </th><th class="col1 centeralign">  Формат                                                   </th><th class="col2 centeralign">  По умолчанию         </th>
 427         </tr>
 428         </thead>
 429         <tr class="row1">
 430                 <td class="col0 leftalign"> component-attributes    </td><td class="col1 leftalign"> список имён атрибутов, разделённых запятыми               </td><td class="col2 centeralign">  *                    </td>
 431         </tr>
 432         <tr class="row2">
 433                 <td class="col0 leftalign"> sort                    </td><td class="col1 leftalign"> логическое значение                                       </td><td class="col2 centeralign">  false                </td>
 434         </tr>
 435 </table></div>
 436 <!-- EDIT12 TABLE [14841-15253] -->
 437 </div>
 438
 439 <h4 id="component-attributes">component-attributes</h4>
 440 <div class="level4">
 441
 442 <p>
 443 Список имён атрибутов, отображаемых в диалоговом окне выбора компонентов.
 444 </p>
 445
 446 <p>
 447 Атрибуты символов в диалоговом окне сортируются в том же порядке, в каком
 448 они появляются в списке. Если первым элементом списка будет звёздочка “*”,
 449 все атрибуты будут отображаться в алфавитном порядке. При задании пустого
 450 списка показ атрибутов в диалоговом окне будет отключен.
 451 </p>
 452
 453 </div>
 454
 455 <h4 id="sort">sort</h4>
 456 <div class="level4">
 457
 458 <p>
 459 Настройка сортировки библиотеки компонентов.
 460 </p>
 461
 462 <p>
 463 Если значение этого параметра равно «true», библиотеки компонентов
 464 сортируются в алфавитном порядке. В противном случае они сортируются в
 465 порядке, обратном порядку их добавления.
 466 </p>
 467
 468 </div>
 469 <!-- EDIT11 SECTION "Группа gschem.library" [14726-16361] -->
 470 <h3 class="sectionedit13" id="группа_gschemprinting">Группа gschem.printing</h3>
 471 <div class="level3">
 472
 473 <p>
 474 <em><strong>Таблица 5.</strong></em> Параметры группы <strong>gschem.printing</strong>
 475 </p>
 476 <div class="table sectionedit14"><table class="inline">
 477         <thead>
 478         <tr class="row0">
 479                 <th class="col0 centeralign">  Ключ       </th><th class="col1 centeralign">  Формат                                                         </th><th class="col2 centeralign">  По умолчанию           </th>
 480         </tr>
 481         </thead>
 482         <tr class="row1">
 483                 <td class="col0 leftalign"> layout      </td><td class="col1 leftalign"> предопределённая строка: «portrait», «landscape» или «auto»     </td><td class="col2 centeralign">  auto                   </td>
 484         </tr>
 485         <tr class="row2">
 486                 <td class="col0 leftalign"> monochrome  </td><td class="col1 leftalign"> логическое значение                                             </td><td class="col2 centeralign">  false                  </td>
 487         </tr>
 488         <tr class="row3">
 489                 <td class="col0 leftalign"> paper       </td><td class="col1 leftalign"> предопределённая строка размера                                 </td><td class="col2 centeralign">  <em>зависит от локали</em>  </td>
 490         </tr>
 491 </table></div>
 492 <!-- EDIT14 TABLE [16479-17024] -->
 493 </div>
 494
 495 <h4 id="layout1">layout</h4>
 496 <div class="level4">
 497
 498 <p>
 499 Настройка ориентации вывода при задании размера бумаги. При задании «auto»
 500 используется та ориентация, которая лучше соответствует размерам
 501 изображения.
 502 </p>
 503
 504 <p>
 505 Ориентация страницы в <strong>gschem</strong> рассчитана на вывод страниц на принтер, а не в
 506 PDF, поэтому значение «auto» означает, что если
 507 вы выводите страницы в PDF, вы получите перевёрнутую пейзажную ориентацию вместо
 508 обычной. Для получения пригодного для чтения PDF со страницами в пейзажной ориентации
 509 используйте вместо этого команду <a href="#gaf_export" title=":geda:gaf_utility.ru.txt ↵" class="wikilink1">gaf export</a> и задайте значение «auto» для ключа <code>layout</code>
 510 в группе <a href="#группа_export" title=":geda:gaf_utility.ru.txt ↵" class="wikilink1">export</a>.
 511 </p>
 512
 513 <p>
 514 Примечание: в настоящее время при печати с помощью скрипта <em><code>print.scm</code></em>
 515 настройка ключа <code>layout</code> не используется.
 516 </p>
 517
 518 </div>
 519
 520 <h4 id="paper1">paper</h4>
 521 <div class="level4">
 522
 523 <p>
 524 Задание размера вывода в виде конкретного формата листа.
 525 </p>
 526
 527 <p>
 528 Значение по умолчанию ключа <code>paper</code> зависит от текущей
 529 локали. См. примечания о размере бумаги выше в описании ключа <code>paper</code> для
 530 группы <a href="#группа_export" title=":geda:gaf_utility.ru.txt ↵" class="wikilink1">export</a>.
 531 </p>
 532
 533 </div>
 534
 535 <h4 id="monochrome1">monochrome</h4>
 536 <div class="level4">
 537
 538 <p>
 539 Переключение монохромного/цветного вывода.
 540 </p>
 541
 542 <p>
 543 Значение по умолчанию ключа <code>monochrome</code> в данной группе в отличие от
 544 значения этого ключа в группе <a href="#группа_export" title=":geda:gaf_utility.ru.txt ↵" class="wikilink1">export</a> задано равным
 545 <code>false</code> умышленно.
 546 </p>
 547
 548 </div>
 549 <!-- EDIT13 SECTION "Группа gschem.printing" [16362-18999] -->
 550 <h3 class="sectionedit15" id="группы_gschemdialog-geometry">Группы gschem.dialog-geometry.*</h3>
 551 <div class="level3">
 552
 553 <p>
 554 Сюда входят группы:
 555 </p>
 556 <ul>
 557 <li class="level1"><div class="li"> gschem.dialog-geometry.arc-angle</div>
 558 </li>
 559 <li class="level1"><div class="li"> gschem.dialog-geometry.autonumber</div>
 560 </li>
 561 <li class="level1"><div class="li"> gschem.dialog-geometry.color-edit</div>
 562 </li>
 563 <li class="level1"><div class="li"> gschem.dialog-geometry.compselect</div>
 564 </li>
 565 <li class="level1"><div class="li"> gschem.dialog-geometry.coord</div>
 566 </li>
 567 <li class="level1"><div class="li"> gschem.dialog-geometry.fill-type</div>
 568 </li>
 569 <li class="level1"><div class="li"> gschem.dialog-geometry.find-text</div>
 570 </li>
 571 <li class="level1"><div class="li"> gschem.dialog-geometry.hide-text</div>
 572 </li>
 573 <li class="level1"><div class="li"> gschem.dialog-geometry.hotkeys</div>
 574 </li>
 575 <li class="level1"><div class="li"> gschem.dialog-geometry.line-type</div>
 576 </li>
 577 <li class="level1"><div class="li"> gschem.dialog-geometry.log</div>
 578 </li>
 579 <li class="level1"><div class="li"> gschem.dialog-geometry.multiattrib</div>
 580 </li>
 581 <li class="level1"><div class="li"> gschem.dialog-geometry.pin-type-edit</div>
 582 </li>
 583 <li class="level1"><div class="li"> gschem.dialog-geometry.show-text</div>
 584 </li>
 585 <li class="level1"><div class="li"> gschem.dialog-geometry.singleattrib</div>
 586 </li>
 587 <li class="level1"><div class="li"> gschem.dialog-geometry.slot-edit</div>
 588 </li>
 589 <li class="level1"><div class="li"> gschem.dialog-geometry.snap-size</div>
 590 </li>
 591 <li class="level1"><div class="li"> gschem.dialog-geometry.text-edit</div>
 592 </li>
 593 <li class="level1"><div class="li"> gschem.dialog-geometry.text-entry</div>
 594 </li>
 595 <li class="level1"><div class="li"> gschem.dialog-geometry.text-size</div>
 596 </li>
 597 <li class="level1"><div class="li"> gschem.dialog-geometry.translate</div>
 598 </li>
 599 </ul>
 600
 601 <p>
 602 Есть две особые группы, имеющие дополнительные настройки:
 603 </p>
 604 <ul>
 605 <li class="level1"><div class="li"> gschem.dialog-geometry.compselect</div>
 606 </li>
 607 <li class="level1"><div class="li"> gschem.dialog-geometry.multiattrib</div>
 608 </li>
 609 </ul>
 610
 611 <p>
 612 <em><strong>Таблица 5.</strong></em> Параметры группы <strong> gschem.dialog-geometry.* </strong>
 613 </p>
 614 <div class="table sectionedit16"><table class="inline">
 615         <thead>
 616         <tr class="row0">
 617                 <th class="col0 centeralign" colspan="3">  Все диалоговые окна                                                                                      </th>
 618         </tr>
 619         <tr class="row1">
 620                 <th class="col0 centeralign">  Ключ                   </th><th class="col1 centeralign">  Формат                                                   </th><th class="col2 centeralign">  По умолчанию         </th>
 621         </tr>
 622         </thead>
 623         <tr class="row2">
 624                 <td class="col0 leftalign"> x                       </td><td class="col1 leftalign"> целое                                                     </td><td class="col2 centeralign">  -                    </td>
 625         </tr>
 626         <tr class="row3">
 627                 <td class="col0 leftalign"> y                       </td><td class="col1 leftalign"> целое                                                     </td><td class="col2 centeralign">  -                    </td>
 628         </tr>
 629         <tr class="row4">
 630                 <td class="col0 leftalign"> width                   </td><td class="col1 leftalign"> целое                                                     </td><td class="col2 centeralign">  -                    </td>
 631         </tr>
 632         <tr class="row5">
 633                 <td class="col0 leftalign"> height                  </td><td class="col1 leftalign"> целое                                                     </td><td class="col2 centeralign">  -                    </td>
 634         </tr>
 635         <tr class="row6">
 636                 <th class="col0 centeralign" colspan="3">  gschem.dialog-geometry.compselect                                                                        </th>
 637         </tr>
 638         <tr class="row7">
 639                 <th class="col0 centeralign">  Ключ                   </th><th class="col1 centeralign">  Формат                                                   </th><th class="col2 centeralign">  По умолчанию         </th>
 640         </tr>
 641         <tr class="row8">
 642                 <td class="col0 leftalign"> hpaned                  </td><td class="col1 leftalign"> целое                                                     </td><td class="col2 centeralign">  -                    </td>
 643         </tr>
 644         <tr class="row9">
 645                 <td class="col0 leftalign"> vpaned                  </td><td class="col1 leftalign"> целое                                                     </td><td class="col2 centeralign">  -                    </td>
 646         </tr>
 647         <tr class="row10">
 648                 <td class="col0 leftalign"> source-tab              </td><td class="col1 leftalign"> 0 или 1                                                   </td><td class="col2 centeralign">  1                    </td>
 649         </tr>
 650         <tr class="row11">
 651                 <th class="col0 centeralign" colspan="3">  gschem.dialog-geometry.multiattrib                                                                       </th>
 652         </tr>
 653         <tr class="row12">
 654                 <th class="col0 centeralign">  Ключ                   </th><th class="col1 centeralign">  Формат                                                   </th><th class="col2 centeralign">  По умолчанию         </th>
 655         </tr>
 656         <tr class="row13">
 657                 <td class="col0 leftalign"> show_inherited          </td><td class="col1 leftalign"> логическое значение                                       </td><td class="col2 centeralign">  true                 </td>
 658         </tr>
 659 </table></div>
 660 <!-- EDIT16 TABLE [20137-21835] -->
 661 <p>
 662 Примечание: все указанные значения автоматически сохраняются в файлах
 663 настроек пользователя. Их можно изменить вручную, но значения будут
 664 перезаписаны в следующий раз, когда изменится размер или другая упомянутая в
 665 этой таблице величина соответствующего диалогового окна. Если вы
 666 отредактируете эти значения в то время, когда программа <strong>gschem</strong> запущена,
 667 они будут молча перезаписаны при завершении её работы.
 668 </p>
 669
 670 </div>
 671
 672 <h4 id="x">x</h4>
 673 <div class="level4">
 674
 675 <p>
 676 Позиция диалогового окна по оси X.
 677 </p>
 678
 679 </div>
 680
 681 <h4 id="y">y</h4>
 682 <div class="level4">
 683
 684 <p>
 685 Позиция диалогового окна по оси Y.
 686 </p>
 687
 688 </div>
 689
 690 <h4 id="width">width</h4>
 691 <div class="level4">
 692
 693 <p>
 694 Ширина диалогового окна.
 695 </p>
 696
 697 </div>
 698
 699 <h4 id="height">height</h4>
 700 <div class="level4">
 701
 702 <p>
 703 Высота диалогового окна.
 704 </p>
 705
 706 </div>
 707
 708 <h4 id="hpaned">hpaned</h4>
 709 <div class="level4">
 710
 711 <p>
 712 Ширина горизонтального фрейма, где выбираются компоненты в диалоговом окне
 713 выбора компонентов.
 714 </p>
 715
 716 </div>
 717
 718 <h4 id="vpaned">vpaned</h4>
 719 <div class="level4">
 720
 721 <p>
 722 Высота вертикального фрейма для предварительного просмотра компонента в
 723 диалоговом окне выбора компонентов.
 724 </p>
 725
 726 </div>
 727
 728 <h4 id="source-tab">source-tab</h4>
 729 <div class="level4">
 730
 731 <p>
 732 Значение, определяющее то, какая вкладка будет открываться при открытии
 733 диалогового окна выбора компонента. 0 означает, что будет выбрана вкладка
 734 «Используемые» («In use»), 1 означает, что будет выбрана вкладка
 735 «Библиотечные» («Libraries»).
 736 </p>
 737
 738 </div>
 739
 740 <h4 id="show_inherited">show_inherited</h4>
 741 <div class="level4">
 742
 743 <p>
 744 Настройка видимости унаследованных атрибутов в диалоговом окне
 745 редактирования атрибутов.
 746 </p>
 747
 748 </div>
 749 <!-- EDIT15 SECTION "Группы gschem.dialog-geometry.*" [19000-23908] -->
 750 <h2 class="sectionedit17" id="gaf_shell">gaf shell</h2>
 751 <div class="level2">
 752
 753 <p>
 754 <strong>gaf shell</strong> предоставляет цикл чтения-вычисления-вывода Scheme («Read-Eval-Print Loop» — REPL) для
 755 автоматической обработки файлов схем и символов. Эта утилита разработана
 756 для поддержки работы с <abbr title="Application Programming Interface">API</abbr> языка Scheme в gEDA. Информацию об опциях утилиты см. в справочной странице <em>gaf(1)</em>, а
 757 для информации о поддерживаемых Scheme-процедурах gEDA см. <strong>info geda-scheme</strong>.
 758 </p>
 759
 760 </div>
 761 <!-- EDIT17 SECTION "gaf shell" [23909-24525] -->
 762 <h2 class="sectionedit18" id="шрифты">Шрифты</h2>
 763 <div class="level2">
 764
 765 <p>
 766 В Linux за настройку шрифтов отвечает пакет <strong>Fontconfig</strong>, и современные
 767 системы (в частности <strong>pango</strong> и <strong>cairo</strong>) полагаются на его библиотеку в
 768 поиске любого заданного шрифта. Вы можете задать команде <strong>gaf</strong> шаблон,
 769 содержащий имя нужного шрифта и, при желании, некоторые настройки для этого
 770 шрифта. Fontconfig ищет соответствие шаблону среди всех шрифтов, доступных в
 771 вашей системе, и выбирает самое близкое соответствие. Это обеспечивает то,
 772 что библиотека всегда возвращает какой-то шрифт, но не гарантирует, что он
 773 будет похож на запрошенный в шаблоне.
 774 </p>
 775
 776 <p>
 777 Если вы хотите узнать, какие шрифты доступны в вашей системе, вы можете
 778 использовать утилиту <em>fc-list(1)</em> из пакета fontconfig. Для проверки, смог
 779 ли fontconfig найти подходящий шрифт по указанному шаблону (или посмотреть
 780 какой шрифт будет соответствовать вашему шаблону), используйте утилиту
 781 <em>fc-match(1)</em>.
 782 </p>
 783
 784 <p>
 785 Больше информации о том, как задать имя шрифта, который хотелось бы
 786 использовать, см. в
 787 <a href="http://freedesktop.org/software/fontconfig/fontconfig-user.html" class="urlextern" title="http://freedesktop.org/software/fontconfig/fontconfig-user.html" rel="nofollow">документации
 788 пакета fontconfig</a>.
 789 </p>
 790
 791 <p>
 792 В некоторых случаях система шрифтов может даже внедрить в ваш документ более
 793 одного шрифта. Это может произойти, например, тогда, когда наиболее
 794 подходящий шрифт, выбранный библиотекой fontconfig не содержит некоторых
 795 глифов для одного из языков, используемых в документе. В этом случае она
 796 добавит какой-то другой шрифт, в котором есть необходимые глифы.
 797 </p>
 798
 799 <p>
 800 В следующей таблице приводится список возможных значений настроек
 801 (полученный из документации по Pango), которые вы можете использовать в
 802 своих шаблонах имён шрифтов. См. также раздел <a href="#примеры" title=":geda:gaf_utility.ru.txt ↵" class="wikilink1">Примеры</a> ниже.
 803 </p>
 804
 805 <p>
 806 <em><strong>Table 6.</strong></em> Возможные параметры настройки шрифта
 807 </p>
 808 <div class="table sectionedit19"><table class="inline">
 809         <thead>
 810         <tr class="row0">
 811                 <th class="col0"> Параметр </th><th class="col1"> Значение </th>
 812         </tr>
 813         </thead>
 814         <tr class="row1">
 815                 <td class="col0 leftalign"> Style   </td><td class="col1"> Normal<br/>
 816 Oblique<br/>
 817 Italic </td>
 818         </tr>
 819         <tr class="row2">
 820                 <td class="col0 leftalign"> Weight  </td><td class="col1"> Thin<br/>
 821 Ultralight<br/>
 822 Light<br/>
 823 Book<br/>
 824 Normal<br/>
 825 Medium<br/>
 826 Semibold<br/>
 827 Bold<br/>
 828 Ultrabold<br/>
 829 Heavy<br/>
 830 Ultraheavy </td>
 831         </tr>
 832         <tr class="row3">
 833                 <td class="col0"> Variant </td><td class="col1">Normal<br/>
 834 SmallCaps </td>
 835         </tr>
 836         <tr class="row4">
 837                 <td class="col0"> Stretch </td><td class="col1"> UltraCondensed<br/>
 838 ExtraCondensed<br/>
 839 Condensed<br/>
 840 SemiCondensed<br/>
 841 Normal<br/>
 842 SemiExpanded<br/>
 843 Expanded<br/>
 844 ExtraExpanded<br/>
 845 UltraExpanded </td>
 846         </tr>
 847 </table></div>
 848 <!-- EDIT19 TABLE [27428-27796] -->
 849 </div>
 850 <!-- EDIT18 SECTION "Шрифты" [24526-27798] -->
 851 <h2 class="sectionedit20" id="примеры">Примеры</h2>
 852 <div class="level2">
 853
 854 </div>
 855 <!-- EDIT20 SECTION "Примеры" [27799-27825] -->
 856 <h3 class="sectionedit21" id="настройка_экспорта">Настройка экспорта</h3>
 857 <div class="level3">
 858
 859 <p>
 860 Использовать пейзажную ориентацию («landscape») по умолчанию для локального проекта:
 861 </p>
 862 <pre class="code">gaf config --project export layout landscape</pre>
 863
 864 <p>
 865 Использовать размер бумаги «letter» по умолчанию для печати чего-угодно:
 866 </p>
 867 <pre class="code">gaf config --user export paper na_letter</pre>
 868
 869 <p>
 870 Задать для локального проекта определённое значение размера бумаги, равное 1&times;2 дюйма:
 871 </p>
 872 <pre class="code">gaf config --project export size &quot;72;144&quot;</pre>
 873
 874 <p>
 875 Задать поля как полдюйма для левой и правой сторон и как четверть
 876 дюйма для верха и низа для локального проекта:
 877 </p>
 878 <pre class="code">gaf config --project export margins &quot;18;36;18;36&quot;</pre>
 879
 880 <p>
 881 Следующая команда выровняет схемы вашего проекта вправо:
 882 </p>
 883 <pre class="code">gaf config --project export align &quot;1.0;0.5&quot;</pre>
 884
 885 <p>
 886 Следующая команда — неправильная, она не будет работать, даже если
 887 в вашей локали в качестве разделителя в числах с плавающей запятой используется запятая, а не точка:
 888 </p>
 889 <pre class="code">gaf config --project export align &quot;1,0;0,0&quot;</pre>
 890
 891 <p>
 892 Эта команда, однако, работает в данном случае (например, в локали ru_RU.UTF-8):
 893 </p>
 894 <pre class="code">gaf export -a 0,0:1.0 -o file.pdf file.sch</pre>
 895
 896 <p>
 897 Обратите внимание, что здесь я использую <strong><code>gaf export</code></strong>, а не <strong><code>gaf config</code></strong>.
 898 </p>
 899
 900 <p>
 901 Чтобы печатать все свои схемы в цвете (обратите внимание: “False” или “FALSE”
 902 работать не будут):
 903 </p>
 904 <pre class="code">gaf config --project export monochrome false</pre>
 905
 906 <p>
 907 Настроить нестандартный пользовательский шрифт:
 908 </p>
 909 <pre class="code">gaf config --user export font &quot;OpenGost Type B TT Italic&quot;</pre>
 910
 911 <p>
 912 Выбрать другой шрифт для локального проекта:
 913 </p>
 914 <pre class="code">gaf config --project export font &quot;Arial Bold&quot;</pre>
 915
 916 </div>
 917 <!-- EDIT21 SECTION "Настройка экспорта" [27826-29996] -->
 918 <h3 class="sectionedit22" id="настройка_создания_списков_соединений">Настройка создания списков соединений</h3>
 919 <div class="level3">
 920
 921 <p>
 922 Использовать более короткие имена соединений и шин во всех списках соединений
 923 созданных пользователем:
 924 </p>
 925 <pre class="code">gaf config --user gnetlist default-net-name net
 926 gaf config --user gnetlist default-bus-name bus</pre>
 927
 928 <p>
 929 Обеспечить, что в локальном проекте будут использоваться иерархические
 930 имена соединений, несмотря на настройки в <em><code>geda-user.conf</code></em>:
 931 </p>
 932 <pre class="code">gaf config --project gnetlist traverse-hierarchy true</pre>
 933
 934 <p>
 935 Переименовывать соединения, подключенные к <em><code>gnd-1.sym</code></em> (и другим символам
 936 имеющим атрибут <code>net</code>), если они имеют атрибут <code>netname</code>:
 937 </p>
 938 <pre class="code">gaf config --project gnetlist net-naming-priority netname-attribute</pre>
 939
 940 </div>
 941 <!-- EDIT22 SECTION "Настройка создания списков соединений" [29997-30959] -->
 942 <h3 class="sectionedit23" id="настройка_gschem">Настройка gschem</h3>
 943 <div class="level3">
 944
 945 <p>
 946 Использовать более короткие имена для новых файлов:
 947 </p>
 948 <pre class="code">gaf config --user gschem default-filename empty</pre>
 949
 950 </div>
 951 <!-- EDIT23 SECTION "Настройка gschem" [30960-31142] -->
 952 <h3 class="sectionedit24" id="настройка_вида_библиотеки_gschem">Настройка вида библиотеки gschem</h3>
 953 <div class="level3">
 954
 955 <p>
 956 Эта команда явно говорит, что вы хотите, чтобы всегда показывались все
 957 атрибуты:
 958 </p>
 959 <pre class="code">gaf config --project gschem.library component-attributes &quot;*&quot;</pre>
 960
 961 <p>
 962 Будьте осторожны при использовании этой команды в командной строке.
 963 Если вы забудете кавычки, командная оболочка подставит вместо имени атрибута
 964 первое имя файла в рабочем каталоге. Скорее всего, это не то, что вам надо.
 965 </p>
 966
 967 <p>
 968 Ограничить список отображаемых атрибутов указанным фильтром:
 969 </p>
 970 <pre class="code">gaf config --project gschem.library component-attributes &quot;refdes;device;description&quot;</pre>
 971
 972 <p>
 973 Не показывать никаких атрибутов в диалоговом окне выбора атрибутов:
 974 </p>
 975 <pre class="code">gaf config --project gschem.library component-attributes &quot;&quot;</pre>
 976
 977 <p>
 978 То же самое, что и выше, но эта команда работать не будет, потому что
 979 в указанной строке значения разделены запятыми, а не точками с запятыми,
 980 поэтому строка целиком будет считаться именем одного атрибута:
 981 </p>
 982 <pre class="code">gaf config --project gschem.library component-attributes &quot;refdes,device,description&quot;</pre>
 983
 984 <p>
 985 Сортировать библиотеку компонентов в <strong>gschem</strong> в алфавитном порядке:
 986 </p>
 987 <pre class="code">gaf config --user gschem.library sort true</pre>
 988
 989 </div>
 990 <!-- EDIT24 SECTION "Настройка вида библиотеки gschem" [31143-32839] -->
 991 <h3 class="sectionedit25" id="настройка_печати_из_gschem">Настройка печати из gschem</h3>
 992 <div class="level3">
 993
 994 <p>
 995 Выбрать пейзажную ориентацию (<code>landscape</code>) как ориентацию по умолчанию для локального проекта
 996 при печати из <strong>gschem</strong>:
 997 </p>
 998 <pre class="code">gaf config --project gschem.printing layout landscape</pre>
 999
1000 <p>
1001 Использовать формат A5 при печати из <strong>gschem</strong>:
1002 </p>
1003 <pre class="code">gaf config --project gschem.printing paper iso_a5</pre>
1004
1005 <p>
1006 Всегда использовать чёрно-белую печать в <strong>gschem</strong>:
1007 </p>
1008 <pre class="code">gaf config --user gschem.printing monochrome true</pre>
1009
1010 </div>
1011 <!-- EDIT25 SECTION "Настройка печати из gschem" [32840-33423] -->
1012 <h3 class="sectionedit26" id="настройка_диалоговых_окон_gschem">Настройка диалоговых окон gschem</h3>
1013 <div class="level3">
1014
1015 <p>
1016 Не отображать никаких унаследованных атрибутов в диалоговом окне редактирования атрибутов:
1017 </p>
1018 <pre class="code">gaf config --user gschem.dialog-geometry.multiattrib show_inherited false</pre>
1019
1020 <p>
1021 Учтите, что в команде выше нельзя использовать ключ <code>--project</code> (<code>-p</code>).
1022 Эта команда работает только в пользовательском контексте и не имеет смысла
1023 для локальных проектов.
1024 </p>
1025
1026 </div>
1027 <!-- EDIT26 SECTION "Настройка диалоговых окон gschem" [33424-34043] -->
1028 <h3 class="sectionedit27" id="использование_оболочки_gaf_gaf_shell">Использование оболочки gaf (gaf shell)</h3>
1029 <div class="level3">
1030
1031 <p>
1032 Для определения имени каталога пользовательских настроек gEDA,
1033 наберите:
1034 </p>
1035 <pre class="code">gaf shell -c &quot;(display (user-config-dir))&quot;</pre>
1036
1037 <p>
1038 То же самое для каталогов системных настроек:
1039 </p>
1040 <pre class="code">gaf shell -c &quot;(display (sys-config-dirs))&quot;</pre>
1041
1042 </div>
1043 <!-- EDIT27 SECTION "Использование оболочки gaf (gaf shell)" [34044-] --></body>
1044 </html>