aboutsummaryrefslogtreecommitdiff
path: root/documentation/content
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/content')
-rw-r--r--documentation/content/bn-bd/articles/explaining-bsd/_index.adoc22
-rw-r--r--documentation/content/bn-bd/articles/new-users/_index.adoc22
-rw-r--r--documentation/content/da/articles/ipsec-must/_index.adoc28
-rw-r--r--documentation/content/de/articles/contributing/_index.adoc45
-rw-r--r--documentation/content/de/articles/explaining-bsd/_index.adoc26
-rw-r--r--documentation/content/de/articles/freebsd-update-server/_index.adoc38
-rw-r--r--documentation/content/de/articles/leap-seconds/_index.adoc32
-rw-r--r--documentation/content/de/articles/linux-users/_index.adoc50
-rw-r--r--documentation/content/de/articles/nanobsd/_index.adoc25
-rw-r--r--documentation/content/de/articles/new-users/_index.adoc35
-rw-r--r--documentation/content/de/articles/port-mentor-guidelines/_index.adoc32
-rw-r--r--documentation/content/de/articles/solid-state/_index.adoc26
-rw-r--r--documentation/content/de/books/developers-handbook/_index.adoc84
-rw-r--r--documentation/content/de/books/developers-handbook/bibliography/chapter.adoc36
-rw-r--r--documentation/content/de/books/developers-handbook/introduction/chapter.adoc34
-rw-r--r--documentation/content/de/books/developers-handbook/ipv6/chapter.adoc36
-rw-r--r--documentation/content/de/books/developers-handbook/kernelbuild/chapter.adoc39
-rw-r--r--documentation/content/de/books/developers-handbook/kerneldebug/chapter.adoc37
-rw-r--r--documentation/content/de/books/developers-handbook/l10n/chapter.adoc35
-rw-r--r--documentation/content/de/books/developers-handbook/policies/chapter.adoc35
-rw-r--r--documentation/content/de/books/developers-handbook/secure/chapter.adoc35
-rw-r--r--documentation/content/de/books/developers-handbook/sockets/chapter.adoc35
-rw-r--r--documentation/content/de/books/developers-handbook/testing/chapter.adoc35
-rw-r--r--documentation/content/de/books/developers-handbook/tools/chapter.adoc36
-rw-r--r--documentation/content/de/books/developers-handbook/x86/chapter.adoc35
-rw-r--r--documentation/content/de/books/faq/_index.adoc200
-rw-r--r--documentation/content/de/books/handbook/_index.adoc45
-rw-r--r--documentation/content/de/books/handbook/advanced-networking/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/audit/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/basics/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/bibliography/_index.adoc39
-rw-r--r--documentation/content/de/books/handbook/book.adoc132
-rw-r--r--documentation/content/de/books/handbook/boot/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/bsdinstall/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/config/_index.adoc45
-rw-r--r--documentation/content/de/books/handbook/cutting-edge/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/desktop/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/disks/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/dtrace/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/eresources/_index.adoc42
-rw-r--r--documentation/content/de/books/handbook/filesystems/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/firewalls/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/geom/_index.adoc45
-rw-r--r--documentation/content/de/books/handbook/introduction/_index.adoc39
-rw-r--r--documentation/content/de/books/handbook/jails/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/kernelconfig/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/l10n/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/linuxemu/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/mac/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/mail/_index.adoc45
-rw-r--r--documentation/content/de/books/handbook/mirrors/_index.adoc38
-rw-r--r--documentation/content/de/books/handbook/multimedia/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/network-servers/_index.adoc45
-rw-r--r--documentation/content/de/books/handbook/parti.adoc10
-rw-r--r--documentation/content/de/books/handbook/partii.adoc10
-rw-r--r--documentation/content/de/books/handbook/partiii.adoc10
-rw-r--r--documentation/content/de/books/handbook/partiv.adoc10
-rw-r--r--documentation/content/de/books/handbook/partv.adoc10
-rw-r--r--documentation/content/de/books/handbook/pgpkeys/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/ports/_index.adoc53
-rw-r--r--documentation/content/de/books/handbook/ppp-and-slip/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/preface/_index.adoc33
-rw-r--r--documentation/content/de/books/handbook/printing/_index.adoc45
-rw-r--r--documentation/content/de/books/handbook/security/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/serialcomms/_index.adoc45
-rw-r--r--documentation/content/de/books/handbook/usb-device-mode/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/virtualization/_index.adoc43
-rw-r--r--documentation/content/de/books/handbook/x11/_index.adoc45
-rw-r--r--documentation/content/de/books/handbook/zfs/_index.adoc43
-rw-r--r--documentation/content/de/books/porters-handbook/_index.adoc79
-rw-r--r--documentation/content/de/books/porters-handbook/keeping-up/chapter.adoc35
-rw-r--r--documentation/content/de/books/porters-handbook/makefile/chapter.adoc39
-rw-r--r--documentation/content/de/books/porters-handbook/own-port/chapter.adoc35
-rw-r--r--documentation/content/de/books/porters-handbook/pkg-files/chapter.adoc35
-rw-r--r--documentation/content/de/books/porters-handbook/plist/chapter.adoc35
-rw-r--r--documentation/content/de/books/porters-handbook/port-upgrading/chapter.adoc43
-rw-r--r--documentation/content/de/books/porters-handbook/porting-dads/chapter.adoc39
-rw-r--r--documentation/content/de/books/porters-handbook/porting-samplem/chapter.adoc35
-rw-r--r--documentation/content/de/books/porters-handbook/quick-porting/chapter.adoc39
-rw-r--r--documentation/content/de/books/porters-handbook/security/chapter.adoc35
-rw-r--r--documentation/content/de/books/porters-handbook/slow/chapter.adoc35
-rw-r--r--documentation/content/de/books/porters-handbook/special/chapter.adoc37
-rw-r--r--documentation/content/de/books/porters-handbook/testing/chapter.adoc35
-rw-r--r--documentation/content/de/books/porters-handbook/why-port/chapter.adoc35
-rw-r--r--documentation/content/el/articles/bsdl-gpl/_index.adoc26
-rw-r--r--documentation/content/el/articles/contributing/_index.adoc45
-rw-r--r--documentation/content/el/articles/explaining-bsd/_index.adoc26
-rw-r--r--documentation/content/el/articles/freebsd-questions/_index.adoc35
-rw-r--r--documentation/content/el/articles/gjournal-desktop/_index.adoc40
-rw-r--r--documentation/content/el/articles/greek-language-support/_index.adoc31
-rw-r--r--documentation/content/el/articles/linux-users/_index.adoc52
-rw-r--r--documentation/content/el/articles/mailing-list-faq/_index.adoc40
-rw-r--r--documentation/content/el/articles/nanobsd/_index.adoc26
-rw-r--r--documentation/content/el/articles/new-users/_index.adoc32
-rw-r--r--documentation/content/el/articles/problem-reports/_index.adoc45
-rw-r--r--documentation/content/el/articles/releng/_index.adoc47
-rw-r--r--documentation/content/el/books/faq/_index.adoc208
-rw-r--r--documentation/content/el/books/handbook/_index.adoc42
-rw-r--r--documentation/content/el/books/handbook/advanced-networking/_index.adoc46
-rw-r--r--documentation/content/el/books/handbook/audit/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/basics/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/bibliography/_index.adoc40
-rw-r--r--documentation/content/el/books/handbook/book.adoc126
-rw-r--r--documentation/content/el/books/handbook/boot/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/bsdinstall/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/config/_index.adoc48
-rw-r--r--documentation/content/el/books/handbook/cutting-edge/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/desktop/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/disks/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/dtrace/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/eresources/_index.adoc43
-rw-r--r--documentation/content/el/books/handbook/filesystems/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/firewalls/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/geom/_index.adoc46
-rw-r--r--documentation/content/el/books/handbook/install/_index.adoc48
-rw-r--r--documentation/content/el/books/handbook/introduction/_index.adoc42
-rw-r--r--documentation/content/el/books/handbook/jails/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/kernelconfig/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/l10n/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/linuxemu/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/mac/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/mail/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/mirrors/_index.adoc43
-rw-r--r--documentation/content/el/books/handbook/multimedia/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/network-servers/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/parti.adoc10
-rw-r--r--documentation/content/el/books/handbook/partii.adoc10
-rw-r--r--documentation/content/el/books/handbook/partiii.adoc10
-rw-r--r--documentation/content/el/books/handbook/partiv.adoc10
-rw-r--r--documentation/content/el/books/handbook/partv.adoc10
-rw-r--r--documentation/content/el/books/handbook/pgpkeys/_index.adoc42
-rw-r--r--documentation/content/el/books/handbook/ports/_index.adoc52
-rw-r--r--documentation/content/el/books/handbook/ppp-and-slip/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/preface/_index.adoc34
-rw-r--r--documentation/content/el/books/handbook/printing/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/security/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/serialcomms/_index.adoc46
-rw-r--r--documentation/content/el/books/handbook/users/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/virtualization/_index.adoc44
-rw-r--r--documentation/content/el/books/handbook/x11/_index.adoc44
-rw-r--r--documentation/content/en/articles/bsdl-gpl/_index.adoc21
-rw-r--r--documentation/content/en/articles/building-products/_index.adoc49
-rw-r--r--documentation/content/en/articles/committers-guide/_index.adoc62
-rw-r--r--documentation/content/en/articles/contributing/_index.adoc54
-rw-r--r--documentation/content/en/articles/contributors/_index.adoc30
-rw-r--r--documentation/content/en/articles/cups/_index.adoc23
-rw-r--r--documentation/content/en/articles/explaining-bsd/_index.adoc23
-rw-r--r--documentation/content/en/articles/filtering-bridges/_index.adoc29
-rw-r--r--documentation/content/en/articles/fonts/_index.adoc23
-rw-r--r--documentation/content/en/articles/freebsd-questions/_index.adoc32
-rw-r--r--documentation/content/en/articles/freebsd-releng/_index.adoc22
-rw-r--r--documentation/content/en/articles/freebsd-src-lsp/_index.adoc23
-rw-r--r--documentation/content/en/articles/freebsd-update-server/_index.adoc36
-rw-r--r--documentation/content/en/articles/geom-class/_index.adoc29
-rw-r--r--documentation/content/en/articles/gjournal-desktop/_index.adoc41
-rw-r--r--documentation/content/en/articles/hubs/_index.adoc29
-rw-r--r--documentation/content/en/articles/ipsec-must/_index.adoc27
-rw-r--r--documentation/content/en/articles/ldap-auth/_index.adoc21
-rw-r--r--documentation/content/en/articles/leap-seconds/_index.adoc27
-rw-r--r--documentation/content/en/articles/linux-emulation/_index.adoc21
-rw-r--r--documentation/content/en/articles/linux-users/_index.adoc47
-rw-r--r--documentation/content/en/articles/mailing-list-faq/_index.adoc33
-rw-r--r--documentation/content/en/articles/nanobsd/_index.adoc28
-rw-r--r--documentation/content/en/articles/new-users/_index.adoc21
-rw-r--r--documentation/content/en/articles/pam/_index.adoc60
-rw-r--r--documentation/content/en/articles/pgpkeys/_index.adoc26
-rw-r--r--documentation/content/en/articles/port-mentor-guidelines/_index.adoc27
-rw-r--r--documentation/content/en/articles/pr-guidelines/_index.adoc30
-rw-r--r--documentation/content/en/articles/problem-reports/_index.adoc42
-rw-r--r--documentation/content/en/articles/rc-scripting/_index.adoc27
-rw-r--r--documentation/content/en/articles/releng/_index.adoc52
-rw-r--r--documentation/content/en/articles/remote-install/_index.adoc26
-rw-r--r--documentation/content/en/articles/serial-uart/_index.adoc27
-rw-r--r--documentation/content/en/articles/solid-state/_index.adoc21
-rw-r--r--documentation/content/en/articles/vinum/_index.adoc34
-rw-r--r--documentation/content/en/articles/vm-design/_index.adoc25
-rw-r--r--documentation/content/en/books/arch-handbook/_index.adoc41
-rw-r--r--documentation/content/en/books/arch-handbook/bibliography/_index.adoc35
-rw-r--r--documentation/content/en/books/arch-handbook/book.adoc82
-rw-r--r--documentation/content/en/books/arch-handbook/boot/_index.adoc31
-rw-r--r--documentation/content/en/books/arch-handbook/driverbasics/_index.adoc31
-rw-r--r--documentation/content/en/books/arch-handbook/isa/_index.adoc31
-rw-r--r--documentation/content/en/books/arch-handbook/jail/_index.adoc33
-rw-r--r--documentation/content/en/books/arch-handbook/kobj/_index.adoc31
-rw-r--r--documentation/content/en/books/arch-handbook/locking/_index.adoc31
-rw-r--r--documentation/content/en/books/arch-handbook/mac/_index.adoc31
-rw-r--r--documentation/content/en/books/arch-handbook/newbus/_index.adoc31
-rw-r--r--documentation/content/en/books/arch-handbook/parti.adoc12
-rw-r--r--documentation/content/en/books/arch-handbook/partii.adoc10
-rw-r--r--documentation/content/en/books/arch-handbook/partiii.adoc10
-rw-r--r--documentation/content/en/books/arch-handbook/pccard/_index.adoc31
-rw-r--r--documentation/content/en/books/arch-handbook/pci/_index.adoc31
-rw-r--r--documentation/content/en/books/arch-handbook/scsi/_index.adoc31
-rw-r--r--documentation/content/en/books/arch-handbook/smp/_index.adoc31
-rw-r--r--documentation/content/en/books/arch-handbook/sound/_index.adoc31
-rw-r--r--documentation/content/en/books/arch-handbook/sysinit/_index.adoc31
-rw-r--r--documentation/content/en/books/arch-handbook/usb/_index.adoc31
-rw-r--r--documentation/content/en/books/arch-handbook/vm/_index.adoc31
-rw-r--r--documentation/content/en/books/design-44bsd/_index.adoc49
-rw-r--r--documentation/content/en/books/dev-model/_index.adoc63
-rw-r--r--documentation/content/en/books/developers-handbook/_index.adoc42
-rw-r--r--documentation/content/en/books/developers-handbook/bibliography/_index.adoc36
-rw-r--r--documentation/content/en/books/developers-handbook/book.adoc79
-rw-r--r--documentation/content/en/books/developers-handbook/introduction/_index.adoc31
-rw-r--r--documentation/content/en/books/developers-handbook/ipv6/_index.adoc31
-rw-r--r--documentation/content/en/books/developers-handbook/kernelbuild/_index.adoc35
-rw-r--r--documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc33
-rw-r--r--documentation/content/en/books/developers-handbook/l10n/_index.adoc31
-rw-r--r--documentation/content/en/books/developers-handbook/parti.adoc12
-rw-r--r--documentation/content/en/books/developers-handbook/partii.adoc10
-rw-r--r--documentation/content/en/books/developers-handbook/partiii.adoc10
-rw-r--r--documentation/content/en/books/developers-handbook/partiv.adoc10
-rw-r--r--documentation/content/en/books/developers-handbook/partv.adoc10
-rw-r--r--documentation/content/en/books/developers-handbook/policies/_index.adoc31
-rw-r--r--documentation/content/en/books/developers-handbook/secure/_index.adoc31
-rw-r--r--documentation/content/en/books/developers-handbook/sockets/_index.adoc32
-rw-r--r--documentation/content/en/books/developers-handbook/testing/_index.adoc31
-rw-r--r--documentation/content/en/books/developers-handbook/tools/_index.adoc39
-rw-r--r--documentation/content/en/books/developers-handbook/x86/_index.adoc31
-rw-r--r--documentation/content/en/books/faq/_index.adoc151
-rw-r--r--documentation/content/en/books/fdp-primer/_index.adoc28
-rw-r--r--documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc40
-rw-r--r--documentation/content/en/books/fdp-primer/book.adoc71
-rw-r--r--documentation/content/en/books/fdp-primer/doc-build/_index.adoc34
-rw-r--r--documentation/content/en/books/fdp-primer/editor-config/_index.adoc30
-rw-r--r--documentation/content/en/books/fdp-primer/examples/_index.adoc30
-rw-r--r--documentation/content/en/books/fdp-primer/manual-pages/_index.adoc32
-rw-r--r--documentation/content/en/books/fdp-primer/overview/_index.adoc35
-rw-r--r--documentation/content/en/books/fdp-primer/po-translations/_index.adoc44
-rw-r--r--documentation/content/en/books/fdp-primer/preface/_index.adoc31
-rw-r--r--documentation/content/en/books/fdp-primer/rosetta/_index.adoc30
-rw-r--r--documentation/content/en/books/fdp-primer/see-also/_index.adoc32
-rw-r--r--documentation/content/en/books/fdp-primer/structure/_index.adoc31
-rw-r--r--documentation/content/en/books/fdp-primer/tools/_index.adoc30
-rw-r--r--documentation/content/en/books/fdp-primer/translations/_index.adoc35
-rw-r--r--documentation/content/en/books/fdp-primer/working-copy/_index.adoc30
-rw-r--r--documentation/content/en/books/fdp-primer/writing-style/_index.adoc32
-rw-r--r--documentation/content/en/books/handbook/_index.adoc32
-rw-r--r--documentation/content/en/books/handbook/advanced-networking/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/audit/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/basics/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/bibliography/_index.adoc36
-rw-r--r--documentation/content/en/books/handbook/book.adoc126
-rw-r--r--documentation/content/en/books/handbook/boot/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/bsdinstall/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/colophon.adoc32
-rw-r--r--documentation/content/en/books/handbook/config/_index.adoc42
-rw-r--r--documentation/content/en/books/handbook/cutting-edge/_index.adoc44
-rw-r--r--documentation/content/en/books/handbook/desktop/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/disks/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/dtrace/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/eresources/_index.adoc39
-rw-r--r--documentation/content/en/books/handbook/filesystems/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/firewalls/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/geom/_index.adoc42
-rw-r--r--documentation/content/en/books/handbook/glossary.adoc38
-rw-r--r--documentation/content/en/books/handbook/introduction/_index.adoc46
-rw-r--r--documentation/content/en/books/handbook/jails/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/kernelconfig/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/l10n/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/linuxemu/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/mac/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/mail/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/mirrors/_index.adoc39
-rw-r--r--documentation/content/en/books/handbook/multimedia/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/network-servers/_index.adoc42
-rw-r--r--documentation/content/en/books/handbook/parti.adoc10
-rw-r--r--documentation/content/en/books/handbook/partii.adoc10
-rw-r--r--documentation/content/en/books/handbook/partiii.adoc10
-rw-r--r--documentation/content/en/books/handbook/partiv.adoc10
-rw-r--r--documentation/content/en/books/handbook/partv.adoc10
-rw-r--r--documentation/content/en/books/handbook/pgpkeys/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/ports/_index.adoc50
-rw-r--r--documentation/content/en/books/handbook/ppp-and-slip/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/preface/_index.adoc31
-rw-r--r--documentation/content/en/books/handbook/printing/_index.adoc42
-rw-r--r--documentation/content/en/books/handbook/security/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/serialcomms/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/usb-device-mode/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/virtualization/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/wine/_index.adoc40
-rw-r--r--documentation/content/en/books/handbook/x11/_index.adoc42
-rw-r--r--documentation/content/en/books/handbook/zfs/_index.adoc40
-rw-r--r--documentation/content/en/books/porters-handbook/_index.adoc27
-rw-r--r--documentation/content/en/books/porters-handbook/book.adoc78
-rw-r--r--documentation/content/en/books/porters-handbook/flavors/_index.adoc31
-rw-r--r--documentation/content/en/books/porters-handbook/keeping-up/_index.adoc31
-rw-r--r--documentation/content/en/books/porters-handbook/makefiles/_index.adoc39
-rw-r--r--documentation/content/en/books/porters-handbook/new-port/_index.adoc31
-rw-r--r--documentation/content/en/books/porters-handbook/order/_index.adoc31
-rw-r--r--documentation/content/en/books/porters-handbook/pkg-files/_index.adoc31
-rw-r--r--documentation/content/en/books/porters-handbook/plist/_index.adoc31
-rw-r--r--documentation/content/en/books/porters-handbook/porting-dads/_index.adoc35
-rw-r--r--documentation/content/en/books/porters-handbook/porting-samplem/_index.adoc31
-rw-r--r--documentation/content/en/books/porters-handbook/porting-why/_index.adoc33
-rw-r--r--documentation/content/en/books/porters-handbook/quick-porting/_index.adoc33
-rw-r--r--documentation/content/en/books/porters-handbook/security/_index.adoc31
-rw-r--r--documentation/content/en/books/porters-handbook/slow-porting/_index.adoc31
-rw-r--r--documentation/content/en/books/porters-handbook/special/_index.adoc35
-rw-r--r--documentation/content/en/books/porters-handbook/testing/_index.adoc33
-rw-r--r--documentation/content/en/books/porters-handbook/upgrading/_index.adoc41
-rw-r--r--documentation/content/en/books/porters-handbook/uses/_index.adoc32
-rw-r--r--documentation/content/en/books/porters-handbook/versions/_index.adoc31
-rw-r--r--documentation/content/es/articles/bsdl-gpl/_index.adoc21
-rw-r--r--documentation/content/es/articles/building-products/_index.adoc49
-rw-r--r--documentation/content/es/articles/contributing/_index.adoc374
-rw-r--r--documentation/content/es/articles/contributors/_index.adoc42
-rw-r--r--documentation/content/es/articles/contributors/_index.po4
-rw-r--r--documentation/content/es/articles/contributors/contrib-386bsd.adoc95
-rw-r--r--documentation/content/es/articles/contributors/contrib-additional.adoc2387
-rw-r--r--documentation/content/es/articles/contributors/contrib-committers.adoc399
-rw-r--r--documentation/content/es/articles/contributors/contrib-corealumni.adoc56
-rw-r--r--documentation/content/es/articles/contributors/contrib-develalumni.adoc499
-rw-r--r--documentation/content/es/articles/contributors/contrib-portmgralumni.adoc23
-rw-r--r--documentation/content/es/articles/cups/_index.adoc21
-rw-r--r--documentation/content/es/articles/explaining-bsd/_index.adoc136
-rw-r--r--documentation/content/es/articles/filtering-bridges/_index.adoc118
-rw-r--r--documentation/content/es/articles/fonts/_index.adoc30
-rw-r--r--documentation/content/es/articles/freebsd-questions/_index.adoc38
-rw-r--r--documentation/content/es/articles/ipsec-must/_index.adoc36
-rw-r--r--documentation/content/es/articles/leap-seconds/_index.adoc36
-rw-r--r--documentation/content/es/articles/linux-users/_index.adoc56
-rw-r--r--documentation/content/es/articles/mailing-list-faq/_index.adoc42
-rw-r--r--documentation/content/es/articles/nanobsd/_index.adoc30
-rw-r--r--documentation/content/es/articles/port-mentor-guidelines/_index.adoc36
-rw-r--r--documentation/content/es/articles/pr-guidelines/_index.adoc36
-rw-r--r--documentation/content/es/articles/problem-reports/_index.adoc48
-rw-r--r--documentation/content/es/articles/releng/_index.adoc59
-rw-r--r--documentation/content/es/articles/remote-install/_index.adoc36
-rw-r--r--documentation/content/es/articles/solid-state/_index.adoc30
-rw-r--r--documentation/content/es/articles/vinum/_index.adoc34
-rw-r--r--documentation/content/es/articles/vm-design/_index.adoc25
-rw-r--r--documentation/content/es/books/faq/_index.adoc206
-rw-r--r--documentation/content/es/books/handbook/_index.adoc41
-rw-r--r--documentation/content/es/books/handbook/advanced-networking/_index.adoc46
-rw-r--r--documentation/content/es/books/handbook/audit/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/basics/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/bibliography/_index.adoc38
-rw-r--r--documentation/content/es/books/handbook/book.adoc127
-rw-r--r--documentation/content/es/books/handbook/boot/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/config/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/cutting-edge/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/desktop/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/disks/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/eresources/_index.adoc39
-rw-r--r--documentation/content/es/books/handbook/firewalls/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/geom/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/install/_index.adoc47
-rw-r--r--documentation/content/es/books/handbook/introduction/_index.adoc41
-rw-r--r--documentation/content/es/books/handbook/jails/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/kernelconfig/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/l10n/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/linuxemu/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/mac/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/mail/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/mirrors/_index.adoc39
-rw-r--r--documentation/content/es/books/handbook/multimedia/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/network-servers/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/parti.adoc10
-rw-r--r--documentation/content/es/books/handbook/partii.adoc10
-rw-r--r--documentation/content/es/books/handbook/partiii.adoc10
-rw-r--r--documentation/content/es/books/handbook/partiv.adoc10
-rw-r--r--documentation/content/es/books/handbook/partv.adoc10
-rw-r--r--documentation/content/es/books/handbook/pgpkeys/_index.adoc42
-rw-r--r--documentation/content/es/books/handbook/ports/_index.adoc50
-rw-r--r--documentation/content/es/books/handbook/ppp-and-slip/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/preface/_index.adoc34
-rw-r--r--documentation/content/es/books/handbook/printing/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/security/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/serialcomms/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/users/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/vinum/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/virtualization/_index.adoc44
-rw-r--r--documentation/content/es/books/handbook/x11/_index.adoc44
-rw-r--r--documentation/content/fr/articles/building-products/_index.adoc51
-rw-r--r--documentation/content/fr/articles/committers-guide/_index.adoc38
-rw-r--r--documentation/content/fr/articles/contributing/_index.adoc47
-rw-r--r--documentation/content/fr/articles/explaining-bsd/_index.adoc28
-rw-r--r--documentation/content/fr/articles/filtering-bridges/_index.adoc34
-rw-r--r--documentation/content/fr/articles/fonts/_index.adoc28
-rw-r--r--documentation/content/fr/articles/ipsec-must/_index.adoc34
-rw-r--r--documentation/content/fr/articles/leap-seconds/_index.adoc34
-rw-r--r--documentation/content/fr/articles/linux-users/_index.adoc54
-rw-r--r--documentation/content/fr/articles/nanobsd/_index.adoc30
-rw-r--r--documentation/content/fr/articles/new-users/_index.adoc36
-rw-r--r--documentation/content/fr/articles/pam/_index.adoc67
-rw-r--r--documentation/content/fr/articles/pr-guidelines/_index.adoc28
-rw-r--r--documentation/content/fr/articles/problem-reports/_index.adoc28
-rw-r--r--documentation/content/fr/books/developers-handbook/_index.adoc56
-rw-r--r--documentation/content/fr/books/developers-handbook/driverbasics/chapter.adoc35
-rw-r--r--documentation/content/fr/books/developers-handbook/locking/chapter.adoc35
-rw-r--r--documentation/content/fr/books/developers-handbook/pci/chapter.adoc35
-rw-r--r--documentation/content/fr/books/developers-handbook/scsi/chapter.adoc35
-rw-r--r--documentation/content/fr/books/developers-handbook/secure/chapter.adoc35
-rw-r--r--documentation/content/fr/books/developers-handbook/tools/chapter.adoc36
-rw-r--r--documentation/content/fr/books/developers-handbook/usb/chapter.adoc35
-rw-r--r--documentation/content/fr/books/faq/_index.adoc143
-rw-r--r--documentation/content/fr/books/handbook/_index.adoc39
-rw-r--r--documentation/content/fr/books/handbook/advanced-networking/_index.adoc45
-rw-r--r--documentation/content/fr/books/handbook/audit/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/basics/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/bibliography/_index.adoc39
-rw-r--r--documentation/content/fr/books/handbook/book.adoc131
-rw-r--r--documentation/content/fr/books/handbook/boot/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/bsdinstall/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/config/_index.adoc47
-rw-r--r--documentation/content/fr/books/handbook/cutting-edge/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/desktop/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/disks/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/dtrace/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/eresources/_index.adoc42
-rw-r--r--documentation/content/fr/books/handbook/filesystems/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/firewalls/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/geom/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/introduction/_index.adoc41
-rw-r--r--documentation/content/fr/books/handbook/jails/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/kernelconfig/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/l10n/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/linuxemu/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/mac/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/mail/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/mirrors/_index.adoc42
-rw-r--r--documentation/content/fr/books/handbook/multimedia/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/network-servers/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/parti.adoc10
-rw-r--r--documentation/content/fr/books/handbook/partii.adoc10
-rw-r--r--documentation/content/fr/books/handbook/partiii.adoc10
-rw-r--r--documentation/content/fr/books/handbook/partiv.adoc10
-rw-r--r--documentation/content/fr/books/handbook/partv.adoc10
-rw-r--r--documentation/content/fr/books/handbook/pgpkeys/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/ports/_index.adoc51
-rw-r--r--documentation/content/fr/books/handbook/ppp-and-slip/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/preface/_index.adoc32
-rw-r--r--documentation/content/fr/books/handbook/printing/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/security/_index.adoc45
-rw-r--r--documentation/content/fr/books/handbook/serialcomms/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/users/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/vinum/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/virtualization/_index.adoc43
-rw-r--r--documentation/content/fr/books/handbook/x11/_index.adoc45
-rw-r--r--documentation/content/fr/books/handbook/zfs/_index.adoc43
-rw-r--r--documentation/content/fr/books/porters-handbook/book.adoc50
-rw-r--r--documentation/content/hu/articles/cups/_index.adoc26
-rw-r--r--documentation/content/hu/articles/explaining-bsd/_index.adoc26
-rw-r--r--documentation/content/hu/articles/gjournal-desktop/_index.adoc40
-rw-r--r--documentation/content/hu/articles/linux-users/_index.adoc52
-rw-r--r--documentation/content/hu/books/faq/_index.adoc249
-rw-r--r--documentation/content/hu/books/handbook/_index.adoc37
-rw-r--r--documentation/content/hu/books/handbook/advanced-networking/_index.adoc46
-rw-r--r--documentation/content/hu/books/handbook/audit/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/basics/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/bibliography/_index.adoc38
-rw-r--r--documentation/content/hu/books/handbook/book.adoc127
-rw-r--r--documentation/content/hu/books/handbook/boot/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/config/_index.adoc48
-rw-r--r--documentation/content/hu/books/handbook/cutting-edge/_index.adoc46
-rw-r--r--documentation/content/hu/books/handbook/desktop/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/disks/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/dtrace/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/eresources/_index.adoc43
-rw-r--r--documentation/content/hu/books/handbook/filesystems/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/firewalls/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/geom/_index.adoc46
-rw-r--r--documentation/content/hu/books/handbook/install/_index.adoc48
-rw-r--r--documentation/content/hu/books/handbook/introduction/_index.adoc42
-rw-r--r--documentation/content/hu/books/handbook/jails/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/kernelconfig/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/l10n/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/linuxemu/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/mac/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/mail/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/mirrors/_index.adoc43
-rw-r--r--documentation/content/hu/books/handbook/multimedia/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/network-servers/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/parti.adoc10
-rw-r--r--documentation/content/hu/books/handbook/partii.adoc10
-rw-r--r--documentation/content/hu/books/handbook/partiii.adoc10
-rw-r--r--documentation/content/hu/books/handbook/partiv.adoc10
-rw-r--r--documentation/content/hu/books/handbook/partv.adoc10
-rw-r--r--documentation/content/hu/books/handbook/pgpkeys/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/ports/_index.adoc52
-rw-r--r--documentation/content/hu/books/handbook/ppp-and-slip/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/preface/_index.adoc34
-rw-r--r--documentation/content/hu/books/handbook/printing/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/security/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/serialcomms/_index.adoc46
-rw-r--r--documentation/content/hu/books/handbook/users/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/vinum/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/virtualization/_index.adoc44
-rw-r--r--documentation/content/hu/books/handbook/x11/_index.adoc44
-rw-r--r--documentation/content/it/articles/bsdl-gpl/_index.adoc29
-rw-r--r--documentation/content/it/books/handbook/_index.adoc40
-rw-r--r--documentation/content/it/books/handbook/advanced-networking/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/audit/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/basics/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/bibliography/_index.adoc39
-rw-r--r--documentation/content/it/books/handbook/book.adoc126
-rw-r--r--documentation/content/it/books/handbook/boot/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/config/_index.adoc47
-rw-r--r--documentation/content/it/books/handbook/cutting-edge/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/desktop/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/disks/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/eresources/_index.adoc42
-rw-r--r--documentation/content/it/books/handbook/firewalls/_index.adoc44
-rw-r--r--documentation/content/it/books/handbook/geom/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/install/_index.adoc47
-rw-r--r--documentation/content/it/books/handbook/introduction/_index.adoc51
-rw-r--r--documentation/content/it/books/handbook/jails/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/kernelconfig/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/l10n/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/linuxemu/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/mac/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/mail/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/mirrors/_index.adoc42
-rw-r--r--documentation/content/it/books/handbook/multimedia/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/network-servers/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/parti.adoc10
-rw-r--r--documentation/content/it/books/handbook/partii.adoc10
-rw-r--r--documentation/content/it/books/handbook/partiii.adoc10
-rw-r--r--documentation/content/it/books/handbook/partiv.adoc10
-rw-r--r--documentation/content/it/books/handbook/partv.adoc10
-rw-r--r--documentation/content/it/books/handbook/pgpkeys/_index.adoc42
-rw-r--r--documentation/content/it/books/handbook/ports/_index.adoc51
-rw-r--r--documentation/content/it/books/handbook/ppp-and-slip/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/preface/_index.adoc32
-rw-r--r--documentation/content/it/books/handbook/printing/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/security/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/serialcomms/_index.adoc45
-rw-r--r--documentation/content/it/books/handbook/users/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/vinum/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/virtualization/_index.adoc43
-rw-r--r--documentation/content/it/books/handbook/x11/_index.adoc43
-rw-r--r--documentation/content/ja/articles/contributing/_index.adoc46
-rw-r--r--documentation/content/ja/articles/fonts/_index.adoc35
-rw-r--r--documentation/content/ja/articles/ipsec-must/_index.adoc37
-rw-r--r--documentation/content/ja/articles/leap-seconds/_index.adoc35
-rw-r--r--documentation/content/ja/articles/problem-reports/_index.adoc50
-rw-r--r--documentation/content/ja/books/design-44bsd/_index.adoc57
-rw-r--r--documentation/content/ja/books/faq/_index.adoc145
-rw-r--r--documentation/content/ja/books/handbook/_index.adoc40
-rw-r--r--documentation/content/ja/books/handbook/advanced-networking/_index.adoc46
-rw-r--r--documentation/content/ja/books/handbook/basics/_index.adoc44
-rw-r--r--documentation/content/ja/books/handbook/bibliography/_index.adoc40
-rw-r--r--documentation/content/ja/books/handbook/book.adoc109
-rw-r--r--documentation/content/ja/books/handbook/boot/_index.adoc44
-rw-r--r--documentation/content/ja/books/handbook/bsdinstall/_index.adoc44
-rw-r--r--documentation/content/ja/books/handbook/config/_index.adoc44
-rw-r--r--documentation/content/ja/books/handbook/cutting-edge/_index.adoc48
-rw-r--r--documentation/content/ja/books/handbook/desktop/_index.adoc44
-rw-r--r--documentation/content/ja/books/handbook/disks/_index.adoc44
-rw-r--r--documentation/content/ja/books/handbook/eresources/_index.adoc43
-rw-r--r--documentation/content/ja/books/handbook/introduction/_index.adoc50
-rw-r--r--documentation/content/ja/books/handbook/kernelconfig/_index.adoc44
-rw-r--r--documentation/content/ja/books/handbook/l10n/_index.adoc44
-rw-r--r--documentation/content/ja/books/handbook/linuxemu/_index.adoc44
-rw-r--r--documentation/content/ja/books/handbook/mail/_index.adoc44
-rw-r--r--documentation/content/ja/books/handbook/mirrors/_index.adoc41
-rw-r--r--documentation/content/ja/books/handbook/multimedia/_index.adoc44
-rw-r--r--documentation/content/ja/books/handbook/parti.adoc10
-rw-r--r--documentation/content/ja/books/handbook/partii.adoc10
-rw-r--r--documentation/content/ja/books/handbook/partiii.adoc10
-rw-r--r--documentation/content/ja/books/handbook/partiv.adoc10
-rw-r--r--documentation/content/ja/books/handbook/partv.adoc10
-rw-r--r--documentation/content/ja/books/handbook/pgpkeys/_index.adoc44
-rw-r--r--documentation/content/ja/books/handbook/ports/_index.adoc52
-rw-r--r--documentation/content/ja/books/handbook/ppp-and-slip/_index.adoc46
-rw-r--r--documentation/content/ja/books/handbook/preface/_index.adoc33
-rw-r--r--documentation/content/ja/books/handbook/printing/_index.adoc44
-rw-r--r--documentation/content/ja/books/handbook/security/_index.adoc44
-rw-r--r--documentation/content/ja/books/handbook/serialcomms/_index.adoc46
-rw-r--r--documentation/content/ja/books/handbook/users/_index.adoc44
-rw-r--r--documentation/content/ja/books/handbook/x11/_index.adoc46
-rw-r--r--documentation/content/ja/books/porters-handbook/_index.adoc87
-rw-r--r--documentation/content/ja/books/porters-handbook/changes/chapter.adoc35
-rw-r--r--documentation/content/ja/books/porters-handbook/makefile/chapter.adoc37
-rw-r--r--documentation/content/ja/books/porters-handbook/own-port/chapter.adoc35
-rw-r--r--documentation/content/ja/books/porters-handbook/pkg-files/chapter.adoc35
-rw-r--r--documentation/content/ja/books/porters-handbook/port-upgrading/chapter.adoc39
-rw-r--r--documentation/content/ja/books/porters-handbook/porting-autoplist/chapter.adoc35
-rw-r--r--documentation/content/ja/books/porters-handbook/porting-dads/chapter.adoc39
-rw-r--r--documentation/content/ja/books/porters-handbook/porting-info/chapter.adoc35
-rw-r--r--documentation/content/ja/books/porters-handbook/porting-manpages/chapter.adoc35
-rw-r--r--documentation/content/ja/books/porters-handbook/porting-masterdir/chapter.adoc35
-rw-r--r--documentation/content/ja/books/porters-handbook/porting-motif/chapter.adoc35
-rw-r--r--documentation/content/ja/books/porters-handbook/porting-samplem/chapter.adoc35
-rw-r--r--documentation/content/ja/books/porters-handbook/quick-porting/chapter.adoc39
-rw-r--r--documentation/content/ja/books/porters-handbook/shared/chapter.adoc37
-rw-r--r--documentation/content/ja/books/porters-handbook/slow/chapter.adoc35
-rw-r--r--documentation/content/ja/books/porters-handbook/special/chapter.adoc35
-rw-r--r--documentation/content/ja/books/porters-handbook/testing/chapter.adoc35
-rw-r--r--documentation/content/ja/books/porters-handbook/why-port/chapter.adoc35
-rw-r--r--documentation/content/ja/books/porters-handbook/x11-fonts/chapter.adoc35
-rw-r--r--documentation/content/ko/articles/bsdl-gpl/_index.adoc26
-rw-r--r--documentation/content/ko/articles/contributing/_index.adoc54
-rw-r--r--documentation/content/ko/articles/explaining-bsd/_index.adoc26
-rw-r--r--documentation/content/mn/books/handbook/_index.adoc40
-rw-r--r--documentation/content/mn/books/handbook/advanced-networking/_index.adoc46
-rw-r--r--documentation/content/mn/books/handbook/audit/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/basics/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/bibliography/_index.adoc40
-rw-r--r--documentation/content/mn/books/handbook/book.adoc132
-rw-r--r--documentation/content/mn/books/handbook/boot/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/bsdinstall/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/config/_index.adoc48
-rw-r--r--documentation/content/mn/books/handbook/cutting-edge/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/desktop/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/disks/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/dtrace/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/eresources/_index.adoc43
-rw-r--r--documentation/content/mn/books/handbook/filesystems/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/firewalls/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/geom/_index.adoc46
-rw-r--r--documentation/content/mn/books/handbook/install/_index.adoc48
-rw-r--r--documentation/content/mn/books/handbook/introduction/_index.adoc52
-rw-r--r--documentation/content/mn/books/handbook/jails/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/kernelconfig/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/l10n/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/linuxemu/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/mac/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/mail/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/mirrors/_index.adoc41
-rw-r--r--documentation/content/mn/books/handbook/multimedia/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/network-servers/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/parti.adoc10
-rw-r--r--documentation/content/mn/books/handbook/partii.adoc10
-rw-r--r--documentation/content/mn/books/handbook/partiii.adoc10
-rw-r--r--documentation/content/mn/books/handbook/partiv.adoc10
-rw-r--r--documentation/content/mn/books/handbook/partv.adoc10
-rw-r--r--documentation/content/mn/books/handbook/pgpkeys/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/ports/_index.adoc56
-rw-r--r--documentation/content/mn/books/handbook/ppp-and-slip/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/preface/_index.adoc32
-rw-r--r--documentation/content/mn/books/handbook/printing/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/security/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/serialcomms/_index.adoc46
-rw-r--r--documentation/content/mn/books/handbook/users/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/vinum/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/virtualization/_index.adoc44
-rw-r--r--documentation/content/mn/books/handbook/x11/_index.adoc44
-rw-r--r--documentation/content/nl/articles/contributing/_index.adoc46
-rw-r--r--documentation/content/nl/articles/explaining-bsd/_index.adoc29
-rw-r--r--documentation/content/nl/articles/leap-seconds/_index.adoc35
-rw-r--r--documentation/content/nl/articles/problem-reports/_index.adoc48
-rw-r--r--documentation/content/nl/articles/solid-state/_index.adoc29
-rw-r--r--documentation/content/nl/books/handbook/_index.adoc40
-rw-r--r--documentation/content/nl/books/handbook/advanced-networking/_index.adoc46
-rw-r--r--documentation/content/nl/books/handbook/audit/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/basics/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/bibliography/_index.adoc40
-rw-r--r--documentation/content/nl/books/handbook/book.adoc130
-rw-r--r--documentation/content/nl/books/handbook/boot/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/bsdinstall/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/config/_index.adoc48
-rw-r--r--documentation/content/nl/books/handbook/cutting-edge/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/desktop/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/disks/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/dtrace/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/eresources/_index.adoc43
-rw-r--r--documentation/content/nl/books/handbook/filesystems/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/firewalls/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/geom/_index.adoc46
-rw-r--r--documentation/content/nl/books/handbook/install/_index.adoc48
-rw-r--r--documentation/content/nl/books/handbook/introduction/_index.adoc42
-rw-r--r--documentation/content/nl/books/handbook/jails/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/kernelconfig/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/l10n/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/linuxemu/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/mac/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/mail/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/mirrors/_index.adoc43
-rw-r--r--documentation/content/nl/books/handbook/multimedia/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/network-servers/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/parti.adoc10
-rw-r--r--documentation/content/nl/books/handbook/partii.adoc10
-rw-r--r--documentation/content/nl/books/handbook/partiii.adoc10
-rw-r--r--documentation/content/nl/books/handbook/partiv.adoc10
-rw-r--r--documentation/content/nl/books/handbook/partv.adoc10
-rw-r--r--documentation/content/nl/books/handbook/pgpkeys/_index.adoc42
-rw-r--r--documentation/content/nl/books/handbook/ports/_index.adoc56
-rw-r--r--documentation/content/nl/books/handbook/ppp-and-slip/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/preface/_index.adoc33
-rw-r--r--documentation/content/nl/books/handbook/printing/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/security/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/serialcomms/_index.adoc46
-rw-r--r--documentation/content/nl/books/handbook/users/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/virtualization/_index.adoc44
-rw-r--r--documentation/content/nl/books/handbook/x11/_index.adoc44
-rw-r--r--documentation/content/pl/articles/filtering-bridges/_index.adoc35
-rw-r--r--documentation/content/pl/articles/new-users/_index.adoc29
-rw-r--r--documentation/content/pl/books/handbook/_index.adoc40
-rw-r--r--documentation/content/pl/books/handbook/advanced-networking/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/audit/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/basics/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/bibliography/_index.adoc38
-rw-r--r--documentation/content/pl/books/handbook/book.adoc130
-rw-r--r--documentation/content/pl/books/handbook/boot/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/config/_index.adoc46
-rw-r--r--documentation/content/pl/books/handbook/cutting-edge/_index.adoc46
-rw-r--r--documentation/content/pl/books/handbook/desktop/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/disks/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/dtrace/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/eresources/_index.adoc43
-rw-r--r--documentation/content/pl/books/handbook/filesystems/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/firewalls/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/geom/_index.adoc46
-rw-r--r--documentation/content/pl/books/handbook/install/_index.adoc48
-rw-r--r--documentation/content/pl/books/handbook/introduction/_index.adoc42
-rw-r--r--documentation/content/pl/books/handbook/jails/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/kernelconfig/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/l10n/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/linuxemu/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/mac/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/mail/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/mirrors/_index.adoc39
-rw-r--r--documentation/content/pl/books/handbook/multimedia/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/network-servers/_index.adoc46
-rw-r--r--documentation/content/pl/books/handbook/parti.adoc10
-rw-r--r--documentation/content/pl/books/handbook/partii.adoc10
-rw-r--r--documentation/content/pl/books/handbook/partiii.adoc10
-rw-r--r--documentation/content/pl/books/handbook/partiv.adoc10
-rw-r--r--documentation/content/pl/books/handbook/partv.adoc10
-rw-r--r--documentation/content/pl/books/handbook/pgpkeys/_index.adoc42
-rw-r--r--documentation/content/pl/books/handbook/ports/_index.adoc52
-rw-r--r--documentation/content/pl/books/handbook/ppp-and-slip/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/preface/_index.adoc33
-rw-r--r--documentation/content/pl/books/handbook/printing/_index.adoc46
-rw-r--r--documentation/content/pl/books/handbook/security/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/serialcomms/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/usb-device-mode/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/users/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/virtualization/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/x11/_index.adoc44
-rw-r--r--documentation/content/pl/books/handbook/zfs/_index.adoc44
-rw-r--r--documentation/content/pt-br/articles/bsdl-gpl/_index.adoc21
-rw-r--r--documentation/content/pt-br/articles/building-products/_index.adoc54
-rw-r--r--documentation/content/pt-br/articles/committers-guide/_index.adoc45
-rw-r--r--documentation/content/pt-br/articles/contributing/_index.adoc59
-rw-r--r--documentation/content/pt-br/articles/contributors/_index.adoc49
-rw-r--r--documentation/content/pt-br/articles/contributors/_index.po4
-rw-r--r--documentation/content/pt-br/articles/contributors/contrib-386bsd.adoc95
-rw-r--r--documentation/content/pt-br/articles/contributors/contrib-additional.adoc2387
-rw-r--r--documentation/content/pt-br/articles/contributors/contrib-committers.adoc399
-rw-r--r--documentation/content/pt-br/articles/contributors/contrib-corealumni.adoc56
-rw-r--r--documentation/content/pt-br/articles/contributors/contrib-develalumni.adoc499
-rw-r--r--documentation/content/pt-br/articles/contributors/contrib-develinmemoriam.adoc10
-rw-r--r--documentation/content/pt-br/articles/contributors/contrib-portmgralumni.adoc23
-rw-r--r--documentation/content/pt-br/articles/cups/_index.adoc29
-rw-r--r--documentation/content/pt-br/articles/explaining-bsd/_index.adoc28
-rw-r--r--documentation/content/pt-br/articles/filtering-bridges/_index.adoc35
-rw-r--r--documentation/content/pt-br/articles/fonts/_index.adoc29
-rw-r--r--documentation/content/pt-br/articles/freebsd-questions/_index.adoc37
-rw-r--r--documentation/content/pt-br/articles/freebsd-releng/_index.adoc28
-rw-r--r--documentation/content/pt-br/articles/freebsd-update-server/_index.adoc45
-rw-r--r--documentation/content/pt-br/articles/geom-class/_index.adoc37
-rw-r--r--documentation/content/pt-br/articles/gjournal-desktop/_index.adoc47
-rw-r--r--documentation/content/pt-br/articles/hubs/_index.adoc35
-rw-r--r--documentation/content/pt-br/articles/ipsec-must/_index.adoc35
-rw-r--r--documentation/content/pt-br/articles/ldap-auth/_index.adoc29
-rw-r--r--documentation/content/pt-br/articles/leap-seconds/_index.adoc34
-rw-r--r--documentation/content/pt-br/articles/leap-seconds/_index.po2
-rw-r--r--documentation/content/pt-br/articles/linux-emulation/_index.adoc29
-rw-r--r--documentation/content/pt-br/articles/linux-users/_index.adoc55
-rw-r--r--documentation/content/pt-br/articles/mailing-list-faq/_index.adoc39
-rw-r--r--documentation/content/pt-br/articles/nanobsd/_index.adoc29
-rw-r--r--documentation/content/pt-br/articles/new-users/_index.adoc29
-rw-r--r--documentation/content/pt-br/articles/pam/_index.adoc66
-rw-r--r--documentation/content/pt-br/articles/pgpkeys/_index.adoc34
-rw-r--r--documentation/content/pt-br/articles/port-mentor-guidelines/_index.adoc35
-rw-r--r--documentation/content/pt-br/articles/pr-guidelines/_index.adoc35
-rw-r--r--documentation/content/pt-br/articles/problem-reports/_index.adoc29
-rw-r--r--documentation/content/pt-br/articles/rc-scripting/_index.adoc35
-rw-r--r--documentation/content/pt-br/articles/releng/_index.adoc50
-rw-r--r--documentation/content/pt-br/articles/remote-install/_index.adoc35
-rw-r--r--documentation/content/pt-br/articles/serial-uart/_index.adoc35
-rw-r--r--documentation/content/pt-br/articles/solid-state/_index.adoc29
-rw-r--r--documentation/content/pt-br/articles/vinum/_index.adoc51
-rw-r--r--documentation/content/pt-br/articles/vm-design/_index.adoc33
-rw-r--r--documentation/content/pt-br/books/dev-model/_index.adoc69
-rw-r--r--documentation/content/pt-br/books/faq/_index.adoc178
-rw-r--r--documentation/content/pt-br/books/fdp-primer/_index.adoc35
-rw-r--r--documentation/content/pt-br/books/fdp-primer/asciidoctor-primer/_index.adoc37
-rw-r--r--documentation/content/pt-br/books/fdp-primer/book.adoc76
-rw-r--r--documentation/content/pt-br/books/fdp-primer/doc-build/_index.adoc31
-rw-r--r--documentation/content/pt-br/books/fdp-primer/editor-config/_index.adoc31
-rw-r--r--documentation/content/pt-br/books/fdp-primer/examples/_index.adoc32
-rw-r--r--documentation/content/pt-br/books/fdp-primer/manual-pages/_index.adoc33
-rw-r--r--documentation/content/pt-br/books/fdp-primer/overview/_index.adoc31
-rw-r--r--documentation/content/pt-br/books/fdp-primer/po-translations/_index.adoc41
-rw-r--r--documentation/content/pt-br/books/fdp-primer/preface/_index.adoc29
-rw-r--r--documentation/content/pt-br/books/fdp-primer/rosetta/_index.adoc32
-rw-r--r--documentation/content/pt-br/books/fdp-primer/see-also/_index.adoc33
-rw-r--r--documentation/content/pt-br/books/fdp-primer/see-also/_index.po4
-rw-r--r--documentation/content/pt-br/books/fdp-primer/structure/_index.adoc32
-rw-r--r--documentation/content/pt-br/books/fdp-primer/tools/_index.adoc30
-rw-r--r--documentation/content/pt-br/books/fdp-primer/translations/_index.adoc36
-rw-r--r--documentation/content/pt-br/books/fdp-primer/working-copy/_index.adoc30
-rw-r--r--documentation/content/pt-br/books/fdp-primer/writing-style/_index.adoc33
-rw-r--r--documentation/content/pt-br/books/handbook/_index.adoc40
-rw-r--r--documentation/content/pt-br/books/handbook/advanced-networking/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/audit/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/basics/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/bibliography/_index.adoc38
-rw-r--r--documentation/content/pt-br/books/handbook/book.adoc130
-rw-r--r--documentation/content/pt-br/books/handbook/boot/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/bsdinstall/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/config/_index.adoc46
-rw-r--r--documentation/content/pt-br/books/handbook/cutting-edge/_index.adoc46
-rw-r--r--documentation/content/pt-br/books/handbook/desktop/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/disks/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/dtrace/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/eresources/_index.adoc43
-rw-r--r--documentation/content/pt-br/books/handbook/filesystems/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/firewalls/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/geom/_index.adoc46
-rw-r--r--documentation/content/pt-br/books/handbook/introduction/_index.adoc48
-rw-r--r--documentation/content/pt-br/books/handbook/jails/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/kernelconfig/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/l10n/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/linuxemu/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/mac/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/mail/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/mirrors/_index.adoc39
-rw-r--r--documentation/content/pt-br/books/handbook/multimedia/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/network-servers/_index.adoc46
-rw-r--r--documentation/content/pt-br/books/handbook/parti.adoc10
-rw-r--r--documentation/content/pt-br/books/handbook/partii.adoc10
-rw-r--r--documentation/content/pt-br/books/handbook/partiii.adoc10
-rw-r--r--documentation/content/pt-br/books/handbook/partiv.adoc10
-rw-r--r--documentation/content/pt-br/books/handbook/partv.adoc10
-rw-r--r--documentation/content/pt-br/books/handbook/pgpkeys/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/ports/_index.adoc54
-rw-r--r--documentation/content/pt-br/books/handbook/ppp-and-slip/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/preface/_index.adoc33
-rw-r--r--documentation/content/pt-br/books/handbook/printing/_index.adoc46
-rw-r--r--documentation/content/pt-br/books/handbook/security/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/serialcomms/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/usb-device-mode/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/virtualization/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/handbook/x11/_index.adoc46
-rw-r--r--documentation/content/pt-br/books/handbook/zfs/_index.adoc44
-rw-r--r--documentation/content/pt-br/books/porters-handbook/_index.adoc82
-rw-r--r--documentation/content/pt-br/books/porters-handbook/flavors/chapter.adoc36
-rw-r--r--documentation/content/pt-br/books/porters-handbook/keeping-up/chapter.adoc36
-rw-r--r--documentation/content/pt-br/books/porters-handbook/makefiles/chapter.adoc45
-rw-r--r--documentation/content/pt-br/books/porters-handbook/new-port/chapter.adoc36
-rw-r--r--documentation/content/pt-br/books/porters-handbook/order/chapter.adoc36
-rw-r--r--documentation/content/pt-br/books/porters-handbook/pkg-files/chapter.adoc36
-rw-r--r--documentation/content/pt-br/books/porters-handbook/plist/chapter.adoc36
-rw-r--r--documentation/content/pt-br/books/porters-handbook/porting-dads/chapter.adoc40
-rw-r--r--documentation/content/pt-br/books/porters-handbook/porting-samplem/chapter.adoc36
-rw-r--r--documentation/content/pt-br/books/porters-handbook/porting-why/chapter.adoc36
-rw-r--r--documentation/content/pt-br/books/porters-handbook/quick-porting/chapter.adoc38
-rw-r--r--documentation/content/pt-br/books/porters-handbook/security/chapter.adoc36
-rw-r--r--documentation/content/pt-br/books/porters-handbook/slow-porting/chapter.adoc36
-rw-r--r--documentation/content/pt-br/books/porters-handbook/special/chapter.adoc38
-rw-r--r--documentation/content/pt-br/books/porters-handbook/testing/chapter.adoc38
-rw-r--r--documentation/content/pt-br/books/porters-handbook/upgrading/chapter.adoc46
-rw-r--r--documentation/content/pt-br/books/porters-handbook/uses/chapter.adoc36
-rw-r--r--documentation/content/pt-br/books/porters-handbook/versions/chapter.adoc36
-rw-r--r--documentation/content/ru/articles/committers-guide/_index.adoc52
-rw-r--r--documentation/content/ru/articles/contributing/_index.adoc46
-rw-r--r--documentation/content/ru/articles/cups/_index.adoc29
-rw-r--r--documentation/content/ru/articles/explaining-bsd/_index.adoc29
-rw-r--r--documentation/content/ru/articles/fonts/_index.adoc29
-rw-r--r--documentation/content/ru/articles/freebsd-questions/_index.adoc40
-rw-r--r--documentation/content/ru/articles/geom-class/_index.adoc37
-rw-r--r--documentation/content/ru/articles/gjournal-desktop/_index.adoc43
-rw-r--r--documentation/content/ru/articles/hubs/_index.adoc39
-rw-r--r--documentation/content/ru/articles/ipsec-must/_index.adoc35
-rw-r--r--documentation/content/ru/articles/mailing-list-faq/_index.adoc43
-rw-r--r--documentation/content/ru/articles/new-users/_index.adoc29
-rw-r--r--documentation/content/ru/articles/pam/_index.adoc76
-rw-r--r--documentation/content/ru/articles/pr-guidelines/_index.adoc38
-rw-r--r--documentation/content/ru/articles/problem-reports/_index.adoc51
-rw-r--r--documentation/content/ru/articles/releng/_index.adoc53
-rw-r--r--documentation/content/ru/articles/solid-state/_index.adoc29
-rw-r--r--documentation/content/ru/articles/vm-design/_index.adoc33
-rw-r--r--documentation/content/ru/books/arch-handbook/book.adoc48
-rw-r--r--documentation/content/ru/books/arch-handbook/driverbasics/chapter.adoc35
-rw-r--r--documentation/content/ru/books/arch-handbook/locking/chapter.adoc35
-rw-r--r--documentation/content/ru/books/arch-handbook/sound/chapter.adoc35
-rw-r--r--documentation/content/ru/books/design-44bsd/_index.adoc53
-rw-r--r--documentation/content/ru/books/developers-handbook/_index.adoc52
-rw-r--r--documentation/content/ru/books/developers-handbook/introduction/chapter.adoc36
-rw-r--r--documentation/content/ru/books/developers-handbook/kerneldebug/chapter.adoc38
-rw-r--r--documentation/content/ru/books/developers-handbook/policies/chapter.adoc44
-rw-r--r--documentation/content/ru/books/developers-handbook/secure/chapter.adoc36
-rw-r--r--documentation/content/ru/books/faq/_index.adoc204
-rw-r--r--documentation/content/ru/books/handbook/_index.adoc40
-rw-r--r--documentation/content/ru/books/handbook/advanced-networking/_index.adoc46
-rw-r--r--documentation/content/ru/books/handbook/audit/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/basics/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/bibliography/_index.adoc40
-rw-r--r--documentation/content/ru/books/handbook/book.adoc122
-rw-r--r--documentation/content/ru/books/handbook/boot/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/bsdinstall/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/config/_index.adoc46
-rw-r--r--documentation/content/ru/books/handbook/cutting-edge/_index.adoc46
-rw-r--r--documentation/content/ru/books/handbook/desktop/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/disks/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/eresources/_index.adoc43
-rw-r--r--documentation/content/ru/books/handbook/filesystems/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/firewalls/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/geom/_index.adoc46
-rw-r--r--documentation/content/ru/books/handbook/install/_index.adoc48
-rw-r--r--documentation/content/ru/books/handbook/introduction/_index.adoc42
-rw-r--r--documentation/content/ru/books/handbook/kernelconfig/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/l10n/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/linuxemu/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/mac/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/mail/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/mirrors/_index.adoc39
-rw-r--r--documentation/content/ru/books/handbook/multimedia/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/network-servers/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/parti.adoc10
-rw-r--r--documentation/content/ru/books/handbook/partii.adoc10
-rw-r--r--documentation/content/ru/books/handbook/partiii.adoc10
-rw-r--r--documentation/content/ru/books/handbook/partiv.adoc10
-rw-r--r--documentation/content/ru/books/handbook/partv.adoc10
-rw-r--r--documentation/content/ru/books/handbook/pgpkeys/_index.adoc42
-rw-r--r--documentation/content/ru/books/handbook/ports/_index.adoc56
-rw-r--r--documentation/content/ru/books/handbook/ppp-and-slip/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/preface/_index.adoc34
-rw-r--r--documentation/content/ru/books/handbook/printing/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/security/_index.adoc44
-rw-r--r--documentation/content/ru/books/handbook/serialcomms/_index.adoc46
-rw-r--r--documentation/content/ru/books/handbook/x11/_index.adoc44
-rw-r--r--documentation/content/ru/books/porters-handbook/_index.adoc83
-rw-r--r--documentation/content/ru/books/porters-handbook/keeping-up/chapter.adoc36
-rw-r--r--documentation/content/ru/books/porters-handbook/makefiles/chapter.adoc42
-rw-r--r--documentation/content/ru/books/porters-handbook/new-port/chapter.adoc36
-rw-r--r--documentation/content/ru/books/porters-handbook/pkg-files/chapter.adoc36
-rw-r--r--documentation/content/ru/books/porters-handbook/plist/chapter.adoc36
-rw-r--r--documentation/content/ru/books/porters-handbook/porting-dads/chapter.adoc40
-rw-r--r--documentation/content/ru/books/porters-handbook/porting-samplem/chapter.adoc36
-rw-r--r--documentation/content/ru/books/porters-handbook/porting-why/chapter.adoc36
-rw-r--r--documentation/content/ru/books/porters-handbook/quick-porting/chapter.adoc40
-rw-r--r--documentation/content/ru/books/porters-handbook/security/chapter.adoc36
-rw-r--r--documentation/content/ru/books/porters-handbook/slow-porting/chapter.adoc36
-rw-r--r--documentation/content/ru/books/porters-handbook/special/chapter.adoc38
-rw-r--r--documentation/content/ru/books/porters-handbook/testing/chapter.adoc36
-rw-r--r--documentation/content/ru/books/porters-handbook/upgrading/chapter.adoc44
-rw-r--r--documentation/content/ru/books/porters-handbook/uses/chapter.adoc36
-rw-r--r--documentation/content/ru/books/porters-handbook/versions/chapter.adoc36
-rw-r--r--documentation/content/tr/articles/explaining-bsd/_index.adoc22
-rw-r--r--documentation/content/zh-cn/articles/contributing/_index.adoc47
-rw-r--r--documentation/content/zh-cn/articles/leap-seconds/_index.adoc34
-rw-r--r--documentation/content/zh-cn/articles/linux-users/_index.adoc54
-rw-r--r--documentation/content/zh-cn/articles/nanobsd/_index.adoc30
-rw-r--r--documentation/content/zh-cn/articles/rc-scripting/_index.adoc34
-rw-r--r--documentation/content/zh-cn/articles/remote-install/_index.adoc35
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/_index.adoc86
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/bibliography/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/boot/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/driverbasics/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/isa/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/jail/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/kobj/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/locking/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/mac/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/newbus/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/pccard/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/pci/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/scsi/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/smp/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/sound/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/sysinit/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/usb/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/arch-handbook/vm/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/handbook/_index.adoc46
-rw-r--r--documentation/content/zh-cn/books/handbook/advanced-networking/_index.adoc46
-rw-r--r--documentation/content/zh-cn/books/handbook/audit/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/basics/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/bibliography/_index.adoc40
-rw-r--r--documentation/content/zh-cn/books/handbook/book.adoc131
-rw-r--r--documentation/content/zh-cn/books/handbook/boot/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/bsdinstall/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/config/_index.adoc48
-rw-r--r--documentation/content/zh-cn/books/handbook/cutting-edge/_index.adoc46
-rw-r--r--documentation/content/zh-cn/books/handbook/desktop/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/disks/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/dtrace/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/eresources/_index.adoc43
-rw-r--r--documentation/content/zh-cn/books/handbook/filesystems/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/firewalls/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/geom/_index.adoc46
-rw-r--r--documentation/content/zh-cn/books/handbook/install/_index.adoc48
-rw-r--r--documentation/content/zh-cn/books/handbook/introduction/_index.adoc42
-rw-r--r--documentation/content/zh-cn/books/handbook/jails/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/kernelconfig/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/l10n/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/linuxemu/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/mac/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/mail/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/mirrors/_index.adoc43
-rw-r--r--documentation/content/zh-cn/books/handbook/multimedia/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/network-servers/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/parti.adoc10
-rw-r--r--documentation/content/zh-cn/books/handbook/partii.adoc10
-rw-r--r--documentation/content/zh-cn/books/handbook/partiii.adoc10
-rw-r--r--documentation/content/zh-cn/books/handbook/partiv.adoc10
-rw-r--r--documentation/content/zh-cn/books/handbook/partv.adoc10
-rw-r--r--documentation/content/zh-cn/books/handbook/pgpkeys/_index.adoc42
-rw-r--r--documentation/content/zh-cn/books/handbook/ports/_index.adoc52
-rw-r--r--documentation/content/zh-cn/books/handbook/ppp-and-slip/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/preface/_index.adoc34
-rw-r--r--documentation/content/zh-cn/books/handbook/printing/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/security/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/serialcomms/_index.adoc46
-rw-r--r--documentation/content/zh-cn/books/handbook/users/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/vinum/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/virtualization/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/handbook/x11/_index.adoc44
-rw-r--r--documentation/content/zh-cn/books/porters-handbook/_index.adoc76
-rw-r--r--documentation/content/zh-cn/books/porters-handbook/keeping-up/chapter.adoc36
-rw-r--r--documentation/content/zh-cn/books/porters-handbook/makefile/chapter.adoc40
-rw-r--r--documentation/content/zh-cn/books/porters-handbook/own-port/chapter.adoc36
-rw-r--r--documentation/content/zh-cn/books/porters-handbook/pkg-files/chapter.adoc36
-rw-r--r--documentation/content/zh-cn/books/porters-handbook/plist/chapter.adoc36
-rw-r--r--documentation/content/zh-cn/books/porters-handbook/port-upgrading/chapter.adoc44
-rw-r--r--documentation/content/zh-cn/books/porters-handbook/porting-dads/chapter.adoc40
-rw-r--r--documentation/content/zh-cn/books/porters-handbook/porting-samplem/chapter.adoc36
-rw-r--r--documentation/content/zh-cn/books/porters-handbook/quick-porting/chapter.adoc40
-rw-r--r--documentation/content/zh-cn/books/porters-handbook/security/chapter.adoc36
-rw-r--r--documentation/content/zh-cn/books/porters-handbook/slow/chapter.adoc36
-rw-r--r--documentation/content/zh-cn/books/porters-handbook/special/chapter.adoc38
-rw-r--r--documentation/content/zh-cn/books/porters-handbook/testing/chapter.adoc36
-rw-r--r--documentation/content/zh-cn/books/porters-handbook/why-port/chapter.adoc36
-rw-r--r--documentation/content/zh-tw/articles/contributing/_index.adoc48
-rw-r--r--documentation/content/zh-tw/articles/freebsd-questions/_index.adoc38
-rw-r--r--documentation/content/zh-tw/articles/hubs/_index.adoc35
-rw-r--r--documentation/content/zh-tw/articles/leap-seconds/_index.adoc35
-rw-r--r--documentation/content/zh-tw/articles/mailing-list-faq/_index.adoc43
-rw-r--r--documentation/content/zh-tw/articles/nanobsd/_index.adoc31
-rw-r--r--documentation/content/zh-tw/articles/pr-guidelines/_index.adoc38
-rw-r--r--documentation/content/zh-tw/articles/problem-reports/_index.adoc51
-rw-r--r--documentation/content/zh-tw/articles/remote-install/_index.adoc36
-rw-r--r--documentation/content/zh-tw/books/developers-handbook/_index.adoc78
-rw-r--r--documentation/content/zh-tw/books/developers-handbook/bibliography/chapter.adoc35
-rw-r--r--documentation/content/zh-tw/books/developers-handbook/introduction/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/developers-handbook/ipv6/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/developers-handbook/kernelbuild/chapter.adoc42
-rw-r--r--documentation/content/zh-tw/books/developers-handbook/kerneldebug/chapter.adoc40
-rw-r--r--documentation/content/zh-tw/books/developers-handbook/l10n/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/developers-handbook/policies/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/developers-handbook/secure/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/developers-handbook/sockets/chapter.adoc39
-rw-r--r--documentation/content/zh-tw/books/developers-handbook/testing/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/developers-handbook/tools/chapter.adoc43
-rw-r--r--documentation/content/zh-tw/books/developers-handbook/x86/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/faq/_index.adoc200
-rw-r--r--documentation/content/zh-tw/books/handbook/_index.adoc40
-rw-r--r--documentation/content/zh-tw/books/handbook/advanced-networking/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/audit/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/basics/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/bibliography/_index.adoc38
-rw-r--r--documentation/content/zh-tw/books/handbook/book.adoc128
-rw-r--r--documentation/content/zh-tw/books/handbook/boot/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/bsdinstall/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/config/_index.adoc46
-rw-r--r--documentation/content/zh-tw/books/handbook/cutting-edge/_index.adoc46
-rw-r--r--documentation/content/zh-tw/books/handbook/desktop/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/disks/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/dtrace/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/eresources/_index.adoc39
-rw-r--r--documentation/content/zh-tw/books/handbook/filesystems/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/firewalls/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/geom/_index.adoc46
-rw-r--r--documentation/content/zh-tw/books/handbook/introduction/_index.adoc48
-rw-r--r--documentation/content/zh-tw/books/handbook/jails/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/kernelconfig/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/l10n/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/linuxemu/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/mac/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/mail/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/mirrors/_index.adoc39
-rw-r--r--documentation/content/zh-tw/books/handbook/multimedia/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/network-servers/_index.adoc46
-rw-r--r--documentation/content/zh-tw/books/handbook/parti.adoc10
-rw-r--r--documentation/content/zh-tw/books/handbook/partii.adoc10
-rw-r--r--documentation/content/zh-tw/books/handbook/partiii.adoc10
-rw-r--r--documentation/content/zh-tw/books/handbook/partiv.adoc10
-rw-r--r--documentation/content/zh-tw/books/handbook/partv.adoc10
-rw-r--r--documentation/content/zh-tw/books/handbook/pgpkeys/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/ports/_index.adoc54
-rw-r--r--documentation/content/zh-tw/books/handbook/ppp-and-slip/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/preface/_index.adoc33
-rw-r--r--documentation/content/zh-tw/books/handbook/printing/_index.adoc46
-rw-r--r--documentation/content/zh-tw/books/handbook/security/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/serialcomms/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/usb-device-mode/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/virtualization/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/handbook/x11/_index.adoc46
-rw-r--r--documentation/content/zh-tw/books/handbook/zfs/_index.adoc44
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/_index.adoc84
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/flavors/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/keeping-up/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/makefiles/chapter.adoc46
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/new-port/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/order/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/pkg-files/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/plist/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/porting-dads/chapter.adoc42
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/porting-samplem/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/porting-why/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/quick-porting/chapter.adoc40
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/security/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/slow-porting/chapter.adoc38
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/special/chapter.adoc40
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/testing/chapter.adoc40
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/upgrading/chapter.adoc48
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/uses/chapter.adoc39
-rw-r--r--documentation/content/zh-tw/books/porters-handbook/versions/chapter.adoc38
1113 files changed, 31947 insertions, 20557 deletions
diff --git a/documentation/content/bn-bd/articles/explaining-bsd/_index.adoc b/documentation/content/bn-bd/articles/explaining-bsd/_index.adoc
index 0534c72474..a783465049 100644
--- a/documentation/content/bn-bd/articles/explaining-bsd/_index.adoc
+++ b/documentation/content/bn-bd/articles/explaining-bsd/_index.adoc
@@ -3,7 +3,6 @@ title: BSD কি, কেন, কার জন্য
authors:
- author: গ্রেগ লেহেই
email: grog@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sparc", "sun", "unix", "general"]
---
@@ -16,6 +15,27 @@ trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sparc",
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/explaining-bsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Abstract
diff --git a/documentation/content/bn-bd/articles/new-users/_index.adoc b/documentation/content/bn-bd/articles/new-users/_index.adoc
index ee6444aaff..1a71760815 100644
--- a/documentation/content/bn-bd/articles/new-users/_index.adoc
+++ b/documentation/content/bn-bd/articles/new-users/_index.adoc
@@ -3,7 +3,6 @@ title: ইউনিক্স ও FreeBSD'র হাতেখড়ি
authors:
- author: অ্যানেলিস এন্ডারসন
email: andrsn@andrsn.stanford.edu
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"]
---
@@ -16,6 +15,27 @@ trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/new-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Abstract
diff --git a/documentation/content/da/articles/ipsec-must/_index.adoc b/documentation/content/da/articles/ipsec-must/_index.adoc
index 19ea3c41b1..7c2cd106ed 100644
--- a/documentation/content/da/articles/ipsec-must/_index.adoc
+++ b/documentation/content/da/articles/ipsec-must/_index.adoc
@@ -3,7 +3,6 @@ title: Uafhængig Verifikation af IPsec Funktionalitet i FreeBSD
authors:
- author: David Honig
email: honig@sprynet.com
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "opengroup", "general"]
---
@@ -16,10 +15,27 @@ trademarks: ["freebsd", "opengroup", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Indholdsfortegnelse
-:table-caption: Tabel
-:figure-caption: Figur
-:example-caption: Eksempel
+:images-path: articles/ipsec-must/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumé
@@ -111,7 +127,7 @@ Internet Protokol sikkerheds udvidelser til IPv4; krævet for IPv6. En protokol
De fleste af de moderne versioner af FreeBSD har IPsec support i deres base kildekode. Så du er sikkert nødt til at inkludere `IPSEC` optionen i din kernel konfig og, efter genbygning og reinstallation af kernel, konfigurere IPsec forbindelser ved hjælp af man:setkey[8] kommandoen.
-En udførlig guide om at køre IPsec på FreeBSD er tilrådighed i link:{handbook}#ipsec[FreeBSD Håndbogen].
+En udførlig guide om at køre IPsec på FreeBSD er tilrådighed i extref:{handbook}security/[FreeBSD Håndbogen, ipsec].
[[kernel]]
== src/sys/i386/conf/KERNELNAME
diff --git a/documentation/content/de/articles/contributing/_index.adoc b/documentation/content/de/articles/contributing/_index.adoc
index 7fc45f3cd8..725ee69a5c 100644
--- a/documentation/content/de/articles/contributing/_index.adoc
+++ b/documentation/content/de/articles/contributing/_index.adoc
@@ -2,7 +2,6 @@
title: FreeBSD unterstützen
authors:
- author: Jordan Hubbard
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ieee", "general"]
---
@@ -15,24 +14,26 @@ trademarks: ["freebsd", "ieee", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-
-ifeval::["{backend}" == "html5"]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/urls.adoc[]
+:images-path: articles/contributing/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/de/urls.adoc[]
-include::../../../../shared/de/mailing-lists.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/de/urls.adoc[]
-include::../../../../shared/de/mailing-lists.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -65,7 +66,7 @@ Die folgende Liste von Aufgaben und Unterprojekten repräsentiert eine Zusammenf
Viele Menschen, die an FreeBSD beteiligt sind, sind keine Programmierer. Es sind Leute, die an der Dokumentation arbeiten, Internetseiten erstellen oder einfach Hilfe anbieten. Alles, was diese Leute mitbringen müssen, sind Zeit und die Bereitschaft, etwas zu lernen.
. Lesen Sie die häufig gestellten Fragen (FAQ) und das Handbuch gelegentlich. Wenn etwas schlecht erklärt wird, veraltet oder einfach falsch ist, teilen Sie es uns mit. Oder noch besser, korrigieren Sie es (SGML ist nicht schwer zu erlernen, wir akzeptieren aber auch Vorschläge im ASCII-Format.).
-. Helfen Sie dabei, die Dokumentation in Ihre Muttersprache zu übersetzen. Wenn an der Übersetzung in Ihre Sprache bereits gearbeitet wird, helfen Sie, indem Sie weitere Dokumente übersetzen, oder sorgen Sie dafür, dass die Übersetzungen aktuell sind. Lesen Sie zuerst die link:{fdp-primer}#translations[Übersetzungs-FAQ] der Fibel für neue Mitarbeiter des FreeBSD-Dokumentations-Projekts. Sie verpflichten sich dabei nicht dazu, jede einzelne Seite zu übersetzen - als Freiwilliger übersetzen Sie genau so viel, wie Sie wollen. Wenn jemand mit der Übersetzung beginnt, beteiligen sich fast immer auch andere Personen daran. Wenn Sie nur Zeit und Energie für einen Teil der Dokumentation haben, dann übersetzen Sie bitte die Installationsanleitung.
+. Helfen Sie dabei, die Dokumentation in Ihre Muttersprache zu übersetzen. Wenn an der Übersetzung in Ihre Sprache bereits gearbeitet wird, helfen Sie, indem Sie weitere Dokumente übersetzen, oder sorgen Sie dafür, dass die Übersetzungen aktuell sind. Lesen Sie zuerst die extref:{fdp-primer}[Übersetzungs-FAQ, translations] der Fibel für neue Mitarbeiter des FreeBSD-Dokumentations-Projekts. Sie verpflichten sich dabei nicht dazu, jede einzelne Seite zu übersetzen - als Freiwilliger übersetzen Sie genau so viel, wie Sie wollen. Wenn jemand mit der Übersetzung beginnt, beteiligen sich fast immer auch andere Personen daran. Wenn Sie nur Zeit und Energie für einen Teil der Dokumentation haben, dann übersetzen Sie bitte die Installationsanleitung.
. Lesen Sie {freebsd-questions} sowie die news:comp.unix.bsd.freebsd.misc gelegentlich (oder sogar regelmäßig). Es kann sehr befriedigend sein, wenn Sie Ihr Wissen teilen und anderen Leuten dabei helfen können, deren Probleme zu lösen; vielleicht lernen Sie sogar noch etwas Neues! Diese Foren können auch eine Quelle für Ideen sein, an denen man arbeiten könnte.
[[ongoing-programmer-tasks]]
@@ -102,7 +103,7 @@ Mögliche Beiträge lassen sich in fünf Kategorien einteilen:
[[contrib-general]]
=== Fehlerberichte und allgemeine Vorschläge
-Eine Idee oder ein Vorschlag von _allgemeinem_ technischen Interesse sollte an {freebsd-hackers} geschickt werden. Personen, die an solchen Fragen interessiert sind (und kein Problem mit einem _hohen_ Mailaufkommen haben!) können die Mailingliste {freebsd-hackers} auch abonnieren. Informationen zu dieser und anderen Mailinglisten finden Sie im link:{handbook}#eresources-mail[FreeBSD Handbuch].
+Eine Idee oder ein Vorschlag von _allgemeinem_ technischen Interesse sollte an {freebsd-hackers} geschickt werden. Personen, die an solchen Fragen interessiert sind (und kein Problem mit einem _hohen_ Mailaufkommen haben!) können die Mailingliste {freebsd-hackers} auch abonnieren. Informationen zu dieser und anderen Mailinglisten finden Sie im extref:{handbook}eresources/[FreeBSD Handbuch, eresources-mail].
Wenn Sie einen Fehler gefunden oder eine Verbesserung entwickelt haben, vergessen Sie nicht, einen Bericht über man:send-pr[1] oder dessen link:https://www.FreeBSD.org/de/send-pr/[Internetschnittstelle] zu erstellen. Versuchen Sie bitte, jedes Feld auszufüllen. Ist Ihr Patch kleiner als 65 KB, sollten Sie ihn direkt in den Bericht einbauen. Kann der Patch direkt auf den Quellcodebaum angewendet werden, fügen Sie `[PATCH]` im Synopsis-Feld ein. Wenn Sie einen Patch einfügen, verwenden Sie bitte __kein copy-and-paste__, weil dadurch Tabulatoren in Leerzeichen umgewandelt werden, was den Patch unbrauchbar macht. Sind die Patches viel größer als 20 KB, sollten Sie sie komprimieren (z.B. mit man:gzip[1] oder man:bzip2[1]) und man:uuencode[1] verwenden, um diese in ihren Problembericht einzufügen.
@@ -110,15 +111,15 @@ Nachdem Sie einen Bericht versandt haben, erhalten Sie eine E-Mail, die eine Bes
Sollten Sie innerhalb einer Woche keine Bestätigung erhalten, oder man:send-pr[1] nicht verwenden können, können Sie über {freebsd-bugs} jemanden bitten, dies für Sie zu erledigen.
-Weitere Informationen zum Verfassen von guten Problemberichten finden Sie im entsprechenden link:{problem-reports}[Artikel].
+Weitere Informationen zum Verfassen von guten Problemberichten finden Sie im entsprechenden extref:{problem-reports}[Artikel].
=== Änderungen der Dokumentation
-Änderungen der Dokumentation werden vom {freebsd-doc} überwacht. Lesen Sie bitte die link:{fdp-primer}[Fibel für neue Mitarbeiter des FreeBSD-Dokumentationsprojekts] für weitere Informationen. Korrekturen und Ergänzungen (selbst kleine Änderungen sind willkommen!) werden mit man:send-pr[1] übermittelt. Lesen Sie dazu den Abschnitt <<contrib-general>>.
+Änderungen der Dokumentation werden vom {freebsd-doc} überwacht. Lesen Sie bitte die extref:{fdp-primer}[Fibel für neue Mitarbeiter des FreeBSD-Dokumentationsprojekts] für weitere Informationen. Korrekturen und Ergänzungen (selbst kleine Änderungen sind willkommen!) werden mit man:send-pr[1] übermittelt. Lesen Sie dazu den Abschnitt <<contrib-general>>.
=== Änderungen am vorhandenen Quellcode
-Änderungen des existierenden Quellcodes sind etwas komplizierter. Entscheidend ist hier, wie vertraut Sie mit dem aktuellen Entwicklungsstand von FreeBSD sind. Es existiert eine spezielle, ständig aktualisierte Version von FreeBSD, die als "FreeBSD-CURRENT" bekannt ist. Diese ist auf verschiedenen Wegen erhältlich und stellt den aktuellen Stand der Entwicklung dar. Lesen Sie den Abschnitt link:{handbook}#current-stable[FreeBSD-CURRENT vs. FreeBSD-STABLE] des Handbuchs für weitere Informationen zur Installation und Verwendung von FreeBSD-CURRENT.
+Änderungen des existierenden Quellcodes sind etwas komplizierter. Entscheidend ist hier, wie vertraut Sie mit dem aktuellen Entwicklungsstand von FreeBSD sind. Es existiert eine spezielle, ständig aktualisierte Version von FreeBSD, die als "FreeBSD-CURRENT" bekannt ist. Diese ist auf verschiedenen Wegen erhältlich und stellt den aktuellen Stand der Entwicklung dar. Lesen Sie den Abschnitt extref:{handbook}updating-upgrading/[FreeBSD-CURRENT vs. FreeBSD-STABLE, current-stable] des Handbuchs für weitere Informationen zur Installation und Verwendung von FreeBSD-CURRENT.
Arbeiten Sie mit älteren Quellcodeversionen, kann dies leider bedeuten, das Ihre Änderungen obsolet sind, oder sich nicht mehr in FreeBSD reintegrieren lassen. Dieses Risiko lässt sich verringern, wenn Sie die Mailinglisten {freebsd-announce} und {freebsd-current} abonnieren, auf denen aktuelle Systemänderungen diskutiert werden.
@@ -243,4 +244,4 @@ Das FreeBSD-Projekt freut sich, wenn jemand benötigte Hardware spenden will. Si
==== Internetzugang zur Verfügung stellen
-Wir sind ständig auf der Suche nach neuen FTP-, WWW- oder `cvsup`-Spiegeln. Wenn Sie einen solchen Spiegel einrichten wollen, lesen Sie bitte den Artikel link:{hubs}[Mirroring FreeBSD], der weitere Informationen enthält.
+Wir sind ständig auf der Suche nach neuen FTP-, WWW- oder `cvsup`-Spiegeln. Wenn Sie einen solchen Spiegel einrichten wollen, lesen Sie bitte den Artikel extref:{hubs}[Mirroring FreeBSD], der weitere Informationen enthält.
diff --git a/documentation/content/de/articles/explaining-bsd/_index.adoc b/documentation/content/de/articles/explaining-bsd/_index.adoc
index 204f1364b4..7b7fc337ae 100644
--- a/documentation/content/de/articles/explaining-bsd/_index.adoc
+++ b/documentation/content/de/articles/explaining-bsd/_index.adoc
@@ -3,7 +3,6 @@ title: Hintergrundwissen zu BSD
authors:
- author: Greg Lehey
email: grog@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sparc", "sun", "unix", "general"]
---
@@ -16,10 +15,27 @@ trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sparc",
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: articles/explaining-bsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Zusammenfassung
diff --git a/documentation/content/de/articles/freebsd-update-server/_index.adoc b/documentation/content/de/articles/freebsd-update-server/_index.adoc
index 5b0b201a58..348c36d2c1 100644
--- a/documentation/content/de/articles/freebsd-update-server/_index.adoc
+++ b/documentation/content/de/articles/freebsd-update-server/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Jason Helfman
email: jgh@FreeBSD.org
copyright: 2009-2011, 2013 Jason Helfma
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "amd", "intel", "general"]
---
@@ -17,21 +16,26 @@ trademarks: ["freebsd", "amd", "intel", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: articles/freebsd-update-server/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -68,7 +72,7 @@ Als Minimum, muss das zu verteilende Ziel-Release auf einer gleichen, oder höhe
====
* Ein Benutzerkonto mit mindestens 4 GB freiem Speicherplatz. Dies erlaubt die Erstellung der Updates für 7.1 und 7.2. Der genaue Platzbedarf kann sich aber von Version zu Version ändern.
* Ein man:ssh[1] Konto auf einem entfernten System, um die später zu verteilenden Updates hochzuladen.
-* Einen Webserver, wie link:{handbook}#network-apache[Apache], wobei über die Hälfte des Platzes für den Bau benötigt wird. Als Beispiel benötigt der Bau von 7.1 und 7.2 insgesamt 4 GB. Der Speicherplatz, den der Webserver für die Verteilung dieser Updates benötigt, würde 2.6 GB betragen.
+* Einen Webserver, wie extref:{handbook}network-servers/[Apache, network-apache], wobei über die Hälfte des Platzes für den Bau benötigt wird. Als Beispiel benötigt der Bau von 7.1 und 7.2 insgesamt 4 GB. Der Speicherplatz, den der Webserver für die Verteilung dieser Updates benötigt, würde 2.6 GB betragen.
* Grundlegende Kenntnisse im Shell Skripting mit der Bourne Shell, man:sh[1].
[[Configuration]]
@@ -372,9 +376,9 @@ Wenn der Update-Code erneut hochgeladen werden muss, kann dies durch die Änderu
====
-Um die Updates zu verteilen, müssen die hochgeladenen Dateien im Document Root des Webservers liegen. Die genaue Konfiguration hängt von dem verwendeten Webserver ab. Für den Apache Webserver, beziehen Sie sich bitte auf das Kapitel link:{handbook}#network-apache[Konfiguration des Apache Servers] im Handbuch.
+Um die Updates zu verteilen, müssen die hochgeladenen Dateien im Document Root des Webservers liegen. Die genaue Konfiguration hängt von dem verwendeten Webserver ab. Für den Apache Webserver, beziehen Sie sich bitte auf das Kapitel extref:{handbook}network-servers/[Konfiguration des Apache Servers, network-apache] im Handbuch.
-Aktualisieren Sie `KeyPrint` und `ServerName` in der [.filename]#/etc/freebsd-update.conf# des Clients und führen Sie das Update, wie im Kapitel link:{handbook}#updating-upgrading-freebsdupdate[FreeBSD Update] des Handbuchs beschrieben, aus.
+Aktualisieren Sie `KeyPrint` und `ServerName` in der [.filename]#/etc/freebsd-update.conf# des Clients und führen Sie das Update, wie im Kapitel extref:{handbook}updating-upgrading/[FreeBSD Update, updating-upgrading-freebsdupdate] des Handbuchs beschrieben, aus.
[IMPORTANT]
====
@@ -404,7 +408,7 @@ Erstellen Sie das Korrekturverzeichnis des jeweiligen Releases unter [.filename]
% cd /usr/local/freebsd-update-server/patches/7.1-RELEASE
....
-Als Beispiel nehmen Sie die Korrektur für man:named[8]. Lesen Sie den Hinweis und laden Sie die erforderliche Datei von link:https://www.FreeBSD.org/security/advisories/[FreeBSD Sicherheits-Hinweise] herunter. Weitere Informationen zur Interpretation der Sicherheitshinweise finden Sie im link:{handbook}#security-advisories[FreeBSD Handbuch].
+Als Beispiel nehmen Sie die Korrektur für man:named[8]. Lesen Sie den Hinweis und laden Sie die erforderliche Datei von link:https://www.FreeBSD.org/security/advisories/[FreeBSD Sicherheits-Hinweise] herunter. Weitere Informationen zur Interpretation der Sicherheitshinweise finden Sie im extref:{handbook}security[FreeBSD Handbuch, security-advisories].
In der https://security.freebsd.org/advisories/FreeBSD-SA-09:12.bind.asc[Sicherheits Anweisung], nennt sich dieser Hinweis `SA-09:12.bind`. Nach dem Herunterladen der Datei, ist es erforderlich, die Datei auf einen geeigneten Patch-Level umzubenennen. Es steht Ihnen frei den Namen frei zu wählen, es wird jedoch nahegelegt, diesen im Einklang mit dem offiziellen FreeBSD Patch-Level zu halten. Für diesen Bau folgen wir der derzeit gängigen Praxis von FreeBSD und benennen sie `p7`. Benennen Sie die Datei um:
@@ -563,7 +567,7 @@ Als Referenz wird der gesamte Verlauf von link:../../../source/articles/freebsd-
[[tips]]
== Tipps
-* Wenn Sie ein selbst erstelltes Release über die native `make release` link:{releng}#release-build[Prozedur] bauen, wir der `freebsd-update-server` Code Ihr Release unterstützen. Als Beispiel können Sie ein Release ohne Ports oder Dokumentation bauen, indem Sie betreffende Funktionalität der Subroutinen `findextradocs ()`, `addextradocs ()` entfernen und eine Veränderung des Download-Verzeichnisses in `fetchiso ()`, in [.filename]#scripts/build.subr#. Als letzten Schritt ändern Sie den man:sha256[1] Hash in [.filename]#build.conf# für Ihr jeweiliges Release und Architektur damit Sie bereit sind, Ihr benutzerdefiniertes Release zu bauen.
+* Wenn Sie ein selbst erstelltes Release über die native `make release` extref:{releng}[Prozedur, release-build] bauen, wir der `freebsd-update-server` Code Ihr Release unterstützen. Als Beispiel können Sie ein Release ohne Ports oder Dokumentation bauen, indem Sie betreffende Funktionalität der Subroutinen `findextradocs ()`, `addextradocs ()` entfernen und eine Veränderung des Download-Verzeichnisses in `fetchiso ()`, in [.filename]#scripts/build.subr#. Als letzten Schritt ändern Sie den man:sha256[1] Hash in [.filename]#build.conf# für Ihr jeweiliges Release und Architektur damit Sie bereit sind, Ihr benutzerdefiniertes Release zu bauen.
+
[.programlisting]
....
@@ -592,7 +596,7 @@ addextradocs () {
make ${COMPATFLAGS} release.1 release.2 2>&1
....
-* Erstellen Sie einen geeigneten link:{handbook}#network-dns[DNS] SRV Datensatz für den Update-Server, und fügen Sie weitere Server mit verschiedenen Gewichtungen hinzu. Sie können diese Möglichkeit nutzen um Update-Mirror hinzuzufügen. Dieser Tipp ist jedoch nicht notwendig solange Sie keinen redundanten Service anbieten möchten.
+* Erstellen Sie einen geeigneten extref:{handbook}network-servers[DNS, network-dns] SRV Datensatz für den Update-Server, und fügen Sie weitere Server mit verschiedenen Gewichtungen hinzu. Sie können diese Möglichkeit nutzen um Update-Mirror hinzuzufügen. Dieser Tipp ist jedoch nicht notwendig solange Sie keinen redundanten Service anbieten möchten.
+
[.programlisting]
....
diff --git a/documentation/content/de/articles/leap-seconds/_index.adoc b/documentation/content/de/articles/leap-seconds/_index.adoc
index 990497a624..529c64a3d0 100644
--- a/documentation/content/de/articles/leap-seconds/_index.adoc
+++ b/documentation/content/de/articles/leap-seconds/_index.adoc
@@ -1,6 +1,5 @@
---
title: Unterstützung für Schaltsekunden in FreeBSD
-releaseinfo: "$FreeBSD$"
---
= Unterstützung für Schaltsekunden in FreeBSD
@@ -12,21 +11,26 @@ releaseinfo: "$FreeBSD$"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-
-ifeval::["{backend}" == "html5"]
-include::shared/de/urls.adoc[]
+:images-path: articles/leap-seconds/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/de/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/de/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -47,7 +51,7 @@ Das normale Verhalten für Schaltsekunden wird in https://tools.ietf.org/html/rf
[[leapseconds-posix]]
== Handhabung von gewöhnlichen Schaltsekunden in FreeBD
-Die einfachste Art, mit Schaltsekunden umzugehen, ist, die POSIX Zeitregeln, welche FreeBSD standardmässig verwendet, sowie link:{handbook}#network-ntp[NTP] zu benutzen. Wenn man:ntpd[8] läuft und die Uhrzeit mit einem vorgeschalteten NTP-Server, welcher Schaltsekunden richtig handhabt, abgeglichen wird, passt das System die Uhrzeit automatisch so an, dass die letzte Sekunde des Tages wiederholt wird. Es sind keine weiteren Anpassungen nötig.
+Die einfachste Art, mit Schaltsekunden umzugehen, ist, die POSIX Zeitregeln, welche FreeBSD standardmässig verwendet, sowie extref:{handbook}network-servers/[NTP, network-ntp] zu benutzen. Wenn man:ntpd[8] läuft und die Uhrzeit mit einem vorgeschalteten NTP-Server, welcher Schaltsekunden richtig handhabt, abgeglichen wird, passt das System die Uhrzeit automatisch so an, dass die letzte Sekunde des Tages wiederholt wird. Es sind keine weiteren Anpassungen nötig.
Sollte der vorgeschaltete NTP-Server Schaltsekunden nicht korrekt handhaben, wird man:ntpd[8] die Uhrzeit um eine Sekunde anpassen nachdem der fehlerhafte Server dies bemerkt hat und seine Uhr selbst neu einstellt.
diff --git a/documentation/content/de/articles/linux-users/_index.adoc b/documentation/content/de/articles/linux-users/_index.adoc
index 6960975bb5..c0212dc208 100644
--- a/documentation/content/de/articles/linux-users/_index.adoc
+++ b/documentation/content/de/articles/linux-users/_index.adoc
@@ -3,7 +3,6 @@ title: FreeBSD Anleitung für Linux®-Benutzer
authors:
- author: John Ferrell
copyright: 2008 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"]
---
@@ -16,21 +15,26 @@ trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-
-ifeval::["{backend}" == "html5"]
-include::shared/de/urls.adoc[]
+:images-path: articles/linux-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/de/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/de/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -47,14 +51,14 @@ toc::[]
Dieses Dokument beschreibt einige der technischen Unterschiede zwischen FreeBSD und Linux(R), damit sich Linux(R)-Anwender schnell mit den Grundlagen von FreeBSD vertraut machen können.
-Dieses Dokument geht davon aus, dass FreeBSD bereits installiert ist. Lesen Sie das Kapitel link:{handbook}#bsdinstall[Installation von FreeBSD] des FreeBSD-Handbuch für die Hilfe bei der Installation.
+Dieses Dokument geht davon aus, dass FreeBSD bereits installiert ist. Lesen Sie das Kapitel extref:{handbook}bsdinstall[Installation von FreeBSD, bsdinstall] des FreeBSD-Handbuch für die Hilfe bei der Installation.
[[shells]]
== Standard-Shell
Linux(R)-Benutzer sind oft überrascht, dass Bash nicht die Standard-Shell in FreeBSD ist. Genau genommen ist Bash nicht einmal in der Standardinstallation enthalten. FreeBSD benutzt stattdessen man:tcsh[1] als Standard-Shell für root, sowie die Bourne shell-kompatible man:sh[1] als Standardshell für Benutzer. man:sh[1] ist der Bash sehr ähnlich, besitzt jedoch einen kleineren Funktionsumfang. In der Regel werden Skripte für die man:sh[1] auch mit der Bash laufen. Der umgekehrte Fall trifft jedoch meistens nicht zu.
-Bash und weitere Shells können unter FreeBSD mit link:{handbook}#ports[Paketen und der Ports-Sammlung] installiert werden.
+Bash und weitere Shells können unter FreeBSD mit extref:{handbook}ports/[Paketen und der Ports-Sammlung, ports] installiert werden.
Nachdem Sie eine andere Shell installiert haben, benutzen Sie man:chsh[1] um die Standard-Shell für einen Benutzer zu ändern. Es wird empfohlen, die Standard-Shell des Benutzers `root` unverändert bleibt, da Shells, welche nicht im Basissystem enthalten sind, in [.filename]#/usr/local/bin# installiert werden. Im Falle eines Problems ist vielleicht das Dateisystem, auf dem sich [.filename]#/usr/local/bin# befindet, nicht eingehängt ist. In einem solchen Fall hätte der Benutzer `root` keinen Zugriff auf die Standard-Shell, was ihn daran hindern würde, sich am System anzumelden und das Problem zu beheben.
@@ -86,7 +90,7 @@ Pakete sind vorkompilierte Anwendungen, sozusagen FreeBSD-Äquivalente von [.fil
# pkg install apache24
....
-Weitere Informationen zu Paketen finden Sie im Abschnitt 4.4 des FreeBSD Handbuchs: link:{handbook}#pkgng-intro[Benutzen von pkg zur Verwaltung von Binärpaketen].
+Weitere Informationen zu Paketen finden Sie im Abschnitt 4.4 des FreeBSD Handbuchs: extref:{handbook}ports/[Benutzen von pkg zur Verwaltung von Binärpaketen, pkgng-intro].
[[ports]]
=== Ports
@@ -111,7 +115,7 @@ Ein Vorteil von Ports bei der Installation von Software ist die Möglichkeit, di
# make WITH_LDAP="YES" install clean
....
-Lesen Sie link:{handbook}#ports-using[Benutzen der Ports-Sammlung] für weitere Informationen.
+Lesen Sie extref:{handbook}ports/[Benutzen der Ports-Sammlung, ports-using] für weitere Informationen.
[[startup]]
== Systemstart
@@ -120,7 +124,7 @@ Viele Linux(R)-Distributionen verwenden das SysV init System, während FreeBSD d
Die Skripte in [.filename]#/etc/rc.d/# sind für Anwendungen aus dem "Basissystem", wie beispielsweise man:cron[8], man:sshd[8], und man:syslog[3]. Die Skripte in [.filename]#/usr/local/etc/rc.d/# gehören zu den vom Benutzer installierten Anwendungen, wie zum Beispiel Apache und Squid.
-Da FreeBSD als komplettes Betriebssystem entwickelt wird, werden die vom Benutzer installierten Anwendungen nicht als Teil des "Basissystems" angesehen. Diese Anwendungen werden in der Regel als link:{handbook}#ports-using[Pakete oder Ports] installiert. Um die Anwendungen vom Basissystem zu separieren, werden diese unterhalb von [.filename]#/usr/local/# installiert. Die Binärdateien der installierten Anwendungen werden in [.filename]#/usr/local/bin/# gespeichert, die Konfigurationsdateien in [.filename]#/usr/local/etc/#, und so weiter.
+Da FreeBSD als komplettes Betriebssystem entwickelt wird, werden die vom Benutzer installierten Anwendungen nicht als Teil des "Basissystems" angesehen. Diese Anwendungen werden in der Regel als extref:{handbook}ports/[Pakete oder Ports, ports-using] installiert. Um die Anwendungen vom Basissystem zu separieren, werden diese unterhalb von [.filename]#/usr/local/# installiert. Die Binärdateien der installierten Anwendungen werden in [.filename]#/usr/local/bin/# gespeichert, die Konfigurationsdateien in [.filename]#/usr/local/etc/#, und so weiter.
Dienste werden über einen Eintrag in [.filename]#/etc/rc.conf# aktiviert. Die Standardeinstellungen des Systems stehen in [.filename]#/etc/defaults/rc.conf# und werden von den Einstellungen in [.filename]#/etc/rc.conf# überschrieben. Lesen Sie man:rc.conf[5] für weitere Informationen über die verfügbaren Einträge. Wenn Sie zusätzliche Anwendungen installieren, lesen Sie die Nachrichten um zu erfahren, wie Sie alle dazugehörigen Dienste aktivieren.
@@ -195,9 +199,9 @@ ifconfig_em0="DHCP"
FreeBSD verwendet nicht Linux(R)IPTABLES als Firewall. Stattdessen hat der Benutzer unter FreeBSD die Wahl zwischen drei Firewalls, die auf Kernel-Ebene arbeiten:
-* link:{handbook}#firewalls-pf[PF]
-* link:{handbook}#firewalls-ipf[IPFILTER]
-* link:{handbook}#firewalls-ipfw[IPFW]
+* extref:{handbook}firewalls/[PF, firewalls-pf]
+* extref:{handbook}firewalls/[IPFILTER, firewalls-ipf]
+* extref:{handbook}firewalls/[IPFW, firewalls-ipfw]
PF wurde vom OpenBSD Projekt entwickelt und nach FreeBSD portiert. PF wurde als Ersatz für IPFILTER entwickelt und die Syntax ist der von IPFILTER sehr ähnlich. PF kann zusammen mit man:altq[4] werden um QoS-Funktionen bereitzustellen.
@@ -246,7 +250,7 @@ Wenn Sie man:cron[8] verwenden um Updates zu planen, benutzen Sie `freebsd-updat
====
-Weitere Informationen über die Aktualisierung aus den Quellen und Binär-Updates finden Sie im Kapitel link:{handbook}#updating-upgrading[FreeBSD aktualisieren] des FreeBSD Handbuchs.
+Weitere Informationen über die Aktualisierung aus den Quellen und Binär-Updates finden Sie im Kapitel extref:{handbook}updating-upgrading/[FreeBSD aktualisieren, updating-upgrading] des FreeBSD Handbuchs.
[[procfs]]
== procfs: Verschwunden, aber nicht vergessen
@@ -328,4 +332,4 @@ Einige Kommando-Äquivalente sind wie folgt:
[[conclusion]]
== Fazit
-Dieses Dokument hat einen Überblick über FreeBSD geboten. Lesen Sie das link:{handbook}[FreeBSD Handbuch] für eine tiefergehender Abdeckung dieses und weiterer Themen, welche nicht in diesem Dokument behandelt sind.
+Dieses Dokument hat einen Überblick über FreeBSD geboten. Lesen Sie das extref:{handbook}[FreeBSD Handbuch] für eine tiefergehender Abdeckung dieses und weiterer Themen, welche nicht in diesem Dokument behandelt sind.
diff --git a/documentation/content/de/articles/nanobsd/_index.adoc b/documentation/content/de/articles/nanobsd/_index.adoc
index 5f3bb2bdb9..5ff335f600 100644
--- a/documentation/content/de/articles/nanobsd/_index.adoc
+++ b/documentation/content/de/articles/nanobsd/_index.adoc
@@ -15,21 +15,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: articles/nanobsd/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
diff --git a/documentation/content/de/articles/new-users/_index.adoc b/documentation/content/de/articles/new-users/_index.adoc
index 46f5c10add..a5612a7ba7 100644
--- a/documentation/content/de/articles/new-users/_index.adoc
+++ b/documentation/content/de/articles/new-users/_index.adoc
@@ -3,7 +3,6 @@ title: Informationen für FreeBSD- und UNIX®-Einsteiger
authors:
- author: Annelise Anderson
email: andrsn@andrsn.stanford.edu
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-
-ifeval::["{backend}" == "html5"]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/urls.adoc[]
+:images-path: articles/new-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/de/urls.adoc[]
-include::../../../../shared/de/mailing-lists.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/de/urls.adoc[]
-include::../../../../shared/de/mailing-lists.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -317,7 +318,7 @@ Anschließend können Sie das Diskettenlaufwerk wieder aus dem Verzeichnisbaum a
Danach starten Sie DOS (Windows(R)). Kopieren Sie die Dateien in ein Verzeichnis. Nun öffnen Sie die Dateien mit DOS EDIT, Windows(R) Notepad, Wordpad oder einem anderen Schreibprogramm, speichern die Datei, falls Sie kleinere Änderungen vornehmen wollen, und drucken die Datei unter DOS oder Windows aus. Manualpages werden unter DOS am besten mit `print` ausgedruckt.
-Um Ihren Drucker unter FreeBSD einzurichten, muss ein entsprechender Eintrag in [.filename]#/etc/printcap# und ein Spool-Verzeichnis unter [.filename]#/var/spool/output# angelegt werden. Falls der Drucker an `lpt0` (entspricht LPT1 unter DOS) angeschlossen ist, müssen Sie wahrscheinlich nur nach [.filename]#/var/spool/output# wechseln und (als `root`) das Verzeichnis [.filename]#lpd# mit `mkdir lpd` anlegen, falls es nicht schon vorhanden ist. Danach sollte sich der Drucker, wenn er eingeschaltet ist, beim Booten melden und `lp` oder `lpr` sollte eine Datei zum Drucker schicken und ausdrucken. Ob die Datei schließlich ausgedruckt wird, hängt von der Konfiguration des Druckers ab, die im link:{handbook}[FreeBSD Handbuch] ausführlich beschrieben ist.
+Um Ihren Drucker unter FreeBSD einzurichten, muss ein entsprechender Eintrag in [.filename]#/etc/printcap# und ein Spool-Verzeichnis unter [.filename]#/var/spool/output# angelegt werden. Falls der Drucker an `lpt0` (entspricht LPT1 unter DOS) angeschlossen ist, müssen Sie wahrscheinlich nur nach [.filename]#/var/spool/output# wechseln und (als `root`) das Verzeichnis [.filename]#lpd# mit `mkdir lpd` anlegen, falls es nicht schon vorhanden ist. Danach sollte sich der Drucker, wenn er eingeschaltet ist, beim Booten melden und `lp` oder `lpr` sollte eine Datei zum Drucker schicken und ausdrucken. Ob die Datei schließlich ausgedruckt wird, hängt von der Konfiguration des Druckers ab, die im extref:{handbook}[FreeBSD Handbuch] ausführlich beschrieben ist.
[[other-useful-commands]]
== Weitere nützliche Befehle
diff --git a/documentation/content/de/articles/port-mentor-guidelines/_index.adoc b/documentation/content/de/articles/port-mentor-guidelines/_index.adoc
index 4ee098de90..6bd36195df 100644
--- a/documentation/content/de/articles/port-mentor-guidelines/_index.adoc
+++ b/documentation/content/de/articles/port-mentor-guidelines/_index.adoc
@@ -3,7 +3,6 @@ title: Richtlinien für Port-Mentoren
organizations:
- organization: Das FreeBSD Ports-Management Team
copyright: 2011 Thomas Abthorpe, Chris Rees
-releaseinfo: "$FreeBSD$"
---
= Richtlinien für Port-Mentoren
@@ -15,21 +14,26 @@ releaseinfo: "$FreeBSD$"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-
-ifeval::["{backend}" == "html5"]
-include::shared/de/urls.adoc[]
+:images-path: articles/port-mentor-guidelines/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/de/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/de/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -72,7 +76,7 @@ Wir erwarten, dass Mentoren alle vorgeschlagenen Patche, zumindest für einen An
Wir erwarten, dass Mentoren die Verantwortung für die Aktionen Ihres Mentees übernehmen. Ein Mentor sollte hinter den Commits des Mentees stehen, sowohl implizit als auch explizit.
-Wir erwarten, dass Mentoren ihre Mentees die Lektüre des link:{porters-handbook}[Handbuch für Ports Committer], die link:{pr-guidelines}[PR-Richtlinien] sowie den link:{committers-guide}[Committer's Guide] empfehlen. Obwohl es nicht notwendig ist, all diese Details im Gedächtnis zu behalten, sollte jeder Committer einen Überblick über diese Dinge haben, um ein effizienter Teil der Gemeinschaft zu sein (und um Anfängerfehler so weit wie möglich zu vermeiden).
+Wir erwarten, dass Mentoren ihre Mentees die Lektüre des extref:{porters-handbook}[Handbuch für Ports Committer], die extref:{pr-guidelines}[PR-Richtlinien] sowie den extref:{committers-guide}[Committer's Guide] empfehlen. Obwohl es nicht notwendig ist, all diese Details im Gedächtnis zu behalten, sollte jeder Committer einen Überblick über diese Dinge haben, um ein effizienter Teil der Gemeinschaft zu sein (und um Anfängerfehler so weit wie möglich zu vermeiden).
[[mentees]]
=== Auswahl eines Mentees
diff --git a/documentation/content/de/articles/solid-state/_index.adoc b/documentation/content/de/articles/solid-state/_index.adoc
index 3b641aef4c..e555779684 100644
--- a/documentation/content/de/articles/solid-state/_index.adoc
+++ b/documentation/content/de/articles/solid-state/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: John Kozubik
email: john@kozubik.com
copyright: 2001, 2009 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -17,10 +16,27 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: articles/solid-state/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Zusammenfassung
diff --git a/documentation/content/de/books/developers-handbook/_index.adoc b/documentation/content/de/books/developers-handbook/_index.adoc
index 18be34514d..00e1073cdd 100644
--- a/documentation/content/de/books/developers-handbook/_index.adoc
+++ b/documentation/content/de/books/developers-handbook/_index.adoc
@@ -3,8 +3,8 @@ title: FreeBSD Developers' Handbook
authors:
- author: The FreeBSD Documentation Project
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
+trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
+isIndex: true
---
= FreeBSD Developers' Handbook
@@ -12,65 +12,45 @@ trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhaltsverzeichnis
-:part-signifier: Teil
-:chapter-signifier: Kapitel
-:appendix-caption: Anhang
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+:book: true
+:pdf: false
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
-:imagesdir: ../../../../images/books/developers-handbook/
-:chapters-path: content/de/books/developers-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/de/mailing-lists.adoc[]
-include::../../../../shared/de/teams.adoc[]
-include::../../../../shared/de/urls.adoc[]
-:imagesdir: ../../../static/images/books/developers-handbook/
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/de/mailing-lists.adoc[]
-include::../../../../shared/de/teams.adoc[]
-include::../../../../shared/de/urls.adoc[]
-:imagesdir: ../../../static/images/books/developers-handbook/
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
[abstract]
Zusammenfassung
-Willkommen zum Entwickler-Handbuch. Dieses Handbuch ist _jederzeit unter Bearbeitung_ und das Ergebnis der Arbeit vieler Einzelpersonen. Dies kann dazu führen, dass bestimmte Bereiche nicht mehr aktuell sind und auf den neuesten Stand gebracht werden müssen. Bei Unklarheiten empfiehlt es sich daher stets, auch die link:{developers-handbook}[englische Originalversion] des Handbuchs zu lesen.
+Willkommen zum Entwickler-Handbuch. Dieses Handbuch ist _jederzeit unter Bearbeitung_ und das Ergebnis der Arbeit vieler Einzelpersonen. Dies kann dazu führen, dass bestimmte Bereiche nicht mehr aktuell sind und auf den neuesten Stand gebracht werden müssen. Bei Unklarheiten empfiehlt es sich daher stets, auch die extref:{developers-handbook}[englische Originalversion] des Handbuchs zu lesen.
Wenn Sie bei der Übersetzung dieses Handbuchs mithelfen möchten, senden Sie bitte eine E-Mail an die Mailingliste {de-doc}.
-Die aktuelle Version dieses Handbuchs ist immer auf dem http://www.FreeBSD.org/[FreeBSD-Webserver] verfügbar und kann in verschiedenen Formaten und in komprimierter Form vom link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc[FreeBSD-FTP-Server] oder einem der zahlreichen link:{handbook}#mirrors-ftp[Spiegel] heruntergeladen werden (ältere Versionen finden Sie hingegen unter http://docs.FreeBSD.org/doc/[http://docs.FreeBSD.org/doc/]).
+Die aktuelle Version dieses Handbuchs ist immer auf dem http://www.FreeBSD.org/[FreeBSD-Webserver] verfügbar und kann in verschiedenen Formaten und in komprimierter Form vom link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc[FreeBSD-FTP-Server] oder einem der zahlreichen extref:{handbook}mirrors/[Spiegel, mirrors-ftp] heruntergeladen werden (ältere Versionen finden Sie hingegen unter http://docs.FreeBSD.org/doc/[http://docs.FreeBSD.org/doc/]).
'''
@@ -80,32 +60,32 @@ toc::[]
[[basics]]
= Grundlagen
-include::{chapters-path}introduction/chapter.adoc[leveloffset=+1, lines=7..22;33..-1]
-include::{chapters-path}tools/chapter.adoc[leveloffset=+1, lines=10..32;43..-1]
-include::{chapters-path}secure/chapter.adoc[leveloffset=+1, lines=9..25;36..-1]
-include::{chapters-path}l10n/chapter.adoc[leveloffset=+1, lines=7..23;34..-1]
-include::{chapters-path}policies/chapter.adoc[leveloffset=+1, lines=10..26;37..-1]
-include::{chapters-path}testing/chapter.adoc[leveloffset=+1, lines=7..23;34..-1]
+include::{chapters-path}introduction/chapter.adoc[leveloffset=+1]
+include::{chapters-path}tools/chapter.adoc[leveloffset=+1]
+include::{chapters-path}secure/chapter.adoc[leveloffset=+1]
+include::{chapters-path}l10n/chapter.adoc[leveloffset=+1]
+include::{chapters-path}policies/chapter.adoc[leveloffset=+1]
+include::{chapters-path}testing/chapter.adoc[leveloffset=+1]
// Section two
[[ipc]]
= Interprozess-Kommunikation
-include::{chapters-path}sockets/chapter.adoc[leveloffset=+1, lines=9..25;36..-1]
-include::{chapters-path}ipv6/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
+include::{chapters-path}sockets/chapter.adoc[leveloffset=+1]
+include::{chapters-path}ipv6/chapter.adoc[leveloffset=+1]
// Section three
[[kernel]]
= Kernel
-include::{chapters-path}kernelbuild/chapter.adoc[leveloffset=+1, lines=7..23;34..-1]
-include::{chapters-path}kerneldebug/chapter.adoc[leveloffset=+1, lines=11..27;38..-1]
+include::{chapters-path}kernelbuild/chapter.adoc[leveloffset=+1]
+include::{chapters-path}kerneldebug/chapter.adoc[leveloffset=+1]
// Section four
[[architectures]]
= Architekturen
-include::{chapters-path}x86/chapter.adoc[leveloffset=+1, lines=7..23;34..-1]
+include::{chapters-path}x86/chapter.adoc[leveloffset=+1]
// Appendices
[[appendices]]
= Anhang
-include::{chapters-path}bibliography/chapter.adoc[leveloffset=+1, lines=6..20;29..-1]
+include::{chapters-path}bibliography/chapter.adoc[leveloffset=+1]
diff --git a/documentation/content/de/books/developers-handbook/bibliography/chapter.adoc b/documentation/content/de/books/developers-handbook/bibliography/chapter.adoc
index a2847e37ac..37c2d499e2 100644
--- a/documentation/content/de/books/developers-handbook/bibliography/chapter.adoc
+++ b/documentation/content/de/books/developers-handbook/bibliography/chapter.adoc
@@ -10,21 +10,37 @@ prev: books/developers-handbook/x86
:toc: macro
:toclevels: 1
:icons: font
-:sectnums!:
+:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[COD,1]] [1] Dave A Patterson and John L Hennessy. Copyright(R) 1998 Morgan Kaufmann Publishers, Inc. 1-55860-428-6. Morgan Kaufmann Publishers, Inc. Computer Organization and Design. The Hardware / Software Interface. 1-2.
diff --git a/documentation/content/de/books/developers-handbook/introduction/chapter.adoc b/documentation/content/de/books/developers-handbook/introduction/chapter.adoc
index be3e2fbe27..12e216ef87 100644
--- a/documentation/content/de/books/developers-handbook/introduction/chapter.adoc
+++ b/documentation/content/de/books/developers-handbook/introduction/chapter.adoc
@@ -11,24 +11,36 @@ next: books/developers-handbook/tools
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-devel]]
== Unter FreeBSD entwickeln
diff --git a/documentation/content/de/books/developers-handbook/ipv6/chapter.adoc b/documentation/content/de/books/developers-handbook/ipv6/chapter.adoc
index 8657754234..6610b447e7 100644
--- a/documentation/content/de/books/developers-handbook/ipv6/chapter.adoc
+++ b/documentation/content/de/books/developers-handbook/ipv6/chapter.adoc
@@ -11,26 +11,36 @@ next: books/developers-handbook/kernelbuild
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:appendix-caption: Anhang
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ipv6-implementation]]
== IPv6/IPsec-Implementierung
diff --git a/documentation/content/de/books/developers-handbook/kernelbuild/chapter.adoc b/documentation/content/de/books/developers-handbook/kernelbuild/chapter.adoc
index c3c03f6047..2402b2b5b0 100644
--- a/documentation/content/de/books/developers-handbook/kernelbuild/chapter.adoc
+++ b/documentation/content/de/books/developers-handbook/kernelbuild/chapter.adoc
@@ -11,25 +11,36 @@ next: books/developers-handbook/kerneldebug
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Ein Kernelentwickler muss wissen, wie der Bau eines angepassten Kernels funktioniert, da das Debuggen des FreeBSD-Kernels nur durch den Bau eines neuen Kernels möglich ist. Es gibt zwei Wege, einen angepassten Kernel zu bauen:
@@ -38,7 +49,7 @@ Ein Kernelentwickler muss wissen, wie der Bau eines angepassten Kernels funktion
[NOTE]
====
-Die folgenden Ausführungen setzen voraus, dass Sie den Abschnitt link:{handbook}#kernelconfig-building[Erstellen und Installation eines angepassten Kernels] des FreeBSD-Handbuchs gelesen haben und daher wissen, wie man einen FreeBSD-Kernel baut.
+Die folgenden Ausführungen setzen voraus, dass Sie den Abschnitt extref:{handbook}kernelconfig/[Erstellen und Installation eines angepassten Kernels, kernelconfig-building] des FreeBSD-Handbuchs gelesen haben und daher wissen, wie man einen FreeBSD-Kernel baut.
====
[[kernelbuild-traditional]]
@@ -81,4 +92,4 @@ Bis FreeBSD 4.X wurde dieser Weg zum Bau eines angepassten Kernels empfohlen. Si
[[kernelbuild-new]]
== Einen Kernel auf die "neue" Art und Weise bauen
-Dieser Weg wird für alle aktuellen FreeBSD-Versionen empfohlen. Lesen Sie bitte den Abschnitt link:{handbook}#kernelconfig-building[Erstellen und Installation eines angepassten Kernels] des FreeBSD-Handbuchs, wenn Sie Ihren Kernel auf diese Art und Weise bauen wollen.
+Dieser Weg wird für alle aktuellen FreeBSD-Versionen empfohlen. Lesen Sie bitte den Abschnitt extref:{handbook}kernelconfig/[Erstellen und Installation eines angepassten Kernels, kernelconfig-building] des FreeBSD-Handbuchs, wenn Sie Ihren Kernel auf diese Art und Weise bauen wollen.
diff --git a/documentation/content/de/books/developers-handbook/kerneldebug/chapter.adoc b/documentation/content/de/books/developers-handbook/kerneldebug/chapter.adoc
index 8e3fefbea8..1e3aabb544 100644
--- a/documentation/content/de/books/developers-handbook/kerneldebug/chapter.adoc
+++ b/documentation/content/de/books/developers-handbook/kerneldebug/chapter.adoc
@@ -15,25 +15,36 @@ next: books/developers-handbook/x86
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kerneldebug-obtain]]
== Besorgen eines Speicherauszugs nach einem Kernel-Absturz (Kernel-Crash-Dump)
@@ -348,7 +359,7 @@ options KDB
options DDB
....
-Ihrer Konfigurationsdatei hinzu und bauen Sie den Kernel neu. (Details zur Konfiguration des FreeBSD-Kernels finden Sie im link:{handbook}[FreeBSD-Handbuch]).
+Ihrer Konfigurationsdatei hinzu und bauen Sie den Kernel neu. (Details zur Konfiguration des FreeBSD-Kernels finden Sie im extref:{handbook}[FreeBSD-Handbuch]).
[NOTE]
====
diff --git a/documentation/content/de/books/developers-handbook/l10n/chapter.adoc b/documentation/content/de/books/developers-handbook/l10n/chapter.adoc
index a52e6fd360..8a4b50b4be 100644
--- a/documentation/content/de/books/developers-handbook/l10n/chapter.adoc
+++ b/documentation/content/de/books/developers-handbook/l10n/chapter.adoc
@@ -11,25 +11,36 @@ next: books/developers-handbook/policies
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-programming]]
== I18N-konforme Anwendungen programmieren
diff --git a/documentation/content/de/books/developers-handbook/policies/chapter.adoc b/documentation/content/de/books/developers-handbook/policies/chapter.adoc
index 99f8996f67..e03d03c675 100644
--- a/documentation/content/de/books/developers-handbook/policies/chapter.adoc
+++ b/documentation/content/de/books/developers-handbook/policies/chapter.adoc
@@ -14,25 +14,36 @@ next: books/developers-handbook/testing
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Dieses Kapitel dokumentiert verschiedene Vorgaben und Richtlinien für das FreeBSD-Quelltextverzeichnis.
diff --git a/documentation/content/de/books/developers-handbook/secure/chapter.adoc b/documentation/content/de/books/developers-handbook/secure/chapter.adoc
index 1c03b73282..4407013162 100644
--- a/documentation/content/de/books/developers-handbook/secure/chapter.adoc
+++ b/documentation/content/de/books/developers-handbook/secure/chapter.adoc
@@ -13,25 +13,36 @@ next: books/developers-handbook/l10n
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[secure-synopsis]]
== Zusammenfassung
diff --git a/documentation/content/de/books/developers-handbook/sockets/chapter.adoc b/documentation/content/de/books/developers-handbook/sockets/chapter.adoc
index a9dcf1abd0..9ec9f3a459 100644
--- a/documentation/content/de/books/developers-handbook/sockets/chapter.adoc
+++ b/documentation/content/de/books/developers-handbook/sockets/chapter.adoc
@@ -13,24 +13,35 @@ next: books/developers-handbook/ipv6
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Dieses Kapitel ist noch nicht übersetzt. Lesen Sie bitte <<sockets,das Original in englischer Sprache>>. Wenn Sie helfen wollen, dieses Kapitel zu übersetzen, senden Sie bitte eine E-Mail an die Mailingliste {de-doc}.
diff --git a/documentation/content/de/books/developers-handbook/testing/chapter.adoc b/documentation/content/de/books/developers-handbook/testing/chapter.adoc
index 8e22611fde..ea7fd0efac 100644
--- a/documentation/content/de/books/developers-handbook/testing/chapter.adoc
+++ b/documentation/content/de/books/developers-handbook/testing/chapter.adoc
@@ -11,25 +11,36 @@ next: books/developers-handbook/sockets
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Regressions-Tests werden durchgeführt, um zu überprüfen, ob ein bestimmter Teil des Systems wie erwartet funktioniert, und um sicherzustellen, dass bereits beseitigte Fehler nicht wieder eingebaut werden.
diff --git a/documentation/content/de/books/developers-handbook/tools/chapter.adoc b/documentation/content/de/books/developers-handbook/tools/chapter.adoc
index 599080b478..a511fdae7e 100644
--- a/documentation/content/de/books/developers-handbook/tools/chapter.adoc
+++ b/documentation/content/de/books/developers-handbook/tools/chapter.adoc
@@ -15,30 +15,40 @@ next: books/developers-handbook/secure
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:c-plus-plus-command: c++
:clang-plus-plus-command: clang++
:gcc-plus-plus: g++
:lg-plus-plus: -lg++
:lstdc-plus-plus: -lstdc++
-:sectnumoffset: 2
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[tools-synopsis]]
== Überblick
@@ -71,7 +81,7 @@ Meiner Meinung nach sind interpretierte Sprachen der beste Anfang, wenn Sie bish
Im folgenden eine Liste der über die FreeBSD Ports-Sammlung verfügbaren Interpreter einschließlich einer kurzen Erörterung der populären interpretierten Sprachen.
-Anleitungen wie man Anwendungen aus der Ports-Sammlung erhält und installiert können Sie dem Kapitel link:{handbook}#ports-using/[Benutzen der Ports-Sammlung] aus dem FreeBSD Handbuch entnehmen.
+Anleitungen wie man Anwendungen aus der Ports-Sammlung erhält und installiert können Sie dem Kapitel extref:{handbook}ports/[Benutzen der Ports-Sammlung, ports-using] aus dem FreeBSD Handbuch entnehmen.
BASIC::
Kurz für Beginner's All-purpose Symbolic Instruction Code. Entwickelt in den 50er Jahren um Studenten in Programmierung zu unterrichten, wurde BASIC in den 80er Jahren mit jedem anständigen Personal Computer ausgeliefert und war für viele Programmierer die erste Programmiersprache. BASIC ist auch die Grundlage für Visual Basic.
diff --git a/documentation/content/de/books/developers-handbook/x86/chapter.adoc b/documentation/content/de/books/developers-handbook/x86/chapter.adoc
index 0f4fef2cb8..f4830a5735 100644
--- a/documentation/content/de/books/developers-handbook/x86/chapter.adoc
+++ b/documentation/content/de/books/developers-handbook/x86/chapter.adoc
@@ -11,25 +11,36 @@ next: books/developers-handbook/bibliography
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
_Dieses Kapitel wurde geschrieben von {stanislav}._
diff --git a/documentation/content/de/books/faq/_index.adoc b/documentation/content/de/books/faq/_index.adoc
index 3898d3b3df..86f0f0b74f 100644
--- a/documentation/content/de/books/faq/_index.adoc
+++ b/documentation/content/de/books/faq/_index.adoc
@@ -3,8 +3,8 @@ title: Häufig gestellte Fragen zu FreeBSD 11.X und 12.X
authors:
- author: The FreeBSD Documentation Project
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
+trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
+isIndex: true
---
= Häufig gestellte Fragen zu FreeBSD {rel2-relx} und {rel-relx}
@@ -12,60 +12,46 @@ trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "
:toc: macro
:toclevels: 1
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhaltsverzeichnis
-:part-signifier: Teil
-:chapter-signifier: Kapitel
-:appendix-caption: Anhang
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:rel-numbranch: 3
-:rel-head: 13-CURRENT
-:rel-head-relx: 13.X
+:images-path: books/faq/
+:rel-numbranch: 4
+:rel-head: 14-CURRENT
+:rel-head-relx: 14.X
:rel-head-releng: head/
-:rel-relx: 12.X
-:rel-stable: 12-STABLE
-:rel-releng: stable/12/
+:rel-relx: 13.X
+:rel-stable: 13-STABLE
+:rel-releng: stable/13/
:rel-relengdate: December 2018
-:rel2-relx: 11.X
-:rel2-stable: 11-STABLE
-:rel2-releng: stable/11/
-:rel2-relengdate: October 2016
-
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+:rel2-relx: 12.X
+:rel2-stable: 12-STABLE
+:rel2-releng: stable/12/
+:rel2-relengdate: December 2018
+:rel3-relx: 11.X
+:rel3-stable: 11-STABLE
+:rel3-releng: stable/11/
+:rel3-relengdate: October 2016
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/de/mailing-lists.adoc[]
-include::../../../../shared/de/teams.adoc[]
-include::../../../../shared/de/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/de/mailing-lists.adoc[]
-include::../../../../shared/de/teams.adoc[]
-include::../../../../shared/de/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -89,7 +75,7 @@ Es basiert auf dem "4.4BSD-Lite"-Release der U.C. Berkeley, mit einigen Erweiter
Unternehmen, Internet Service Provider, Forscher, Computerfachleute, Studenten und Privatnutzer auf der ganzen Welt benutzen FreeBSD für die Arbeit, die Ausbildung oder in der Freizeit.
-Ausführlichere Informationen zu FreeBSD, finden Sie im link:{handbook}[FreeBSD Handbuch].
+Ausführlichere Informationen zu FreeBSD, finden Sie im extref:{handbook}[FreeBSD Handbuch].
[[FreeBSD-goals]]
=== Welches Ziel hat das FreeBSD Project?
@@ -116,7 +102,7 @@ Die meisten Anwender benutzen kein Betriebssystem, sondern Anwendungen. Die Anwe
Wenn Sie eine Anwendung benutzen müssen, die es nur für ein bestimmtes Betriebssystem gibt, dann kommen Sie an diesem Betriebssystem nicht vorbei. Allerdings stehen die Chancen nicht schlecht, dass es eine vergleichbare Anwendung für FreeBSD gibt.
-Wenn Sie von einem anderen UNIX(TM) System zu FreeBSD wechseln, dürfte Ihnen vieles bekannt vorkommen. Wenn Ihr Hintergrund ein Betriebssystem wie Windows(TM) oder MacOS(TM)ist, sind Sie vielleicht an https://www.trueos.org/[TrueOS] interessiert, eine auf FreeBSD basierende Desktop-Distribution. Wenn Sie vorher noch nicht mit UNIX(TM) gearbeitet haben, werden Sie zusätzliche Zeit investieren müssen, um den UNIX(TM) Stil zu verstehen. Diese FAQ und das link:{handbook}[FreeBSD Handbuch] sind die besten Startpunkte.
+Wenn Sie von einem anderen UNIX(TM) System zu FreeBSD wechseln, dürfte Ihnen vieles bekannt vorkommen. Wenn Ihr Hintergrund ein Betriebssystem wie Windows(TM) oder MacOS(TM)ist, sind Sie vielleicht an https://www.trueos.org/[TrueOS] interessiert, eine auf FreeBSD basierende Desktop-Distribution. Wenn Sie vorher noch nicht mit UNIX(TM) gearbeitet haben, werden Sie zusätzliche Zeit investieren müssen, um den UNIX(TM) Stil zu verstehen. Diese FAQ und das extref:{handbook}[FreeBSD Handbuch] sind die besten Startpunkte.
=== Warum heißt es FreeBSD?
@@ -152,7 +138,7 @@ Weitere Informationen über FreeBSD-Releases finden Sie auf der http://www.FreeB
=== Was ist FreeBSD-CURRENT?
-link:{handbook}#current[FreeBSD-CURRENT] ist die Entwicklungsversion des Betriebssystems, aus der zu gegebener Zeit der FreeBSD-STABLE-Zweig entstehen wird. Als solche ist sie lediglich für Entwickler, die am System mitarbeiten und für unentwegte Bastler von Interesse. Details zum Betrieb von _-CURRENT_ finden Sie im link:{handbook}#current[entsprechenden Abschnitt] des link:{handbook}[Handbuchs].
+extref:{handbook}updating-upgrading[FreeBSD-CURRENT, current] ist die Entwicklungsversion des Betriebssystems, aus der zu gegebener Zeit der FreeBSD-STABLE-Zweig entstehen wird. Als solche ist sie lediglich für Entwickler, die am System mitarbeiten und für unentwegte Bastler von Interesse. Details zum Betrieb von _-CURRENT_ finden Sie im extref:{handbook}updating-upgrading[entsprechenden Abschnitt, current] des extref:{handbook}[Handbuchs].
Falls Sie mit FreeBSD nicht vertraut sind, sollten Sie FreeBSD-CURRENT nicht verwenden. Dieser Zweig entwickelt sich manchmal sehr schnell weiter und kann gelegentlich nicht installierbar sein. Von Personen, die FreeBSD-CURRENT verwenden, wird erwartet, dass Sie dazu in der Lage sind, Probleme zu erkennen, zu analysieren und diese an das Projekt zurückzumelden.
@@ -171,7 +157,7 @@ Offizielle Snapshots werden in regelmäßigen Abständen für jeden aktiven Zwei
=== Was ist das Konzept von FreeBSD-STABLE?
-Zur der Zeit, als FreeBSD 2.0.5 herausgegeben wurde, wurde entschieden, die Entwicklung von FreeBSD zweizuteilen. Ein Zweig wurde link:{handbook}#stable[-STABLE], der andere link:{handbook}#current[-CURRENT] genannt. _FreeBSD-STABLE_ ist der Entwicklungszweig aus dem die Hauptversionen erstellt werden. In diesem Zweig gehen nur Änderungen ein, wenn sie zuvor sorgfältig in FreeBSD-CURRENT getestet wurden. Gelegentlich können die Quellen für FreeBSD-STABLE möglicherweise nicht für den allgemeinen Gebrauch geeignet sein, da es Fehler enthalten können, die noch nicht in FreeBSD-CURRENT gefunden wurden. Benutzer, die nicht über genügend Ressourcen verfügen um zu testen, sollten stattdessen die aktuelle Version von FreeBSD verwenden. _FreeBSD-CURRENT_ ist eine ununterbrochene Linie seitdem die Version 2.0 herausgegeben worden ist. Sie führt zu 11.0-RELEASE (und darüber hinaus). Weitere Informationen zu diesen Zweigen finden Sie unter "link:{releng}#rel-branch[FreeBSD Release Engineering: Creating the Release Branch]", der Status der Zweige und der Zeitplan zur anstehenden Veröffentlichung kann auf der Seite http://www.FreeBSD.org/releng[Release Engineering Information] gefunden werden.
+Zur der Zeit, als FreeBSD 2.0.5 herausgegeben wurde, wurde entschieden, die Entwicklung von FreeBSD zweizuteilen. Ein Zweig wurde extref:{handbook}updating-upgrading[-STABLE, stable], der andere extref:{handbook}updating-upgrading[-CURRENT, current] genannt. _FreeBSD-STABLE_ ist der Entwicklungszweig aus dem die Hauptversionen erstellt werden. In diesem Zweig gehen nur Änderungen ein, wenn sie zuvor sorgfältig in FreeBSD-CURRENT getestet wurden. Gelegentlich können die Quellen für FreeBSD-STABLE möglicherweise nicht für den allgemeinen Gebrauch geeignet sein, da es Fehler enthalten können, die noch nicht in FreeBSD-CURRENT gefunden wurden. Benutzer, die nicht über genügend Ressourcen verfügen um zu testen, sollten stattdessen die aktuelle Version von FreeBSD verwenden. _FreeBSD-CURRENT_ ist eine ununterbrochene Linie seitdem die Version 2.0 herausgegeben worden ist. Sie führt zu 11.0-RELEASE (und darüber hinaus). Weitere Informationen zu diesen Zweigen finden Sie unter "extref:{releng}[FreeBSD Release Engineering: Creating the Release Branch, rel-branch]", der Status der Zweige und der Zeitplan zur anstehenden Veröffentlichung kann auf der Seite http://www.FreeBSD.org/releng[Release Engineering Information] gefunden werden.
11.0-STABLE ist der Zweig, auf den sich die Entwicklung von _-STABLE_ zur Zeit konzentriert. Das neueste Release aus dem 11.0-STABLE-Zweig ist 11.0-RELEASE und ist im Oktober 2016 erschienen.
@@ -187,7 +173,7 @@ Für diejenigen, die ein wenig mehr Spannung möchten, werden täglich Snapshots
=== Wer ist für FreeBSD verantwortlich?
-Schlüsseldiskussionen, die das FreeBSD Project betreffen, wie z.B. über die generelle Ausrichtung des Projekts und darüber, wem es erlaubt sein soll, Code zum Quellbaum hinzuzufügen, werden innerhalb eines https://www.FreeBSD.org/administration/#t-core[Core Teams] von 9 Personen geführt. Es gibt ein weitaus größeres Team von über 350 link:{contributors}#staff-committers[Committern], die dazu autorisiert sind, Änderungen am FreeBSD Quellbaum durchzuführen.
+Schlüsseldiskussionen, die das FreeBSD Project betreffen, wie z.B. über die generelle Ausrichtung des Projekts und darüber, wem es erlaubt sein soll, Code zum Quellbaum hinzuzufügen, werden innerhalb eines https://www.FreeBSD.org/administration/#t-core[Core Teams] von 9 Personen geführt. Es gibt ein weitaus größeres Team von über 350 extref:{contributors}[Committern, staff-committers], die dazu autorisiert sind, Änderungen am FreeBSD Quellbaum durchzuführen.
Jedoch werden die meisten nicht-trivialen Änderungen zuvor in den <<mailing,Mailinglisten>> diskutiert und es bestehen keinerlei Einschränkungen darüber, wer sich an diesen Diskussionen beteiligen darf.
@@ -199,7 +185,7 @@ Jede bedeutende Ausgabe von FreeBSD ist per Anonymous-FTP vom link:ftp://ftp.Fre
* https://www.FreeBSD.org/snapshots/[Snapshot]-Releases werden monatlich aus dem <<current,-CURRENT>>-Zweig sowie aus dem <<stable,-STABLE>>-Zweig erzeugt. Sie sollten aber nur von Entwicklern und sehr erfahrenen Testern verwendet werden.
* Das aktuelle _10-STABLE_-Release, 10.3-RELEASE, finden Sie im link:ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/i386/10.3-RELEASE/[Verzeichnis 10.3-RELEASE].
-Wo und wie Sie FreeBSD auf CD, DVD, und anderen Medien beziehen können, erfahren Sie im link:{handbook}#mirrors[Handbuch].
+Wo und wie Sie FreeBSD auf CD, DVD, und anderen Medien beziehen können, erfahren Sie im extref:{handbook}mirrors[Handbuch, mirrors].
=== Wie greife ich auf die Datenbank mit Problemberichten zu?
@@ -207,13 +193,13 @@ Die Datenbank mit Problemberichten (PR, problem report) und Änderungsanfragen v
Über die https://www.FreeBSD.org/support/bugreports/[webbasierte PR-Schnittstelle] können Sie Problemberichte über einen Webbrowser einreichen.
-Bevor Sie einen Fehler melden, sollten Sie zuerst link:{problem-reports}[Writing FreeBSD Problem Reports] lesen, damit Sie wissen, wie Sie eine gute Fehlermeldung verfassen.
+Bevor Sie einen Fehler melden, sollten Sie zuerst extref:{problem-reports}[Writing FreeBSD Problem Reports] lesen, damit Sie wissen, wie Sie eine gute Fehlermeldung verfassen.
== Dokumentation und Unterstützung
=== Gibt es gute Bücher über FreeBSD?
-Im Zuge des FreeBSD Projekts sind diverse gute Dokumente entstanden, die unter der folgenden URL abgerufen werden können: http://www.FreeBSD.org/docs/[http://www.FreeBSD.org/de/docs/]. Zusätzlich enthält <<bibliography,die Bibliographie>> am Ende dieser FAQ und link:{handbook}#bibliography[diejenige im Handbuch] Verweise auf weitere empfohlene Bücher.
+Im Zuge des FreeBSD Projekts sind diverse gute Dokumente entstanden, die unter der folgenden URL abgerufen werden können: http://www.FreeBSD.org/docs/[http://www.FreeBSD.org/de/docs/]. Zusätzlich enthält <<bibliography,die Bibliographie>> am Ende dieser FAQ und extref:{handbook}bibliography[diejenige im Handbuch, bibliography] Verweise auf weitere empfohlene Bücher.
=== Ist die Dokumentation auch in anderen Formaten verfügbar? Zum Beispiel als einfacher Text (ASCII) oder als PostScript?
@@ -350,7 +336,7 @@ Wenn die Datei komprimiert ist, wird tar automatisch das entsprechende Format er
=== Woher bekomme ich Informationen zu den FreeBSD Mailinglisten? Welche Newsgruppen existieren zu FreeBSD?
-Lesen Sie den link:{handbook}#eresources-mail[Handbucheintrag über Mailinglisten] und den link:{handbook}#eresources-news/[Handbucheintrag zu Newsgruppen].
+Lesen Sie den extref:{handbook}eresources[Handbucheintrag über Mailinglisten, eresources-mail] und den extref:{handbook}eresources/[Handbucheintrag zu Newsgruppen, eresources-news].
=== Gibt es FreeBSD IRC (Internet Relay Chat) Kanäle?
@@ -412,7 +398,7 @@ Sie können eine der folgenden Dateien wählen:
pc98-Benutzer benötigen drei Floppy-Images: [.filename]#floppies/boot.flp#, [.filename]#floppies/kern1.flp#, [.filename]#floppies/kern2.flp#, und [.filename]#floppies/mfsroot1.flp#. Diese Images müssen mit Hilfe von Werkzeugen wie man:dd[1] auf Disketten kopiert werden.
-Eine vollständige Anleitung für dieses Vorgehen und weitere Informationen zur Installation finden Sie im link:{handbook}#bsdinstall[Handbucheintrag zur Installation von FreeBSD].
+Eine vollständige Anleitung für dieses Vorgehen und weitere Informationen zur Installation finden Sie im extref:{handbook}bsdinstall[Handbucheintrag zur Installation von FreeBSD, bsdinstall].
=== Was mache ich, wenn das Image nicht bootet?
@@ -424,7 +410,7 @@ Wenn Sie einen FTP-Client für die Kommandozeile benutzen, geben Sie am FTP-Prom
=== Wo befinden sich die Anweisungen zur Installation von FreeBSD?
-Installationsanleitungen finden Sie im link:{handbook}#bsdinstall/[Handbucheintrag zur Installation von FreeBSD].
+Installationsanleitungen finden Sie im extref:{handbook}bsdinstall/[Handbucheintrag zur Installation von FreeBSD, bsdinstall].
=== Was sind die Mindestanforderungen zum Betrieb von FreeBSD?
@@ -432,7 +418,7 @@ Der Betrieb von FreeBSD erfordert mindestens einen 486er Prozessor, 64 MB RAM so
=== Wie kann ich ein angepasstes Installationsmedium erstellen?
-Individuelle FreeBSD Installationsmedien können über den Bau eines Releases erzeugt werden. Folgen Sie den Anweisungen im Artikel link:{releng}[Release Engineering].
+Individuelle FreeBSD Installationsmedien können über den Bau eines Releases erzeugt werden. Folgen Sie den Anweisungen im Artikel extref:{releng}[Release Engineering].
=== Kann Windows neben FreeBSD existieren?
@@ -527,7 +513,7 @@ PAE wird heutzutage nicht sehr häufig verwendet, da die Mehrzahl an neuer x86-H
=== Unterstützt FreeBSD neben x86 auch andere Architekturen?
-Ja. FreeBSD teilt die Unterstützung in sogenannte Tiers auf. Tier-1 Architekturen, wie i386 oder amd64 werden vollständig unterstützt. Tier-2 und Tier-3 werden auf der "Best-Effort Basis" unterstützt. Eine vollständige Erklärung dieser Aufteilung finden Sie im link:{committers-guide}#archs[Committer's Guide].
+Ja. FreeBSD teilt die Unterstützung in sogenannte Tiers auf. Tier-1 Architekturen, wie i386 oder amd64 werden vollständig unterstützt. Tier-2 und Tier-3 werden auf der "Best-Effort Basis" unterstützt. Eine vollständige Erklärung dieser Aufteilung finden Sie im extref:{committers-guide}[Committer's Guide, archs].
Eine vollständige Liste der unterstützten Architekturen finden Sie auf der Seite http://www.FreeBSD.org/de/platforms/[Unterstützte Plattformen].
@@ -702,7 +688,7 @@ Die Entwickler von FreeBSD interessieren sich für solchen Meldungen, allerdings
Der FreeBSD-Kernel beschränkt die Anzahl der gleichzeitig laufenden Prozesse. Die Anzahl errechnet sich aus dem Wert der `kern.maxusers` man:sysctl[8]-Variable. Auch andere Einstellungen wie die Anzahl der Puffer für Netzwerkoperationen werden durch `kern.maxusers` beeinflusst. Wenn das System stark belastet ist, sollten Sie den Wert von `kern.maxusers` erhöhen. Dadurch werden diverse Einstellungen des Systems angepasst und die maximale Anzahl gleichzeitig laufender Prozesse erhöht.
-Um den Wert von `kern.maxusers` anzupassen, folgen Sie den Anweisungen im Abschnitt link:{handbook}#kern-maxfiles[Datei und Prozeß Limits] des Handbuchs. Dieser Abschnitt spricht zwar nur von Dateien, für Prozesse gelten aber die gleichen Beschränkungen.
+Um den Wert von `kern.maxusers` anzupassen, folgen Sie den Anweisungen im Abschnitt extref:{handbook}config-tuning[Datei und Prozeß Limits, kern-maxfiles] des Handbuchs. Dieser Abschnitt spricht zwar nur von Dateien, für Prozesse gelten aber die gleichen Beschränkungen.
Wenn das System nicht besonders stark ausgelastet ist und Sie einfach nur mehr gleichzeitig laufende Prozesse erlauben wollen, können Sie den Wert der Variable `kern.maxproc` in [.filename]#/boot/loader.conf# anpassen. Um die Änderung zu aktivieren, müssen Sie das System neu starten. Wollen Sie das System zusätzlich optimieren, sollten Sie man:loader.conf[5] lesen. Wenn diese Prozesse von einem einzigen Benutzer ausgeführt werden, müssen Sie den Wert von `kern.maxprocperuid` ebenfalls erhöhen. Dieser Wert muss immer mindestens um eins geringer sein als der Wert von `kern.maxproc`, weil ein Systemprogramm, man:init[8], immer ausgeführt werden muss.
@@ -732,7 +718,7 @@ Haben Sie FreeBSD gerade erst installiert, kann es auch sein, dass die Domänen-
=== Warum sehe ich in der Ausgabe von dmesg8 häufig die Meldung file: table is full?
-Diese Fehlermeldung besagt, dass die zur Verfügung stehenden Datei-Deskriptoren des Systems aufgebraucht sind. Was das genau bedeutet und wie Sie dieses Problem lösen können, steht im Abschnitt link:{handbook}#kern-maxfiles[kern.maxfiles] im Kapitel link:{handbook}#configtuning-kernel-limits/[Einstellungen von Kernel Limits] des Handbuchs.
+Diese Fehlermeldung besagt, dass die zur Verfügung stehenden Datei-Deskriptoren des Systems aufgebraucht sind. Was das genau bedeutet und wie Sie dieses Problem lösen können, steht im Abschnitt extref:{handbook}config-tuning[kern.maxfiles, kern-maxfiles] im Kapitel extref:{handbook}config-tuning/[Einstellungen von Kernel Limits, configtuning-kernel-limits] des Handbuchs.
=== Warum ist die Uhrzeit auf meinem Rechner immer falsch?
@@ -830,8 +816,8 @@ FreeBSD unterstützt für die Installation komprimierte Binärpakete und Ports.
Die folgenden Methoden können verwendet werden:
-* In den meisten Situationen sollten Sie portsnap benutzen. Der Abschnitt link:{handbook}#ports-using/[Benutzen der Ports-Sammlung] beschreibt die Verwendung dieses Werkzeugs.
-* Verwenden Sie SVN, wenn Sie bestimmte Patches für den Portsbaum benötigen. Lesen Sie link:{handbook}#svn/[Benutzen von Subversion] für weitere Informationen.
+* In den meisten Situationen sollten Sie portsnap benutzen. Der Abschnitt extref:{handbook}ports/[Benutzen der Ports-Sammlung, ports-using] beschreibt die Verwendung dieses Werkzeugs.
+* Verwenden Sie SVN, wenn Sie bestimmte Patches für den Portsbaum benötigen. Lesen Sie extref:{handbook}mirrors/[Benutzen von Subversion, svn] für weitere Informationen.
=== Unterstützt FreeBSD Java?
@@ -839,7 +825,7 @@ Ja. Lesen Sie https://www.FreeBSD.org/java/[http://www.FreeBSD.org/java/] für w
=== Warum kann ich manche Ports auf meiner 9.X oder 10.X-STABLE-Maschine nicht erstellen?
-Wenn Sie eine FreeBSD-Version benutzen, die deutlich älter als das aktuelle _-CURRENT_ oder _-STABLE_ ist, könnte es sein, dass Sie zunächst die Ports-Sammlung aktualisieren müssen. Lesen Sie dazu link:{handbook}#ports-using/[Benutzen der Ports-Sammlung]. Ist die Ports-Sammlung aktuell, könnte es sein, dass jemand eine Änderung am Port durchgeführt hat, die für _-CURRENT_ funktioniert, den Port für _-STABLE_ aber unbrauchbar gemacht hat. Bitte senden Sie einen https://bugs.FreeBSD.org/submit/[Fehlerbericht]. Von der Ports-Sammlung wird nämlich erwartet, dass sie sowohl auf _-CURRENT_ als auch auf _-STABLE_ funktioniert.
+Wenn Sie eine FreeBSD-Version benutzen, die deutlich älter als das aktuelle _-CURRENT_ oder _-STABLE_ ist, könnte es sein, dass Sie zunächst die Ports-Sammlung aktualisieren müssen. Lesen Sie dazu extref:{handbook}ports/[Benutzen der Ports-Sammlung, ports-using]. Ist die Ports-Sammlung aktuell, könnte es sein, dass jemand eine Änderung am Port durchgeführt hat, die für _-CURRENT_ funktioniert, den Port für _-STABLE_ aber unbrauchbar gemacht hat. Bitte senden Sie einen https://bugs.FreeBSD.org/submit/[Fehlerbericht]. Von der Ports-Sammlung wird nämlich erwartet, dass sie sowohl auf _-CURRENT_ als auch auf _-STABLE_ funktioniert.
=== Ich habe gerade versucht, INDEX mit make index zu bauen, und es hat nicht geklappt. Woran liegt das?
@@ -849,7 +835,7 @@ Es gibt seltene Fälle, in denen [.filename]#INDEX# nicht gebaut werden kann, we
=== Ich habe die Quellen aktualisiert, wie aktualisiere ich jetzt die installierten Ports?
-FreeBSD enthält zwar kein Programm, das die installierten Ports aktualisiert, allerdings existieren diverse Programme, die diesen Prozess etwas vereinfachen. Weiterhin können Sie zusätzliche Programme installieren, die Sie dabei unterstützen. Lesen Sie das Kapitel link:{handbook}#ports-using/[Benutzen der Ports-Sammlung] im FreeBSD Handbuch.
+FreeBSD enthält zwar kein Programm, das die installierten Ports aktualisiert, allerdings existieren diverse Programme, die diesen Prozess etwas vereinfachen. Weiterhin können Sie zusätzliche Programme installieren, die Sie dabei unterstützen. Lesen Sie das Kapitel extref:{handbook}ports/[Benutzen der Ports-Sammlung, ports-using] im FreeBSD Handbuch.
=== Muss ich nach der Aktualisierung einer FreeBSD-Hauptversion jedes Mal alle Ports neu erstellen?
@@ -857,7 +843,7 @@ Ja! Obwohl ein aktuelles System mit Software für eine ältere Version funktioni
Wenn das System aktualisiert wird, werden verschiedene Shared-Libraries, ladbare Module und andere Systembestandteile durch neuere Versionen ersetzt. Anwendungen, die gegen die älteren Versionen gelinkt sind, werden nicht starten oder in anderen Fällen nicht korrekt funktionieren.
-Für weitere Informationen lesen Sie den Abschnitt link:{handbook}#freebsdupdate-upgrade[FreeBSD-Update] im FreeBSD Handbuch.
+Für weitere Informationen lesen Sie den Abschnitt extref:{handbook}updating-upgrading[FreeBSD-Update, freebsdupdate-upgrade] im FreeBSD Handbuch.
=== Muss ich nach der Aktualisierung einer FreeBSD-Unterversion jedes Mal alle Ports neu erstellen?
@@ -878,14 +864,14 @@ Installieren Sie zuerst den Port package:audio/timidity[]. Danach müssen Sie ma
% timidity -Ow -s 44100 -o /tmp/juke/01.wav 01.mid
....
-Die WAV-Dateien können dann in andere Formate konvertiert werden oder (wie im link:{handbook}#creating-cds/[FreeBSD Handbuch]. beschrieben) auf Audio-CDs gebrannt werden.
+Die WAV-Dateien können dann in andere Formate konvertiert werden oder (wie im extref:{handbook}disks/[FreeBSD Handbuch, creating-cds]. beschrieben) auf Audio-CDs gebrannt werden.
== Kernelkonfiguration
[[make-kernel]]
=== Ich möchte meinen Kernel anpassen. Ist das schwierig?
-Überhaupt nicht! Lesen Sie den link:{handbook}#kernelconfig/[Abschnitt zur Kernelkonfiguration im Handbuch].
+Überhaupt nicht! Lesen Sie den extref:{handbook}kernelconfig/[Abschnitt zur Kernelkonfiguration im Handbuch].
[NOTE]
====
@@ -931,7 +917,7 @@ Ersetzen Sie _accf_httpd ipfw_ durch die gewünschten Module. Nur aufgelistete M
Um die Größe des Kernels weiter zu reduzieren, können nicht benötigte Geräte aus dem Kernel entfernt werden. <<make-kernel>> enthält weitere Informationen.
-Um eine dieser Optionen in Kraft zu setzen, folgen Sie den Anweisungen zum link:{handbook}#kernelconfig-building/[Erstellen und Installieren] eines neuen Kernels.
+Um eine dieser Optionen in Kraft zu setzen, folgen Sie den Anweisungen zum extref:{handbook}kernelconfig/[Erstellen und Installieren, kernelconfig-building] eines neuen Kernels.
Der FreeBSD 11 amd64 Kernel ([.filename]#/boot/kernel/kernel#) ist circa 25 MB groß.
@@ -961,7 +947,7 @@ kern.sched.name: ULE
=== Wie kann ich meine neue Festplatte in mein FreeBSD-System einbinden?
-Lesen Sie den Abschnitt link:{handbook}#disks-adding/[Hinzufügen von Laufwerken] im Handbuch.
+Lesen Sie den Abschnitt extref:{handbook}disks/[Hinzufügen von Laufwerken, disks-adding] im Handbuch.
=== Wie verschiebe ich mein System auf meine neue, große Platte?
@@ -1068,7 +1054,7 @@ Die erweiterten DOS-Partitionen befinden sich hinter _allen_ primären Partition
=== Gibt es ein verschlüsselndes Dateisystem für FreeBSD?
-Ja. man:gbde[8] und man:geli[8]. Lesen Sie dazu auch den Abschnitt link:{handbook}#disks-encrypting/[Partitionen verschlüsseln] im FreeBSD Handbuch.
+Ja. man:gbde[8] und man:geli[8]. Lesen Sie dazu auch den Abschnitt extref:{handbook}disks/[Partitionen verschlüsseln, disks-encrypting] im FreeBSD Handbuch.
=== Wie boote ich FreeBSD und Linux mit GRUB?
@@ -1134,23 +1120,23 @@ Es ist eine gute Idee einen Eintrag in [.filename]#/etc/fstab# hinzuzufügen (si
=== Wieso erhalte ich die Meldung Incorrect super block beim Mounten einer CD?
-Sie müssen man:mount[8] mitteilen, was für ein Gerät Sie mounten wollen. Genauere Informationen dazu finden Sie im Abschnitt link:{handbook}#mounting-cd[Einhängen von Daten-CDs] des Handbuchs.
+Sie müssen man:mount[8] mitteilen, was für ein Gerät Sie mounten wollen. Genauere Informationen dazu finden Sie im Abschnitt extref:{handbook}disks[Einhängen von Daten-CDs, mounting-cd] des Handbuchs.
=== Wieso erhalte ich die Meldung Device not configured, wenn ich eine CD mounte?
-Das bedeutet im allgemeinen, dass sich keine CD im Laufwerk befindet, oder dass das Laufwerk auf dem Bus nicht sichtbar ist. Dieses Problem wird im Kapitel link:{handbook}#mounting-cd[Einhängen von Daten-CDs] des Handbuchs ausführlich diskutiert.
+Das bedeutet im allgemeinen, dass sich keine CD im Laufwerk befindet, oder dass das Laufwerk auf dem Bus nicht sichtbar ist. Dieses Problem wird im Kapitel extref:{handbook}disks[Einhängen von Daten-CDs, mounting-cd] des Handbuchs ausführlich diskutiert.
=== Wieso werden alle Sonderzeichen in den Dateinamen auf meinen CDs durch ? ersetzt, wenn ich die CD unter FreeBSD benutze?
-Wahrscheinlich werden auf der CD-ROM die "Joliet" Erweiterungen für die Speicherung von Datei- und Verzeichnisnamen benutzt. Werfen Sie einen Blick in das Kapitel link:{handbook}#mounting-cd[Einhängen von Daten-CDs] im Handbuch.
+Wahrscheinlich werden auf der CD-ROM die "Joliet" Erweiterungen für die Speicherung von Datei- und Verzeichnisnamen benutzt. Werfen Sie einen Blick in das Kapitel extref:{handbook}disks[Einhängen von Daten-CDs, mounting-cd] im Handbuch.
=== Ich habe eine CD mit FreeBSD gebrannt und kann sie nicht mit anderen Betriebssystemen lesen. Warum?
-Sie haben wahrscheinlich eine Datei direkt auf CD geschrieben, statt ein ISO 9660-Dateisystem erzeugt zu haben. Werfen Sie einen Blick in das Kapitel link:{handbook}#mounting-cd[Einhängen von Daten-CDs] im Handbuch.
+Sie haben wahrscheinlich eine Datei direkt auf CD geschrieben, statt ein ISO 9660-Dateisystem erzeugt zu haben. Werfen Sie einen Blick in das Kapitel extref:{handbook}disks[Einhängen von Daten-CDs, mounting-cd] im Handbuch.
=== Wie kann ich ein Image einer Daten-CD erzeugen?
-Diese Information finden Sie im Abschnitt link:{handbook}#mkisofs[Daten auf ein ISO-Dateisystem schreiben] des Handbuchs. Weitere Informationen über die Arbeit mit CD-ROMs finden Sie im Abschnitt link:{handbook}#creating-cds/[Erstellen und Verwenden von CDs] im Kapitel Speichermedien des Handbuchs.
+Diese Information finden Sie im Abschnitt extref:{handbook}disks[Daten auf ein ISO-Dateisystem schreiben, mkisofs] des Handbuchs. Weitere Informationen über die Arbeit mit CD-ROMs finden Sie im Abschnitt extref:{handbook}disks/[Erstellen und Verwenden von CDs, creating-cds] im Kapitel Speichermedien des Handbuchs.
=== Wieso kommt mount nicht mit einer Audio-CD zurecht?
@@ -1216,7 +1202,7 @@ Bitte beachten Sie, dass die Freigabe des Plattenplatzes durch Soft Updates um b
=== Wie kann ich den Swap-Bereich vergrößern?
-Der Abschnitt link:{handbook}#adding-swap-space/[Hinzufügen von Swap-Bereichen] im Handbuch enthält hierzu eine Schritt-für-Schritt Anleitung.
+Der Abschnitt extref:{handbook}config-tuning/[Hinzufügen von Swap-Bereichen, adding-swap-space] im Handbuch enthält hierzu eine Schritt-für-Schritt Anleitung.
=== Warum ist meine Festplatte unter FreeBSD kleiner, als sie laut Hersteller sein soll?
@@ -1351,11 +1337,11 @@ Sobald Sie diese Schritte ausgeführt haben, können Sie den Fehler in [.filenam
=== Wieso habe ich habe Probleme, meinen Drucker einzurichten?
-Lesen Sie zur Problembehandlung das Kapitel link:{handbook}#printing/[Drucken] im Handbuch.
+Lesen Sie zur Problembehandlung das Kapitel extref:{handbook}printing/[Drucken] im Handbuch.
=== Wie kann ich die Tastaturbelegung meines Systems korrigieren?
-Informationen dazu finden Sie im Kapitel link:{handbook}#using-localization/[Lokalisierung] des Handbuchs, insbesondere im Abschnitt link:{handbook}#setting-console[Einrichten der Konsole].
+Informationen dazu finden Sie im Kapitel extref:{handbook}l10n/[Lokalisierung, using-localization] des Handbuchs, insbesondere im Abschnitt extref:{handbook}l10n[Einrichten der Konsole, setting-console].
=== Wieso funktionieren die Benutzer-Quotas nicht richtig?
@@ -1367,7 +1353,7 @@ options QUOTA
....
+
-Weitere Informationen zum Einsatz von Quotas finden Sie im Abschnitt link:{handbook}#quotas/[Disk Quotas] des Handbuchs.
+Weitere Informationen zum Einsatz von Quotas finden Sie im Abschnittextref:{handbook}disks/[Disk Quotas, quotas] des Handbuchs.
. Benutzen Sie keine Quotas für [.filename]#/#.
. Erstellen Sie die Quotas-Datei in dem Dateisystem, für das die Quotas gelten sollen:
+
@@ -1415,7 +1401,7 @@ Wenn Sie immer noch dazu aufgefordert werden, das Passwort für `root` beim Betr
[NOTE]
====
-Wenn Sie die Root-Partition im Single-User-Modus nicht mounten können, liegt es möglicherweise daran, dass die Partitionen verschlüsselt sind und es damit unmöglich ist, sie ohne die dazugehörigen Schlüssel zu mounten. Für weitere Informationen lesen Sie den Abschnitt über verschlüsselte Partitionen im FreeBSD link:{handbook}#disks-encrypting/[Handbuch].
+Wenn Sie die Root-Partition im Single-User-Modus nicht mounten können, liegt es möglicherweise daran, dass die Partitionen verschlüsselt sind und es damit unmöglich ist, sie ohne die dazugehörigen Schlüssel zu mounten. Für weitere Informationen lesen Sie den Abschnitt über verschlüsselte Partitionen im FreeBSD extref:{handbook}disks/[Handbuch, disks-encrypting].
====
=== Wie verhindere ich, dass das System mit StrgAltEntf rebootet werden kann?
@@ -1480,7 +1466,7 @@ Ausführliche Antwort: Bei FreeBSD gibt es zwei Quellen für Releases. Die Major
Bevor in einem Zweig ein Release erfolgt, muss in diesem Zweig ein bestimmter Prozess ablaufen. Ein Teil dieses Prozesses ist der "code freeze", der Stop der Weiterentwicklung. Sobald dieser Schritt erfolgt ist, wird der Name des Zweiges geändert, um anzuzeigen, dass demnächst ein Release erfolgen wird. Wenn der Zweig zum Beispiel 6.2-STABLE genannt wurde, wird der Name in 6.3-PRERELEASE geändert, um dies zu verdeutlichen. Weiterhin ist das ein Zeichen, dass jetzt besonders intensiv getestet werden sollte. In dieser Phase können Fehler im Quellcode noch korrigiert werden. Wenn der Quellcode so weit "gereift" ist, dass ein Release erstellt werden kann, wird der Name in 6.3-RC geändert, um genau dies anzuzeigen. In dieser Phase können nur noch extrem wichtige Korrekturen aufgenommen werden. Sobald das Release (in diesem Beispiel 6.3-RELEASE) erfolgt ist, wird der Zweig in 6.3-STABLE umbenannt.
-Weitere Informationen über Versionsnummern und die verschiedenen Entwicklungszweige enthält der Artikel link:{releng}[Release Engineering].
+Weitere Informationen über Versionsnummern und die verschiedenen Entwicklungszweige enthält der Artikel extref:{releng}[Release Engineering].
=== Als ich versucht habe, einen neuen Kernel zu installieren, ist chflags1 fehlgeschlagen. Was mache ich jetzt?
@@ -1578,7 +1564,7 @@ Sie können Xorg auch als Paket installieren:
# pkg install xorg
....
-Lesen Sie nach erfolgreicher Installation von Xorg den Abschnitt link:{handbook}#x-config/[X11 konfigurieren] im FreeBSD Handbuch.
+Lesen Sie nach erfolgreicher Installation von Xorg den Abschnitt extref:{handbook}x11/[X11 konfigurieren, x-config] im FreeBSD Handbuch.
=== Ich habe versucht, X zu starten, aber wenn ich startx eingebe, erhalte ich die Fehlermeldung No devices detected.. Was soll ich jetzt machen?
@@ -1792,7 +1778,7 @@ Geben Sie `xmodmap -e "pointer = 3 2 1"` ein. Fügen Sie dieses Kommando in [.fi
=== Wie installiere ich einen Splash-Screen und wo finde ich sie?
-Die detaillierte Antwort auf diese Frage finden Sie im Abschnitt link:{handbook}#boot-splash/[Willkommensbildschirme während des Bootvorgangs konfigurieren] des FreeBSD Handbuchs.
+Die detaillierte Antwort auf diese Frage finden Sie im Abschnitt extref:{handbook}boot/[Willkommensbildschirme während des Bootvorgangs konfigurieren, boot-splash] des FreeBSD Handbuchs.
=== Kann ich die Windows-Tasten unter X benutzen?
@@ -1858,29 +1844,29 @@ Bei ATI Rage 128 und Radeon lesen Sie man:ati[4], man:r128[4] und man:radeon[4].
=== Woher kann ich Informationen über Diskless Booting bekommen?
-"Diskless Booting" bedeutet, dass die FreeBSD-Maschine über ein Netzwerk gebootet wird und die notwendigen Dateien von einem Server anstatt von der Festplatte liest. Vollständige Details finden Sie im link:{handbook}#network-diskless/[Handbucheintrag über den plattenlosen Betrieb].
+"Diskless Booting" bedeutet, dass die FreeBSD-Maschine über ein Netzwerk gebootet wird und die notwendigen Dateien von einem Server anstatt von der Festplatte liest. Vollständige Details finden Sie im extref:{handbook}advanced-networking/[Handbucheintrag über den plattenlosen Betrieb, network-diskless].
=== Kann eine FreeBSD-Maschine als Netzwerkrouter genutzt werden?
-Ja. Genaue Informationen zu diesem Thema finden Sie im Abschnitt link:{handbook}#network-routing/[Gateways und Routen] des Handbuchkapitels link:{handbook}#advanced-networking/[Weiterführende Netzwerkthemen].
+Ja. Genaue Informationen zu diesem Thema finden Sie im Abschnitt extref:{handbook}advanced-networking/[Gateways und Routen, network-routing] des Handbuchkapitels extref:{handbook}advanced-networking/[Weiterführende Netzwerkthemen, advanced-networking].
=== Kann ich meine Windows-Maschine über FreeBSD ans Internet anbinden?
Personen, die diese Frage stellen, haben typischerweise zwei PCs zu Hause: einen mit FreeBSD und einen mit einer Windows(TM)-Variante. Die Idee ist, die FreeBSD-Maschine an das Internet anzubinden, um in der Lage zu sein, von der Windows(TM)-Maschine über die FreeBSD-Maschine auf das Internet zuzugreifen. Das ist tatsächlich nur ein Spezialfall der vorherigen Frage.
-Wenn Sie eine Einwahlverbindung benutzen, müssen Sie `ppp` mit der Option `-nat` verwenden und in [.filename]#/etc/rc.conf# die Variable `gateway_enable` auf _YES_ setzen. Weitere Informationen erhalten Sie in man:ppp[8] oder im Abschnitt link:{handbook}#userppp/[User-PPP des Handbuchs].
+Wenn Sie eine Einwahlverbindung benutzen, müssen Sie `ppp` mit der Option `-nat` verwenden und in [.filename]#/etc/rc.conf# die Variable `gateway_enable` auf _YES_ setzen. Weitere Informationen erhalten Sie in man:ppp[8] oder im Abschnitt extref:{handbook}ppp-and-slip/[User-PPP des Handbuchs, userppp].
-Wenn die Verbindung zum Internet über Ethernet erstellt wurde, müssen Sie man:natd[8] benutzen. Weitere Informationen dazu finden Sie im Abschnitt link:{handbook}#network-natd[natd] des Handbuchs.
+Wenn die Verbindung zum Internet über Ethernet erstellt wurde, müssen Sie man:natd[8] benutzen. Weitere Informationen dazu finden Sie im Abschnitt extref:{handbook}[natd, network-natd] des Handbuchs.
=== Unterstützt FreeBSD und PPP?
Ja. man:ppp[8] bietet Unterstützung für eingehende und ausgehende Verbindungen.
-Weitere Informationen finden Sie im link:{handbook}#ppp-and-slip/[Kapitel PPP im Handbuch].
+Weitere Informationen finden Sie im extref:{handbook}ppp-and-slip/[Kapitel PPP im Handbuch, ppp-and-slip].
=== Unterstützt FreeBSD NAT oder Masquerading?
-Ja. Wenn Sie NAT über eine User-PPP-Verbindung einsetzen wollen, lesen Sie den link:{handbook}#userppp/[Abschnitt PPP des Handbuchs]. Wollen Sie NAT über eine andere Verbindung einsetzen, lesen Sie bitte den Abschnitt link:{handbook}#network-natd/[NAT Konfiguration] im Handbuch.
+Ja. Wenn Sie NAT über eine User-PPP-Verbindung einsetzen wollen, lesen Sie den extref:{handbook}ppp-and-slip/[Abschnitt PPP des Handbuchs, userppp]. Wollen Sie NAT über eine andere Verbindung einsetzen, lesen Sie bitte den Abschnitt extref:{handbook}/[NAT Konfiguration, network-natd] im Handbuch.
=== Wie kann ich Ethernet-Aliase einrichten?
@@ -1898,7 +1884,7 @@ Andernfalls geben sie die Adresse und die Netzmaske wie gewohnt an:
# ifconfig ed0 alias 172.16.141.5 netmask 0xffffff00
....
-Weitere Informationen finden Sie im FreeBSD link:{handbook}#configtuning-virtual-hosts/[Handbuch].
+Weitere Informationen finden Sie im FreeBSD extref:{handbook}config-tuning/[Handbuch, configtuning-virtual-hosts].
=== Warum kann ich per NFS nicht von einer Linux-Maschine mounten?
@@ -1911,7 +1897,7 @@ Einige Versionen des Linux(TM) NFS-Codes akzeptieren Mount-Anfragen nur von eine
=== Warum meldet mir mountd auf meinem FreeBSD NFS-Server ständig can't change attributes und bad exports list?
-Die häufigste Ursache für dieses Problem ist, dass Sie den Aufbau der [.filename]#/etc/exports# nicht richtig verstanden haben. Lesen Sie man:exports[5] und das Kapitel link:{handbook}#network-nfs/[NFS] im Handbuch, speziell den Abschnitt link:{handbook}#configuring-nfs[Konfiguration von NFS].
+Die häufigste Ursache für dieses Problem ist, dass Sie den Aufbau der [.filename]#/etc/exports# nicht richtig verstanden haben. Lesen Sie man:exports[5] und das Kapitel extref:{handbook}network-servers/[NFS, network-nfs] im Handbuch, speziell den Abschnitt extref:{handbook}[Konfiguration von NFS, configuring-nfs].
=== Wie aktiviere ich die Unterstützung für IP-Multicast?
@@ -1919,7 +1905,7 @@ Installieren Sie das Paket oder den Port package:net/mrouted[] und fügen Sie `m
=== Warum muss ich für Hosts auf meiner Site den FQDN benutzen?
-Die Antwort hierzu finden Sie im FreeBSD link:{handbook}#mail-trouble[Handbuch].
+Die Antwort hierzu finden Sie im FreeBSD extref:{handbook}mail[Handbuch, mail-trouble].
=== Wieso erhalte ich bei allen Netzwerkoperationen die Meldung Permission denied?
@@ -1934,7 +1920,7 @@ Wenn die Firewall unabsichtlich falsch konfiguriert wurde, stellen Sie die Netzw
Sie können in [.filename]#/etc/rc.conf# auch `firewall_type="open"` setzen.
-Weitere Informationen über die Konfiguration dieser Firewall finden Sie im Kapitel link:{handbook}#firewalls-ipfw/[IPFW] des Handbuchs.
+Weitere Informationen über die Konfiguration dieser Firewall finden Sie im Kapitel extref:{handbook}firewalls/[IPFW, firewalls-ipfw] des Handbuchs.
=== Warum kann ich mit ipfw einen Dienst nicht mit fwd auf eine andere Maschine umlenken?
@@ -2093,7 +2079,7 @@ Einige Anwender benutzen `toor` mit einer alternativen Shell für die tägliche
=== Ich bekomme ppp8 nicht zum Laufen. Was mache ich falsch?
-Lesen Sie zuerst man:ppp[8] und den link:{handbook}#userppp[Abschnitt zu PPP im Handbuch]. Aktivieren Sie zur Fehlersuche die Protokollierung mit folgendem Befehl:
+Lesen Sie zuerst man:ppp[8] und den extref:{handbook}ppp-and-slip[Abschnitt zu PPP im Handbuch, userppp]. Aktivieren Sie zur Fehlersuche die Protokollierung mit folgendem Befehl:
[.programlisting]
....
@@ -2143,7 +2129,7 @@ Ein weiterer Grund dafür, dass die Zeile für die Standardroute fehlt, könnte
delete ALL
....
-Lesen Sie in diesem Fall den Abschnitt link:{handbook}#userppp-final[Abschließende Systemkonfiguration] des Handbuchs.
+Lesen Sie in diesem Fall den Abschnitt extref:{handbook}ppp-and-slip[Abschließende Systemkonfiguration, userppp-final] des Handbuchs.
=== Was bedeutet No route to host?
@@ -2164,7 +2150,7 @@ delete ALL
add 0 0 HISADDR
....
-Weitere Informationen finden Sie im Abschnitt link:{handbook}#userppp-dynamicip[PPP und Dynamische IP-Adressen] des Handbuchs.
+Weitere Informationen finden Sie im Abschnitt extref:{handbook}[PPP und Dynamische IP-Adressen, userppp-dynamicip] des Handbuchs.
=== Wieso werden meine Verbindungen nach ca. drei Minuten beendet?
@@ -2339,7 +2325,7 @@ set dfilter 3 permit 0/0 0/0
Dies ist nicht immer brauchbar, weil es effektiv die Fähigkeit, auf Anforderung wählen zu können einschränkt - die meisten Programme müssen eine DNS-Anfrage durchführen, bevor Sie andere, das Netzwerk betreffenden Dinge tun können.
-Im Fall von DNS sollten Sie versuchen, herauszufinden, welches Programm tatsächlich versucht, einen Hostnamen aufzulösen. Sehr oft handelt es sich hier um Sendmail. Sie sollten sicherstellen, dass Sie Sendmail in der Konfigurationsdatei sagen, dass es keine DNS-Anfragen durchführen soll. Weitere Details enthält der Abschnitt link:{handbook}#smtp-dialup/[E-Mail über Einwahl-Verbindungen] des Handbuchs. Sie könnten z.B. die folgende Zeile in die [.filename]#.mc#-Datei einfügen:
+Im Fall von DNS sollten Sie versuchen, herauszufinden, welches Programm tatsächlich versucht, einen Hostnamen aufzulösen. Sehr oft handelt es sich hier um Sendmail. Sie sollten sicherstellen, dass Sie Sendmail in der Konfigurationsdatei sagen, dass es keine DNS-Anfragen durchführen soll. Weitere Details enthält der Abschnitt extref:{handbook}mail/[E-Mail über Einwahl-Verbindungen, smtp-dialup] des Handbuchs. Sie könnten z.B. die folgende Zeile in die [.filename]#.mc#-Datei einfügen:
[.programlisting]
....
@@ -2448,7 +2434,7 @@ Dieses Kapitel beantwortet häufig gestellte Fragen zu seriellen Verbindungen mi
=== Welche seriellen Multi-Port-Karten werden von FreeBSD unterstützt?
-Es existiert eine Liste der unterstützten Karten im Abschnitt link:{handbook}#serial/[Serielle Datenübertragung] des Handbuchs.
+Es existiert eine Liste der unterstützten Karten im Abschnitt extref:{handbook}serialcomms/[Serielle Datenübertragung, serial] des Handbuchs.
Die meisten auf den 16550 basierten PCI Multi-Port-Karten werden mühelos unterstützt.
@@ -2458,7 +2444,7 @@ In man:uart[4] und man:sio[4] finden Sie weitere Informationen zur Konfiguration
=== Wie kann ich den boot:-Prompt auf einer seriellen Konsole anzeigen lassen?
-Lesen Sie link:{handbook}#serialconsole-setup/[diesen Abschnitt] des Handbuchs.
+Lesen Sie extref:{handbook}serialcomms/[diesen Abschnitt, serialconsole-setup] des Handbuchs.
=== Wie kann ich feststellen, ob FreeBSD meine seriellen Schnittstellen oder Modemkarten gefunden hat?
@@ -2515,15 +2501,15 @@ Die Flags zeigen an, dass die Master-Schnittstelle die Minor-Nummer `7` (`0x700`
=== Kann ich die vorgegebenen seriellen Parameter für eine Schnittstelle einstellen?
-See the link:{handbook}#serial-hw-config[Serial Communications] section in the FreeBSD Handbook.
+See the extref:{handbook}serialcomms[Serial Communications, serial-hw-config] section in the FreeBSD Handbook.
=== Wie kann ich Einwahl-Logins über mein Modem aktivieren?
-Lesen Sie dazu den Abschnitt über link:{handbook}#dialup/[Einwählverbindungen] im FreeBSD Handbuch.
+Lesen Sie dazu den Abschnitt über extref:{handbook}serialcomms/[Einwählverbindungen, dialup] im FreeBSD Handbuch.
=== Wie kann ich ein Hardware-Terminal mit meiner FreeBSD Box verbinden?
-Diese Information finden Sie im Abschnitt link:{handbook}#term/[Terminals] im FreeBSD Handbuch.
+Diese Information finden Sie im Abschnitt extref:{handbook}serialcomms/[Terminals, term] im FreeBSD Handbuch.
=== Warum kann ich tip oder cu nicht laufen lassen?
@@ -2585,7 +2571,7 @@ Die Ports-Sammlung enthält auch package:emulators/dosbox[]. Das Hauptaugenmerk
=== Was muss ich tun, um die FreeBSD-Dokumentation in meine Muttersprache zu übersetzen?
-Lesen Sie die link:{fdp-primer}#translations/[Translation FAQ] im FreeBSD Documentation Project Primer.
+Lesen Sie die extref:{fdp-primer}[Translation FAQ, translations] im FreeBSD Documentation Project Primer.
=== Warum kommen alle meine Mails, die ich an FreeBSD.org schicke, wieder zurück?
@@ -2625,7 +2611,7 @@ Einige Bilder in den Formaten Xfig und eps sind unter [.filename]#/usr/shared/ex
=== Ich habe in den Mailinglisten eine Abkürzung oder einen Begriff gesehen, den ich nicht kenne. Wo erhalte ich eine Erklärung dazu?
-Sehen Sie im link:{handbook}#freebsd-glossary[FreeBSD-Glossar] nach.
+Sehen Sie im extref:{handbook}glossary[FreeBSD-Glossar, freebsd-glossary] nach.
=== Warum sollte mich die Farbe des Fahrradschuppens interessieren?
@@ -2756,13 +2742,13 @@ Installieren Sie auf dem Rechner Ihres Kollegen package:games/sl[] und warten Si
=== Wie kann ich mehr über die Interna von FreeBSD erfahren?
-Lesen Sie das link:{arch-handbook}[FreeBSD Architecture Handbook].
+Lesen Sie das extref:{arch-handbook}[FreeBSD Architecture Handbook].
Allgemeines Wissen über UNIX(TM) kann allerdings in den meisten Fällen auf FreeBSD angewendet werden.
=== Wie kann ich bei der Entwicklung von FreeBSD mithelfen?
-Genauere Informationen finden Sie im Artikel link:{contributing}[FreeBSD unterstützen]. Wir können Hilfe immer gut gebrauchen!
+Genauere Informationen finden Sie im Artikel extref:{contributing}[FreeBSD unterstützen]. Wir können Hilfe immer gut gebrauchen!
=== Was sind Snapshots und Releases?
@@ -2778,7 +2764,7 @@ Derzeit steht _-CURRENT_ für den 11._X_-Entwicklungsstrom. Der _10-STABLE_-Zwei
=== Ich habe eine Kernelerweiterung geschrieben. An wen sende ich sie?
-Lesen Sie den Artikel link:{contributing}[FreeBSD unterstützen].
+Lesen Sie den Artikel extref:{contributing}[FreeBSD unterstützen].
Und Danke, dass Sie darüber nachdenken!
@@ -2922,7 +2908,7 @@ Um den richtigen Wert von _N_ zu bestimmen, teilen Sie den gewünschte Größe d
Dieses kleine unschuldige Dokument mit Häufig gestellten Fragen wurde die letzten Jahrzehnte von Hunderten, wenn nicht Tausenden, geschrieben, neu geschrieben, überarbeitet, gefaltet, verdreht, durcheinander gebracht, wieder aufgebaut, verstümmelt, seziert, durchgekaut, überdacht, und wiederbelebt. Und das nicht nur einmal.
-Wir möchten allen dafür Verantwortlichen danken und wir fordern auch Sie auf, link:{contributing}[dieser Gruppe beizutreten], um diese FAQ noch besser zu machen.
+Wir möchten allen dafür Verantwortlichen danken und wir fordern auch Sie auf, extref:{contributing}[dieser Gruppe beizutreten], um diese FAQ noch besser zu machen.
[bibliography]
[[bibliography]]
diff --git a/documentation/content/de/books/handbook/_index.adoc b/documentation/content/de/books/handbook/_index.adoc
index b367738d7f..305d6ccfdd 100644
--- a/documentation/content/de/books/handbook/_index.adoc
+++ b/documentation/content/de/books/handbook/_index.adoc
@@ -3,9 +3,9 @@ title: FreeBSD Handbuch
authors:
- author: The FreeBSD Documentation Project
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
next: books/handbook/preface
+isIndex: true
---
= FreeBSD Handbuch
@@ -13,30 +13,39 @@ next: books/handbook/preface
:toc: macro
:toclevels: 1
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhaltsverzeichnis
-:part-signifier: Teil
-:chapter-signifier: Kapitel
-:appendix-caption: Anhang
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: books/handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Zusammenfassung
-Willkommen bei FreeBSD! Dieses Handbuch beschreibt die Installation und den täglichen Umgang mit _FreeBSD {rel121-current}-RELEASE_, _FreeBSD {rel113-current}-RELEASE_. Das Handbuch ist das Ergebnis einer fortlaufenden Arbeit vieler Einzelpersonen. Dies kann dazu führen, dass einige Abschnitte nicht aktuell sind. Bei Unklarheiten empfiehlt es sich daher stets, die link:{handbook}[englische Originalversion] des Handbuchs zu lesen.
+Willkommen bei FreeBSD! Dieses Handbuch beschreibt die Installation und den täglichen Umgang mit _FreeBSD {rel121-current}-RELEASE_, _FreeBSD {rel113-current}-RELEASE_. Das Handbuch ist das Ergebnis einer fortlaufenden Arbeit vieler Einzelpersonen. Dies kann dazu führen, dass einige Abschnitte nicht aktuell sind. Bei Unklarheiten empfiehlt es sich daher stets, die extref:{handbook}[englische Originalversion] des Handbuchs zu lesen.
Wenn Sie bei der Übersetzung des Handbuchs mithelfen möchten, senden Sie bitte eine E-Mail an die Mailingliste {de-doc}.
@@ -44,10 +53,10 @@ Die aktuelle Version des Handbuchs ist immer auf dem https://www.FreeBSD.org/[Fr
'''
-include::content/de/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
-include::content/de/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
-include::content/de/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
-include::content/de/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/de/books/handbook/advanced-networking/_index.adoc b/documentation/content/de/books/handbook/advanced-networking/_index.adoc
index 3047f6fac5..28cd0a5e9b 100644
--- a/documentation/content/de/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/de/books/handbook/advanced-networking/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/partv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 31
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 31
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[advanced-networking-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/audit/_index.adoc b/documentation/content/de/books/handbook/audit/_index.adoc
index af9d40ae77..701726832a 100644
--- a/documentation/content/de/books/handbook/audit/_index.adoc
+++ b/documentation/content/de/books/handbook/audit/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/disks
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[audit-synopsis]]
== Einleitung
diff --git a/documentation/content/de/books/handbook/basics/_index.adoc b/documentation/content/de/books/handbook/basics/_index.adoc
index 195d22a1ef..9b1d822bdb 100644
--- a/documentation/content/de/books/handbook/basics/_index.adoc
+++ b/documentation/content/de/books/handbook/basics/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/ports
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[basics-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/bibliography/_index.adoc b/documentation/content/de/books/handbook/bibliography/_index.adoc
index 6a5b5e937e..06e356213b 100644
--- a/documentation/content/de/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/de/books/handbook/bibliography/_index.adoc
@@ -9,25 +9,40 @@ next: books/handbook/eresources
[[bibliography]]
= Bibliografie
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Während die Manualpages eine definitive Referenz über bestimmte Teile des FreeBSD-Betriebssystems bieten, so können sie jedoch selten veranschaulichen, wie man die einzelnen Teile zusammenfügt, um ein vollständig laufendes Betriebssystem herzustellen. Daher gibt es keinen Ersatz für ein gutes Buch oder Benutzerhandbuch über die Administration von UNIX(R)-Systemen.
@@ -101,7 +116,7 @@ Eine https://www.FreeBSD.org/doc/it_IT.ISO8859-15/books/unix-introduction/index.
* Jolitz, William. "Porting UNIX to the 386". _Dr. Dobb's Journal_. January 1991-July 1992.
* Leffler, Samuel J., Marshall Kirk McKusick, Michael J Karels and John Quarterman _The Design and Implementation of the 4.3BSD UNIX Operating System_. Reading, Mass. : Addison-Wesley, 1989. ISBN 0-201-06196-1
+
-Kapitel 2 dieses Buchs ist Teil des FreeBSD Documentation Projects und link:{design-44bsd}[online] erhältlich.
+Kapitel 2 dieses Buchs ist Teil des FreeBSD Documentation Projects und extref:{design-44bsd}[online] erhältlich.
* Leffler, Samuel J., Marshall Kirk McKusick, _The Design and Implementation of the 4.3BSD UNIX Operating System: Answer Book_. Reading, Mass. : Addison-Wesley, 1991. ISBN 0-201-54629-9
* McKusick, Marshall Kirk, Keith Bostic, Michael J Karels, and John Quarterman. _The Design and Implementation of the 4.4BSD Operating System_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-54979-4
* Marshall Kirk McKusick, George V. Neville-Neil. _The Design and Implementation of the FreeBSD Operating System_. Boston, Mass. : Addison-Wesley, 2004. ISBN 0-201-70245-2
diff --git a/documentation/content/de/books/handbook/book.adoc b/documentation/content/de/books/handbook/book.adoc
index ebeac83241..eea3a7ae3d 100644
--- a/documentation/content/de/books/handbook/book.adoc
+++ b/documentation/content/de/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: FreeBSD Handbuch
authors:
- author: The FreeBSD Documentation Project
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
---
@@ -12,61 +11,42 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhaltsverzeichnis
-:part-signifier: Teil
-:chapter-signifier: Kapitel
-:appendix-caption: Anhang
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
:book: true
:pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
-:chapters-path: content/de/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/de/mailing-lists.adoc[]
-include::../../../../shared/de/teams.adoc[]
-include::../../../../shared/de/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/de/mailing-lists.adoc[]
-include::../../../../shared/de/teams.adoc[]
-include::../../../../shared/de/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
[abstract]
Zusammenfassung
-Willkommen bei FreeBSD! Dieses Handbuch beschreibt die Installation und den täglichen Umgang mit _FreeBSD {rel121-current}-RELEASE_, _FreeBSD {rel113-current}-RELEASE_. Das Handbuch ist das Ergebnis einer fortlaufenden Arbeit vieler Einzelpersonen. Dies kann dazu führen, dass einige Abschnitte nicht aktuell sind. Bei Unklarheiten empfiehlt es sich daher stets, die link:{handbook}[englische Originalversion] des Handbuchs zu lesen.
+Willkommen bei FreeBSD! Dieses Handbuch beschreibt die Installation und den täglichen Umgang mit _FreeBSD {rel121-current}-RELEASE_, _FreeBSD {rel113-current}-RELEASE_. Das Handbuch ist das Ergebnis einer fortlaufenden Arbeit vieler Einzelpersonen. Dies kann dazu führen, dass einige Abschnitte nicht aktuell sind. Bei Unklarheiten empfiehlt es sich daher stets, die extref:{handbook}[englische Originalversion] des Handbuchs zu lesen.
Wenn Sie bei der Übersetzung des Handbuchs mithelfen möchten, senden Sie bitte eine E-Mail an die Mailingliste {de-doc}.
@@ -78,95 +58,95 @@ toc::[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
// Section one
-include::{chapters-path}parti.adoc[lines=8..18]
+include::{chapters-path}parti.adoc[lines=15..26]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..24;35..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
-include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1]
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=8..18]
+include::{chapters-path}partii.adoc[lines=15..26]
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=8..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}jails/_index.adoc[leveloffset=+1]
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
-include::{chapters-path}zfs/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}zfs/_index.adoc[leveloffset=+1]
-include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}filesystems/_index.adoc[leveloffset=+1]
-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
-include::{chapters-path}dtrace/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}dtrace/_index.adoc[leveloffset=+1]
-include::{chapters-path}usb-device-mode/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}usb-device-mode/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=8..19]
+include::{chapters-path}partiv.adoc[lines=15..27]
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
// Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
:sectnums!:
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..24;33..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..24;32..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..24;33..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..24;34..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/de/books/handbook/boot/_index.adoc b/documentation/content/de/books/handbook/boot/_index.adoc
index dd00ea098b..51fdd15cd3 100644
--- a/documentation/content/de/books/handbook/boot/_index.adoc
+++ b/documentation/content/de/books/handbook/boot/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/security
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/bsdinstall/_index.adoc b/documentation/content/de/books/handbook/bsdinstall/_index.adoc
index fab875854e..52e967fc6b 100644
--- a/documentation/content/de/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/de/books/handbook/bsdinstall/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/basics
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/bsdinstall/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
-endif::[]
+:images-path: books/handbook/bsdinstall/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[bsdinstall-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/config/_index.adoc b/documentation/content/de/books/handbook/config/_index.adoc
index 5ae1e236c3..f516a99115 100644
--- a/documentation/content/de/books/handbook/config/_index.adoc
+++ b/documentation/content/de/books/handbook/config/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/boot
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/config/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[config-synopsis]]
== Übersicht
@@ -285,7 +284,7 @@ Die folgenden Schlüsselwörter können im Kopf des Startskripts angegeben werde
Durch das Verwenden dieser Schlüsselwörter kann ein Administrator die Startreihenfolge von Systemdiensten feingranuliert steuern, ohne mit den Schwierigkeiten des "runlevel"-Systems anderer UNIX(R) Systeme kämpfen zu müssen.
-Weitere Informationen über das man:rc[8]-System finden Sie in man:rc[8] und man:rc.subr[8]. Wenn Sie eigene [.filename]#rc.d#-Skripte schreiben wollen, sollten Sie link:{rc-scripting}[diesen Artikel] lesen.
+Weitere Informationen über das man:rc[8]-System finden Sie in man:rc[8] und man:rc.subr[8]. Wenn Sie eigene [.filename]#rc.d#-Skripte schreiben wollen, sollten Sie extref:{rc-scripting}[diesen Artikel] lesen.
[[configtuning-core-configuration]]
=== Systemspezifische Konfiguration
diff --git a/documentation/content/de/books/handbook/cutting-edge/_index.adoc b/documentation/content/de/books/handbook/cutting-edge/_index.adoc
index 64d12e64fa..22b42f14a3 100644
--- a/documentation/content/de/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/de/books/handbook/cutting-edge/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/dtrace
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[updating-upgrading-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/desktop/_index.adoc b/documentation/content/de/books/handbook/desktop/_index.adoc
index bde4370074..6843127baa 100644
--- a/documentation/content/de/books/handbook/desktop/_index.adoc
+++ b/documentation/content/de/books/handbook/desktop/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/multimedia
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[desktop-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/disks/_index.adoc b/documentation/content/de/books/handbook/disks/_index.adoc
index 71a29caae5..33e29cd15e 100644
--- a/documentation/content/de/books/handbook/disks/_index.adoc
+++ b/documentation/content/de/books/handbook/disks/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/geom
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[disks-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/dtrace/_index.adoc b/documentation/content/de/books/handbook/dtrace/_index.adoc
index 0ad5483e4d..df7e220898 100644
--- a/documentation/content/de/books/handbook/dtrace/_index.adoc
+++ b/documentation/content/de/books/handbook/dtrace/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/usb-device-mode
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/dtrace/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
-endif::[]
+:images-path: books/handbook/dtrace/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dtrace-synopsis]]
== Überblick
diff --git a/documentation/content/de/books/handbook/eresources/_index.adoc b/documentation/content/de/books/handbook/eresources/_index.adoc
index 52ca92dbb1..488512a048 100644
--- a/documentation/content/de/books/handbook/eresources/_index.adoc
+++ b/documentation/content/de/books/handbook/eresources/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/pgpkeys
[[eresources]]
= Ressourcen im Internet
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/bibliography/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Gedruckte Medien können mit der schnellen Entwicklung von FreeBSD nicht Schritt halten. Elektronische Medien sind häufig die einzige Möglichkeit, über aktuelle Entwicklungen informiert zu sein. Da FreeBSD ein Projekt von Freiwilligen ist, gibt die Benutzergemeinde selbst auch technische Unterstützung. Die Benutzergemeinde erreichen Sie am besten über E-Mail, Internetforen oder Usenet-News.
@@ -52,9 +66,9 @@ Die Chartas der verschiedenen Listen sind unten wiedergegeben. _Bevor Sie sich e
_Um zu testen, ob Sie eine Nachricht an eine FreeBSD-Liste senden können, verwenden Sie bitte die Liste {freebsd-test}._ Schicken Sie derartige Nachrichten bitte nicht an eine der anderen Listen.
====
-Wenn Sie Sich nicht sicher sind, auf welcher Liste Sie Ihre Frage stellen sollen, sollten Sie den Artikel link:{freebsd-questions-article}[ How to get best results from the FreeBSD-questions mailing list] lesen.
+Wenn Sie Sich nicht sicher sind, auf welcher Liste Sie Ihre Frage stellen sollen, sollten Sie den Artikel extref:{freebsd-questions-article}[ How to get best results from the FreeBSD-questions mailing list] lesen.
-Bevor Sie eine Nachricht an eine Mailingliste senden, sollten Sie die korrekte Nutzung der Mailinglisten erlernen. Dazu gehört auch das Vermeiden von sich häufig wiederholenden Diskussionen (lesen Sie deshalb zuerst die link:{mailing-list-faq}[ Mailing List Frequently Asked Questions]).
+Bevor Sie eine Nachricht an eine Mailingliste senden, sollten Sie die korrekte Nutzung der Mailinglisten erlernen. Dazu gehört auch das Vermeiden von sich häufig wiederholenden Diskussionen (lesen Sie deshalb zuerst die extref:{mailing-list-faq}[Mailing List Frequently Asked Questions]).
Alle Mailinglisten werden archiviert und können auf dem link:https://www.FreeBSD.org/search/[FreeBSD World Wide Web Server] durchsucht werden. Das nach Schlüsselwörtern durchsuchbare Archiv bietet die hervorragende Möglichkeit, Antworten auf häufig gestellte Fragen zu finden. Nutzen Sie bitte diese Möglichkeit, bevor Sie Fragen auf einer Liste stellen. Beachten Sie auch, dass das zur Folge hat, dass die Nachrichten an die FreeBSD Mailinglisten für die Ewigkeit erhalten bleiben. Wenn Sie am Schutz Ihrer Privatsphäre interessiert sind, ziehen Sie die Verwendung einer Wegwerf-E-Mail-Adresse in Betracht und schreiben Sie nur solche Nachrichten, die für die Öffentlichkeit bestimmt sind.
diff --git a/documentation/content/de/books/handbook/filesystems/_index.adoc b/documentation/content/de/books/handbook/filesystems/_index.adoc
index 3d98f866ce..73743e9503 100644
--- a/documentation/content/de/books/handbook/filesystems/_index.adoc
+++ b/documentation/content/de/books/handbook/filesystems/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/virtualization
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/filesystems/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
-endif::[]
+:images-path: books/handbook/filesystems/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[filesystems-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/firewalls/_index.adoc b/documentation/content/de/books/handbook/firewalls/_index.adoc
index afe1e675db..ca488cbfe0 100644
--- a/documentation/content/de/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/de/books/handbook/firewalls/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/advanced-networking
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 30
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 30
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[firewalls-intro]]
== Einführung
diff --git a/documentation/content/de/books/handbook/geom/_index.adoc b/documentation/content/de/books/handbook/geom/_index.adoc
index 7294119468..51fdd8bf62 100644
--- a/documentation/content/de/books/handbook/geom/_index.adoc
+++ b/documentation/content/de/books/handbook/geom/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/zfs
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[geom-synopsis]]
== Übersicht
@@ -1128,4 +1127,4 @@ Falls auf dem System mehrere Slices angelegt sind (beispielsweise [.filename]#ad
Mit `tunefs` ist es auch möglich, Journaling auf bereits existierenden Dateisystemen zu aktivieren. Machen Sie aber _immer_ eine Sicherung der Daten, bevor Sie versuchen, ein existierendes Dateisystem zu ändern. `gjournal` wird zwar den Vorgang abbrechen, wenn es das Journal nicht erzeugen kann, allerdings schützt dies nicht vor Datenverlust durch einen fehlerhaften Einsatz von `tunefs`. Weitere Informationen über diese beiden Werkzeuge finden Sie in man:gjournal[8] und man:tunefs[8].
-Es ist möglich, Journale auch für die Bootplatte eines FreeBSD-Systems zu verwenden. Der Artikel link:{gjournal-desktop}[ Implementing UFS Journaling on a Desktop PC] enthält eine ausführliche Anleitung zu diesem Thema.
+Es ist möglich, Journale auch für die Bootplatte eines FreeBSD-Systems zu verwenden. Der Artikel extref:{gjournal-desktop}[ Implementing UFS Journaling on a Desktop PC] enthält eine ausführliche Anleitung zu diesem Thema.
diff --git a/documentation/content/de/books/handbook/introduction/_index.adoc b/documentation/content/de/books/handbook/introduction/_index.adoc
index b2a61abf5e..b04101dfd3 100644
--- a/documentation/content/de/books/handbook/introduction/_index.adoc
+++ b/documentation/content/de/books/handbook/introduction/_index.adoc
@@ -13,24 +13,35 @@ next: books/handbook/bsdinstall
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/handbook/introduction/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-synopsis]]
== Überblick
@@ -81,7 +92,7 @@ Durch den freien Zugang zum Quellcode von FreeBSD ist es in unvergleichbarer Wei
* _Bildung:_ Sind Sie Informatikstudent oder Student eines verwandten Studiengangs? Die praktischen Einblicke in FreeBSD sind die beste Möglichkeit etwas über Betriebssysteme, Rechnerarchitektur und Netzwerke zu lernen. Einige frei erhältliche CAD-, mathematische und grafische Anwendungen sind sehr nützlich, gerade für diejenigen, deren Hauptinteresse in einem Computer darin besteht, _andere_ Arbeit zu erledigen!
* _Forschung:_ Mit dem frei verfügbaren Quellcode für das gesamte System bildet FreeBSD ein exzellentes Studienobjekt in der Disziplin der Betriebssysteme, wie auch in anderen Zweigen der Informatik. Es ist beispielsweise denkbar, das räumlich getrennte Gruppen gemeinsam an einer Idee oder Entwicklung arbeiten. Das Konzept der freien Verfügbarkeit und -nutzung von FreeBSD ermöglicht so die freie Verwendung, ohne sich gross Gedanken über Lizenzbedingungen zu machen oder aufgrund von Beschränkungen evtl. in einem offenen Forum bestimmte Dinge nicht diskutieren zu dürfen.
* _Netzwerkfähigkeit:_ Brauchen Sie einen neuen Router? Oder einen Name-Server (DNS)? Eine Firewall zum Schutze Ihres Intranets vor Fremdzugriff? FreeBSD macht aus dem in der Ecke verstaubenden 386- oder 486-PC im Handumdrehen einen leistungsfähigen Router mit anspruchsvollen Paketfilter-Funktionen.
-* _Embedded:_ FreeBSD ist eine exzellente Plattform, um auf embedded Systemen aufzubauen. Mit der Unterstützung für die ARM(R)-, MIPS(R)- und PowerPC(R)-Plattformen, verbunden mit dem robusten Netzwerkstack, aktuellen Neuerungen und der freizügigen link:{faq}#bsd-license-restrictions[BSD-Lizenz] stellt FreeBSD eine ausgezeichnete Basis für embedded Router, Firewalls und andere Geräte dar.
+* _Embedded:_ FreeBSD ist eine exzellente Plattform, um auf embedded Systemen aufzubauen. Mit der Unterstützung für die ARM(R)-, MIPS(R)- und PowerPC(R)-Plattformen, verbunden mit dem robusten Netzwerkstack, aktuellen Neuerungen und der freizügigen extref:{faq}[BSD-Lizenz, bsd-license-restrictions] stellt FreeBSD eine ausgezeichnete Basis für embedded Router, Firewalls und andere Geräte dar.
* _Desktop:_ FreeBSD ist eine gute Wahl für kostengünstige X-Terminals mit dem frei verfügbaren X11-Server. FreeBSD bietet die Auswahl aus vielen Open Source Desktop Umgebungen, dazu gehören auch die GNOME und KDE GUIs. FreeBSD kann sogar "plattenlos" booten, was einzelne Workstations sogar noch günstiger macht und die Verwaltung erleichtert.
* _Software-Entwicklung:_ Das Standard-FreeBSD-System wird mit einem kompletten Satz an Entwicklungswerkzeugen bereitgestellt, unter anderem einem vollständigen C/C++-Compiler und -Debugger. Entwicklungswerkzeugen. Viele zusätzliche Programmiersprachen für Wissenschaft und Entwicklung sind aus der Ports- und Paket-Sammlung zu haben.
@@ -167,7 +178,7 @@ Der Code in unserem Quellbaum, der unter die General Public License (GPL) oder d
[[development]]
=== Das FreeBSD-Entwicklungsmodell
-Die Entwicklung von FreeBSD ist ein offener und flexibler Prozess, der durch den Beitrag von buchstäblich tausenden Leuten rund um die Welt ermöglicht wird, wie an der link:{contributors}[Liste der Beitragenden] ersehen können. Die vielen Entwickler können aufgrund der Entwicklungs-Infrastruktur von FreeBSD über das Internet zusammenarbeiten. Wir suchen ständig nach neuen Entwicklern, Ideen und jenen, die sich in das Projekt tiefer einbringen wollen. Nehmen Sie einfach auf der Mailingliste {freebsd-hackers} Kontakt mit uns auf. Die Mailingliste {freebsd-announce} steht für wichtige Ankündigungen, die alle FreeBSD-Benutzer betreffen, zur Verfügung.
+Die Entwicklung von FreeBSD ist ein offener und flexibler Prozess, der durch den Beitrag von buchstäblich tausenden Leuten rund um die Welt ermöglicht wird, wie an der extref:{contributors}[Liste der Beitragenden] ersehen können. Die vielen Entwickler können aufgrund der Entwicklungs-Infrastruktur von FreeBSD über das Internet zusammenarbeiten. Wir suchen ständig nach neuen Entwicklern, Ideen und jenen, die sich in das Projekt tiefer einbringen wollen. Nehmen Sie einfach auf der Mailingliste {freebsd-hackers} Kontakt mit uns auf. Die Mailingliste {freebsd-announce} steht für wichtige Ankündigungen, die alle FreeBSD-Benutzer betreffen, zur Verfügung.
Unabhängig davon ob Sie alleine oder mit anderen eng zusammen arbeiten, enthält die folgende Aufstellung nützliche Informationen über das FreeBSD Projekt und dessen Entwicklungsabläufe.
@@ -188,7 +199,7 @@ Wie die meisten Entwickler auch, sind die Mitglieder des Core Teams Freiwillige,
Aussenstehende Beitragende::
Schliesslich stellt die grösste, aber nichtsdestotrotz wichtigste Gruppe von Entwicklern die der Benutzer selbst dar, die stetig Rückmeldungen und Fehlerbehebungen liefert. Der hauptsächliche Weg mit FreeBSDs nicht-zentralisierter Entwicklung Kontakt zu halten, ist, die {freebsd-hackers} Mailingliste zu abonnieren, auf der solche Dinge diskutiert werden. Lesen Sie dazu crossref:eresources[eresources, Ressourcen im Internet] für weitere Informationen über die verschiedenen FreeBSD-Mailinglisten.
+
-link:{contributors}[Liste der Beitragenden] ist eine, die lang ist und stetig wächst, also warum nicht FreeBSD beitreten und noch heute etwas zurückgeben?
+extref:{contributors}[Liste der Beitragenden] ist eine, die lang ist und stetig wächst, also warum nicht FreeBSD beitreten und noch heute etwas zurückgeben?
+
Code ist nicht die einzige Art, zu dem Projekt etwas beizutragen. Für eine ausführlichere Liste von Dingen die getan werden müssen, lesen Sie auf der link:https://www.FreeBSD.org/[FreeBSD Projektwebseite].
diff --git a/documentation/content/de/books/handbook/jails/_index.adoc b/documentation/content/de/books/handbook/jails/_index.adoc
index df78a87de2..6175fc26b1 100644
--- a/documentation/content/de/books/handbook/jails/_index.adoc
+++ b/documentation/content/de/books/handbook/jails/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/mac
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/jails/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
-endif::[]
+:images-path: books/handbook/jails/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[jails-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/kernelconfig/_index.adoc b/documentation/content/de/books/handbook/kernelconfig/_index.adoc
index 7ebe7ce585..55f23c9899 100644
--- a/documentation/content/de/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/de/books/handbook/kernelconfig/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/printing
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kernelconfig-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/l10n/_index.adoc b/documentation/content/de/books/handbook/l10n/_index.adoc
index 70534cb72a..2e847bd485 100644
--- a/documentation/content/de/books/handbook/l10n/_index.adoc
+++ b/documentation/content/de/books/handbook/l10n/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/cutting-edge
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/linuxemu/_index.adoc b/documentation/content/de/books/handbook/linuxemu/_index.adoc
index fc6450328e..dd44a463eb 100644
--- a/documentation/content/de/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/de/books/handbook/linuxemu/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/partiii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[linuxemu-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/mac/_index.adoc b/documentation/content/de/books/handbook/mac/_index.adoc
index 805fc7c4ec..dc01e015e4 100644
--- a/documentation/content/de/books/handbook/mac/_index.adoc
+++ b/documentation/content/de/books/handbook/mac/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/audit
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/mail/_index.adoc b/documentation/content/de/books/handbook/mail/_index.adoc
index 1fdb417141..7a8941bd82 100644
--- a/documentation/content/de/books/handbook/mail/_index.adoc
+++ b/documentation/content/de/books/handbook/mail/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/network-servers
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 28
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 28
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mail-de-term]]
== Terminologie
@@ -332,7 +331,7 @@ Sobald alles konfiguriert ist, wird empfohlen, das System neu zu starten. Ein Ne
[[mail-trouble]]
== Fehlerbehebung
-Hier finden sich ein paar häufig gestellte Fragen und ihre Antworten, die von der link:{faq}[FAQ] übernommen wurden.
+Hier finden sich ein paar häufig gestellte Fragen und ihre Antworten, die von der extref:{faq}[FAQ] übernommen wurden.
=== Warum muss ich einen FQDN (fully-qualified domain name / voll ausgeschriebenen Domänennamen) für meine Rechner verwenden?
diff --git a/documentation/content/de/books/handbook/mirrors/_index.adoc b/documentation/content/de/books/handbook/mirrors/_index.adoc
index ac1ca481f3..ab2d8b1e57 100644
--- a/documentation/content/de/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/de/books/handbook/mirrors/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/bibliography
[[mirrors]]
= Bezugsquellen für FreeBSD
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mirrors-cdrom]]
== CD and DVD Sets
diff --git a/documentation/content/de/books/handbook/multimedia/_index.adoc b/documentation/content/de/books/handbook/multimedia/_index.adoc
index 99f8211fd2..ecaf6edd91 100644
--- a/documentation/content/de/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/de/books/handbook/multimedia/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/kernelconfig
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[multimedia-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/network-servers/_index.adoc b/documentation/content/de/books/handbook/network-servers/_index.adoc
index faf84ad068..f2c2f51948 100644
--- a/documentation/content/de/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/de/books/handbook/network-servers/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/firewalls
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 29
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 29
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[network-servers-synopsis]]
== Übersicht
@@ -1110,7 +1109,7 @@ FreeBSD integriert keinen LDAP-Server. Beginnen Sie die Konfiguration mit der In
# pkg install openldap-server
....
-Im link:{linux-users}#software/[ Paket] sind eine große Anzahl an Optionen aktiviert. Mit dem Befehl `pkg info openldap-server` können diese überprüft werden. Falls die Optionen nicht ausreichend sind (weil bspw. SQL-Unterstützung benötigt wird), sollten Sie in Betracht ziehen, den Port mit dem entsprechenden Framework neu zu übersetzen.
+Im extref:{linux-users}[Paket,#software] sind eine große Anzahl an Optionen aktiviert. Mit dem Befehl `pkg info openldap-server` können diese überprüft werden. Falls die Optionen nicht ausreichend sind (weil bspw. SQL-Unterstützung benötigt wird), sollten Sie in Betracht ziehen, den Port mit dem entsprechenden Framework neu zu übersetzen.
Während der Installation wird für die Daten das Verzeichnis [.filename]#/var/db/openldap-data# erstellt. Das Verzeichnis für die Ablage der Zertifikate muss manuell angelegt werden:
diff --git a/documentation/content/de/books/handbook/parti.adoc b/documentation/content/de/books/handbook/parti.adoc
index 91a1bba0af..21bc441d1b 100644
--- a/documentation/content/de/books/handbook/parti.adoc
+++ b/documentation/content/de/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
next: books/handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[getting-started]]
= Erste Schritte
@@ -17,4 +25,4 @@ Dieser Teil des Handbuchs richtet sich an Benutzer und Administratoren für die
Referenzen auf weiter vorne liegende Textteile wurden auf ein Minimum beschränkt, so dass dieser Abschnitt ohne viel Blättern durchgearbeitet werden kann.
-include::content/de/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/de/books/handbook/partii.adoc b/documentation/content/de/books/handbook/partii.adoc
index 1dce35fcbc..01edf5883b 100644
--- a/documentation/content/de/books/handbook/partii.adoc
+++ b/documentation/content/de/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
next: books/handbook/desktop
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[common-tasks]]
= Oft benutzte Funktionen
@@ -17,4 +25,4 @@ Nach den Grundlagen beschäftigt sich das Handbuch mit oft benutzten Funktionen
Damit Sie einige Kapitel verstehen, sollten Sie vorher andere Kapitel gelesen haben. Die Übersicht zu jedem Kapitel zählt die Voraussetzungen für das erolgreiche Durcharbeiten des Kapitels auf.
-include::content/de/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/de/books/handbook/partiii.adoc b/documentation/content/de/books/handbook/partiii.adoc
index a725515aa6..ab26d52fd5 100644
--- a/documentation/content/de/books/handbook/partiii.adoc
+++ b/documentation/content/de/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
next: books/handbook/config
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[system-administration]]
= Systemadministration
@@ -11,4 +19,4 @@ Die restlichen Kapitel behandeln alle Aspekte der FreeBSD Systemadministration.
Diese Kapitel sollten Sie lesen, wenn Sie die Informationen darin benötigen. Sie brauchen Sie nicht in einer bestimmten Reihenfolge zu lesen, noch müssen Sie die Kapitel lesen, bevor Sie anfangen, FreeBSD zu benutzen.
-include::content/de/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/de/books/handbook/partiv.adoc b/documentation/content/de/books/handbook/partiv.adoc
index c56c04d048..bd1086aad2 100644
--- a/documentation/content/de/books/handbook/partiv.adoc
+++ b/documentation/content/de/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/usb-device-mode
next: books/handbook/serialcomms
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[network-communication]]
= Netzwerke
@@ -18,4 +26,4 @@ FreeBSD ist eins der meist benutzten Betriebssysteme für leistungsfähige Netzw
Diese Kapitel sollten Sie lesen, wenn Sie die Informationen darin benötigen. Sie brauchen die Kapitel nicht in einer bestimmten Reihenfolge zu lesen, noch müssen Sie die Kapitel lesen, bevor Sie anfangen, FreeBSD in einer Netzwerkumgebung zu benutzen.
-include::content/de/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/de/books/handbook/partv.adoc b/documentation/content/de/books/handbook/partv.adoc
index 2a8343ac72..f2d5bafc1a 100644
--- a/documentation/content/de/books/handbook/partv.adoc
+++ b/documentation/content/de/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
next: books/handbook/mirrors
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= Anhang
-include::content/de/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/de/books/handbook/pgpkeys/_index.adoc b/documentation/content/de/books/handbook/pgpkeys/_index.adoc
index 0be2e24e81..551eb9ac11 100644
--- a/documentation/content/de/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/de/books/handbook/pgpkeys/_index.adoc
@@ -9,29 +9,46 @@ next: books/handbook/freebsd-glossary
[[pgpkeys]]
= OpenPGP-Schlüssel
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
-Verwenden Sie die nachstehenden Schlüssel, wenn Sie eine Signatur überprüfen oder eine verschlüsselte E-Mail an einen Ansprechpartner oder einen Entwickler schicken wollen. Eine vollständige Liste der FreeBSD OpenPGP-Schlüssel finden Sie im Artikel {pgpkeys}[PGP Keys]. Den vollständigen Schlüsselring der Entwickler von FreeBSD finden Sie unter link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
+Verwenden Sie die nachstehenden Schlüssel, wenn Sie eine Signatur überprüfen oder eine verschlüsselte E-Mail an einen Ansprechpartner oder einen Entwickler schicken wollen. Eine vollständige Liste der FreeBSD OpenPGP-Schlüssel finden Sie im Artikel extref:{pgpkeys}[PGP Keys]. Den vollständigen Schlüsselring der Entwickler von FreeBSD finden Sie unter link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
[[pgpkeys-officers]]
== Ansprechpartner
diff --git a/documentation/content/de/books/handbook/ports/_index.adoc b/documentation/content/de/books/handbook/ports/_index.adoc
index 84707a6f9d..0e9825bc4b 100644
--- a/documentation/content/de/books/handbook/ports/_index.adoc
+++ b/documentation/content/de/books/handbook/ports/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/x11
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ports-synopsis]]
== Übersicht
@@ -617,7 +616,7 @@ Bei der Verwendung von `fetch` können die `extract` oder `update` Operationen n
****
*Procedure: Installation mit Subversion*
-Wird mehr Kontrolle über die Ports-Sammlung benötigt, oder wenn die lokalen Änderungen beibehalten werden sollen, oder Sie FreeBSD-CURRENT benutzen, kann Subversion benutzt werden, um die Ports-Sammlung zu laden. Lesen Sie link:{committers-guide}#subversion-primer/[den Subversion Primer] für eine detaillierte Beschreibung von Subversion.
+Wird mehr Kontrolle über die Ports-Sammlung benötigt, oder wenn die lokalen Änderungen beibehalten werden sollen, oder Sie FreeBSD-CURRENT benutzen, kann Subversion benutzt werden, um die Ports-Sammlung zu laden. Lesen Sie extref:{committers-guide}[den Subversion Primer, subversion-primer] für eine detaillierte Beschreibung von Subversion.
. Subversion muss installiert sein, bevor die Ports-Sammlung geladen werden kann. Ist eine lokale Kopie der Ports-Sammlung bereits vorhanden, installieren Sie Subversion wie folgt:
+
@@ -657,7 +656,7 @@ Die Ports-Sammlung enthält eine Reihe von Verzeichnissen, die jeweils eine Soft
* [.filename]#pkg-descr#: enthält eine ausführlichere Beschreibung der Anwendung.
* [.filename]#pkg-plist#: eine Liste aller Dateien, die durch diesen Port installiert werden. Außerdem sind hier Informationen enthalten, die zum Entfernen des Ports benötigt werden.
-Einige Ports beinhalten noch [.filename]#pkg-message# oder weitere Dateien, die vom Port-System benutzt werden, um spezielle Situationen zu handhaben. Wenn Sie mehr über diese Dateien oder das Port-System erfahren wollen, lesen Sie das link:{porters-handbook}[FreeBSD Porter's Handbook].
+Einige Ports beinhalten noch [.filename]#pkg-message# oder weitere Dateien, die vom Port-System benutzt werden, um spezielle Situationen zu handhaben. Wenn Sie mehr über diese Dateien oder das Port-System erfahren wollen, lesen Sie das extref:{porters-handbook}[FreeBSD Porter's Handbook].
Ein Port enthält nicht den eigentlichen Quellcode, der auch als "Distfile" bekannt ist. Der heruntergeladene Quellcode wird automatisch nach [.filename]#/usr/ports/distfiles# extrahiert.
@@ -1141,11 +1140,11 @@ Wenn sich ein Port nicht bauen oder installieren lässt, versuchen Sie folgendes
+
[NOTE]
====
-Einige Ports werden nicht von einer Einzelperson, sondern von einer link:{mailing-list-faq}[Mailingliste] betreut. Viele (aber nicht alle) dieser Adressen haben die Form mailto:freebsd-NameDerListe@FreeBSD.org[freebsd-NameDerListe@FreeBSD.org]. Denken Sie daran, wenn Sie Ihre Fragen formulieren.
+Einige Ports werden nicht von einer Einzelperson, sondern von einer extref:{mailing-list-faq}[Mailingliste] betreut. Viele (aber nicht alle) dieser Adressen haben die Form mailto:freebsd-NameDerListe@FreeBSD.org[freebsd-NameDerListe@FreeBSD.org]. Denken Sie daran, wenn Sie Ihre Fragen formulieren.
Dies gilt insbesondere für Ports, die von mailto:ports@FreeBSD.org[ports@FreeBSD.org] betreut werden. Derartige Ports haben überhaupt keinen Betreuer. Korrekturen und Unterstützung kommen daher nur von Personen, die diese Mailingliste abonniert haben. Gerade in diesem Bereich werden jederzeit zusätzliche freiwillige Helfer benötigt!
====
+
-Erhalten Sie auf Ihre Anfrage keine Antwort, benutzen Sie Bugzilla, um einen Problembericht zu erstellen. Bevor Sie einen solchen Bericht erstellen, lesen Sie den Artikel link:{problem-reports}[Writing FreeBSD Problem Reports].
-. Reparieren Sie ihn! Das link:{porters-handbook}[FreeBSD Porter's Handbook] enthält eine detaillierte Beschreibung des Portsystems. Damit sind Sie in der Lage, einen zeitweilig kaputten Port zu reparieren oder einen eigenen Port zu erstellen.
+Erhalten Sie auf Ihre Anfrage keine Antwort, benutzen Sie Bugzilla, um einen Problembericht zu erstellen. Bevor Sie einen solchen Bericht erstellen, lesen Sie den Artikel extref:{problem-reports}[Writing FreeBSD Problem Reports].
+. Reparieren Sie ihn! Das extref:{porters-handbook}[FreeBSD Porter's Handbook] enthält eine detaillierte Beschreibung des Portsystems. Damit sind Sie in der Lage, einen zeitweilig kaputten Port zu reparieren oder einen eigenen Port zu erstellen.
. Installieren Sie das Paket anstelle des Ports. Anweisungen hierzu finden Sie in <<pkgng-intro>>.
diff --git a/documentation/content/de/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/de/books/handbook/ppp-and-slip/_index.adoc
index b13a42ee6f..993bd234fe 100644
--- a/documentation/content/de/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/de/books/handbook/ppp-and-slip/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/mail
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ppp-and-slip-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/preface/_index.adoc b/documentation/content/de/books/handbook/preface/_index.adoc
index 71239ed040..9530f7dec7 100644
--- a/documentation/content/de/books/handbook/preface/_index.adoc
+++ b/documentation/content/de/books/handbook/preface/_index.adoc
@@ -11,16 +11,33 @@ next: books/handbook/parti
:toc: macro
:toclevels: 1
:icons: font
-:sectnums!:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-audience]]
== Über dieses Buch
diff --git a/documentation/content/de/books/handbook/printing/_index.adoc b/documentation/content/de/books/handbook/printing/_index.adoc
index 9b01f52e32..fd1c09f84a 100644
--- a/documentation/content/de/books/handbook/printing/_index.adoc
+++ b/documentation/content/de/books/handbook/printing/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/linuxemu
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/printing/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Trotz vieler Versuche es zu vermeiden, ist der Druck von Informationen auf Papier immer noch eine wichtige Funktion. Drucken hat zwei grundlegende Komponenten. Die Daten müssen an den Drucker gesendet werden, und zwar in einer Form, die der Drucker verstehen kann.
@@ -721,7 +720,7 @@ Neben dem in FreeBSD enthaltenen man:lpd[8] existieren noch weitere Drucksysteme
[[printing-other-cups]]
=== CUPS (Common UNIX(R) Printing System)
-CUPS ist ein beliebtes Drucksystem, das für viele Betriebssysteme erhältlich ist. CUPS unter FreeBSD wird in einem separaten Artikel beschrieben: link:{cups}[CUPS on FreeBSD].
+CUPS ist ein beliebtes Drucksystem, das für viele Betriebssysteme erhältlich ist. CUPS unter FreeBSD wird in einem separaten Artikel beschrieben: extref:{cups}[CUPS on FreeBSD].
[[printing-other-hplip]]
=== HPLIP
diff --git a/documentation/content/de/books/handbook/security/_index.adoc b/documentation/content/de/books/handbook/security/_index.adoc
index 075b5b2877..6a6a5c6633 100644
--- a/documentation/content/de/books/handbook/security/_index.adoc
+++ b/documentation/content/de/books/handbook/security/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/jails
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/serialcomms/_index.adoc b/documentation/content/de/books/handbook/serialcomms/_index.adoc
index 00994b10f1..adee43e78a 100644
--- a/documentation/content/de/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/de/books/handbook/serialcomms/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/ppp-and-slip
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[serial-synopsis]]
== Übersicht
@@ -1048,7 +1047,7 @@ Aktiviert die Konsolenunterstützung für dieses Gerät. Zurzeit kann nur ein Ge
Das erste Gerät in der Kernelkonfigurationsdatei mit dieser Option wird, unabhängig von dem unten diskutierten Schalter `-h`, zur Konsole. Die Option `0x20` muss zusammen mit `0x10` verwendet werden.
`0x40`:::
-Reserviert dieses Gerät und sperrt es für normale Zugriffe. Sie sollten diese Option nicht auf dem Gerät setzen, das Sie als serielle Konsole verwenden wollen. Der Zweck dieser Option ist es, dieses Gerät für das Remote-Debuggen zu reservieren. Das link:{developers-handbook}[ FreeBSD Developers' Handbook] enthält dazu weitere Informationen.
+Reserviert dieses Gerät und sperrt es für normale Zugriffe. Sie sollten diese Option nicht auf dem Gerät setzen, das Sie als serielle Konsole verwenden wollen. Der Zweck dieser Option ist es, dieses Gerät für das Remote-Debuggen zu reservieren. Das extref:{developers-handbook}[FreeBSD Developers' Handbook] enthält dazu weitere Informationen.
+
Beispiel:
+
diff --git a/documentation/content/de/books/handbook/usb-device-mode/_index.adoc b/documentation/content/de/books/handbook/usb-device-mode/_index.adoc
index e0cae179e0..fd442d7dde 100644
--- a/documentation/content/de/books/handbook/usb-device-mode/_index.adoc
+++ b/documentation/content/de/books/handbook/usb-device-mode/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/partiv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/usb-device-mode/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/usb-device-mode/
-endif::[]
+:images-path: books/handbook/usb-device-mode/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/usb-device-mode/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[usb-device-mode-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/virtualization/_index.adoc b/documentation/content/de/books/handbook/virtualization/_index.adoc
index ee43b8c617..3f2570c4a4 100644
--- a/documentation/content/de/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/de/books/handbook/virtualization/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/l10n
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/virtualization/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
-endif::[]
+:images-path: books/handbook/virtualization/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[virtualization-synopsis]]
== Übersicht
diff --git a/documentation/content/de/books/handbook/x11/_index.adoc b/documentation/content/de/books/handbook/x11/_index.adoc
index 9c45f1f38b..b99d427d67 100644
--- a/documentation/content/de/books/handbook/x11/_index.adoc
+++ b/documentation/content/de/books/handbook/x11/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/partii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[x11-synopsis]]
== Übersicht
@@ -1052,7 +1051,7 @@ Die Installation des Compiz Fusion Pakets ist einfach, aber bei der Konfiguratio
Desktop-Effekte erzeugen eine hohe Last auf der Grafikkarte. Für nVidia-basierte Grafikkarten sind die proprietären Treiber für eine gute Leistung erforderlich. Benutzer anderer Grafikkarten können diesen Abschnitt überspringen und mit der Konfiguration von Xorg fortfahren.
-Lesen Sie die link:{faq}#x/[FAQ zu diesem Thema], um herauszufinden, wie der richtige nVidia-Treiber ermittelt werden kann.
+Lesen Sie die extref:{faq}[FAQ zu diesem Thema, x], um herauszufinden, wie der richtige nVidia-Treiber ermittelt werden kann.
Nachdem der richtige Treiber für die Karte ermittelt wurde, kann er wie jedes andere Paket installiert werden.
diff --git a/documentation/content/de/books/handbook/zfs/_index.adoc b/documentation/content/de/books/handbook/zfs/_index.adoc
index 1d4a5e5fe5..270f9cd81e 100644
--- a/documentation/content/de/books/handbook/zfs/_index.adoc
+++ b/documentation/content/de/books/handbook/zfs/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/filesystems
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/zfs/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/zfs/
-endif::[]
+:images-path: books/handbook/zfs/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/zfs/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Das _Z-Dateisystem_, oder kurz ZFS, ist ein fortgeschrittenes Dateisystem, das entwickelt wurde, um viele der großen Probleme in vorherigen Entwicklungen zu überwinden.
diff --git a/documentation/content/de/books/porters-handbook/_index.adoc b/documentation/content/de/books/porters-handbook/_index.adoc
index 914ea0585b..43795744da 100644
--- a/documentation/content/de/books/porters-handbook/_index.adoc
+++ b/documentation/content/de/books/porters-handbook/_index.adoc
@@ -3,8 +3,8 @@ title: FreeBSD Porter's Handbook
authors:
- author: The FreeBSD Documentation Project
copyright: 2000-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "sun", "unix", "general"]
+trademarks: ["freebsd", "sun", "unix", "general"]
+isIndex: true
---
= FreeBSD Porter's Handbook
@@ -12,51 +12,34 @@ trademarks: ["freebsd", "sun", "unix", "general"]
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
-:toc-title: Inhaltsverzeichnis
-:part-signifier: Teil
-:chapter-signifier: Kapitel
-:appendix-caption: Anhang
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
+:book: true
+:pdf: false
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/de/mailing-lists.adoc[]
-include::shared/de/teams.adoc[]
-include::shared/de/urls.adoc[]
-:chapters-path: content/de/books/porters-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/porters-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/de/mailing-lists.adoc[]
-include::../../../../shared/de/teams.adoc[]
-include::../../../../shared/de/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/de/mailing-lists.adoc[]
-include::../../../../shared/de/teams.adoc[]
-include::../../../../shared/de/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -67,17 +50,17 @@ include::{chapters-path}toc-tables.adoc[]
include::{chapters-path}toc-examples.adoc[]
-include::{chapters-path}why-port/chapter.adoc[leveloffset=+1, lines=7..24;28..-1]
-include::{chapters-path}own-port/chapter.adoc[leveloffset=+1, lines=7..24;28..-1]
-include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1, lines=7..24;28..-1]
-include::{chapters-path}slow/chapter.adoc[leveloffset=+1, lines=7..24;28..-1]
-include::{chapters-path}makefile/chapter.adoc[leveloffset=+1, lines=7..24;28..-1]
-include::{chapters-path}special/chapter.adoc[leveloffset=+1, lines=7..24;28..-1]
-include::{chapters-path}plist/chapter.adoc[leveloffset=+1, lines=7..24;28..-1]
-include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1, lines=7..24;28..-1]
-include::{chapters-path}testing/chapter.adoc[leveloffset=+1, lines=7..24;28..-1]
-include::{chapters-path}port-upgrading/chapter.adoc[leveloffset=+1, lines=7..24;28..-1]
-include::{chapters-path}security/chapter.adoc[leveloffset=+1, lines=7..24;28..-1]
-include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1, lines=7..24;28..-1]
-include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1, lines=7..24;28..-1]
-include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1, lines=6..23;27..-1]
+include::{chapters-path}why-port/chapter.adoc[leveloffset=+1]
+include::{chapters-path}own-port/chapter.adoc[leveloffset=+1]
+include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1]
+include::{chapters-path}slow/chapter.adoc[leveloffset=+1]
+include::{chapters-path}makefile/chapter.adoc[leveloffset=+1]
+include::{chapters-path}special/chapter.adoc[leveloffset=+1]
+include::{chapters-path}plist/chapter.adoc[leveloffset=+1]
+include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1]
+include::{chapters-path}testing/chapter.adoc[leveloffset=+1]
+include::{chapters-path}port-upgrading/chapter.adoc[leveloffset=+1]
+include::{chapters-path}security/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1]
+include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1]
diff --git a/documentation/content/de/books/porters-handbook/keeping-up/chapter.adoc b/documentation/content/de/books/porters-handbook/keeping-up/chapter.adoc
index d3264b3936..83b38d0044 100644
--- a/documentation/content/de/books/porters-handbook/keeping-up/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/keeping-up/chapter.adoc
@@ -10,19 +10,36 @@ prev: books/porters-handbook/porting-samplem
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Die FreeBSD Ports-Sammlung verändert sich ständig. Hier finden Sie einige Informationen, wie Sie auf dem Laufenden bleiben.
diff --git a/documentation/content/de/books/porters-handbook/makefile/chapter.adoc b/documentation/content/de/books/porters-handbook/makefile/chapter.adoc
index 31bcd2eafc..e6c81caaad 100644
--- a/documentation/content/de/books/porters-handbook/makefile/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/makefile/chapter.adoc
@@ -11,19 +11,36 @@ next: books/porters-handbook/special
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Das Konfigurieren des [.filename]#Makefile# ist sehr einfach und wir schlagen vor, dass Sie zunächst einen Blick auf vorhandene Beispiele werfen. Zusätzlich gibt es ein <<porting-samplem,Beispiel eines Makefile>> in diesem Handbuch. Schauen Sie es sich an und verfolgen Sie bitte die Abfolge der Variablen und Abschnitte in dieser Vorlage. Damit erleichtern Sie es anderen, Ihren Port zu lesen.
@@ -675,7 +692,7 @@ Da die Ports-Sammlung über viele Jahre gewachsen ist, wurden viele neue Kategor
Unsere bestehende Maxime ist die Vermeidung der Neuanlage von physischen Kategorien, solange nicht eine große Zahl von Ports zugeordnet werden können oder falls ihr nicht Ports zugehören würden, welche eine logisch abgegrenzte Gruppe von limitiertem öffentlichem Interesse zugehören würden (zum Beispiel neue Sprachkategorien) oder vorzugsweise beides.
-Die Erklärung dafür ist, dass eine Neuanlage einer physischen Kategorie einen link:{committers-guide}#PORTS[erheblichen Arbeitsaufwand] sowohl für die Committer als auch diejenigen Nutzer bedeutet, welche die Änderungen der Ports-Sammlung nachvollziehen. Zusätzlich verursachen Vorschläge für neue Kategorien oftmals Kontroversen (natürlich deswegen, weil es keinen klaren Konsens darüber gibt, welche Kategorie als "zu groß" betrachtet werden muss noch ob sich bestimmte Kategorien zur einfachen Suche eignen (und wie viele Kategorien überhaupt ideal wären) und so weiter).
+Die Erklärung dafür ist, dass eine Neuanlage einer physischen Kategorie einen extref:{committers-guide}[erheblichen Arbeitsaufwand, ports] sowohl für die Committer als auch diejenigen Nutzer bedeutet, welche die Änderungen der Ports-Sammlung nachvollziehen. Zusätzlich verursachen Vorschläge für neue Kategorien oftmals Kontroversen (natürlich deswegen, weil es keinen klaren Konsens darüber gibt, welche Kategorie als "zu groß" betrachtet werden muss noch ob sich bestimmte Kategorien zur einfachen Suche eignen (und wie viele Kategorien überhaupt ideal wären) und so weiter).
Hier ist das Prozedere:
@@ -692,7 +709,7 @@ Hier ist das Prozedere:
** Für zusätzliches Ansehen sorgen Sie, wenn Sie die anderen Dateien, die geändert werden müssen, beifügen wie in der Direktive des Committer's Guide beschrieben.
. Da es die Ports-Infrastruktur beeinflusst und nicht nur die Durchführung von Repocopies und möglicherweise sogar Regressionstests auf dem Build Cluster durchgeführt werden müssen, sollte der PR dem Ports Management Team {portmgr} zugeordnet werden.
-. Sobald der PR bestätigt wurde muss ein Committer den Rest der Prozedur durchführen, welche im link:{committers-guide}#ports[ Committers Guide] beschrieben ist.
+. Sobald der PR bestätigt wurde muss ein Committer den Rest der Prozedur durchführen, welche im extref:{committers-guide}[Committers Guide, ports] beschrieben ist.
====
Das Vorschlagen einer neuen virtuellen Kategorie ist ähnlich, aber wesentlich weniger aufwendig, weil keine Ports verschoben werden müssen. In diesem Falle müssen nur die Patches an den PR beigefügt werden, welche die neue Kategorie zur Variable `CATEGORIES` der betroffenen Ports hinzufügen.
diff --git a/documentation/content/de/books/porters-handbook/own-port/chapter.adoc b/documentation/content/de/books/porters-handbook/own-port/chapter.adoc
index 9be1b77e68..42a774de4e 100644
--- a/documentation/content/de/books/porters-handbook/own-port/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/own-port/chapter.adoc
@@ -11,19 +11,36 @@ next: books/porters-handbook/quick-porting
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Sie sind also daran interessiert, einen neuen Port zu erstellen oder einen vorhandenen zu aktualisieren? Großartig!
diff --git a/documentation/content/de/books/porters-handbook/pkg-files/chapter.adoc b/documentation/content/de/books/porters-handbook/pkg-files/chapter.adoc
index b9d65af088..a114741f25 100644
--- a/documentation/content/de/books/porters-handbook/pkg-files/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/pkg-files/chapter.adoc
@@ -11,19 +11,36 @@ next: books/porters-handbook/testing
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[porting-message]]
== [.filename]#pkg-message#
diff --git a/documentation/content/de/books/porters-handbook/plist/chapter.adoc b/documentation/content/de/books/porters-handbook/plist/chapter.adoc
index cffd56dca0..70ae80d724 100644
--- a/documentation/content/de/books/porters-handbook/plist/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/plist/chapter.adoc
@@ -11,19 +11,36 @@ next: books/porters-handbook/pkg-files
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[plist-sub]]
== Änderungen an pkg-plist mit Hilfe von make-Variablen
diff --git a/documentation/content/de/books/porters-handbook/port-upgrading/chapter.adoc b/documentation/content/de/books/porters-handbook/port-upgrading/chapter.adoc
index 99f9e83eaf..1acc172e34 100644
--- a/documentation/content/de/books/porters-handbook/port-upgrading/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/port-upgrading/chapter.adoc
@@ -11,21 +11,38 @@ next: books/porters-handbook/security
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
-Wenn Sie feststellen, dass ein Port verglichen mit der neuesten Version des Originalautors nicht mehr auf dem aktuellen Stand ist, sollten Sie als Erstes sicherstellen, dass Sie die aktuellste Version des Ports haben. Diese finden Sie im Verzeichnis [.filename]#ports/ports-current# der FreeBSD FTP-Spiegelseiten. Wenn Sie allerdings mit mehr als ein paar Ports arbeiten, werden Sie es wahrscheinlich einfacher finden CVSup zu benutzen, um Ihre gesamte Ports-Sammlung aktuell zu halten, wie es im link:{handbook}#CVSUP-CONFIG[Handbuch] beschrieben wird. Das hat zusätzlich den Vorteil, dass Sie so auch alle Abhängigkeiten des Ports aktuell halten.
+Wenn Sie feststellen, dass ein Port verglichen mit der neuesten Version des Originalautors nicht mehr auf dem aktuellen Stand ist, sollten Sie als Erstes sicherstellen, dass Sie die aktuellste Version des Ports haben. Diese finden Sie im Verzeichnis [.filename]#ports/ports-current# der FreeBSD FTP-Spiegelseiten. Wenn Sie allerdings mit mehr als ein paar Ports arbeiten, werden Sie es wahrscheinlich einfacher finden CVSup zu benutzen, um Ihre gesamte Ports-Sammlung aktuell zu halten, wie es im extref:{handbook}[Handbuch, CVSUP-CONFIG] beschrieben wird. Das hat zusätzlich den Vorteil, dass Sie so auch alle Abhängigkeiten des Ports aktuell halten.
Der nächste Schritt besteht darin festzustellen, ob bereits eine Aktualisierung des Ports darauf wartet committet zu werden. Um das sicherzustellen haben Sie folgende Möglichkeiten. Es gibt eine durchsuchbare Schnittstelle zur http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[FreeBSD Problembericht Datenbank (PR - Problem Report)] (auch bekannt als `GNATS`). Wählen Sie dazu `Ports` im Drop-Down-Menü und geben Sie den Namen des Ports ein.
@@ -46,11 +63,11 @@ Soll mehr als eine Datei gepatcht werden, können Sie entweder `cvs diff` verwen
Um gängige Operationen mit Korrekturdateien zu vereinfachen, können Sie [.filename]#/usr/ports/Tools/scripts/patchtool.py# benutzen. Aber lesen Sie bitte vorher [.filename]#/usr/ports/Tools/scripts/README.patchtool#.
-Falls der Port keinen Maintainer hat und Sie ihn selbst aktiv benutzen, ziehen Sie bitte in Erwägung sich als Maintainer zu melden. FreeBSD hat mehr als 4000 Ports ohne Maintainer und in diesem Bereich werden immer zusätzliche Freiwillige benötigt (Für eine ausführliche Beschreibung der Verantwortlichkeiten eines Maintainers lesen Sie bitte im link:{developers-handbook}#POLICIES-MAINTAINER[ Developer's Handbook] nach).
+Falls der Port keinen Maintainer hat und Sie ihn selbst aktiv benutzen, ziehen Sie bitte in Erwägung sich als Maintainer zu melden. FreeBSD hat mehr als 4000 Ports ohne Maintainer und in diesem Bereich werden immer zusätzliche Freiwillige benötigt (Für eine ausführliche Beschreibung der Verantwortlichkeiten eines Maintainers lesen Sie bitte im extref:{developers-handbook}[Developer's Handbook, POLICIES-MAINTAINER] nach).
Der beste Weg uns das diff zu schicken ist mittels man:send-pr[1] (Kategorie Ports). Wenn Sie der Maintainer des Ports sind, fügen Sie bitte `[maintainer update]` an den Anfang Ihrer Zusammenfassung und setzen Sie die "Klasse" des PR auf `maintainer-update`. Ansonsten sollte die "Klasse" des PR `change-request` sein. Bitte erwähnen Sie alle hinzugefügten oder gelöschten Dateien in der Nachricht, da diese beim Commit ausdrücklich an man:cvs[1] übergeben werden müssen. Wenn das diff größer ist als 20 Kilobyte komprimieren und uuencoden Sie es bitte. Ansonsten können Sie es in den PR einfügen wie es ist.
-Bevor Sie den PR mit man:send-pr[1] abschicken, sollten Sie den Abschnitt link:{problem-reports}#pr-writing/[ Den Problembericht schreiben] im Artikel über Problemberichte lesen. Dieser enthält sehr viel mehr Informationen darüber, wie man nützliche Problemberichte verfasst.
+Bevor Sie den PR mit man:send-pr[1] abschicken, sollten Sie den Abschnitt extref:{problem-reports}[Den Problembericht schreiben, pr-writing] im Artikel über Problemberichte lesen. Dieser enthält sehr viel mehr Informationen darüber, wie man nützliche Problemberichte verfasst.
[IMPORTANT]
====
@@ -78,7 +95,7 @@ Wenn möglich, sollten Sie stets eine man:cvs[1]-Differenz einreichen. Diese sin
<.> Das Verzeichnis, in dem Sie den Port bauen wollen. Dieses Arbeitsverzeichnis kann sich auch außerhalb von [.filename]#/usr/ports/# befinden.
-<.> R_CVSROOT steht für einen öffentlichen CVS-Server. Eine Liste aller verfügbaren Server finden Sie im link:{handbook}#cvsup/[FreeBSD Handbuch].
+<.> R_CVSROOT steht für einen öffentlichen CVS-Server. Eine Liste aller verfügbaren Server finden Sie im extref:{handbook}[FreeBSD Handbuch, cvsup].
<.> Ersetzen Sie "pdnsd" durch den Modulnamen des Ports. Dieser entspricht in der Regel dem Namen des Ports. Allerdings gibt es einige Ausnahmen von dieser Regel, insbesondere bei sprachspezifischen Ports (beispielsweise lautet der Modulname für den Port package:german/selfhtml[] de-selfhtml). Um den Namen des Moduls herauszufinden, können Sie entweder die link:https://www.FreeBSD.org/cgi/cvsweb.cgi/ports[cvsweb-Schnittstelle] verwenden oder den kompletten Pfad des Ports angeben (in unserem Beispiel wäre der komplette Pfad also [.filename]#ports/dns/pdnsd#).
diff --git a/documentation/content/de/books/porters-handbook/porting-dads/chapter.adoc b/documentation/content/de/books/porters-handbook/porting-dads/chapter.adoc
index 8d114ed5be..09279e202a 100644
--- a/documentation/content/de/books/porters-handbook/porting-dads/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/porting-dads/chapter.adoc
@@ -11,29 +11,46 @@ next: books/porters-handbook/porting-samplem
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dads-intro]]
== Einführung
-Hier ist eine Liste von gebräuchlichen Dos and Don'ts (Dinge, die man machen oder vermeiden sollte), welchen Sie während des Portierungsprozesses begegnen werden. Sie sollten Ihren Port anhand dieser Liste überprüfen. Sie können auch Ports in der http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[PR Datenbank], welche andere Menschen eingereicht haben, kontrollieren. Senden Sie bitte Kommentare zu Ports, die Sie verifizieren wie unter link:{contributing}#CONTRIB-GENERAL[Bug Reports and General Commentary] beschrieben. Der Abgleich von Ports aus der PR-Datenbank hilft uns diese schneller zu committen, und zeigt auch, dass Sie wissen, worum es geht.
+Hier ist eine Liste von gebräuchlichen Dos and Don'ts (Dinge, die man machen oder vermeiden sollte), welchen Sie während des Portierungsprozesses begegnen werden. Sie sollten Ihren Port anhand dieser Liste überprüfen. Sie können auch Ports in der http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[PR Datenbank], welche andere Menschen eingereicht haben, kontrollieren. Senden Sie bitte Kommentare zu Ports, die Sie verifizieren wie unter extref:{contributing}[Bug Reports and General Commentary, CONTRIB-GENERAL] beschrieben. Der Abgleich von Ports aus der PR-Datenbank hilft uns diese schneller zu committen, und zeigt auch, dass Sie wissen, worum es geht.
[[porting-wrkdir]]
== `WRKDIR`
-Schreiben Sie in keine Dateien außerhalb von `WRKDIR`. `WRKDIR` ist der einzige Ort, welcher während des Erstellen des Ports garantiert beschreibbar ist (siehe link:{handbook}#PORTS-CD[ Ports Installieren von CDROM] für ein Beispiel, um Ports in einem schreibgeschützen Zweig zu erstellen). Wenn Sie eine der [.filename]##pkg-*## Dateien modifizieren müssen, sollten Sie <<porting-pkgfiles,eine Variable erneut definieren>>, anstatt die Datei zu überschreiben.
+Schreiben Sie in keine Dateien außerhalb von `WRKDIR`. `WRKDIR` ist der einzige Ort, welcher während des Erstellen des Ports garantiert beschreibbar ist (siehe extref:{handbook}ports[Ports Installieren von CDROM, PORTS-CD] für ein Beispiel, um Ports in einem schreibgeschützen Zweig zu erstellen). Wenn Sie eine der [.filename]##pkg-*## Dateien modifizieren müssen, sollten Sie <<porting-pkgfiles,eine Variable erneut definieren>>, anstatt die Datei zu überschreiben.
[[porting-wrkdirprefix]]
== `WRKDIRPREFIX`
diff --git a/documentation/content/de/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/de/books/porters-handbook/porting-samplem/chapter.adoc
index 5514bc8772..c7d622f5f6 100644
--- a/documentation/content/de/books/porters-handbook/porting-samplem/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/porting-samplem/chapter.adoc
@@ -11,19 +11,36 @@ next: books/porters-handbook/keeping-up
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Hier ein Beispiel für ein [.filename]#Makefile#, welches als Vorlage für einen neuen Port dienen kann. Alle zusätzlichen Kommentare in eckigen Klammern müssen entfernt werden!
diff --git a/documentation/content/de/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/de/books/porters-handbook/quick-porting/chapter.adoc
index 0d9c64edb5..c26c3b1241 100644
--- a/documentation/content/de/books/porters-handbook/quick-porting/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/quick-porting/chapter.adoc
@@ -11,19 +11,36 @@ next: books/porters-handbook/slow
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Dieser Abschnitt beschreibt, wie Sie schnell einen neuen Port erstellen können. In vielen Fällen ist dies allerdings nicht ausreichend, dann werden Sie in diesem Buch weiterlesen müssen.
@@ -183,7 +200,7 @@ Bevor Sie den neuen Port einreichen, lesen Sie bitte unbedingt den Abschnitt <<p
Nun, da Sie mit Ihrem Port zufrieden sind, müssen Sie ihn nur noch in den Haupt-Ports-Tree von FreeBSD einbringen, damit alle daran teilhaben können. Wir benötigen nicht Ihr [.filename]#work#-Verzeichnis oder Ihr [.filename]#pkgname.tgz#-Paket - diese können Sie nun löschen. Wenn Ihr Port beispielsweise `oneko` heißt, wechseln Sie in das Verzeichnis, in dem sich das Verzeichnis `oneko` befindet und führen den Befehl `shar find oneko > oneko.shar` aus.
-Fügen Sie Ihre Datei `oneko.shar` einem Fehlerbericht an und senden Sie diesen mit Hilfe des Programms man:send-pr[1] (unter link:{contributing}#CONTRIB-GENERAL[ Bug Reports and General Commentary] finden Sie weitere Informationen über man:send-pr[1]). Ordnen Sie den Fehlerbericht bitte in die Kategorie `Ports` mit der Klasse `Change-Request` ein (Markieren Sie den Bericht nicht als `vertraulich` (`confidential`)!). Fügen Sie bitte eine kurze Beschreibung des Programms, das Sie portiert haben, in das "Beschreibungs"-Feld des Problemberichts und die shar-Datei in das "Fix"-Feld ein (bespielsweise eine kurze Version des `COMMENT`).
+Fügen Sie Ihre Datei `oneko.shar` einem Fehlerbericht an und senden Sie diesen mit Hilfe des Programms man:send-pr[1] (unter extref:{contributing}[ Bug Reports and General Commentary, CONTRIB-GENERAL] finden Sie weitere Informationen über man:send-pr[1]). Ordnen Sie den Fehlerbericht bitte in die Kategorie `Ports` mit der Klasse `Change-Request` ein (Markieren Sie den Bericht nicht als `vertraulich` (`confidential`)!). Fügen Sie bitte eine kurze Beschreibung des Programms, das Sie portiert haben, in das "Beschreibungs"-Feld des Problemberichts und die shar-Datei in das "Fix"-Feld ein (bespielsweise eine kurze Version des `COMMENT`).
[NOTE]
====
@@ -194,4 +211,4 @@ Noch einmal: _Bitte fügen Sie nicht das distfile der Originalquelle, das [.file
Haben Sie bitte etwas Geduld, nachdem Sie den Port eingereicht haben. Manchmal kann es einige Monate dauern, bevor ein Port in FreeBSD eingefügt wird, obwohl es wahrscheinlich nur ein paar Tage dauert. Sie können sich die http://www.FreeBSD.org/cgi/query-pr-summary.cgi?category=ports[ Liste der PRs, die darauf warten, in FreeBSD committet zu werden], ansehen.
-Nachdem wir einen Blick auf Ihren Port geworfen haben, werden wir, wenn nötig, bei Ihnen nachfragen und ihn in die Ports-Sammlung übernehmen. Ihr Name taucht dann auch in der Liste der link:{contributors}#contrib-additional/[Additional FreeBSD Contributors] und in anderen Dateien auf. Ist das nicht toll?! :-)
+Nachdem wir einen Blick auf Ihren Port geworfen haben, werden wir, wenn nötig, bei Ihnen nachfragen und ihn in die Ports-Sammlung übernehmen. Ihr Name taucht dann auch in der Liste der extref:{contributors}[Additional FreeBSD Contributors, contrib-additional] und in anderen Dateien auf. Ist das nicht toll?! :-)
diff --git a/documentation/content/de/books/porters-handbook/security/chapter.adoc b/documentation/content/de/books/porters-handbook/security/chapter.adoc
index 2cec58e3c3..de0b204bef 100644
--- a/documentation/content/de/books/porters-handbook/security/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/security/chapter.adoc
@@ -11,19 +11,36 @@ next: books/porters-handbook/porting-dads
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-intro]]
== Warum Sicherheit so wichtig ist
diff --git a/documentation/content/de/books/porters-handbook/slow/chapter.adoc b/documentation/content/de/books/porters-handbook/slow/chapter.adoc
index 75bf69693a..3ec201c3ad 100644
--- a/documentation/content/de/books/porters-handbook/slow/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/slow/chapter.adoc
@@ -11,19 +11,36 @@ next: books/porters-handbook/makefile
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Ok, das war nicht ganz einfach und der Port hat einige Veränderungen erfordert, um funktionieren zu können. In diesem Abschnitt werden wir Schritt für Schritt erklären, wie man den funktionierenden Port den Vorgaben der Ports entsprechend anpasst.
diff --git a/documentation/content/de/books/porters-handbook/special/chapter.adoc b/documentation/content/de/books/porters-handbook/special/chapter.adoc
index 1e04e57229..36a48ca28a 100644
--- a/documentation/content/de/books/porters-handbook/special/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/special/chapter.adoc
@@ -11,19 +11,36 @@ next: books/porters-handbook/plist
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Es gibt einige Dinge mehr, die zu beachten sind, wenn man einen Port erstellt. Dieser Abschnitt erklärt die wichtigsten.
@@ -2090,7 +2107,7 @@ Weitere Informationen zu diesem Thema finden sich in der Datei http://www.freebs
[[rc-scripts]]
== Starten und Anhalten von Diensten (rc Skripten)
-[.filename]#rc.d#-Skripten werden zum Starten von Diensten während des Systemstarts verwendet und um den Administratoren einen Standardweg zum Anhalten und Starten von Diensten zu bieten. Ports halten sich an dieses systemweite [.filename]#rc.d#-Framework. Details zu deren Benutzung können im link:{handbook}#configtuning-rcd/[rc.d Kapitel des Handbuchs] nachgelesen werden. Ausführliche Beschreibungen der verfügbaren Befehle stehen in man:rc[8] und man:rc.subr[8]. Desweiteren gibt es link:{rc-scripting.en}[einen Artikel] zu praktischen Aspekten bezüglich [.filename]#rc.d#-Skripten.
+[.filename]#rc.d#-Skripten werden zum Starten von Diensten während des Systemstarts verwendet und um den Administratoren einen Standardweg zum Anhalten und Starten von Diensten zu bieten. Ports halten sich an dieses systemweite [.filename]#rc.d#-Framework. Details zu deren Benutzung können im extref:{handbook}config-tuning/[rc.d Kapitel des Handbuchs, configtuning-rcd] nachgelesen werden. Ausführliche Beschreibungen der verfügbaren Befehle stehen in man:rc[8] und man:rc.subr[8]. Desweiteren gibt es link:{rc-scripting.en}[einen Artikel] zu praktischen Aspekten bezüglich [.filename]#rc.d#-Skripten.
Ein oder mehrere [.filename]#rc.d#-Skripten können installiert werden mittels:
diff --git a/documentation/content/de/books/porters-handbook/testing/chapter.adoc b/documentation/content/de/books/porters-handbook/testing/chapter.adoc
index 0f15951aa8..c9d3cda064 100644
--- a/documentation/content/de/books/porters-handbook/testing/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/testing/chapter.adoc
@@ -11,19 +11,36 @@ next: books/porters-handbook/port-upgrading
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[make-describe]]
== `make describe` ausführen
diff --git a/documentation/content/de/books/porters-handbook/why-port/chapter.adoc b/documentation/content/de/books/porters-handbook/why-port/chapter.adoc
index 323b7a0ecc..8d057b33ec 100644
--- a/documentation/content/de/books/porters-handbook/why-port/chapter.adoc
+++ b/documentation/content/de/books/porters-handbook/why-port/chapter.adoc
@@ -11,19 +11,36 @@ next: books/porters-handbook/own-port
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
-:toc-title: Inhaltsverzeichnis
-:table-caption: Tabelle
-:figure-caption: Abbildung
-:example-caption: Beispiel
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Die Ports-Sammlung von FreeBSD ist der gebräuchlichste Weg, um Anwendungen ("Ports") unter FreeBSD zu installieren. Wie alles andere in FreeBSD auch, ist sie hauptsächlich das Ergebnis der Arbeit von Freiwilligen. Es ist wichtig, diesen Aspekt beim Lesen im Hinterkopf zu behalten.
diff --git a/documentation/content/el/articles/bsdl-gpl/_index.adoc b/documentation/content/el/articles/bsdl-gpl/_index.adoc
index 12b0b5fe2f..22e5c42122 100644
--- a/documentation/content/el/articles/bsdl-gpl/_index.adoc
+++ b/documentation/content/el/articles/bsdl-gpl/_index.adoc
@@ -5,7 +5,6 @@ authors:
email: brucem@alumni.cse.ucsc.edu
- author: Γιώργος Κεραμίδας
email: keramida@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "cvsup", "intel", "xfree86", "general"]
---
@@ -18,10 +17,27 @@ trademarks: ["freebsd", "cvsup", "intel", "xfree86", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
+:images-path: articles/bsdl-gpl/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
'''
diff --git a/documentation/content/el/articles/contributing/_index.adoc b/documentation/content/el/articles/contributing/_index.adoc
index 38be4554dd..302707118a 100644
--- a/documentation/content/el/articles/contributing/_index.adoc
+++ b/documentation/content/el/articles/contributing/_index.adoc
@@ -3,7 +3,6 @@ title: Συνεισφέροντας στο FreeBSD
authors:
- author: Jordan Hubbard
- author: Κυριάκος Κεντρωτής
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ieee", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "ieee", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-
-ifeval::["{backend}" == "html5"]
-include::shared/el/urls.adoc[]
-include::shared/el/mailing-lists.adoc[lines=10..-1]
+:images-path: articles/contributing/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/el/urls.adoc[]
-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/el/urls.adoc[]
-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -64,7 +65,7 @@ toc::[]
Αρκετοί άνθρωποι που σχετίζονται με το FreeBSD δεν είναι προγραμματιστές. Το έργο περιλαμβάνει συγγραφείς τεκμηρίωσης, σχεδιαστές ιστοσελίδων και ανθρώπους που το υποστηρίζουν. Το μόνο που χρειάζεται για να συνεισφέρει κάποιος στο έργο αυτής της ομάδας είναι η διάθεση να επενδύσει λίγο χρόνο και η θέληση για γνώση.
. Διαβάστε τη λίστα συχνών ερωτήσεων (FAQ) και το Εγχειρίδιο του FreeBSD. Αν κάτι δεν εξηγείται σωστά, περιέχει ξεπερασμένες πληροφορίες ή είναι εντελώς λάθος, ειδοποιήστε μας. Ακόμα καλύτερα, στείλτε μας μια διόρθωση (η SGML δεν είναι δύσκολη στην εκμάθηση, αλλά πάντα δεχόμαστε και διορθώσεις σε μορφή απλού κειμένου ASCII).
-. Βοηθήστε στη μετάφραση της τεκμηρίωσης του FreeBSD στη μητρική σας γλώσσα. Αν υπάρχει ήδη τεκμηρίωση στη γλώσσα σας, μπορείτε να βοηθήσετε στη μετάφραση επιπρόσθετων κειμένων ή να επιβεβαιώνετε ότι η μετάφραση είναι ενημερωμένη. Πρώτα, κοιτάξτε στις link:{fdp-primer}#translations[απαντημένες ερωτήσεις σχετικά με τις μεταφράσεις] στο Βασικό Οδηγό για την Τεκμηρίωση του FreeBSD. Το να στείλετε μία μετάφραση δεν σας καθιστά υπεύθυνο να μεταφράσετε όλη την τεκμηρίωση του FreeBSD. Ως εθελοντής μπορείτε να μεταφράσετε όσα κείμενα θέλετε ή μπορείτε· όσο πολλά, μεγάλα, μικρά ή λίγα είναι αυτά. Μόλις αρχίσει κάποιος τη μετάφραση της τεκμηρίωσης του FreeBSD σε μια γλώσσα, σχεδόν αμέσως αρχίσουν να συνεισφέρουν κι άλλοι στην προσπάθεια. Αν έχετε το χρόνο ή την ενέργεια να μεταφράσετε μόνο ένα μέρος της τεκμηρίωσης, παρακαλούμε μεταφράστε τις οδηγίες εγκατάστασης.
+. Βοηθήστε στη μετάφραση της τεκμηρίωσης του FreeBSD στη μητρική σας γλώσσα. Αν υπάρχει ήδη τεκμηρίωση στη γλώσσα σας, μπορείτε να βοηθήσετε στη μετάφραση επιπρόσθετων κειμένων ή να επιβεβαιώνετε ότι η μετάφραση είναι ενημερωμένη. Πρώτα, κοιτάξτε στις extref:{fdp-primer}[απαντημένες ερωτήσεις σχετικά με τις μεταφράσεις, translations] στο Βασικό Οδηγό για την Τεκμηρίωση του FreeBSD. Το να στείλετε μία μετάφραση δεν σας καθιστά υπεύθυνο να μεταφράσετε όλη την τεκμηρίωση του FreeBSD. Ως εθελοντής μπορείτε να μεταφράσετε όσα κείμενα θέλετε ή μπορείτε· όσο πολλά, μεγάλα, μικρά ή λίγα είναι αυτά. Μόλις αρχίσει κάποιος τη μετάφραση της τεκμηρίωσης του FreeBSD σε μια γλώσσα, σχεδόν αμέσως αρχίσουν να συνεισφέρουν κι άλλοι στην προσπάθεια. Αν έχετε το χρόνο ή την ενέργεια να μεταφράσετε μόνο ένα μέρος της τεκμηρίωσης, παρακαλούμε μεταφράστε τις οδηγίες εγκατάστασης.
. Να διαβάζετε περιστασιακά (ή καθημερινά) τις {freebsd-questions} και news:comp.unix.bsd.freebsd.misc. Το να μοιράζεστε την εμπειρία σας και να βοηθάτε ανθρώπους να λύσουν τα προβλήματά τους μπορεί να είναι ιδιαίτερα ικανοποιητικό. Μερικές φορές μπορεί να μάθετε και κάτι νέο μέσα από αυτή τη διαδικασία! Επίσης αυτές οι συζητήσεις μπορεί να σας δώσουν ιδέες για καινούρια ενδιαφέροντα πράγματα με τα οποία μπορείτε να ασχοληθείτε.
[[ongoing-programmer-tasks]]
@@ -101,7 +102,7 @@ toc::[]
[[contrib-general]]
=== Αναφορές προβλήματος και γενικές επεξηγηματικές παρατηρήσεις-σχόλια
-Μια ιδέα ή πρόταση _γενικού_ τεχνικού ενδιαφέροντος θα πρέπει να αποσταλεί στη λίστα {freebsd-hackers}. Επιπλέον, άνθρωποι με ενδιαφέρον για τέτοια θέματα (αλλά και ανεκτικότητα σε _μεγάλο_ αριθμό εισερχόμενων μηνυμάτων!) μπορούν να γραφτούν στη λίστα {freebsd-hackers}. Δείτε το link:{handbook}#eresources-mail[Εγχειρίδιο του FreeBSD] για περισσότερες πληροφορίες σχετικά με αυτήν αλλά και άλλες λίστες.
+Μια ιδέα ή πρόταση _γενικού_ τεχνικού ενδιαφέροντος θα πρέπει να αποσταλεί στη λίστα {freebsd-hackers}. Επιπλέον, άνθρωποι με ενδιαφέρον για τέτοια θέματα (αλλά και ανεκτικότητα σε _μεγάλο_ αριθμό εισερχόμενων μηνυμάτων!) μπορούν να γραφτούν στη λίστα {freebsd-hackers}. Δείτε το extref:{handbook}eresources[Εγχειρίδιο του FreeBSD, eresources-mail] για περισσότερες πληροφορίες σχετικά με αυτήν αλλά και άλλες λίστες.
Αν βρείτε κάποιο bug ή αν έχετε κάνει κάποια συγκεκριμένη αλλαγή, παρακαλούμε κάντε αναφορά χρησιμοποιώντας το πρόγραμμα man:send-pr[1] ή την αντίστοιχη link:https://www.FreeBSD.org/send-pr/[ ιστοσελίδα]. Προσπαθήστε να συμπληρώσετε όλα τα πεδία της αναφοράς. Αν οι αλλαγές που κάνατε δεν ξεπερνούν τα 65KB σε μέγεθος, συμπεριλάβετε τις αλλαγές σας απευθείας στην αναφορά. Αν οι αλλαγές είναι κατάλληλες για εφαρμογή στον πηγαίο κώδικα, προσθέστε την ετικέτα `[PATCH]` στην περίληψη της αναφοράς. Όταν συμπεριλαμβάνετε patches, _μη_ χρησιμοποιείτε αντιγραφή-και-επικόλληση, διότι η αντιγραφή και επικόλληση μετατρέπει συχνά τους στηλοθέτες (TAB) σε κενά και αχρηστεύει το patch. Αν τα patches είναι πολύ μεγαλύτερα από 20KB, δοκιμάστε να τα συμπιέσετε (π.χ. με το man:gzip[1] ή το man:bzip2[1]) και χρησιμοποιήστε το εργαλείο man:uuencode[1] για να εισάγετε τη συμπιεσμένη μορφή στην αναφορά σας.
@@ -109,15 +110,15 @@ toc::[]
Εάν δε λάβετε επιβεβαίωση εγκαίρως (3 μέρες ως μια βδομάδα, ανάλογα με τη αξιοπιστία του email) ή για κάποιο λόγο αδυνατείτε να χρησιμοποιήσετε την εντολή man:send-pr[1], μπορείτε να απευθυνθείτε σε κάποιον προκειμένου να την αρχειοθετήσει για εσάς στέλνοντας mail στη {freebsd-bugs}.
-Δείτε επίσης link:{problem-reports}[αυτό το άρθρο] σχετικά με το πώς να γράφετε καλές αναφορές προβλημάτων.
+Δείτε επίσης extref:{problem-reports}[αυτό το άρθρο] σχετικά με το πώς να γράφετε καλές αναφορές προβλημάτων.
=== Αλλαγές στην τεκμηρίωση
-Οι αλλαγές στην τεκμηρίωση επιβλέπονται από την {freebsd-doc}. Για πλήρεις οδηγίες σχετικά με τον τρόπο που μπορείτε να συνεισφέρετε στην τεκμηρίωση του FreeBSD, δείτε τον link:{fdp-primer}[Οδηγό τεκμηρίωσης του FreeBSD]. Στείλτε τα καινούρια σας κείμενα ή τις αλλαγές σας (ακόμη και μικροδιορθώσεις είναι πάντα καλοδεχούμενες) χρησιμοποιώντας την εντολή man:send-pr[1] όπως περιγράφετε στο <<contrib-general>>.
+Οι αλλαγές στην τεκμηρίωση επιβλέπονται από την {freebsd-doc}. Για πλήρεις οδηγίες σχετικά με τον τρόπο που μπορείτε να συνεισφέρετε στην τεκμηρίωση του FreeBSD, δείτε τον extref:{fdp-primer}[Οδηγό τεκμηρίωσης του FreeBSD]. Στείλτε τα καινούρια σας κείμενα ή τις αλλαγές σας (ακόμη και μικροδιορθώσεις είναι πάντα καλοδεχούμενες) χρησιμοποιώντας την εντολή man:send-pr[1] όπως περιγράφετε στο <<contrib-general>>.
=== Αλλαγές στον Πηγαίο Κώδικα
-Μία προσθήκη ή αλλαγή στον υπάρχοντα κώδικα είναι κατά κάποιο τρόπο περίτεχνη υπόθεση και εξαρτάται αρκετά από τον βαθμό της ενημέρωσης που έχετε με την τρέχουσα κατάσταση της ανάπτυξης του FreeBSD. Υπάρχει μια ειδική συνεχώς αναπτυσσόμενη έκδοση του FreeBSD γνωστή ως "FreeBSD-CURRENT" η οποία είναι διαθέσιμη με διάφορους τρόπους για την ευκολία των προγραμματιστών που δραστηριοποιούνται ενεργά στην ανάπτυξη του συστήματος. Δείτε link:{handbook}#current-stable[το Εγχειρίδιο του FreeBSD] για περισσότερες πληροφορίες σχετικά με το που θα βρείτε και πώς μπορείτε να χρησιμοποιήσετε το FreeBSD-CURRENT.
+Μία προσθήκη ή αλλαγή στον υπάρχοντα κώδικα είναι κατά κάποιο τρόπο περίτεχνη υπόθεση και εξαρτάται αρκετά από τον βαθμό της ενημέρωσης που έχετε με την τρέχουσα κατάσταση της ανάπτυξης του FreeBSD. Υπάρχει μια ειδική συνεχώς αναπτυσσόμενη έκδοση του FreeBSD γνωστή ως "FreeBSD-CURRENT" η οποία είναι διαθέσιμη με διάφορους τρόπους για την ευκολία των προγραμματιστών που δραστηριοποιούνται ενεργά στην ανάπτυξη του συστήματος. Δείτε extref:{handbook}updating-upgrading[το Εγχειρίδιο του FreeBSD, current-stable] για περισσότερες πληροφορίες σχετικά με το που θα βρείτε και πώς μπορείτε να χρησιμοποιήσετε το FreeBSD-CURRENT.
Δουλεύοντας από παλιότερο κώδικα δυστυχώς σημαίνει ότι οι αλλαγές σας μπορεί μερικές φορές να είναι αρκετά ξεπερασμένες ή να αποκλίνουν πολύ, οπότε να δυσκολεύει κάπως η ενσωμάτωσή τους στο FreeBSD. Ρίσκα σαν γι' αυτά μπορούν να ελαχιστοποιηθούν κάπως με την συμμετοχή στις λίστες {freebsd-announce} και {freebsd-current}, στις οποίες διεξάγονται συζητήσεις για την τρέχουσα κατάσταση του συστήματος.
@@ -242,4 +243,4 @@ USA
==== Δωρέες Πρόσβασης στο Διαδίκτυο
-Πάντα είναι χρήσιμο να έχουμε καινούρια mirror sites για το FTP, τον ιστότοπό μας ή το `cvsup`. Αν θέλετε να εγκαταστήσετε ένα τέτοιο mirror, παρακαλούμε δείτε τo άρθρο link:{hubs}[Mirroring FreeBSD]. Εκεί θα βρείτε περισσότερες πληροφορίες.
+Πάντα είναι χρήσιμο να έχουμε καινούρια mirror sites για το FTP, τον ιστότοπό μας ή το `cvsup`. Αν θέλετε να εγκαταστήσετε ένα τέτοιο mirror, παρακαλούμε δείτε τo άρθρο extref:{hubs}[Mirroring FreeBSD]. Εκεί θα βρείτε περισσότερες πληροφορίες.
diff --git a/documentation/content/el/articles/explaining-bsd/_index.adoc b/documentation/content/el/articles/explaining-bsd/_index.adoc
index 2fcf6ade56..23f115df62 100644
--- a/documentation/content/el/articles/explaining-bsd/_index.adoc
+++ b/documentation/content/el/articles/explaining-bsd/_index.adoc
@@ -3,7 +3,6 @@ title: Περιγραφή των Συστημάτων BSD
authors:
- author: Greg Lehey
email: grog@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "amd", "apple", "intel", "xfree86", "linux", "opengroup", "sparc", "sun", "unix", "general"]
---
@@ -16,10 +15,27 @@ trademarks: ["freebsd", "amd", "apple", "intel", "xfree86", "linux", "opengroup"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
+:images-path: articles/explaining-bsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Περίληψη
diff --git a/documentation/content/el/articles/freebsd-questions/_index.adoc b/documentation/content/el/articles/freebsd-questions/_index.adoc
index c11b9f1860..11b7d3bf54 100644
--- a/documentation/content/el/articles/freebsd-questions/_index.adoc
+++ b/documentation/content/el/articles/freebsd-questions/_index.adoc
@@ -3,7 +3,6 @@ title: Πως να χρησιμοποιείτε με επιτυχία την λ
authors:
- author: Greg Lehey
email: grog@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "microsoft", "opengroup", "qualcomm", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "microsoft", "opengroup", "qualcomm", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-
-ifeval::["{backend}" == "html5"]
-include::shared/el/urls.adoc[]
-include::shared/el/mailing-lists.adoc[]
+:images-path: articles/freebsd-questions/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/el/urls.adoc[]
-include::../../../../shared/el/mailing-lists.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/el/urls.adoc[]
-include::../../../../shared/el/mailing-lists.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -137,7 +138,7 @@ your options page that will email your current password to you.
Μπορείτε (και πρέπει) να κάνετε κάποια πράγματα από μόνοι σας πριν στείλετε μια ερώτηση σε κάποια από τις λίστες ηλεκτρονικού ταχυδρομείου.
* Προσπαθείστε να λύσετε το πρόβλημα μόνοι σας. Αν στείλετε μια ερώτηση η οποία δείχνει ότι έχετε προσπαθήσει ήδη να λύσετε το πρόβλημα, είναι σχεδόν σίγουρο ότι η ερώτησή σας θα κινήσει το ενδιαφέρον περισσότερο ενδιαφέρον. Η προσπάθεια να λύσετε το πρόβλημα μόνοι σας έχει κι άλλα καλά αποτελέσματα: θα βελτιώσει την κατανόηση που έχετε για τον τρόπο που δουλεύει το FreeBSD, οπότε ύστερα θα μπορείτε ακόμη και να χρησιμοποιήσετε τη γνώση που αποκτήσατε για να βοηθήσετε άλλους, απαντώντας τις ερωτήσεις τους σε κάποια από τις λίστες.
-* Διαβάστε τα manual pages, και την τεκμηρίωση του FreeBSD (είτε το αντίγραφο που διανέμεται μαζί με τις εκδόσεις του FreeBSD κι εγκαθίσταται στον κατάλογο [.filename]#/usr/doc# ή μέσω WWW στη διεύθυνση http://www.FreeBSD.org[http://www.FreeBSD.org]), ειδικά το link:{handbook}[Εγχειρίδιο του FreeBSD] και τη link:{faq}[λίστα συχνών ερωτήσεων].
+* Διαβάστε τα manual pages, και την τεκμηρίωση του FreeBSD (είτε το αντίγραφο που διανέμεται μαζί με τις εκδόσεις του FreeBSD κι εγκαθίσταται στον κατάλογο [.filename]#/usr/doc# ή μέσω WWW στη διεύθυνση http://www.FreeBSD.org[http://www.FreeBSD.org]), ειδικά το extref:{handbook}[Εγχειρίδιο του FreeBSD] και τη extref:{faq}[λίστα συχνών ερωτήσεων].
* Περιηγηθείτε ή αναζητήστε σχετικά θέματα στα αρχεία της λίστας, για να δείτε αν η ερώτησή σας ή κάποια παρόμοια έχει ήδη εμφανιστεί ή έχει απαντηθεί στο παρελθόν. Μπορείτε να βρείτε τα αρχεία της λίστας στη διεύθυνση http://www.FreeBSD.org/mail[http://www.FreeBSD.org/mail] και να αναζητήσετε παλιά θέματα στη διεύθυνση http://www.FreeBSD.org/search/#mailinglists[http://www.FreeBSD.org/search/#mailinglists]. Τέτοιες αναζητήσεις μπορούν να γίνουν και σε άλλους εξυπηρετητές που έχουν το αρχείο της λίστας, π.χ. στη διεύθυνση http://marc.theaimsgroup.com[http://marc.theaimsgroup.com].
* Χρησιμοποιήστε μια μηχανή αναζήτησης, όπως το http://www.google.com[Google] ή το http://www.yahoo.com[Yahoo] για να βρείτε απαντήσεις στις ερωτήσεις σας. Το Google έχει ακόμα και http://www.google.com/bsd[ειδικό τμήμα για τα BSD λειτουργικά συστήματα].
diff --git a/documentation/content/el/articles/gjournal-desktop/_index.adoc b/documentation/content/el/articles/gjournal-desktop/_index.adoc
index 1a997e4ce7..fda3f943e6 100644
--- a/documentation/content/el/articles/gjournal-desktop/_index.adoc
+++ b/documentation/content/el/articles/gjournal-desktop/_index.adoc
@@ -3,7 +3,6 @@ title: Υλοποίηση του UFS Journaling σε ένα Desktop Υπολογ
authors:
- author: Μανώλης Κιαγιάς
email: manolis@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -16,32 +15,27 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
+:images-path: articles/gjournal-desktop/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/el/mailing-lists.adoc[lines=10..-1]
-include::shared/el/urls.adoc[]
-:imagesdir: ../../../images/articles/gjournal-desktop/
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/el/urls.adoc[]
-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/el/urls.adoc[]
-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
endif::[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Περίληψη
@@ -312,7 +306,7 @@ options UFS_GJOURNAL # Σημείωση: η επιλογή αυτή υπάρχε
options GEOM_JOURNAL # Θα πρέπει να προσθέσετε αυτή τη γραμμή
....
-Μεταγλωττίστε και επανεγκαταστήστε τον πυρήνα σας χρησιμοποιώντας τις σχετικές link:{handbook}#kernelconfig[οδηγίες στο Εγχειρίδιο του FreeBSD.]
+Μεταγλωττίστε και επανεγκαταστήστε τον πυρήνα σας χρησιμοποιώντας τις σχετικές extref:{handbook}kernelconfig[οδηγίες στο Εγχειρίδιο του FreeBSD., kernelconfig]
Μην ξεχάσετε να αφαιρέσετε την αντίστοιχη καταχώρηση "load" από το αρχείο [.filename]#/boot/loader.conf# αν την είχατε χρησιμοποιήσει προηγουμένως.
@@ -433,7 +427,7 @@ tunefs: soft updates set
Το journaling είναι μια σχετικά νέα δυνατότητα του FreeBSD, και έτσι δεν είναι ακόμα καλά τεκμηριωμένη. Ίσως όμως να βρείτε χρήσιμες πληροφορίες στις παρακάτω αναφορές:
-* Υπάρχει ένα link:{handbook}#geom-gjournal[νέο τμήμα για το journaling] στο Εγχειρίδιο του FreeBSD.
+* Υπάρχει ένα extref:{handbook}geom[νέο τμήμα για το journaling, geom-gjournal] στο Εγχειρίδιο του FreeBSD.
* http://lists.freebsd.org/pipermail/freebsd-current/2006-June/064043.html[Αυτή η δημοσίευση] στη λίστα {freebsd-current} από τον δημιουργό του man:gjournal[8], `{pjd}`.
* http://lists.freebsd.org/pipermail/freebsd-questions/2008-April/173501.html[Αυτή η δημοσίευση] στη λίστα {freebsd-questions} από τον `{ivoras}`.
* Οι σελίδες manual του man:gjournal[8] και man:geom[8].
diff --git a/documentation/content/el/articles/greek-language-support/_index.adoc b/documentation/content/el/articles/greek-language-support/_index.adoc
index dc861f81a7..163b54b4d0 100644
--- a/documentation/content/el/articles/greek-language-support/_index.adoc
+++ b/documentation/content/el/articles/greek-language-support/_index.adoc
@@ -3,7 +3,6 @@ title: Υποστήριξη της Ελληνικής Γλώσσας στο Free
authors:
- author: Νικόλαος Κόκκαλης
email: nickkokkalis@yahoo.co.uk
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
+:images-path: articles/greek-language-support/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/el/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/el/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -162,7 +163,7 @@ set output-meta On
Τα πιο συνηθισμένα γραφικό περιβάλλον εργασίας σε FreeBSD βασίζονται στην πλατφόρμα Xorg. Οι ρυθμίσεις για υποστήριξη Ελληνικών σε Xorg είναι εντελώς ίδιες με αυτές που χρησιμοποιεί το περιβάλλον Xorg και σε άλλα UNIX συστήματα (π.χ. σε GNU/Linux).
-Αρχικά, πρέπει να ρυθμίσετε το περιβάλλον Xorg έτσι ώστε να ξεκινά σωστά-ακόμη και χωρίς Ελληνικά. Για πληροφορίες σχετικά με τις πρώτες αυτές ρυθμίσεις, δείτε link:{handbook}#x11[το αντίστοιχο κεφάλαιο στο Εγχειρίδιο του FreeBSD].
+Αρχικά, πρέπει να ρυθμίσετε το περιβάλλον Xorg έτσι ώστε να ξεκινά σωστά-ακόμη και χωρίς Ελληνικά. Για πληροφορίες σχετικά με τις πρώτες αυτές ρυθμίσεις, δείτε extref:{handbook}x11[το αντίστοιχο κεφάλαιο στο Εγχειρίδιο του FreeBSD, x11].
Αφού καταφέρετε να ρυθμίσετε τα πάντα για να ξεκινά το γραφικό περιβάλλον Xorg, πρέπει να τοποθετήσετε τις παρακάτω γραμμές στο αρχείο [.filename]#/etc/X11/xorg.conf#:
diff --git a/documentation/content/el/articles/linux-users/_index.adoc b/documentation/content/el/articles/linux-users/_index.adoc
index 506102e033..9fe19a7d1c 100644
--- a/documentation/content/el/articles/linux-users/_index.adoc
+++ b/documentation/content/el/articles/linux-users/_index.adoc
@@ -3,7 +3,6 @@ title: Οδηγός Γρήγορης Εκκίνησης του FreeBSD για Χ
authors:
- author: John Ferrell
copyright: 2008 Η Ομάδα Τεκμηρίωσης του FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"]
---
@@ -16,21 +15,26 @@ trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-
-ifeval::["{backend}" == "html5"]
-include::shared/el/urls.adoc[]
+:images-path: articles/linux-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/el/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/el/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -47,14 +51,14 @@ toc::[]
Το κείμενο αυτό τονίζει τις διαφορές μεταξύ του FreeBSD και του Linux(R) ώστε μέσοι ή προχωρημένοι χρήστες του Linux(R) να μπορούν γρήγορα να προσαρμοστούν στις βασικές έννοιες του FreeBSD. Πρόκειται για μια τεχνική εισαγωγή στο FreeBSD, και δεν θα αναφερθούμε σε τυχόν "φιλοσοφικές" διαφορές μεταξύ των δύο συστημάτων.
-Το κείμενο αυτό υποθέτει ότι έχετε ήδη εγκαταστήσει το FreeBSD. Αν δεν έχετε εγκαταστήσει το FreeBSD ή χρειάζεστε βοήθεια με την διαδικασία εγκατάστασης του, παρακαλούμε να διαβάσετε το κεφάλαιο link:{handbook}#install[Εγκαθιστώντας το FreeBSD] στο Εγχειρίδιο του FreeBSD.
+Το κείμενο αυτό υποθέτει ότι έχετε ήδη εγκαταστήσει το FreeBSD. Αν δεν έχετε εγκαταστήσει το FreeBSD ή χρειάζεστε βοήθεια με την διαδικασία εγκατάστασης του, παρακαλούμε να διαβάσετε το κεφάλαιο extref:{handbook}install[Εγκαθιστώντας το FreeBSD, install] στο Εγχειρίδιο του FreeBSD.
[[shells]]
== Κελύφη: Δεν υπάρχει Bash;
Όσοι έρχονται από το Linux(R) συχνά εκπλήσσονται όταν ανακαλύπτουν ότι το Bash δεν είναι το προεπιλεγμένο κέλυφος στο FreeBSD. Στην πραγματικότητα, το Bash δεν υπάρχει καν στην βασική διανομή του FreeBSD. Αντίθετα, το FreeBSD χρησιμοποιεί το man:tcsh[1] ως το προεπιλεγμένο κέλυφος. Το Bash καθώς και άλλα κελύφη που ίσως θέλετε να εγκαταστήσετε, είναι διαθέσιμα στη <<SOFTWARE, Συλλογή Πακέτων και Ports>> του FreeBSD.
-Αν εγκαταστήσετε διαφορετικά κελύφη, μπορείτε να χρησιμοποιήσετε την εντολή man:chsh[1] για να αλλάξετε το προεπιλεγμένο κέλυφος κάποιου χρήστη. Σας συνιστούμε ωστόσο να αφήσετε το κέλυφος του `root` στο προεπιλεγμένο. Ο λόγος για αυτό είναι ότι τα κελύφη που δεν περιλαμβάνονται στην βασική διανομή του FreeBSD, εγκαθίστανται στην τοποθεσία [.filename]#/usr/local/bin# ή [.filename]#/usr/bin#. Σε περίπτωση προβλήματος, είναι πιθανόν τα συστήματα αρχείων όπου βρίσκονται τα [.filename]#/usr/local/bin# και [.filename]#/usr/bin# να μην μπορούν να προσαρτηθούν. Στην περίπτωση αυτή, ο `root` δεν θα είχε πρόσβαση στο προεπιλεγμένο του κέλυφος, εμποδίζοντας έτσι και την είσοδο του στο σύστημα. Για το λόγο αυτό, υπάρχει ένας δεύτερος λογαριασμός όμοιος με τον `root`, ο `toor`, ο οποίος δημιουργήθηκε ειδικά για να χρησιμοποιείται με κάποιο άλλο κέλυφος. Δείτε τις Συχνές Ερωτήσεις Ασφαλείας σχετικά με τον link:{faq}#TOOR-ACCOUNT[λογαριασμό toor].
+Αν εγκαταστήσετε διαφορετικά κελύφη, μπορείτε να χρησιμοποιήσετε την εντολή man:chsh[1] για να αλλάξετε το προεπιλεγμένο κέλυφος κάποιου χρήστη. Σας συνιστούμε ωστόσο να αφήσετε το κέλυφος του `root` στο προεπιλεγμένο. Ο λόγος για αυτό είναι ότι τα κελύφη που δεν περιλαμβάνονται στην βασική διανομή του FreeBSD, εγκαθίστανται στην τοποθεσία [.filename]#/usr/local/bin# ή [.filename]#/usr/bin#. Σε περίπτωση προβλήματος, είναι πιθανόν τα συστήματα αρχείων όπου βρίσκονται τα [.filename]#/usr/local/bin# και [.filename]#/usr/bin# να μην μπορούν να προσαρτηθούν. Στην περίπτωση αυτή, ο `root` δεν θα είχε πρόσβαση στο προεπιλεγμένο του κέλυφος, εμποδίζοντας έτσι και την είσοδο του στο σύστημα. Για το λόγο αυτό, υπάρχει ένας δεύτερος λογαριασμός όμοιος με τον `root`, ο `toor`, ο οποίος δημιουργήθηκε ειδικά για να χρησιμοποιείται με κάποιο άλλο κέλυφος. Δείτε τις Συχνές Ερωτήσεις Ασφαλείας σχετικά με τον extref:{faq}[λογαριασμό toor, TOOR-ACCOUNT].
[[software]]
== Πακέτα και Ports: Προσθέτοντας λογισμικό στο FreeBSD
@@ -90,14 +94,14 @@ in your /etc/rc.conf. Extra options can be found in startup script.
Αν χρησιμοποιείτε μια "επίσημη" έκδοση του FreeBSD (6.2, 6.3, 7.0, κλπ. που γενικά μπορείτε να εγκαταστήσετε από CD-ROM) η εντολή `pkg_add -r` θα κατεβάσει τα πακέτα που φτιάχτηκαν για αυτή τη συγκεκριμένη έκδοση. Τα πακέτα αυτά _ίσως δεν περιέχουν_ τις πλέον τελευταίες εκδόσεις των εφαρμογών. Μπορείτε να χρησιμοποιήσετε την μεταβλητή περιβάλλοντος `PACKAGESITE` για να παρακάμψετε αυτή την προεπιλεγμένη συμπεριφορά. Για παράδειγμα, θέτοντας την `PACKAGESITE` στην τιμή link:ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-6-stable/Latest/[ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-6-stable/Latest/] θα κατεβάσετε τα πιο πρόσφατα πακέτα που υπάρχουν για τη σειρά 6.X.
====
-Για περισσότερες πληροφορίες σχετικά με τα πακέτα, παρακαλούμε διαβάστε την ενότητα 4.4 στο Εγχειρίδιο του FreeBSD: link:{handbook}#packages-using[Χρησιμοποιώντας το Σύστημα Packages].
+Για περισσότερες πληροφορίες σχετικά με τα πακέτα, παρακαλούμε διαβάστε την ενότητα 4.4 στο Εγχειρίδιο του FreeBSD: extref:{handbook}ports[Χρησιμοποιώντας το Σύστημα Packages, packages-using].
[[ports]]
=== Ports
Η δεύτερη μέθοδος για την εγκατάσταση εφαρμογών στο FreeBSD είναι η Συλλογή των Ports. Η Συλλογή των Ports είναι ένα πλαίσιο λειτουργιών που αποτελείται από [.filename]#Makefiles# και αρχεία διαφορών (patches) τα οποία έχουν δημιουργηθεί ειδικά, ώστε να είναι δυνατή η εγκατάσταση διάφορων εφαρμογών στο FreeBSD από τον πηγαίο κώδικα τους. Όταν εγκαθιστάτε ένα port, το σύστημα θα κατεβάσει τον πηγαίο κώδικα, θα εφαρμόσει όλες τις απαιτούμενες αλλαγές χρησιμοποιώντας τα patches, θα μεταγλωττίσει τον κώδικα, και τέλος θα εγκαταστήσει την εφαρμογή. Θα ακολουθήσει την ίδια διαδικασία και για οποιαδήποτε τυχόν εξαρτώμενα προγράμματα.
-Μπορείτε να βρείτε την Συλλογή των Ports (η οποία μερικές φορές αναφέρεται και ως "δέντρο των ports"), στον κατάλογο [.filename]#/usr/ports#. Αυτό βέβαια προϋποθέτει ότι εγκαταστήσατε την Συλλογή των Ports κατά τη διάρκεια της εγκατάστασης του FreeBSD. Αν δεν το έχετε κάνει, μπορείτε να την προσθέσετε από το CD εγκατάστασης με την βοήθεια του man:sysinstall[8] ή να την κατεβάσετε από τους εξυπηρετητές του FreeBSD χρησιμοποιώντας την εντολή man:csup[1] ή την εντολή man:portsnap[8]. Μπορείτε να βρείτε λεπτομερείς οδηγίες για την εγκατάσταση της Συλλογής των Ports στην link:{handbook}#ports-using[ενότητα 4.5.1] του εγχειριδίου.
+Μπορείτε να βρείτε την Συλλογή των Ports (η οποία μερικές φορές αναφέρεται και ως "δέντρο των ports"), στον κατάλογο [.filename]#/usr/ports#. Αυτό βέβαια προϋποθέτει ότι εγκαταστήσατε την Συλλογή των Ports κατά τη διάρκεια της εγκατάστασης του FreeBSD. Αν δεν το έχετε κάνει, μπορείτε να την προσθέσετε από το CD εγκατάστασης με την βοήθεια του man:sysinstall[8] ή να την κατεβάσετε από τους εξυπηρετητές του FreeBSD χρησιμοποιώντας την εντολή man:csup[1] ή την εντολή man:portsnap[8]. Μπορείτε να βρείτε λεπτομερείς οδηγίες για την εγκατάσταση της Συλλογής των Ports στην extref:{handbook}ports[ενότητα 4.5.1, ports-using] του εγχειριδίου.
Η εγκατάσταση ενός port είναι γενικά τόσο απλή όσο το να εισέλθετε στον κατάλογο του και να ξεκινήσετε την διαδικασία μεταγλώττισης. Στο ακόλουθο παράδειγμα γίνεται εγκατάσταση του Apache 2.2 από την Συλλογή των Ports:
@@ -115,7 +119,7 @@ in your /etc/rc.conf. Extra options can be found in startup script.
# make WITH_LDAP="YES" install clean
....
-Διαβάστε την ενότητα 4.5 του Εγχειριδίου του FreeBSD, link:{handbook}#ports-using[Χρησιμοποιώντας την Ports Collection], για περισσότερες πληροφορίες σχετικά με τη Συλλογή των Ports.
+Διαβάστε την ενότητα 4.5 του Εγχειριδίου του FreeBSD, extref:{handbook}ports[Χρησιμοποιώντας την Ports Collection, ports-using], για περισσότερες πληροφορίες σχετικά με τη Συλλογή των Ports.
[[which]]
=== Ports ή πακέτα, τι πρέπει να χρησιμοποιήσω;
@@ -221,9 +225,9 @@ ifconfig_em0="DHCP"
Στο Linux(R) χρησιμοποιείται το IPTABLES το οποίο παρέχει υπηρεσίες firewall σε επίπεδο πυρήνα. Το FreeBSD παρέχει επίσης firewall μέσω του πυρήνα. Για την ακρίβεια, το FreeBSD παρέχει τρία firewalls:
-* link:{handbook}#firewalls-ipfw[IPFIREWALL]
-* link:{handbook}#firewalls-ipf[IPFILTER]
-* link:{handbook}#firewalls-pf[PF]
+* extref:{handbook}firewalls[IPFIREWALL, firewalls-ipfw]
+* extref:{handbook}firewalls[IPFILTER, firewalls-ipf]
+* extref:{handbook}firewalls[PF, firewalls-pf]
Το IPFIREWALL ή IPFW (η εντολή χειρισμού των κανόνων του IPFW είναι η man:ipfw[8]) είναι το firewall που έχει αναπτυχθεί και συντηρείται από την ομάδα ανάπτυξης του FreeBSD. Το IPFW μπορεί να συνδυαστεί με το man:dummynet[4] για να παρέχει δυνατότητες διαμόρφωσης της κίνησης πακέτων (traffic shaping) και να εξομοιώνει διαφορετικούς τύπους συνδέσεων δικτύου.
@@ -257,7 +261,7 @@ pass in on $ext_if inet proto tcp from any to ($ext_if) port 22
Υπάρχουν τρεις μέθοδοι για την αναβάθμιση ενός συστήματος FreeBSD: Μέσω του πηγαίου κώδικα, μέσω έτοιμων (binary) αναβαθμίσεων, και μέσω των CD εγκατάστασης.
-Η εγκατάσταση μέσω του πηγαίου κώδικα είναι η πιο πολύπλοκη, αλλά προσφέρει και τη μεγαλύτερη δυνατή ευελιξία. Η διαδικασία αυτή περιλαμβάνει το συγχρονισμό του τοπικού αντιγράφου του πηγαίου κώδικα του FreeBSD με τον κώδικα του FreeBSD που βρίσκεται στους εξυπηρετητές CVS (Concurrent Versioning System). Από τη στιγμή που το τοπικό αντίγραφο πηγαίου κώδικα είναι ανανεωμένο, μπορείτε να μεταγλωττίσετε νέες εκδόσεις του πυρήνα και των βασικών προγραμμάτων. Για περισσότερες πληροφορίες σχετικά με το σύστημα αναβάθμισης μέσω πηγαίου κώδικα, δείτε το κεφάλαιο link:{handbook}#updating-upgrading[Ενημέρωση και Αναβάθμιση] στο Εγχειρίδιο του FreeBSD.
+Η εγκατάσταση μέσω του πηγαίου κώδικα είναι η πιο πολύπλοκη, αλλά προσφέρει και τη μεγαλύτερη δυνατή ευελιξία. Η διαδικασία αυτή περιλαμβάνει το συγχρονισμό του τοπικού αντιγράφου του πηγαίου κώδικα του FreeBSD με τον κώδικα του FreeBSD που βρίσκεται στους εξυπηρετητές CVS (Concurrent Versioning System). Από τη στιγμή που το τοπικό αντίγραφο πηγαίου κώδικα είναι ανανεωμένο, μπορείτε να μεταγλωττίσετε νέες εκδόσεις του πυρήνα και των βασικών προγραμμάτων. Για περισσότερες πληροφορίες σχετικά με το σύστημα αναβάθμισης μέσω πηγαίου κώδικα, δείτε το κεφάλαιο extref:{handbook}updating-upgrading[Ενημέρωση και Αναβάθμιση, updating-upgrading] στο Εγχειρίδιο του FreeBSD.
Οι έτοιμες (binary) αναβαθμίσεις, είναι παρόμοιες με τη χρήση της εντολής `yum` ή `apt-get` για την αναβάθμιση ενός συστήματος Linux(R). Η εντολή man:freebsd-update[8] θα κατεβάσει τις αναβαθμίσεις και θα τις εγκαταστήσει. Μπορείτε να καθορίσετε την αυτόματη, ανά τακτά διαστήματα εκτέλεση της, με τη χρήση του man:cron[8].
@@ -315,7 +319,7 @@ kern.posix1version: 200112
Κάποιες από τις τιμές που δείχνει η εντολή `sysctl` είναι μόνο για ανάγνωση.
====
-Υπάρχουν περιπτώσεις όπου απαιτείται το procfs, όπως για παράδειγμα όταν εκτελείτε παλιότερο λογισμικό, το οποίο κάνει χρήση της εντολής man:truss[1] για την ανίχνευση των κλήσεων συστήματος, και για την link:{handbook}#linuxemu[Συμβατότητα με Εκτελέσιμα του Linux(R)]. (Αν και η Συμβατότητα με Εκτελέσιμα του Linux(R) χρησιμοποιεί το δικό της procfs, το man:linprocfs[5]). Αν χρειάζεται να προσαρτήσετε το procfs, μπορείτε να προσθέσετε την ακόλουθη εγγραφή στο αρχείο [.filename]#/etc/fstab#:
+Υπάρχουν περιπτώσεις όπου απαιτείται το procfs, όπως για παράδειγμα όταν εκτελείτε παλιότερο λογισμικό, το οποίο κάνει χρήση της εντολής man:truss[1] για την ανίχνευση των κλήσεων συστήματος, και για την extref:{handbook}linuxemu[Συμβατότητα με Εκτελέσιμα του Linux(R), linuxemu]. (Αν και η Συμβατότητα με Εκτελέσιμα του Linux(R) χρησιμοποιεί το δικό της procfs, το man:linprocfs[5]). Αν χρειάζεται να προσαρτήσετε το procfs, μπορείτε να προσθέσετε την ακόλουθη εγγραφή στο αρχείο [.filename]#/etc/fstab#:
[source,shell]
....
@@ -390,4 +394,4 @@ proc /proc procfs rw,noauto 0 0
[[conclusion]]
== Συμπεράσματα
-Ευελπιστούμε ότι αυτό το κείμενο σας παρείχε αρκετές πληροφορίες για να ξεκινήσετε με το FreeBSD. Για περισσότερες και πιο λεπτομερείς πληροφορίες, παρακαλούμε να διαβάσετε το link:{handbook}[Εγχειρίδιο του FreeBSD] το οποίο επίσης περιέχει και πολλά θέματα που δεν καλύφθηκαν καθόλου στο παρόν κείμενο.
+Ευελπιστούμε ότι αυτό το κείμενο σας παρείχε αρκετές πληροφορίες για να ξεκινήσετε με το FreeBSD. Για περισσότερες και πιο λεπτομερείς πληροφορίες, παρακαλούμε να διαβάσετε το extref:{handbook}[Εγχειρίδιο του FreeBSD] το οποίο επίσης περιέχει και πολλά θέματα που δεν καλύφθηκαν καθόλου στο παρόν κείμενο.
diff --git a/documentation/content/el/articles/mailing-list-faq/_index.adoc b/documentation/content/el/articles/mailing-list-faq/_index.adoc
index c111e6c474..eeec49f6f4 100644
--- a/documentation/content/el/articles/mailing-list-faq/_index.adoc
+++ b/documentation/content/el/articles/mailing-list-faq/_index.adoc
@@ -2,7 +2,6 @@
title: Συχνές Ερωτήσεις Σχετικά με τις Λίστες Ηλεκτρονικού Ταχυδρομείου του FreeBSD
authors:
- author: Η Ομάδα Τεκμηρίωσης του FreeBSD
-releaseinfo: "$FreeBSD$"
---
= Συχνές Ερωτήσεις Σχετικά με τις Λίστες Ηλεκτρονικού Ταχυδρομείου του FreeBSD
@@ -14,33 +13,32 @@ releaseinfo: "$FreeBSD$"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
+:images-path: articles/mailing-list-faq/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/el/mailing-lists.adoc[lines=10..-1]
-include::shared/el/urls.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
-include::../../../../shared/el/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
-include::../../../../shared/el/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
Περίληψη
-Το άρθρο αυτό αποτελεί τις συχνές ερωτήσεις για τις λίστες ταχυδρομείου του FreeBSD. Αν ενδιαφέρεστε να βοηθήσετε σε αυτό το έργο, στείλτε ένα email στην {freebsd-doc}. Η τελευταία έκδοση αυτού του εγγράφου είναι πάντοτε διαθέσιμη στην link:{mailing-list-faq}[Δικτυακή τοποθεσία του FreeBSD]. Μπορείτε επίσης να το κατεβάσετε ως ένα μεγάλο αρχείο link:.[HTML] ή και ως απλό κείμενο, PostScript, PDF, κ.λ.π. από τον link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[Διακομιστή FTP του FreeBSD]. Μπορεί επίσης να θέλετε να link:https://www.FreeBSD.org/search/[ψάξετε σε αυτό το άρθρο].
+Το άρθρο αυτό αποτελεί τις συχνές ερωτήσεις για τις λίστες ταχυδρομείου του FreeBSD. Αν ενδιαφέρεστε να βοηθήσετε σε αυτό το έργο, στείλτε ένα email στην {freebsd-doc}. Η τελευταία έκδοση αυτού του εγγράφου είναι πάντοτε διαθέσιμη στην extref:{mailing-list-faq}[Δικτυακή τοποθεσία του FreeBSD]. Μπορείτε επίσης να το κατεβάσετε ως ένα μεγάλο αρχείο link:.[HTML] ή και ως απλό κείμενο, PostScript, PDF, κ.λ.π. από τον link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[Διακομιστή FTP του FreeBSD]. Μπορεί επίσης να θέλετε να link:https://www.FreeBSD.org/search/[ψάξετε σε αυτό το άρθρο].
'''
@@ -94,7 +92,7 @@ toc::[]
=== Τι πρέπει να κάνω πριν από μια δημοσίευση;
-Διαβάζοντας αυτό το κείμενο, έχετε ήδη κάνει το πιο σημαντικό βήμα. Ωστόσο, αν είστε νέος στο FreeBSD, θα πρέπει πρώτα να εξοικειωθείτε με το λογισμικό και όλη την κοινωνική ιστορία που το περιβάλλει, διαβάζοντας τα διάφορα link:https://www.FreeBSD.org/docs/books/[άρθρα και βιβλία] τα οποία είναι διαθέσιμα. Ιδιαίτερο ενδιαφέρον έχουν link:{faq}[Οι Συχνές Ερωτήσεις (FAQ) του FreeBSD], το link:{handbook}[Εγχειρίδιο του FreeBSD] καθώς και τα άρθρα link:{freebsd-questions-article}[Πως να χρησιμοποιείτε με επιτυχία τη λίστα ηλεκτρονικού ταχυδρομείου FreeBSD-questions], link:{explaining-bsd}[Περιγραφή των Συστημάτων BSD], και link:{new-users}[Για Χρήστες Νέους τόσο στο FreeBSD όσο και στο UNIX(R)].
+Διαβάζοντας αυτό το κείμενο, έχετε ήδη κάνει το πιο σημαντικό βήμα. Ωστόσο, αν είστε νέος στο FreeBSD, θα πρέπει πρώτα να εξοικειωθείτε με το λογισμικό και όλη την κοινωνική ιστορία που το περιβάλλει, διαβάζοντας τα διάφορα link:https://www.FreeBSD.org/docs/books/[άρθρα και βιβλία] τα οποία είναι διαθέσιμα. Ιδιαίτερο ενδιαφέρον έχουν extref:{faq}[Οι Συχνές Ερωτήσεις (FAQ) του FreeBSD], το extref:{handbook}[Εγχειρίδιο του FreeBSD] καθώς και τα άρθρα extref:{freebsd-questions-article}[Πως να χρησιμοποιείτε με επιτυχία τη λίστα ηλεκτρονικού ταχυδρομείου FreeBSD-questions], extref:{explaining-bsd}[Περιγραφή των Συστημάτων BSD], και extref:{new-users}[Για Χρήστες Νέους τόσο στο FreeBSD όσο και στο UNIX(R)].
Θεωρείται γενικά κακή συμπεριφορά να ρωτήσετε μια ερώτηση η οποία μπορεί να απαντηθεί από κάποιο από τα παραπάνω κείμενα. Αυτό δεν συμβαίνει επειδή οι εθελοντές που δουλεύουν σε αυτό το έργο είναι κακοί άνθρωποι, αλλά επειδή όταν έχουν απαντήσει την ίδια ερώτηση πολλές φορές, αρχίζει να τους ενοχλεί. Αυτό συμβαίνει ειδικά αν υπάρχει διαθέσιμη η απάντηση της ερώτησης. Να θυμάστε πάντα ότι σχεδόν όλη η δουλειά στο FreeBSD γίνεται από εθελοντές και τελικά είμαστε απλώς άνθρωποι.
@@ -163,7 +161,7 @@ toc::[]
[[bikeshed]]
== Τι είναι το "Bikeshed";
-Κυριολεκτικά το `bikeshed` είναι ένα μικρό εξωτερικό καταφύγιο όπου κάποιος μπορεί να φυλάξει το δίτροχο του (υπόστεγο ποδηλάτων). Στην ορολογία του FreeBSD ωστόσο, η λέξη αυτή χρησιμοποιείται για να αναφερόμαστε σε θέματα συζήτησης που είναι τόσο απλά ώστε (σχεδόν) καθένας να μπορεί να εκφέρει μια γνώμη για αυτά - και πολύ συχνά συμβαίνει ακριβώς αυτό. Η γέννηση αυτού του όρου εξηγείται με περισσότερη λεπτομέρεια σε link:{faq}#BIKESHED-PAINTING[αυτό το κείμενο]. Θα πρέπει να κατανοείτε την έννοια αυτού του όρου πριν αρχίσετε να στέλνετε μηνύματα σε οποιαδήποτε λίστα του FreeBSD.
+Κυριολεκτικά το `bikeshed` είναι ένα μικρό εξωτερικό καταφύγιο όπου κάποιος μπορεί να φυλάξει το δίτροχο του (υπόστεγο ποδηλάτων). Στην ορολογία του FreeBSD ωστόσο, η λέξη αυτή χρησιμοποιείται για να αναφερόμαστε σε θέματα συζήτησης που είναι τόσο απλά ώστε (σχεδόν) καθένας να μπορεί να εκφέρει μια γνώμη για αυτά - και πολύ συχνά συμβαίνει ακριβώς αυτό. Η γέννηση αυτού του όρου εξηγείται με περισσότερη λεπτομέρεια σε extref:{faq}[αυτό το κείμενο, BIKESHED-PAINTING]. Θα πρέπει να κατανοείτε την έννοια αυτού του όρου πριν αρχίσετε να στέλνετε μηνύματα σε οποιαδήποτε λίστα του FreeBSD.
Πιο γενικά, το bikeshed είναι ένα θέμα το οποίο τείνει να δημιουργεί περισσότερες παράπλευρες συζητήσεις και λεκτικούς διαξιφισμούς, αν δεν έχετε διαβάσει σχετικά με την προϊστορία του.
@@ -173,7 +171,7 @@ toc::[]
== Ευχαριστίες
`{grog}`::
-Ο αρχικός συγγραφέας του περισσότερου υλικού που αφορά τους κανονισμούς των λιστών, που προέρχονται από το άρθρο link:{freebsd-questions-article}[Πως να χρησιμοποιείτε με επιτυχία την λίστα ηλεκτρονικού ταχυδρομείου FreeBSD-questions].
+Ο αρχικός συγγραφέας του περισσότερου υλικού που αφορά τους κανονισμούς των λιστών, που προέρχονται από το άρθρο extref:{freebsd-questions-article}[Πως να χρησιμοποιείτε με επιτυχία την λίστα ηλεκτρονικού ταχυδρομείου FreeBSD-questions].
`{linimon}`::
Δημιουργία του πρόχειρου αντίγραφου αυτού του FAQ.
diff --git a/documentation/content/el/articles/nanobsd/_index.adoc b/documentation/content/el/articles/nanobsd/_index.adoc
index 9a9ce0a9c5..c628938c70 100644
--- a/documentation/content/el/articles/nanobsd/_index.adoc
+++ b/documentation/content/el/articles/nanobsd/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Daniel Gerzo
- author: Κυριάκος Κεντρωτής
copyright: 2006, 2009 Η Ομάδα Τεκμηρίωσης του FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -17,21 +16,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
+:images-path: articles/nanobsd/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
diff --git a/documentation/content/el/articles/new-users/_index.adoc b/documentation/content/el/articles/new-users/_index.adoc
index 049ea57bf2..c94f810554 100644
--- a/documentation/content/el/articles/new-users/_index.adoc
+++ b/documentation/content/el/articles/new-users/_index.adoc
@@ -3,7 +3,6 @@ title: Για Χρήστες Νέους τόσο στο FreeBSD όσο και σ
authors:
- author: Annelise Anderson
email: andrsn@andrsn.stanford.edu
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"]
---
@@ -16,21 +15,26 @@ trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-
-ifeval::["{backend}" == "html5"]
-include::shared/el/urls.adoc[]
+:images-path: articles/new-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/el/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/el/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -303,7 +307,7 @@ kbd:[Ctrl+b] and kbd:[Ctrl+f]::
και να επανεκκινήσετε το σύστημά σας σε DOS. Αντιγράψτε αυτά τα αρχεία σε ένα DOS κατάλογο, ανοίξτε τα με το DOS EDIT, το Windows(R) Notepad ή το Wordpad, ή ένα επεξεργαστή κειμένου, κάντε μια μικρή αλλαγή έτσι ώστε να πρέπει το αρχείο να σωθεί, και τυπώστε όπως συνήθως από το DOS ή τα Windows(R). Ελπίζω να δουλέψει! Οι σελίδες man τυπώνονται πολύ όμορφα αν χρησιμοποιήσετε την εντολή `print` του DOS. (Η αντιγραφή αρχείων από το FreeBSD σε ένα mounted DOS τμήμα δίσκου είναι σε μερικές περιπτώσεις επικίνδυνο πράγμα.)
-Το να κάνετε ένα εκτυπωτή στο FreeBSD να τυπώσει απαιτεί να φτιάξετε μια κατάλληλη εγγραφή στο αρχείο [.filename]#/etc/printcap# και να δημιουργήσετε ένα spool κατάλογο στο [.filename]#/var/spool/output#. Αν ο εκτυπωτής σας είναι στην θύρα `lpt0` (αυτή που το DOS αποκαλεί `LPT1`), μπορεί απλά να χρειάζεται να πάτε στον κατάλογο [.filename]#/var/spool/output# και (σαν `root`) να δημιουργήσετε ένα υποκατάλογο [.filename]#lpd# γράφοντας: `mkdir lpd`, αν δεν υπάρχει ήδη. Τότε ο εκτυπωτής θα πρέπει να απαντάει αν είναι ανοιχτός όταν το σύστημα ξεκινάει, και οι εντολές `lp` και `lpr` θα πρέπει να στέλνουν ένα αρχείο στον εκτυπωτή. Αν το αρχείο θα τυπωθεί ή όχι, εξαρτάται από το αν ο εκτυπωτής έχει ρυθμιστεί σωστά, κάτι που καλύπτει το link:{handbook}[handbook του FreeBSD.]
+Το να κάνετε ένα εκτυπωτή στο FreeBSD να τυπώσει απαιτεί να φτιάξετε μια κατάλληλη εγγραφή στο αρχείο [.filename]#/etc/printcap# και να δημιουργήσετε ένα spool κατάλογο στο [.filename]#/var/spool/output#. Αν ο εκτυπωτής σας είναι στην θύρα `lpt0` (αυτή που το DOS αποκαλεί `LPT1`), μπορεί απλά να χρειάζεται να πάτε στον κατάλογο [.filename]#/var/spool/output# και (σαν `root`) να δημιουργήσετε ένα υποκατάλογο [.filename]#lpd# γράφοντας: `mkdir lpd`, αν δεν υπάρχει ήδη. Τότε ο εκτυπωτής θα πρέπει να απαντάει αν είναι ανοιχτός όταν το σύστημα ξεκινάει, και οι εντολές `lp` και `lpr` θα πρέπει να στέλνουν ένα αρχείο στον εκτυπωτή. Αν το αρχείο θα τυπωθεί ή όχι, εξαρτάται από το αν ο εκτυπωτής έχει ρυθμιστεί σωστά, κάτι που καλύπτει το extref:{handbook}[handbook του FreeBSD.]
[[other-useful-commands]]
== Άλλες Χρήσιμες Εντολές
diff --git a/documentation/content/el/articles/problem-reports/_index.adoc b/documentation/content/el/articles/problem-reports/_index.adoc
index 81f8b6e62a..c443f7c92c 100644
--- a/documentation/content/el/articles/problem-reports/_index.adoc
+++ b/documentation/content/el/articles/problem-reports/_index.adoc
@@ -2,7 +2,6 @@
title: Γράφοντας Αναφορές Προβλημάτων για το FreeBSD
authors:
- author: Dag-Erling Smørgrav
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "cvsup", "ibm", "intel", "sparc", "sun", "general"]
---
@@ -15,24 +14,26 @@ trademarks: ["freebsd", "cvsup", "ibm", "intel", "sparc", "sun", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-
-ifeval::["{backend}" == "html5"]
-include::shared/el/mailing-lists.adoc[lines=10..-1]
-include::shared/el/urls.adoc[]
+:images-path: articles/problem-reports/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
-include::../../../../shared/el/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
-include::../../../../shared/el/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -71,7 +72,7 @@ toc::[]
+
Όταν ένα πακέτο είναι υπό την επίβλεψη κάποιου, συνήθως δεν είναι ιδιαίτερα χρήσιμες οι αναφορές που απλώς ανακοινώνουν μια καινούρια έκδοση από τον συγγραφέα του πηγαίου κώδικα του πακέτου. Συνήθως το ξέρει ήδη ο υπεύθυνος του πακέτου για το FreeBSD, ή έχει συνεργαστεί με τον συγγραφέα του πηγαίου κώδικα για τη νέα έκδοση, ή δοκιμάζει το πακέτο για να δει ότι όλα εξακολουθούν να δουλεύουν, κοκ.
+
-Όπως και να 'χει, είναι καλή ιδέα να ακολουθήσετε τη διαδικασία από το link:{porters-handbook}#port-upgrading[Porter's Handbook].
+Όπως και να 'χει, είναι καλή ιδέα να ακολουθήσετε τη διαδικασία από το extref:{porters-handbook}[Porter's Handbook, port-upgrading].
Ένα bug που δεν μπορεί κανείς να το αναπαράγει είναι πολύ δύσκολο να διορθωθεί. Αν το bug εμφανίστηκε μια φορά μόνο και δεν μπορείτε να το αναπαράγετε εσείς, και φαινομενικά δεν εμφανίζεται σε κανέναν άλλο, είναι πολύ μικρές οι πιθανότητες να μπορεί κάποιος προγραμματιστής να το ανακαλύψει και να καταλάβει τί είναι αυτό που προκαλεί το λάθος. Αυτό δεν σημαίνει πως δεν συμβαίνει, αλλά σημαίνει πως η πιθανότητα να οδηγήσει η αναφορά σας στην λύση του προβλήματος είναι πάρα πολύ μικρή, και μάλλον είναι καλύτερο να σταματήσετε να ασχολείστε με το θέμα. Ακόμα χειρότερα, κάποιες φορές αυτού του είδους τα προβλήματα οφείλονται σε προβλήματα του υλικού (χαλασμένους σκληρούς δίσκους ή επεξεργαστές που υπερθερμαίνονται). Πρέπει πάντοτε πριν στέλνετε μια αναφορά προβλήματος, όταν φυσικά είναι δυνατόν να γίνει κάτι τέτοιο, να προσπαθείτε να αποκλείσετε τέτοιες περιπτώσεις.
@@ -83,7 +84,7 @@ toc::[]
Τέλος, ελέγξτε ότι η αναφορά που στέλνετε αφορά ένα πρόβλημα το οποίο υπάρχει ακόμα. Μερικές φορές είναι κάπως ενοχλητικό για έναν προγραμματιστή να παίρνει ειδοποιήσεις για ένα πρόβλημα το οποίο έχει ήδη διορθωθεί.
-Αν το πρόβλημα που αντιμετωπίζετε αφορά το βασικό σύστημα και δεν έχετε ενημερωθεί ήδη για τις τελευταίες εκδόσεις του FreeBSD, διαβάστε το τμήμα link:{faq}#LATEST-VERSION[εκδόσεις του FreeBSD] στη Λίστα Συχνών Ερωτήσεων του FreeBSD. Η ομάδα του FreeBSD μπορεί να συντηρεί μόνο ένα ορισμένο (μικρό) αριθμό κλάδων ανάπτυξης του FreeBSD. Δε μπορεί να διορθώνει προβλήματα για οποιαδήποτε έκδοση του FreeBSD. Οπότε αν αναφέρετε ότι έχετε πρόβλημα με μια πολύ παλιά έκδοση του συστήματος, η πιο πιθανή απάντηση που θα πάρετε θα είναι να αναβαθμίσετε το σύστημά σας σε μια έκδοση που υποστηρίζεται επίσημα από την ομάδα του FreeBSD και να κάνετε δοκιμές για να δείτε αν το πρόβλημα έχει ήδη διορθωθεί ή υπάρχει ακόμη. Η Ομάδα Ασφάλειας του FreeBSD συντηρεί και ενημερώνει μια http://www.freebsd.org/security/[λίστα εκδόσεων του FreeBSD που υποστηρίζονται επίσημα].
+Αν το πρόβλημα που αντιμετωπίζετε αφορά το βασικό σύστημα και δεν έχετε ενημερωθεί ήδη για τις τελευταίες εκδόσεις του FreeBSD, διαβάστε το τμήμα extref:{faq}[εκδόσεις του FreeBSD, LATEST-VERSION] στη Λίστα Συχνών Ερωτήσεων του FreeBSD. Η ομάδα του FreeBSD μπορεί να συντηρεί μόνο ένα ορισμένο (μικρό) αριθμό κλάδων ανάπτυξης του FreeBSD. Δε μπορεί να διορθώνει προβλήματα για οποιαδήποτε έκδοση του FreeBSD. Οπότε αν αναφέρετε ότι έχετε πρόβλημα με μια πολύ παλιά έκδοση του συστήματος, η πιο πιθανή απάντηση που θα πάρετε θα είναι να αναβαθμίσετε το σύστημά σας σε μια έκδοση που υποστηρίζεται επίσημα από την ομάδα του FreeBSD και να κάνετε δοκιμές για να δείτε αν το πρόβλημα έχει ήδη διορθωθεί ή υπάρχει ακόμη. Η Ομάδα Ασφάλειας του FreeBSD συντηρεί και ενημερώνει μια http://www.freebsd.org/security/[λίστα εκδόσεων του FreeBSD που υποστηρίζονται επίσημα].
Αν το πρόβλημα που αντιμετωπίζετε αφορά ένα πακέτο, τότε πρέπει κατ' αρχήν να ενημερώσετε τα Ports σας στην τελευταία έκδοση της Συλλογής των Ports και να δείτε αν το πρόβλημα υπάρχει ακόμα. Οι εφαρμογές που περιέχονται στη Συλλογή των Ports αλλάζουν πολύ γρήγορα. Λόγω του γρήγορου ρυθμού με τον οποίο ενημερώνονται είναι πρακτικά αδύνατον για την ομάδα του FreeBSD να υποστηρίξει οποιαδήποτε παλιότερη έκδοση των Ports. Αυτό σημαίνει ότι τα προβλήματα που έχουν οι παλιές εκδόσεις κάποιων προγραμμάτων απλά δε γίνεται να διορθωθούν.
@@ -92,8 +93,8 @@ toc::[]
Είναι καλή ιδέα να κάνετε πάντα μια μικρή έρευνα πριν να στείλετε κάποια αναφορά προβλήματος. Μπορεί το πρόβλημά σας να το έχει ήδη αναφέρει και κάποιος άλλος. Μπορεί να είναι θέμα συζητήσεων σε κάποια λίστα ηλεκτρονικού ταχυδρομείου ή να ήταν πρόσφατα. Μπορεί ακόμα, να είναι ήδη διορθωμένο το πρόβλημα σε κάποια έκδοση νεώτερη από αυτή που τρέχετε. Πρέπει λοιπόν να ελέγχετε όλα τα προφανή σημεία, πριν να στείλετε μια αναφορά προβλήματος. Για το FreeBSD αυτό σημαίνει:
-* Την link:{faq}[λίστα] με τις πιο συχνές ερωτήσεις (FAQ) για το FreeBSD. Η λίστα αυτή παρέχει απαντήσεις σε μια μεγάλη ποικιλία ερωτήσεων, όπως αυτές που αφορούν link:{faq}#hardware[το υλικό], link:{faq}#applications[τις εφαρμογές] και τις link:{faq}#kernelconfig[ρυθμίσεις του πυρήνα].
-* Οι link:{handbook}#eresources-mail[λίστες ηλεκτρονικού ταχυδρομείου]-αν δεν έχετε γραφτεί σε κάποια από αυτές, μπορείτε να χρησιμοποιήσετε το http://www.FreeBSD.org/search/#mailinglists[αρχείο] στις σελίδες του FreeBSD για να αναζητήσετε πληροφορίες σχετικές με το πρόβλημα. Αν το πρόβλημά σας δεν έχει συζητηθεί στις λίστες είναι, γενικά, καλή ιδέα να στείλετε ένα γράμμα στις λίστες ηλεκτρονικού ταχυδρομείου και να περιμένετε λίγες μέρες μήπως κάποιος βρει κάτι που εσείς δεν προσέξατε.
+* Την extref:{faq}[λίστα] με τις πιο συχνές ερωτήσεις (FAQ) για το FreeBSD. Η λίστα αυτή παρέχει απαντήσεις σε μια μεγάλη ποικιλία ερωτήσεων, όπως αυτές που αφορούν extref:{faq}[το υλικό, hardware], extref:{faq}[τις εφαρμογές, applications] και τις extref:{faq}[ρυθμίσεις του πυρήνα, kernelconfig].
+* Οι extref:{handbook}eresources[λίστες ηλεκτρονικού ταχυδρομείου, eresources-mail]-αν δεν έχετε γραφτεί σε κάποια από αυτές, μπορείτε να χρησιμοποιήσετε το http://www.FreeBSD.org/search/#mailinglists[αρχείο] στις σελίδες του FreeBSD για να αναζητήσετε πληροφορίες σχετικές με το πρόβλημα. Αν το πρόβλημά σας δεν έχει συζητηθεί στις λίστες είναι, γενικά, καλή ιδέα να στείλετε ένα γράμμα στις λίστες ηλεκτρονικού ταχυδρομείου και να περιμένετε λίγες μέρες μήπως κάποιος βρει κάτι που εσείς δεν προσέξατε.
* Προαιρετικά, όλο το δίκτυο. Χρησιμοποιήστε την αγαπημένη σας μηχανή αναζήτησης για να βρείτε πληροφορίες σχετικά με το πρόβλημα. Έτσι μπορεί να βρείτε ακόμη και αναφορές από λίστες ηλεκτρονικού ταχυδρομείου ή ομάδες συζητήσεων που δεν ξέρατε ότι υπάρχουν ή δεν σκεφτήκατε να ψάξετε.
* Ύστερα μπορείτε να αναζητήσετε σχετικές αναφορές στην http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[βάση αναφορών του FreeBSD] (GNATS). Αν το πρόβλημά σας δεν είναι πρόσφατο ή αρκετά περίεργο, είναι πολύ πιθανόν να έχει ήδη στείλει κάποιος άλλος μια αναφορά.
* Το πιο σημαντικό από όλα όμως είναι να δείτε μήπως η τεκμηρίωση του FreeBSD περιέχει κάποια λύση στο πρόβλημά σας.
@@ -140,7 +141,7 @@ toc::[]
Αν χρησιμοποιείτε το πρόγραμμα man:send-pr[1], σιγουρευτείτε ότι η μεταβλητή περιβάλλοντος `VISUAL` (ή η μεταβλητή περιβάλλοντος `EDITOR` αν δεν είναι ορισμένη η `VISUAL`) έχει κάποια λογική τιμή.
-Ελέγξτε επίσης ότι η αποστολή ηλεκτρονικής αλληλογραφίας λειτουργεί σωστά. Το πρόγραμμα man:send-pr[1] χρησιμοποιεί μηνύματα ηλεκτρονικής αλληλογραφίας για την αποστολή και την παρακολούθηση των αναφορών προβλημάτων. Αν δε μπορείτε να στείλετε μηνύματα ηλεκτρονικής αλληλογραφίας από το μηχάνημα στο οποίο χρησιμοποιείτε το πρόγραμμα man:send-pr[1], το μήνυμά σας και η αναφορά δε θα φτάσει ποτέ στη βάση αναφορών προβλημάτων του FreeBSD. Για λεπτομέρειες σχετικά με τη ρύθμιση της ηλεκτρονικής αλληλογραφίας στο FreeBSD δείτε το κεφάλαιο περί "Ηλεκτρονικής Αλληλογραφίας" στο Εγχειρίδιο του FreeBSD στη διεύθυνση link:{handbook}#mail[Electronic Mail].
+Ελέγξτε επίσης ότι η αποστολή ηλεκτρονικής αλληλογραφίας λειτουργεί σωστά. Το πρόγραμμα man:send-pr[1] χρησιμοποιεί μηνύματα ηλεκτρονικής αλληλογραφίας για την αποστολή και την παρακολούθηση των αναφορών προβλημάτων. Αν δε μπορείτε να στείλετε μηνύματα ηλεκτρονικής αλληλογραφίας από το μηχάνημα στο οποίο χρησιμοποιείτε το πρόγραμμα man:send-pr[1], το μήνυμά σας και η αναφορά δε θα φτάσει ποτέ στη βάση αναφορών προβλημάτων του FreeBSD. Για λεπτομέρειες σχετικά με τη ρύθμιση της ηλεκτρονικής αλληλογραφίας στο FreeBSD δείτε το κεφάλαιο περί "Ηλεκτρονικής Αλληλογραφίας" στο Εγχειρίδιο του FreeBSD στη διεύθυνση extref:{handbook}mail[Electronic Mail, mail].
Σιγουρευτείτε ότι το πρόγραμμα αλληλογραφίας το οποίο χρησιμοποιείτε δεν θα αλλάξει ούτε το περιεχόμενο ούτε τη μορφή του κειμένου που στέλνετε πριν αυτό φτάσει στο σύστημα GNATS του FreeBSD. Πιο συγκεκριμένα, αν το πρόγραμμα αλληλογραφίας σας αποφασίζει αυτόματα για το μήκος κάθε γραμμής κειμένου, αλλάζει τους χαρακτήρες στηλοθέτη με κενά ή επεμβαίνει στους χαρακτήρες αλλαγής γραμμής, τότε κάθε patch που στέλνετε μπορεί να είναι εντελώς άχρηστο. Από την άλλη, στα πεδία της αναφοράς προβλήματος τα οποία περιέχουν απλό κείμενο είναι πιο βολικό να έχει περίπου 70 στήλες η κάθε γραμμή. Έτσι διαβάζεται πιο εύκολα το κείμενο της αναφοράς μέσα από το web interface μας.
@@ -271,4 +272,4 @@ Subject: Re: ports/12345: compilation problem with foo/bar
Παρακάτω θα βρείτε κάποιες πηγές που είναι σχετικές με το θέμα των αναφορών προβλήματος. Δεν είναι μια πλήρης ή επαρκής λίστα, φυσικά.
* http://www.chiark.greenend.org.uk/~sgtatham/bugs.html[How to Report Bugs Effectively]-μια πολύ καλή έκθεση από τον Simon G. Tatham που περιγράφει πως μπορείτε να γράφετε χρήσιμες αναφορές προβλήματων (όχι μόνο για το FreeBSD).
-* link:{pr-guidelines}[Problem Report Handling Guidelines]-χρήσιμες πληροφορίες για τον τρόπο με τον οποίο χειρίζεται τις αναφορές προβλημάτων η ομάδα ανάπτυξης του FreeBSD
+* extref:{pr-guidelines}[Problem Report Handling Guidelines]-χρήσιμες πληροφορίες για τον τρόπο με τον οποίο χειρίζεται τις αναφορές προβλημάτων η ομάδα ανάπτυξης του FreeBSD
diff --git a/documentation/content/el/articles/releng/_index.adoc b/documentation/content/el/articles/releng/_index.adoc
index 75b2330cb9..79b3fa255f 100644
--- a/documentation/content/el/articles/releng/_index.adoc
+++ b/documentation/content/el/articles/releng/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Murray Stokely
email: murray@FreeBSD.org
webpage: https://people.FreeBSD.org/~murray/
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "intel", "general"]
---
@@ -17,34 +16,26 @@ trademarks: ["freebsd", "intel", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:xrefstyle: full
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
+:images-path: articles/releng/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[lines=10..-1]
-include::shared/el/teams.adoc[lines=21..-1]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
-include::../../../../shared/el/teams.adoc[lines=21..-1]
-include::../../../../shared/el/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/el/mailing-lists.adoc[lines=10..-1]
-include::../../../../shared/el/teams.adoc[lines=21..-1]
-include::../../../../shared/el/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -189,7 +180,7 @@ __Οι ετικέτες ``RELENG_*`` είναι δεσμευμένες για χ
* `CVSROOT` - Ο κατάλογος στον οποίο βρίσκεται το CVS repository.
* `RELEASETAG` - Η ετικέτα CVS που αντιστοιχεί στην έκδοση την οποία θέλετε να μεταγλωττίσετε.
-Αν δεν έχετε ήδη πρόσβαση σε κάποιο τοπικό CVS repository με τον κώδικα του FreeBSD, μπορείτε πάντα να φτιάξετε το δικό σας τοπικό CVS mirror με το link:{handbook}#synching[CVSup]. Υπάρχει ένα supfile, στο αρχείο [.filename]#/usr/shared/examples/cvsup/cvs-supfile#, το οποίο μπορείτε να χρησιμοποιήσετε για να αντιγράψετε το CVS repository του FreeBSD στο δικό σας τοπικό mirrror.
+Αν δεν έχετε ήδη πρόσβαση σε κάποιο τοπικό CVS repository με τον κώδικα του FreeBSD, μπορείτε πάντα να φτιάξετε το δικό σας τοπικό CVS mirror με το extref:{handbook}updating-upgrading[CVSup, synching]. Υπάρχει ένα supfile, στο αρχείο [.filename]#/usr/shared/examples/cvsup/cvs-supfile#, το οποίο μπορείτε να χρησιμοποιήσετε για να αντιγράψετε το CVS repository του FreeBSD στο δικό σας τοπικό mirrror.
Αν παραλείψετε την ετικέτα `RELEASETAG`, τότε θα μεταγλωττιστεί μια πλήρης έκδοση από την κορυφή του `HEAD` (δηλ. του -CURRENT) κορμού. Οι εκδόσεις που φτιάχνονται από αυτόν τον κορμό, συνήθως αναφέρονται σαν "-CURRENT snapshots".
@@ -291,7 +282,7 @@ make release CHROOTDIR=/local3/release \
[.filename]#/pub/FreeBSD/releases/arch/ISO-IMAGES/X.Y/X.Y-*.iso#::
Τα αρχεία ISO.
-Για περισσότερες πληροφορίες σχετικά με την οργάνωση των mirror διανομής FTP του FreeBSD, παρακαλώ δείτε το άρθρο link:{hubs}[Φτιάχνοντας ένα FreeBSD mirror].
+Για περισσότερες πληροφορίες σχετικά με την οργάνωση των mirror διανομής FTP του FreeBSD, παρακαλώ δείτε το άρθρο extref:{hubs}[Φτιάχνοντας ένα FreeBSD mirror].
Μπορεί να πάρει αρκετές ώρες από την στιγμή που θα ενημερωθεί ο `ftp-master` μέχρι να ενημερωθούν στην πλειοψηφία τους τα πρώτου επιπέδου FTP mirror με την νέα έκδοση. Επιβάλλεται οι υπεύθυνοι έκδοσης να συνεννοηθούν με την {freebsd-hubs} πριν ανακοινώσουν την γενική διαθεσιμότητα της νέας έκδοσης στους εξυπηρετητές FTP.
@@ -359,11 +350,11 @@ make release CHROOTDIR=/local3/release \
(5) The libh Project http://www.FreeBSD.org/projects/libh/[http://www.FreeBSD.org/projects/libh/]
-(6) link:{contributors}#staff-committers[FreeBSD Committers]
+(6) extref:{contributors}[FreeBSD Committers, staff-committers]
-(7) link:{contributors}#staff-core[FreeBSD Core-Team]
+(7) extref:{contributors}[FreeBSD Core-Team, staff-core]
-(8) link:{handbook}[FreeBSD Handbook]
+(8) extref:{handbook}[FreeBSD Handbook]
(9) GNATS: The GNU Bug Tracking System http://www.gnu.org/software/gnats[http://www.gnu.org/software/gnats]
diff --git a/documentation/content/el/books/faq/_index.adoc b/documentation/content/el/books/faq/_index.adoc
index 25b5afbced..eedac8c88f 100644
--- a/documentation/content/el/books/faq/_index.adoc
+++ b/documentation/content/el/books/faq/_index.adoc
@@ -1,71 +1,57 @@
---
-title: Συχνές Ερωτήσεις για το FreeBSD 6.X και 7.X
+title: Συχνές Ερωτήσεις για το FreeBSD 11.X, 12.X και 13.X
authors:
- author: Η Ομάδα Τεκμηρίωσης του FreeBSD
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "ibm", "ieee", "3com", "adobe", "intel", "linux", "microsoft", "opengroup", "sparc", "sun", "oracle", "xfree86", "general"]
+trademarks: ["freebsd", "ibm", "ieee", "3com", "adobe", "intel", "linux", "microsoft", "opengroup", "sparc", "sun", "oracle", "xfree86", "general"]
+isIndex: true
---
-= Συχνές Ερωτήσεις για το FreeBSD 6.X και 7.X
+= Συχνές Ερωτήσεις για το FreeBSD {rel2-relx} και {rel-relx}
:doctype: book
:toc: macro
:toclevels: 1
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:part-signifier: Μέρος
-:chapter-signifier: Κεφάλαιο
-:appendix-caption: Παράρτημα
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:rel-numbranch: 3
-:rel-head: 13-CURRENT
-:rel-head-relx: 13.X
+:images-path: books/faq/
+:rel-numbranch: 4
+:rel-head: 14-CURRENT
+:rel-head-relx: 14.X
:rel-head-releng: head/
-:rel-relx: 12.X
-:rel-stable: 12-STABLE
-:rel-releng: stable/12/
+:rel-relx: 13.X
+:rel-stable: 13-STABLE
+:rel-releng: stable/13/
:rel-relengdate: December 2018
-:rel2-relx: 11.X
-:rel2-stable: 11-STABLE
-:rel2-releng: stable/11/
-:rel2-relengdate: October 2016
-
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+:rel2-relx: 12.X
+:rel2-stable: 12-STABLE
+:rel2-releng: stable/12/
+:rel2-relengdate: December 2018
+:rel3-relx: 11.X
+:rel3-stable: 11-STABLE
+:rel3-releng: stable/11/
+:rel3-relengdate: October 2016
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/el/mailing-lists.adoc[]
-include::../../../../shared/el/teams.adoc[]
-include::../../../../shared/el/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/el/mailing-lists.adoc[]
-include::../../../../shared/el/teams.adoc[]
-include::../../../../shared/el/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -91,7 +77,7 @@ toc::[]
Το FreeBSD χρησιμοποιείται από εταιρίες, παροχείς υπηρεσιών Internet (ISPs), ερευνητές, επαγγελματίες της Πληροφορικής, φοιτητές και οικιακούς χρήστες από όλο τον κόσμο, στη δουλειά τους, στην εκπαίδευση και για αναψυχή.
-Για περισσότερες λεπτομέρειες σχετικά με το FreeBSD, παρακαλούμε διαβάστε το link:{handbook}[Εγχειρίδιο του FreeBSD].
+Για περισσότερες λεπτομέρειες σχετικά με το FreeBSD, παρακαλούμε διαβάστε το extref:{handbook}[Εγχειρίδιο του FreeBSD].
=== Ποιος είναι ο σκοπός του FreeBSD Project;
@@ -114,7 +100,7 @@ toc::[]
Αν χρειάζεται να χρησιμοποιήσετε μια εφαρμογή που είναι διαθέσιμη σε ένα μόνο λειτουργικό σύστημα, τότε απλά δεν μπορείτε να αντικαταστήσετε αυτό το λειτουργικό σύστημα. Είναι, όμως, πολύ πιθανό ότι θα βρείτε μια αντίστοιχη εφαρμογή στο FreeBSD. Αν θέλετε έναν σταθερό εξυπηρετητή για το γραφείο σας ή για το Internet, ένα αξιόπιστο σταθμό εργασίας, ή απλώς την ικανότητα να κάνετε την εργασία σας χωρίς διακοπές, είναι σχεδόν σίγουρο ότι το FreeBSD μπορεί να κάνει ότι χρειάζεστε. Πολλοί χρήστες υπολογιστών σε όλο τον κόσμο - τόσο αρχάριοι όσο και έμπειροι διαχειριστές συστημάτων UNIX(R) - χρησιμοποιούν το FreeBSD ως το βασικό λειτουργικό σύστημα στους σταθμούς εργασίας τους.
-Αν έρχεστε στο FreeBSD από κάποιο άλλο περιβάλλον τύπου UNIX(R), ξέρετε ήδη τα περισσότερα από αυτά που χρειάζεστε. Αν ωστόσο η εμπειρία σας προέρχεται από λειτουργικά συστήματα με γραφικό περιβάλλον, όπως τα Windows(R) και οι παλιότερες εκδόσεις του Mac OS(R), θα πρέπει να επενδύσετε, όπως είναι αναμενόμενο, επιπλέον χρόνο για να εξοικειωθείτε με τον τρόπο εργασίας σε ένα σύστημα UNIX(R). Αυτό το FAQ, καθώς και το link:{handbook}[Εγχειρίδιο του FreeBSD] αποτελούν εξαιρετικά αναγνώσματα για να ξεκινήσετε.
+Αν έρχεστε στο FreeBSD από κάποιο άλλο περιβάλλον τύπου UNIX(R), ξέρετε ήδη τα περισσότερα από αυτά που χρειάζεστε. Αν ωστόσο η εμπειρία σας προέρχεται από λειτουργικά συστήματα με γραφικό περιβάλλον, όπως τα Windows(R) και οι παλιότερες εκδόσεις του Mac OS(R), θα πρέπει να επενδύσετε, όπως είναι αναμενόμενο, επιπλέον χρόνο για να εξοικειωθείτε με τον τρόπο εργασίας σε ένα σύστημα UNIX(R). Αυτό το FAQ, καθώς και το extref:{handbook}[Εγχειρίδιο του FreeBSD] αποτελούν εξαιρετικά αναγνώσματα για να ξεκινήσετε.
=== Γιατί ονομάζεται FreeBSD;
@@ -146,7 +132,7 @@ Version link:ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/{rel120-current}-RE
=== Τι είναι το FreeBSD-CURRENT;
-Το link:{handbook}#CURRENT[FreeBSD-CURRENT] είναι η υπό εξέλιξη έκδοση του λειτουργικού συστήματος, το οποίο με τον καιρό θα εξελιχθεί στο νέο κλάδο FreeBSD-STABLE. Για το λόγο αυτό, παρουσιάζει συνήθως ενδιαφέρον μόνο σε όσους ασχολούνται με την ανάπτυξη κώδικα του συστήματος και σε σκληροπυρηνικούς χομπίστες. Δείτε το link:{handbook}#CURRENT[σχετικό τμήμα] στο link:{handbook}[εγχειρίδιο] για λεπτομέρειες σχετικά με το -CURRENT.
+Το extref:{handbook}updating-upgrading[FreeBSD-CURRENT, current] είναι η υπό εξέλιξη έκδοση του λειτουργικού συστήματος, το οποίο με τον καιρό θα εξελιχθεί στο νέο κλάδο FreeBSD-STABLE. Για το λόγο αυτό, παρουσιάζει συνήθως ενδιαφέρον μόνο σε όσους ασχολούνται με την ανάπτυξη κώδικα του συστήματος και σε σκληροπυρηνικούς χομπίστες. Δείτε το extref:{handbook}updating-upgrading[σχετικό τμήμα, current] στο extref:{handbook}[εγχειρίδιο] για λεπτομέρειες σχετικά με το -CURRENT.
Αν δεν είστε εξοικειωμένος με το λειτουργικό σύστημα, ή δεν είστε ικανός να αναγνωρίσετε τη διαφορά μεταξύ ενός πραγματικού και ενός προσωρινού προβλήματος, μάλλον δεν θα πρέπει να χρησιμοποιήσετε το FreeBSD-CURRENT. Ο κλάδος αυτός ορισμένες φορές εξελίσσεται πολύ γρήγορα, και μπορεί ακόμα και η μεταγλώττιση του να μην είναι δυνατή για αρκετές συνεχόμενες μέρες. Όσοι χρησιμοποιούν το FreeBSD-CURRENT αναμένεται να είναι ικανοί να αναλύουν τα όποια προβλήματα και να τα αναφέρουν μόνο αν θεωρούν ότι πρόκειται για σημαντικά λάθη και όχι για "μικροπροβλήματα". Ερωτήσεις του τύπου "το make world παράγει κάποια σφάλματα σχετικά με τα groups" στη λίστα ταχυδρομείου -CURRENT, μπορεί να αντιμετωπιστούν περιφρονητικά.
@@ -165,7 +151,7 @@ Version link:ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/{rel120-current}-RE
=== Τι είναι το FreeBSD-STABLE;
-Όταν κυκλοφόρησε το FreeBSD 2.0.5, η ανάπτυξη του FreeBSD χωρίστηκε σε δύο κλάδους. Ο ένας κλάδος ονομάστηκε link:{handbook}#STABLE[-STABLE], και ο άλλος link:{handbook}#CURRENT[-CURRENT]. Το _FreeBSD-STABLE_ απευθύνεται σε Παροχείς Υπηρεσιών Internet (ISPs) και άλλες εμπορικές χρήσεις, όπου οι απότομες αλλαγές και τα τυχόν πειραματικά χαρακτηριστικά είναι γενικά ανεπιθύμητα. Στον κλάδο αυτό ενσωματώνονται μόνο καλά δοκιμασμένες διορθώσεις και άλλες μικρές αλλαγές. Από την άλλη μεριά, το _FreeBSD-CURRENT_ βρίσκεται σε μια μοναδική αδιάκοπη γραμμή ανάπτυξης από την εποχή της κυκλοφορίας της έκδοσης 2.0, οδηγώντας προς την έκδοση {rel120-current}-RELEASE αλλά και μετά από αυτή. Για περισσότερες πληροφορίες δείτε το άρθρο "link:{releng}#REL-BRANCH[Προετοιμασία Εκδόσεων του FreeBSD: Δημιουργία του Κλάδου Έκδοσης]".
+Όταν κυκλοφόρησε το FreeBSD 2.0.5, η ανάπτυξη του FreeBSD χωρίστηκε σε δύο κλάδους. Ο ένας κλάδος ονομάστηκε extref:{handbook}updating-upgrading[-STABLE, stable], και ο άλλος extref:{handbook}updating-upgrading[-CURRENT, current]. Το _FreeBSD-STABLE_ απευθύνεται σε Παροχείς Υπηρεσιών Internet (ISPs) και άλλες εμπορικές χρήσεις, όπου οι απότομες αλλαγές και τα τυχόν πειραματικά χαρακτηριστικά είναι γενικά ανεπιθύμητα. Στον κλάδο αυτό ενσωματώνονται μόνο καλά δοκιμασμένες διορθώσεις και άλλες μικρές αλλαγές. Από την άλλη μεριά, το _FreeBSD-CURRENT_ βρίσκεται σε μια μοναδική αδιάκοπη γραμμή ανάπτυξης από την εποχή της κυκλοφορίας της έκδοσης 2.0, οδηγώντας προς την έκδοση {rel120-current}-RELEASE αλλά και μετά από αυτή. Για περισσότερες πληροφορίες δείτε το άρθρο "extref:{releng}[Προετοιμασία Εκδόσεων του FreeBSD: Δημιουργία του Κλάδου Έκδοσης, REL-BRANCH]".
Ο κλάδος 2.2-STABLE εγκαταλείφθηκε με την κυκλοφορία της έκδοσης 2.2.8. Ο κλάδος 3-STABLE τελείωσε με την κυκλοφορία της έκδοσης 3.5.1, που ήταν και η τελευταία της σειράς εκδόσεων 3._X_. Ο κλάδος 4-STABLE τελείωσε με την κυκλοφορία της έκδοσης 4.11, της τελευταίας της σειράς 4._X_. Οι μόνες αλλαγές που γίνονται κατά βάση σε κάθε ένα από αυτούς τους κλάδους, έχουν σχέση με διορθώσεις σε κενά ασφαλείας. Η υποστήριξη των κλάδων 5-STABLE σταμάτησε με την έκδοση 5.5, την τελευταία έκδοση της σειράς 5._X_. Η υποστήριξη για τη σειρά εκδόσεων 6-STABLE θα συνεχιστεί για λίγο καιρό ακόμα, αλλά θα επικεντρωθεί περισσότερο σε διορθώσεις κενών ασφαλείας και άλλων σοβαρών προβλημάτων.
@@ -183,7 +169,7 @@ H {re} δίνει στην κυκλοφορία μια καινούρια έκδ
=== Ποιος είναι υπεύθυνος για το FreeBSD
-Οι βασικές αποφάσεις που αφορούν το FreeBSD Project, όπως η συνολική κατεύθυνση του έργου και ποιος επιτρέπεται να προσθέσει πηγαίο κώδικα στο δέντρο, παίρνονται από την link:https://www.FreeBSD.org/administration/#t-core[βασική ομάδα (core team)] που αποτελείται από 9 άτομα. Υπάρχει μια ακόμα μεγαλύτερη ομάδα με περισσότερα από 350 άτομα που ονομάζονται link:{contributors}#STAFF-COMMITTERS[ διαπράκτες (committers)] και οι οποίοι έχουν την έγκριση να κάνουν απευθείας αλλαγές στο δέντρο πηγαίου κώδικα του FreeBSD.
+Οι βασικές αποφάσεις που αφορούν το FreeBSD Project, όπως η συνολική κατεύθυνση του έργου και ποιος επιτρέπεται να προσθέσει πηγαίο κώδικα στο δέντρο, παίρνονται από την link:https://www.FreeBSD.org/administration/#t-core[βασική ομάδα (core team)] που αποτελείται από 9 άτομα. Υπάρχει μια ακόμα μεγαλύτερη ομάδα με περισσότερα από 350 άτομα που ονομάζονται extref:{contributors}[ διαπράκτες (committers), STAFF-COMMITTERS] και οι οποίοι έχουν την έγκριση να κάνουν απευθείας αλλαγές στο δέντρο πηγαίου κώδικα του FreeBSD.
Ωστόσο οι περισσότερες σημαντικές αλλαγές συζητούνται από πριν στις <<mailing,λίστες ηλεκτρονικού ταχυδρομείου>>, και δεν υπάρχουν περιορισμοί σχετικά με το ποιοι λαμβάνουν μέρος σε αυτές τις συζητήσεις.
@@ -195,7 +181,7 @@ H {re} δίνει στην κυκλοφορία μια καινούρια έκδ
* Εκδόσεις που βασίζονται σεlink:https://www.FreeBSD.org/snapshots/[Στιγμιότυπα] γίνονται καθημερινά από τους κλάδους <<current,-CURRENT>> και <<stable,-STABLE>>, και εξυπηρετούν κατά βάση όσους ασχολούνται με την ανάπτυξη και τον έλεγχο των τελευταίας γενιάς προγραμμάτων.
* Η τελευταία κυκλοφορία που βασίζεται στον κλάδο 5-STABLE, η {rel112-current}-RELEASE, μπορεί να βρεθεί στον κατάλογο link:ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/{rel112-current}-RELEASE/[{rel112-current}-RELEASE].
-Πληροφορίες σχετικά με τη διάθεση του FreeBSD σε CD, DVD και άλλα μέσα μπορούν να βρεθούν link:{handbook}#mirrors/[στο Εγχειρίδιο].
+Πληροφορίες σχετικά με τη διάθεση του FreeBSD σε CD, DVD και άλλα μέσα μπορούν να βρεθούν extref:{handbook}mirrors/[στο Εγχειρίδιο, mirrors].
=== Πως μπορώ να έχω πρόσβαση στη Βάση Δεδομένων με τις Αναφορές Προβλημάτων;
@@ -203,7 +189,7 @@ H {re} δίνει στην κυκλοφορία μια καινούρια έκδ
Η εντολή man:send-pr[1] μπορεί να χρησιμοποιηθεί για την υποβολή αναφορών προβλημάτων, καθώς και αιτήσεων για αλλαγές, μέσω ηλεκτρονικού ταχυδρομείου. Εναλλακτικά, μπορείτε να χρησιμοποιήσετε την αντίστοιχη δυνατότητα http://www.freebsd.org/send-pr/[υποβολής αναφορών προβλημάτων μέσω της διεπαφής web] με τη βοήθεια ενός προγράμματος φυλλομετρητή.
-Πριν υποβάλετε μια αναφορά προβλήματος, παρακαλούμε διαβάστε το link:{problem-reports}[Γράφοντας Αναφορές Προβλημάτων για το FreeBSD], ένα άρθρο για το πως να γράφετε καλές αναφορές προβλημάτων.
+Πριν υποβάλετε μια αναφορά προβλήματος, παρακαλούμε διαβάστε το extref:{problem-reports}[Γράφοντας Αναφορές Προβλημάτων για το FreeBSD], ένα άρθρο για το πως να γράφετε καλές αναφορές προβλημάτων.
=== Τι άλλες πηγές πληροφοριών υπάρχουν;
@@ -390,11 +376,11 @@ File: +DESC (ignored)
=== Που μπορώ να βρω πληροφορίες για λίστες ηλεκτρονικού ταχυδρομείου του FreeBSD;
-Μπορείτε να βρείτε πλήρεις πληροφορίες στην αντίστοιχη link:{handbook}#eresources-mail[καταχώρηση του Εγχειριδίου για τις λίστες ηλεκτρονικού ταχυδρομείου].
+Μπορείτε να βρείτε πλήρεις πληροφορίες στην αντίστοιχη extref:{handbook}eresources[καταχώρηση του Εγχειριδίου για τις λίστες ηλεκτρονικού ταχυδρομείου, eresources-mail].
=== Τι ομάδες συζήτησης είναι διαθέσιμες για το FreeBSD;
-Μπορείτε να βρείτε πλήρεις πληροφορίες στην link:{handbook}#eresources-news/[καταχώρηση του Εγχειριδίου για τις ομάδες συζητήσεων].
+Μπορείτε να βρείτε πλήρεις πληροφορίες στην extref:{handbook}eresources/[καταχώρηση του Εγχειριδίου για τις ομάδες συζητήσεων, eresources-news].
=== Υπάρχουν κανάλια στο IRC (Internet Relay Chat) για το FreeBSD;
@@ -433,7 +419,7 @@ File: +DESC (ignored)
* doc/
* src/ssys.*
-Πλήρεις οδηγίες σχετικά με τη διαδικασία καθώς και περισσότερες πληροφορίες σχετικά με γενικά προβλήματα κατά την εγκατάσταση μπορείτε να βρείτε στο link:{handbook}#install/[Κεφάλαιο του Εγχειριδίου σχετικά με την εγκατάσταση του FreeBSD].
+Πλήρεις οδηγίες σχετικά με τη διαδικασία καθώς και περισσότερες πληροφορίες σχετικά με γενικά προβλήματα κατά την εγκατάσταση μπορείτε να βρείτε στο extref:{handbook}install/[Κεφάλαιο του Εγχειριδίου σχετικά με την εγκατάσταση του FreeBSD, install].
=== Τι μπορώ να κάνω αν το image της δισκέτας δεν χωράει σε μια μόνο δισκέτα;
@@ -448,11 +434,11 @@ File: +DESC (ignored)
Για να παρακάμψετε το πρόβλημα: γράψτε _binary_ στην γραμμή εντολών του FTP, μετά που θα συνδεθείτε στον εξυπηρετητή, και πριν ξεκινήσετε να κατεβάζετε το image.
* Χρήση της εντολής `copy` του DOS (η αντίστοιχου γραφικού εργαλείου) για τη μεταφορά του αρχείου image στη δισκέτα.
+
-Προγράμματα όπως το `copy`, δεν θα λειτουργήσουν σωστά καθώς το image εκκίνησης έχει φτιαχτεί ώστε να εκκινεί άμεσα. Το image έχει τα πλήρη περιεχόμενα της δισκέτας, τροχιά προς τροχιά, και δεν πρέπει να γραφεί στη δισκέτα ως κανονικό αρχείο. Θα πρέπει να το μεταφέρετε στη δισκέτα με "ωμό" τρόπο, χρησιμοποιώντας εργαλεία χαμηλού επιπέδου (low-level) (όπως π.χ. το `fdimage` ή το `rawrite`) που περιγράφονται στον link:{handbook}#install/[οδηγό εγκατάστασης του FreeBSD].
+Προγράμματα όπως το `copy`, δεν θα λειτουργήσουν σωστά καθώς το image εκκίνησης έχει φτιαχτεί ώστε να εκκινεί άμεσα. Το image έχει τα πλήρη περιεχόμενα της δισκέτας, τροχιά προς τροχιά, και δεν πρέπει να γραφεί στη δισκέτα ως κανονικό αρχείο. Θα πρέπει να το μεταφέρετε στη δισκέτα με "ωμό" τρόπο, χρησιμοποιώντας εργαλεία χαμηλού επιπέδου (low-level) (όπως π.χ. το `fdimage` ή το `rawrite`) που περιγράφονται στον extref:{handbook}install/[οδηγό εγκατάστασης του FreeBSD, install].
=== Που βρίσκονται οι οδηγίες για την εγκατάσταση του FreeBSD;
-Μπορείτε να βρείτε τις οδηγίες στην link:{handbook}#install/[καταχώρηση του Εγχειριδίου σχετικά με την εγκατάσταση του FreeBSD].
+Μπορείτε να βρείτε τις οδηγίες στην extref:{handbook}install/[καταχώρηση του Εγχειριδίου σχετικά με την εγκατάσταση του FreeBSD, install].
=== Τι χρειάζομαι για να εκτελέσω το FreeBSD;
@@ -466,7 +452,7 @@ File: +DESC (ignored)
Τη δεδομένη στιγμή, δεν υπάρχει τρόπος να φτιάξετε _απλώς_ μια προσαρμοσμένη δισκέτα εγκατάστασης. Θα πρέπει να δημιουργήσετε ολόκληρη νέα έκδοση, η οποία θα περιλαμβάνει και την προσαρμοσμένη δισκέτα εγκατάστασης σας.
-Για να δημιουργήσετε μια προσαρμοσμένη έκδοση, ακολουθήστε τις οδηγίες στο άρθρο σχετικά με την link:{releng}[Οργάνωση Εκδόσεων].
+Για να δημιουργήσετε μια προσαρμοσμένη έκδοση, ακολουθήστε τις οδηγίες στο άρθρο σχετικά με την extref:{releng}[Οργάνωση Εκδόσεων].
=== Μπορούν να συνυπάρξουν τα Windows(R) με το FreeBSD;
@@ -582,7 +568,7 @@ Fixit# fdisk -B -b /boot/boot0 bootdevice
=== Μπορώ να εγκαταστήσω το FreeBSD στο φορητό μου χρησιμοποιώντας PLIP (Parallel Line IP, IP μέσω Παράλληλης Θύρας);
-Ναι. Χρησιμοποιήστε τυποποιημένο καλώδιο τύπου Laplink. Αν χρειάζεται, διαβάστε το link:{handbook}#network-plip/[τμήμα PLIP του Εγχειριδίου] για λεπτομέρειες σχετικές με δικτύωση μέσω παράλληλης θύρας.
+Ναι. Χρησιμοποιήστε τυποποιημένο καλώδιο τύπου Laplink. Αν χρειάζεται, διαβάστε το extref:{handbook}advanced-networking/[τμήμα PLIP του Εγχειριδίου, network-plip] για λεπτομέρειες σχετικές με δικτύωση μέσω παράλληλης θύρας.
=== Τι γεωμετρία να χρησιμοποιήσω για το σκληρό μου δίσκο;
@@ -969,7 +955,7 @@ To FreeBSD υποστηρίζει αρκετά software modems με την βο
==== Ποιες κάρτες πολλαπλών σειριακών θυρών υποστηρίζονται από το FreeBSD;
-Υπάρχει μια λίστα για αυτές στην ενότητα link:{handbook}#install/[διάφορων συσκευών] του Εγχειριδίου.
+Υπάρχει μια λίστα για αυτές στην ενότητα extref:{handbook}install/[διάφορων συσκευών, install] του Εγχειριδίου.
Ακόμα φαίνεται ότι λειτουργούν και κάποιες κάρτες που είναι αντιγραφές επώνυμων μοντέλων, ειδικά όσες υποστηρίζουν ότι είναι συμβατές με τις αντίστοιχες τις AST.
@@ -1009,7 +995,7 @@ To FreeBSD υποστηρίζει αρκετά software modems με την βο
==== Ποιες άλλες συσκευές υποστηρίζονται από το FreeBSD;
-Δείτε το link:{handbook}#install/[Εγχειρίδιο] για τη λίστα των υπόλοιπων συσκευών που υποστηρίζονται.
+Δείτε το extref:{handbook}install/[Εγχειρίδιο, install] για τη λίστα των υπόλοιπων συσκευών που υποστηρίζονται.
==== Υποστηρίζει το FreeBSD διαχείριση ενέργειας για το φορητό μου υπολογιστή;
@@ -1062,7 +1048,7 @@ device pcic
device card 1
....
-Μεταγλωττίστε ξανά και εγκαταστήστε το νέο πυρήνα όπως περιγράφεται στην link:{handbook}#kernelconfig/[Ρύθμιση Πυρήνα του FreeBSD].
+Μεταγλωττίστε ξανά και εγκαταστήστε το νέο πυρήνα όπως περιγράφεται στην extref:{handbook}kernelconfig/[Ρύθμιση Πυρήνα του FreeBSD, kernelconfig].
== Αντιμετώπιση Προβλημάτων
@@ -1107,7 +1093,7 @@ ARRE (Auto Read Reallocation Enbld): 1
Το πρόβλημα αυτό είναι γνωστό. Ο ενσωματωμένος στη μητρική ελεγκτής SCSI του HP Netserver, χρησιμοποιεί σύνδεση τύπου EISA και καταλαμβάνει τη θέση EISA με αριθμό 11. Με τον τρόπο αυτό, όλες οι "πραγματικές" υποδοχές τύπου EISA βρίσκονται πριν από αυτή. Ωστόσο, η περιοχή διευθύνσεων των υποδοχών EISA με αριθμό = 10, συγκρούεται με την περιοχή διευθύνσεων του PCI, και το FreeBSD στη σημερινή του μορφή, δεν μπορεί να χειριστεί σωστά αυτή την κατάσταση.
-Έτσι, για την ώρα, το καλύτερο που μπορείτε να κάνετε είναι να παριστάνετε ότι δεν υπάρχει σύγκρουση διευθύνσεων :) και να ανεβάσετε την επιλογή `EISA_SLOTS` του πυρήνα στην τιμή 12. Μεταγλωττίστε έπειτα ξανά τον πυρήνα, όπως περιγράφεται στην link:{handbook}#kernelconfig/[σχετική καταχώρηση του Εγχειριδίου].
+Έτσι, για την ώρα, το καλύτερο που μπορείτε να κάνετε είναι να παριστάνετε ότι δεν υπάρχει σύγκρουση διευθύνσεων :) και να ανεβάσετε την επιλογή `EISA_SLOTS` του πυρήνα στην τιμή 12. Μεταγλωττίστε έπειτα ξανά τον πυρήνα, όπως περιγράφεται στην extref:{handbook}kernelconfig/[σχετική καταχώρηση του Εγχειριδίου, kernelconfig].
Φυσικά αυτό είναι ένα πρόβλημα αντίστοιχο με το αυγό και την κότα, όσο αφορά την εγκατάσταση ενός τέτοιου μηχανήματος. Για να προσπεράσετε το πρόβλημα, υπάρχει ειδική πρόβλεψη στο _UserConfig_. Μη χρησιμοποιήσετε το "visual" interface, αλλά την γραμμή εντολών. Απλώς γράψτε:
@@ -1140,7 +1126,7 @@ quit
=== Ο εκτυπωτής μου στην παράλληλη θύρα είναι απελπιστικά αργός. Τι μπορώ να κάνω;
-Αν το μόνο πρόβλημα είναι ο υπερβολικά αργός εκτυπωτής, μπορείτε να δοκιμάσετε να αλλάξετε την link:{handbook}#PRINTING-PARALLEL-PORT-MODE[κατάσταση λειτουργίας της παράλληλης θύρας] όπως περιγράφεται στο κεφάλαιο του Εγχειριδίου σχετικά με την link:{handbook}#printing-intro-setup/[Εγκατάσταση Εκτυπωτή].
+Αν το μόνο πρόβλημα είναι ο υπερβολικά αργός εκτυπωτής, μπορείτε να δοκιμάσετε να αλλάξετε την extref:{handbook}priting[κατάσταση λειτουργίας της παράλληλης θύρας, printing-parallel-port-mode] όπως περιγράφεται στο κεφάλαιο του Εγχειριδίου σχετικά με την extref:{handbook}printing/[Εγκατάσταση Εκτυπωτή, printing-intro-setup].
=== Γιατί τα προγράμματα μου περιστασιακά τερματίζουν με σφάλμα Signal 11;
@@ -1213,17 +1199,17 @@ quit
=== Το σύστημα μου δεν έχει 1GB RAM, και πάλι όμως το FreeBSD δημιουργεί panic με το μήνυμα kmem_map too small!
-Το panic δείχνει ότι το σύστημα έχει μείνει από εικονική μνήμη για προσωρινή αποθήκευση δεδομένων δικτύου (network buffers, και ειδικότερα mbuf clusters). Μπορείτε να αυξήσετε το μέγεθος της εικονικής μνήμης που διατίθεται για mbuf clusters, ακολουθώντας τις οδηγίες στην ενότητα link:{handbook}#NMBCLUSTERS[Όρια Δικτύου] του Εγχειριδίου.
+Το panic δείχνει ότι το σύστημα έχει μείνει από εικονική μνήμη για προσωρινή αποθήκευση δεδομένων δικτύου (network buffers, και ειδικότερα mbuf clusters). Μπορείτε να αυξήσετε το μέγεθος της εικονικής μνήμης που διατίθεται για mbuf clusters, ακολουθώντας τις οδηγίες στην ενότητα extref:{handbook}config-tuning[Όρια Δικτύου, nmbclusters] του Εγχειριδίου.
=== Γιατί παίρνω το μήνυμα λάθους /kernel: proc: table is full;
Ο πυρήνας του FreeBSD επιτρέπει κάθε χρονική στιγμή την ύπαρξη ενός συγκεκριμένου αριθμού διεργασιών. Ο αριθμός αυτός βασίζεται στην επιλογή `MAXUSERS` του πυρήνα. Το `MAXUSERS` επηρεάζει επίσης και άλλα όρια μέσα στον πυρήνα, όπως η προσωρινή μνήμη του δικτύου (network buffers) (δείτε <<panic-kmemmap-too-small,την προηγούμενη ερώτηση>>). Αν το μηχάνημα σας λειτουργεί σε υψηλό φορτίο, ίσως έχει νόημα να αυξήσετε την επιλογή `MAXUSERS`. Με τον τρόπο αυτό, μαζί με το μέγιστο αριθμό διεργασιών, θα αυξηθούν και άλλα όρια του συστήματος.
-Για να ρυθμίσετε την τιμή του `MAXUSERS`, δείτε την ενότητα link:{handbook}#KERN-MAXFILES[Όρια Αρχείων/Διεργασιών] του Εγχειριδίου. (Αν και η ενότητα αυτή αναφέρεται σε ανοιχτά αρχεία, τα ίδια όρια ισχύουν και για τις διεργασίες.)
+Για να ρυθμίσετε την τιμή του `MAXUSERS`, δείτε την ενότητα extref:{handbook}config-tuning[Όρια Αρχείων/Διεργασιών, kern-maxfiles] του Εγχειριδίου. (Αν και η ενότητα αυτή αναφέρεται σε ανοιχτά αρχεία, τα ίδια όρια ισχύουν και για τις διεργασίες.)
Αν το μηχάνημα σας λειτουργεί σε χαμηλό φορτίο, αλλά εκτελεί μεγάλο αριθμό διεργασιών, μπορείτε απλώς να ρυθμίσετε τον αριθμό τους αλλάζοντας την τιμή της μεταβλητής `kern.maxproc`. Αν πρέπει να ρυθμίσετε αυτή τη μεταβλητή, θα πρέπει να την ορίσετε στο αρχείο [.filename]#/boot/loader.conf#. Η ρύθμιση δεν θα ισχύσει μέχρι να επανεκκινήσετε το σύστημα. Για περισσότερες πληροφορίες σχετικά με τις μεταβλητές του πυρήνα, δείτε τις σελίδες manual man:loader.conf[5] και man:sysctl.conf[5]. Αν όλες αυτές οι διεργασίες εκτελούνται από ένα μόνο χρήστη, θα πρέπει επίσης να ρυθμίσετε την τιμή της μεταβλητής `kern.maxprocperuid` ώστε να είναι κατά ένα μικρότερη από την νέα τιμή της `kern.maxproc`. (Πρέπει να είναι κατά ένα μικρότερη, γιατί υπάρχει πάντα ένα πρόγραμμα συστήματος, το man:init[8], που πρέπει να εκτελείται συνέχεια.).
-Για να γίνει μόνιμη μια αλλαγή ενός sysctl, τοποθετήστε την κατάλληλη τιμή στο αρχείο [.filename]#/etc/sysctl.conf#. Περισσότερες πληροφορίες για τη ρύθμιση του συστήματος με την χρήση του man:sysctl[8], μπορείτε να βρείτε στην ενότητα link:{handbook}#configtuning-sysctl/[Ρυθμίσεις μέσω sysctl] του Εγχειριδίου.
+Για να γίνει μόνιμη μια αλλαγή ενός sysctl, τοποθετήστε την κατάλληλη τιμή στο αρχείο [.filename]#/etc/sysctl.conf#. Περισσότερες πληροφορίες για τη ρύθμιση του συστήματος με την χρήση του man:sysctl[8], μπορείτε να βρείτε στην ενότητα extref:{handbook}config-tuning[Ρυθμίσεις μέσω sysctl, configtuning-sysctl] του Εγχειριδίου.
=== Γιατί παίρνω το μήνυμα λάθους CMAP busy όταν επανεκκινώ με νέο πυρήνα;
@@ -1427,7 +1413,7 @@ static struct isa_pnp_id sio_ids[] = {
=== Γιατί βλέπω συνέχεια το μήνυμα file: table is full στο dmesg;
-Το μήνυμα αυτό σημαίνει ότι έχετε εξαντλήσει τον αριθμό των διαθέσιμων περιγραφέων αρχείων (file descriptors) στο σύστημα σας. Παρακαλούμε δείτε το link:{handbook}#KERN-MAXFILES[kern.maxfiles ] τμήμα στο κεφάλαιο link:{handbook}#configtuning-kernel-limits/[Ρύθμιση Ορίων Πυρήνα] του Εγχειριδίου, για ερμηνεία και επίλυση του προβλήματος.
+Το μήνυμα αυτό σημαίνει ότι έχετε εξαντλήσει τον αριθμό των διαθέσιμων περιγραφέων αρχείων (file descriptors) στο σύστημα σας. Παρακαλούμε δείτε το extref:{handbook}config-tuning/[kern.maxfiles, kern-maxfiles] τμήμα στο κεφάλαιο extref:{handbook}config-tuning/[Ρύθμιση Ορίων Πυρήνα, configtuning-kernel-limits] του Εγχειριδίου, για ερμηνεία και επίλυση του προβλήματος.
=== Γιατί το ρολόι στο φορητό μου υπολογιστή δεν κρατάει την σωστή ώρα;
@@ -1551,7 +1537,7 @@ FreeBSD also includes a variety of text editors, spreadsheets, and drawing progr
=== Where can I get Motif(R) for FreeBSD?
-The Open Group has released the source code to Motif(R) 2.2.2. You can install the `open-motif` package, or compile it from ports. Refer to link:{handbook}#ports/[the ports section of the Handbook] for more information on how to do this.
+The Open Group has released the source code to Motif(R) 2.2.2. You can install the `open-motif` package, or compile it from ports. Refer to extref:{handbook}ports/[the ports section of the Handbook, ports] for more information on how to do this.
[NOTE]
====
@@ -1666,7 +1652,7 @@ Yes. Please see link:https://www.FreeBSD.org/java/[ http://www.FreeBSD.org/java/
=== Why can I not build this port on my 4.X-STABLE machine?
-If you are running a FreeBSD version that lags significantly behind -CURRENT or -STABLE, you may need to update your ports collection; see the link:{porters-handbook}#keeping-up/[ Keeping Up] section of the Porter's Handbook for further information on how to do this. If you are up to date, then someone might have committed a change to the port which works for -CURRENT but which broke the port for -STABLE. Please submit a bug report on this with the man:send-pr[1] command, since the ports collection is supposed to work for both the -CURRENT and -STABLE branches.
+If you are running a FreeBSD version that lags significantly behind -CURRENT or -STABLE, you may need to update your ports collection; see the extref:{porters-handbook}[Keeping Up, keeping-up] section of the Porter's Handbook for further information on how to do this. If you are up to date, then someone might have committed a change to the port which works for -CURRENT but which broke the port for -STABLE. Please submit a bug report on this with the man:send-pr[1] command, since the ports collection is supposed to work for both the -CURRENT and -STABLE branches.
=== I just tried to build INDEX using make index, and it failed. Why?
@@ -1722,7 +1708,7 @@ The usual answer is that DNS on your system is misconfigured. Both man:getenv[3]
=== I updated parts of the Ports Collection using CVSup, and now many ports fail to build with mysterious error messages! What happened? Is the Ports Collection broken in some major way?
-If you only update parts of the Ports Collection, using one of its CVSup subcollections and not the `ports-all` CVSup collection, you should _always_ update the `ports-base` subcollection too! The reasons are described link:{handbook}#cvsup[in the Handbook].
+If you only update parts of the Ports Collection, using one of its CVSup subcollections and not the `ports-all` CVSup collection, you should _always_ update the `ports-base` subcollection too! The reasons are described extref:{handbook}mirrors[in the Handbook, cvsup].
=== How do I create audio CDs from my MIDI files?
@@ -1739,7 +1725,7 @@ The wav files can then be converted to other formats or burned onto audio CDs, a
=== I would like to customize my kernel. Is it difficult?
-Not at all! Check out the link:{handbook}#kernelconfig/[ kernel config section of the Handbook].
+Not at all! Check out the extref:{handbook}kernelconfig/[kernel config section of the Handbook, kernelconfig].
[NOTE]
====
@@ -2156,23 +2142,23 @@ and it is probably a good idea to add a line like this to [.filename]#/etc/fstab
=== Why do I get Incorrect super block when mounting a CDROM?
-You have to tell man:mount[8] the type of the device that you want to mount. This is described in the link:{handbook}#creating-cds/[ Handbook section on optical media], specifically the section link:{handbook}#MOUNTING-CD[Using Data CDs].
+You have to tell man:mount[8] the type of the device that you want to mount. This is described in the extref:{handbook}disks/[Handbook section on optical media, creating-cds], specifically the section extref:{handbook}disks[Using Data CDs, mounting-cd].
=== Why do I get Device not configured when mounting a CDROM?
-This generally means that there is no CDROM in the CDROM drive, or the drive is not visible on the bus. Please see the link:{handbook}#MOUNTING-CD[Using Data CDs] section of the Handbook for a detailed discussion of this issue.
+This generally means that there is no CDROM in the CDROM drive, or the drive is not visible on the bus. Please see the extref:{handbook}disks[Using Data CDs, mounting-cd] section of the Handbook for a detailed discussion of this issue.
=== Why do all non-English characters in filenames show up as ? on my CDs when mounted in FreeBSD?
-Your CDROM probably uses the "Joliet" extension for storing information about files and directories. This is discussed in the Handbook chapter on link:{handbook}#creating-cds/[creating and using CDROMs], specifically the section on link:{handbook}#MOUNTING-CD[Using Data CDROMs].
+Your CDROM probably uses the "Joliet" extension for storing information about files and directories. This is discussed in the Handbook chapter on extref:{handbook}disks/[creating and using CDROMs, creating-cds], specifically the section on extref:{handbook}disks[Using Data CDROMs, mounting-cd].
=== I burned a CD under FreeBSD and now I can not read it under any other operating system. Why?
-You most likely burned a raw file to your CD, rather than creating an ISO 9660 filesystem. Take a look at the link:{handbook}#creating-cds/[Handbook chapter on creating CDROMs], particularly the section on link:{handbook}#RAWDATA-CD[burning raw data CDs].
+You most likely burned a raw file to your CD, rather than creating an ISO 9660 filesystem. Take a look at the extref:{handbook}disks/[Handbook chapter on creating CDROMs, creating-cds], particularly the section on extref:{handbook}disks[burning raw data CDs, rawdata-cd].
=== How can I create an image of a data CD?
-This is discussed in the Handbook section on link:{handbook}#IMAGING-CD[duplicating data CDs]. For more on working with CDROMs, see the link:{handbook}#creating-cds/[Creating CDs Section] in the Storage chapter in the Handbook.
+This is discussed in the Handbook section on extref:{handbook}disks[duplicating data CDs, imaging-cd]. For more on working with CDROMs, see the extref:{handbook}disks/[Creating CDs Section, creating-cds] in the Storage chapter in the Handbook.
=== Why can I not mount an audio CD?
@@ -2278,7 +2264,7 @@ This situation is common on web servers. Many people set up a FreeBSD web server
=== How can I add more swap space?
-In the link:{handbook}#config-tuning/[Configuration and Tuning] section of the Handbook, you will find a link:{handbook}#adding-swap-space/[section] describing how to do this.
+In the extref:{handbook}config-tuning[Configuration and Tuning, config-tuning] section of the Handbook, you will find a extref:{handbook}config-tuning/[section, adding-swap-space] describing how to do this.
=== Why does FreeBSD see my disk as smaller than the manufacturer says it is?
@@ -2353,13 +2339,13 @@ Once you have performed these steps, you can edit [.filename]#/etc/rc.conf# as y
=== Why am I having trouble setting up my printer?
-Please have a look at the Handbook entry on printing. It should cover most of your problem. See the link:{handbook}#printing/[ Handbook entry on printing].
+Please have a look at the Handbook entry on printing. It should cover most of your problem. See the extref:{handbook}printing/[Handbook entry on printing, printing].
Some printers require a host-based driver to do any kind of printing. These so-called "WinPrinters" are not natively supported by FreeBSD. If your printer does not work in DOS or Windows NT(R) 4.0, it is probably a WinPrinter. Your only hope of getting one of these to work is to check if the package:print/pnm2ppa[] port supports it.
=== How can I correct the keyboard mappings for my system?
-Please see the Handbook section on link:{handbook}#using-localization/[using localization], specifically the section on link:{handbook}#SETTING-CONSOLE[console setup].
+Please see the Handbook section on extref:{handbook}l10n/[using localization, using-localization], specifically the section on extref:{handbook}l10n[console setup, setting-console].
=== Why do I get messages like: unknown: PNP0303 can't assign resources on boot?
@@ -2378,7 +2364,7 @@ options QUOTA
....
+
-Please read the link:{handbook}#quotas/[Handbook entry on quotas] for full details.
+Please read theextref:{handbook}disks/[Handbook entry on quotas, quotas] for full details.
. Do not turn on quotas on [.filename]#/#.
. Put the quota file on the filesystem that the quotas are to be enforced on, i.e.:
+
@@ -2567,7 +2553,7 @@ Long answer: FreeBSD derives its releases from one of two places. Major, dot-zer
When a release is about to be made, the branch from which it will be derived from has to undergo a certain process. Part of this process is a code freeze. When a code freeze is initiated, the name of the branch is changed to reflect that it is about to become a release. For example, if the branch used to be called 4.5-STABLE, its name will be changed to 4.6-PRERELEASE to signify the code freeze and signify that extra pre-release testing should be happening. Bug fixes can still be committed to be part of the release. When the source code is in shape for the release the name will be changed to 4.6-RC to signify that a release is about to be made from it. Once in the RC stage, only the most critical bugs found can be fixed. Once the release (4.6-RELEASE in this example) and release branch have been made, the branch will be renamed to 4.6-STABLE.
-For more information on version numbers and the various CVS branches, refer to the link:{releng}[Release Engineering] article.
+For more information on version numbers and the various CVS branches, refer to the extref:{releng}[Release Engineering] article.
=== I tried to install a new kernel, and the chflags failed. How do I get around this?
@@ -2654,7 +2640,7 @@ However, early in 2004, some XFree86 developers left that project over issues in
As of July 2004, in FreeBSD-CURRENT, XFree86(TM) has been replaced with Xorg as the default implementation. The XFree86(TM) ports (package:x11/XFree86-4[] and subports) remain in the ports collection. But Xorg is the default X11 implementation for FreeBSD 5.3 and later.
-For further information, read the link:{handbook}#x11/[X11] section of the FreeBSD Handbook.
+For further information, read the extref:{handbook}x11/[X11, x11] section of the FreeBSD Handbook.
[NOTE]
====
@@ -2690,7 +2676,7 @@ If you would like to add X to an existing installation, you should use the packa
Then read and follow the documentation on the man:xorgconfig[1] tool, which assists you in configuring Xorg for your particular graphics card/mouse/etc. You may also wish to examine the man:xorgcfg[1] tool, which provides a graphical interface to the X configuration process.
-For further information, read the link:{handbook}#x11/[X11] section of the FreeBSD Handbook.
+For further information, read the extref:{handbook}x11/[X11, x11] section of the FreeBSD Handbook.
You may also wish to investigate the Xaccel server. See the section on <<xig,Xi Graphics>> for more details.
@@ -3058,35 +3044,35 @@ The availability of 3D acceleration depends on the version of XFree86(TM) or Xor
=== Where can I get information on diskless booting?
-"Diskless booting" means that the FreeBSD box is booted over a network, and reads the necessary files from a server instead of its hard disk. For full details, please read link:{handbook}#network-diskless/[the Handbook entry on diskless booting]
+"Diskless booting" means that the FreeBSD box is booted over a network, and reads the necessary files from a server instead of its hard disk. For full details, please read extref:{handbook}advanced-networking/[the Handbook entry on diskless booting, network-diskless]
=== Can a FreeBSD box be used as a dedicated network router?
-Yes. Please see the Handbook entry on link:{handbook}#advanced-networking/[ advanced networking], specifically the section on link:{handbook}#network-routing/[routing and gateways].
+Yes. Please see the Handbook entry on extref:{handbook}advanced-networking/[advanced networking, advanced-networking], specifically the section on extref:{handbook}advanced-networking/[routing and gateways, network-routing].
=== Can I connect my Windows(R) box to the Internet via FreeBSD?
Typically, people who ask this question have two PCs at home, one with FreeBSD and one with some version of Windows(R) the idea is to use the FreeBSD box to connect to the Internet and then be able to access the Internet from the Windows(R) box through the FreeBSD box. This is really just a special case of the previous question and works perfectly well.
-If you are using dialup to connect to the Internet user-mode man:ppp[8] contains a `-nat` option. If you run man:ppp[8] with the `-nat` option, set `gateway_enable` to _YES_ in [.filename]#/etc/rc.conf#, and configure your Windows(R) machine correctly, this should work fine. For more information, please see the man:ppp[8] manual page or the link:{handbook}#userppp/[Handbook entry on user PPP].
+If you are using dialup to connect to the Internet user-mode man:ppp[8] contains a `-nat` option. If you run man:ppp[8] with the `-nat` option, set `gateway_enable` to _YES_ in [.filename]#/etc/rc.conf#, and configure your Windows(R) machine correctly, this should work fine. For more information, please see the man:ppp[8] manual page or the extref:{handbook}ppp-and-slip/[Handbook entry on user PPP, userppp].
-If you are using kernel-mode PPP or have an Ethernet connection to the Internet, you need to use man:natd[8]. Please look at the link:{handbook}#network-natd/[natd] section of the Handbook for a tutorial.
+If you are using kernel-mode PPP or have an Ethernet connection to the Internet, you need to use man:natd[8]. Please look at the extref:{handbook}/[natd, network-natd] section of the Handbook for a tutorial.
=== Does FreeBSD support SLIP and PPP?
Yes. See the manual pages for man:slattach[8], man:sliplogin[8], man:ppp[8], and man:pppd[8]. man:ppp[8] and man:pppd[8] provide support for both incoming and outgoing connections, while man:sliplogin[8] deals exclusively with incoming connections, and man:slattach[8] deals exclusively with outgoing connections.
-For more information on how to use these, please see the link:{handbook}#ppp-and-slip/[Handbook chapter on PPP and SLIP].
+For more information on how to use these, please see the extref:{handbook}ppp-and-slip/[Handbook chapter on PPP and SLIP, ppp-and-slip].
If you only have access to the Internet through a "shell account", you may want to have a look at the package:net/slirp[] package. It can provide you with (limited) access to services such as ftp and http direct from your local machine.
=== Does FreeBSD support NAT or Masquerading?
-Yes. If you want to use NAT over a user PPP connection, please see the link:{handbook}#userppp/[Handbook entry on user PPP]. If you want to use NAT over some other sort of network connection, please look at the link:{handbook}#network-natd/[natd] section of the Handbook.
+Yes. If you want to use NAT over a user PPP connection, please see the extref:{handbook}ppp-and-slip/[Handbook entry on user PPP, userppp]. If you want to use NAT over some other sort of network connection, please look at the extref:{handbook}/[natd, network-natd] section of the Handbook.
=== How do I connect two FreeBSD systems over a parallel line using PLIP?
-Please see the link:{handbook}#network-plip/[PLIP section] of the Handbook.
+Please see the extref:{handbook}advanced-networking/[PLIP section, network-plip] of the Handbook.
=== Why can I not create a /dev/ed0 device?
@@ -3116,7 +3102,7 @@ If you want to use the other ports, you will have to specify an additional param
Certain PC network cards are better than others (to put it mildly) and can sometimes cause problems with network intensive applications like NFS.
-See link:{handbook}#network-nfs/[ the Handbook entry on NFS] for more information on this topic.
+See extref:{handbook}network-servers/[the Handbook entry on NFS, network-nfs] for more information on this topic.
=== Why can I not NFS-mount from a Linux(R) box?
@@ -3138,7 +3124,7 @@ Sun(TM) workstations running SunOS(TM) 4.X only accept mount requests from a pri
=== Why does mountd keep telling me it can't change attributes and that I have a bad exports list on my FreeBSD NFS server?
-The most frequent problem is not understanding the correct format of [.filename]#/etc/exports#. Please review man:exports[5] and the link:{handbook}#network-nfs/[NFS] entry in the Handbook, especially the section on link:{handbook}#CONFIGURING-NFS[configuring NFS].
+The most frequent problem is not understanding the correct format of [.filename]#/etc/exports#. Please review man:exports[5] and the extref:{handbook}network-servers/[NFS, network-nfs] entry in the Handbook, especially the section on extref:{handbook}[configuring NFS].
=== Why am I having problems talking PPP to NeXTStep machines?
@@ -3253,11 +3239,11 @@ If you had unintentionally misconfigured your system for firewalling, you can re
You can also set `firewall_type="open"` in [.filename]#/etc/rc.conf#.
-For further information on configuring a FreeBSD firewall, see the link:{handbook}#firewalls/[ Handbook chapter].
+For further information on configuring a FreeBSD firewall, see the extref:{handbook}firewalls[Handbook chapter, firewalls].
=== How much overhead does IPFW incur?
-Please see the Handbook's link:{handbook}#firewalls/[Firewalls] section, specifically the section on link:{handbook}#IPFW-OVERHEAD[IPFW Overhead Optimization].
+Please see the Handbook's extref:{handbook}firewalls[Firewalls, firewalls] section, specifically the section on extref:{handbook}[IPFW Overhead Optimization].
=== Why is my ipfw fwd rule to redirect a service to another machine not working?
@@ -3304,7 +3290,7 @@ On FreeBSD 4.X and earlier, you must also create the device node. After rebootin
# sh MAKEDEV bpf0
....
-Please see the link:{handbook}#kernelconfig-nodes/[ Handbook entry on device nodes] for more information on managing devices.
+Please see the extref:{handbook}[Handbook entry on device nodes, kernelconfig-nodes] for more information on managing devices.
=== How do I mount a disk from a Windows(R) machine that is on my network, like smbmount in Linux(R)?
@@ -3346,7 +3332,7 @@ First, see if the error message you are receiving is like the one shown below.
/usr/libexec/ld-elf.so.1: Shared object "libXaw.so.6" not found
....
-Errors like these are caused by installing the package:net/cvsup[] port on a machine which does not have the XFree86(TM) suite. If you want to use the GUI included with CVSup you will need to install XFree86(TM) now. Alternatively if you just wish to use CVSup from a command line you should delete the package previously installed. Then install the package:net/cvsup-without-gui[] port. This is covered in more detail in the link:{handbook}#cvsup/[CVSup section] of the Handbook.
+Errors like these are caused by installing the package:net/cvsup[] port on a machine which does not have the XFree86(TM) suite. If you want to use the GUI included with CVSup you will need to install XFree86(TM) now. Alternatively if you just wish to use CVSup from a command line you should delete the package previously installed. Then install the package:net/cvsup-without-gui[] port. This is covered in more detail in the extref:{handbook}mirrors/[CVSup section, cvsup] of the Handbook.
== Ασφάλεια
@@ -3449,7 +3435,7 @@ If you want `suidperl` to be built suid during upgrades from source, edit [.file
=== I cannot make man:ppp[8] work. What am I doing wrong?
-You should first read the man:ppp[8] manual page and the link:{handbook}#ppp-and-slip/[ PPP section of the handbook]. Enable logging with the command
+You should first read the man:ppp[8] manual page and the extref:{handbook}ppp-and-slip/[ PPP section of the handbook, ppp-and-slip]. Enable logging with the command
[.programlisting]
....
@@ -3499,7 +3485,7 @@ Another reason for the default route line being missing is that you have mistake
delete ALL
....
-from [.filename]#ppp.conf#. If this is the case, go back to the link:{handbook}#USERPPP-FINAL[ Final system configuration] section of the handbook.
+from [.filename]#ppp.conf#. If this is the case, go back to the extref:{handbook}ppp-and-slip[Final system configuration, userppp-final] section of the handbook.
=== What does No route to host mean?
@@ -3520,7 +3506,7 @@ delete ALL
add 0 0 HISADDR
....
-Refer to the link:{handbook}#USERPPP-DYNAMICIP[ PPP and Dynamic IP addresses] section of the handbook for further details.
+Refer to the extref:{handbook}ppp-and-slip[PPP and Dynamic IP addresses, userppp-dynamicip] section of the handbook for further details.
=== Why does my connection drop after about 3 minutes?
@@ -3702,7 +3688,7 @@ set dfilter 3 permit 0/0 0/0
This is not always suitable, as it will effectively break your demand-dial capabilities - most programs will need a DNS lookup before doing any other network related things.
-In the DNS case, you should try to determine what is actually trying to resolve a host name. A lot of the time, man:sendmail[8] is the culprit. You should make sure that you tell sendmail not to do any DNS lookups in its configuration file. See the section on link:{handbook}#smtp-dialup/[using email with a dialup connection] in the FreeBSD Handbook for details on how to create your own configuration file and what should go into it. You may also want to add the following line to your [.filename]#.mc# file:
+In the DNS case, you should try to determine what is actually trying to resolve a host name. A lot of the time, man:sendmail[8] is the culprit. You should make sure that you tell sendmail not to do any DNS lookups in its configuration file. See the section on extref:{handbook}mail/[using email with a dialup connection, smtp-dialup] in the FreeBSD Handbook for details on how to create your own configuration file and what should go into it. You may also want to add the following line to your [.filename]#.mc# file:
[.programlisting]
....
@@ -4313,7 +4299,7 @@ If doscmd will not suffice, the add-on utility package:emulators/pcemu[] emulate
=== What do I need to do to translate a FreeBSD document into my native language?
-See the link:{fdp-primer}#translations/[ Translation FAQ] in the FreeBSD Documentation Project Primer.
+See the extref:{fdp-primer}[Translation FAQ, translations] in the FreeBSD Documentation Project Primer.
=== Why does my email to any address at FreeBSD.org bounce?
@@ -4347,7 +4333,7 @@ http://www.grex.org/[Grex] provides a site very similar to M-Net including the s
http://www.FreeBSD.org/cgi/ports.cgi?^sup[ SUP] stands for Software Update Protocol, and was developed by CMU for keeping their development trees in sync. We used it to keep remote sites in sync with our central development sources.
-SUP is not bandwidth friendly, and has been retired. The current recommended method to keep your sources up to date is link:{handbook}#CVSUP[ CVSup]
+SUP is not bandwidth friendly, and has been retired. The current recommended method to keep your sources up to date is extref:{handbook}mirrors[CVSup, CVSUP]
=== What is the cute little red guy's name?
@@ -4367,7 +4353,7 @@ You will find eps and Xfig drawings under [.filename]#/usr/shared/examples/BSD_d
=== I have seen an acronym or other term on the mailing lists and I do not understand what it means. Where should I look?
-Please see the link:{handbook}#freebsd-glossary/[ FreeBSD Glossary].
+Please see the extref:{handbook}glossary/[ FreeBSD Glossary, freebsd-glossary].
=== Why should I care what color the bikeshed is?
@@ -4496,11 +4482,11 @@ At this time, there is only one book on FreeBSD-specific OS internals, namely "T
Additionally, much general UNIX(R) knowledge is directly applicable to FreeBSD.
-For a list of relevant books, please check the Handbook's link:{handbook}#bibliography-osinternals/[Operating System Internals Bibliography].
+For a list of relevant books, please check the Handbook's extref:{handbook}bibliography/[Operating System Internals Bibliography, bibliography-osinternals].
=== How can I contribute to FreeBSD?
-Please see the article on link:{contributing}[Contributing to FreeBSD] for specific advice on how to do this. Assistance is more than welcome!
+Please see the article on extref:{contributing}[Contributing to FreeBSD] for specific advice on how to do this. Assistance is more than welcome!
=== What are SNAPs and RELEASEs?
@@ -4516,7 +4502,7 @@ Right now, "-CURRENT" is the 7.X development stream; the `5-STABLE` branch, RELE
=== How do I make my own custom release?
-Please see the link:{releng}[ Release Engineering] article.
+Please see the extref:{releng}[Release Engineering] article.
=== Why does make world clobber my existing installed binaries?
@@ -4534,7 +4520,7 @@ The Adaptec 1542 SCSI host adapters allow the user to configure their bus access
=== Can I follow -CURRENT with limited Internet access?
-Yes, you can do this _without_ downloading the whole source tree by using the link:{handbook}#CTM[CTM facility].
+Yes, you can do this _without_ downloading the whole source tree by using the extref:{handbook}mirrors[CTM facility, CTM].
=== How did you split the distribution into 240k files?
@@ -4554,7 +4540,7 @@ ${RELEASEDIR}/tarballs/bindist/bin_tgz.)
=== I have written a kernel extension, who do I send it to?
-Please take a look at the article on link:{contributing}[Contributing to FreeBSD] to learn how to submit code.
+Please take a look at the article on extref:{contributing}[Contributing to FreeBSD] to learn how to submit code.
And thanks for the thought!
@@ -4740,7 +4726,7 @@ NOTE: the size of the kernel address space must be a multiple of four megabytes.
This innocent little Frequently Asked Questions document has been written, rewritten, edited, folded, spindled, mutilated, eviscerated, contemplated, discombobulated, cogitated, regurgitated, rebuilt, castigated, and reinvigorated over the last decade, by a cast of hundreds if not thousands. Repeatedly.
-We wish to thank every one of the people responsible, and we encourage you to to link:{contributing}[join them] in making this FAQ even better.
+We wish to thank every one of the people responsible, and we encourage you to to extref:{contributing}[join them] in making this FAQ even better.
[bibliography]
[[bibliography]]
diff --git a/documentation/content/el/books/handbook/_index.adoc b/documentation/content/el/books/handbook/_index.adoc
index 427ef15a9e..7edbceed69 100644
--- a/documentation/content/el/books/handbook/_index.adoc
+++ b/documentation/content/el/books/handbook/_index.adoc
@@ -3,9 +3,9 @@ title: Εγχειρίδιο του FreeBSD
authors:
- author: Ομάδα Τεκμηρίωσης του FreeBSD
copyright: 1995-2020 Ομάδα Τεκμηρίωσης του FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
next: books/handbook/preface
+isIndex: true
---
= Εγχειρίδιο του FreeBSD
@@ -13,24 +13,34 @@ next: books/handbook/preface
:toc: macro
:toclevels: 1
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:book: true
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Περίληψη
@@ -39,10 +49,10 @@ include::shared/el/mailing-lists.adoc[]
'''
-include::content/el/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
-include::content/el/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
-include::content/el/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
-include::content/el/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/el/books/handbook/advanced-networking/_index.adoc b/documentation/content/el/books/handbook/advanced-networking/_index.adoc
index 4e597c41b0..a0f4f264db 100644
--- a/documentation/content/el/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/el/books/handbook/advanced-networking/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 31
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 31
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[advanced-networking-synopsis]]
== Σύνοψη
@@ -1837,7 +1835,7 @@ Most other TA's will probably work as well, TA vendors try to make sure their pr
The real problem with external TA's is that, like modems, you need a good serial card in your computer.
-You should read the link:{serial-uart}[FreeBSD Serial Hardware] tutorial for a detailed understanding of serial devices, and the differences between asynchronous and synchronous serial ports.
+You should read the extref:{serial-uart}[FreeBSD Serial Hardware] tutorial for a detailed understanding of serial devices, and the differences between asynchronous and synchronous serial ports.
A TA running off a standard PC serial port (asynchronous) limits you to 115.2 Kbs, even though you have a 128 Kbs connection. To fully utilize the 128 Kbs that ISDN is capable of, you must move the TA to a synchronous serial card.
diff --git a/documentation/content/el/books/handbook/audit/_index.adoc b/documentation/content/el/books/handbook/audit/_index.adoc
index 5371e12163..298a3fd76b 100644
--- a/documentation/content/el/books/handbook/audit/_index.adoc
+++ b/documentation/content/el/books/handbook/audit/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/disks
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 31
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[audit-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/basics/_index.adoc b/documentation/content/el/books/handbook/basics/_index.adoc
index df0f356593..728b5f48d3 100644
--- a/documentation/content/el/books/handbook/basics/_index.adoc
+++ b/documentation/content/el/books/handbook/basics/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ports
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[basics-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/bibliography/_index.adoc b/documentation/content/el/books/handbook/bibliography/_index.adoc
index 0d59d40b42..d35ba5bc22 100644
--- a/documentation/content/el/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/el/books/handbook/bibliography/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/eresources
[[bibliography]]
= Βιβλιογραφία
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Αν και τα manual pages παρέχουν μία επίσημη αναφορά για τα διάφορα τμήματα του λειτουργικού συστήματος FreeBSD, δεν εξηγούν πως όλα αυτά ενώνονται μεταξύ τους ώστε το λειτουργικό σύστημα να λειτουργεί ομαλά. Για αυτές τις πληροφορίες, θα πρέπει να συμβουλευτείτε ένα καλό βιβλίο διαχείρισης συστημάτων UNIX(R) και ένα καλό εγχειρίδιο χρήστη.
@@ -103,7 +117,7 @@ _Βιβλία & περιοδικά στην Αγγλική γλώσσα:_
* Leffler, Samuel J., Marshall Kirk McKusick, _The Design and Implementation of the 4.3BSD UNIX Operating System: Answer Book_. Reading, Mass. : Addison-Wesley, 1991. ISBN 0-201-54629-9
* McKusick, Marshall Kirk, Keith Bostic, Michael J Karels, and John Quarterman. _The Design and Implementation of the 4.4BSD Operating System_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-54979-4
+
-(Το κεφάλαιο 2 από αυτό το βιβλίο διατίθεται link:{design-44bsd}[online] ως μέρος του FreeBSD Documentation Project.)
+(Το κεφάλαιο 2 από αυτό το βιβλίο διατίθεται extref:{design-44bsd}[online] ως μέρος του FreeBSD Documentation Project.)
* Marshall Kirk McKusick, George V. Neville-Neil _The Design and Implementation of the FreeBSD Operating System_. Boston, Mass. : Addison-Wesley, 2004. ISBN 0-201-70245-2
* Stevens, W. Richard. _TCP/IP Illustrated, Volume 1: The Protocols_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-63346-9
* Schimmel, Curt. _Unix Systems for Modern Architectures_. Reading, Mass. : Addison-Wesley, 1994. ISBN 0-201-63338-8
diff --git a/documentation/content/el/books/handbook/book.adoc b/documentation/content/el/books/handbook/book.adoc
index 42922cd8c2..53b51a19be 100644
--- a/documentation/content/el/books/handbook/book.adoc
+++ b/documentation/content/el/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: Εγχειρίδιο του FreeBSD
authors:
- author: Ομάδα Τεκμηρίωσης του FreeBSD
copyright: 1995-2020 Ομάδα Τεκμηρίωσης του FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
---
@@ -12,54 +11,35 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:part-signifier: Μέρος
-:chapter-signifier: Κεφάλαιο
-:appendix-caption: Παράρτημα
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
:book: true
:pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
-:chapters-path: content/el/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/el/mailing-lists.adoc[]
-include::../../../../shared/el/teams.adoc[]
-include::../../../../shared/el/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/el/mailing-lists.adoc[]
-include::../../../../shared/el/teams.adoc[]
-include::../../../../shared/el/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -74,91 +54,91 @@ toc::[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
// Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..26;36..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
-include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1]
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}jails/_index.adoc[leveloffset=+1]
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
-include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}filesystems/_index.adoc[leveloffset=+1]
-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
-include::{chapters-path}dtrace/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}dtrace/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=7..19]
+include::{chapters-path}partiv.adoc[lines=15..27]
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
// Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
:sectnums!:
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/el/books/handbook/boot/_index.adoc b/documentation/content/el/books/handbook/boot/_index.adoc
index 2542df5791..7adefdcab7 100644
--- a/documentation/content/el/books/handbook/boot/_index.adoc
+++ b/documentation/content/el/books/handbook/boot/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/users
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/bsdinstall/_index.adoc b/documentation/content/el/books/handbook/bsdinstall/_index.adoc
index c5638b8a82..7e2c44ab0a 100644
--- a/documentation/content/el/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/el/books/handbook/bsdinstall/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/install
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/bsdinstall/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
-endif::[]
+:images-path: books/handbook/bsdinstall/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[bsdinstall-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/config/_index.adoc b/documentation/content/el/books/handbook/config/_index.adoc
index 8cbe711965..45dcd81964 100644
--- a/documentation/content/el/books/handbook/config/_index.adoc
+++ b/documentation/content/el/books/handbook/config/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/boot
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/config/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/config/
-endif::[]
+:images-path: books/handbook/config/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/config/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[config-synopsis]]
== Σύνοψη
@@ -304,7 +302,7 @@ HOME=/var/log
[IMPORTANT]
====
-Δεν θα πρέπει να χρησιμοποιήσετε την διαδικασία που περιγράφεται εδώ για την διόρθωση/εγκατάσταση του crontab του συστήματος. Απλά χρησιμοποιήστε τον αγαπημένο σας κειμενογράφο: το `cron` θα εντοπίσει ότι το αρχείο έχει τροποποιηθεί και θα αρχίσει άμεσα να χρησιμοποιεί την ανανεωμένη έκδοση του. Δείτε link:{faq}#ROOT-NOT-FOUND-CRON-ERRORS[αυτή την εγγραφή του FAQ ] για περισσότερες πληροφορίες.
+Δεν θα πρέπει να χρησιμοποιήσετε την διαδικασία που περιγράφεται εδώ για την διόρθωση/εγκατάσταση του crontab του συστήματος. Απλά χρησιμοποιήστε τον αγαπημένο σας κειμενογράφο: το `cron` θα εντοπίσει ότι το αρχείο έχει τροποποιηθεί και θα αρχίσει άμεσα να χρησιμοποιεί την ανανεωμένη έκδοση του. Δείτε extref:{faq}[αυτή την εγγραφή του FAQ, ROOT-NOT-FOUND-CRON-ERRORS] για περισσότερες πληροφορίες.
====
Για να εγκαταστήσετε ένα νέο [.filename]#crontab# χρήστη, πρώτα χρησιμοποιήστε τον αγαπημένο σας κειμενογράφο για να δημιουργήσετε ένα αρχείο με το απαιτούμενο τύπο, και τότε χρησιμοποιήστε το `crontab`. Η πιο κοινή χρήση του είναι:
@@ -389,7 +387,7 @@ Starting background file system checks in 60 seconds.
Χρησιμοποιώντας την μέθοδο αυτή, οι διαχειριστές μπορούν εύκολα να ελέγξουν τις υπηρεσίες του συστήματος χωρίς τα δυσνόητα "runlevels" όπως σε μερικά άλλα λειτουργικά συστήματα UNIX(R).
-Επιπλέον πληροφορίες για το σύστημα [.filename]#rc.d# μπορούν να βρεθούν στις σελίδες βοηθείας man:rc[8] και man:rc.subr[8]. Αν ενδιαφέρεστε για την εγγραφή δικών σας σεναρίων [.filename]#rc.d# ή για την βελτίωση των ήδη υπάρχοντων, θα βρείτε link:{rc-scripting}[τον σύνδεσμο αυτόν] αρκετά χρήσιμο.
+Επιπλέον πληροφορίες για το σύστημα [.filename]#rc.d# μπορούν να βρεθούν στις σελίδες βοηθείας man:rc[8] και man:rc.subr[8]. Αν ενδιαφέρεστε για την εγγραφή δικών σας σεναρίων [.filename]#rc.d# ή για την βελτίωση των ήδη υπάρχοντων, θα βρείτε extref:{rc-scripting}[τον σύνδεσμο αυτόν] αρκετά χρήσιμο.
[[config-network-setup]]
== Ρυθμίζοντας Τις Κάρτες Δικτύου
diff --git a/documentation/content/el/books/handbook/cutting-edge/_index.adoc b/documentation/content/el/books/handbook/cutting-edge/_index.adoc
index 1174367f3d..12c48ea870 100644
--- a/documentation/content/el/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/el/books/handbook/cutting-edge/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/dtrace
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[updating-upgrading-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/desktop/_index.adoc b/documentation/content/el/books/handbook/desktop/_index.adoc
index f2b766a5b3..2b5404024d 100644
--- a/documentation/content/el/books/handbook/desktop/_index.adoc
+++ b/documentation/content/el/books/handbook/desktop/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/multimedia
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[desktop-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/disks/_index.adoc b/documentation/content/el/books/handbook/disks/_index.adoc
index e1f2685c99..2a41333a84 100644
--- a/documentation/content/el/books/handbook/disks/_index.adoc
+++ b/documentation/content/el/books/handbook/disks/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/geom
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[disks-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/dtrace/_index.adoc b/documentation/content/el/books/handbook/dtrace/_index.adoc
index e8854b496d..32456099c3 100644
--- a/documentation/content/el/books/handbook/dtrace/_index.adoc
+++ b/documentation/content/el/books/handbook/dtrace/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/dtrace/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
-endif::[]
+:images-path: books/handbook/dtrace/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dtrace-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/eresources/_index.adoc b/documentation/content/el/books/handbook/eresources/_index.adoc
index 39eba3df83..e52476c305 100644
--- a/documentation/content/el/books/handbook/eresources/_index.adoc
+++ b/documentation/content/el/books/handbook/eresources/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/pgpkeys
[[eresources]]
= Πηγές Πληροφόρησης στο Διαδίκτυο
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Η ραγδαία εξέλιξη του FreeBSD καθιστά τα έντυπα μέσα ανίκανα να ακολουθήσουν τις τελευταίες εξελίξεις. Οι ηλεκτρονικές πηγές είναι ο καλύτερος (αν όχι ο μόνος) τρόπος για να παραμείνετε ενήμερος για τις τελευταίες εξελίξεις. Καθώς το FreeBSD είναι μια εθελοντική προσπάθεια, η κοινότητα των χρηστών λειτουργεί και ως "τμήμα τεχνικής υποστήριξης", με το ηλεκτρονικό ταχυδρομείο, τα web forums, και τα USENET news να είναι οι πλέον αποτελεσματικοί τρόποι για να έλθετε σε επαφή με αυτή την κοινότητα.
@@ -47,9 +60,9 @@ include::shared/el/urls.adoc[]
_Αν θέλετε να δοκιμάσετε την ικανότητα σας να στέλνετε μηνύματα στις λίστες του FreeBSD, στείλτε ένα δοκιμαστικό μήνυμα στην λίστα {freebsd-test}._ Παρακαλούμε μη στέλνετε δοκιμαστικά μηνύματα σε οποιαδήποτε άλλη λίστα.
====
-Αν βρίσκεστε σε δίλημμα σχετικά με το ποια λίστα να στείλετε μια ερώτηση, δείτε το link:{freebsd-questions-article}[Πως να χρησιμοποιείτε με επιτυχία την λίστα ηλεκτρονικού ταχυδρομείου FreeBSD-questions].
+Αν βρίσκεστε σε δίλημμα σχετικά με το ποια λίστα να στείλετε μια ερώτηση, δείτε το extref:{freebsd-questions-article}[Πως να χρησιμοποιείτε με επιτυχία την λίστα ηλεκτρονικού ταχυδρομείου FreeBSD-questions].
-Πριν στείλετε κάτι σε οποιαδήποτε λίστα, μάθετε πως να χρησιμοποιείτε καλύτερα τις λίστες ηλεκτρονικού ταχυδρομείου. Για παράδειγμα, δείτε πως μπορείτε να βοηθήσετε ώστε να αποφεύγονται συχνά επαναλαμβανόμενες συζητήσεις, διαβάζοντας το κείμενο link:{mailing-list-faq}[Συχνές Ερωτήσεις Σχετικά με τις Λίστες Ταχυδρομείου] (FAQ).
+Πριν στείλετε κάτι σε οποιαδήποτε λίστα, μάθετε πως να χρησιμοποιείτε καλύτερα τις λίστες ηλεκτρονικού ταχυδρομείου. Για παράδειγμα, δείτε πως μπορείτε να βοηθήσετε ώστε να αποφεύγονται συχνά επαναλαμβανόμενες συζητήσεις, διαβάζοντας το κείμενο extref:{mailing-list-faq}[Συχνές Ερωτήσεις Σχετικά με τις Λίστες Ταχυδρομείου] (FAQ).
Για όλες τις λίστες ηλεκτρονικού ταχυδρομείου διατηρείται αρχείο με τις παλιές δημοσιεύσεις, στο οποίο μπορεί να γίνει αναζήτηση χρησιμοποιώντας την link:https://www.FreeBSD.org/search/[Δικτυακή Τοποθεσία του FreeBSD]. Είναι δυνατή η αναζήτηση στο αρχείο μέσω λέξεων-κλειδιών, το οποίο αποτελεί ένα άριστο τρόπο για να βρείτε απαντήσεις σε συχνές ερωτήσεις. Πριν στείλετε μια ερώτηση, καλό θα είναι να πραγματοποιήσετε μια τέτοια αναζήτηση. Σημειώστε επίσης ότι τα μηνύματα που στέλνονται σε αυτές τις λίστες αποθηκεύονται για πάντα. Αν σας προβληματίζει η προστασία των προσωπικών σας δεδομένων, σας συνιστούμε να χρησιμοποιήσετε μια δευτερεύουσα διεύθυνση email, και να μην γράφετε ποτέ προσωπικές σας πληροφορίες.
diff --git a/documentation/content/el/books/handbook/filesystems/_index.adoc b/documentation/content/el/books/handbook/filesystems/_index.adoc
index 289d8c4e78..75ba333e2a 100644
--- a/documentation/content/el/books/handbook/filesystems/_index.adoc
+++ b/documentation/content/el/books/handbook/filesystems/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/virtualization
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/filesystems/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
-endif::[]
+:images-path: books/handbook/filesystems/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[filesystems-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/firewalls/_index.adoc b/documentation/content/el/books/handbook/firewalls/_index.adoc
index ab01667f95..348fab7a60 100644
--- a/documentation/content/el/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/el/books/handbook/firewalls/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/advanced-networking
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 30
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 30
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[firewalls-intro]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/geom/_index.adoc b/documentation/content/el/books/handbook/geom/_index.adoc
index aa61b9ca2b..0177fc03c4 100644
--- a/documentation/content/el/books/handbook/geom/_index.adoc
+++ b/documentation/content/el/books/handbook/geom/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/filesystems
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[GEOM-synopsis]]
== Σύνοψη
@@ -646,4 +644,4 @@ options GEOM_JOURNAL
Για καλύτερη απόδοση, ίσως είναι επιθυμητή η τήρηση του journal σε διαφορετικό δίσκο. Για τις περιπτώσεις αυτές, ο παροχέας ημερολογίου (η συσκευή δίσκου που θα περιέχει το journal) πρέπει να δίνεται ως παράμετρος στην εντολή, αμέσως μετά τη συσκευή δίσκου στην οποία θα ενεργοποιηθεί το journaling. Μπορείτε επίσης να ενεργοποιήσετε το journaling σε υπάρχοντα συστήματα αρχείων χρησιμοποιώντας την εντολή `tunefs`. Ωστόσο, θα πρέπει να κρατήσετε αντίγραφο ασφαλείας των αρχείων σας, πριν επιχειρήσετε να κάνετε αλλαγές σε ένα υπάρχον σύστημα αρχείων. Στις περισσότερες περιπτώσεις, η `tunefs` θα αποτύχει αν δεν μπορέσει να δημιουργήσει το journal, αλλά αυτό δεν σας προστατεύει από απώλεια δεδομένων που μπορεί να προέλθει από κακή χρήση της `tunefs`.
-Είναι επίσης δυνατόν να χρησιμοποιηθεί journaling στον δίσκο εκκίνησης ενός συστήματος FreeBSD. Διαβάστε το άρθρο link:{gjournal-desktop}[Υλοποίηση του UFS Journaling σε ένα Desktop Υπολογιστή] για λεπτομερείς οδηγίες.
+Είναι επίσης δυνατόν να χρησιμοποιηθεί journaling στον δίσκο εκκίνησης ενός συστήματος FreeBSD. Διαβάστε το άρθρο extref:{gjournal-desktop}[Υλοποίηση του UFS Journaling σε ένα Desktop Υπολογιστή] για λεπτομερείς οδηγίες.
diff --git a/documentation/content/el/books/handbook/install/_index.adoc b/documentation/content/el/books/handbook/install/_index.adoc
index d40624c818..3f989349ea 100644
--- a/documentation/content/el/books/handbook/install/_index.adoc
+++ b/documentation/content/el/books/handbook/install/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/basics
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/install/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/install/
-endif::[]
+:images-path: books/handbook/install/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/install/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[install-synopsis]]
== Σύνοψη
@@ -2289,7 +2287,7 @@ Please press any key to reboot.
[NOTE]
====
-Αν ενδιαφέρεστε να δημιουργήσετε μια εξειδικευμένη έκδοση του FreeBSD, δείτε το link:{releng}[Release Engineering Article].
+Αν ενδιαφέρεστε να δημιουργήσετε μια εξειδικευμένη έκδοση του FreeBSD, δείτε το extref:{releng}[Release Engineering Article].
====
[[install-ftp]]
@@ -2400,7 +2398,7 @@ C:\> xcopy e:\manpages c:\freebsd\manpages\ /s
Αν χρησιμοποιείτε modem, τότε το PPP είναι σχεδόν σίγουρα η μόνη σας επιλογή. Βεβαιωθείτε ότι έχετε άμεσα διαθέσιμες τις πληροφορίες για τον παροχέα σας, καθώς θα τις χρειαστείτε σχετικά νωρίς στη διαδικασία εγκατάστασης.
-Αν χρησιμοποιείτε PAP ή CHAP για να συνδεθείτε με τον ISP σας (με άλλα λόγια, μπορείτε στα Windows(R) να συνδεθείτε με τον ISP σας χωρίς να χρησιμοποιήσετε script), τότε το μόνο που θα χρειαστείτε είναι να γράψετε την εντολή `dial` στην προτροπή της εφαρμογής ppp. Διαφορετικά, θα πρέπει να ξέρετε πως να καλέσετε τον ISP σας, χρησιμοποιώντας εντολές "AT commands" οι οποίες είναι συγκεκριμένες για το modem σας, καθώς το πρόγραμμα κλήσεων του PPP (dialer) παρέχει ένα πολύ απλό εξομοιωτή τερματικού. Ανατρέξτε στο user-ppp crossref:ppp-and-slip[userppp,handbook] και link:{faq}#ppp/[FAQ] για περισσότερες πληροφορίες. Αν έχετε προβλήματα, μπορείτε να κατευθύνετε την καταγραφή (logging) στην οθόνη με την εντολή `set log local ...`.
+Αν χρησιμοποιείτε PAP ή CHAP για να συνδεθείτε με τον ISP σας (με άλλα λόγια, μπορείτε στα Windows(R) να συνδεθείτε με τον ISP σας χωρίς να χρησιμοποιήσετε script), τότε το μόνο που θα χρειαστείτε είναι να γράψετε την εντολή `dial` στην προτροπή της εφαρμογής ppp. Διαφορετικά, θα πρέπει να ξέρετε πως να καλέσετε τον ISP σας, χρησιμοποιώντας εντολές "AT commands" οι οποίες είναι συγκεκριμένες για το modem σας, καθώς το πρόγραμμα κλήσεων του PPP (dialer) παρέχει ένα πολύ απλό εξομοιωτή τερματικού. Ανατρέξτε στο user-ppp crossref:ppp-and-slip[userppp,handbook] και extref:{faq}[FAQ, ppp] για περισσότερες πληροφορίες. Αν έχετε προβλήματα, μπορείτε να κατευθύνετε την καταγραφή (logging) στην οθόνη με την εντολή `set log local ...`.
Αν υπάρχει διαθέσιμη φυσική σύνδεση με άλλο μηχάνημα FreeBSD, μπορείτε επίσης να εγκαταστήσετε μέσω παράλληλου καλωδίου "laplink". Η ταχύτητα μετάδοσης δεδομένων μέσω της παράλληλης θύρας είναι αρκετά υψηλότερη συνήθως από ότι της σειριακής (μέχρι 50 kbytes/sec), με αποτέλεσμα γρηγορότερη εγκατάσταση.
diff --git a/documentation/content/el/books/handbook/introduction/_index.adoc b/documentation/content/el/books/handbook/introduction/_index.adoc
index df487a4bc8..28aaea6830 100644
--- a/documentation/content/el/books/handbook/introduction/_index.adoc
+++ b/documentation/content/el/books/handbook/introduction/_index.adoc
@@ -13,25 +13,35 @@ next: books/handbook/bsdinstall
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/handbook/introduction/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-synopsis]]
== Σύνοψη
@@ -49,7 +59,7 @@ toc::[]
[[nutshell]]
== Καλώς ήλθατε στο FreeBSD!
-Το FreeBSD είναι ένα λειτουργικό σύστημα βασισμένο στο 4.4BSD-Lite, το οποίο μπορεί να χρησιμοποιηθεί σε Η/Υ Intel (x86 και Itanium(R)), AMD64 και Sun UltraSPARC(R). Σε εξέλιξη βρίσκεται επίσης η διαδικασία μεταφοράς του FreeBSD σε άλλες αρχιτεκτονικές. Μπορείτε επίσης να διαβάσετε για <<history,την ιστορία του FreeBSD>>, ή για την <<relnotes,πιο πρόσφατη επίσημη έκδοση του>>. Εάν ενδιαφέρεστε να συμβάλλετε με κάποιο τρόπο στο Project (κώδικα, hardware, χρηματοδότηση), διαβάστε το άρθρο link:{contributing}[Συνεισφέροντας στην Ανάπτυξη του FreeBSD].
+Το FreeBSD είναι ένα λειτουργικό σύστημα βασισμένο στο 4.4BSD-Lite, το οποίο μπορεί να χρησιμοποιηθεί σε Η/Υ Intel (x86 και Itanium(R)), AMD64 και Sun UltraSPARC(R). Σε εξέλιξη βρίσκεται επίσης η διαδικασία μεταφοράς του FreeBSD σε άλλες αρχιτεκτονικές. Μπορείτε επίσης να διαβάσετε για <<history,την ιστορία του FreeBSD>>, ή για την <<relnotes,πιο πρόσφατη επίσημη έκδοση του>>. Εάν ενδιαφέρεστε να συμβάλλετε με κάποιο τρόπο στο Project (κώδικα, hardware, χρηματοδότηση), διαβάστε το άρθρο extref:{contributing}[Συνεισφέροντας στην Ανάπτυξη του FreeBSD].
[[os-overview]]
=== Τι μπορεί να κάνει το FreeBSD;
@@ -89,7 +99,7 @@ toc::[]
* _Εκπαίδευση:_ Είστε φοιτητής πληροφορικής ή κάποιου σχετικού τομέα; Δεν υπάρχει καλύτερος τρόπος να μάθετε για λειτουργικά συστήματα, αρχιτεκτονικές Η/Υ, και συστήματα δικτύων από την πρακτική εμπειρία και την σε βάθος γνώση που μπορεί να σας παρέχει το FreeBSD. Το μεγάλο πλήθος των δωρεάν διαθέσιμων πακέτων εφαρμογών CAD, γραφικής σχεδίασης, και μαθηματικών, κάνουν το FreeBSD εξαιρετικά χρήσιμο σε όσους το κύριο ενδιαφέρον τους στους υπολογιστές είναι να _κάνουν τη δουλειά τους_!
* _Έρευνα:_ Με διαθέσιμο τον πηγαίο κώδικα ολόκληρου του συστήματος, το FreeBSD είναι μία εξαίρετη πλατφόρμα για την έρευνα στα λειτουργικά συστήματα όπως επίσης για άλλους κλάδους της πληροφορικής. Η φύση της ελεύθερης διάθεσης του FreeBSD επιτρέπει επίσης σε απομακρυσμένες ομάδες να συνεργάζονται σε ιδέες ή να μοιράζονται την ανάπτυξη εφαρμογών, χωρίς να ανησυχούν για άδειες χρήσης και χωρίς να περιορίζεται η δυνατότητα τους για ελεύθερη συζήτηση οποιουδήποτε θέματος σε ανοιχτές ομάδες συζήτησης (forums).
* _Δικτύωση:_ Χρειάζεστε ένα καινούργιο router (δρομολογητή); Ένα εξυπηρετητή DNS; Ένα firewall για να κρατάτε τον κόσμο έξω από το εσωτερικό σας δίκτυο; Το FreeBSD μπορεί εύκολα να μετατρέψει εκείνο το παλιό PC που κάθεται αχρησιμοποίητο στην γωνία, σε ένα προηγμένο δρομολογητή με εξεζητημένες δυνατότητες φιλτραρίσματος πακέτων.
-* _Embedded:_ Το FreeBSD αποτελεί μια εξαιρετική πλατφόρμα για τη δημιουργία embedded συστημάτων. Με υποστήριξη για τις πλατφόρμες ARM(R), MIPS(R) και PowerPC(R) και σε συνδυασμό με αξιόπιστη δικτύωση, προηγμένα χαρακτηριστικά και την ελεύθερη άδεια link:{faq}#bsd-license-restrictions[BSD] το FreeBSD είναι ένα εξαιρετικό σημείο εκκίνησης για embedded συστήματα router, firewall και άλλα.
+* _Embedded:_ Το FreeBSD αποτελεί μια εξαιρετική πλατφόρμα για τη δημιουργία embedded συστημάτων. Με υποστήριξη για τις πλατφόρμες ARM(R), MIPS(R) και PowerPC(R) και σε συνδυασμό με αξιόπιστη δικτύωση, προηγμένα χαρακτηριστικά και την ελεύθερη άδεια extref:{faq}[BSD, bsd-license-restrictions] το FreeBSD είναι ένα εξαιρετικό σημείο εκκίνησης για embedded συστήματα router, firewall και άλλα.
* _Desktop:_ Το FreeBSD είναι μια εξαίρετη επιλογή για ένα οικονομικό desktop. Το FreeBSD σας επιτρέπει να επιλέξετε ανάμεσα σε πολλά ανοικτού κώδικα περιβάλλοντα εργασίας τα οποία περιλαμβάνουν το GNOME και το KDE. To FreeBSD μπορεί να ξεκινήσει ακόμα και "diskless" (χωρίς σκληρό δίσκο), κάνοντας έτσι τους προσωπικούς σταθμούς εργασίας ακόμη πιο φτηνούς και ευκολότερους στη διαχείριση.
* _Ανάπτυξη Λογισμικού:_ Το βασικό σύστημα του FreeBSD διατίθεται ολοκληρωμένο, με πλήρη σειρά εργαλείων ανάπτυξης, που περιλαμβάνουν ένα πλήρη C/C++ compiler και debugger.
@@ -186,7 +196,7 @@ To FreeBSD Project γεννήθηκε στις αρχές του 1993, μερι
[[development]]
=== Το Μοντέλο Ανάπτυξης του FreeBSD
-Η ανάπτυξη του FreeBSD είναι μία πολύ ανοικτή και ευέλικτη διαδικασία, αφού κυριολεκτικά βασίζεται στην συνεισφορά χιλιάδων ανθρώπων από όλο τον κόσμο, όπως μπορείτε να δείτε από την link:{contributors}[λίστα των συνεργατών] μας. Η υποδομή ανάπτυξης του FreeBSD επιτρέπει στα χιλιάδες μέλη των συνεργατών μας να συνεργάζονται μέσω του Ίντερνετ. Είμαστε σταθερά σε αναζήτηση για νέα μέλη στην ομάδα ανάπτυξης και για ιδέες, και όσοι ενδιαφέρονται να ασχοληθούν ακόμη περισσότερο με το project χρειάζεται απλά να επικοινωνήσουν μαζί μας στην {freebsd-hackers}. Επίσης η {freebsd-announce} είναι διαθέσιμη σε όσους επιθυμούν να ενημερώσουν άλλους χρήστες του FreeBSD για βασικούς τομείς εργασίας πάνω στο Project.
+Η ανάπτυξη του FreeBSD είναι μία πολύ ανοικτή και ευέλικτη διαδικασία, αφού κυριολεκτικά βασίζεται στην συνεισφορά χιλιάδων ανθρώπων από όλο τον κόσμο, όπως μπορείτε να δείτε από την extref:{contributors}[λίστα των συνεργατών] μας. Η υποδομή ανάπτυξης του FreeBSD επιτρέπει στα χιλιάδες μέλη των συνεργατών μας να συνεργάζονται μέσω του Ίντερνετ. Είμαστε σταθερά σε αναζήτηση για νέα μέλη στην ομάδα ανάπτυξης και για ιδέες, και όσοι ενδιαφέρονται να ασχοληθούν ακόμη περισσότερο με το project χρειάζεται απλά να επικοινωνήσουν μαζί μας στην {freebsd-hackers}. Επίσης η {freebsd-announce} είναι διαθέσιμη σε όσους επιθυμούν να ενημερώσουν άλλους χρήστες του FreeBSD για βασικούς τομείς εργασίας πάνω στο Project.
Χρήσιμα πράγματα που πρέπει να γνωρίζετε για το FreeBSD Project και την διαδικασία ανάπτυξης του, είτε δουλεύετε ανεξάρτητα είτε ως στενοί συνεργάτες:
@@ -207,7 +217,7 @@ The FreeBSD core team[[development-core]]::
Εξωτερικοί συνεργάτες::
Τέλος, αλλά οπωσδήποτε όχι μικρότερης σημασίας, η μεγαλύτερη ομάδα ανάπτυξης είναι οι ίδιοι οι χρήστες που μας παρέχουν σχόλια και διορθώσεις των bug σε σχεδόν σταθερή βάση. Ο κύριος τρόπος για να κρατάτε επαφή με την μη-συγκεντρωτική ομάδα ανάπτυξης του FreeBSD είναι να γίνετε συνδρομητές στην {freebsd-hackers} όπου γίνονται οι ανάλογες συζητήσεις. Δείτε το crossref:eresources[eresources, Πηγές Πληροφόρησης στο Διαδίκτυο] για περισσότερες πληροφορίες σχετικά με τις διάφορες λίστες ηλεκτρονικού ταχυδρομείου του FreeBSD.
+
-link:{contributors}[Η Λίστα Συνεργατών του FreeBSD] είναι μεγάλη και συνεχώς αυξανόμενη, επομένως γιατί να μην γίνετε και εσείς μέλος της και να συμβάλλετε σήμερα σε κάτι στο FreeBSD;
+extref:{contributors}[Η Λίστα Συνεργατών του FreeBSD] είναι μεγάλη και συνεχώς αυξανόμενη, επομένως γιατί να μην γίνετε και εσείς μέλος της και να συμβάλλετε σήμερα σε κάτι στο FreeBSD;
+
Η παροχή κώδικα δεν είναι ο μόνος τρόπος για να συνεισφέρετε στο project. Για μια ολοκληρωμένη λίστα των πραγμάτων στα οποία χρειαζόμαστε βοήθεια, παρακαλούμε επισκεφθείτε την link:https://www.FreeBSD.org/[Δικτυακή τοποθεσία του FreeBSD Project].
diff --git a/documentation/content/el/books/handbook/jails/_index.adoc b/documentation/content/el/books/handbook/jails/_index.adoc
index 4fd0134578..f70a52b34d 100644
--- a/documentation/content/el/books/handbook/jails/_index.adoc
+++ b/documentation/content/el/books/handbook/jails/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mac
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/jails/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
-endif::[]
+:images-path: books/handbook/jails/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[jails-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/kernelconfig/_index.adoc b/documentation/content/el/books/handbook/kernelconfig/_index.adoc
index 04d2ee822b..769807ae98 100644
--- a/documentation/content/el/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/el/books/handbook/kernelconfig/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/printing
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kernelconfig-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/l10n/_index.adoc b/documentation/content/el/books/handbook/l10n/_index.adoc
index dbc00159d3..c1b87806a7 100644
--- a/documentation/content/el/books/handbook/l10n/_index.adoc
+++ b/documentation/content/el/books/handbook/l10n/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/cutting-edge
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/linuxemu/_index.adoc b/documentation/content/el/books/handbook/linuxemu/_index.adoc
index f80ea86199..2b430cb140 100644
--- a/documentation/content/el/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/el/books/handbook/linuxemu/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[linuxemu-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/mac/_index.adoc b/documentation/content/el/books/handbook/mac/_index.adoc
index 8f9db0578f..6a55fd9630 100644
--- a/documentation/content/el/books/handbook/mac/_index.adoc
+++ b/documentation/content/el/books/handbook/mac/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/audit
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/mail/_index.adoc b/documentation/content/el/books/handbook/mail/_index.adoc
index 5a53320b93..d734855395 100644
--- a/documentation/content/el/books/handbook/mail/_index.adoc
+++ b/documentation/content/el/books/handbook/mail/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/network-servers
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 28
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 28
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mail-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/mirrors/_index.adoc b/documentation/content/el/books/handbook/mirrors/_index.adoc
index 4342511289..1b21f803f7 100644
--- a/documentation/content/el/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/el/books/handbook/mirrors/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/bibliography
[[mirrors]]
= Που θα Βρείτε το FreeBSD
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mirrors-cdrom]]
== Εκδόσεις σε CDROM και DVD
@@ -971,7 +984,7 @@ doc/zh_*
+
[IMPORTANT]
====
-Αν σκοπεύετε να δημιουργήσετε το δικό σας τοπικό αντίγραφο του [.filename]#ports/INDEX#, θα _πρέπει_ να δεχτείτε τη συλλογή `ports-all` (ολόκληρο το δέντρο των ports). H δημιουργία του [.filename]#ports/INDEX# από μη-πλήρες δέντρο δεν υποστηρίζεται. Δείτε το link:{faq}#MAKE-INDEX[ FAQ].
+Αν σκοπεύετε να δημιουργήσετε το δικό σας τοπικό αντίγραφο του [.filename]#ports/INDEX#, θα _πρέπει_ να δεχτείτε τη συλλογή `ports-all` (ολόκληρο το δέντρο των ports). H δημιουργία του [.filename]#ports/INDEX# από μη-πλήρες δέντρο δεν υποστηρίζεται. Δείτε το extref:{faq}[FAQ, MAKE-INDEX].
====
`ports-accessibility release=cvs`::::
@@ -1406,7 +1419,7 @@ RELENG_2_2::
=== Ετικέτες Εκδόσεων (Release Tags)
-Οι ετικέτες αυτές αναφέρονται σε μια συγκεκριμένη χρονική στιγμή κατά την οποία έγινε μια κανονική έκδοση (release) του FreeBSD. Η διαδικασία της έκδοσης τεκμηριώνεται με περισσότερες λεπτομέρειες στα έγγραφα link:https://www.FreeBSD.org/releng/[Πληροφορίες Διαδικασίας Έκδοσης] και link:{releng}#release-proc/[Διαδικασία Έκδοσης]. Το δέντρο [.filename]#src# χρησιμοποιεί ονόματα ετικετών που ξεκινούν με τη λέξη `RELENG_`. Τα δέντρα [.filename]#ports# και [.filename]#doc# χρησιμοποιούν ετικέτες που ξεκινούν με τη λέξη `RELEASE`. Τέλος, στο δέντρο [.filename]#www# δεν δίνεται κάποια ειδική ετικέτα που να έχει σχέση με τις εκδόσεις.
+Οι ετικέτες αυτές αναφέρονται σε μια συγκεκριμένη χρονική στιγμή κατά την οποία έγινε μια κανονική έκδοση (release) του FreeBSD. Η διαδικασία της έκδοσης τεκμηριώνεται με περισσότερες λεπτομέρειες στα έγγραφα link:https://www.FreeBSD.org/releng/[Πληροφορίες Διαδικασίας Έκδοσης] και extref:{releng}[Διαδικασία Έκδοσης, release-proc]. Το δέντρο [.filename]#src# χρησιμοποιεί ονόματα ετικετών που ξεκινούν με τη λέξη `RELENG_`. Τα δέντρα [.filename]#ports# και [.filename]#doc# χρησιμοποιούν ετικέτες που ξεκινούν με τη λέξη `RELEASE`. Τέλος, στο δέντρο [.filename]#www# δεν δίνεται κάποια ειδική ετικέτα που να έχει σχέση με τις εκδόσεις.
RELENG_9_0_0_RELEASE::
FreeBSD 9.0
diff --git a/documentation/content/el/books/handbook/multimedia/_index.adoc b/documentation/content/el/books/handbook/multimedia/_index.adoc
index 73563f83ec..fe64232bd4 100644
--- a/documentation/content/el/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/el/books/handbook/multimedia/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/kernelconfig
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[multimedia-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/network-servers/_index.adoc b/documentation/content/el/books/handbook/network-servers/_index.adoc
index 5577b5c855..a6d0631e0e 100644
--- a/documentation/content/el/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/el/books/handbook/network-servers/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/firewalls
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 29
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 29
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[network-servers-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/parti.adoc b/documentation/content/el/books/handbook/parti.adoc
index 7e00dc3da4..34ff9778ec 100644
--- a/documentation/content/el/books/handbook/parti.adoc
+++ b/documentation/content/el/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
next: books/handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[getting-started]]
= Ξεκινώντας με το FreeBSD
@@ -17,4 +25,4 @@ next: books/handbook/introduction
Σε αυτό το τμήμα του βιβλίου, έχουμε προσπαθήσει να μειώσουμε στο ελάχιστο τις αναφορές σε τμήματα ή κεφάλαια του Εγχειριδίου τα οποία δεν έχετε ήδη διαβάσει. Αυτό αποσκοπεί στο να γίνει πιο εύκολη η ανάγνωση του τμήματος αυτού του Εγχειριδίου από την αρχή μέχρι και το τέλος, χωρίς να απαιτείται να ψάχνετε συνεχώς τα επόμενα ή προηγούμενα τμήματα.
-include::content/el/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/el/books/handbook/partii.adoc b/documentation/content/el/books/handbook/partii.adoc
index 78db507fc1..669cd5cc0e 100644
--- a/documentation/content/el/books/handbook/partii.adoc
+++ b/documentation/content/el/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
next: books/handbook/desktop
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[common-tasks]]
= Βασικές Εργασίες
@@ -17,4 +25,4 @@ next: books/handbook/desktop
Μερικά από αυτά τα κεφάλαια απαιτούν να έχετε μελετήσει πιο πριν κάποιο άλλο κεφάλαιο. Όπου είναι απαραίτητο κάτι τέτοιο, αναφέρεται στη σύνοψη του κάθε κεφαλαίου.
-include::content/el/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/el/books/handbook/partiii.adoc b/documentation/content/el/books/handbook/partiii.adoc
index ece3e954eb..05922429b0 100644
--- a/documentation/content/el/books/handbook/partiii.adoc
+++ b/documentation/content/el/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
next: books/handbook/config
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[system-administration]]
= Διαχείριση Συστήματος
@@ -11,4 +19,4 @@ next: books/handbook/config
Αυτά τα κεφάλαια έχουν σχεδιαστεί περισσότερο ως οδηγός αναφοράς παρά ως εισαγωγικό κείμενο. Γι αυτό είναι πιο χρήσιμα ως οδηγοί στους οποίους μπορείτε να ανατρέξετε όταν χρειάζεστε κάποια πληροφορία για το FreeBSD. Δε χρειάζεται να τα διαβάσετε με κάποια συγκεκριμένη σειρά, ούτε χρειάζεται να τα έχετε διαβάσει όλα πριν αρχίσετε να ασχολείστε με το FreeBSD.
-include::content/el/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/el/books/handbook/partiv.adoc b/documentation/content/el/books/handbook/partiv.adoc
index 47ee594169..3b671d5de6 100644
--- a/documentation/content/el/books/handbook/partiv.adoc
+++ b/documentation/content/el/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/dtrace
next: books/handbook/serialcomms
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[network-communication]]
= Δικτυακές Επικοινωνίες
@@ -18,4 +26,4 @@ next: books/handbook/serialcomms
Αυτά τα κεφάλαια έχουν σχεδιαστεί περισσότερο ως οδηγός αναφοράς παρά ως εισαγωγικό κείμενο. Γι αυτό είναι πιο χρήσιμα ως οδηγοί στους οποίους μπορείτε να ανατρέξετε όταν χρειάζεστε κάποια πληροφορία για το FreeBSD. Δε χρειάζεται να τα διαβάσετε με κάποια συγκεκριμένη σειρά, ούτε χρειάζεται να τα έχετε διαβάσει όλα πριν αρχίσετε να ασχολείστε με το FreeBSD.
-include::content/el/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/el/books/handbook/partv.adoc b/documentation/content/el/books/handbook/partv.adoc
index 9c8b2f2b5d..2c2de68caf 100644
--- a/documentation/content/el/books/handbook/partv.adoc
+++ b/documentation/content/el/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
next: books/handbook/mirrors
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= Παραρτήματα
-include::content/el/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/el/books/handbook/pgpkeys/_index.adoc b/documentation/content/el/books/handbook/pgpkeys/_index.adoc
index 7ed4bf4060..23f466868a 100644
--- a/documentation/content/el/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/el/books/handbook/pgpkeys/_index.adoc
@@ -9,28 +9,44 @@ next: books/handbook/freebsd-glossary
[[pgpkeys]]
= Κλειδιά PGP
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Στο παράρτημα αυτό, θα βρείτε τα δημόσια PGP κλειδιά των officers και των μελών της ομάδας ανάπτυξης του FreeBSD. Μπορείτε να τα χρησιμοποιήσετε για να ελέγξετε μια ψηφιακή υπογραφή ή για να στείλετε κρυπτογραφημένο email σε κάποιο μέλος της ομάδας. Μπορείτε να κατεβάσετε την πλήρη λίστα από κλειδιά χρηστών του `FreeBSD.org`, από την τοποθεσία link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
diff --git a/documentation/content/el/books/handbook/ports/_index.adoc b/documentation/content/el/books/handbook/ports/_index.adoc
index 35872f8698..979f0dd343 100644
--- a/documentation/content/el/books/handbook/ports/_index.adoc
+++ b/documentation/content/el/books/handbook/ports/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/x11
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ports-synopsis]]
== Σύνοψη
@@ -417,7 +415,7 @@ docbook =
* Ένα αρχείο [.filename]#pkg-descr#. Αυτό είναι μία πιο λεπτομερής, συχνά πολλών γραμμών, περιγραφή του προγράμματος.
* Ένα αρχείο [.filename]#pkg-plist#. Αυτό περιέχει μια λίστα όλων των αρχείων που θα εγκατασταθούν από το port. Επίσης καθοδηγεί το σύστημα των ports τι αρχεία να αφαιρέσει κατά την απεγκατάσταση.
-Μερικά ports έχουν και άλλα αρχεία, όπως το [.filename]#pkg-message#. Το σύστημα των ports χρησιμοποιεί αυτά τα αρχεία για να χειριστεί ειδικές περιστάσεις. Αν θέλετε περισσότερες λεπτομέρειες για αυτά τα αρχεία, και τα ports γενικότερα, δείτε το link:{porters-handbook}[FreeBSD Porter's Handbook].
+Μερικά ports έχουν και άλλα αρχεία, όπως το [.filename]#pkg-message#. Το σύστημα των ports χρησιμοποιεί αυτά τα αρχεία για να χειριστεί ειδικές περιστάσεις. Αν θέλετε περισσότερες λεπτομέρειες για αυτά τα αρχεία, και τα ports γενικότερα, δείτε το extref:{porters-handbook}[FreeBSD Porter's Handbook].
Το port περιέχει οδηγίες για το πως να μεταγλωττιστεί ο πηγαίος κώδικας, αλλά δεν περιέχει τον πηγαίο κώδικα. Μπορείτε να προμηθευτείτε τον πηγαίο κώδικα από ένα CD-ROM ή από το Διαδίκτυο. Ο πηγαίος κώδικας διανέμεται με οποιοδήποτε τρόπο επιθυμεί ο δημιουργός του. Συχνά είναι ένα tarred και gzipped αρχείο, αλλά μπορεί να είναι συμπιεσμένος με κάποιο άλλο εργαλείο ή να είναι ακόμα και ασυμπίεστος. Ο πηγαίος κώδικας του προγράμματος, σε οποιαδήποτε μορφή κι αν διατίθεται, λέγεται "distfile". Οι δύο μέθοδοι για να εγκαταστήσετε ένα FreeBSD port περιγράφονται παρακάτω.
@@ -822,11 +820,11 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch
+
[NOTE]
====
-Μερικά ports δεν συντηρούνται από κάποιο συγκεκριμένο άτομο, αλλά από κάποια link:{mailing-list-faq}[mailing list]. Πολλές, αν όχι όλες, από αυτές τις διευθύνσεις έχουν την μορφή mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org]. Παρακαλούμε να το έχετε υπόψη σας κατά τη διατύπωση των ερωτήσεων σας.
+Μερικά ports δεν συντηρούνται από κάποιο συγκεκριμένο άτομο, αλλά από κάποια extref:{mailing-list-faq}[mailing list]. Πολλές, αν όχι όλες, από αυτές τις διευθύνσεις έχουν την μορφή mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org]. Παρακαλούμε να το έχετε υπόψη σας κατά τη διατύπωση των ερωτήσεων σας.
Συγκεκριμένα, τα ports που φαίνονται ότι συντηρούνται από το mailto:ports@FreeBSD.org[ports@FreeBSD.org], δεν συντηρούνται από κανέναν στην πραγματικότητα. Διορθώσεις και υποστήριξη, αν υπάρχουν, έρχονται γενικά από την κοινότητα που συμμετέχει στην συγκεκριμένη mailing list. Χρειαζόμαστε πάντοτε περισσότερους εθελοντές!
====
+
-Αν δεν λάβετε απάντηση, μπορείτε να χρησιμοποιήσετε το man:send-pr[1] για να στείλετε μια αναφορά σφάλματος (δείτε το link:{problem-reports}[Γράφοντας Αναφορές Σφάλματος για το FreeBSD]).
-. Διορθώστε το! Το link:{porters-handbook}[Porter's Handbook] περιέχει λεπτομερείς πληροφορίες για την υποδομή των "Ports" ώστε να μπορείτε να διορθώσετε το περιστασιακό προβληματικό port ή ακόμα και να δημιουργήσετε ένα δικό σας port!
+Αν δεν λάβετε απάντηση, μπορείτε να χρησιμοποιήσετε το man:send-pr[1] για να στείλετε μια αναφορά σφάλματος (δείτε το extref:{problem-reports}[Γράφοντας Αναφορές Σφάλματος για το FreeBSD]).
+. Διορθώστε το! Το extref:{porters-handbook}[Porter's Handbook] περιέχει λεπτομερείς πληροφορίες για την υποδομή των "Ports" ώστε να μπορείτε να διορθώσετε το περιστασιακό προβληματικό port ή ακόμα και να δημιουργήσετε ένα δικό σας port!
. Ανακτήστε το πακέτο από ένα κοντινό σας FTP site. Η "κύρια" συλλογή πακέτων βρίσκεται στο `ftp.FreeBSD.org`, στον link:ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/[κατάλογο πακέτων]. Πριν τη χρησιμοποιήσετε, ελέγξτε _πρώτα_ το crossref:mirrors[mirrors-ftp,τοπικό σας mirror]. Τα πακέτα είναι πιο σίγουρο ότι θα λειτουργήσουν, από το να προσπαθείτε να μεταγλωττίσετε τον πηγαίο κώδικα, και η διαδικασία τελειώνει πιο γρήγορα. Χρησιμοποιήστε το πρόγραμμα man:pkg_add[1] για να εγκαταστήσετε το πακέτο στο σύστημα σας.
diff --git a/documentation/content/el/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/el/books/handbook/ppp-and-slip/_index.adoc
index 2f19d09cfa..088d599b7a 100644
--- a/documentation/content/el/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/el/books/handbook/ppp-and-slip/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mail
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/network-servers/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ppp-and-slip-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/preface/_index.adoc b/documentation/content/el/books/handbook/preface/_index.adoc
index 89ab1a3789..1b71319270 100644
--- a/documentation/content/el/books/handbook/preface/_index.adoc
+++ b/documentation/content/el/books/handbook/preface/_index.adoc
@@ -11,17 +11,33 @@ next: books/handbook/parti
:toc: macro
:toclevels: 1
:icons: font
-:sectnums!:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-audience]]
== Σε Ποιους Απευθύνεται Αυτό το Βιβλίο
diff --git a/documentation/content/el/books/handbook/printing/_index.adoc b/documentation/content/el/books/handbook/printing/_index.adoc
index 0e021d47bd..0a4b5effe0 100644
--- a/documentation/content/el/books/handbook/printing/_index.adoc
+++ b/documentation/content/el/books/handbook/printing/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/linuxemu
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/priting/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[printing-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/security/_index.adoc b/documentation/content/el/books/handbook/security/_index.adoc
index c860c84648..096a7259d3 100644
--- a/documentation/content/el/books/handbook/security/_index.adoc
+++ b/documentation/content/el/books/handbook/security/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/jails
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/serialcomms/_index.adoc b/documentation/content/el/books/handbook/serialcomms/_index.adoc
index 43f7f27248..c85be30918 100644
--- a/documentation/content/el/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/el/books/handbook/serialcomms/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ppp-and-slip
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[serial-synopsis]]
== Σύνοψη
@@ -1170,7 +1168,7 @@ raisechar=^^
Εξαναγκάζει τη συγκεκριμένη θύρα να γίνει η κονσόλα (εκτός αν υπάρχει άλλη κονσόλα υψηλότερης προτεραιότητας) άσχετα με την επιλογή `-h` που περιγράφεται παρακάτω. Θα πρέπει να χρησιμοποιήσετε το flag `0x20` μαζί με το flag `0x10`.
`0x40`:::
-Παρακρατεί τη συγκεκριμένη θύρα (σε συνδυασμό με την `0x10`) κάνοντας την μη διαθέσιμη για κανονική πρόσβαση. Δεν θα πρέπει να θέσετε αυτή την επιλογή στη σειριακή θύρα που σκοπεύετε να χρησιμοποιήσετε ως σειριακή κονσόλα. Η μόνη χρήση αυτού του flag, είναι να καθορίσετε ότι η θύρα θα χρησιμοποιηθεί για απομακρυσμένη εκσφαλμάτωση του πυρήνα (kernel debugging). Δείτε link:{developers-handbook}[Το Βιβλίο του Προγραμματιστή] για περισσότερες λεπτομέρειες σχετικά με την απομακρυσμένη εκσφαλμάτωση.
+Παρακρατεί τη συγκεκριμένη θύρα (σε συνδυασμό με την `0x10`) κάνοντας την μη διαθέσιμη για κανονική πρόσβαση. Δεν θα πρέπει να θέσετε αυτή την επιλογή στη σειριακή θύρα που σκοπεύετε να χρησιμοποιήσετε ως σειριακή κονσόλα. Η μόνη χρήση αυτού του flag, είναι να καθορίσετε ότι η θύρα θα χρησιμοποιηθεί για απομακρυσμένη εκσφαλμάτωση του πυρήνα (kernel debugging). Δείτε extref:{developers-handbook}[Το Βιβλίο του Προγραμματιστή] για περισσότερες λεπτομέρειες σχετικά με την απομακρυσμένη εκσφαλμάτωση.
+
Παράδειγμα:
+
diff --git a/documentation/content/el/books/handbook/users/_index.adoc b/documentation/content/el/books/handbook/users/_index.adoc
index 824db6ed22..0a1b84c947 100644
--- a/documentation/content/el/books/handbook/users/_index.adoc
+++ b/documentation/content/el/books/handbook/users/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/security
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/users/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/users/
-endif::[]
+:images-path: books/handbook/users/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/users/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[users-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/virtualization/_index.adoc b/documentation/content/el/books/handbook/virtualization/_index.adoc
index e336881d31..07d89c0015 100644
--- a/documentation/content/el/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/el/books/handbook/virtualization/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/l10n
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/virtualization/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
-endif::[]
+:images-path: books/handbook/virtualization/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[virtualization-synopsis]]
== Σύνοψη
diff --git a/documentation/content/el/books/handbook/x11/_index.adoc b/documentation/content/el/books/handbook/x11/_index.adoc
index 1bba89eff6..ab1eb64902 100644
--- a/documentation/content/el/books/handbook/x11/_index.adoc
+++ b/documentation/content/el/books/handbook/x11/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Πίνακας Περιεχομένων
-:table-caption: Πίνακας
-:figure-caption: Σχήμα
-:example-caption: Παράδειγμα
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/el/mailing-lists.adoc[]
-include::shared/el/teams.adoc[]
-include::shared/el/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[x11-synopsis]]
== Σύνοψη
diff --git a/documentation/content/en/articles/bsdl-gpl/_index.adoc b/documentation/content/en/articles/bsdl-gpl/_index.adoc
index 40d4061196..1dd7817228 100644
--- a/documentation/content/en/articles/bsdl-gpl/_index.adoc
+++ b/documentation/content/en/articles/bsdl-gpl/_index.adoc
@@ -17,6 +17,27 @@ tags: ["bsdl", "gpl", "FreeBSD License"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/bsdl-gpl/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
'''
diff --git a/documentation/content/en/articles/building-products/_index.adoc b/documentation/content/en/articles/building-products/_index.adoc
index 29fca86847..e3bcb2f895 100644
--- a/documentation/content/en/articles/building-products/_index.adoc
+++ b/documentation/content/en/articles/building-products/_index.adoc
@@ -19,27 +19,26 @@ tags: ["FreeBSD", "FreeBSD as base for your product"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/building-products/
-
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/urls.adoc[]
-:imagesdir: ../../../images/articles/building-products/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/building-products/
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/building-products/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -180,7 +179,7 @@ Conflict resolution is performed by a nine member "Core Team" that is elected fr
FreeBSD does not have "corporate" committers.
Individual committers are required to take responsibility for the changes they introduce to the code.
-The link:{committers-guide}[FreeBSD Committer's guide] <<ComGuide>> documents the rules and responsibilities for committers.
+The extref:{committers-guide}[FreeBSD Committer's guide] <<ComGuide>> documents the rules and responsibilities for committers.
FreeBSD's project model is examined in detail in <<Nik2005>>.
@@ -200,7 +199,7 @@ image::freebsd-branches.png[]
Code lines are kept alive for as long as there is user and developer interest in them.
Machine architectures are grouped into "tiers"; _Tier 1_ architectures are fully supported by the project's release engineering and security teams, _Tier 2_ architectures are supported on a best effort basis, and experimental architectures comprise _Tier 3_.
-The list of link:{committers-guide}#archs[supported architectures] is part of the FreeBSD documentation collection.
+The list of extref:{committers-guide}[supported architectures, archs] is part of the FreeBSD documentation collection.
The release engineering team publishes a link:https://www.FreeBSD.org/releng/[road map] for future releases of FreeBSD on the project's web site.
The dates laid down in the road map are not deadlines; FreeBSD is released when its code and documentation are ready.
@@ -280,7 +279,7 @@ Plan for the long term::
Setup processes that help in tracking the development of FreeBSD.
For example:
+
-*Track FreeBSD source code.* The project makes it easy to mirror its SVN repository using link:{committers-guide}#svn-advanced-use-setting-up-svnsync[svnsync]. Having the complete history of the source is useful when debugging complex problems and offers valuable insight into the intentions of the original developers. Use a capable source control system that allows you to easily merge changes between the upstream FreeBSD code base and your own in-house code.
+*Track FreeBSD source code.* The project makes it easy to mirror its SVN repository using extref:{committers-guide}[svnsync, svn-advanced-use-setting-up-svnsync]. Having the complete history of the source is useful when debugging complex problems and offers valuable insight into the intentions of the original developers. Use a capable source control system that allows you to easily merge changes between the upstream FreeBSD code base and your own in-house code.
+
<<fig-svn-blame, An annotated source listing generated using `svn blame`>> shows a portion of an annotated listing of the file referenced by the change log in <<fig-change-log, A sample change log entry>>.
The ancestry of each line of the source is clearly visible.
@@ -340,7 +339,7 @@ In some countries, donations to the FreeBSD project enjoy tax benefits.
The project has a dedicated link:https://www.FreeBSD.org/donations/[donations liaison] to assist donors.
The project also maintains a web page where developers link:https://www.FreeBSD.org/donations/wantlist/[list their needs].
+
-As a policy the FreeBSD project link:{contributors}[acknowledges] all contributions received on its web site.
+As a policy the FreeBSD project extref:{contributors}[acknowledges] all contributions received on its web site.
[[conclusion]]
== Conclusion
@@ -359,19 +358,19 @@ The article concluded with a list of best-practices that could help organization
[[Carp1996]] [Carp1996] http://www.ietf.org/rfc/rfc1958.txt[The Architectural Principles of the Internet] B. Carpenter. The Internet Architecture Board.The Internet Architecture Board. Copyright(R) 1996.
-[[ComGuide]] [ComGuide] link:{committers-guide}[Committer's Guide] The FreeBSD Project. Copyright(R) 2005.
+[[ComGuide]] [ComGuide] extref:{committers-guide}[Committer's Guide] The FreeBSD Project. Copyright(R) 2005.
[[GoldGab2005]] [GoldGab2005] http://dreamsongs.com/IHE/IHE.html[Innovation Happens Elsewhere: Open Source as Business Strategy] Ron Goldman. Richard Gabriel. Copyright(R) 2005. Morgan-Kaufmann.
-[[Hub1994]] [Hub1994] link:{contributing}[Contributing to the FreeBSD Project] Jordan Hubbard. Copyright(R) 1994-2005. The FreeBSD Project.
+[[Hub1994]] [Hub1994] extref:{contributing}[Contributing to the FreeBSD Project] Jordan Hubbard. Copyright(R) 1994-2005. The FreeBSD Project.
[[McKu1999]] [McKu1999] http://www.usenix.org/publications/library/proceedings/usenix99/mckusick.html[Soft Updates: A Technique for Eliminating Most Synchronous Writes in the Fast Filesystem] Kirk McKusick. Gregory Ganger. Copyright(R) 1999.
[[McKu1999-1]] [McKu1999-1] http://www.oreilly.com/catalog/opensources/book/kirkmck.html[Twenty Years of Berkeley Unix: From AT&T-Owned to Freely Redistributable] Marshall Kirk McKusick. http://www.oreilly.com/catalog/opensources/book/toc.html[Open Sources: Voices from the Open Source Revolution] O'Reilly Inc.. Copyright(R) 1993.
-[[Mon2005]] [Mon2005] link:{bsdl-gpl}[Why you should use a BSD style license for your Open Source Project] Bruce Montague. The FreeBSD Project. Copyright(R) 2005.
+[[Mon2005]] [Mon2005] extref{bsdl-gpl}[Why you should use a BSD style license for your Open Source Project] Bruce Montague. The FreeBSD Project. Copyright(R) 2005.
-[[Nik2005]] [Nik2005] link:{dev-model}[A project model for the FreeBSD Project] Niklas Saers. Copyright(R) 2005. The FreeBSD Project.
+[[Nik2005]] [Nik2005] extref:{dev-model}[A project model for the FreeBSD Project] Niklas Saers. Copyright(R) 2005. The FreeBSD Project.
[[Nor1993]] [Nor1993] http://www.norvig.com/luv-slides.ps[Tutorial on Good Lisp Programming Style] Peter Norvig. Kent Pitman. Copyright(R) 1993.
@@ -379,4 +378,4 @@ The article concluded with a list of best-practices that could help organization
[[Ray2004]] [Ray2004] http://www.catb.org/~esr/faqs/smart-questions.html[How to ask questions the smart way] Eric Steven Raymond. Copyright(R) 2004.
-[[RelEngDoc]] [RelEngDoc] link:{releng}[FreeBSD Release Engineering] Murray Stokely. Copyright(R) 2001. The FreeBSD Project.
+[[RelEngDoc]] [RelEngDoc] extref:{releng}[FreeBSD Release Engineering] Murray Stokely. Copyright(R) 2001. The FreeBSD Project.
diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc
index d29fbf8c36..50e34da46f 100644
--- a/documentation/content/en/articles/committers-guide/_index.adoc
+++ b/documentation/content/en/articles/committers-guide/_index.adoc
@@ -18,26 +18,26 @@ tags: ["FreeBSD Committer's Guide", "Guide", "Community"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/committers-guide/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/en/teams.adoc[lines=16..-1]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/teams.adoc[lines=16..-1]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/teams.adoc[lines=16..-1]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -289,10 +289,10 @@ This list shows the most common cases:
* Changes in [.filename]#documentation/content/en/books/porters-handbook/versions/_index.adoc#
+
-link:{porters-handbook}versions/[__FreeBSD_version Values (Porter's Handbook)], mainly used for src committers.
+extref:{porters-handbook}versions/[__FreeBSD_version Values (Porter's Handbook)], mainly used for src committers.
* Changes in [.filename]#documentation/content/en/articles/contributors/contrib-additional.adoc#
+
-link:{contributors}#contrib-additional[Additional FreeBSD Contributors'] maintenance.
+extref:{contributors}[Additional FreeBSD Contributors, contrib-additional] maintenance.
* All link:#commit-steps[Steps for New Committers], doc related
* Security advisories; Errata Notices; Releases;
+
@@ -301,7 +301,7 @@ Used by {security-officer} and {re}.
+
Used by {donations}.
-Before any commit, a build test is necessary; see the 'Overview' and 'The FreeBSD Documentation Build Process' sections of the link:{fdp-primer}[FreeBSD Documentation Project Primer for New Contributors] for more details.
+Before any commit, a build test is necessary; see the 'Overview' and 'The FreeBSD Documentation Build Process' sections of the extref:{fdp-primer}[FreeBSD Documentation Project Primer for New Contributors] for more details.
[[git-primer]]
== Git Primer
@@ -509,7 +509,7 @@ e.g.:
....
so that won't be covered in depth here.
-If you want to build a custom kernel, link:{handbook}#kernelconfig[the kernel config section] of the FreeBSD Handbook recommends creating a file MYKERNEL under sys/${ARCH}/conf with your changes against GENERIC.
+If you want to build a custom kernel, extref:{handbook}[the kernel config section, kernelconfig] of the FreeBSD Handbook recommends creating a file MYKERNEL under sys/${ARCH}/conf with your changes against GENERIC.
To have MYKERNEL disregarded by Git, it can be added to .git/info/exclude.
===== Updating
@@ -666,7 +666,7 @@ The branch names are different and the repositories are in different locations.
The cgit repository web interface for use with web browsers is at https://cgit.FreeBSD.org/ports/ .
The production Git repository is at https://git.FreeBSD.org/ports.git and at ssh://anongit@git.FreeBSD.org/ports.git (or anongit@git.FreeBSD.org:ports.git).
-There is also a mirror on GitHub, see link:{handbook}mirrors/#mirrors[External mirrors] for an overview.
+There is also a mirror on GitHub, see extref:{handbook}/mirrors[External mirrors, mirrors] for an overview.
The 'current' branch is 'main' .
The quarterly branches are named 'yyyyQn' for year 'yyyy' and quarter 'n'.
@@ -2481,7 +2481,7 @@ Those who have been given commit rights to the FreeBSD repositories must follow
[.filename]#doc/shared/authors.adoc# - Add an author entity. Later steps depend on this entity, and missing this step will cause the [.filename]#doc/# build to fail. This is a relatively easy task, but remains a good first test of version control skills.
. Update the List of Developers and Contributors
+
-[.filename]#doc/documentation/content/en/articles/contributors/contrib-committers.adoc# - Add an entry, which will then appear in the "Developers" section of the link:{contributors}#staff-committers[Contributors List]. Entries are sorted by last name.
+[.filename]#doc/documentation/content/en/articles/contributors/contrib-committers.adoc# - Add an entry, which will then appear in the "Developers" section of the extref:{contributors}[Contributors List, staff-committers]. Entries are sorted by last name.
+
[.filename]#doc/documentation/content/en/articles/contributors/contrib-additional.adoc# - _Remove_ the entry. Entries are sorted by first name.
. Add a News Item
@@ -3205,7 +3205,7 @@ Committers with non-``FreeBSD.org`` Bugzilla accounts can have the old account m
You can find out more about Bugzilla at:
-* link:{pr-guidelines}[FreeBSD Problem Report Handling Guidelines]
+* extref:{pr-guidelines}[FreeBSD Problem Report Handling Guidelines]
* link:https://www.FreeBSD.org/support/[https://www.FreeBSD.org/support]
[[phabricator]]
@@ -3237,7 +3237,7 @@ doceng is the group responsible for the documentation build infrastructure, appr
It is not a conflict resolution body.
The vast majority of documentation related discussion takes place on the {freebsd-doc}.
More details regarding the doceng team can be found in its https://www.FreeBSD.org/internal/doceng/[charter].
-Committers interested in contributing to the documentation should familiarize themselves with the link:{fdp-primer}[Documentation Project Primer].
+Committers interested in contributing to the documentation should familiarize themselves with the extref:{fdp-primer}[Documentation Project Primer].
`{re-members}`::
These are the members of the `{re}`.
@@ -3391,7 +3391,7 @@ When in doubt, ask for review!
. Respect existing maintainers if listed.
+
Many parts of FreeBSD are not "owned" in the sense that any specific individual will jump up and yell if you commit a change to "their" area, but it still pays to check first.
-One convention we use is to put a maintainer line in the [.filename]#Makefile# for any package or subtree which is being actively maintained by one or more people; see link:{developers-handbook}#policies[Source Tree Guidelines and Policies] for documentation on this.
+One convention we use is to put a maintainer line in the [.filename]#Makefile# for any package or subtree which is being actively maintained by one or more people; see extref:{developers-handbook}[Source Tree Guidelines and Policies, policies] for documentation on this.
Where sections of code have several maintainers, commits to affected areas by one maintainer need to be reviewed by at least one other maintainer.
In cases where the "maintainer-ship" of something is not clear, look at the repository logs for the files in question and see if someone has been working recently or predominantly in that area.
. Any disputed change must be backed out pending resolution of the dispute if requested by a maintainer. Security related changes may override a maintainer's wishes at the Security Officer's discretion.
@@ -3683,19 +3683,19 @@ When sending questions about this script to the {freebsd-ports}, please also CC
Check the port, preferably to make sure it compiles and packages correctly.
-The link:{porters-handbook}testing[Porters Handbook's Testing Chapter] contains more detailed instructions.
-See the link:{porters-handbook}testing#testing-portclippy[Portclippy / Portfmt] and the link:{porters-handbook}testing#testing-poudriere[Poudriere] sections.
+The extref:{porters-handbook}testing[Porters Handbook's Testing Chapter] contains more detailed instructions.
+See the extref:{porters-handbook}testing[Portclippy / Portfmt, testing-portclippy] and the extref:{porters-handbook}testing[Poudriere, testing-poudriere] sections.
You do not necessarily have to eliminate all warnings but make sure you have fixed the simple ones.
-If the port came from a submitter who has not contributed to the Project before, add that person's name to the link:{contributors}#contrib-additional[Additional Contributors] section of the FreeBSD Contributors List.
+If the port came from a submitter who has not contributed to the Project before, add that person's name to the extref:{contributors}[Additional Contributors, contrib-additional] section of the FreeBSD Contributors List.
Close the PR if the port came in as a PR.
To close a PR, change the state to `Issue Resolved` and the resolution as `Fixed`.
[NOTE]
====
-If for some reason using link:{porters-handbook}testing#testing-poudriere[Poudriere] to test the new port is not possible, the bare minimum of testing includes this sequence:
+If for some reason using extref:{porters-handbook}testing[Poudriere, testing-poudriere] to test the new port is not possible, the bare minimum of testing includes this sequence:
[source,shell]
....
@@ -3809,7 +3809,7 @@ The -x parameter ensures the hash '$HASH' of the main branch is included in the
[[ports-qa-new-category-how]]
==== What is the procedure for creating a new category?
-Please see link:{porters-handbook}#proposing-categories[Proposing a New Category] in the Porter's Handbook.
+Please see extref:{porters-handbook}[Proposing a New Category, proposing-categories] in the Porter's Handbook.
Once that procedure has been followed and the PR has been assigned to the {portmgr}, it is their decision whether or not to approve it.
If they do, it is their responsibility to:
@@ -3843,7 +3843,7 @@ To do this, use the [.filename]#chkorigin.sh# tool: `env PORTSDIR=/path/to/ports
. Once this is done, you can commit the updated [.filename]#ports/Makefile# to connect the new category to the build and also commit the [.filename]#Makefile# changes for the old category or categories.
. Add appropriate entries to [.filename]#ports/MOVED#.
. Update the documentation by modifying:
-** the link:{porters-handbook}#PORTING-CATEGORIES[list of categories] in the Porter's Handbook
+** the extref:{porters-handbook}[list of categories, PORTING-CATEGORIES] in the Porter's Handbook
+
. Only once all the above have been done, and no one is any longer reporting problems with the new ports, should the old ports be deleted from their previous locations in the repository.
====
@@ -3852,7 +3852,7 @@ To do this, use the [.filename]#chkorigin.sh# tool: `env PORTSDIR=/path/to/ports
This is much simpler than a physical category. Only a few modifications are needed:
-* the link:{porters-handbook}#PORTING-CATEGORIES[list of categories] in the Porter's Handbook
+* the extref:{porters-handbook}[list of categories, PORTING-CATEGORIES] in the Porter's Handbook
[[ports-qa-misc-questions]]
=== Miscellaneous Questions
diff --git a/documentation/content/en/articles/contributing/_index.adoc b/documentation/content/en/articles/contributing/_index.adoc
index 4472701eaf..adbd9bd8ba 100644
--- a/documentation/content/en/articles/contributing/_index.adoc
+++ b/documentation/content/en/articles/contributing/_index.adoc
@@ -19,20 +19,26 @@ tags: ["Contributing", "FreeBSD", "Non-Programmer Tasks", "Programmer Tasks"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-
-ifeval::["{backend}" == "html5"]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/urls.adoc[]
+:images-path: articles/contributing/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -76,7 +82,7 @@ The Project includes documentation writers, Web designers, and support people.
All that these people need to contribute is an investment of time and a willingness to learn.
. Read through the FAQ and Handbook periodically. If anything is poorly explained, ambiguous, out of date or incorrect, let us know. Even better, send us a fix (AsciiDoc is not difficult to learn, but there is no objection to plain text submissions).
-. Help translate FreeBSD documentation into your native language. If documentation already exists for your language, you can help translate additional documents or verify that the translations are up-to-date and correct. First take a look at the link:{fdp-primer}#translations[Translations FAQ] in the FreeBSD Documentation Project Primer. You are not committing yourself to translating every single FreeBSD document by doing this - as a volunteer, you can do as much or as little translation as you desire. Once someone begins translating, others almost always join the effort. If you only have the time or energy to translate one part of the documentation, please translate the installation instructions.
+. Help translate FreeBSD documentation into your native language. If documentation already exists for your language, you can help translate additional documents or verify that the translations are up-to-date and correct. First take a look at the extref:{fdp-primer}[Translations FAQ, translations] in the FreeBSD Documentation Project Primer. You are not committing yourself to translating every single FreeBSD document by doing this - as a volunteer, you can do as much or as little translation as you desire. Once someone begins translating, others almost always join the effort. If you only have the time or energy to translate one part of the documentation, please translate the installation instructions.
. Read the {freebsd-questions} occasionally (or even regularly). It can be very satisfying to share your expertise and help people solve their problems; sometimes you may even learn something new yourself! These forums can also be a source of ideas for things to improve upon.
[[ongoing-programmer-tasks]]
@@ -119,7 +125,7 @@ Whether you are looking for an ongoing role, or a fun challenge for a rainy day,
There are a number of easy ways you can contribute to keeping the ports tree up to date and in good working order:
-* Find some cool or useful software and link:{porters-handbook}[create a port] for it.
+* Find some cool or useful software and extref:{porters-handbook}[create a port] for it.
* There are a large number of ports that have no maintainer. Become a maintainer and <<adopt-port>>.
* If you have created or adopted a port, be aware of <<maintain-port>>.
* When you are looking for a quick challenge you could <<fix-broken>>.
@@ -139,7 +145,7 @@ Contributions to the system generally fall into one or more of the following 5 c
An idea or suggestion of _general_ technical interest should be mailed to the {freebsd-hackers}.
Likewise, people with an interest in such things (and a tolerance for a _high_ volume of mail!) may subscribe to the {freebsd-hackers}.
-See link:{handbook}#eresources-mail[The FreeBSD Handbook] for more information about this and other mailing lists.
+See extref:{handbook}[The FreeBSD Handbook, eresources-mail] for more information about this and other mailing lists.
If you find a bug or are submitting a specific change, please report it using the https://bugs.FreeBSD.org/submit/[bug submission form].
Try to fill-in each field of the bug report.
@@ -151,19 +157,19 @@ When patches are a lot larger than 20KB, consider compressing them (eg. with man
After filing a report, you should receive confirmation along with a tracking number.
Keep this tracking number so that you can update us with details about the problem.
-See also link:{problem-reports}[this article] on how to write good problem reports.
+See also extref:{problem-reports}[this article] on how to write good problem reports.
=== Changes to the Documentation
Changes to the documentation are overseen by the {freebsd-doc}.
-Please look at the link:{fdp-primer}[FreeBSD Documentation Project Primer] for complete instructions.
+Please look at the extref:{fdp-primer}[FreeBSD Documentation Project Primer] for complete instructions.
Send submissions and changes (even small ones are welcome!) using the same method as any other bug report.
=== Changes to Existing Source Code
An addition or change to the existing source code is a somewhat trickier affair and depends a lot on how far out of date you are with the current state of FreeBSD development.
There is a special on-going release of FreeBSD known as "FreeBSD-CURRENT" which is made available in a variety of ways for the convenience of developers working actively on the system.
-See link:{handbook}#current-stable[The FreeBSD Handbook] for more information about getting and using FreeBSD-CURRENT.
+See extref:{handbook}[The FreeBSD Handbook, current-stable] for more information about getting and using FreeBSD-CURRENT.
Working from older sources unfortunately means that your changes may sometimes be too obsolete or too divergent for easy re-integration into FreeBSD.
Chances of this can be minimized somewhat by subscribing to the {freebsd-announce} and the {freebsd-current} lists, where discussions on the current state of the system take place.
@@ -280,7 +286,7 @@ The FreeBSD Ports Monitoring System (portsmon) is currently not working due to l
==== How to adopt the port
First make sure you understand your <<maintain-port>>.
-Also read the link:{porters-handbook}[Porter's Handbook].
+Also read the extref:{porters-handbook}[Porter's Handbook].
_Please do not commit yourself to more than you feel you can comfortably handle._
You may request maintainership of any unmaintained port as soon as you wish.
@@ -331,7 +337,7 @@ As a maintainer, you will need to manage the following challenges:
This section outlines the process to follow to keep your ports up to date.
This is an overview.
-More information about upgrading a port is available in the link:{porters-handbook}[Porter's Handbook].
+More information about upgrading a port is available in the extref:{porters-handbook}[Porter's Handbook].
[.procedure]
====
@@ -361,13 +367,13 @@ Thoroughly review and test your changes:
. Submit changes
+
Send your update by submitting a PR with an explanation of the changes and a patch containing the differences between the original port and the updated one.
-Please refer to link:{problem-reports}[Writing FreeBSD Problem Reports] for information on how to write a really good PR.
+Please refer to extref:{problem-reports}[Writing FreeBSD Problem Reports] for information on how to write a really good PR.
+
[NOTE]
======
Please do not submit a man:shar[1] archive of the entire port; instead, use man:git-format-patch[1] or man:diff[1] `-ruN`.
In this way, committers can much more easily see exactly what changes are being made.
-The Porter's Handbook section on link:{porters-handbook}#port-upgrading[Upgrading] has more information.
+The Porter's Handbook section on extref:{porters-handbook}[Upgrading, port-upgrading] has more information.
======
. Wait
+
@@ -550,9 +556,9 @@ By this, we mean that there are unresolved problems or pending updates that have
[[resources]]
=== Resources for ports maintainers and contributors
-The link:{porters-handbook}[Porter's Handbook] is your hitchhiker's guide to the ports system. Keep it handy!
+The extref:{porters-handbook}[Porter's Handbook] is your hitchhiker's guide to the ports system. Keep it handy!
-link:{problem-reports}[Writing FreeBSD Problem Reports] describes how to best formulate and submit a PR.
+extref:{problem-reports}[Writing FreeBSD Problem Reports] describes how to best formulate and submit a PR.
In 2005 more than eleven thousand ports PRs were submitted! Following this article will greatly assist us in reducing the time needed to handle your PRs.
The https://bugs.freebsd.org/bugzilla/query.cgi[Problem Report database].
@@ -569,7 +575,7 @@ Documentation is located at the https://github.com/freebsd/poudriere[poudriere g
man:portlint[1] is an application which can be used to verify that your port conforms to many important stylistic and functional guidelines.
portlint is a simple heuristic application, so you should use it __only as a guide__.
-If portlint suggests changes which seem unreasonable, consult the link:{porters-handbook}[Porter's Handbook] or ask for advice.
+If portlint suggests changes which seem unreasonable, consult the extref:{porters-handbook}[Porter's Handbook] or ask for advice.
The {freebsd-ports} is for general ports-related discussion.
It is a good place to ask for help.
diff --git a/documentation/content/en/articles/contributors/_index.adoc b/documentation/content/en/articles/contributors/_index.adoc
index 5c6dc3578f..22227dd531 100644
--- a/documentation/content/en/articles/contributors/_index.adoc
+++ b/documentation/content/en/articles/contributors/_index.adoc
@@ -11,25 +11,31 @@ tags: ["Contributors", "FreeBSD", "individuals", "organizations"]
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:sectnumlevels: 6
+:images-path: articles/contributors/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/en/urls.adoc[]
-:include-path: content/en/articles/contributors/
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+:include-path: content/{{% lang %}}/articles/contributors/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
:include-path:
endif::[]
+endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
:include-path:
endif::[]
@@ -106,7 +112,7 @@ The following individuals and businesses have generously contributed hardware fo
* _Special contributors:_
-** http://www.osd.bsdi.com/[BSDi] (formerly Walnut Creek CDROM) has donated almost more than we can say (see the 'About the FreeBSD Project' section of the link:{handbook}[FreeBSD Handbook] for more details). In particular, we would like to thank them for the original hardware used for `freefall.FreeBSD.org`, our primary development machine, and for `thud.FreeBSD.org`, a testing and build box. We are also indebted to them for funding various contributors over the years and providing us with unrestricted use of their T1 connection to the Internet.
+** http://www.osd.bsdi.com/[BSDi] (formerly Walnut Creek CDROM) has donated almost more than we can say (see the 'About the FreeBSD Project' section of the extref:{handbook}[FreeBSD Handbook] for more details). In particular, we would like to thank them for the original hardware used for `freefall.FreeBSD.org`, our primary development machine, and for `thud.FreeBSD.org`, a testing and build box. We are also indebted to them for funding various contributors over the years and providing us with unrestricted use of their T1 connection to the Internet.
** The http://www.interface-business.de/[interface business GmbH, Dresden] has been patiently supporting {joerg} who has often preferred FreeBSD work over paid work, and used to fall back to their (quite expensive) EUnet Internet connection whenever his private connection became too slow or flaky to work with it...
** http://www.bsdi.com/[Berkeley Software Design, Inc.] has contributed their DOS emulator code to the remaining BSD world, which is used in the _doscmd_ command.
diff --git a/documentation/content/en/articles/cups/_index.adoc b/documentation/content/en/articles/cups/_index.adoc
index 9d0216ea91..58930951c9 100644
--- a/documentation/content/en/articles/cups/_index.adoc
+++ b/documentation/content/en/articles/cups/_index.adoc
@@ -14,9 +14,30 @@ tags: ["CUPS", "FreeBSD", "Guide", "configuration", "introduction"]
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:sectnumlevels: 6
+:images-path: articles/cups/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Abstract
diff --git a/documentation/content/en/articles/explaining-bsd/_index.adoc b/documentation/content/en/articles/explaining-bsd/_index.adoc
index a8f6359fb7..b188f0a2b0 100644
--- a/documentation/content/en/articles/explaining-bsd/_index.adoc
+++ b/documentation/content/en/articles/explaining-bsd/_index.adoc
@@ -14,9 +14,30 @@ tags: ["Explaining BSD", "BSD", "FreeBSD", "operating system"]
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:sectnumlevels: 6
+:images-path: articles/explaining-bsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Abstract
diff --git a/documentation/content/en/articles/filtering-bridges/_index.adoc b/documentation/content/en/articles/filtering-bridges/_index.adoc
index 4f54b24ace..1d9f76ba83 100644
--- a/documentation/content/en/articles/filtering-bridges/_index.adoc
+++ b/documentation/content/en/articles/filtering-bridges/_index.adoc
@@ -14,20 +14,29 @@ tags: ["network", "filtering", "bridges", "FreeBSD"]
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:sectnumlevels: 6
-
-ifeval::["{backend}" == "html5"]
-include::shared/en/urls.adoc[]
+:images-path: articles/filtering-bridges/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -87,7 +96,7 @@ options IPFIREWALL_VERBOSE
The first line is to compile the bridge support, the second one is the firewall and the third one is the logging functions of the firewall.
Now it is necessary to build and install the new kernel.
-You may find detailed instructions in the link:{handbook}#kernelconfig-building[Building and Installing a Custom Kernel] section of the FreeBSD Handbook.
+You may find detailed instructions in the extref:{handbook}[Building and Installing a Custom Kernel, kernelconfig-building] section of the FreeBSD Handbook.
[[filtering-bridges-modules]]
=== Modules Loading
diff --git a/documentation/content/en/articles/fonts/_index.adoc b/documentation/content/en/articles/fonts/_index.adoc
index 8ff9e387a9..da20965609 100644
--- a/documentation/content/en/articles/fonts/_index.adoc
+++ b/documentation/content/en/articles/fonts/_index.adoc
@@ -15,9 +15,30 @@ tags: ["Fonts", "syscons", "X11", "Ghostscript", "Groff", "guide", "tutorial", "
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:sectnumlevels: 6
+:images-path: articles/fonts/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Abstract
diff --git a/documentation/content/en/articles/freebsd-questions/_index.adoc b/documentation/content/en/articles/freebsd-questions/_index.adoc
index 2cee8e4da2..1689ff5219 100644
--- a/documentation/content/en/articles/freebsd-questions/_index.adoc
+++ b/documentation/content/en/articles/freebsd-questions/_index.adoc
@@ -17,20 +17,26 @@ tags: ["questions", "mailing", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-
-ifeval::["{backend}" == "html5"]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/urls.adoc[]
+:images-path: articles/freebsd-questions/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -95,7 +101,7 @@ The following criteria should help for 99% of all questions, however:
. If the question relates to a bug, and you are _sure_ that it is a bug (for example, you can pinpoint the place in the code where it happens, and you maybe have a fix), then send the message to `FreeBSD-hackers`.
. If the question relates to enhancements to FreeBSD, and you can make suggestions about how to implement them, then send the message to `FreeBSD-hackers`.
-There are also a number of other link:{handbook}eresources/#eresources-mail[specialized mailing lists], which caters to more specific interests.
+There are also a number of other extref:{handbook}[specialized mailing lists, eresources-mail], which caters to more specific interests.
The criteria above still apply, and it is in your interest to stick to them, since you are more likely to get good results that way.
== Before Submitting a Question
@@ -103,7 +109,7 @@ The criteria above still apply, and it is in your interest to stick to them, sin
You can (and should) do some things yourself before asking a question on one of the mailing lists:
* Try solving the problem on your own. If you post a question which shows that you have tried to solve the problem, your question will generally attract more positive attention from people reading it. Trying to solve the problem yourself will also enhance your understanding of FreeBSD, and will eventually let you use your knowledge to help others by answering questions posted to the mailing lists.
-* Read the manual pages, and the FreeBSD documentation (either installed in [.filename]#/usr/doc# or accessible via WWW at http://www.FreeBSD.org[http://www.FreeBSD.org]), especially the link:{handbook}[handbook] and the link:{faq}[FAQ].
+* Read the manual pages, and the FreeBSD documentation (either installed in [.filename]#/usr/doc# or accessible via WWW at http://www.FreeBSD.org[http://www.FreeBSD.org]), especially the extref:{handbook}[handbook] and the extref:{faq}[FAQ].
* Browse and/or search the archives for the mailing list, to see if your question or a similar one has been asked (and possibly answered) on the list. You can browse and/or search the mailing list archives at https://www.FreeBSD.org/mail[https://www.FreeBSD.org/mail] and https://www.FreeBSD.org/search/#mailinglists[https://www.FreeBSD.org/search/#mailinglists] respectively. This can be done at other WWW sites as well, for example at http://marc.theaimsgroup.com[http://marc.theaimsgroup.com].
* Use a search engine such as http://www.google.com[Google] or http://www.yahoo.com[Yahoo] to find answers to your question.
diff --git a/documentation/content/en/articles/freebsd-releng/_index.adoc b/documentation/content/en/articles/freebsd-releng/_index.adoc
index eab53ff992..86d34f3ba1 100644
--- a/documentation/content/en/articles/freebsd-releng/_index.adoc
+++ b/documentation/content/en/articles/freebsd-releng/_index.adoc
@@ -36,6 +36,28 @@ tags: ["releases", "engineering", "process", "FreeBSD"]
:branchReleasex: release/12.0.0/
:branchRevision: 12.0
+:images-path: articles/freebsd-releng/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+
[.abstract-title]
Abstract
diff --git a/documentation/content/en/articles/freebsd-src-lsp/_index.adoc b/documentation/content/en/articles/freebsd-src-lsp/_index.adoc
index ef2127f5f9..87286645a7 100644
--- a/documentation/content/en/articles/freebsd-src-lsp/_index.adoc
+++ b/documentation/content/en/articles/freebsd-src-lsp/_index.adoc
@@ -13,12 +13,33 @@ tags: ["FreeBSD", "Language Server", "LSP"]
= Use Language Servers for Development in the FreeBSD Src Tree
:doctype: article
:toc: macro
-:toclevels: 2
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/freebsd-src-lsp/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
toc::[]
diff --git a/documentation/content/en/articles/freebsd-update-server/_index.adoc b/documentation/content/en/articles/freebsd-update-server/_index.adoc
index dab8525828..caaf17a3d7 100644
--- a/documentation/content/en/articles/freebsd-update-server/_index.adoc
+++ b/documentation/content/en/articles/freebsd-update-server/_index.adoc
@@ -18,20 +18,26 @@ tags: ["FreeBSD", "Update", "Server", "internal"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/freebsd-update-server/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -72,7 +78,7 @@ At a minimum, updates require building on a FreeBSD release greater than or equa
====
* A user account with at least 4 GB of available space. This will allow the creation of updates for 7.1 and 7.2, but the exact space requirements may change from version to version.
* An man:ssh[1] account on a remote machine to upload distributed updates.
-* A web server, like link:{handbook}#network-apache[Apache], with over half of the space required for the build. For instance, test builds for 7.1 and 7.2 consume a total amount of 4 GB, and the webserver space needed to distribute these updates is 2.6 GB.
+* A web server, like extref:{handbook}[Apache, network-apache], with over half of the space required for the build. For instance, test builds for 7.1 and 7.2 consume a total amount of 4 GB, and the webserver space needed to distribute these updates is 2.6 GB.
* Basic knowledge of shell scripting with Bourne shell, man:sh[1].
[[Configuration]]
@@ -386,9 +392,9 @@ In the event update code needs to be re-uploaded, this may be done by changing t
The uploaded files will need to be in the document root of the webserver in order for updates to be distributed.
The exact configuration will vary depending on the web server used.
-For the Apache web server, please refer to the link:{handbook}#network-apache[Configuration of Apache servers] section in the Handbook.
+For the Apache web server, please refer to the extref:{handbook}[Configuration of Apache servers, network-apache] section in the Handbook.
-Update client's `KeyPrint` and `ServerName` in [.filename]#/etc/freebsd-update.conf#, and perform updates as instructed in the link:{handbook}#updating-upgrading-freebsdupdate[FreeBSD Update] section of the Handbook.
+Update client's `KeyPrint` and `ServerName` in [.filename]#/etc/freebsd-update.conf#, and perform updates as instructed in the extref:{handbook}[FreeBSD Update, updating-upgrading-freebsdupdate] section of the Handbook.
[IMPORTANT]
====
@@ -421,7 +427,7 @@ Create the patch directory of the respective release under [.filename]#/usr/loca
As an example, take the patch for man:named[8].
Read the advisory, and grab the necessary file from link:https://www.FreeBSD.org/security/advisories/[FreeBSD Security Advisories].
-More information on interpreting the advisory, can be found in the link:{handbook}#security-advisories[FreeBSD Handbook].
+More information on interpreting the advisory, can be found in the extref:{handbook}[FreeBSD Handbook, security-advisories].
In the https://security.freebsd.org/advisories/FreeBSD-SA-09:12.bind.asc[security brief], this advisory is called `SA-09:12.bind`.
After downloading the file, it is required to rename the file to an appropriate patch level.
@@ -586,7 +592,7 @@ For reference, the entire run of link:../../source/articles/freebsd-update-serve
[[tips]]
== Tips
-* If a custom release is built using the native `make release` link:{releng}#release-build[procedure], freebsd-update-server code will work from your release. As an example, a release without ports or documentation can be built by clearing functionality pertaining to documentation subroutines `findextradocs ()`, `addextradocs ()` and altering the download location in `fetchiso ()`, respectively, in [.filename]#scripts/build.subr#. As a last step, change the man:sha256[1] hash in [.filename]#build.conf# under your respective release and architecture and you are ready to build off your custom release.
+* If a custom release is built using the native `make release` extref:{releng}[procedure, release-build], freebsd-update-server code will work from your release. As an example, a release without ports or documentation can be built by clearing functionality pertaining to documentation subroutines `findextradocs ()`, `addextradocs ()` and altering the download location in `fetchiso ()`, respectively, in [.filename]#scripts/build.subr#. As a last step, change the man:sha256[1] hash in [.filename]#build.conf# under your respective release and architecture and you are ready to build off your custom release.
+
[.programlisting]
....
@@ -615,7 +621,7 @@ addextradocs () {
make ${COMPATFLAGS} release.1 release.2 2>&1
....
-* Create an appropriate link:{handbook}#network-dns[DNS] SRV record for the update server, and put others behind it with variable weights. Using this facility will provide update mirrors, however this tip is not necessary unless you wish to provide a redundant service.
+* Create an appropriate extref:{handbook}[DNS, network-dns] SRV record for the update server, and put others behind it with variable weights. Using this facility will provide update mirrors, however this tip is not necessary unless you wish to provide a redundant service.
+
[.programlisting]
....
diff --git a/documentation/content/en/articles/geom-class/_index.adoc b/documentation/content/en/articles/geom-class/_index.adoc
index 3d836c51f3..cf10202e74 100644
--- a/documentation/content/en/articles/geom-class/_index.adoc
+++ b/documentation/content/en/articles/geom-class/_index.adoc
@@ -17,17 +17,26 @@ tags: ["GEOM", "kernel", "modules", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-
-ifeval::["{backend}" == "html5"]
-include::shared/en/urls.adoc[]
+:images-path: articles/geom-class/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -49,8 +58,8 @@ toc::[]
Documentation on kernel programming is scarce - it is one of few areas where there is nearly nothing in the way of friendly tutorials, and the phrase "use the source!" really holds true.
However, there are some bits and pieces (some of them seriously outdated) floating around that should be studied before beginning to code:
-* The link:{developers-handbook}[FreeBSD Developer's Handbook] - part of the documentation project, it does not contain anything specific to kernel programming, but rather some general useful information.
-* The link:{arch-handbook}[FreeBSD Architecture Handbook] - also from the documentation project, contains descriptions of several low-level facilities and procedures. The most important chapter is 13, link:{arch-handbook}#driverbasics[Writing FreeBSD device drivers].
+* The extref:{developers-handbook}[FreeBSD Developer's Handbook] - part of the documentation project, it does not contain anything specific to kernel programming, but rather some general useful information.
+* The extref:{arch-handbook}[FreeBSD Architecture Handbook] - also from the documentation project, contains descriptions of several low-level facilities and procedures. The most important chapter is 13, extref:{arch-handbook}[Writing FreeBSD device drivers, driverbasics].
* The Blueprints section of http://www.freebsddiary.org[FreeBSD Diary] web site - contains several interesting articles on kernel facilities.
* The man pages in section 9 - for important documentation on kernel functions.
* The man:geom[4] man page and http://phk.freebsd.dk/pubs/[PHK's GEOM slides] - for general introduction of the GEOM subsystem.
diff --git a/documentation/content/en/articles/gjournal-desktop/_index.adoc b/documentation/content/en/articles/gjournal-desktop/_index.adoc
index c39fa2d3a1..71ce2b3084 100644
--- a/documentation/content/en/articles/gjournal-desktop/_index.adoc
+++ b/documentation/content/en/articles/gjournal-desktop/_index.adoc
@@ -17,35 +17,26 @@ tags: ["UFS", "Journaling" , "Desktop", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/gjournal-desktop/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
-endif::[]
-
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/articles/gjournal-desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
endif::[]
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -380,7 +371,7 @@ options UFS_GJOURNAL # Note: This is already in GENERIC
options GEOM_JOURNAL # You will have to add this one
....
-Rebuild and reinstall your kernel following the relevant link:{handbook}#kernelconfig[instructions in the FreeBSD Handbook.]
+Rebuild and reinstall your kernel following the relevant extref:{handbook}[instructions in the FreeBSD Handbook., kernelconfig]
Do not forget to remove the relevant "load" entry from [.filename]#/boot/loader.conf# if you have previously used it.
@@ -513,7 +504,7 @@ Finally, edit [.filename]#/boot/loader.conf#, remove the entry that loads the `g
Journaling is a fairly new feature of FreeBSD, and as such, it is not very well documented yet.
You may however find the following additional references useful:
-* A link:{handbook}#geom-gjournal[new section on journaling] is now part of the FreeBSD Handbook.
+* A extref:{handbook}[new section on journaling, geom-gjournal] is now part of the FreeBSD Handbook.
* https://lists.freebsd.org/pipermail/freebsd-current/2006-June/064043.html[This post] in {freebsd-current} by man:gjournal[8]'s developer, `{pjd}`.
* https://lists.freebsd.org/pipermail/freebsd-questions/2008-April/173501.html[This post] in {freebsd-questions} by `{ivoras}`.
* The manual pages of man:gjournal[8] and man:geom[8].
diff --git a/documentation/content/en/articles/hubs/_index.adoc b/documentation/content/en/articles/hubs/_index.adoc
index fa28584e38..1e2c9da25a 100644
--- a/documentation/content/en/articles/hubs/_index.adoc
+++ b/documentation/content/en/articles/hubs/_index.adoc
@@ -23,23 +23,26 @@ tags: ["Mirroring", "FreeBSD", "Hub"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/hubs/
-ifeval::["{backend}" == "html5"]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/urls.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
-include::../../../../shared/releases.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
-include::../../../../shared/releases.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -366,7 +369,7 @@ Tier-1 mirrors are required to:
* provide FTP and rsync access
Furthermore, admins should be subscribed to the {freebsd-hubs}.
-See link:{handbook}#eresources-mail[this link] for details, how to subscribe.
+See extref:{handbook}[this link, eresources-mail] for details, how to subscribe.
[IMPORTANT]
====
diff --git a/documentation/content/en/articles/ipsec-must/_index.adoc b/documentation/content/en/articles/ipsec-must/_index.adoc
index 7e2cbef7db..361f70406f 100644
--- a/documentation/content/en/articles/ipsec-must/_index.adoc
+++ b/documentation/content/en/articles/ipsec-must/_index.adoc
@@ -17,17 +17,26 @@ tags: ["IPsec", "verification", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-
-ifeval::["{backend}" == "html5"]
-include::shared/en/urls.adoc[]
+:images-path: articles/ipsec-must/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -134,7 +143,7 @@ IPsec encrypts everything between two hosts.
Most of the modern versions of FreeBSD have IPsec support in their base source.
So you will need to include the `IPSEC` option in your kernel config and, after kernel rebuild and reinstall, configure IPsec connections using man:setkey[8] command.
-A comprehensive guide on running IPsec on FreeBSD is provided in link:{handbook}#ipsec[FreeBSD Handbook].
+A comprehensive guide on running IPsec on FreeBSD is provided in extref:{handbook}[FreeBSD Handbook, ipsec].
[[kernel]]
== src/sys/i386/conf/KERNELNAME
diff --git a/documentation/content/en/articles/ldap-auth/_index.adoc b/documentation/content/en/articles/ldap-auth/_index.adoc
index 76b89f9bef..66a05a8e4f 100644
--- a/documentation/content/en/articles/ldap-auth/_index.adoc
+++ b/documentation/content/en/articles/ldap-auth/_index.adoc
@@ -18,6 +18,27 @@ tags: ["LDAP", "Authentication", "OpenLDAP", "configuration", "guide", "tutorial
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/ldap-auth/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Abstract
diff --git a/documentation/content/en/articles/leap-seconds/_index.adoc b/documentation/content/en/articles/leap-seconds/_index.adoc
index 1cf7606ad4..d28629b005 100644
--- a/documentation/content/en/articles/leap-seconds/_index.adoc
+++ b/documentation/content/en/articles/leap-seconds/_index.adoc
@@ -13,17 +13,26 @@ tags: ["Leap Seconds", "Support", "Verification", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-
-ifeval::["{backend}" == "html5"]
-include::shared/en/urls.adoc[]
+:images-path: articles/leap-seconds/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -47,7 +56,7 @@ Also see man:time2posix[3].
[[leapseconds-posix]]
== Default Leap Second Handling on FreeBSD
-The easiest way to handle leap seconds is with the POSIX time rules FreeBSD uses by default, combined with link:{handbook}#network-ntp[NTP].
+The easiest way to handle leap seconds is with the POSIX time rules FreeBSD uses by default, combined with extref:{handbook}[NTP, network-ntp].
When man:ntpd[8] is running and the time is synchronized with upstream NTP servers that handle leap seconds correctly, the leap second will cause the system time to automatically repeat the last second of the day.
No other adjustments are necessary.
diff --git a/documentation/content/en/articles/linux-emulation/_index.adoc b/documentation/content/en/articles/linux-emulation/_index.adoc
index e9d86ae201..b695d7bc81 100644
--- a/documentation/content/en/articles/linux-emulation/_index.adoc
+++ b/documentation/content/en/articles/linux-emulation/_index.adoc
@@ -17,17 +17,26 @@ tags: ["Emulation", "Linuxulator", "kernel", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/linux-emulation/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
diff --git a/documentation/content/en/articles/linux-users/_index.adoc b/documentation/content/en/articles/linux-users/_index.adoc
index aa2e76682a..37f9a4126d 100644
--- a/documentation/content/en/articles/linux-users/_index.adoc
+++ b/documentation/content/en/articles/linux-users/_index.adoc
@@ -17,17 +17,26 @@ tags: ["Quickstart", "guide", "Linux", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-
-ifeval::["{backend}" == "html5"]
-include::shared/en/urls.adoc[]
+:images-path: articles/linux-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -45,7 +54,7 @@ toc::[]
This document highlights some of the technical differences between FreeBSD and Linux(R) so that intermediate to advanced Linux(R) users can quickly familiarize themselves with the basics of FreeBSD.
This document assumes that FreeBSD is already installed.
-Refer to the link:{handbook}#bsdinstall[Installing FreeBSD] chapter of the FreeBSD Handbook for help with the installation process.
+Refer to the extref:{handbook}[Installing FreeBSD, bsdinstall] chapter of the FreeBSD Handbook for help with the installation process.
[[shells]]
== Default Shell
@@ -56,7 +65,7 @@ Instead, FreeBSD uses man:tcsh[1] as the default root shell, and the Bourne shel
man:sh[1] is very similar to Bash but with a much smaller feature-set.
Generally shell scripts written for man:sh[1] will run in Bash, but the reverse is not always true.
-However, Bash and other shells are available for installation using the FreeBSD link:{handbook}#ports[Packages and Ports Collection].
+However, Bash and other shells are available for installation using the FreeBSD extref:{handbook}[Packages and Ports Collection, ports].
After installing another shell, use man:chsh[1] to change a user's default shell.
It is recommended that the `root` user's default shell remain unchanged since shells which are not included in the base distribution are installed to [.filename]#/usr/local/bin#.
@@ -96,7 +105,7 @@ For example, the following command installs Apache 2.4:
# pkg install apache24
....
-For more information on packages refer to section 5.4 of the FreeBSD Handbook: link:{handbook}#pkgng-intro[Using pkgng for Binary Package Management].
+For more information on packages refer to section 5.4 of the FreeBSD Handbook: extref:{handbook}[Using pkgng for Binary Package Management, pkgng-intro].
[[ports]]
=== Ports
@@ -105,7 +114,7 @@ The FreeBSD Ports Collection is a framework of [.filename]#Makefiles# and patche
When installing a port, the system will fetch the source code, apply any required patches, compile the code, and install the application and any required dependencies.
The Ports Collection, sometimes referred to as the ports tree, can be installed to [.filename]#/usr/ports# using man:portsnap[8].
-Detailed instructions for installing the Ports Collection can be found in link:{handbook}#ports-using[section 5.5] of the FreeBSD Handbook.
+Detailed instructions for installing the Ports Collection can be found in extref:{handbook}[section 5.5, ports-using] of the FreeBSD Handbook.
To compile a port, change to the port's directory and start the build process. The following example installs Apache 2.4 from the Ports Collection:
@@ -124,7 +133,7 @@ This example specifies that the mod_ldap module should also be installed:
# make WITH_LDAP="YES" install clean
....
-Refer to link:{handbook}#ports-using[Using the Ports Collection] for more information.
+Refer to extref:{handbook}[Using the Ports Collection, ports-using] for more information.
[[startup]]
== System Startup
@@ -139,7 +148,7 @@ The scripts found in [.filename]#/etc/rc.d/# are for applications that are part
The scripts in [.filename]#/usr/local/etc/rc.d/# are for user-installed applications such as Apache and Squid.
Since FreeBSD is developed as a complete operating system, user-installed applications are not considered to be part of the "base" system.
-User-installed applications are generally installed using link:{handbook}#ports-using[Packages or Ports].
+User-installed applications are generally installed using extref:{handbook}[Packages or Ports, ports-using].
In order to keep them separate from the base system, user-installed applications are installed under [.filename]#/usr/local/#.
Therefore, user-installed binaries reside in [.filename]#/usr/local/bin/#, configuration files are in [.filename]#/usr/local/etc/#, and so on.
@@ -222,9 +231,9 @@ ifconfig_em0="DHCP"
FreeBSD does not use Linux(R) IPTABLES for its firewall.
Instead, FreeBSD offers a choice of three kernel level firewalls:
-* link:{handbook}#firewalls-pf[PF]
-* link:{handbook}#firewalls-ipf[IPFILTER]
-* link:{handbook}#firewalls-ipfw[IPFW]
+* extref:{handbook}[PF, firewalls-pf]
+* extref:{handbook}[IPFILTER, firewalls-ipf]
+* extref:{handbook}[IPFW, firewalls-ipfw]
PF is developed by the OpenBSD project and ported to FreeBSD.
PF was created as a replacement for IPFILTER and its syntax is similar to that of IPFILTER.
@@ -281,7 +290,7 @@ When using man:cron[8] to schedule updates, use `freebsd-update cron` in the man
====
-For more information on source and binary updates, refer to link:{handbook}#updating-upgrading[the chapter on updating] in the FreeBSD Handbook.
+For more information on source and binary updates, refer to extref:{handbook}[the chapter on updating, updating-upgrading] in the FreeBSD Handbook.
[[procfs]]
== procfs: Gone But Not Forgotten
@@ -365,4 +374,4 @@ Some common command equivalents are as follows:
== Conclusion
This document has provided an overview of FreeBSD.
-Refer to the link:{handbook}[FreeBSD Handbook] for more in-depth coverage of these topics as well as the many topics not covered by this document.
+Refer to the extref:{handbook}[FreeBSD Handbook] for more in-depth coverage of these topics as well as the many topics not covered by this document.
diff --git a/documentation/content/en/articles/mailing-list-faq/_index.adoc b/documentation/content/en/articles/mailing-list-faq/_index.adoc
index c62fd0d5a8..8ab7fcb797 100644
--- a/documentation/content/en/articles/mailing-list-faq/_index.adoc
+++ b/documentation/content/en/articles/mailing-list-faq/_index.adoc
@@ -16,23 +16,26 @@ tags: ["FAQ", "Mailing Lists", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/mailing-list-faq/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -111,7 +114,7 @@ Please make only appropriate postings, and follow common rules of etiquette.
You have already taken the most important step by reading this document.
However, if you are new to FreeBSD, you may first need to familiarize yourself with the software, and all the social history around it, by reading the numerous link:https://www.FreeBSD.org/docs/books/[books and articles] that are available.
-Items of particular interest include the link:{faq}[FreeBSD Frequently Asked Questions (FAQ)] document, the link:{handbook}[FreeBSD Handbook], and the articles link:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list], link:{explaining-bsd}[Explaining BSD], and link:{new-users}[FreeBSD First Steps].
+Items of particular interest include the extref:{faq}[FreeBSD Frequently Asked Questions (FAQ)] document, the extref:{handbook}[FreeBSD Handbook], and the articles extref:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list], extref:{explaining-bsd}[Explaining BSD], and extref:{new-users}[FreeBSD First Steps].
It is always considered bad form to ask a question that is already answered in the above documents.
This is not because the volunteers who work on this project are particularly mean people, but after a certain number of times answering the same questions over and over again, frustration begins to set in.
@@ -189,7 +192,7 @@ Nevertheless, the burden is on you, the poster, to do your homework to help avoi
== What Is A "Bikeshed"?
Literally, a `bikeshed` is a small outdoor shelter into which one may store one's two-wheeled form of transportation.
-However, in FreeBSD parlance, the term refers to topics that are simple enough that (nearly) anyone can offer an opinion about, and often (nearly) everyone does. The genesis of this term is explained in more detail link:{faq}#bikeshed-painting[in this document].
+However, in FreeBSD parlance, the term refers to topics that are simple enough that (nearly) anyone can offer an opinion about, and often (nearly) everyone does. The genesis of this term is explained in more detail extref:{faq}[in this document, bikeshed-painting].
You simply must have a working knowledge of this concept before posting to any FreeBSD mailing list.
More generally, a bikeshed is a topic that will tend to generate immediate meta-discussions and flames if you have not read up on their past history.
@@ -201,7 +204,7 @@ Thanks.
== Acknowledgments
`{grog}`::
-Original author of most of the material on mailing list etiquette, taken from the article on link:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list].
+Original author of most of the material on mailing list etiquette, taken from the article on extref:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list].
`{linimon}`::
Creation of the rough draft of this FAQ.
diff --git a/documentation/content/en/articles/nanobsd/_index.adoc b/documentation/content/en/articles/nanobsd/_index.adoc
index b90ac20046..2f6e420b17 100644
--- a/documentation/content/en/articles/nanobsd/_index.adoc
+++ b/documentation/content/en/articles/nanobsd/_index.adoc
@@ -17,20 +17,26 @@ tags: ["nanobsd", "guide", "embedded", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/nanobsd/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -243,7 +249,7 @@ Two options are passed to man:boot0cfg[8] to initialize the boot sector of the d
With `NANO_BOOTLOADER` a bootloader file can be chosen.
The most common possible options are between [.filename]#boot0sio# and [.filename]#boot0# depending on whether the appliance has a serial port or not.
It is best to avoid supplying a different bootloader, but it is possible.
-To do so, it is best to have checked the link:{handbook}boot/[FreeBSD Handbook] chapter on the boot process.
+To do so, it is best to have checked the extref:{handbook}boot[FreeBSD Handbook] chapter on the boot process.
With `NANO_BOOT0CFG`, the booting process can be tweaked, like selecting on which partition the NanoBSD image will actually boot.
It is best to check the man:boot0cfg[8] page before changing the default value of this variable.
@@ -266,7 +272,7 @@ There are many variable that need to be set just right for the script to produce
* The `NANO_MEDIASIZE` variable must be set to the size (in 512 bytes sectors) of the storage media that will be used. If you set it wrong, it is possible that the NanoBSD image will not boot at all, and a message at boot time will be warning about incorrect disk geometry.
* The [.filename]#/etc#, [.filename]#/var#, and [.filename]#/tmp# directories are allocated as man:md[4] (malloc) disks at boot time; so their sizes can be tailored to suit the appliance needs. The `NANO_RAM_ETCSIZE` variable sets the size of the [.filename]#/etc#; and the `NANO_RAM_TMPVARSIZE` variable sets the size of both the [.filename]#/var# and [.filename]#/tmp# directory, as [.filename]#/tmp# is symbolically linked to [.filename]#/var/tmp#. By default, both malloc disks sizes are set at 20MB each. They can always be changed, but usually the [.filename]#/etc# does not grow too much in size, so 20MB is a good starting point, whereas the [.filename]#/var# and especially [.filename]#/tmp# can grow much larger if not careful about it. For memory constrained systems, smaller filesystem sizes may be chosen.
-* As NanoBSD is mainly designed to build a system image for an appliance, it is assumed that the storage media used will be relatively small. For that reason, the filesystem that is laid out is configured to have a small block size (4Kb) and a small fragment size (512b). The configuration options of the filesystem can be modified through the `NANO_NEWFS` variable, but the syntax must respect the man:newfs[8] command format. Also, by default, the filesystem has Soft Updates enabled. The link:{handbook}[FreeBSD Handbook] can be checked about this.
+* As NanoBSD is mainly designed to build a system image for an appliance, it is assumed that the storage media used will be relatively small. For that reason, the filesystem that is laid out is configured to have a small block size (4Kb) and a small fragment size (512b). The configuration options of the filesystem can be modified through the `NANO_NEWFS` variable, but the syntax must respect the man:newfs[8] command format. Also, by default, the filesystem has Soft Updates enabled. The extref:{handbook}[FreeBSD Handbook] can be checked about this.
* The different partition sizes can be set through the use of `NANO_CODESIZE`, `NANO_CONFSIZE`, and `NANO_DATASIZE` as a multiple of 512 bytes sectors. `NANO_CODESIZE` defines the size of the first two image partitions: `code#1` and `code#2`. They have to be big enough to hold all the files that will be produced as a result of the `buildworld` and `buildkernel` processes. `NANO_CONFSIZE` defines the size of the configuration file partition, so it does not need to be very big; but do not make it so small that it will not hold all configuration files. Finally, `NANO_DATASIZE` defines the size of an optional partition, that can be used on the appliance. The last partition can be used, for example, to keep files created on the fly on disk.
==== Custom Functions
diff --git a/documentation/content/en/articles/new-users/_index.adoc b/documentation/content/en/articles/new-users/_index.adoc
index 88a2080772..a84fd50e15 100644
--- a/documentation/content/en/articles/new-users/_index.adoc
+++ b/documentation/content/en/articles/new-users/_index.adoc
@@ -17,6 +17,27 @@ tags: ["Introduction", "basics", "FreeBSD", "UNIX"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/new-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Abstract
diff --git a/documentation/content/en/articles/pam/_index.adoc b/documentation/content/en/articles/pam/_index.adoc
index 6cb5d09d0a..8aa56bb4b2 100644
--- a/documentation/content/en/articles/pam/_index.adoc
+++ b/documentation/content/en/articles/pam/_index.adoc
@@ -51,6 +51,30 @@ SUCH DAMAGE.
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/pam/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+:include-path: static/source/articles/pam/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:include-path: ../../../../static/source/articles/pam/
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:include-path: ../../../../static/source/articles/pam/
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Abstract
@@ -618,17 +642,7 @@ the one presented in <<pam-sample-conv>> is a good starting point, but should no
[.programlisting]
....
-ifeval::["{backend}" == "html5"]
-include::static/source/articles/pam/su.c[]
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../static/source/articles/pam/su.c[]
-endif::[]
-
-ifeval::["{backend}" == "epub3"]
-include::../../../../static/source/articles/pam/su.c[]
-endif::[]
+include::{include-path}su.c[]
....
:sectnums!:
@@ -642,17 +656,7 @@ It should build and run with most PAM implementations, but takes advantage of Op
[.programlisting]
....
-ifeval::["{backend}" == "html5"]
-include::static/source/articles/pam/pam_unix.c[]
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../static/source/articles/pam/pam_unix.c[]
-endif::[]
-
-ifeval::["{backend}" == "epub3"]
-include::../../../../static/source/articles/pam/pam_unix.c[]
-endif::[]
+include::{include-path}pam_unix.c[]
....
:sectnums!:
@@ -667,17 +671,7 @@ Even if you are not using OpenPAM, feel free to download the source code and ada
[.programlisting]
....
-ifeval::["{backend}" == "html5"]
-include::static/source/articles/pam/converse.c[]
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../static/source/articles/pam/converse.c[]
-endif::[]
-
-ifeval::["{backend}" == "epub3"]
-include::../../../../static/source/articles/pam/converse.c[]
-endif::[]
+include::{include-path}converse.c[]
....
:sectnums!:
diff --git a/documentation/content/en/articles/pgpkeys/_index.adoc b/documentation/content/en/articles/pgpkeys/_index.adoc
index ef391cc5cd..0fb55195b6 100644
--- a/documentation/content/en/articles/pgpkeys/_index.adoc
+++ b/documentation/content/en/articles/pgpkeys/_index.adoc
@@ -13,26 +13,32 @@ tags: ["OpenPGP", "Developers", "Officers", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/pgpkeys/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/en/teams.adoc[lines=16..-1]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
:include-path: static/pgpkeys/
endif::[]
-
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
// PGP keys are not included during the build
// See 29e47423be969b7fcc7125977c1b22ddd33fc671 revision
// (a wrong path is used as a workaround)
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/teams.adoc[lines=16..-1]
:include-path: ../../../static/pgpkeys/
endif::[]
+endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/teams.adoc[lines=16..-1]
-:include-path: ../../../../static/pgpkeys/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+:include-path: ../../../static/pgpkeys/
endif::[]
'''
diff --git a/documentation/content/en/articles/port-mentor-guidelines/_index.adoc b/documentation/content/en/articles/port-mentor-guidelines/_index.adoc
index 0d1c2b72b1..c9129d228e 100644
--- a/documentation/content/en/articles/port-mentor-guidelines/_index.adoc
+++ b/documentation/content/en/articles/port-mentor-guidelines/_index.adoc
@@ -16,17 +16,26 @@ tags: ["port", "mentor", "mentee", "guidelines", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-
-ifeval::["{backend}" == "html5"]
-include::shared/en/urls.adoc[]
+:images-path: articles/port-mentor-guidelines/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -71,7 +80,7 @@ We expect mentors to review and test-build all proposed patches, at least for an
We expect that mentors should take responsibility for the actions of their mentee.
A mentor should follow up with all commits the mentee makes, both approved and implicit.
-We expect mentors to make sure their mentees read the link:{porters-handbook}[Porter's Handbook], the link:{pr-guidelines}[PR handling guide], and the link:{committers-guide}[Committer's Guide].
+We expect mentors to make sure their mentees read the extref:{porters-handbook}[Porter's Handbook], the extref:{pr-guidelines}[PR handling guide], and the extref:{committers-guide}[Committer's Guide].
While it is not necessary to memorize all the details, every committer needs to have an overview of these things to be an effective part of the community (and avoid as many rookie mistakes as possible).
[[mentees]]
diff --git a/documentation/content/en/articles/pr-guidelines/_index.adoc b/documentation/content/en/articles/pr-guidelines/_index.adoc
index 787caf1a3e..0f5fbab15d 100644
--- a/documentation/content/en/articles/pr-guidelines/_index.adoc
+++ b/documentation/content/en/articles/pr-guidelines/_index.adoc
@@ -17,20 +17,26 @@ tags: ["PR", "guideline", "bugs", "maintenance", "BugZilla", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-
-ifeval::["{backend}" == "html5"]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/urls.adoc[]
+:images-path: articles/pr-guidelines/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -506,4 +512,4 @@ Setting the category to `junk` makes it obvious that there is no useful content
This is a list of resources relevant to the proper writing and processing of problem reports.
It is by no means complete.
-* link:{problem-reports}[How to Write FreeBSD Problem Reports]-guidelines for PR originators.
+* extref:{problem-reports}[How to Write FreeBSD Problem Reports]-guidelines for PR originators.
diff --git a/documentation/content/en/articles/problem-reports/_index.adoc b/documentation/content/en/articles/problem-reports/_index.adoc
index 42ada1e99a..2353ac2740 100644
--- a/documentation/content/en/articles/problem-reports/_index.adoc
+++ b/documentation/content/en/articles/problem-reports/_index.adoc
@@ -17,20 +17,26 @@ tags: ["formulate", "submit", "FreeBSD", "PR"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-
-ifeval::["{backend}" == "html5"]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/urls.adoc[]
+:images-path: articles/problem-reports/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -72,7 +78,7 @@ Consider these factors when submitting PRs about ports or other software that is
* Please do not submit problem reports that simply state that a newer version of an application is available. Ports maintainers are automatically notified by portscout when a new version of an application becomes available. Actual patches to update a port to the latest version are welcome.
* For unmaintained ports (`MAINTAINER` is `ports@FreeBSD.org`), a PR without an included patch is unlikely to get picked up by a committer. To become the maintainer of an unmaintained port, submit a PR with the request (patch preferred but not required).
-* In either case, following the process described in link:{porters-handbook}#port-upgrading[Porter's Handbook] will yield the best results. (You might also wish to read link:{contributing}#ports-contributing[Contributing to the FreeBSD Ports Collection].)
+* In either case, following the process described in extref:{porters-handbook}[Porter's Handbook, port-upgrading] will yield the best results. (You might also wish to read extref:{contributing}[Contributing to the FreeBSD Ports Collection, ports-contributing].)
A bug that cannot be reproduced can rarely be fixed.
If the bug only occurred once and you cannot reproduce it, and it does not seem to happen to anybody else, chances are none of the developers will be able to reproduce it or figure out what is wrong.
@@ -88,7 +94,7 @@ Next, to decide to whom you should file your problem report, you need to underst
Then, ascertain whether the problem is timely.
There are few things that will annoy a developer more than receiving a problem report about a bug she has already fixed.
-If the problem is in the base system, first read the FAQ section on link:{faq}#LATEST-VERSION[FreeBSD versions], if you are not already familiar with the topic.
+If the problem is in the base system, first read the FAQ section on extref:{faq}[FreeBSD versions, LATEST-VERSION], if you are not already familiar with the topic.
It is not possible for FreeBSD to fix problems in anything other than certain recent branches of the base system, so filing a bug report about an older version will probably only result in a developer advising you to upgrade to a supported version to see if the problem still recurs.
The Security Officer team maintains the link:https://www.FreeBSD.org/security/[list of supported versions].
@@ -103,8 +109,8 @@ Maybe the problem has already been reported; maybe it is being discussed on the
You should therefore check all the obvious places before submitting your problem report.
For FreeBSD, this means:
-* The FreeBSD link:{faq}[Frequently Asked Questions] (FAQ) list. The FAQ attempts to provide answers for a wide range of questions, such as those concerning link:{faq}#hardware[hardware compatibility], link:{faq}#applications[user applications], and link:{faq}#kernelconfig[kernel configuration].
-* The link:{handbook}#eresources-mail[mailing lists]-if you are not subscribed, use https://www.FreeBSD.org/search/#mailinglists[the searchable archives] on the FreeBSD web site. If the problem has not been discussed on the lists, you might try posting a message about it and waiting a few days to see if someone can spot something that has been overlooked.
+* The FreeBSD extref:{faq}[Frequently Asked Questions] (FAQ) list. The FAQ attempts to provide answers for a wide range of questions, such as those concerning extref:{faq}[hardware compatibility, hardware], extref:{faq}[user applications, applications], and extref:{faq}[kernel configuration, kernelconfig].
+* The extref:{handbook}[mailing lists, eresources-mail]-if you are not subscribed, use https://www.FreeBSD.org/search/#mailinglists[the searchable archives] on the FreeBSD web site. If the problem has not been discussed on the lists, you might try posting a message about it and waiting a few days to see if someone can spot something that has been overlooked.
* Optionally, the entire web-use your favorite search engine to locate any references to the problem. You may even get hits from archived mailing lists or newsgroups you did not know of or had not thought to search through.
* Next, the searchable https://bugs.freebsd.org/bugzilla/query.cgi[FreeBSD PR database] (Bugzilla). Unless the problem is recent or obscure, there is a fair chance it has already been reported.
* Most importantly, attempt to see if existing documentation in the source base addresses your problem.
@@ -260,9 +266,9 @@ When a problem report has not received attention after several weeks, it is wort
There are a few ways to do so, ideally in the following order, with a few days between attempting each communication channel:
-* Find the relevant FreeBSD mailing list for the problem report from the link:{handbook}#eresources-mail[list in the Handbook] and send a message to that list asking about assistance or comments on the problem report.
+* Find the relevant FreeBSD mailing list for the problem report from the extref:{handbook}[list in the Handbook, eresources-mail] and send a message to that list asking about assistance or comments on the problem report.
* Join the relevant IRC channels. A partial listing is here: https://wiki.freebsd.org/IrcChannels[]. Inform the people in that channel about the problem report and ask for assistance. Be patient and stay in the channel after posting, so that the people from different time zones around the world have a chance to catch up.
-* Find committers interested in the problem that was reported. If the problem was in a particular tool, binary, port, document, or source file, check the https://cgit.FreeBSD.org[Git Repository]. Locate the last few committers who made substantive changes to the file, and try to reach them via IRC or email. A list of committers and their emails can be found in the link:{contributors}[Contributors to FreeBSD] article.
+* Find committers interested in the problem that was reported. If the problem was in a particular tool, binary, port, document, or source file, check the https://cgit.FreeBSD.org[Git Repository]. Locate the last few committers who made substantive changes to the file, and try to reach them via IRC or email. A list of committers and their emails can be found in the extref:{contributors}[Contributors to FreeBSD] article.
Remember that these people are volunteers, just like maintainers and users, so they might not be immediately available to assist with the problem report.
Patience and consistency in the follow-ups is highly advised and appreciated.
@@ -281,4 +287,4 @@ This is a list of resources relevant to the proper writing and processing of pro
It is by no means complete.
* https://github.com/smileytechguy/reporting-bugs-effectively/blob/master/ENGLISH.md[How to Report Bugs Effectively]-an excellent essay by Simon G. Tatham on composing useful (non-FreeBSD-specific) problem reports.
-* link:{pr-guidelines}[Problem Report Handling Guidelines]-valuable insight into how problem reports are handled by the FreeBSD developers.
+* extref:{pr-guidelines}[Problem Report Handling Guidelines]-valuable insight into how problem reports are handled by the FreeBSD developers.
diff --git a/documentation/content/en/articles/rc-scripting/_index.adoc b/documentation/content/en/articles/rc-scripting/_index.adoc
index 4d12be53b5..750072951e 100644
--- a/documentation/content/en/articles/rc-scripting/_index.adoc
+++ b/documentation/content/en/articles/rc-scripting/_index.adoc
@@ -18,17 +18,26 @@ tags: ["rc.d", "scripting", "guide", "tutorial", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-
-ifeval::["{backend}" == "html5"]
-include::shared/en/urls.adoc[]
+:images-path: articles/rc-scripting/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -578,7 +587,7 @@ After a script has been written, it needs to be integrated into [.filename]#rc.d
The crucial step is to install the script in [.filename]#/etc/rc.d# (for the base system) or [.filename]#/usr/local/etc/rc.d# (for ports).
Both [.filename]#bsd.prog.mk# and [.filename]#bsd.port.mk# provide convenient hooks for that, and usually you do not have to worry about the proper ownership and mode.
System scripts should be installed from [.filename]#src/etc/rc.d# through the [.filename]#Makefile# found there.
-Port scripts can be installed using `USE_RC_SUBR` as described link:{porters-handbook}#rc-scripts[in the Porter's Handbook].
+Port scripts can be installed using `USE_RC_SUBR` as described extref:{porters-handbook}[in the Porter's Handbook, rc-scripts].
However, we should consider beforehand the place of our script in the system startup sequence.
The service handled by our script is likely to depend on other services.
diff --git a/documentation/content/en/articles/releng/_index.adoc b/documentation/content/en/articles/releng/_index.adoc
index 8ed11ec631..aea32e4591 100644
--- a/documentation/content/en/articles/releng/_index.adoc
+++ b/documentation/content/en/articles/releng/_index.adoc
@@ -18,34 +18,26 @@ tags: ["Release", "Engineering", "Historical", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:xrefstyle: full
+:images-path: articles/releng/
-
-ifeval::["{backend}" == "html5"]
-include::shared/releases.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/en/teams.adoc[lines=16..-1]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/urls.adoc[]
-:imagesdir: ../../../images/articles/releng/
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/teams.adoc[lines=16..-1]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/releng/
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::shared/releases.adoc[]
-include::shared/authors.adoc[]
-include::shared/en/teams.adoc[lines=16..-1]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/releng/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -55,7 +47,7 @@ Abstract
====
This document is outdated and does not accurately describe the current release procedures of the FreeBSD Release Engineering team.
It is retained for historical purposes.
-The current procedures used by the FreeBSD Release Engineering team are available in the link:{freebsd-releng}[FreeBSD Release Engineering] article.
+The current procedures used by the FreeBSD Release Engineering team are available in the extref:{freebsd-releng}[FreeBSD Release Engineering] article.
====
This paper describes the approach used by the FreeBSD release engineering team to make production quality releases of the FreeBSD Operating System.
@@ -74,7 +66,7 @@ The FreeBSD Project provides Subversion footnote:[Subversion, http://subversion.
This has been a huge help in attracting more talented developers to FreeBSD.
However, I think everyone would agree that chaos would soon manifest if write access to the main repository was opened up to everyone on the Internet.
Therefore only a "select" group of nearly 300 people are given write access to the Subversion repository.
-These link:{contributors}#staff-committers[FreeBSD committers]footnote:[link:{contributors}#staff-committers[FreeBSD committers]] are usually the people who do the bulk of FreeBSD development.
+These extref:{contributors}[FreeBSD committers, staff-committers]footnote:[extref:{contributors}[FreeBSD committers, staff-committers]] are usually the people who do the bulk of FreeBSD development.
An elected link:https://www.FreeBSD.org/administration/#t-core[Core Team]footnote:[link:https://www.FreeBSD.org/administration/#t-core[FreeBSD Core Team]] of developers provide some level of direction over the project.
The rapid pace of `FreeBSD` development makes the main development branch unsuitable for the everyday use by the general public.
@@ -94,7 +86,7 @@ The ABI stability has improved greatly from the compared to previous releases.
In most cases, binaries from the older _STABLE_ systems run unmodified on newer systems, including __HEAD__, assuming that the system management interfaces are not used.
In the interim period between releases, weekly snapshots are built automatically by the FreeBSD Project build machines and made available for download from `ftp://ftp.FreeBSD.org/pub/FreeBSD/snapshots/`.
-The widespread availability of binary release snapshots, and the tendency of our user community to keep up with -STABLE development with Subversion and "`make buildworld`" footnote:[link:{handbook}#makeworld[Rebuilding world]] helps to keep FreeBSD-STABLE in a very reliable condition even before the quality assurance activities ramp up pending a major release.
+The widespread availability of binary release snapshots, and the tendency of our user community to keep up with -STABLE development with Subversion and "`make buildworld`" footnote:[extref:{handbook}[Rebuilding world, makeworld]] helps to keep FreeBSD-STABLE in a very reliable condition even before the quality assurance activities ramp up pending a major release.
In addition to installation ISO snapshots, weekly virtual machine images are also provided for use with VirtualBox, qemu, or other popular emulation software.
The virtual machine images can be downloaded from `ftp://ftp.FreeBSD.org/pub/FreeBSD/snapshots/VM-IMAGES/`.
@@ -172,7 +164,7 @@ When several BETA images have been made available for widespread testing and all
In all examples below, `$FSVN` refers to the location of the FreeBSD Subversion repository, `svn+ssh://svn.FreeBSD.org/base/`.
====
-The layout of FreeBSD branches in Subversion is described in the link:{committers-guide}#subversion-primer-base-layout[Committer's Guide].
+The layout of FreeBSD branches in Subversion is described in the extref:{committers-guide}[Committer's Guide, subversion-primer-base-layout].
The first step in creating a branch is to identify the revision of the `stable/_X_` sources that you want to branch _from_.
[source,shell]
@@ -277,7 +269,7 @@ By creating tags, we ensure that future release builders will always be able to
== Release Building
FreeBSD "releases" can be built by anyone with a fast machine and access to a source repository.
-(That should be everyone, since we offer Subversion access! See the link:{handbook}#svn[Subversion section in the Handbook] for details.)
+(That should be everyone, since we offer Subversion access! See the extref:{handbook}[Subversion section in the Handbook, svn] for details.)
The _only_ special requirement is that the man:md[4] device must be available.
If the device is not loaded into your kernel, then the kernel module should be automatically loaded when man:mdconfig[8] is executed during the boot media creation phase.
All of the tools necessary to build a release are available from the Subversion repository in [.filename]#src/release#.
@@ -393,7 +385,7 @@ A symlink to [.filename]#../../../ports/arch/packages-X.Y-release#.
The ISO images. The "*" is [.filename]#disc1#, [.filename]#disc2#, etc.
Only if there is a [.filename]#disc1# and there is an alternative first installation CD (for example a stripped-down install with no windowing system) there may be a [.filename]#mini# as well.
-For more information about the distribution mirror architecture of the FreeBSD FTP sites, please see the link:{hubs}[Mirroring FreeBSD] article.
+For more information about the distribution mirror architecture of the FreeBSD FTP sites, please see the extref:{hubs}[Mirroring FreeBSD] article.
It may take many hours to two days after updating `ftp-master` before a majority of the Tier-1 FTP sites have the new software depending on whether or not a package set got loaded at the same time.
It is imperative that the release engineers coordinate with the {mirror-announce} before announcing the general availability of new software on the FTP sites.
@@ -420,7 +412,7 @@ We certainly encourage innovation in the form of advanced installation and admin
=== Scripting `bsdinstall`
The FreeBSD system installation and configuration tool, man:bsdinstall[8], can be scripted to provide automated installs for large sites.
-This functionality can be used in conjunction with Intel(R) PXE footnote:[link:{handbook}#network-diskless[Diskless Operation with PXE]] to bootstrap systems from the network.
+This functionality can be used in conjunction with Intel(R) PXE footnote:[extref:{handbook}[Diskless Operation with PXE, network-diskless]] to bootstrap systems from the network.
[[lessons-learned]]
== Lessons Learned from FreeBSD 4.4
diff --git a/documentation/content/en/articles/remote-install/_index.adoc b/documentation/content/en/articles/remote-install/_index.adoc
index 5d6a8b5e4a..f1bd16bb37 100644
--- a/documentation/content/en/articles/remote-install/_index.adoc
+++ b/documentation/content/en/articles/remote-install/_index.adoc
@@ -18,20 +18,26 @@ tags: ["Remote", "Installation", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/remote-install/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -227,7 +233,7 @@ Repeat the following command for each hard drive:
Next, create slices and label them with your preferred tool.
While it is considered easier to use `sysinstall`, a powerful and also probably less buggy method will be to use standard text-based UNIX(R) tools, such as man:fdisk[8] and man:bsdlabel[8], which will also be covered in this section.
-The former option is well documented in the link:{handbook}#install-steps[Installing FreeBSD] chapter of the FreeBSD Handbook.
+The former option is well documented in the extref:{handbook}[Installing FreeBSD, install-steps] chapter of the FreeBSD Handbook.
As it was mentioned in the introduction, this article will present how to set up a system with RAID-1 and ZFS capabilities.
Our set up will consist of a small man:gmirror[8] mirrored [.filename]#/# (root), [.filename]#/usr# and [.filename]#/var# dataset, and the rest of the disk space will be allocated for a man:zpool[8] mirrored ZFS file system.
Please note, that the ZFS file system will be configured after the FreeBSD operating system is successfully installed and booted.
diff --git a/documentation/content/en/articles/serial-uart/_index.adoc b/documentation/content/en/articles/serial-uart/_index.adoc
index 60ee8c73b4..3852251b85 100644
--- a/documentation/content/en/articles/serial-uart/_index.adoc
+++ b/documentation/content/en/articles/serial-uart/_index.adoc
@@ -17,21 +17,26 @@ tags: ["Serial", "hardware", "UART", "Tutorial", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/serial-uart/
-
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -873,7 +878,7 @@ One important note - the actual UART chips for the Boca 16 are in the connector
So if you have it unplugged, probes of those ports will fail.
I have never tested booting with the box unplugged and plugging it back in, and I suggest you do not either.
-If you do not already have a custom kernel configuration file set up, refer to link:{handbook}#kernelconfig[Kernel Configuration] chapter of the FreeBSD Handbook for general procedures.
+If you do not already have a custom kernel configuration file set up, refer to extref:{handbook}[Kernel Configuration, kernelconfig] chapter of the FreeBSD Handbook for general procedures.
The following are the specifics for the Boca 16 board and assume you are using the kernel name MYKERNEL and editing with vi.
[.procedure]
diff --git a/documentation/content/en/articles/solid-state/_index.adoc b/documentation/content/en/articles/solid-state/_index.adoc
index ca2ddad07e..2309a9193b 100644
--- a/documentation/content/en/articles/solid-state/_index.adoc
+++ b/documentation/content/en/articles/solid-state/_index.adoc
@@ -18,6 +18,27 @@ tags: ["Solid State", "embedded", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/solid-state/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Abstract
diff --git a/documentation/content/en/articles/vinum/_index.adoc b/documentation/content/en/articles/vinum/_index.adoc
index abb5ee8c90..f6b0baea11 100644
--- a/documentation/content/en/articles/vinum/_index.adoc
+++ b/documentation/content/en/articles/vinum/_index.adoc
@@ -25,20 +25,26 @@ For the FreeBSD Documentation Project
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-
-
-ifeval::["{backend}" == "html5"]
-include::shared/en/urls.adoc[]
-:imagesdir: ../../../images/articles/vinum/
+:images-path: articles/vinum/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/en/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/vinum/
endif::[]
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/articles/vinum/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -62,7 +68,7 @@ This chapter provides an overview of potential problems with traditional disk st
[NOTE]
====
-Starting with FreeBSD 5, [.filename]#vinum# has been rewritten in order to fit into the link:{handbook}#geom[GEOM architecture], while retaining the original ideas, terminology, and on-disk metadata.
+Starting with FreeBSD 5, [.filename]#vinum# has been rewritten in order to fit into the extref:{handbook}[GEOM architecture, geom], while retaining the original ideas, terminology, and on-disk metadata.
This rewrite is called _gvinum_ (for _GEOM vinum_).
While this chapter uses the term [.filename]#vinum#, any command invocations should be performed with `gvinum`.
The name of the kernel module has changed from the original [.filename]#vinum.ko# to [.filename]#geom_vinum.ko#, and all device nodes reside under [.filename]#/dev/gvinum# instead of [.filename]#/dev/vinum#.
@@ -694,7 +700,7 @@ If this file system is to be mounted read-write later on, it is necessary to rem
==== Only Primary Bootstrap Loads
If [.filename]#/boot/loader# fails to load, but the primary bootstrap still loads (visible by a single dash in the left column of the screen right after the boot process starts), an attempt can be made to interrupt the primary bootstrap by pressing kbd:[space].
-This will make the bootstrap stop in link:{handbook}#boot-boot1[stage two].
+This will make the bootstrap stop in extref:{handbook}[stage two, boot-boot1].
An attempt can be made here to boot off an alternate partition, like the partition containing the previous root file system that has been moved away from `a`.
[[vinum-root-panic]]
@@ -705,6 +711,6 @@ Unfortunately, [.filename]#vinum# accidentally leaves only 4 KB at the beginning
However, the stage one and two bootstraps plus the bsdlabel require 8 KB.
So if a [.filename]#vinum# partition was started at offset 0 within a slice or disk that was meant to be bootable, the [.filename]#vinum# setup will trash the bootstrap.
-Similarly, if the above situation has been recovered, by booting from a "Fixit" media, and the bootstrap has been re-installed using `bsdlabel -B` as described in link:{handbook}#boot-boot1[stage two], the bootstrap will trash the [.filename]#vinum# header, and [.filename]#vinum# will no longer find its disk(s).
+Similarly, if the above situation has been recovered, by booting from a "Fixit" media, and the bootstrap has been re-installed using `bsdlabel -B` as described in extref:{handbook}[stage two, boot-boot1], the bootstrap will trash the [.filename]#vinum# header, and [.filename]#vinum# will no longer find its disk(s).
Though no actual [.filename]#vinum# configuration data or data in [.filename]#vinum# volumes will be trashed, and it would be possible to recover all the data by entering exactly the same [.filename]#vinum# configuration data again, the situation is hard to fix.
It is necessary to move the entire [.filename]#vinum# partition by at least 4 KB, in order to have the [.filename]#vinum# header and the system bootstrap no longer collide.
diff --git a/documentation/content/en/articles/vm-design/_index.adoc b/documentation/content/en/articles/vm-design/_index.adoc
index 1cabb3bb28..cac81535c5 100644
--- a/documentation/content/en/articles/vm-design/_index.adoc
+++ b/documentation/content/en/articles/vm-design/_index.adoc
@@ -17,17 +17,26 @@ tags: ["Design", "virtual machine", "FreeBSD"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/articles/vm-design/
+:images-path: articles/vm-design/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/articles/vm-design/
endif::[]
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/articles/vm-design/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
diff --git a/documentation/content/en/books/arch-handbook/_index.adoc b/documentation/content/en/books/arch-handbook/_index.adoc
index 6739310869..ad7b1f4b9e 100644
--- a/documentation/content/en/books/arch-handbook/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/_index.adoc
@@ -9,6 +9,7 @@ tags: ["Arch Handbook", "FreeBSD"]
next: books/arch-handbook/parti
weight: 50
add_single_page_link: true
+isIndex: true
---
= FreeBSD Architecture Handbook
@@ -18,37 +19,31 @@ add_single_page_link: true
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
:source-highlighter: rouge
:experimental:
+:images-path: books/arch-handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
-:chapters-path: content/en/books/arch-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/arch-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -56,8 +51,8 @@ Abstract
Welcome to the FreeBSD Architecture Handbook. This manual is a _work in progress_ and is the work of many individuals. Many sections do not yet exist and some of those that do exist need to be updated. If you are interested in helping with this project, send email to the {freebsd-doc}.
-The latest version of this document is always available from the link:https://www.FreeBSD.org/[FreeBSD World Wide Web server]. It may also be downloaded in a variety of formats and compression options from the https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous link:{handbook}#mirrors-ftp/[mirror sites].
+The latest version of this document is always available from the link:https://www.FreeBSD.org/[FreeBSD World Wide Web server]. It may also be downloaded in a variety of formats and compression options from the https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous extref:{handbook}[mirror sites, mirrors-ftp].
'''
-include::content/en/books/arch-handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
diff --git a/documentation/content/en/books/arch-handbook/bibliography/_index.adoc b/documentation/content/en/books/arch-handbook/bibliography/_index.adoc
index 5adf3107f8..510ec6ec8e 100644
--- a/documentation/content/en/books/arch-handbook/bibliography/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/bibliography/_index.adoc
@@ -12,19 +12,36 @@ tags: ["bibliography", "Arch Handbook", "FreeBSD"]
:toc: macro
:toclevels: 1
:icons: font
-:sectnums!:
+:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[1] _Marshall Kirk McKusick, Keith Bostic, Michael J Karels, and John S Quarterman._ Copyright © 1996 Addison-Wesley Publishing Company, Inc.. 0-201-54979-4. Addison-Wesley Publishing Company, Inc.. The Design and Implementation of the 4.4 BSD Operating System. 1-2.
diff --git a/documentation/content/en/books/arch-handbook/book.adoc b/documentation/content/en/books/arch-handbook/book.adoc
index 4c1905bc8a..839bc5bcb4 100644
--- a/documentation/content/en/books/arch-handbook/book.adoc
+++ b/documentation/content/en/books/arch-handbook/book.adoc
@@ -14,48 +14,34 @@ add_split_page_link: true
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
-:chapter-signifier: Chapter
-:part-signifier: Part
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
:book: true
:pdf: false
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
-:chapters-path: content/en/books/arch-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/arch-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -63,37 +49,37 @@ Abstract
Welcome to the FreeBSD Architecture Handbook. This manual is a _work in progress_ and is the work of many individuals. Many sections do not yet exist and some of those that do exist need to be updated. If you are interested in helping with this project, send email to the {freebsd-doc}.
-The latest version of this document is always available from the link:https://www.FreeBSD.org/[FreeBSD World Wide Web server]. It may also be downloaded in a variety of formats and compression options from the https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous link:{handbook}#mirrors-ftp/[mirror sites].
+The latest version of this document is always available from the link:https://www.FreeBSD.org/[FreeBSD World Wide Web server]. It may also be downloaded in a variety of formats and compression options from the https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous extref:{handbook}[mirror sites, mirrors-ftp].
'''
toc::[]
// Section one
-include::{chapters-path}parti.adoc[lines=7..8]
+include::{chapters-path}parti.adoc[lines=15..16]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}locking/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}kobj/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}jail/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}sysinit/_index.adoc[leveloffset=+1], lines=9..23;34..-1]
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=14..28;39..-1]
-include::{chapters-path}vm/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}smp/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
+include::{chapters-path}locking/_index.adoc[leveloffset=+1]
+include::{chapters-path}kobj/_index.adoc[leveloffset=+1]
+include::{chapters-path}jail/_index.adoc[leveloffset=+1]
+include::{chapters-path}sysinit/_index.adoc[leveloffset=+1]]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
+include::{chapters-path}vm/_index.adoc[leveloffset=+1]
+include::{chapters-path}smp/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..8]
+include::{chapters-path}partii.adoc[lines=15..16]
-include::{chapters-path}driverbasics/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}isa/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}pci/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}scsi/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}usb/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}newbus/_index.adoc[leveloffset=+1, lines=14..28;39..-1]
-include::{chapters-path}sound/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}pccard/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
+include::{chapters-path}driverbasics/_index.adoc[leveloffset=+1]
+include::{chapters-path}isa/_index.adoc[leveloffset=+1]
+include::{chapters-path}pci/_index.adoc[leveloffset=+1]
+include::{chapters-path}scsi/_index.adoc[leveloffset=+1]
+include::{chapters-path}usb/_index.adoc[leveloffset=+1]
+include::{chapters-path}newbus/_index.adoc[leveloffset=+1]
+include::{chapters-path}sound/_index.adoc[leveloffset=+1]
+include::{chapters-path}pccard/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..8]
+include::{chapters-path}partiii.adoc[lines=15..16]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..21;30..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
diff --git a/documentation/content/en/books/arch-handbook/boot/_index.adoc b/documentation/content/en/books/arch-handbook/boot/_index.adoc
index 5ba026e967..a499da22a7 100644
--- a/documentation/content/en/books/arch-handbook/boot/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/boot/_index.adoc
@@ -14,22 +14,35 @@ tags: ["boot", "BIOS", "kernel", "MBR", "FreeBSD"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/arch-handbook/driverbasics/_index.adoc b/documentation/content/en/books/arch-handbook/driverbasics/_index.adoc
index 3c9045a52f..eebda401ce 100644
--- a/documentation/content/en/books/arch-handbook/driverbasics/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/driverbasics/_index.adoc
@@ -14,22 +14,35 @@ tags: ["writing", "device drivers", "KLD", "FreeBSD"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[driverbasics-intro]]
== Introduction
diff --git a/documentation/content/en/books/arch-handbook/isa/_index.adoc b/documentation/content/en/books/arch-handbook/isa/_index.adoc
index 4120532432..772fe86ad1 100644
--- a/documentation/content/en/books/arch-handbook/isa/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/isa/_index.adoc
@@ -14,22 +14,35 @@ tags: ["ISA", "device drivers", "FreeBSD"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[isa-driver-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/arch-handbook/jail/_index.adoc b/documentation/content/en/books/arch-handbook/jail/_index.adoc
index 2591a46629..5f18d54736 100644
--- a/documentation/content/en/books/arch-handbook/jail/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/jail/_index.adoc
@@ -14,26 +14,39 @@ tags: ["jail", "architecture", "networking", "kernel"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
On most UNIX(R) systems, `root` has omnipotent power. This promotes insecurity. If an attacker gained `root` on a system, he would have every function at his fingertips. In FreeBSD there are sysctls which dilute the power of `root`, in order to minimize the damage caused by an attacker. Specifically, one of these functions is called `secure levels`. Similarly, another function which is present from FreeBSD 4.0 and onward, is a utility called man:jail[8]. Jail chroots an environment and sets certain restrictions on processes which are forked within the jail. For example, a jailed process cannot affect processes outside the jail, utilize certain system calls, or inflict any damage on the host environment.
-Jail is becoming the new security model. People are running potentially vulnerable servers such as Apache, BIND, and sendmail within jails, so that if an attacker gains `root` within the jail, it is only an annoyance, and not a devastation. This article mainly focuses on the internals (source code) of jail. For information on how to set up a jail see the link:{handbook}#jails/[handbook entry on jails].
+Jail is becoming the new security model. People are running potentially vulnerable servers such as Apache, BIND, and sendmail within jails, so that if an attacker gains `root` within the jail, it is only an annoyance, and not a devastation. This article mainly focuses on the internals (source code) of jail. For information on how to set up a jail see the extref:{handbook}[handbook entry on jails, jails].
[[jail-arch]]
== Architecture
diff --git a/documentation/content/en/books/arch-handbook/kobj/_index.adoc b/documentation/content/en/books/arch-handbook/kobj/_index.adoc
index 77954ac18b..9b8ed55143 100644
--- a/documentation/content/en/books/arch-handbook/kobj/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/kobj/_index.adoc
@@ -14,22 +14,35 @@ tags: ["kernel objects", "kobj", "guide", "FreeBSD"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Kernel Objects, or _Kobj_ provides an object-oriented C programming system for the kernel.
As such the data being operated on carries the description of how to operate on it.
diff --git a/documentation/content/en/books/arch-handbook/locking/_index.adoc b/documentation/content/en/books/arch-handbook/locking/_index.adoc
index a632e8d4a6..4cccbe779f 100644
--- a/documentation/content/en/books/arch-handbook/locking/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/locking/_index.adoc
@@ -14,22 +14,35 @@ tags: ["locking", "notes", "SMP", "Mutexes"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
_This chapter is maintained by the FreeBSD SMP Next Generation Project._
diff --git a/documentation/content/en/books/arch-handbook/mac/_index.adoc b/documentation/content/en/books/arch-handbook/mac/_index.adoc
index 5e94cfea88..113bbfddb0 100644
--- a/documentation/content/en/books/arch-handbook/mac/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/mac/_index.adoc
@@ -19,22 +19,35 @@ tags: ["TrustedBSD", "MAC"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-copyright]]
== MAC Documentation Copyright
diff --git a/documentation/content/en/books/arch-handbook/newbus/_index.adoc b/documentation/content/en/books/arch-handbook/newbus/_index.adoc
index 862a46331e..5a92939cfd 100644
--- a/documentation/content/en/books/arch-handbook/newbus/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/newbus/_index.adoc
@@ -19,22 +19,35 @@ tags: ["Newbus", "overview", "API"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
_Special thanks to Matthew N. Dodd, Warner Losh, Bill Paul, Doug Rabson, Mike Smith, Peter Wemm and Scott Long_.
diff --git a/documentation/content/en/books/arch-handbook/parti.adoc b/documentation/content/en/books/arch-handbook/parti.adoc
index 1239a7c024..78b766efe3 100644
--- a/documentation/content/en/books/arch-handbook/parti.adoc
+++ b/documentation/content/en/books/arch-handbook/parti.adoc
@@ -1,10 +1,18 @@
---
title: Part I. Kernel
-prev: books/arch-handbook/
+prev: books/arch-handbook
next: books/arch-handbook/boot
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/arch-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[kernel]]
= Kernel
-include::content/en/books/arch-handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/en/books/arch-handbook/partii.adoc b/documentation/content/en/books/arch-handbook/partii.adoc
index 595673da2a..df71bc2b2c 100644
--- a/documentation/content/en/books/arch-handbook/partii.adoc
+++ b/documentation/content/en/books/arch-handbook/partii.adoc
@@ -4,7 +4,15 @@ prev: books/arch-handbook/smp
next: books/arch-handbook/driverbasics
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/arch-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[devicedrivers]]
= Device Drivers
-include::content/en/books/arch-handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/en/books/arch-handbook/partiii.adoc b/documentation/content/en/books/arch-handbook/partiii.adoc
index b11632ef34..8c647ca8ac 100644
--- a/documentation/content/en/books/arch-handbook/partiii.adoc
+++ b/documentation/content/en/books/arch-handbook/partiii.adoc
@@ -4,7 +4,15 @@ prev: books/arch-handbook/pccard
next: books/arch-handbook/bibliography
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/arch-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= Appendices
-include::content/en/books/arch-handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/en/books/arch-handbook/pccard/_index.adoc b/documentation/content/en/books/arch-handbook/pccard/_index.adoc
index 1501a317f5..2328260d3d 100644
--- a/documentation/content/en/books/arch-handbook/pccard/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/pccard/_index.adoc
@@ -14,22 +14,35 @@ tags: ["pc card", "overview"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
This chapter will talk about the FreeBSD mechanisms for writing a device driver for a PC Card or CardBus device. However, at present it just documents how to add a new device to an existing pccard driver.
diff --git a/documentation/content/en/books/arch-handbook/pci/_index.adoc b/documentation/content/en/books/arch-handbook/pci/_index.adoc
index b7385d0b2d..fdfb86129b 100644
--- a/documentation/content/en/books/arch-handbook/pci/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/pci/_index.adoc
@@ -14,22 +14,35 @@ tags: ["PCI", "Devices", "example", "guide"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
This chapter will talk about the FreeBSD mechanisms for writing a device driver for a device on a PCI bus.
diff --git a/documentation/content/en/books/arch-handbook/scsi/_index.adoc b/documentation/content/en/books/arch-handbook/scsi/_index.adoc
index 7c225d88fb..b2287a11ef 100644
--- a/documentation/content/en/books/arch-handbook/scsi/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/scsi/_index.adoc
@@ -14,22 +14,35 @@ tags: ["SCSI", "Controller", "Architecture"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[scsi-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/arch-handbook/smp/_index.adoc b/documentation/content/en/books/arch-handbook/smp/_index.adoc
index 5c5501449b..9cff4c076e 100644
--- a/documentation/content/en/books/arch-handbook/smp/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/smp/_index.adoc
@@ -14,22 +14,35 @@ tags: ["SMPng", "introduction", "locks"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[smp-intro]]
== Introduction
diff --git a/documentation/content/en/books/arch-handbook/sound/_index.adoc b/documentation/content/en/books/arch-handbook/sound/_index.adoc
index 1b5dc08fc6..507ddfc3f3 100644
--- a/documentation/content/en/books/arch-handbook/sound/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/sound/_index.adoc
@@ -14,22 +14,35 @@ tags: ["Sound", "OSS", "pcm", "mixer"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[oss-intro]]
== Introduction
diff --git a/documentation/content/en/books/arch-handbook/sysinit/_index.adoc b/documentation/content/en/books/arch-handbook/sysinit/_index.adoc
index fd2ddb830a..713aa29258 100644
--- a/documentation/content/en/books/arch-handbook/sysinit/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/sysinit/_index.adoc
@@ -14,22 +14,35 @@ tags: ["SYSINIT", "framework", "Terminology"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
SYSINIT is the framework for a generic call sort and dispatch mechanism. FreeBSD currently uses it for the dynamic initialization of the kernel. SYSINIT allows FreeBSD's kernel subsystems to be reordered, and added, removed, and replaced at kernel link time when the kernel or one of its modules is loaded without having to edit a statically ordered initialization routing and recompile the kernel. This system also allows kernel modules, currently called _KLD's_, to be separately compiled, linked, and initialized at boot time and loaded even later while the system is already running. This is accomplished using the "kernel linker" and "linker sets".
diff --git a/documentation/content/en/books/arch-handbook/usb/_index.adoc b/documentation/content/en/books/arch-handbook/usb/_index.adoc
index d5c7843db5..db1409f80d 100644
--- a/documentation/content/en/books/arch-handbook/usb/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/usb/_index.adoc
@@ -14,22 +14,35 @@ tags: ["USB", "Structure", "UHCI", "OHCI"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[usb-intro]]
== Introduction
diff --git a/documentation/content/en/books/arch-handbook/vm/_index.adoc b/documentation/content/en/books/arch-handbook/vm/_index.adoc
index 8f3005d3cc..adad29a391 100644
--- a/documentation/content/en/books/arch-handbook/vm/_index.adoc
+++ b/documentation/content/en/books/arch-handbook/vm/_index.adoc
@@ -14,22 +14,35 @@ tags: ["Virtual memory", "vm_page_t", "vm_object_t", "I/O", "KVM"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[vm-physmem]]
== Management of Physical Memory `vm_page_t`
diff --git a/documentation/content/en/books/design-44bsd/_index.adoc b/documentation/content/en/books/design-44bsd/_index.adoc
index 0fde927c10..6527b3cf6d 100644
--- a/documentation/content/en/books/design-44bsd/_index.adoc
+++ b/documentation/content/en/books/design-44bsd/_index.adoc
@@ -10,6 +10,7 @@ description: Donated by Addison-Wesley, provides a design overview of 4.4BSD, fr
trademarks: ["design-44bsd"]
weight: 60
tags: ["4.4BSD", "design", "operating system", "BSD", "UNIX"]
+isIndex: true
---
= The Design and Implementation of the 4.4BSD Operating System
@@ -17,47 +18,35 @@ tags: ["4.4BSD", "design", "operating system", "BSD", "UNIX"]
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
-:chapter-signifier: Chapter
-:part-signifier: Part
+:sectnumoffset: 2
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:sectnumoffset: 2
+:images-path: books/design-44bsd/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../images/{images-path}
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
-:imagesdir: ../../../images/books/design-44bsd/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/design-44bsd/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
-:imagesdir: ../../../../static/images/books/design-44bsd/
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
-:imagesdir: ../../../../static/images/books/design-44bsd/
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
diff --git a/documentation/content/en/books/dev-model/_index.adoc b/documentation/content/en/books/dev-model/_index.adoc
index 24a3dc86db..c98587cb3b 100644
--- a/documentation/content/en/books/dev-model/_index.adoc
+++ b/documentation/content/en/books/dev-model/_index.adoc
@@ -7,6 +7,7 @@ description: A formal study of the organization of the FreeBSD project
trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
weight: 45
tags: ["model", "project model", "FreeBSD"]
+isIndex: true
---
////
@@ -40,46 +41,34 @@ SUCH DAMAGE.
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
-:chapter-signifier: Chapter
-:part-signifier: Part
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
+:images-path: books/dev-model/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../images/{images-path}
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
-:imagesdir: ../../../../images/books/dev-model/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/dev-model/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
-:imagesdir: ../../../../static/images/books/dev-model/
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
-:imagesdir: ../../../../static/images/books/dev-model/
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -1235,7 +1224,7 @@ Only documentation errors are corrected in the security branches.
Like the ports sub-project, the Documentation project can appoint documentation committers without FreeBSD Core's approval. [<<freebsd-doceng-charter, FreeBSD, 2003B>>].
-The Documentation project has link:{fdp-primer}[a primer].
+The Documentation project has extref:{fdp-primer}[a primer].
This is used both to introduce new project members to the standard tools and syntaxes and to act as a reference when working on the project.
:sectnums!:
@@ -1260,28 +1249,28 @@ This is used both to introduce new project members to the standard tools and syn
[FreeBSD, 2000A] Copyright © 2002 The FreeBSD Project. Core Bylaws. https://www.freebsd.org/internal/bylaws/.
[[freebsd-developer-handbook]]
-[FreeBSD, 2002A] Copyright © 2002 The FreeBSD Documentation Project. FreeBSD Developer's Handbook. link:{developers-handbook}[Developers Handbook].
+[FreeBSD, 2002A] Copyright © 2002 The FreeBSD Documentation Project. FreeBSD Developer's Handbook. extref:{developers-handbook}[Developers Handbook].
[[bsd-election2002]]
[FreeBSD, 2002B] Copyright © 2002 The FreeBSD Project. Core team election 2002. http://election.uk.freebsd.org/candidates.html.
[[freebsd-handle-pr]]
-[FreeBSD, 2002C] Dag-Erling Smørgrav and Hiten Pandya. Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Problem Report Handling Guidelines. link:{pr-guidelines}[Problem Report Handling Guidelines].
+[FreeBSD, 2002C] Dag-Erling Smørgrav and Hiten Pandya. Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Problem Report Handling Guidelines. extref:{pr-guidelines}[Problem Report Handling Guidelines].
[[freebsd-send-pr]]
-[FreeBSD, 2002D] Dag-Erling Smørgrav. Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Writing FreeBSD Problem Reports. link:{problem-reports}[Writing FreeBSD Problem Reports].
+[FreeBSD, 2002D] Dag-Erling Smørgrav. Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Writing FreeBSD Problem Reports. extref:{problem-reports}[Writing FreeBSD Problem Reports].
[[freebsd-committer]]
-[FreeBSD, 2001] Copyright © 2001 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Committers Guide. link:{committers-guide}[Committer's Guide].
+[FreeBSD, 2001] Copyright © 2001 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Committers Guide. extref:{committers-guide}[Committer's Guide].
[[freebsd-releng]]
-[FreeBSD, 2002E] Murray Stokely. Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. FreeBSD Release Engineering. https://link:{releng}[FreeBSD Release Engineering].
+[FreeBSD, 2002E] Murray Stokely. Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. FreeBSD Release Engineering. extref:{releng}[FreeBSD Release Engineering].
[[ref-bsd-handbook]]
-[FreeBSD, 2003A] The FreeBSD Documentation Project. FreeBSD Handbook. link:{handbook}[FreeBSD Handbook].
+[FreeBSD, 2003A] The FreeBSD Documentation Project. FreeBSD Handbook. extref:{handbook}[FreeBSD Handbook].
[[freebsd-contributors]]
-[FreeBSD, 2002F] Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Contributors to FreeBSD. link:{contributors}[Contributors to FreeBSD].
+[FreeBSD, 2002F] Copyright © 2002 The FreeBSD Documentation Project. The FreeBSD Documentation Project. Contributors to FreeBSD. extref:{contributors}[Contributors to FreeBSD].
[[freebsd-election]]
[FreeBSD, 2002G] Copyright © 2002 The FreeBSD Project. The FreeBSD Project. Core team elections 2002. http://election.uk.freebsd.org.
diff --git a/documentation/content/en/books/developers-handbook/_index.adoc b/documentation/content/en/books/developers-handbook/_index.adoc
index 0e84ae38f4..4841656769 100644
--- a/documentation/content/en/books/developers-handbook/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/_index.adoc
@@ -9,6 +9,7 @@ next: books/developers-handbook/parti
weight: 25
tags: ["FreeBSD Developers' Handbook"]
add_single_page_link: true
+isIndex: true
---
= FreeBSD Developers' Handbook
@@ -18,34 +19,31 @@ add_single_page_link: true
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
:source-highlighter: rouge
:experimental:
+:images-path: books/developers-handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -57,8 +55,8 @@ Many sections do not yet exist and some of those that do exist need to be update
If you are interested in helping with this project, send email to the {freebsd-doc}.
The latest version of this document is always available from the link:https://www.FreeBSD.org[FreeBSD World Wide Web server].
-It may also be downloaded in a variety of formats and compression options from the link:https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous link:{handbook}#mirrors-ftp/[mirror sites].
+It may also be downloaded in a variety of formats and compression options from the link:https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous extref:{handbook}[mirror sites, mirrors-ftp].
'''
-include::content/en/books/developers-handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
diff --git a/documentation/content/en/books/developers-handbook/bibliography/_index.adoc b/documentation/content/en/books/developers-handbook/bibliography/_index.adoc
index f50a5938c5..9dd43644f7 100644
--- a/documentation/content/en/books/developers-handbook/bibliography/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/bibliography/_index.adoc
@@ -12,21 +12,37 @@ tags: ["FreeBSD Developers' Handbook", "bibliography"]
:toc: macro
:toclevels: 1
:icons: font
-:sectnums!:
+:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[COD,1]] [1] Dave A Patterson and John L Hennessy. Copyright(R) 1998 Morgan Kaufmann Publishers, Inc. 1-55860-428-6. Morgan Kaufmann Publishers, Inc. Computer Organization and Design. The Hardware / Software Interface. 1-2.
diff --git a/documentation/content/en/books/developers-handbook/book.adoc b/documentation/content/en/books/developers-handbook/book.adoc
index c742d0237e..31364dcad2 100644
--- a/documentation/content/en/books/developers-handbook/book.adoc
+++ b/documentation/content/en/books/developers-handbook/book.adoc
@@ -14,51 +14,34 @@ add_split_page_link: true
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
-:chapter-signifier: Chapter
-:part-signifier: Part
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
:book: true
:pdf: false
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
-:imagesdir: ../../../../images/books/developers-handbook/
-:chapters-path: content/en/books/developers-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
-:imagesdir: ../../../../static/images/books/developers-handbook/
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
-:imagesdir: ../../../../static/images/books/developers-handbook/
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -70,35 +53,35 @@ Many sections do not yet exist and some of those that do exist need to be update
If you are interested in helping with this project, send email to the {freebsd-doc}.
The latest version of this document is always available from the link:https://www.FreeBSD.org[FreeBSD World Wide Web server].
-It may also be downloaded in a variety of formats and compression options from the link:https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous link:{handbook}#mirrors-ftp/[mirror sites].
+It may also be downloaded in a variety of formats and compression options from the link:https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous extref:{handbook}[mirror sites, mirrors-ftp].
'''
toc::[]
// Section one
-include::{chapters-path}parti.adoc[lines=7..8]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=12..26;37..-1]
-include::{chapters-path}tools/_index.adoc[leveloffset=+1, lines=12..28;39..-1]
-include::{chapters-path}secure/_index.adoc[leveloffset=+1, lines=11..25;36..-1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=10..24;35..-1]
-include::{chapters-path}policies/_index.adoc[leveloffset=+1, lines=12..26;37..-1]
-include::{chapters-path}testing/_index.adoc[leveloffset=+1, lines=10..24;35..-1]
+include::{chapters-path}parti.adoc[lines=15..16]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
+include::{chapters-path}tools/_index.adoc[leveloffset=+1]
+include::{chapters-path}secure/_index.adoc[leveloffset=+1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
+include::{chapters-path}policies/_index.adoc[leveloffset=+1]
+include::{chapters-path}testing/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..8]
-include::{chapters-path}sockets/_index.adoc[leveloffset=+1, lines=11..25;37..-1]
-include::{chapters-path}ipv6/_index.adoc[leveloffset=+1, lines=11..25;36..-1]
+include::{chapters-path}partii.adoc[lines=15..16]
+include::{chapters-path}sockets/_index.adoc[leveloffset=+1]
+include::{chapters-path}ipv6/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..8]
-include::{chapters-path}kernelbuild/_index.adoc[leveloffset=+1, lines=10..24;35..-1]
-include::{chapters-path}kerneldebug/_index.adoc[leveloffset=+1, lines=13..27;38..-1]
+include::{chapters-path}partiii.adoc[lines=15..16]
+include::{chapters-path}kernelbuild/_index.adoc[leveloffset=+1]
+include::{chapters-path}kerneldebug/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=7..8]
-include::{chapters-path}x86/_index.adoc[leveloffset=+1, lines=10..24;35..-1]
+include::{chapters-path}partiv.adoc[lines=15..16]
+include::{chapters-path}x86/_index.adoc[leveloffset=+1]
// Appendices
-include::{chapters-path}partv.adoc[lines=7..8]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..22;31..-1]
+include::{chapters-path}partv.adoc[lines=15..16]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
diff --git a/documentation/content/en/books/developers-handbook/introduction/_index.adoc b/documentation/content/en/books/developers-handbook/introduction/_index.adoc
index 35e8e65fca..852ec91c87 100644
--- a/documentation/content/en/books/developers-handbook/introduction/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/introduction/_index.adoc
@@ -17,22 +17,35 @@ tags: ["introduction", "Developing on FreeBSD", "BSD Vision", "Architectural Gui
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-devel]]
== Developing on FreeBSD
diff --git a/documentation/content/en/books/developers-handbook/ipv6/_index.adoc b/documentation/content/en/books/developers-handbook/ipv6/_index.adoc
index 0abbcaa206..dcdaed15ef 100644
--- a/documentation/content/en/books/developers-handbook/ipv6/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/ipv6/_index.adoc
@@ -16,22 +16,35 @@ tags: ["IPv6", "FreeBSD"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ipv6-implementation]]
== IPv6/IPsec Implementation
diff --git a/documentation/content/en/books/developers-handbook/kernelbuild/_index.adoc b/documentation/content/en/books/developers-handbook/kernelbuild/_index.adoc
index bf127de265..1c93e8b96a 100644
--- a/documentation/content/en/books/developers-handbook/kernelbuild/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/kernelbuild/_index.adoc
@@ -15,32 +15,45 @@ tags: ["building", "installing", "kernel", "FreeBSD"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Being a kernel developer requires understanding of the kernel build process.
To debug the FreeBSD kernel it is required to be able to build one.
There are two known ways to do so:
-The supported procedure to build and install a kernel is documented in the link:{handbook}#kernelconfig-building[Building and Installing a Custom Kernel] chapter of the FreeBSD Handbook.
+The supported procedure to build and install a kernel is documented in the extref:{handbook}[Building and Installing a Custom Kernel, kernelconfig-building] chapter of the FreeBSD Handbook.
[NOTE]
====
-It is supposed that the reader of this chapter is familiar with the information described in the link:{handbook}#kernelconfig-building[Building and Installing a Custom Kernel] chapter of the FreeBSD Handbook.
+It is supposed that the reader of this chapter is familiar with the information described in the extref:{handbook}[Building and Installing a Custom Kernel, kernelconfig-building] chapter of the FreeBSD Handbook.
If this is not the case, please read through the above mentioned chapter to understand how the build process works.
====
diff --git a/documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc b/documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc
index 87c4da03bd..0309c98584 100644
--- a/documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc
@@ -18,22 +18,35 @@ tags: ["Debugging", "Dump", "kgdb", "DDB", "GDB"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kerneldebug-obtain]]
== Obtaining a Kernel Crash Dump
@@ -312,7 +325,7 @@ options DDB
....
to your config file, and rebuild.
-(See link:{handbook}/[The FreeBSD Handbook] for details on configuring the FreeBSD kernel).
+(See extref:{handbook}[The FreeBSD Handbook] for details on configuring the FreeBSD kernel).
Once your DDB kernel is running, there are several ways to enter DDB.
The first, and earliest way is to use the boot flag `-d`.
diff --git a/documentation/content/en/books/developers-handbook/l10n/_index.adoc b/documentation/content/en/books/developers-handbook/l10n/_index.adoc
index a8c81ee243..05793b38e3 100644
--- a/documentation/content/en/books/developers-handbook/l10n/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/l10n/_index.adoc
@@ -15,22 +15,35 @@ tags: ["L10N", "I18N", "Localization", "Internationalization", "FreeBSD"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-programming]]
== Programming I18N Compliant Applications
diff --git a/documentation/content/en/books/developers-handbook/parti.adoc b/documentation/content/en/books/developers-handbook/parti.adoc
index 547f228dd5..dc5b56abe5 100644
--- a/documentation/content/en/books/developers-handbook/parti.adoc
+++ b/documentation/content/en/books/developers-handbook/parti.adoc
@@ -1,10 +1,18 @@
---
title: Part I. Basics
-prev: books/developers-handbook/
+prev: books/developers-handbook
next: books/developers-handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[basics]]
= Basics
-include::content/en/books/developers-handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/en/books/developers-handbook/partii.adoc b/documentation/content/en/books/developers-handbook/partii.adoc
index 0216af6687..3ce9d9b69f 100644
--- a/documentation/content/en/books/developers-handbook/partii.adoc
+++ b/documentation/content/en/books/developers-handbook/partii.adoc
@@ -4,7 +4,15 @@ prev: books/developers-handbook/testing
next: books/developers-handbook/sockets
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[ipc]]
= Interprocess Communication
-include::content/en/books/developers-handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/en/books/developers-handbook/partiii.adoc b/documentation/content/en/books/developers-handbook/partiii.adoc
index 7357b79867..47d275450f 100644
--- a/documentation/content/en/books/developers-handbook/partiii.adoc
+++ b/documentation/content/en/books/developers-handbook/partiii.adoc
@@ -4,7 +4,15 @@ prev: books/developers-handbook/ipv6
next: books/developers-handbook/kernelbuild
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[kernel]]
= Kernel
-include::content/en/books/developers-handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/en/books/developers-handbook/partiv.adoc b/documentation/content/en/books/developers-handbook/partiv.adoc
index bed213b989..8c576c8229 100644
--- a/documentation/content/en/books/developers-handbook/partiv.adoc
+++ b/documentation/content/en/books/developers-handbook/partiv.adoc
@@ -4,8 +4,16 @@ prev: books/developers-handbook/kerneldebug
next: books/developers-handbook/x86
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[architectures]]
= Architectures
-include::content/en/books/developers-handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/en/books/developers-handbook/partv.adoc b/documentation/content/en/books/developers-handbook/partv.adoc
index 305926ca2e..aad1558580 100644
--- a/documentation/content/en/books/developers-handbook/partv.adoc
+++ b/documentation/content/en/books/developers-handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/developers-handbook/x86
next: books/developers-handbook/bibliography
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= Appendices
-include::content/en/books/developers-handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/en/books/developers-handbook/policies/_index.adoc b/documentation/content/en/books/developers-handbook/policies/_index.adoc
index ea92c91ea3..ca63920e94 100644
--- a/documentation/content/en/books/developers-handbook/policies/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/policies/_index.adoc
@@ -17,22 +17,35 @@ tags: ["Style Guidelines", "MAINTAINER", "Makefiles", "Contributed Software", "S
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
This chapter documents various guidelines and policies in force for the FreeBSD source tree.
diff --git a/documentation/content/en/books/developers-handbook/secure/_index.adoc b/documentation/content/en/books/developers-handbook/secure/_index.adoc
index fac35d948e..5cbc6b793a 100644
--- a/documentation/content/en/books/developers-handbook/secure/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/secure/_index.adoc
@@ -16,22 +16,35 @@ tags: ["secure programming", "Buffer Overflows", "SetUID issues"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[secure-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/developers-handbook/sockets/_index.adoc b/documentation/content/en/books/developers-handbook/sockets/_index.adoc
index 77e73f4ce9..57dc73cf7c 100644
--- a/documentation/content/en/books/developers-handbook/sockets/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/sockets/_index.adoc
@@ -16,23 +16,35 @@ tags: ["Sockets", "Protocols"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
-:imagesdir: ../../../../images/books/developers-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[sockets-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/developers-handbook/testing/_index.adoc b/documentation/content/en/books/developers-handbook/testing/_index.adoc
index b74ad38914..032e55ad50 100644
--- a/documentation/content/en/books/developers-handbook/testing/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/testing/_index.adoc
@@ -15,22 +15,35 @@ tags: ["Regression", "Performance Testing", "Testing", "Tinderbox"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Regression tests are used to exercise a particular bit of the system to check that it works as expected, and to make sure that old bugs are not reintroduced.
diff --git a/documentation/content/en/books/developers-handbook/tools/_index.adoc b/documentation/content/en/books/developers-handbook/tools/_index.adoc
index 472f8c2361..c714a399ca 100644
--- a/documentation/content/en/books/developers-handbook/tools/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/tools/_index.adoc
@@ -17,24 +17,37 @@ tags: ["tools", "Interpreters", "Compilers", "cc", "make", "Debugging", "lldb",
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
:c-plus-plus-command: c++
:clang-plus-plus-command: clang++
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[tools-synopsis]]
== Synopsis
@@ -88,7 +101,7 @@ Indeed, part of the original UNIX(R) philosophy was to provide lots of small uti
Here is a list of interpreters that are available from the FreeBSD Ports Collection, with a brief discussion of some of the more popular interpreted languages.
-Instructions on how to get and install applications from the Ports Collection can be found in the link:{handbook}#ports-using/[Ports section] of the handbook.
+Instructions on how to get and install applications from the Ports Collection can be found in the extref:{handbook}[Ports section, ports-using] of the handbook.
BASIC::
Short for Beginner's All-purpose Symbolic Instruction Code.
@@ -683,13 +696,13 @@ It has good command help, accessible via the `help` command, as well as https://
[NOTE]
====
-The `lldb` command is available for FreeBSD {rel113-current} link:{handbook}#ports-using/[from ports or packages] as package:devel/llvm[].
+The `lldb` command is available for FreeBSD {rel113-current} extref:{handbook}[from ports or packages, ports-using] as package:devel/llvm[].
This will install the default version of lldb (currently 9.0).
====
The other debugger available with FreeBSD is called `gdb` (GNU debugger).
Unlike lldb, it is not installed by default on FreeBSD {rel121-current};
-to use it, link:{handbook}#ports-using/[install] package:devel/gdb[] from ports or packages.
+to use it, extref:{handbook}#ports-using/[install] package:devel/gdb[] from ports or packages.
The version installed by default on FreeBSD {rel113-current} is old; instead, install package:devel/gdb[] there as well.
It has quite good on-line help, as well as a set of info pages.
@@ -938,7 +951,7 @@ Now all that is needed is to attach to the child, set PauseMode to `0` with `exp
[NOTE]
====
The described functionality is available starting with LLDB version 12.0.0.
-Users of FreeBSD releases containing an earlier LLDB version may wish to use the snapshot available in link:{handbook}#ports-using/[ports or packages], as package:devel/llvm-devel[].
+Users of FreeBSD releases containing an earlier LLDB version may wish to use the snapshot available in extref:{handbook}[ports or packages, ports-using], as package:devel/llvm-devel[].
====
Starting with LLDB 12.0.0, remote debugging is supported on FreeBSD.
diff --git a/documentation/content/en/books/developers-handbook/x86/_index.adoc b/documentation/content/en/books/developers-handbook/x86/_index.adoc
index e8a5250edb..1b4d2371d2 100644
--- a/documentation/content/en/books/developers-handbook/x86/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/x86/_index.adoc
@@ -15,22 +15,35 @@ tags: ["x86", "guide"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
_This chapter was written by {stanislav}._
diff --git a/documentation/content/en/books/faq/_index.adoc b/documentation/content/en/books/faq/_index.adoc
index 7851e3c653..a0583bdf8f 100644
--- a/documentation/content/en/books/faq/_index.adoc
+++ b/documentation/content/en/books/faq/_index.adoc
@@ -7,6 +7,7 @@ description: Frequently Asked Questions, and answers, covering all aspects of Fr
trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
weight: 5
tags: ["FAQ", "FreeBSD FAQ"]
+isIndex: true
---
= Frequently Asked Questions for FreeBSD {rel2-relx} and {rel-relx}
@@ -14,17 +15,12 @@ tags: ["FAQ", "FreeBSD FAQ"]
:toc: macro
:toclevels: 1
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
-:chapter-signifier: Chapter
-:part-signifier: Part
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
+:images-path: books/faq/
:rel-numbranch: 4
:rel-head: 14-CURRENT
:rel-head-relx: 14.X
@@ -42,32 +38,23 @@ tags: ["FAQ", "FreeBSD FAQ"]
:rel3-releng: stable/11/
:rel3-relengdate: October 2016
-
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -76,7 +63,7 @@ Abstract
This is the Frequently Asked Questions (FAQ) for FreeBSD versions {rel-relx}, {rel2-relx}, and {rel3-relx}.
Every effort has been made to make this FAQ as informative as possible; if you have any suggestions as to how it may be improved, send them to the {freebsd-doc}.
-The latest version of this document is always available from the link:{faq}[FreeBSD website].
+The latest version of this document is always available from the extref:{faq}[FreeBSD website].
It may also be downloaded as one large link:.[HTML] file with HTTP or as a variety of other formats from the https://download.freebsd.org/ftp/doc/[FreeBSD FTP server].
'''
@@ -97,7 +84,7 @@ though very little of the 386BSD code remains.
FreeBSD is used by companies, Internet Service Providers, researchers, computer professionals, students and home users all over the world in their work, education and recreation.
-For more detailed information on FreeBSD, refer to the link:{handbook}[FreeBSD Handbook].
+For more detailed information on FreeBSD, refer to the extref:{handbook}[FreeBSD Handbook].
[[FreeBSD-goals]]
=== What is the goal of the FreeBSD Project?
@@ -142,7 +129,7 @@ Many computer users across the world, including both novices and experienced UNI
Users migrating to FreeBSD from another UNIX(R)-like environment will find FreeBSD to be similar.
Windows(R) and Mac OS(R) users may be interested in instead using https://www.ghostbsd.org/[GhostBSD], https://www.midnightbsd.org/[MidnightBSD] or https://www.nomadbsd.org/[NomadBSD] three FreeBSD-based desktop distributions.
Non-UNIX(R) users should expect to invest some additional time learning the UNIX(R) way of doing things.
-This FAQ and the link:{handbook}[FreeBSD Handbook] are excellent places to start.
+This FAQ and the extref:{handbook}[FreeBSD Handbook] are excellent places to start.
[[why-called-FreeBSD]]
=== Why is it called FreeBSD?
@@ -188,9 +175,9 @@ More information on FreeBSD releases can be found on the https://www.FreeBSD.org
[[current]]
=== What is _FreeBSD-CURRENT_?
-link:{handbook}#current[FreeBSD-CURRENT] is the development version of the operating system, which will in due course become the new FreeBSD-STABLE branch.
+extref:{handbook}[FreeBSD-CURRENT, current] is the development version of the operating system, which will in due course become the new FreeBSD-STABLE branch.
As such, it is really only of interest to developers working on the system and die-hard hobbyists.
-See the link:{handbook}#current[relevant section] in the link:{handbook}[Handbook] for details on running _-CURRENT_.
+See the extref:{handbook}[relevant section, current] in the extref:{handbook}[Handbook] for details on running _-CURRENT_.
Users not familiar with FreeBSD should not use FreeBSD-CURRENT.
This branch sometimes evolves quite quickly and due to mistake can be un-buildable at times.
@@ -206,7 +193,7 @@ as it may uncover bugs and corner cases that were not yet found in FreeBSD-CURRE
Users who do not have the resources to perform testing should instead run the most recent release of FreeBSD.
_FreeBSD-CURRENT_, on the other hand, has been one unbroken line since 2.0 was released.
-For more detailed information on branches see "link:{releng}#rel-branch[FreeBSD Release Engineering: Creating the Release Branch]",
+For more detailed information on branches see "extref:{releng}[FreeBSD Release Engineering: Creating the Release Branch, rel-branch]",
the status of the branches and the upcoming release schedule can be found on the https://www.FreeBSD.org/releng[Release Engineering Information] page.
Version https://download.FreeBSD.org/ftp/releases/amd64/amd64/{rel121-current}-RELEASE/[{rel121-current}] is the latest release from the {rel-stable} branch; it was released in {rel121-current-date}.
@@ -247,7 +234,7 @@ Official snapshots are generated on a regular basis for all actively developed b
The key decisions concerning the FreeBSD project, such as the overall direction of the project and who is allowed to add code to the source tree,
are made by a link:https://www.FreeBSD.org/administration#t-core[core team] of 9 people.
-There is a much larger team of more than 350 link:{contributors}#staff-committers[committers] who are authorized to make changes directly to the FreeBSD source tree.
+There is a much larger team of more than 350 extref:{contributors}[committers, staff-committers] who are authorized to make changes directly to the FreeBSD source tree.
However, most non-trivial changes are discussed in advance in the <<mailing,mailing lists>>,
and there are no restrictions on who may take part in the discussion.
@@ -261,7 +248,7 @@ Every significant release of FreeBSD is available via anonymous FTP from the htt
* link:https://www.FreeBSD.org/snapshots/[Snapshot] releases are made monthly for the <<current,-CURRENT>> and <<stable,-STABLE>> branch, these being of service purely to bleeding-edge testers and developers.
* The latest {rel2-stable} release, {rel113-current}-RELEASE can be found in the https://download.FreeBSD.org/ftp/releases/amd64/amd64/{rel113-current}-RELEASE/[{rel113-current}-RELEASE directory].
-Information about obtaining FreeBSD on CD, DVD, and other media can be found in link:{handbook}#mirrors/[the Handbook].
+Information about obtaining FreeBSD on CD, DVD, and other media can be found in extref:{handbook}[the Handbook, mirrors].
[[access-pr]]
=== How do I access the Problem Report database?
@@ -270,7 +257,7 @@ The Problem Report database of all user change requests may be queried by using
The link:https://www.FreeBSD.org/support/bugreports[web-based problem report submission interface] can be used to submit problem reports through a web browser.
-Before submitting a problem report, read link:{problem-reports}[Writing FreeBSD Problem Reports], an article on how to write good problem reports.
+Before submitting a problem report, read extref:{problem-reports}[Writing FreeBSD Problem Reports], an article on how to write good problem reports.
[[support]]
== Documentation and Support
@@ -408,7 +395,7 @@ The main one is called [.filename]#index.html#, which will contain the table of
[[mailing]]
=== Where do I find info on the FreeBSD mailing lists? What FreeBSD news groups are available?
-Refer to the link:{handbook}#eresources-mail[Handbook entry on mailing-lists] and the link:{handbook}#eresources-news/[Handbook entry on newsgroups].
+Refer to the extref:{handbook}[Handbook entry on mailing-lists, eresources-mail] and the extref:{handbook}[Handbook entry on newsgroups, eresources-news].
[[irc]]
=== Are there FreeBSD IRC (Internet Relay Chat) channels?
@@ -472,7 +459,7 @@ Any of the following can be used:
|A minimal image that requires network access during installation to completely install FreeBSD.
|===
-Full instructions on this procedure and a little bit more about installation issues in general can be found in the link:{handbook}#bsdinstall/[Handbook entry on installing FreeBSD].
+Full instructions on this procedure and a little bit more about installation issues in general can be found in the extref:{handbook}[Handbook entry on installing FreeBSD, bsdinstall].
[[floppy-image-too-large]]
=== What do I do if the install image does not boot?
@@ -488,13 +475,13 @@ When using a command line FTP client, type _binary_ at the FTP command prompt af
[[install-instructions-location]]
=== Where are the instructions for installing FreeBSD?
-Installation instructions can be found at link:{handbook}#bsdinstall/[Handbook entry on installing FreeBSD].
+Installation instructions can be found at extref:{handbook}[Handbook entry on installing FreeBSD, bsdinstall].
[[custom-boot-floppy]]
=== How can I make my own custom release or install disk?
Customized FreeBSD installation media can be created by building a custom release.
-Follow the instructions in the link:{releng}[Release Engineering] article.
+Follow the instructions in the extref:{releng}[Release Engineering] article.
[[windows-coexist]]
=== Can Windows(R) co-exist with FreeBSD? (x86-specific)
@@ -647,7 +634,7 @@ Yes.
FreeBSD divides support into multiple tiers.
Tier 1 architectures, such as i386 or amd64; are fully supported.
Tiers 2 and 3 are supported on a best-effort basis.
-A full explanation of the tier system is available in the link:{committers-guide}#archs/[Committer's Guide.]
+A full explanation of the tier system is available in the extref:{committers-guide}[Committer's Guide., archs]
A complete list of supported architectures can be found on the https://www.FreeBSD.org/platforms/[platforms page.]
@@ -852,7 +839,7 @@ The number is based on the `kern.maxusers` man:sysctl[8] variable.
If the machine is heavily loaded, increase `kern.maxusers`.
This will increase these other system limits in addition to the maximum number of processes.
-To adjust the `kern.maxusers` value, see the link:{handbook}#kern-maxfiles[File/Process Limits] section of the Handbook.
+To adjust the `kern.maxusers` value, see the extref:{handbook}[File/Process Limits, kern-maxfiles] section of the Handbook.
While that section refers to open files, the same limits apply to processes.
If the machine is lightly loaded but running a very large number of processes, adjust the `kern.maxproc` tunable by defining it in [.filename]#/boot/loader.conf#.
@@ -906,7 +893,7 @@ If this is causing the problem, either fill in the missing information in [.file
=== Why does file: table is full show up repeatedly in man:dmesg[8]?
This error message indicates that the number of available file descriptors have been exhausted on the system.
-Refer to the link:{handbook}#kern-maxfiles[kern.maxfiles] section of the link:{handbook}#configtuning-kernel-limits/[Tuning Kernel Limits] section of the Handbook for a discussion and solution.
+Refer to the extref:{handbook}[kern.maxfiles, kern-maxfiles] section of the extref:{handbook}[Tuning Kernel Limits, configtuning-kernel-limits] section of the Handbook for a discussion and solution.
[[computer-clock-skew]]
=== Why does the clock on my computer keep incorrect time?
@@ -1039,7 +1026,7 @@ See crossref:handbook[ports-using-installation-methods,Installing the Ports Coll
[[ports-4x]]
=== Why can I not build this port on my {rel2-relx} -, or {rel-relx} -STABLE machine?
-If the installed FreeBSD version lags significantly behind _-CURRENT_ or _-STABLE_, update the Ports Collection using the instructions in link:{handbook}#ports-using/[Using the Ports Collection].
+If the installed FreeBSD version lags significantly behind _-CURRENT_ or _-STABLE_, update the Ports Collection using the instructions in extref:{handbook}[Using the Ports Collection, ports-using].
If the system is up-to-date, someone might have committed a change to the port which works for _-CURRENT_ but which broke the port for _-STABLE_.
https://bugs.FreeBSD.org/submit/[Submit] a bug report, since the Ports Collection is supposed to work for both the _-CURRENT_ and _-STABLE_ branches.
@@ -1056,7 +1043,7 @@ If you suspect that this is the case, try to make [.filename]#INDEX# with those
=== I updated the sources, now how do I update my installed ports?
FreeBSD does not include a port upgrading tool, but it does have some tools to make the upgrade process somewhat easier.
-Additional tools are available to simplify port handling and are described the link:{handbook}#ports-using/[Upgrading Ports] section in the FreeBSD Handbook.
+Additional tools are available to simplify port handling and are described the extref:{handbook}[Upgrading Ports, ports-using] section in the FreeBSD Handbook.
[[ports-major-upgrade]]
=== Do I need to recompile every port each time I perform a major version update?
@@ -1067,7 +1054,7 @@ things will randomly crash and fail to work once other ports are installed or up
When the system is upgraded, various shared libraries, loadable modules, and other parts of the system will be replaced with newer versions.
Applications linked against the older versions may fail to start or, in other cases, fail to function properly.
-For more information, see link:{handbook}#freebsdupdate-upgrade[the section on upgrades] in the FreeBSD Handbook.
+For more information, see extref:{handbook}[the section on upgrades, freebsdupdate-upgrade] in the FreeBSD Handbook.
[[ports-minor-upgrade]]
=== Do I need to recompile every port each time I perform a minor version update?
@@ -1094,7 +1081,7 @@ Compare the memory utilization of these shells by looking at the "VSZ" and "RSS"
[[make-kernel]]
=== I would like to customize my kernel. Is it difficult?
-Not at all! Check out the link:{handbook}#kernelconfig/[kernel config section of the Handbook].
+Not at all! Check out the extref:{handbook}[kernel config section of the Handbook, kernelconfig].
[NOTE]
====
@@ -1151,7 +1138,7 @@ For more information, read [.filename]#/usr/share/examples/etc/make.conf#.
Unneeded devices can be removed from the kernel to further reduce the size.
See <<make-kernel>> for more information.
-To put any of these options into effect, follow the instructions to link:{handbook}#kernelconfig-building/[build and install] the new kernel.
+To put any of these options into effect, follow the instructions to extref:{handbook}[build and install, kernelconfig-building] the new kernel.
For reference, the FreeBSD 11 amd64 kernel ([.filename]#/boot/kernel/kernel#) is approximately 25 MB.
@@ -1186,7 +1173,7 @@ kern.sched.name: ULE
[[adding-disks]]
=== How can I add my new hard disk to my FreeBSD system?
-See the link:{handbook}#disks-adding/[Adding Disks] section in the FreeBSD Handbook.
+See the extref:{handbook}[Adding Disks, disks-adding] section in the FreeBSD Handbook.
[[new-huge-disk]]
=== How do I move my system over to my huge new disk?
@@ -1334,7 +1321,7 @@ there will be a device file for "slice 5" in [.filename]#/dev#. To mount it:
=== Is there a cryptographic file system for FreeBSD?
Yes, man:gbde[8] and man:geli[8].
-See the link:{handbook}#disks-encrypting/[Encrypting Disk Partitions] section of the FreeBSD Handbook.
+See the extref:{handbook}[Encrypting Disk Partitions, disks-encrypting] section of the FreeBSD Handbook.
[[grub-loader]]
=== How do I boot FreeBSD and Linux(R) using GRUB?
@@ -1413,31 +1400,31 @@ It is a good idea to add a line to [.filename]#/etc/fstab# (see man:fstab[5]) so
=== Why do I get Incorrect super block when mounting a CD?
The type of device to mount must be specified.
-This is described in the Handbook section on link:{handbook}#mounting-cd[Using Data CDs].
+This is described in the Handbook section on extref:{handbook}[Using Data CDs, mounting-cd].
[[cdrom-not-configured]]
=== Why do I get Device not configured when mounting a CD?
This generally means that there is no CD in the drive, or the drive is not visible on the bus.
-Refer to the link:{handbook}#mounting-cd[Using Data CDs] section of the Handbook for a detailed discussion of this issue.
+Refer to the extref:{handbook}[Using Data CDs, mounting-cd] section of the Handbook for a detailed discussion of this issue.
[[cdrom-unicode-filenames]]
=== Why do all non-English characters in filenames show up as ? on my CDs when mounted in FreeBSD?
The CD probably uses the "Joliet" extension for storing information about files and directories.
-This is discussed in the Handbook section on link:{handbook}#mounting-cd[Using Data CD-ROMs].
+This is discussed in the Handbook section on extref:{handbook}[Using Data CD-ROMs, mounting-cd].
[[burncd-isofs]]
=== A CD burned under FreeBSD cannot be read under any other operating system. Why?
This means a raw file was burned to the CD, rather than creating an ISO 9660 file system.
-Take a look at the Handbook section on link:{handbook}#mounting-cd[Using Data CDs].
+Take a look at the Handbook section on extref:{handbook}[Using Data CDs].
[[copy-cd]]
=== How can I create an image of a data CD?
-This is discussed in the Handbook section on link:{handbook}#mkisofs[Writing Data to an ISO File System].
-For more on working with CD-ROMs, see the link:{handbook}#creating-cds/[Creating CDs Section] in the Storage chapter in the Handbook.
+This is discussed in the Handbook section on extref:{handbook}[Writing Data to an ISO File System, mkisofs].
+For more on working with CD-ROMs, see the extref:{handbook}[Creating CDs Section, creating-cds] in the Storage chapter in the Handbook.
[[mount-audio-CD]]
=== Why can I not mount an audio CD?
@@ -1529,7 +1516,7 @@ Note that Soft Updates can delay the freeing of disk space and it can take up to
[[add-swap-space]]
=== How can I add more swap space?
-This section link:{handbook}#adding-swap-space/[of the Handbook] describes how to do this.
+This section extref:{handbook}[of the Handbook, adding-swap-space] describes how to do this.
[[manufacturer-disk-size]]
=== Why does FreeBSD see my disk as smaller than the manufacturer says it is?
@@ -1719,13 +1706,13 @@ The error message displayed immediately after the kernel boot messages should in
[[printer-setup]]
=== Why am I having trouble setting up my printer?
-See the link:{handbook}#printing/[Handbook entry on printing] for troubleshooting tips.
+See the extref:{handbook}[Handbook entry on printing, printing] for troubleshooting tips.
[[keyboard-mappings]]
=== How can I correct the keyboard mappings for my system?
-Refer to the Handbook section on link:{handbook}#using-localization/[using localization],
-specifically the section on link:{handbook}#setting-console[console setup].
+Refer to the Handbook section on extref:{handbook}[using localization, using-localization],
+specifically the section on extref:{handbook}[console setup, setting-console].
[[user-quotas]]
=== Why can I not get user quotas to work properly?
@@ -1738,7 +1725,7 @@ In this case, add the following line to the kernel configuration file and recomp
options QUOTA
....
+
-Refer to the link:{handbook}#quotas/[Handbook entry on quotas] for full details.
+Refer to the extref:{handbook}[Handbook entry on quotas, quotas] for full details.
. Do not turn on quotas on [.filename]#/#.
. Put the quota file on the file system that the quotas are to be enforced on:
+
@@ -1801,7 +1788,7 @@ For example, replace `mount -urw /` with `mount /dev/ada0p1 /mnt; chroot /mnt` f
====
If the root partition cannot be mounted from single-user mode,
it is possible that the partitions are encrypted and it is impossible to mount them without the access keys.
-For more information see the section about encrypted disks in the FreeBSD link:{handbook}#disks-encrypting/[Handbook].
+For more information see the section about encrypted disks in the FreeBSD extref:{handbook}[Handbook, disks-encrypting].
====
[[CAD-reboot]]
@@ -1875,7 +1862,7 @@ When the source code is in shape for the release the name will be changed to 6.3
Once in the RC stage, only the most critical bugs found can be fixed.
Once the release (6.3-RELEASE in this example) and release branch have been made, the branch will be renamed to 6.3-STABLE.
-For more information on version numbers and the various Subversion branches, refer to the link:{releng}[Release Engineering] article.
+For more information on version numbers and the various Subversion branches, refer to the extref:{releng}[Release Engineering] article.
[[kernel-chflag-failure]]
=== I tried to install a new kernel, and the man:chflags[1] failed. How do I get around this?
@@ -2018,7 +2005,7 @@ Install Xorg from FreeBSD packages:
# pkg install xorg
....
-After the installation of Xorg, follow the instructions from the link:{handbook}#x-config/[X11 Configuration] section of the FreeBSD Handbook.
+After the installation of Xorg, follow the instructions from the extref:{handbook}[X11 Configuration, x-config] section of the FreeBSD Handbook.
[[running-X-securelevels]]
=== I tried to run X, but I get a No devices detected. error when I type startx. What do I do now?
@@ -2259,7 +2246,7 @@ Add this command to [.filename]#~/.xinitrc# or [.filename]#~/.xsession# to make
[[install-splash]]
=== How do I install a splash screen and where do I find them?
-The detailed answer for this question can be found in the link:{handbook}#boot-splash/[Boot Time Splash Screens] section of the FreeBSD Handbook.
+The detailed answer for this question can be found in the extref:{handbook}[Boot Time Splash Screens, boot-splash] section of the FreeBSD Handbook.
[[windows-keys]]
=== Can I use the kbd:[Windows] keys on my keyboard in X?
@@ -2339,19 +2326,19 @@ For ATI Rage 128 and Radeon see man:ati[4], man:r128[4] and man:radeon[4].
=== Where can I get information on diskless booting?
"Diskless booting" means that the FreeBSD box is booted over a network, and reads the necessary files from a server instead of its hard disk.
-For full details, see link:{handbook}#network-diskless/[the Handbook entry on diskless booting].
+For full details, see extref:{handbook}[the Handbook entry on diskless booting, network-diskless].
[[router]]
=== Can a FreeBSD box be used as a dedicated network router?
-Yes. Refer to the Handbook entry on link:{handbook}#advanced-networking/[advanced networking],
-specifically the section on link:{handbook}#network-routing/[routing and gateways].
+Yes. Refer to the Handbook entry on extref:{handbook}[advanced networking, advanced-networking],
+specifically the section on extref:{handbook}[routing and gateways, network-routing].
[[natd]]
=== Does FreeBSD support NAT or Masquerading?
-Yes. For instructions on how to use NAT over a PPP connection, see the link:{handbook}#userppp/[Handbook entry on PPP].
-To use NAT over some other sort of network connection, look at the link:{handbook}#network-natd[natd] section of the Handbook.
+Yes. For instructions on how to use NAT over a PPP connection, see the extref:{handbook}[Handbook entry on PPP, userppp].
+To use NAT over some other sort of network connection, look at the extref:{handbook}[natd, network-natd] section of the Handbook.
[[ethernet-aliases]]
=== How can I set up Ethernet aliases?
@@ -2370,7 +2357,7 @@ Otherwise, specify the network address and netmask as usual:
# ifconfig ed0 alias 172.16.141.5 netmask 0xffffff00
....
-More information can be found in the FreeBSD link:{handbook}#configtuning-virtual-hosts/[Handbook].
+More information can be found in the FreeBSD extref:{handbook}[Handbook, configtuning-virtual-hosts].
[[nfs-linux]]
=== Why can I not NFS-mount from a Linux(R) box?
@@ -2386,8 +2373,8 @@ Some versions of the Linux(R) NFS code only accept mount requests from a privile
=== Why does mountd keep telling me it can't change attributes and that I have a bad exports list on my FreeBSD NFS server?
The most frequent problem is not understanding the correct format of [.filename]#/etc/exports#.
-Review man:exports[5] and the link:{handbook}#network-nfs/[NFS] entry in the Handbook,
-especially the section on link:{handbook}#configuring-nfs[configuring NFS].
+Review man:exports[5] and the extref:{handbook}[NFS, network-nfs] entry in the Handbook,
+especially the section on extref:{handbook}[configuring NFS, configuring-nfs].
[[ip-multicast]]
=== How do I enable IP multicast support?
@@ -2397,7 +2384,7 @@ Install the package:net/mrouted[] package or port and add `mrouted_enable="YES"`
[[fqdn-hosts]]
=== Why do I have to use the FQDN for hosts on my site?
-See the answer in the FreeBSD link:{handbook}#mail-trouble/[Handbook].
+See the answer in the FreeBSD extref:{handbook}[Handbook, mail-trouble].
[[network-permission-denied]]
=== Why do I get an error, Permission denied, for all networking operations?
@@ -2414,7 +2401,7 @@ If the firewall is unintentionally misconfigured, restore network operability by
Consider setting `firewall_type="open"` in [.filename]#/etc/rc.conf#.
-For further information on configuring this firewall, see the link:{handbook}#firewalls-ipfw/[Handbook chapter].
+For further information on configuring this firewall, see the extref:{handbook}[Handbook chapter, firewalls-ipfw].
[[ipfw-fwd]]
=== Why is my `ipfw` “fwd” rule to redirect a service to another machine not working?
@@ -2641,7 +2628,7 @@ This section answers common questions about serial communications with FreeBSD.
[[serial-console-prompt]]
=== How do I get the boot: prompt to show on the serial console?
-See link:{handbook}#serialconsole-setup/[this section of the Handbook].
+See extref:{handbook}[this section of the Handbook, serialconsole-setup].
[[found-serial]]
=== How do I tell if FreeBSD found my serial ports or modem cards?
@@ -2717,7 +2704,7 @@ The flags indicate that the master port has minor number `7` (`0x700`), and all
[[default-serial-params]]
=== Can I set the default serial parameters for a port?
-See the link:{handbook}#serial/#serial-hw-config[Serial Communications] section in the FreeBSD Handbook.
+See the extref:{handbook}serialcomms[Serial Communications, serial-hw-config] section in the FreeBSD Handbook.
[[cannot-tip]]
=== Why can I not run tip or cu?
@@ -2799,7 +2786,7 @@ The main focus of this application is emulating old DOS games using the local fi
[[translation]]
=== What do I need to do to translate a FreeBSD document into my native language?
-See the link:{fdp-primer}#translations/[Translation FAQ] in the FreeBSD Documentation Project Primer.
+See the extref:{fdp-primer}[Translation FAQ, translations] in the FreeBSD Documentation Project Primer.
[[freebsd-mail-bounces]]
=== Why does my email to any address at FreeBSD.org bounce?
@@ -2858,7 +2845,7 @@ Xfig and eps drawings are available under [.filename]#/usr/share/examples/BSD_da
[[glossary]]
=== I have seen an acronym or other term on the mailing lists and I do not understand what it means. Where should I look?
-Refer to the link:{handbook}#freebsd-glossary/[FreeBSD Glossary].
+Refer to the extref:{handbook}[FreeBSD Glossary, freebsd-glossary].
[[bikeshed-painting]]
=== Why should I care what color the bikeshed is?
@@ -3023,7 +3010,7 @@ Install package:games/sl[] and wait for her to mistype `sl` for `ls`.
[[learn-advanced]]
=== How can I learn more about FreeBSD's internals?
-See the link:{arch-handbook}[FreeBSD Architecture Handbook].
+See the extref:{arch-handbook}[FreeBSD Architecture Handbook].
Additionally, much general UNIX(R) knowledge is directly applicable to FreeBSD.
@@ -3031,7 +3018,7 @@ Additionally, much general UNIX(R) knowledge is directly applicable to FreeBSD.
=== How can I contribute to FreeBSD? What can I do to help?
We accept all types of contributions: documentation, code, and even art.
-See the article on link:{contributing}[Contributing to FreeBSD] for specific advice on how to do this.
+See the article on extref:{contributing}[Contributing to FreeBSD] for specific advice on how to do this.
And thanks for the thought!
@@ -3220,4 +3207,4 @@ To find the correct value of _N_, divide the desired address space size (in mega
This innocent little Frequently Asked Questions document has been written, rewritten, edited, folded, spindled, mutilated, eviscerated, contemplated, discombobulated, cogitated, regurgitated, rebuilt, castigated, and reinvigorated over the last decade, by a cast of hundreds if not thousands. Repeatedly.
-We wish to thank every one of the people responsible, and we encourage you to link:{contributing}[join them] in making this FAQ even better.
+We wish to thank every one of the people responsible, and we encourage you to extref:{contributing}[join them] in making this FAQ even better.
diff --git a/documentation/content/en/books/fdp-primer/_index.adoc b/documentation/content/en/books/fdp-primer/_index.adoc
index 4807dad36a..1b9ef9a0ec 100644
--- a/documentation/content/en/books/fdp-primer/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/_index.adoc
@@ -9,6 +9,7 @@ next: books/fdp-primer/preface
weight: 10
tags: ["FDP", "documentation", "FreeBSD", "Index"]
add_single_page_link: true
+isIndex: true
---
= FreeBSD Documentation Project Primer for New Contributors
@@ -18,7 +19,32 @@ add_single_page_link: true
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
+:source-highlighter: rouge
:experimental:
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/fdp-primer/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Abstract
@@ -33,4 +59,4 @@ Corrections and additions are always welcome.
'''
-include::content/en/books/fdp-primer/toc.adoc[]
+include::{chapters-path}toc.adoc[]
diff --git a/documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc b/documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc
index 581d39aff6..85a4b6a4e0 100644
--- a/documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc
@@ -14,17 +14,35 @@ tags: ["AsciiDoc", "AsciiDoctor", "Primer", "Introduction", "Guide"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-include::shared/en/urls.adoc[]
-
-toc::[]
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Most FDP documentation is written with AsciiDoc.
This chapter explains what that means, how to read and understand the documentation source, and the techniques used.
@@ -212,12 +230,12 @@ For example, if we are in the `cups` article and we want to point to `ipsec-must
. Then create a link using the AsciiDoctor variable to the `ipsec-must` article.
+
....
-link:{ipsec-must}[IPSec-Must article]
+extref:{ipsec-must}[IPSec-Must article]
....
+
And this would be rendered as.
+
-link:{ipsec-must}[IPSec-Must article]
+extref:{ipsec-must}[IPSec-Must article]
[[asciidoctor-conclusion]]
== Conclusion
diff --git a/documentation/content/en/books/fdp-primer/book.adoc b/documentation/content/en/books/fdp-primer/book.adoc
index aec895e083..71ef597575 100644
--- a/documentation/content/en/books/fdp-primer/book.adoc
+++ b/documentation/content/en/books/fdp-primer/book.adoc
@@ -14,48 +14,35 @@ add_split_page_link: true
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
-:chapter-signifier: Chapter
-:part-signifier: Part
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
:book: true
:pdf: false
+:images-path: books/fdp-primer/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
-:chapters-path: content/en/books/fdp-primer/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/fdp-primer/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -79,38 +66,38 @@ include::{chapters-path}toc-examples.adoc[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=9..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
-include::{chapters-path}overview/_index.adoc[leveloffset=+1, lines=9..23; 30..-1]
+include::{chapters-path}overview/_index.adoc[leveloffset=+1]
-include::{chapters-path}tools/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
+include::{chapters-path}tools/_index.adoc[leveloffset=+1]
-include::{chapters-path}working-copy/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
+include::{chapters-path}working-copy/_index.adoc[leveloffset=+1]
-include::{chapters-path}structure/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
+include::{chapters-path}structure/_index.adoc[leveloffset=+1]
-include::{chapters-path}doc-build/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
+include::{chapters-path}doc-build/_index.adoc[leveloffset=+1]
-include::{chapters-path}asciidoctor-primer/_index.adoc[leveloffset=+1, lines=9..23; 29..-1]
+include::{chapters-path}asciidoctor-primer/_index.adoc[leveloffset=+1]
-include::{chapters-path}rosetta/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
+include::{chapters-path}rosetta/_index.adoc[leveloffset=+1]
-include::{chapters-path}translations/_index.adoc[leveloffset=+1, lines=9..23; 30..-1]
+include::{chapters-path}translations/_index.adoc[leveloffset=+1]
-include::{chapters-path}po-translations/_index.adoc[leveloffset=+1, lines=9..23; 29..-1]
+include::{chapters-path}po-translations/_index.adoc[leveloffset=+1]
-include::{chapters-path}manual-pages/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
+include::{chapters-path}manual-pages/_index.adoc[leveloffset=+1]
-include::{chapters-path}writing-style/_index.adoc[leveloffset=+1, lines=9..23; 29..-1]
+include::{chapters-path}writing-style/_index.adoc[leveloffset=+1]
-include::{chapters-path}editor-config/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
+include::{chapters-path}editor-config/_index.adoc[leveloffset=+1]
-include::{chapters-path}see-also/_index.adoc[leveloffset=+1, lines=9..23; 29..-1]
+include::{chapters-path}see-also/_index.adoc[leveloffset=+1]
:sectnums!:
-include::{chapters-path}examples/_index.adoc[leveloffset=+1, lines=8..23; 27..-1]
+include::{chapters-path}examples/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/en/books/fdp-primer/doc-build/_index.adoc b/documentation/content/en/books/fdp-primer/doc-build/_index.adoc
index c39adf8a40..8f52e7d9b5 100644
--- a/documentation/content/en/books/fdp-primer/doc-build/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/doc-build/_index.adoc
@@ -14,15 +14,35 @@ tags: ["build", "process", "make"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-toc::[]
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
This chapter covers organization of the documentation build process and how man:make[1] is used to control it.
diff --git a/documentation/content/en/books/fdp-primer/editor-config/_index.adoc b/documentation/content/en/books/fdp-primer/editor-config/_index.adoc
index 59ecbedc51..d86acd279f 100644
--- a/documentation/content/en/books/fdp-primer/editor-config/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/editor-config/_index.adoc
@@ -14,15 +14,35 @@ tags: ["editor", "configuration", "vim", "emacs", "FreeBSD"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Adjusting your text editor configuration can make working on document files quicker and easier, and help documents conform to FDP guidelines.
diff --git a/documentation/content/en/books/fdp-primer/examples/_index.adoc b/documentation/content/en/books/fdp-primer/examples/_index.adoc
index 430c80c9eb..d1e1acb004 100644
--- a/documentation/content/en/books/fdp-primer/examples/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/examples/_index.adoc
@@ -14,15 +14,35 @@ tags: ["examples", "tutorial", "AsciiDoctor", "Book", "Article"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/fdp-primer/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
These examples are not exhaustive - they do not contain all the elements that might be desirable to use, particularly in a document's front matter.
For more examples of AsciiDoctor, examine the AsciiDoc source for this and other documents available in the Git `doc` repository, or available online starting at link:https://cgit.freebsd.org/doc/[https://cgit.freebsd.org/doc/].
diff --git a/documentation/content/en/books/fdp-primer/manual-pages/_index.adoc b/documentation/content/en/books/fdp-primer/manual-pages/_index.adoc
index 36b078781c..86b8a336ec 100644
--- a/documentation/content/en/books/fdp-primer/manual-pages/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/manual-pages/_index.adoc
@@ -14,15 +14,35 @@ tags: ["manual pages", "introduction", "guide", "reference"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[manual-pages-introduction]]
== Introduction
@@ -249,7 +269,7 @@ A trivial example shows the minimal requirements, a serious example shows actual
Include the BSD license::
Include the BSD license on new manual pages.
-The preferred license is available from the link:{committers-guide}[Committer's Guide].
+The preferred license is available from the extref:{committers-guide}[Committer's Guide].
[[manual-pages-markup-tricks]]
=== Markup Tricks
diff --git a/documentation/content/en/books/fdp-primer/overview/_index.adoc b/documentation/content/en/books/fdp-primer/overview/_index.adoc
index d273ee34ae..42af65e795 100644
--- a/documentation/content/en/books/fdp-primer/overview/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/overview/_index.adoc
@@ -14,18 +14,35 @@ tags: ["overview", "FreeBSD Documentation Project", "quick start"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
-
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-
-toc::[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Welcome to the FreeBSD Documentation Project (FDP).
Quality documentation is crucial to the success of FreeBSD, and we value your contributions very highly.
diff --git a/documentation/content/en/books/fdp-primer/po-translations/_index.adoc b/documentation/content/en/books/fdp-primer/po-translations/_index.adoc
index 7e33cf1742..3783dcd2ba 100644
--- a/documentation/content/en/books/fdp-primer/po-translations/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/po-translations/_index.adoc
@@ -14,17 +14,35 @@ tags: ["po", "translations", "tutorial", "quick start"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-include::shared/en/urls.adoc[]
-
-toc::[]
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[po-translations-introduction]]
== Introduction
@@ -40,7 +58,7 @@ The strings can be used directly or built into a complete translated version of
The procedure shown in crossref:overview[overview-quick-start,Quick Start] is assumed to have already been performed.
The `TRANSLATOR` option is required and already enabled by default in the package:textproc/docproj[] port.
-This example shows the creation of a Spanish translation of the short link:{leap-seconds}[Leap Seconds] article.
+This example shows the creation of a Spanish translation of the short extref:{leap-seconds}[Leap Seconds] article.
[[po-translations-quick-start-install-po-editor]]
@@ -255,7 +273,7 @@ If the language directory already exists, only a subdirectory in the [.filename]
.Creating a Spanish Translation of the Porter's Handbook
[example]
====
-Create a new Spanish translation of the link:{porters-handbook}[Porter's Handbook].
+Create a new Spanish translation of the extref:{porters-handbook}[Porter's Handbook].
The original is a book in [.filename]#~/doc/documentation/content/en/books/porters-handbook/#.
[.procedure]
@@ -350,7 +368,7 @@ English original:
....
msgid ""
"This example shows the creation of a Spanish translation of the short "
-"link:{leap-seconds}[Leap Seconds] article."
+"extref:{leap-seconds}[Leap Seconds] article."
....
Spanish translation:
@@ -359,7 +377,7 @@ Spanish translation:
....
msgid ""
"Este ejemplo muestra la creación de un artículo con poco contenido como el artículo "
-"link:{leap-seconds}[Leap Seconds]."
+"extref:{leap-seconds}[Leap Seconds]."
....
====
diff --git a/documentation/content/en/books/fdp-primer/preface/_index.adoc b/documentation/content/en/books/fdp-primer/preface/_index.adoc
index 99859c1df7..7a46dacfed 100644
--- a/documentation/content/en/books/fdp-primer/preface/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/preface/_index.adoc
@@ -1,6 +1,6 @@
---
title: Preface
-prev: books/fdp-primer/
+prev: books/fdp-primer
next: books/fdp-primer/overview
description: Preface about the FreeBSD Documentation Project
tags: ["preface", "prompts", "conventions"]
@@ -15,10 +15,31 @@ tags: ["preface", "prompts", "conventions"]
:icons: font
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-prompts]]
== Shell Prompts
diff --git a/documentation/content/en/books/fdp-primer/rosetta/_index.adoc b/documentation/content/en/books/fdp-primer/rosetta/_index.adoc
index 54437cb282..2c023b330f 100644
--- a/documentation/content/en/books/fdp-primer/rosetta/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/rosetta/_index.adoc
@@ -14,15 +14,35 @@ tags: ["rosetta", "docbook", "asciidoc", "comparison"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
+:images-path: books/fdp-primer/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[docbook-vs-asciidoc]]
== Comparison between Docbook and AsciiDoc
diff --git a/documentation/content/en/books/fdp-primer/see-also/_index.adoc b/documentation/content/en/books/fdp-primer/see-also/_index.adoc
index 410d384b27..7caa0701d5 100644
--- a/documentation/content/en/books/fdp-primer/see-also/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/see-also/_index.adoc
@@ -14,17 +14,35 @@ tags: ["additional information", "AsciiDoctor", "HTML"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
+:images-path: books/fdp-primer/
-include::shared/en/urls.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
This document is deliberately not an exhaustive discussion of AsciiDoc and the FreeBSD Documentation Project.
For more information about these, you are encouraged to see the following web sites.
@@ -33,7 +51,7 @@ For more information about these, you are encouraged to see the following web si
== The FreeBSD Documentation Project
* link:https://www.FreeBSD.org/docproj/[The FreeBSD Documentation Project web pages]
-* link:{handbook}[The FreeBSD Handbook]
+* extref:{handbook}[The FreeBSD Handbook]
[[see-also-asciidoc]]
== AsciiDoctor
diff --git a/documentation/content/en/books/fdp-primer/structure/_index.adoc b/documentation/content/en/books/fdp-primer/structure/_index.adoc
index 6eaf0403cc..742d5d1583 100644
--- a/documentation/content/en/books/fdp-primer/structure/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/structure/_index.adoc
@@ -14,15 +14,35 @@ tags: ["directory structure", "organization"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Files and directories in the [.filename]#doc/# tree follow a structure meant to:
@@ -223,7 +243,6 @@ title: Why you should use a BSD style license for your Open Source Project
authors:
- author: Bruce Montague
email: brucem@alumni.cse.ucsc.edu
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "intel", "general"]
---
diff --git a/documentation/content/en/books/fdp-primer/tools/_index.adoc b/documentation/content/en/books/fdp-primer/tools/_index.adoc
index a5acaf0859..4158d57897 100644
--- a/documentation/content/en/books/fdp-primer/tools/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/tools/_index.adoc
@@ -14,15 +14,35 @@ tags: ["tools", "required tools", "optional tools"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Several software tools are used to manage the FreeBSD documentation and render it to different output formats.
Some of these tools are required and must be installed before working through the examples in the following chapters.
diff --git a/documentation/content/en/books/fdp-primer/translations/_index.adoc b/documentation/content/en/books/fdp-primer/translations/_index.adoc
index 118c0a980f..8bcbf5b77e 100644
--- a/documentation/content/en/books/fdp-primer/translations/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/translations/_index.adoc
@@ -14,18 +14,35 @@ tags: ["FAQ", "i18n", "i10n", "translation"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-include::shared/en/teams.adoc[]
-include::shared/en/mailing-lists.adoc[]
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
This is the FAQ for people translating the FreeBSD documentation (FAQ, Handbook, tutorials, manual pages, and others) to different languages.
@@ -87,7 +104,7 @@ For example, to view the differences between revisions `abff932fe8` and `2191c44
% git diff abff932fe8 2191c44469 documentation/content/en/articles/committers-guide/_index.adoc
....
-Please see the complete explanation of using Git in FreeBSD in the link:{handbook}mirrors/#git[FreeBSD Handbook].
+Please see the complete explanation of using Git in FreeBSD in the extref:{handbook}mirrors[FreeBSD Handbook, git].
== How do I find out who else might be translating to the same language?
diff --git a/documentation/content/en/books/fdp-primer/working-copy/_index.adoc b/documentation/content/en/books/fdp-primer/working-copy/_index.adoc
index 5b167694a4..56dedf08d7 100644
--- a/documentation/content/en/books/fdp-primer/working-copy/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/working-copy/_index.adoc
@@ -14,15 +14,35 @@ tags: ["working copy", "documentation", "manual pages", "git"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
The _working copy_ is a copy of the FreeBSD repository documentation tree downloaded onto the local computer.
Changes are made to the local working copy, tested, and then submitted as patches to be committed to the main repository.
diff --git a/documentation/content/en/books/fdp-primer/writing-style/_index.adoc b/documentation/content/en/books/fdp-primer/writing-style/_index.adoc
index e6f19cd197..9e3321bbae 100644
--- a/documentation/content/en/books/fdp-primer/writing-style/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/writing-style/_index.adoc
@@ -14,17 +14,35 @@ tags: ["writing", "style", "tipos", "one sentence per line"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-include::shared/en/mailing-lists.adoc[]
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[writing-style-tips]]
== Tips
diff --git a/documentation/content/en/books/handbook/_index.adoc b/documentation/content/en/books/handbook/_index.adoc
index ce29409b75..00b814f978 100644
--- a/documentation/content/en/books/handbook/_index.adoc
+++ b/documentation/content/en/books/handbook/_index.adoc
@@ -9,6 +9,7 @@ tags: ["FreeBSD Handbook", "Handbook"]
next: books/handbook/preface
weight: 1
add_single_page_link: true
+isIndex: true
---
= FreeBSD Handbook
@@ -18,11 +19,32 @@ add_single_page_link: true
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
:source-highlighter: rouge
:experimental:
+:images-path: books/handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Abstract
@@ -40,10 +62,10 @@ Searches can be performed on the handbook and other documents on the link:https:
'''
-include::content/en/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
-include::content/en/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
-include::content/en/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
-include::content/en/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/en/books/handbook/advanced-networking/_index.adoc b/documentation/content/en/books/handbook/advanced-networking/_index.adoc
index cce30cfc4a..5fa4c9d9d3 100644
--- a/documentation/content/en/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/en/books/handbook/advanced-networking/_index.adoc
@@ -15,33 +15,35 @@ tags: ["Advanced Networking", "Handbook", "gateway", "routes", "wireless", "teth
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 32
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 32
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[advanced-networking-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/audit/_index.adoc b/documentation/content/en/books/handbook/audit/_index.adoc
index ca0df463c1..f879157ac3 100644
--- a/documentation/content/en/books/handbook/audit/_index.adoc
+++ b/documentation/content/en/books/handbook/audit/_index.adoc
@@ -15,33 +15,35 @@ tags: ["audit", "terms", "configuration", "guide", "audit trails"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[audit-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/basics/_index.adoc b/documentation/content/en/books/handbook/basics/_index.adoc
index bec5b6b733..8ab50fce94 100644
--- a/documentation/content/en/books/handbook/basics/_index.adoc
+++ b/documentation/content/en/books/handbook/basics/_index.adoc
@@ -15,33 +15,35 @@ tags: ["basics", "virtual consoles", "users", "management", "permissions", "dire
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[basics-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/bibliography/_index.adoc b/documentation/content/en/books/handbook/bibliography/_index.adoc
index 6d990d7712..9540d07a1e 100644
--- a/documentation/content/en/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/en/books/handbook/bibliography/_index.adoc
@@ -11,22 +11,40 @@ tags: ["appendix", "bibliography", "handbook", "books", "guides", "security", "p
[[bibliography]]
= Bibliography
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
While manual pages provide a definitive reference for individual pieces of the FreeBSD operating system, they seldom illustrate how to put the pieces together to make the whole operating system run smoothly.
For this, there is no substitute for a good book or users' manual on UNIX(R) system administration.
@@ -101,7 +119,7 @@ An Italian https://www.FreeBSD.org/doc/it_IT.ISO8859-15/books/unix-introduction/
* Leffler, Samuel J., Marshall Kirk McKusick, _The Design and Implementation of the 4.3BSD UNIX Operating System: Answer Book_. Reading, Mass. : Addison-Wesley, 1991. ISBN 0-201-54629-9
* McKusick, Marshall Kirk, Keith Bostic, Michael J Karels, and John Quarterman. _The Design and Implementation of the 4.4BSD Operating System_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-54979-4
+
-(Chapter 2 of this book is available link:{design-44bsd}[online] as part of the FreeBSD Documentation Project.)
+(Chapter 2 of this book is available extref:{design-44bsd}[online] as part of the FreeBSD Documentation Project.)
* Marshall Kirk McKusick, George V. Neville-Neil _The Design and Implementation of the FreeBSD Operating System_. Boston, Mass. : Addison-Wesley, 2004. ISBN 0-201-70245-2
* Marshall Kirk McKusick, George V. Neville-Neil, Robert N. M. Watson _The Design and Implementation of the FreeBSD Operating System, 2nd Ed._. Westford, Mass. : Pearson Education, Inc., 2014. ISBN 0-321-96897-2
* Stevens, W. Richard. _TCP/IP Illustrated, Volume 1: The Protocols_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-63346-9
diff --git a/documentation/content/en/books/handbook/book.adoc b/documentation/content/en/books/handbook/book.adoc
index 1854c502b2..6facc0e7dd 100644
--- a/documentation/content/en/books/handbook/book.adoc
+++ b/documentation/content/en/books/handbook/book.adoc
@@ -14,49 +14,35 @@ add_split_page_link: true
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
-:chapter-signifier: Chapter
-:part-signifier: Part
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
:book: true
:pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
-:chapters-path: content/en/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -79,97 +65,97 @@ toc::[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=8..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
// Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..27]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
-include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1]
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..27]
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
-include::{chapters-path}wine/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}wine/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..23]
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}jails/_index.adoc[leveloffset=+1]
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
-include::{chapters-path}zfs/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}zfs/_index.adoc[leveloffset=+1]
-include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}filesystems/_index.adoc[leveloffset=+1]
-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
-include::{chapters-path}dtrace/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}dtrace/_index.adoc[leveloffset=+1]
-include::{chapters-path}usb-device-mode/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}usb-device-mode/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=7..19]
+include::{chapters-path}partiv.adoc[lines=15..29]
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=9..36;46..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
// Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
:sectnums!:
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=10..23;32..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=10..23;31..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=10..23;32..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=10..23;33..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/en/books/handbook/boot/_index.adoc b/documentation/content/en/books/handbook/boot/_index.adoc
index 864832928a..6324fbbd56 100644
--- a/documentation/content/en/books/handbook/boot/_index.adoc
+++ b/documentation/content/en/books/handbook/boot/_index.adoc
@@ -15,33 +15,35 @@ tags: ["boot", "boot process", "device hints", "x86", "amd64", "MBR", "GPT", "UE
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/bsdinstall/_index.adoc b/documentation/content/en/books/handbook/bsdinstall/_index.adoc
index 9f50dc2e81..20aa92b7e2 100644
--- a/documentation/content/en/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/en/books/handbook/bsdinstall/_index.adoc
@@ -15,33 +15,35 @@ tags: ["bsdinstall", "installing FreeBSD", "requirements", "tutorial", "guide"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/bsdinstall/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
-endif::[]
+:images-path: books/handbook/bsdinstall/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[bsdinstall-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/colophon.adoc b/documentation/content/en/books/handbook/colophon.adoc
index 7904bb122f..f5c6f6a120 100644
--- a/documentation/content/en/books/handbook/colophon.adoc
+++ b/documentation/content/en/books/handbook/colophon.adoc
@@ -8,14 +8,38 @@ description: FreeBSD Handbook Colophon
[[colophon]]
= Colophon
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:!sectnums:
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/colophon/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
This book is the combined work of hundreds of contributors to "The FreeBSD Documentation Project".
The text is authored in AsciiDoc.
diff --git a/documentation/content/en/books/handbook/config/_index.adoc b/documentation/content/en/books/handbook/config/_index.adoc
index 5fd0076cc2..05dc543f50 100644
--- a/documentation/content/en/books/handbook/config/_index.adoc
+++ b/documentation/content/en/books/handbook/config/_index.adoc
@@ -15,33 +15,35 @@ tags: ["configuration", "tuning", "services", "cron", "virtual hosts", "logging"
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/config/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[config-synopsis]]
== Synopsis
@@ -329,7 +331,7 @@ They are not strictly necessary, but are useful as hints to man:rcorder[8]:
By carefully setting these keywords for each startup script, an administrator has a fine-grained level of control of the startup order of the scripts, without the need for "runlevels" used by some UNIX(R) operating systems.
Additional information can be found in man:rc[8] and man:rc.subr[8].
-Refer to link:{rc-scripting}[this article] for instructions on how to create custom man:rc[8] scripts.
+Refer to extref:{rc-scripting}[this article] for instructions on how to create custom man:rc[8] scripts.
[[configtuning-core-configuration]]
=== Managing System-Specific Configuration
diff --git a/documentation/content/en/books/handbook/cutting-edge/_index.adoc b/documentation/content/en/books/handbook/cutting-edge/_index.adoc
index c0c9684dfd..bbd2cc68f8 100644
--- a/documentation/content/en/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/en/books/handbook/cutting-edge/_index.adoc
@@ -15,33 +15,35 @@ tags: ["updating", "upgrading", "documentation", "FreeBSD-STABLE", "FreeBSD-CURR
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[updating-upgrading-synopsis]]
== Synopsis
@@ -486,13 +488,13 @@ While an up-to-date version of the FreeBSD documentation is always available on
This section describes how to use either source or the FreeBSD Ports Collection to keep a local copy of the FreeBSD documentation up-to-date.
For information on editing and submitting corrections to the documentation,
-refer to the FreeBSD Documentation Project Primer for New Contributors (link:{fdp-primer}[FreeBSD Documentation Project Primer for New Contributors]).
+refer to the FreeBSD Documentation Project Primer for New Contributors (extref:{fdp-primer}[FreeBSD Documentation Project Primer for New Contributors]).
[[updating-installed-documentation]]
=== Updating Documentation from Source
Rebuilding the FreeBSD documentation from source requires a collection of tools which are not part of the FreeBSD base system.
-The required tools can be installed following link:{fdp-primer}#overview-quick-start[these steps] from the FreeBSD Documentation Project Primer.
+The required tools can be installed following extref:{fdp-primer}[these steps, overview-quick-start] from the FreeBSD Documentation Project Primer.
Once installed, use `git` to fetch a clean copy of the documentation source:
diff --git a/documentation/content/en/books/handbook/desktop/_index.adoc b/documentation/content/en/books/handbook/desktop/_index.adoc
index 3f847e7268..d292aa1432 100644
--- a/documentation/content/en/books/handbook/desktop/_index.adoc
+++ b/documentation/content/en/books/handbook/desktop/_index.adoc
@@ -15,33 +15,35 @@ tags: ["desktop", "browsers", "firefox", "chromium", "productivity", "calligra",
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[desktop-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/disks/_index.adoc b/documentation/content/en/books/handbook/disks/_index.adoc
index 5390274807..1665227d0a 100644
--- a/documentation/content/en/books/handbook/disks/_index.adoc
+++ b/documentation/content/en/books/handbook/disks/_index.adoc
@@ -15,33 +15,35 @@ tags: ["storage", "disks", "gpart", "mount", "quotas", "encrypt", "GPT", "cdreco
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[disks-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/dtrace/_index.adoc b/documentation/content/en/books/handbook/dtrace/_index.adoc
index f73a7630d2..09375bcb9c 100644
--- a/documentation/content/en/books/handbook/dtrace/_index.adoc
+++ b/documentation/content/en/books/handbook/dtrace/_index.adoc
@@ -15,33 +15,35 @@ tags: ["DTrace", "features", "guide", "tutorial", "kldload"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/dtrace/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
-endif::[]
+:images-path: books/handbook/dtrace/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dtrace-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/eresources/_index.adoc b/documentation/content/en/books/handbook/eresources/_index.adoc
index 2466b78a14..133575692d 100644
--- a/documentation/content/en/books/handbook/eresources/_index.adoc
+++ b/documentation/content/en/books/handbook/eresources/_index.adoc
@@ -11,23 +11,40 @@ tags: ["eresources", "Websites", "Mailing Lists", "Usenet", "Newsgroups"]
[[eresources]]
= Resources on the Internet
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
The rapid pace of FreeBSD progress makes print media impractical as a means of following the latest developments.
Electronic resources are the best, if not often the only, way to stay informed of the latest advances.
@@ -60,9 +77,9 @@ _To test the ability to send email to FreeBSD lists, send a test message to {fre
Please do not send test messages to any other list.
====
-When in doubt about what list to post a question to, see link:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list].
+When in doubt about what list to post a question to, see extref:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list].
-Before posting to any list, please learn about how to best use the mailing lists, such as how to help avoid frequently-repeated discussions, by reading the link:{mailing-list-faq}[Mailing List Frequently Asked Questions] (FAQ) document.
+Before posting to any list, please learn about how to best use the mailing lists, such as how to help avoid frequently-repeated discussions, by reading the extref:{mailing-list-faq}[Mailing List Frequently Asked Questions] (FAQ) document.
Archives are kept for all of the mailing lists and can be searched using the https://www.FreeBSD.org/search/[FreeBSD World Wide Web server].
The keyword searchable archive offers an excellent way of finding answers to frequently asked questions and should be consulted before posting a question.
diff --git a/documentation/content/en/books/handbook/filesystems/_index.adoc b/documentation/content/en/books/handbook/filesystems/_index.adoc
index 56dfec03d0..950c62f43b 100644
--- a/documentation/content/en/books/handbook/filesystems/_index.adoc
+++ b/documentation/content/en/books/handbook/filesystems/_index.adoc
@@ -15,33 +15,35 @@ tags: ["filesystem", "ext2", "ext3", "ext4", "ext2fs"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/filesystems/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
-endif::[]
+:images-path: books/handbook/filesystems/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[filesystems-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/firewalls/_index.adoc b/documentation/content/en/books/handbook/firewalls/_index.adoc
index a70334c309..cb35b27e75 100644
--- a/documentation/content/en/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/en/books/handbook/firewalls/_index.adoc
@@ -15,33 +15,35 @@ tags: ["firewall", "pf", "ipfw", "ipfilter", "blacklistd", "filtering"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 31
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 31
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[firewalls-intro]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/geom/_index.adoc b/documentation/content/en/books/handbook/geom/_index.adoc
index bf334e1ca3..cb3160f1e7 100644
--- a/documentation/content/en/books/handbook/geom/_index.adoc
+++ b/documentation/content/en/books/handbook/geom/_index.adoc
@@ -15,33 +15,35 @@ tags: ["GEOM", "RAID", "RAID0", "RAID1", "RAID3", "Striping", "bsdlabel", "newfs
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[geom-synopsis]]
== Synopsis
@@ -1296,4 +1298,4 @@ In most cases, `gjournal` will fail if it is unable to create the journal, but t
Refer to man:gjournal[8] and man:tunefs[8] for more information about these commands.
It is possible to journal the boot disk of a FreeBSD system.
-Refer to the article link:{gjournal-desktop}[Implementing UFS Journaling on a Desktop PC] for detailed instructions.
+Refer to the article extref:{gjournal-desktop}[Implementing UFS Journaling on a Desktop PC] for detailed instructions.
diff --git a/documentation/content/en/books/handbook/glossary.adoc b/documentation/content/en/books/handbook/glossary.adoc
index c212640927..cbfe220111 100644
--- a/documentation/content/en/books/handbook/glossary.adoc
+++ b/documentation/content/en/books/handbook/glossary.adoc
@@ -9,16 +9,38 @@ description: FreeBSD Handbook Glossary
[[freebsd-glossary]]
= FreeBSD Glossary
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:!sectnums:
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-
-include::shared/en/urls.adoc[]
+:images-path: books/handbook/glossary/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
This glossary contains terms and acronyms used within the FreeBSD community and documentation.
@@ -144,7 +166,7 @@ FreeBSD is a descendant of the CSRG work.
[[bikeshed-glossary]]
Bikeshed Building::
A phenomenon whereby many people will give an opinion on an uncomplicated topic, whilst a complex topic receives little or no discussion.
-See the link:{faq}#bikeshed-painting[FAQ] for the origin of the term.
+See the extref:{faq}[FAQ, bikeshed-painting] for the origin of the term.
[discrete]
== C
@@ -767,7 +789,7 @@ Developers consider POLA when contemplating user-visible system changes.
[[pr-glossary]]
Problem Report::
A description of some kind of problem that has been found in either the FreeBSD source or documentation.
-See link:{problem-reports}[Writing FreeBSD Problem Reports].
+See extref:{problem-reports}[Writing FreeBSD Problem Reports].
[[pid-glossary]]
Process ID::
diff --git a/documentation/content/en/books/handbook/introduction/_index.adoc b/documentation/content/en/books/handbook/introduction/_index.adoc
index fc8c39b3b0..9a92c689b4 100644
--- a/documentation/content/en/books/handbook/introduction/_index.adoc
+++ b/documentation/content/en/books/handbook/introduction/_index.adoc
@@ -15,33 +15,35 @@ tags: ["introduction", "synopsis", "about", "Who Uses FreeBSD", "goals", "histor
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/introduction/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/introduction/
-endif::[]
+:images-path: books/handbook/introduction/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/introduction/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-synopsis]]
== Synopsis
@@ -98,7 +100,7 @@ Here is just a sampling of some of the applications in which people are currentl
* _Education:_ Are you a student of computer science or a related engineering field? There is no better way of learning about operating systems, computer architecture and networking than the hands on, under the hood experience that FreeBSD can provide. A number of freely available CAD, mathematical and graphic design packages also make it highly useful to those whose primary interest in a computer is to get _other_ work done!
* _Research:_ With source code for the entire system available, FreeBSD is an excellent platform for research in operating systems as well as other branches of computer science. FreeBSD's freely available nature also makes it possible for remote groups to collaborate on ideas or shared development without having to worry about special licensing agreements or limitations on what may be discussed in open forums.
* _Networking:_ Need a new router? A name server (DNS)? A firewall to keep people out of your internal network? FreeBSD can easily turn that unused PC sitting in the corner into an advanced router with sophisticated packet-filtering capabilities.
-* _Embedded:_ FreeBSD makes an excellent platform to build embedded systems upon. With support for the ARM(R), MIPS(R) and PowerPC(R) platforms, coupled with a robust network stack, cutting edge features and the permissive link:{faq}#bsd-license-restrictions[BSD license] FreeBSD makes an excellent foundation for building embedded routers, firewalls, and other devices.
+* _Embedded:_ FreeBSD makes an excellent platform to build embedded systems upon. With support for the ARM(R), MIPS(R) and PowerPC(R) platforms, coupled with a robust network stack, cutting edge features and the permissive extref:{faq}[BSD license, bsd-license-restrictions] FreeBSD makes an excellent foundation for building embedded routers, firewalls, and other devices.
* _Desktop:_ FreeBSD makes a fine choice for an inexpensive desktop solution using the freely available X11 server. FreeBSD offers a choice from many open-source desktop environments, including the standard GNOME and KDE graphical user interfaces. FreeBSD can even boot "diskless" from a central server, making individual workstations even cheaper and easier to administer.
* _Software Development:_ The basic FreeBSD system comes with a full suite of development tools including a full C/C++ compiler and debugger suite. Support for many other languages are also available through the ports and packages collection.
@@ -205,7 +207,7 @@ Due to the additional complexities that can evolve in the commercial use of GPL
[[development]]
=== The FreeBSD Development Model
-The development of FreeBSD is a very open and flexible process, being literally built from the contributions of thousands of people around the world, as can be seen from our link:{contributors}[list of contributors].
+The development of FreeBSD is a very open and flexible process, being literally built from the contributions of thousands of people around the world, as can be seen from our extref:{contributors}[list of contributors].
FreeBSD's development infrastructure allow these thousands of contributors to collaborate over the Internet.
We are constantly on the lookout for new developers and ideas, and those interested in becoming more closely involved with the project need simply contact us at the {freebsd-hackers}.
The {freebsd-announce} is also available to those wishing to make other FreeBSD users aware of major areas of work.
@@ -242,7 +244,7 @@ Last, but definitely not least, the largest group of developers are the users th
The primary way of keeping in touch with FreeBSD's more non-centralized development is to subscribe to the {freebsd-hackers} where such things are discussed.
See crossref:eresources[eresources, Resources on the Internet] for more information about the various FreeBSD mailing lists.
+
-link:{contributors}[The FreeBSD Contributors List] is a long and growing one, so why not join it by contributing something back to FreeBSD today?
+extref:{contributors}[The FreeBSD Contributors List] is a long and growing one, so why not join it by contributing something back to FreeBSD today?
+
Providing code is not the only way of contributing to the project; for a more complete list of things that need doing, please refer to the link:https://www.FreeBSD.org/[FreeBSD Project web site].
diff --git a/documentation/content/en/books/handbook/jails/_index.adoc b/documentation/content/en/books/handbook/jails/_index.adoc
index d278555fea..9498b977a7 100644
--- a/documentation/content/en/books/handbook/jails/_index.adoc
+++ b/documentation/content/en/books/handbook/jails/_index.adoc
@@ -15,33 +15,35 @@ tags: ["jails", "creating", "managing", "updating", "ezjail"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/jails/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
-endif::[]
+:images-path: books/handbook/jails/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[jails-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/kernelconfig/_index.adoc b/documentation/content/en/books/handbook/kernelconfig/_index.adoc
index a9031c43b0..e552442d1f 100644
--- a/documentation/content/en/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/en/books/handbook/kernelconfig/_index.adoc
@@ -15,33 +15,35 @@ tags: ["configuring", "kernel", "custom kernel", "hardware requirements", "pcico
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kernelconfig-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/l10n/_index.adoc b/documentation/content/en/books/handbook/l10n/_index.adoc
index f6ae5652f6..790ed7504e 100644
--- a/documentation/content/en/books/handbook/l10n/_index.adoc
+++ b/documentation/content/en/books/handbook/l10n/_index.adoc
@@ -15,33 +15,35 @@ tags: ["i18n", "L10n", "localization", "Locale", "LANG", "MM_CHARSET", "cap_mkdb
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/linuxemu/_index.adoc b/documentation/content/en/books/handbook/linuxemu/_index.adoc
index 48ecda76ee..2ac2a94c5c 100644
--- a/documentation/content/en/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/en/books/handbook/linuxemu/_index.adoc
@@ -15,33 +15,35 @@ tags: ["linux", "linuxulator", "emulation", "binary", "compatibility"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[linuxemu-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/mac/_index.adoc b/documentation/content/en/books/handbook/mac/_index.adoc
index 950856d6c8..da6e6a22b3 100644
--- a/documentation/content/en/books/handbook/mac/_index.adoc
+++ b/documentation/content/en/books/handbook/mac/_index.adoc
@@ -15,33 +15,35 @@ tags: ["MAC", "labels", "security", "configuration", "nagios"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/mail/_index.adoc b/documentation/content/en/books/handbook/mail/_index.adoc
index 03f363da37..2501d6229e 100644
--- a/documentation/content/en/books/handbook/mail/_index.adoc
+++ b/documentation/content/en/books/handbook/mail/_index.adoc
@@ -15,33 +15,35 @@ tags: ["mail", "sendmail", "MTA", "SMTP", "user agents", "fetchmail", "procmail"
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 29
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 29
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mail-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc
index b7b1535bf1..d0e34b7f7d 100644
--- a/documentation/content/en/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/en/books/handbook/mirrors/_index.adoc
@@ -11,23 +11,40 @@ tags: ["Obtaining", "CD", "DVD", "FTP", "Git"]
[[mirrors]]
= Obtaining FreeBSD
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mirrors-cdrom]]
== CD and DVD Sets
@@ -577,7 +594,7 @@ The GeoDNS should direct you to the nearest mirror to you.
=== For Developers
-Please see the link:{committers-guide}#git-mini-primer[Committer's Guide].
+Please see the extref:{committers-guide}[Committer's Guide, git-mini-primer].
[[external-mirrors]]
=== External mirrors
@@ -616,7 +633,7 @@ Commit messages will be sent to the following mailing lists:
- https://lists.freebsd.org/subscription/dev-commits-src-branches[dev-commits-src-branches]: All changes to all stable branches of the src repository
For more information, please refer to the "Commit message lists" section of C.2.
-"Mailing Lists" in handbook: https://docs.freebsd.org/en/books/handbook/eresources/#eresources-mail
+"Mailing Lists" in handbook: crossref:handbook/eresources[eresources-mail, Mailing lists].
[[svn]]
== Using Subversion
diff --git a/documentation/content/en/books/handbook/multimedia/_index.adoc b/documentation/content/en/books/handbook/multimedia/_index.adoc
index 753ef1d2b2..f596d07d0a 100644
--- a/documentation/content/en/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/en/books/handbook/multimedia/_index.adoc
@@ -15,33 +15,35 @@ tags: ["multimedia", "sound card", "MP3", "MythTV", "scanner", "SANE"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[multimedia-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/network-servers/_index.adoc b/documentation/content/en/books/handbook/network-servers/_index.adoc
index 1100c915eb..26eab1704e 100644
--- a/documentation/content/en/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/en/books/handbook/network-servers/_index.adoc
@@ -15,33 +15,35 @@ tags: ["network", "servers", "inetd", "NFS", "NIS", "LDAP", "DHCP", "DNS", "Apac
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 30
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 30
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[network-servers-synopsis]]
== Synopsis
@@ -1317,7 +1319,7 @@ Begin the configuration by installing package:net/openldap-server[] package or p
# pkg install openldap-server
....
-There is a large set of default options enabled in the link:{linux-users}#software[package].
+There is a large set of default options enabled in the extref:{linux-users}[package, software].
Review them by running `pkg info openldap-server`.
If they are not sufficient (for example if SQL support is needed), please consider recompiling the port using the appropriate crossref:ports[ports-using,framework].
diff --git a/documentation/content/en/books/handbook/parti.adoc b/documentation/content/en/books/handbook/parti.adoc
index 82e96af93b..dde9cad8c1 100644
--- a/documentation/content/en/books/handbook/parti.adoc
+++ b/documentation/content/en/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
next: books/handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[getting-started]]
= Getting Started
@@ -18,4 +26,4 @@ These chapters:
The number of forward references in the text have been kept to a minimum so that this section can be read from front to back with minimal page flipping.
-include::content/en/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/en/books/handbook/partii.adoc b/documentation/content/en/books/handbook/partii.adoc
index 8948169299..000f31ae04 100644
--- a/documentation/content/en/books/handbook/partii.adoc
+++ b/documentation/content/en/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
next: books/handbook/desktop
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[common-tasks]]
= Common Tasks
@@ -18,4 +26,4 @@ These chapters:
Some of these chapters recommend prior reading, and this is noted in the synopsis at the beginning of each chapter.
-include::content/en/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/en/books/handbook/partiii.adoc b/documentation/content/en/books/handbook/partiii.adoc
index c2227bc7b0..0f2fbb9da1 100644
--- a/documentation/content/en/books/handbook/partiii.adoc
+++ b/documentation/content/en/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
next: books/handbook/config
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[system-administration]]
= System Administration
@@ -14,4 +22,4 @@ and also details what the reader is expected to know before tackling the materia
These chapters are designed to be read as the information is needed.
They do not need to be read in any particular order, nor must all of them be read before beginning to use FreeBSD.
-include::content/en/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/en/books/handbook/partiv.adoc b/documentation/content/en/books/handbook/partiv.adoc
index 46ca1c5725..50ca2c7e63 100644
--- a/documentation/content/en/books/handbook/partiv.adoc
+++ b/documentation/content/en/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/usb-device-mode
next: books/handbook/serialcomms
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[network-communication]]
= Network Communication
@@ -20,4 +28,4 @@ The chapters in this part cover:
These chapters are designed to be read when the information is needed.
They do not need to be read in any particular order, nor is it necessary to read all of them before using FreeBSD in a network environment.
-include::content/en/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/en/books/handbook/partv.adoc b/documentation/content/en/books/handbook/partv.adoc
index ed0773fb7a..12efca4145 100644
--- a/documentation/content/en/books/handbook/partv.adoc
+++ b/documentation/content/en/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
next: books/handbook/mirrors
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= Appendices
-include::content/en/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/en/books/handbook/pgpkeys/_index.adoc b/documentation/content/en/books/handbook/pgpkeys/_index.adoc
index a9833f66c1..793a50de32 100644
--- a/documentation/content/en/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/en/books/handbook/pgpkeys/_index.adoc
@@ -11,28 +11,48 @@ tags: ["OpenGPG", "keys", "officers"]
[[pgpkeys]]
= OpenPGP Keys
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
The OpenPGP keys of the `FreeBSD.org` officers are shown here.
These keys can be used to verify a signature or send encrypted email to one of the officers.
-A full list of FreeBSD OpenPGP keys is available in the link:{pgpkeys}[PGP Keys] article.
+A full list of FreeBSD OpenPGP keys is available in the extref:{pgpkeys}[PGP Keys] article.
The complete keyring can be downloaded at link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
[[pgpkeys-officers]]
diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc
index d5dda2a9ab..65df8f1e26 100644
--- a/documentation/content/en/books/handbook/ports/_index.adoc
+++ b/documentation/content/en/books/handbook/ports/_index.adoc
@@ -15,33 +15,35 @@ tags: ["ports", "collection", "pkg", "poudriere", "management"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ports-synopsis]]
== Synopsis
@@ -649,7 +651,7 @@ Each port skeleton includes these files and directories:
* [.filename]#pkg-plist#: a list of all the files that will be installed by the port. It also tells the ports system which files to remove upon deinstallation.
Some ports include [.filename]#pkg-message# or other files to handle special situations.
-For more details on these files, and on ports in general, refer to the link:{porters-handbook}[FreeBSD Porter's Handbook].
+For more details on these files, and on ports in general, refer to the extref:{porters-handbook}[FreeBSD Porter's Handbook].
The port does not include the actual source code, also known as a [.filename]#distfile#.
The extract portion of building a port will automatically save the downloaded source to [.filename]#/usr/ports/distfiles#.
@@ -714,7 +716,7 @@ When using `fetch`, the `extract` or the `update` operation may be run consecuti
If more control over the ports tree is needed or if local changes need to be maintained, or if running FreeBSD-CURRENT,
Git can be used to obtain the Ports Collection.
-Refer to link:{committers-guide}#git-primer[the Git Primer] for a detailed description of Git.
+Refer to extref:{committers-guide}[the Git Primer, git-primer] for a detailed description of Git.
. Git must be installed before it can be used to check out the ports tree. If a copy of the ports tree is already present, install Git like this:
+
@@ -1325,7 +1327,7 @@ When a port does not build or install, try the following:
+
[NOTE]
====
-Some ports are not maintained by an individual but instead by a group maintainer represented by a link:{mailing-list-faq}[mailing list].
+Some ports are not maintained by an individual but instead by a group maintainer represented by a extref:{mailing-list-faq}[mailing list].
Many, but not all, of these addresses look like mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org].
Please take this into account when sending an email.
@@ -1333,6 +1335,6 @@ In particular, ports maintained by mailto:ports@FreeBSD.org[ports@FreeBSD.org] a
Instead, any fixes and support come from the general community who subscribe to that mailing list. More volunteers are always needed!
====
+
-If there is no response to the email, use Bugzilla to submit a bug report using the instructions in link:{problem-reports}[Writing FreeBSD Problem Reports].
-. Fix it! The link:{porters-handbook}[Porter's Handbook] includes detailed information on the ports infrastructure so that you can fix the occasional broken port or even submit your own!
+If there is no response to the email, use Bugzilla to submit a bug report using the instructions in extref:{problem-reports}[Writing FreeBSD Problem Reports].
+. Fix it! The extref:{porters-handbook}[Porter's Handbook] includes detailed information on the ports infrastructure so that you can fix the occasional broken port or even submit your own!
. Install the package instead of the port using the instructions in <<pkgng-intro>>.
diff --git a/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc
index 1362bcab8a..61883aabf7 100644
--- a/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc
@@ -15,33 +15,35 @@ tags: ["PPP", "PPPoE", "PPPoA", "modem"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 28
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 28
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ppp-and-slip-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/preface/_index.adoc b/documentation/content/en/books/handbook/preface/_index.adoc
index 59c14610ec..2c5b3de541 100644
--- a/documentation/content/en/books/handbook/preface/_index.adoc
+++ b/documentation/content/en/books/handbook/preface/_index.adoc
@@ -1,6 +1,6 @@
---
title: Preface
-prev: books/handbook/
+prev: books/handbook
next: books/handbook/parti
description: The FreeBSD newcomer will find that the first section of this book guides the user through the FreeBSD installation process and gently introduces the concepts and conventions that underpin UNIX
tags: ["preface", "audience", "organization", "conventions", "acknowledgments"]
@@ -15,10 +15,31 @@ tags: ["preface", "audience", "organization", "conventions", "acknowledgments"]
:icons: font
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-audience]]
== Intended Audience
diff --git a/documentation/content/en/books/handbook/printing/_index.adoc b/documentation/content/en/books/handbook/printing/_index.adoc
index e6d06d640f..cd338df982 100644
--- a/documentation/content/en/books/handbook/printing/_index.adoc
+++ b/documentation/content/en/books/handbook/printing/_index.adoc
@@ -15,33 +15,35 @@ tags: ["printing", "CUPS", "LPD", "PostScript", "PDLs", "HPLIP", "LPRng"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/printing/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Putting information on paper is a vital function, despite many attempts to eliminate it.
Printing has two basic components.
@@ -881,7 +883,7 @@ These systems offer support for other protocols or additional features.
=== CUPS (Common UNIX(R) Printing System)
CUPS is a popular printing system available on many operating systems.
-Using CUPS on FreeBSD is documented in a separate article: link:{cups}[CUPS]
+Using CUPS on FreeBSD is documented in a separate article: extref:{cups}[CUPS]
[[printing-other-hplip]]
=== HPLIP
diff --git a/documentation/content/en/books/handbook/security/_index.adoc b/documentation/content/en/books/handbook/security/_index.adoc
index 4d60f4012b..97e9eca86a 100644
--- a/documentation/content/en/books/handbook/security/_index.adoc
+++ b/documentation/content/en/books/handbook/security/_index.adoc
@@ -15,33 +15,35 @@ tags: ["security", "one-time passwords", "TCP Wrapper", "Kerberos", "OpenSSL", "
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/serialcomms/_index.adoc b/documentation/content/en/books/handbook/serialcomms/_index.adoc
index 7786405bb3..e21a935129 100644
--- a/documentation/content/en/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/en/books/handbook/serialcomms/_index.adoc
@@ -15,33 +15,35 @@ tags: ["serial", "communications", "terminal", "modem", "console"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[serial-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/usb-device-mode/_index.adoc b/documentation/content/en/books/handbook/usb-device-mode/_index.adoc
index e3e454056a..59136ab4d6 100644
--- a/documentation/content/en/books/handbook/usb-device-mode/_index.adoc
+++ b/documentation/content/en/books/handbook/usb-device-mode/_index.adoc
@@ -15,33 +15,35 @@ tags: ["OTG", "USB"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/usb-device-mode/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/usb-device-mode/
-endif::[]
+:images-path: books/handbook/usb-device-mode/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/usb-device-mode/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[usb-device-mode-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/virtualization/_index.adoc b/documentation/content/en/books/handbook/virtualization/_index.adoc
index 64be6b0f86..683b917b02 100644
--- a/documentation/content/en/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/en/books/handbook/virtualization/_index.adoc
@@ -15,33 +15,35 @@ tags: ["virtualization", "Parallels", "Virtual PC", "VMware", "VirtualBox", "bhy
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/virtualization/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
-endif::[]
+:images-path: books/handbook/virtualization/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[virtualization-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/wine/_index.adoc b/documentation/content/en/books/handbook/wine/_index.adoc
index a29ca3407b..d20e5cfc6b 100644
--- a/documentation/content/en/books/handbook/wine/_index.adoc
+++ b/documentation/content/en/books/handbook/wine/_index.adoc
@@ -15,33 +15,35 @@ tags: ["WINE", "emulation", "guide", "tutorial"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/wine/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/wine/
-endif::[]
+:images-path: books/handbook/wine/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/wine/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[wine-synopsis]]
== Synopsis
diff --git a/documentation/content/en/books/handbook/x11/_index.adoc b/documentation/content/en/books/handbook/x11/_index.adoc
index 316c82acab..95f74f66cc 100644
--- a/documentation/content/en/books/handbook/x11/_index.adoc
+++ b/documentation/content/en/books/handbook/x11/_index.adoc
@@ -15,33 +15,35 @@ tags: ["X11", "Xorg", "TrueType", "DE", "KDE", "Plasma", "Xfce", "Gnome", "XDM",
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[x11-synopsis]]
== Synopsis
@@ -1223,7 +1225,7 @@ Desktop effects can cause quite a load on the graphics card.
For an nVidia-based graphics card, the proprietary driver is required for good performance.
Users of other graphics cards can skip this section and continue with the [.filename]#xorg.conf# configuration.
-To determine which nVidia driver is needed see the link:{faq}#idp59950544[FAQ question on the subject].
+To determine which nVidia driver is needed see the extref:{faq}[FAQ question on the subject, idp59950544].
Having determined the correct driver to use for your card, installation is as simple as installing any other package.
diff --git a/documentation/content/en/books/handbook/zfs/_index.adoc b/documentation/content/en/books/handbook/zfs/_index.adoc
index f299f96726..650d70dbdc 100644
--- a/documentation/content/en/books/handbook/zfs/_index.adoc
+++ b/documentation/content/en/books/handbook/zfs/_index.adoc
@@ -15,33 +15,35 @@ tags: ["ZFS", "filesystem", "administration", "zpool", "features", "terminology"
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/zfs/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/zfs/
-endif::[]
+:images-path: books/handbook/zfs/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/zfs/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
The _Z File System_, or ZFS, is an advanced file system designed to overcome many of the major problems found in previous designs.
diff --git a/documentation/content/en/books/porters-handbook/_index.adoc b/documentation/content/en/books/porters-handbook/_index.adoc
index 717a42203a..0331ca48d2 100644
--- a/documentation/content/en/books/porters-handbook/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/_index.adoc
@@ -9,6 +9,7 @@ next: books/porters-handbook/porting-why
weight: 15
tags: ["FreeBSD Porter's Handbook", "Porting", "FreeBSD Ports Collection"]
add_single_page_link: true
+isIndex: true
---
= FreeBSD Porter's Handbook
@@ -18,9 +19,33 @@ add_single_page_link: true
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
:source-highlighter: rouge
:experimental:
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/porters-handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
'''
-include::content/en/books/porters-handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
diff --git a/documentation/content/en/books/porters-handbook/book.adoc b/documentation/content/en/books/porters-handbook/book.adoc
index 33ae149025..15cf1e9af8 100644
--- a/documentation/content/en/books/porters-handbook/book.adoc
+++ b/documentation/content/en/books/porters-handbook/book.adoc
@@ -14,46 +14,34 @@ add_split_page_link: true
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
-:chapter-signifier: Chapter
-:part-signifier: Part
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
+:book: true
+:pdf: false
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
-:chapters-path: content/en/books/porters-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/porters-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -64,21 +52,21 @@ include::{chapters-path}toc-tables.adoc[]
include::{chapters-path}toc-examples.adoc[]
-include::{chapters-path}porting-why/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}new-port/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}quick-porting/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}slow-porting/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}makefiles/_index.adoc[leveloffset=+1, lines=9..24;35..-1]
-include::{chapters-path}special/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}flavors/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}plist/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}pkg-files/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}testing/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}upgrading/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}porting-dads/_index.adoc[leveloffset=+1, lines=9..25;36..-1]
-include::{chapters-path}porting-samplem/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}order/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}keeping-up/_index.adoc[leveloffset=+1, lines=9..23;34..-1]
-include::{chapters-path}uses/_index.adoc[leveloffset=+1, lines=9..24;35..-1]
-include::{chapters-path}versions/_index.adoc[leveloffset=+1, lines=8..22;33..-1]
+include::{chapters-path}porting-why/_index.adoc[leveloffset=+1]
+include::{chapters-path}new-port/_index.adoc[leveloffset=+1]
+include::{chapters-path}quick-porting/_index.adoc[leveloffset=+1]
+include::{chapters-path}slow-porting/_index.adoc[leveloffset=+1]
+include::{chapters-path}makefiles/_index.adoc[leveloffset=+1]
+include::{chapters-path}special/_index.adoc[leveloffset=+1]
+include::{chapters-path}flavors/_index.adoc[leveloffset=+1]
+include::{chapters-path}plist/_index.adoc[leveloffset=+1]
+include::{chapters-path}pkg-files/_index.adoc[leveloffset=+1]
+include::{chapters-path}testing/_index.adoc[leveloffset=+1]
+include::{chapters-path}upgrading/_index.adoc[leveloffset=+1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
+include::{chapters-path}porting-dads/_index.adoc[leveloffset=+1]
+include::{chapters-path}porting-samplem/_index.adoc[leveloffset=+1]
+include::{chapters-path}order/_index.adoc[leveloffset=+1]
+include::{chapters-path}keeping-up/_index.adoc[leveloffset=+1]
+include::{chapters-path}uses/_index.adoc[leveloffset=+1]
+include::{chapters-path}versions/_index.adoc[leveloffset=+1]
diff --git a/documentation/content/en/books/porters-handbook/flavors/_index.adoc b/documentation/content/en/books/porters-handbook/flavors/_index.adoc
index 5ac688fdb4..06c0a73d82 100644
--- a/documentation/content/en/books/porters-handbook/flavors/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/flavors/_index.adoc
@@ -14,22 +14,35 @@ tags: ["Ports", "Flavors", "introduction", "how-to", "guide"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[flavors-intro]]
== An Introduction to Flavors
diff --git a/documentation/content/en/books/porters-handbook/keeping-up/_index.adoc b/documentation/content/en/books/porters-handbook/keeping-up/_index.adoc
index d998432c5d..195910b56e 100644
--- a/documentation/content/en/books/porters-handbook/keeping-up/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/keeping-up/_index.adoc
@@ -14,22 +14,35 @@ tags: ["keeping up", "ports", "updating", "FreshPorts"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
The FreeBSD Ports Collection is constantly changing.
Here is some information on how to keep up.
diff --git a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
index 269ee28dca..fbc0f6cd7b 100644
--- a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
@@ -14,23 +14,36 @@ tags: ["makefiles", "configuring", "naming", "versions"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
:g-plus-plus: g++
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Configuring the [.filename]#Makefile# is pretty simple, and again we suggest looking at existing examples before starting.
Also, there is a crossref:porting-samplem[porting-samplem,sample Makefile] in this handbook,
@@ -1035,7 +1048,7 @@ Read it thouroughly before proposing a new one.
Our existing practice has been to avoid creating a new physical category unless either a large number of ports would logically belong to it, or the ports that would belong to it are a logically distinct group that is of limited general interest (for instance, categories related to spoken human languages), or preferably both.
-The rationale for this is that such a change creates a link:{committers-guide}#ports[fair amount of work] for both the committers and also for all users who track changes to the Ports Collection.
+The rationale for this is that such a change creates a extref:{committers-guide}[fair amount of work, ports] for both the committers and also for all users who track changes to the Ports Collection.
In addition, proposed category changes just naturally seem to attract controversy.
(Perhaps this is because there is no clear consensus on when a category is "too big", nor whether categories should lend themselves to browsing (and thus what number of categories would be an ideal number), and so forth.)
@@ -1053,7 +1066,7 @@ Here is the procedure:
** (for extra credit, include the other files that have to change, as per the procedure in the Committer's Guide.)
. Since it affects the ports infrastructure and involves moving and patching many ports but also possibly running regression tests on the build cluster, assign the PR to the {portmgr}.
-. If that PR is approved, a committer will need to follow the rest of the procedure that is link:{committers-guide}#PORTS[outlined in the Committer's Guide].
+. If that PR is approved, a committer will need to follow the rest of the procedure that is extref:{committers-guide}[outlined in the Committer's Guide, ports].
Proposing a new virtual category is similar to the above but much less involved, since no ports will actually have to move.
In this case, the only patches to include in the PR would be those to add the new category to `CATEGORIES` of the affected ports.
@@ -2445,7 +2458,7 @@ Please do not include any descriptive text such as a real name in this entry.
That merely confuses the Ports infrastructure and most tools using it.
The maintainer is responsible for keeping the port up to date and making sure that it works correctly.
-For a detailed description of the responsibilities of a port maintainer, refer to link:{contributing}#maintain-port[The challenge for port maintainers].
+For a detailed description of the responsibilities of a port maintainer, refer to extref:{contributing}[The challenge for port maintainers, maintain-port].
[NOTE]
====
@@ -2460,7 +2473,7 @@ Some types of fixes have "blanket approval" from the {portmgr}, allowing any com
These fixes do not need approval from the maintainer.
Blanket approval for most ports applies to fixes like infrastructure changes, or trivial and _tested_ build and runtime fixes.
-The current list is available in link:{committers-guide}#ports-qa-misc-blanket-approval[Ports section of the Committer's Guide].
+The current list is available in extref:{committers-guide}[Ports section of the Committer's Guide, ports-qa-misc-blanket-approval].
====
Other changes to the port will be sent to the maintainer for review and approval before being committed.
diff --git a/documentation/content/en/books/porters-handbook/new-port/_index.adoc b/documentation/content/en/books/porters-handbook/new-port/_index.adoc
index 4c95f9ca29..aa71b6541f 100644
--- a/documentation/content/en/books/porters-handbook/new-port/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/new-port/_index.adoc
@@ -14,22 +14,35 @@ tags: ["new port", "upgrading", "guidelines", "ports"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Interested in making a new port, or upgrading existing ports? Great!
diff --git a/documentation/content/en/books/porters-handbook/order/_index.adoc b/documentation/content/en/books/porters-handbook/order/_index.adoc
index 4aab1efb39..89aa459d19 100644
--- a/documentation/content/en/books/porters-handbook/order/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/order/_index.adoc
@@ -14,22 +14,35 @@ tags: ["order", "PORTNAME", "PATCHFILES", "MAINTAINER", "LICENSE", "dependencies
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
The first sections of the [.filename]#Makefile# must always come in the same order.
This standard makes it so everyone can easily read any port without having to search for variables in a random order.
diff --git a/documentation/content/en/books/porters-handbook/pkg-files/_index.adoc b/documentation/content/en/books/porters-handbook/pkg-files/_index.adoc
index f2c8cd0bcb..bd4b1bbf97 100644
--- a/documentation/content/en/books/porters-handbook/pkg-files/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/pkg-files/_index.adoc
@@ -14,22 +14,35 @@ tags: ["pkg", "pkg-message", "UCL", "pkg-install", "pkg-deinstall"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
There are some tricks we have not mentioned yet about the [.filename]#pkg-*# files that come in handy sometimes.
diff --git a/documentation/content/en/books/porters-handbook/plist/_index.adoc b/documentation/content/en/books/porters-handbook/plist/_index.adoc
index 5063b3a9ad..4aa8bc80a5 100644
--- a/documentation/content/en/books/porters-handbook/plist/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/plist/_index.adoc
@@ -14,22 +14,35 @@ tags: ["pkg-plist", "practices", "configuration"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[plist-sub]]
== Changing pkg-plist Based on Make Variables
diff --git a/documentation/content/en/books/porters-handbook/porting-dads/_index.adoc b/documentation/content/en/books/porters-handbook/porting-dads/_index.adoc
index 669cf32f97..6d1bc0c076 100644
--- a/documentation/content/en/books/porters-handbook/porting-dads/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/porting-dads/_index.adoc
@@ -14,37 +14,50 @@ tags: ["dos", "don'ts", "porting", "ports", "guide"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
:freebsd-version: __FreeBSD_version
:freebsd: __FreeBSD__
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dads-intro]]
== Introduction
Here is a list of common dos and don'ts that are encountered during the porting process.
Check the port against this list, but also check ports in the https://bugs.FreeBSD.org/search/[PR database] that others have submitted.
-Submit any comments on ports as described in link:{contributing}#CONTRIB-GENERAL[Bug Reports and General Commentary].
+Submit any comments on ports as described in extref:{contributing}[Bug Reports and General Commentary, CONTRIB-GENERAL].
Checking ports in the PR database will both make it faster for us to commit them, and prove that you know what you are doing.
[[porting-wrkdir]]
== `WRKDIR`
-Do not write anything to files outside `WRKDIR`. `WRKDIR` is the only place that is guaranteed to be writable during the port build (see link:{handbook}#PORTS-CD[ installing ports from a CDROM] for an example of building ports from a read-only tree).
+Do not write anything to files outside `WRKDIR`. `WRKDIR` is the only place that is guaranteed to be writable during the port build (see extref:{handbook}[ installing ports from a CDROM, PORTS-CD] for an example of building ports from a read-only tree).
The [.filename]##pkg-*## files can be modified by crossref:pkg-files[pkg-names,redefining a variable] rather than overwriting the file.
[[porting-wrkdirprefix]]
diff --git a/documentation/content/en/books/porters-handbook/porting-samplem/_index.adoc b/documentation/content/en/books/porters-handbook/porting-samplem/_index.adoc
index 289bc29eab..cddfbe3600 100644
--- a/documentation/content/en/books/porters-handbook/porting-samplem/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/porting-samplem/_index.adoc
@@ -14,22 +14,35 @@ tags: ["sample", "makefile"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Here is a sample [.filename]#Makefile# that can be used to create a new port.
Make sure to remove all the extra comments (ones between brackets).
diff --git a/documentation/content/en/books/porters-handbook/porting-why/_index.adoc b/documentation/content/en/books/porters-handbook/porting-why/_index.adoc
index f756da55ac..82e815ddf2 100644
--- a/documentation/content/en/books/porters-handbook/porting-why/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/porting-why/_index.adoc
@@ -1,6 +1,6 @@
---
title: Chapter 1. Introduction
-prev: books/porters-handbook/
+prev: books/porters-handbook
next: books/porters-handbook/new-port
description: Why port a program to the FreeBSD Ports Collection
tags: ["ports", "why porting"]
@@ -14,22 +14,35 @@ tags: ["ports", "why porting"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
The FreeBSD Ports Collection is the way almost everyone installs applications ("ports") on FreeBSD.
Like everything else about FreeBSD, it is primarily a volunteer effort.
diff --git a/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc b/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc
index 9fc088a254..bc3786c42f 100644
--- a/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc
@@ -14,22 +14,35 @@ tags: ["quick porting", "guide", "port", "ports collection", "how-to"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
This section describes how to quickly create a new port.
For applications where this quick method is not adequate, the full "Slow Porting" process is described in crossref:slow-porting[slow-porting,Slow Porting].
@@ -293,7 +306,7 @@ A simple search form of the Problem Report database can be searched at https://b
To get a listing of _open_ port PRs, select _Open_ and _Ports & Packages_ in the search form, then click btn:[Search].
After looking at the new port, we will reply if necessary, and commit it to the tree.
-The submitter's name will also be added to the list of link:{contributors}#contrib-additional[Additional FreeBSD Contributors] and other files.
+The submitter's name will also be added to the list of extref:{contributors}[Additional FreeBSD Contributors, contrib-additional] and other files.
It is also possible to submit ports using a man:shar[1] file.
Using the previous example with the `oneko` port above.
diff --git a/documentation/content/en/books/porters-handbook/security/_index.adoc b/documentation/content/en/books/porters-handbook/security/_index.adoc
index 9d4f9abd20..37dd35dfa4 100644
--- a/documentation/content/en/books/porters-handbook/security/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/security/_index.adoc
@@ -14,22 +14,35 @@ tags: ["security", "porting", "ports", "VuXML"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-intro]]
== Why Security is So Important
diff --git a/documentation/content/en/books/porters-handbook/slow-porting/_index.adoc b/documentation/content/en/books/porters-handbook/slow-porting/_index.adoc
index e026c5f72d..2f579815b4 100644
--- a/documentation/content/en/books/porters-handbook/slow-porting/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/slow-porting/_index.adoc
@@ -14,22 +14,35 @@ tags: ["porting", "ports", "slow porting", "guide"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Okay, so it was not that simple, and the port required some modifications to get it to work.
In this section, we will explain, step by step, how to modify it to get it to work with the ports paradigm.
diff --git a/documentation/content/en/books/porters-handbook/special/_index.adoc b/documentation/content/en/books/porters-handbook/special/_index.adoc
index 260fb30bd0..45c69e7d3b 100644
--- a/documentation/content/en/books/porters-handbook/special/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/special/_index.adoc
@@ -14,22 +14,35 @@ tags: ["special considerations", "Handling Symbolic Links", "Bundled Libraries"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
This section explains the most common things to consider when creating a port.
@@ -4422,9 +4435,9 @@ See crossref:uses[uses-sqlite,`sqlite`] for more information.
[.filename]#rc.d# scripts are used to start services on system startup, and to give administrators a standard way of stopping, starting and restarting the service.
Ports integrate into the system [.filename]#rc.d# framework.
-Details on its usage can be found in link:{handbook}#configtuning-rcd/[the rc.d Handbook chapter].
+Details on its usage can be found in extref:{handbook}[the rc.d Handbook chapter, configtuning-rcd].
Detailed explanation of the available commands is provided in man:rc[8] and man:rc.subr[8].
-Finally, there is link:{rc-scripting}[an article] on practical aspects of [.filename]#rc.d# scripting.
+Finally, there is extref:{rc-scripting}[an article] on practical aspects of [.filename]#rc.d# scripting.
With a mythical port called _doorman_, which needs to start a _doormand_ daemon.
Add the following to the [.filename]#Makefile#:
diff --git a/documentation/content/en/books/porters-handbook/testing/_index.adoc b/documentation/content/en/books/porters-handbook/testing/_index.adoc
index 789c9a6dd0..bd0cb0de52 100644
--- a/documentation/content/en/books/porters-handbook/testing/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/testing/_index.adoc
@@ -14,22 +14,35 @@ tags: ["testing", "port", "Portclippy", "Portfmt", "Portlint", "Poudriere", "set
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[make-describe]]
== Running `make describe`
@@ -252,7 +265,7 @@ Choose a server location which is close, for example if the machine is located i
The server from where jails are installed and updated when using Subversion.
Also used for ports tree when not using man:portsnap[8].
Again, choose a nearby location.
-A list of official Subversion mirrors can be found in the link:{handbook}#svn-mirrors[FreeBSD Handbook Subversion section].
+A list of official Subversion mirrors can be found in the extref:{handbook}[FreeBSD Handbook Subversion section, svn-mirrors].
[[testing-poudriere-create-jails]]
=== Creating Poudriere Jails
diff --git a/documentation/content/en/books/porters-handbook/upgrading/_index.adoc b/documentation/content/en/books/porters-handbook/upgrading/_index.adoc
index 968b25a6ed..9dfb199496 100644
--- a/documentation/content/en/books/porters-handbook/upgrading/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/upgrading/_index.adoc
@@ -14,28 +14,41 @@ tags: ["upgrading", "port", "git"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
When a port is not the most recent version available from the authors, update the local working copy of [.filename]#/usr/ports#.
The port might have already been updated to the new version.
When working with more than a few ports, it will probably be easier to use Git to keep the whole ports collection up-to-date,
-as described in the link:{handbook}#ports-using/[Handbook].
+as described in the extref:{handbook}[Handbook, ports-using].
This will have the added benefit of tracking all the port's dependencies.
The next step is to see if there is an update already pending.
@@ -83,7 +96,7 @@ Before using it, please read [.filename]#/usr/ports/Tools/scripts/README.patchto
If the port is unmaintained, and you are actively using it, please consider volunteering to become its maintainer.
FreeBSD has over 4000 ports without maintainers, and this is an area where more volunteers are always needed.
-(For a detailed description of the responsibilities of maintainers, refer to the section in the link:{developers-handbook}#POLICIES-MAINTAINER[Developer's Handbook].)
+(For a detailed description of the responsibilities of maintainers, refer to the section in the extref:{developers-handbook}[Developer's Handbook, POLICIES-MAINTAINER].)
To submit the diff, use the https://bugs.freebsd.org/submit/[bug submit form] (product `Ports & Packages`, component `Individual Port(s)`).
Always include the category with the port name, followed by colon, and brief descripton of the issue.
@@ -91,7 +104,7 @@ Examples: `_category/portname_: _add FOO option_`; `_category/portname_: _Update
Please mention any added or deleted files in the message, as they have to be explicitly specified to man:git[1] when doing a commit.
Do not compress or encode the diff.
-Before submitting the bug, review the link:{problem-reports}#pr-writing/[ Writing the problem report] section in the Problem Reports article.
+Before submitting the bug, review the extref:{problem-reports}[Writing the problem report, pr-writing] section in the Problem Reports article.
It contains far more information about how to write useful problem reports.
[IMPORTANT]
@@ -129,7 +142,7 @@ These will be recorded in the log of the repository and this is the recommended
<.> This can be anywhere, of course. Building ports is not limited to within [.filename]#/usr/ports/#.
-<.> https://git.FreeBSD.org/[git.FreeBSD.org] is the FreeBSD public Git server. See link:{handbook}mirrors/#git-url-table[FreeBSD Git Repository URL Table] for more information.
+<.> https://git.FreeBSD.org/[git.FreeBSD.org] is the FreeBSD public Git server. See extref:{handbook}mirrors[FreeBSD Git Repository URL Table, git-url-table] for more information.
While in the port directory, make any changes that are needed.
If adding, moving, or removing a file, use `git` to track these changes:
@@ -200,7 +213,7 @@ If files have been added, moved, or removed, include the man:git[1] `add`, `mv`,
`git add` or `git rm` must be run after the patch is applied.
====
-Send the patch following the link:{problem-reports}#pr-writing/[problem report submission guidelines].
+Send the patch following the extref:{problem-reports}[problem report submission guidelines, pr-writing].
[[moved-and-updating-files]]
== UPDATING and MOVED
diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc
index f3b9fe83bc..6e9d00d041 100644
--- a/documentation/content/en/books/porters-handbook/uses/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc
@@ -14,23 +14,35 @@ tags: ["uses", "macros", "introduction", "guide"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-:c-plus-plus: c++
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[uses-intro]]
== An Introduction to `USES`
diff --git a/documentation/content/en/books/porters-handbook/versions/_index.adoc b/documentation/content/en/books/porters-handbook/versions/_index.adoc
index f525a47c0a..9a62ff8633 100644
--- a/documentation/content/en/books/porters-handbook/versions/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/versions/_index.adoc
@@ -13,22 +13,35 @@ tags: ["FreeBSD versions"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Here is a convenient list of `__FreeBSD_version` values as defined in https://cgit.freebsd.org/src/tree/sys/sys/param.h[sys/param.h]:
diff --git a/documentation/content/es/articles/bsdl-gpl/_index.adoc b/documentation/content/es/articles/bsdl-gpl/_index.adoc
index 869c882b99..3d7a692046 100644
--- a/documentation/content/es/articles/bsdl-gpl/_index.adoc
+++ b/documentation/content/es/articles/bsdl-gpl/_index.adoc
@@ -18,6 +18,27 @@ trademarks: ["freebsd", "intel", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/bsdl-gpl/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
'''
diff --git a/documentation/content/es/articles/building-products/_index.adoc b/documentation/content/es/articles/building-products/_index.adoc
index 2606833933..ae6e3b3928 100644
--- a/documentation/content/es/articles/building-products/_index.adoc
+++ b/documentation/content/es/articles/building-products/_index.adoc
@@ -21,27 +21,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/building-products/
-
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/urls.adoc[]
-:imagesdir: ../../../images/articles/building-products/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/es/mailing-lists.adoc[]
-include::../../../../shared/es/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/building-products/
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/es/mailing-lists.adoc[]
-include::../../../../shared/es/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/building-products/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -162,7 +161,7 @@ image::freebsd-organization.png[]
La resolución del conflicto es llevada a cabo por un "Core Team" de nueve miembros que es escogido entre el grupo de committers.
-FreeBSD no tiene committers "corporativos". A los committers individuales se les requiere que asuman la responsabilidad de los cambios que introducen en el código. La link:{committers-guide}[FreeBSD Committer's guide] <<ComGuide>> documenta las reglas y responsabilidades de los committers.
+FreeBSD no tiene committers "corporativos". A los committers individuales se les requiere que asuman la responsabilidad de los cambios que introducen en el código. La extref:{committers-guide}[FreeBSD Committer's guide] <<ComGuide>> documenta las reglas y responsabilidades de los committers.
El modelo de proyecto de FreeBSD se examina con detalle en <<Nik2005>>.
@@ -180,7 +179,7 @@ image::freebsd-branches.png[]
Las líneas de código se mantienen vivas mientras haya interés en ellas por parte del usuario y del desarrollador.
-Las arquitecturas se agrupan en "tiers"; Las arquitecturas _Tier 1_ están soportadas por completo por los equipos de seguridad y de ingeniería de versiones del proyecto, las arquitecturas _Tier 2_ están soportadas lo mejor posible y _Tier 3_ está compuesto de arquitecturas experimentales. La lista de link:{committers-guide}#archs[arquitecturas soportadas] es parte de la colección de documentación de FreeBSD.
+Las arquitecturas se agrupan en "tiers"; Las arquitecturas _Tier 1_ están soportadas por completo por los equipos de seguridad y de ingeniería de versiones del proyecto, las arquitecturas _Tier 2_ están soportadas lo mejor posible y _Tier 3_ está compuesto de arquitecturas experimentales. La lista de extref:{committers-guide}[arquitecturas soportadas, archs] es parte de la colección de documentación de FreeBSD.
El equipo de ingeniería de versiones publica una link:https://www.FreeBSD.org/releng/[hoja de ruta] para futuras versiones de FreeBSD en el sitio web del proyecto. Las fechas que hay en la hoja de ruta no son fechas límite; FreeBSD se libera cuando el código y la documentación están listos.
@@ -252,7 +251,7 @@ A continuación presentamos algunas de las mejores prácticas para hacer el mejo
Planificar a largo plazo::
Establecer procesos que ayuden a hacer el seguimiento del desarrollo de FreeBSD. Por ejemplo:
+
-*Seguimiento del código fuente de FreeBSD.* El proyecto hace sencillo clonar su repositorio SVN utilizando link:{committers-guide}#svn-advanced-use-setting-up-svnsync[svnsync]. Tener el histórico completo de las fuentes es útil cuando se depuran problemas complejos y ofrece un conocimiento valioso de las intenciones de los desarrolladores originales. Utiliza un sistema de control de código capaz que te permita incorporar cambios entre el código base de FreeBSD y tu propio código.
+*Seguimiento del código fuente de FreeBSD.* El proyecto hace sencillo clonar su repositorio SVN utilizando extref:{committers-guide}[svnsync, svn-advanced-use-setting-up-svnsync]. Tener el histórico completo de las fuentes es útil cuando se depuran problemas complejos y ofrece un conocimiento valioso de las intenciones de los desarrolladores originales. Utiliza un sistema de control de código capaz que te permita incorporar cambios entre el código base de FreeBSD y tu propio código.
+
<<fig-svn-blame, Listado de código fuente anotado generado con `svn blame`>> muestra una porción de un listado anotado del fichero referenciado por el registro de cambio en <fig-change-log, Un ejemplo de entrada de registro de cambios>>. El antecesor de cada línea es claramente visible. Los listados anotados que muestran el histórico de cada fichero que forma parte de FreeBSD están https://svnweb.freebsd.org/[disponibles en la web].
+
@@ -297,7 +296,7 @@ Hacer saber a la comunidad FreeBSD que tu empresa utiliza FreeBSD ayuda a mejora
Apoya a los desarrolladores de FreeBSD::
A veces el camino más directo para introducir una nueva característica en FreeBSD es apoyar al desarrollador que ya está trabajando en un problema relacionado. La ayuda puede variar desde donaciones de hardware a ayuda financiera directa. En algunos países, las donaciones al proyecto FreeBSD se benefician de exenciones fiscales. El proyecto tiene un link:https://www.FreeBSD.org/donations/[enlace de donaciones] dedicado a ayudar a los donantes. El proyecto también mantiene una página web donde los desarrolladores link:https://www.FreeBSD.org/donations/wantlist/[indican sus necesidades].
+
-Como política, el proyecto FreeBSD link:{contributors}[reconoce] en su sitio web todas las contribuciones recibidas.
+Como política, el proyecto FreeBSD extref:{contributors}[reconoce] en su sitio web todas las contribuciones recibidas.
[[conclusion]]
== Conclusión
@@ -313,19 +312,19 @@ Hemos examinado las características del proyecto FreeBSD que lo convierten en u
[[Carp1996]] [Carp1996] http://www.ietf.org/rfc/rfc1958.txt[The Architectural Principles of the Internet] B. Carpenter. The Internet Architecture Board.The Internet Architecture Board. Copyright(R) 1996.
-[[ComGuide]] [ComGuide] link:{committers-guide}[Committer's Guide] The FreeBSD Project. Copyright(R) 2005.
+[[ComGuide]] [ComGuide] extref:{committers-guide}[Committer's Guide] The FreeBSD Project. Copyright(R) 2005.
[[GoldGab2005]] [GoldGab2005] http://dreamsongs.com/IHE/IHE.html[Innovation Happens Elsewhere: Open Source as Business Strategy] Ron Goldman. Richard Gabriel. Copyright(R) 2005. Morgan-Kaufmann.
-[[Hub1994]] [Hub1994] link:{contributing}[Contributing to the FreeBSD Project] Jordan Hubbard. Copyright(R) 1994-2005. The FreeBSD Project.
+[[Hub1994]] [Hub1994] extref:{contributing}[Contributing to the FreeBSD Project] Jordan Hubbard. Copyright(R) 1994-2005. The FreeBSD Project.
[[McKu1999]] [McKu1999] http://www.usenix.org/publications/library/proceedings/usenix99/mckusick.html[Soft Updates: A Technique for Eliminating Most Synchronous Writes in the Fast Filesystem] Kirk McKusick. Gregory Ganger. Copyright(R) 1999.
[[McKu1999-1]] [McKu1999-1] http://www.oreilly.com/catalog/opensources/book/kirkmck.html[Twenty Years of Berkeley Unix: From AT&T-Owned to Freely Redistributable] Marshall Kirk McKusick. http://www.oreilly.com/catalog/opensources/book/toc.html[Open Sources: Voices from the Open Source Revolution] O'Reilly Inc.. Copyright(R) 1993.
-[[Mon2005]] [Mon2005] link:{bsdl-gpl}[Why you should use a BSD style license for your Open Source Project] Bruce Montague. The FreeBSD Project. Copyright(R) 2005.
+[[Mon2005]] [Mon2005] extref:{bsdl-gpl}[Why you should use a BSD style license for your Open Source Project] Bruce Montague. The FreeBSD Project. Copyright(R) 2005.
-[[Nik2005]] [Nik2005] link:{dev-model}[A project model for the FreeBSD Project] Niklas Saers. Copyright(R) 2005. The FreeBSD Project.
+[[Nik2005]] [Nik2005] extref:{dev-model}[A project model for the FreeBSD Project] Niklas Saers. Copyright(R) 2005. The FreeBSD Project.
[[Nor1993]] [Nor1993] http://www.norvig.com/luv-slides.ps[Tutorial on Good Lisp Programming Style] Peter Norvig. Kent Pitman. Copyright(R) 1993.
@@ -333,4 +332,4 @@ Hemos examinado las características del proyecto FreeBSD que lo convierten en u
[[Ray2004]] [Ray2004] http://www.catb.org/~esr/faqs/smart-questions.html[How to ask questions the smart way] Eric Steven Raymond. Copyright(R) 2004.
-[[RelEngDoc]] [RelEngDoc] link:{releng}[FreeBSD Release Engineering] Murray Stokely. Copyright(R) 2001. The FreeBSD Project.
+[[RelEngDoc]] [RelEngDoc] extref:{releng}[FreeBSD Release Engineering] Murray Stokely. Copyright(R) 2001. The FreeBSD Project.
diff --git a/documentation/content/es/articles/contributing/_index.adoc b/documentation/content/es/articles/contributing/_index.adoc
index 8bbca4c47c..5621b9739a 100644
--- a/documentation/content/es/articles/contributing/_index.adoc
+++ b/documentation/content/es/articles/contributing/_index.adoc
@@ -1,16 +1,10 @@
---
+title: Contribuir a FreeBSD
authors:
- -
- author: 'Jordan Hubbard'
- -
- author: 'Sam Lawrance'
- -
- author: 'Mark Linimon'
-description: 'Cómo contribuir al Proyecto FreeBSD'
-tags: ["Contributing", "FreeBSD", "Non-Programmer Tasks", "Programmer Tasks"]
-title: 'Contribuir a FreeBSD'
+ - author: Jordan Hubbard
+ - author: Sam Lawrance
+ - author: Mark Linimon
trademarks: ["freebsd", "ieee", "general"]
-weight: 15
---
= Contribuir a FreeBSD
@@ -22,20 +16,26 @@ weight: 15
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-
-ifeval::["{backend}" == "html5"]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/urls.adoc[]
+:images-path: articles/contributing/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/es/mailing-lists.adoc[]
-include::../../../../shared/es/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/es/mailing-lists.adoc[]
-include::../../../../shared/es/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -47,15 +47,15 @@ Este artículo describe las diferentes formas en que una persona u organización
toc::[]
-¿Así que quieres contribuir a FreeBSD? ¡Eso es fantástico! FreeBSD _depende_ de las contribuciones de su base de usuarios para sobrevivir. Tus contribuciones no sólo son apreciadas, son vitales para el crecimiento continuo de FreeBSD.
+¿Así que quiere contribuir a FreeBSD? ¡Genial! FreeBSD _depende_ de las contribuciones de su base de usuarios para sobrevivir. Sus contribuciones no solo son gratamente apreciadas, son vitales para que FreeBSD continúe creciendo.
El grupo de desarrolladores de FreeBSD lo componen un grupo grande y siempre creciente de gente de todas partes del mundo, de edades y áreas de experiencia técnica muy diversas. Siempre hay más trabajo pendiente que manos disponibles y siempre se agradece ayuda adicional.
-El único límite que ponemos a los voluntarios es el que su disponibilidad misma dicte. Por otra parte le pedimos que esté al tanto de lo que otros miembros de la comunidad de FreeBSD esperan de ti. Tener esto en cuenta es importante antes de decidir ser voluntario.
+El único límite que ponemos a los voluntarios es el que su disponibilidad misma dicte. Por otra parte le pedimos que esté al tanto de lo que otros miembros de la comunidad de FreeBSD esperan de usted. Tener esto en cuenta es importante antes de decidir ser voluntario.
-El proyecto FreeBSD es responsable de mantener un sistema operativo completo, en lugar de un solo kernel o unas pocas utilidades sueltas. Por lo tanto nuestra lista de tareas pendientes [.filename]#TODO# incluye una gran variedad de tareas: desde la documentación, realización de pruebas en las versiones beta, hasta el desarrollo del instalador del sistema y tareas de desarrollo del kernel altamente especializadas. Todo el mundo puede ayudar, independientemente del nivel de habilidad, en un área u otra del proyecto.
+El proyecto FreeBSD es responsable de mantener un sistema operativo completo, en lugar de un solo kernel o unas pocas utilidades sueltas. Por lo tanto nuestra lista de tareas pendientes [.filename]#TODO# incluye una gran variedad de tareas: desde la documentación, realización de pruebas en las versiones beta, hasta el desarrollo del instalador del sistema y tareas de desarrollo del kernel altamente especializadas. Todo el mundo puede ayudar, independientemente del nivel nivel de habilidad, en un área u otra del proyecto.
-Invitamos a las empresas que tengan proyectos relacionados con FreeBSD a que se pongan en contacto con nosotros. ¿Necesitan de un desarrollo concreto para hacer que su producto funcione? Estaremos encantados de escuchar sus peticiones, siempre y cuando no sean demasiado raras. ¿Está trabajando en un producto de alto valor añadido? ¡Por favor, háganoslo saber! Podemos trabajar conjuntamente en algunos aspectos del mismo. El mundo del software libre está desafiando muchas de las suposiciones existentes sobre cómo se desarrolla, vende y mantiene el software y le instamos encarecidamente a que al menos considere seriamente su uso.
+Invitamos a las empresas que tengan proyectos relacionados con FreeBSD a que se pongan en contacto con nosotros. ¿Necesitan de un desarrollo concreto para hacer que su producto funcione? Estaremos encantados de escuchar sus peticiones, siempre y cuando que no sean demasiado raras. ¿Está trabajando en un producto de alto valor añadido? ¡Por favor, háganoslo saber! Podemos trabajar conjuntamente en algunos aspectos del mismo. El mundo del software libre está desafiando muchas de las suposiciones existentes sobre cómo se desarrolla, vende y mantiene el software y le instamos encarecidamente a que al menos considere seriamente su uso.
[[contrib-what]]
== Qué se necesita
@@ -67,46 +67,46 @@ La lista de tareas y subproyectos que se muestra a continuación es una amalgama
Muchas de las personas que están involucradas en FreeBSD no son programadores. El proyecto incluye a escritores de documentación, diseñadores web y personas que dan soporte. Todo lo que estas personas necesitan para contribuir es invertir tiempo y la voluntad de aprender.
-. Lee cada cierto tiempo las FAQ y el Handbook. Si algo está mal explicado, es ambiguo, está desactualizado o es incorrecto, avísenos. Aún mejor, envíenos una solución (AsciiDoc no es difícil de aprender, pero no hay ningún problema si lo envía en texto plano).
-. Ayuda a traducir la documentación de FreeBSD a tu idioma nativo. Si la documentación para tu idioma ya existe, puedes ayudar en la traducción de documentos adicionales o verificar que las traducciones están actualizadas y son correctas. Primero echa un vistazo a link:{fdp-primer}#translations[Translations FAQ] en la Introducción a la Documentación del Proyecto FreeBSD. No te estás comprometiendo a traducir tú mismo cada uno de los documentos de FreeBSD - como voluntario, puedes hacer tanto o tan poca traducción como quieras. Una vez que alguien empieza a traducir, otros casi siempre se unen a la causa. Si sólo tienes tiempo o energía para traducir una parte de la documentación, por favor traduce las instrucciones de instalación.
-. Lee de vez en cuando (o regularmente) {freebsd-questions}. Puede ser muy satisfactorio compartir tu experiencia y ayudar a la gente a resolver sus problemas; de vez en cuanto ¡podrías aprender algo nuevo tú mismo¡ Estos foros pueden ser también una fuente de ideas sobre cosas que hay que mejorar.
+. Lea cada cierto tiempo las FAQ y el Handbook. Si algo está mal explicado, es ambiguo, está desactualizado o es incorrecto, avísenos. Aún mejor, envíenos una solución (Docbook no es difícil de aprender, pero no hay ningún problema si lo envía en ASCII).
+. Ayude a traducir la documentación de FreeBSD a su lengua materna. Si ya existe documentación en su idioma, puede ayudar a traducir otros documentos o comprobar si las traducciones están actualizadas y son correctas. Antes de nada, consulte las extref:{fdp-primer}[FAQ de las traducciones, translations] en el FreeBSD Documentation Project Primer. El hecho de traducir algo no implica la obligación de traducir todo; como voluntario, puede tanto o tan poco como desee. Una vez que alguien empieza a traducir, casi siempre se apunta alguien más. Si solo tiene tiempo o energía para traducir una parte de la documentación, por favor, traduzca las instrucciones de instalación.
+. Lea la http://lists.FreeBSD.org/mailman/listinfo/freebsd-questions[lista de correo de preguntas generales de FreeBSD] de vez en cuando (o regularmente, si es posible). Puede ser muy satisfactorio compartir su experiencia y ayudar a las personas a resolver sus problemas ¡A veces incluso puede aprender algo nuevo! Estos foros también pueden ser una fuente de ideas de cosas que puede ser mejoradas.
[[ongoing-programmer-tasks]]
=== Tareas en curso para personas que son programadores
La mayoría de las tareas aquí expuestas requieren de una considerable cantidad de tiempo, o un conocimiento profundo del kernel de FreeBSD, o ambas cosas. Sin embargo, también hay muchas tareas útiles que son ideales para "hackers de fin de semana".
-. Si utilizas FreeBSD-CURRENT y tienes una buena conexión a Internet, hay una máquina `current.FreeBSD.org` que construye una versión completa una vez al día de vez en cuando, intenta instalar la última versión y reportar cualquier fallo en el proceso.
-. Lee la {freebsd-bugs}. Podría haber un problema sobre el que podrías comentar de forma constructiva o parches que puedes probar. O podrías incluso intentar arreglar tú mismo alguno de los problemas.
-. Si sabes de alguna corrección que ha sido aplicada con éxito en -CURRENT y cuya solución no ha sido aplicada aun en -STABLE después de un período de tiempo razonable (normalmente, un par de semanas) envía, de forma educada, un mensaje al committer responsable del cambio.
+. Si usa FreeBSD-CURRENT y tiene una buena conexión a Internet, existe una máquina en `current.FreeBSD.org` que genera una release completa una vez al día--de vez en cuando, intente instalar una de estas releases e informe de cualquier problema en el proceso.
+. Lea la http://lists.FreeBSD.org/mailman/listinfo/freebsd-bugs[lista de correo de informes de problemas de FreeBSD]. Puede encontrar algún problema sobre el que hacer un comentario constructivo o sobre el que probar parches. O quizás pueda solucionar uno de los problemas usted mismo.
+. Si sabe de alguna corrección que ha sido aplicada con éxito en -CURRENT y cuya solución no ha sido aplicada aun en -STABLE después de un período de tiempo razonable (normalmente, un par de semanas) envíe, de forma educada, un mensaje al committer responsable del cambio.
. Mueva el software de terceros a [.filename]#src/contrib# en el árbol del código fuente.
-. Asegúrate de que el código en [.filename]#src/contrib# está actualizado.
-. Construye el árbol de fuentes (o sólo una parte) con los avisos extra activados y límpialos. Una lista de avisos de compilación se puede encontrar también en nuestro https://ci.freebsd.org[CI] seleccionando "LLVM/Clang Warnings".
-. Arregla warnings para ports que no marcan como obsoleto el uso de cosas como `gets()` o incluir [.filename]#malloc.h#.
-. Si has contribuido con algún port y tuviste que hacer cambios específicos para FreeBSD, envía tus parches a los autores originales (esto les hará la vida más fácil cuando lancen la próxima versión).
-. Obtén copias de estándares formales como POSIX(R). Compara el comportamiento de FreeBSD con el requerido por el estándar. Si el comportamiento difiere, en particular en casos esquina y sutiles de la especificación, envía un PR acerca de ello. Si puedes, intenta averiguar cómo arreglarlo e incluye un parche en el PR. Si crees que el estándar está equivocado, pregunta al comité del estándar para que consideren la cuestión.
-. ¡Sugiere nuevas tareas para esta lista!
+. Asegúrese de que el código de [.filename]#src/contrib# está actualizado.
+. Compile el árbol del código fuente (o solo una parte del mismo) con un nivel de depuración adicional habilitado y corrija los warnings.
+. Corrija los warnings en los ports que aún utilizan recursos obsoletos como `gets()` o que incluyan [.filename]#malloc.h#.
+. Si ha contribuido con algún port y tuvo que hacer cambios específicos para FreeBSD, envíe sus parches a los autores originales (esto les hará la vida más fácil cuando lancen la próxima versión).
+. Hágase con copias de estándares formales como POSIX(R). Compare el comportamiento de FreeBSD con el requerido por el estándar. Si el comportamiento difiere, particularmente en áreas sutiles u oscuras de la especificación, envíenos un PR al respecto. Si puede, averigüe cómo solucionarlo e incluya un parche en el PR. Si cree que el estándar es incorrecto, pídale al organismo de estándares que considere su propuesta.
+. ¡Sugiera nuevas tareas para esta lista!
-=== Trabaja en la base de datos de PR
+=== Trabaje en la base de datos de PR
-La https://bugs.FreeBSD.org/search/[lista de PR de FreeBSD] muestra todos los informes de problemas activos y las solicitudes de mejora que los usuarios de FreeBSD han enviado. La base de datos de PR incluye tanto tareas para programadores como para no programadores. Echa un vistazo a los PR abiertos y mire si alguno de ellos le interesa. Algunos pueden ser tareas muy sencillas que solo necesitan una revisión adicional para confirmar que la solución adjunta al PR es la adecuada. Otros pueden ser mucho más complejos, o incluso no incluir una solución.
+La https://bugs.FreeBSD.org/search/[lista de PR de FreeBSD] muestra todos los informes de problemas activos y las solicitudes de mejora que los usuarios de FreeBSD han enviado. La base de datos de PR incluye tanto tareas para programadores como para no programadores. Eche un vistazo a los PR abiertos y mire si alguno de ellos le interesa. Algunos pueden ser tareas muy sencillas que solo necesitan una revisión adicional para confirmar que la solución adjunta al PR es la adecuada. Otros pueden ser mucho más complejos, o incluso no incluir una solución.
-Comienza con los PRs que no han sido asignados a nadie. Si el PR ya ha sido asignado a otra persona, pero crees que puedes ayudar, envía un correo electrónico a la persona que lo tiene asignado y pregúntale si puedes colaborar; quizás ya tenga un parche listo para pruebas, o ideas adicionales que proponer.
+Comience con los PRs que no han sido asignados a nadie. Si el PR ya ha sido asignado a otra persona, pero cree que puede ayudar, envíe un correo electrónico a la persona que lo tiene asignado y pregúntele si puede colaborar; quizás ya tenga un parche listo para pruebas, o ideas adicionales que proponer.
=== Tareas en curso relacionadas con la colección de ports
La colección de ports es un trabajo que está siempre activo. Queremos ofrecer a nuestros usuarios un repositorio de software de terceros fácil de usar, actualizado y de gran calidad. Necesitamos que las personas den parte de su tiempo y esfuerzo para ayudarnos a lograr este objetivo.
-Cualquiera puede participar y hay muchas formas diferentes de hacerlo. Contribuir a la colección de ports es una forma excelente de "devolver" algo al proyecto. Si estás buscando un trabajo para realizar de forma continua o un desafío divertido para un día lluvioso ¡estaríamos encantados de que nos ayudes!
+Cualquiera puede participar y hay muchas formas diferentes de hacerlo. Contribuir a la colección de ports es una forma excelente de "devolver" algo al proyecto. Si está buscando un trabajo para realizar de forma contínua o un desafío divertido para un día lluvioso estaríamos encantados de que nos ayude.
Existen varias formas de ayudar a mantener la colección de ports actualizada y en buen funcionamiento:
-* Encuentra algún software útil y chulo y link:{porters-handbook}[crea un port] para él.
-* Hay muchos ports que no tienen mantenedor. Conviértete en mantenedor y <<adopt-port>>.
-* Si has creado o adoptado un port, considera <<maintain-port>>.
-* Cuando busques un desafío rápido piensa en <<fix-broken>>.
+* Encuentre algún software interesante o útil y extref:{porters-handbook}[cree un port].
+* Hay una gran cantidad de ports que no tienen un maintainer. Conviertase en un maintainer y <<adopt-port>>.
+* Si ha creado o adoptado un port tenga en cuenta lo <<maintain-port>>.
+* Si busca un desafío rápido, puede <<fix-broken>>.
-=== Escoge uno de los elementos de la página de ideas
+=== Escoja uno de los elementos de la página de ideas
La https://wiki.freebsd.org/IdeasPage[lista de proyectos e ideas de FreeBSD para voluntarios] también está disponible para las personas que deseen contribuir al proyecto FreeBSD. Esta lista se actualiza regularmente y contiene elementos para programadores y no programadores, así como información sobre cada proyecto.
@@ -118,57 +118,57 @@ Las contribuciones al sistema generalmente pueden catalogarse en las siguientes
[[contrib-general]]
=== Informes de errores y comentarios generales
-Una idea o sugerencia técnica de interés _general_ se debería enviar a {freebsd-hackers}. Igualmente, gente con interés en esas cosas (¡y tolerancia para _altos_ volúmenes de correo!) pueden suscribirse a {freebsd-hackers}. Mira link:{handbook}#eresources-mail[The FreeBSD Handbook] para más información acerca de ésta y otras listas de correo.
+Una idea o sugerencia técnica de interés general debe enviarse a la http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[lista de correo de discusiones técnicas de FreeBSD]. Del mismo modo, las personas interesadas en estas cosas (¡y una tolerancia para un _gran_ volumen de correo!) pueden subscribirse a la http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[lista de correo de discusiones técnicas de FreeBSD]. Consulte el extref:{handbook}eresources[Handbook de FreeBSD, eresources-mail] para obtener más información sobre esta y otras listas de correo.
-Si encuentras un fallo estás enviando un cambio específico, por favor repórtalo utilizando el https://bugs.FreeBSD.org/submit/[formulario de envío de errores]. Intenta rellenar cada uno de los campos del informe de error. A menos que excedan 65KB, incluye cualquier parche directamente en el reporte. Si el parche puede ser aplicado sobre el árbol de fuentes, pon `[PATCH]`en la sinopsis del informe. Cuando incluyas parches, _no_ utilices copiar y pegar porque copiar y pegar convierte tabuladores en espacios y los hace inutilizables. Cuando los parches son mucho mayores que 20KB, considera comprimirlos (ej. con man:gzip[1] o man:bzip2[1]) antes de subirlos.
+Si encuentra un error o quiere enviar un cambio concreto puede informar sobre él utilizando el https://bugs.FreeBSD.org/submit/[formulario de envío de errores]. Trate de rellenar cada campo del informe. Incluya el parche directamente en el informe salvo que exceda los 65KB. Si el parche es adecuado para ser añadido al árbol del código fuente incluya `[PATCH]` en la sinopsis del informe. Cuando incluya parches no utilice copiar y pegar, porque copiar y pegar transforma las tabulaciones en espacios, haciendo el parche inútil. Cuando el parche exceda los 20KB por favor comprímalo (por ejemplo, con man:gzip[1] o man:bzip2[1]) antes de enviarlo.
Tras rellenar el informe debería recibir un mensaje de confirmación junto con un número de seguimiento. Conserve este número de seguimiento para que pueda informarnos con nuevos detalles sobre el problema.
-Ver también link:{problem-reports}[este artículo] sobre cómo escribir buenos informes de error.
+Consulte también extref:{problem-reports}[este artículo] sobre cómo escribir buenos informes de problemas.
=== Cambios en la documentación
-Los cambios en la documentación son revisados por {freebsd-doc}. Por favor, mira link:{fdp-primer}[FreeBSD Documentation Project Primer] para las instrucciones completas. Envía cambios (¡incluso los pequeños son bienvenidos!) utilizando el mismo método que para cualquier otro informe de error.
+Los cambios en la documentación son revisados por los miembros de http://lists.FreeBSD.org/mailman/listinfo/freebsd-doc[la lista de correo del proyecto de documentación de FreeBSD]. Por favor, consulte el extref:{fdp-primer}[FreeBSD Documentation Project Primer] si quiere información detallada. Envíe contribuciones y cambios (¡incluso los más pequeños son bienvenidos!) utilizando el mismo método que cualquier otro informe de errores.
=== Cambios en el código fuente ya existente
-Cambios y añadidos al código fuente existente es un asunto un poco más delicado y depende mucho de cómo de desactualizado te encuentres respecto al desarrollo actual de FreeBSD. Hay una versión especial de FreeBSD en curso denominada "FreeBSD-CURRENT" que está disponible de diversas formas para la conveniencia de los desarrolladores que trabajan activamente en el sistema. Ver link:{handbook}#current-stable[The FreeBSD Handbook] para más información acerca de cómo obtener y utilizar FreeBSD-CURRENT.
+Añadir o modificar el código fuente existente es un tema delicado y depende en gran medida de lo obsoleto que esté el desarrollo actual de FreeBSD. Hay una release especial de FreeBSD conocida como "FreeBSD-CURRENT" que está disponible de varias formas para mayor comodidad de los desarrolladores que trabajan activamente en el sistema. Consulte el extref:{handbook}updating-upgrading[Handbook de FreeBSD, current-stable] para obtener más información sobre cómo obtener y usar FreeBSD-CURRENT.
-Trabajar con fuentes antiguas significa desafortunadamente que tus cambios podrían estar obsoletos o ser demasiado divergentes como para reintegrarlos fácilmente en FreeBSD. Las posibilidades de que esto suceda se pueden minimizar algo suscribiéndose a las listas freebsd-announce} y {freebsd-current}, donde tienen lugar las discusiones sobre el estado actual del sistema.
+Por desgracia trabajar con código fuente antiguo significa que a veces sus cambios podrían resultar obsoletos o diferir demasiado para hacer una reintegración en FreeBSD. Esta posibilidad puede minimizarse suscribiéndose a la http://lists.FreeBSD.org/mailman/listinfo/freebsd-announce[lista de anuncios de FreeBSD] y a la http://lists.FreeBSD.org/mailman/listinfo/freebsd-current[lista de correo FreeBSD-CURRENT], donde tienen lugar los debates sobre el estado actual del sistema.
-Asumiendo que puedes asegurarte unas fuentes actualizadas sobre la que basar tus cambios, el siguiente paso es producir un conjunto de diffs para enviárselos a los maintainers de FreeBSD. Esto se hace con el comando man:diff[1].
+Suponiendo que pueda obtener acceso a una versión lo suficientemente actualizada del código fuente del sistema sobre el que realizar sus cambios, el siguiente paso es generar los diffs para enviar a los maintainers de FreeBSD. Esto se realiza con el comando man:diff[1].
-El formato man:diff[1] preferido para enviar parches es el formato de salida unificada generado por `diff -u`.
+El formato man:diff[1] recomendado para enviar parches es el formato de salida unificado generado por el comando `diff -u`.
-[source, shell]
+[source,shell]
....
-% diff -u oldfile newfile
+% diff -u fichero-antiguo fichero-nuevo
....
o
-[source, shell]
+[source,shell]
....
-% diff -u -r -N olddir newdir
+% diff -u -r -N directorio-antiguo directorio-nuevo
....
debería generar un conjunto de diffs unificados para el archivo de origen o la jerarquía de directorios.
-Ver man:diff[1] para más información.
+Consulte el manual de man:diff[1] para obtener más información.
-Una vez que tienes un conjunto de diffs (los cuales puedes probar con el comando man:patch[1]), deberías enviarlos como un informe de error para su inclusión en FreeBSD. ¡_No envíes simplemente_ los diffs a {freebsd-hackers} o se perderán! Apreciamos enormemente tu envío (¡este es un proyecto voluntario!); debido a que estamos ocupados, quizás no podamos encargarnos de él inmediatamente pero permanecerá en la base de datos de PR hasta que lo hagamos. Señala tu envío incluyendo `[PATCH]` en la sinopsis del informe.
+Una vez que tenga el conjunto de diffs (que debería probar con el comando man:patch[1]), debe enviarlos para que sean incluídos en FreeBSD a través de un informe de error. ¡__No envíe__ los diffs a la http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[lista de correo de discusiones técnicas de FreeBSD] o se perderán! Agradecemos inmensamente su colaboración (¡este es un proyecto voluntario!). Estamos muy ocupados por la gran carga de trabajo, por lo tanto, es posible que no podamos abordarlo de inmediato, pero permanecerán en la base de datos de PR hasta que lo hagamos. Etiquete sus envíos incluyendo `[PATCH]` en la sinopsis del informe.
-Si crees que es apropiado (ej: has añadido, borrado o renombrado ficheros), empaqueta tus cambios en un fichero `tar`. Los archivos creados con man:shar[1] también son bienvenidos.
+Si lo considera oportuno (por ejemplo si ha agregado, eliminado o renombrado archivos) empaquete sus cambios en un archivo `tar`. También aceptamos los archivos creados con man:shar[1].
-Si sus cambios son delicados, por ejemplo, si no está seguro acerca de los problemas de derechos de autor que regirán su distribución en el futuro, envíelos directamente a {core-email} en lugar de enviarlo como un informe de error. El {core-email} es un grupo mucho más pequeño de gente que se encarga de muchas de las tareas diarias de administración del proyecto FreeBSD. Tenga en cuenta que este grupo también está _muy ocupado_ y, por lo tanto, solo debe enviarles correos cuando realmente sea necesario.
+Si sus cambios son delicados, por ejemplo, si no está seguro acerca de los problemas de derechos de autor que regirán su distribución en el futuro, envíelos directamente al Core Team mailto:core@FreeBSD.org[core@FreeBSD.org] en lugar de enviarlo como un informe de error. El Core Team mailto:core@FreeBSD.org[core@FreeBSD.org] es un grupo mucho más pequeño de gente que se encarga de muchas de las tareas diarias de administración del proyecto FreeBSD. Tenga en cuenta que este grupo también está _muy ocupado_ y, por lo tanto, solo debe enviarles correos cuando realmente sea necesario.
-Por favor consulta man:intro[9] y man:style[9] para más información sobre el estilo del código. Agradeceríamos si al menos fueras consciente de esta información antes de enviar código.
+Consulte los manuales de man:intro[9] y man:style[9] para obtener más información sobre el estilo de programación requerido. Agradeceríamos que tuviera esa información en cuenta antes de enviar el código.
=== Código nuevo o paquetes de gran valor añadido
-En el caso de una contribución significativa o de gran impacto, o si se trata de añadir una nueva característica importante a FreeBSD es necesario enviar los cambios comprimidos en un archivo tar o subirlos a un sitio web o FTP para que otras personas puedan acceder a ellos. Si no tiene acceso a un sitio web o FTP solicítelo en la lista de correo de FreeBSD más adecuada para que alguien busque un sitio para alojar los cambios.
+En el caso de una contribución significativa o de gran impacto, o si se trata de añadir una nueva característica importante a FreeBSD es necesario enviar los cambios comprimidos en un archivo tar o subirlos a un sitio web o FTP para que otras personas puedan acceder a ellos. Si no tiene acceso a un sitio web o FTP solicitelo en la lista de correo de FreeBSD más adecuada para que alguien busque un sitio para alojar los cambios.
-Cuando se trabaja con grandes cantidades de código, indefectiblemente surge el espinoso asunto de los copyrights. FreeBSD prefiere licencias de software libre como BSD o ISC. Licencias copyleft como GPLv2 a veces también se permiten. La lista completa se puede encontrar en la página link:https://www.FreeBSD.org/internal/software-license/[core team licensing policy].
+Cuando se trabaja con grandes cantidades de código, siempre surge el delicado tema del copyright. FreeBSD prefiere licencias de software libre como BSD o ISC. Las licencias de Copyleft como la GPLv2, a veces están permitidas. La lista completa se puede encontrar en la link:https://www.FreeBSD.org/internal/software-license/[página de policita de licencias del core team].
=== Dinero o hardware
@@ -177,55 +177,50 @@ Estamos encantados de aceptar donaciones económicas para ayudar a impulsar el p
[[donations]]
==== Donar dinero
-La https://www.freebsdfoundation.org[FreeBSD Foundation] es una fundación sin ánimo de lucro, exenta de impuestos creada para impulsar los objetivos del Proyecto FreeBSD. Como entidad 501(c)3, la Fundación está generalmente exenta de pagar impuestos federales en EE.UU. así como en el Estado de Colorado. Las donaciones a una entidad exenta de pagar impuestos normalmente se pueden deducir de la declaración de impuestos federal.
+La FreeBSD Foundation es una fundación sin ánimo de lucro, libre de impuestos, creada para impulsar los objetivos del proyecto FreeBSD. Como entidad 501(c)3, la FreeBSD Foundation está exenta del impuesto federal de la renta de los EEUU así como del Estado de Colorado. Las donaciones a una entidad exenta de impuestos suelen ser deducibles (en los EEUU).
-Las donaciones se pueden enviar en forma de cheque a:
+Las donaciones pueden enviarse mediante cheque a:
[.address]
****
-The FreeBSD Foundation + P.O. Box 20247, + Boulder, + CO 80308 + USA
+The FreeBSD Foundation +
+P.O. Box 20247, +
+Boulder, +
+CO 80308 +
+USA
****
-La FreeBSD Foundation también acepta https://www.freebsdfoundation.org/donate/[donaciones online] mediante diversas opciones de pago.
+La FreeBSD Foundation también puede aceptar donaciones via web mediante PayPal. Para hacer una donación, visite la https://www.freebsdfoundation.org[página web]. de la FreeBSD Foundation.
-Se puede encontrar más información acerca de la FreeBSD Foundation en https://people.FreeBSD.org/~jdp/foundation/announcement.html[The FreeBSD Foundation -- an Introduction]. Para contactar con la Fundación por email, escribe a mailto:info@FreeBSDFoundation.org[info@FreeBSDFoundation.org].
+Puede encontrar más información sobre la FreeBSD Foundation en https://people.FreeBSD.org/~jdp/foundation/announcement.html[The FreeBSD Foundation -- an Introduction]. Para contactar con la FreeBSD Foundation por correo electrónico, escriba a mailto:info@FreeBSDFoundation.org[info@FreeBSDFoundation.org].
==== Donar hardware
-El Proyecto FreeBSD acepta felizmente las donaciones de hardware al que se le puede encontrar un buen uso. Si estás interesado en donar hardware, por favor contacta con la link:https://www.FreeBSD.org/donations/[Oficina del Enlace de Donaciones].
+El proyecto FreeBSD acepta encantado donaciones de hardware que le resulten útiles. Si desea donar componentes de hardware por favor póngase en contacto con la link:https://www.FreeBSD.org/donations/[Donations Liaison Office].
[[ports-contributing]]
== Contribuyendo a la colección de ports
[[adopt-port]]
-=== Adopta un port que no está mantenido
+=== Adoptar un port que no está mantenido
==== Elegir un port que no esté mantenido
-Asumir el mantenimiento de ports que no están mantenidos es una forma excelente de involucrarse. Los ports que no están mantenidos solo se actualizan y arreglan cuando alguien se ofrece como voluntario para trabajar en ellos. Hay una gran cantidad de ports sin mantenimiento. Es una buena idea empezar adoptando un port que use de forma regular.
-
-Los ports que no están mantenidos tienen su `MAINTAINER` establecido a `ports@FreeBSD.org`. Una lista de ports no mantenidos y sus errores actuales e informes de error se puede ver en el http://portsmon.FreeBSD.org/portsconcordanceformaintainer.py?maintainer=ports%40FreeBSD.org[FreeBSD Ports Monitoring System].
-
-En https://portsfallout.com/fallout?port=&maintainer=ports%40FreeBSD.org[PortsFallout] se puede ver una lista de ports no mantenidos con errores.
+Asumir el mantenimiento de ports que no están matenidos es una forma excelente de involucrarse. Los ports que no están mantenidos solo se actualizan y arreglan cuando alguien se ofrece como voluntario para trabajar en ellos. Hay una gran cantidad de ports sin mantenimiento. Es una buena idea empezar adoptando un port que use de forma regular.
-Muchos ports no mantenidos pueden tener actualizaciones pendientes, esto se puede ver en el https://portscout.freebsd.org/ports@freebsd.org.html[FreeBSD Ports distfile scanner].
+Los ports que no están mantenidos tiene como `MAINTAINER` asignado `ports@FreeBSD.org`. Puede ver un listado de todos los ports sin mantenimiento, así como sus errores actuales e informes de problemas en el http://portsmon.FreeBSD.org/portsconcordanceformaintainer.py?maintainer=ports%40FreeBSD.org[FreeBSD Ports Monitoring System].
Algunos ports afectan a muchos otros debido a las dependencias y las relaciones con los ports que dependan de ellos. En general, esperamos que las personas tengan algo de experiencia antes de ofrecerse voluntariamente para mantener dichos ports.
-Puede comprobar si un port tiene o no dependencias o si otros puertos depende de él consultando el índice maestro de ports, [.filename]#INDEX#.. (El nombre del archivo varía según la versión de FreeBSD; por ejemplo, [.filename]#INDEX#. Algunos ports tienen dependencias condicionales que no están incluidas en la compilación predeterminada de [.filename]#INDEX#. Esperamos que pueda reconocer dichos ports analizando el archivo [.filename]#Makefile# de otros ports.
-
-[NOTE]
-======
-El Sistema de Monitorización de Ports de FreeBSD (portsmon) actualmente no está en funcionamiento debido a las últimas actualizaciones de Python.
-======
+Puede comprobar si un port tiene o no dependencias o si otros puertos depende de él consultando el índice maestro de ports, [.filename]#INDEX#. (El nombre del archivo varía según la versión de FreeBSD; por ejemplo, [.filename]#INDEX-8#) Algunos ports tienen dependencias condicionales que no están incluidas en la compilación predeterminada de [.filename]#INDEX#. Esperamos que pueda reconocer dichos ports analizando el archivo [.filename]#Makefile# de otros ports.
==== Cómo adoptar un port
-Primero asegúrate de que entiendes tu <<maintain-port>>. También lee el link:{porters-handbook}[Porter's Handbook]. _Por favor no te comprometas a más de lo que te sientes cómodo de manejar._
+Primero, asegúrese de de comprender cuáles serán sus <<maintain-port>>. Lea también el extref:{porters-handbook}[Handbook del Porter]. _Por favor, no se comprometa con más de lo que crea que puede manejar cómodamente._
Puede solicitar el mantenimiento de cualquier port que esté sin mantenimiento cuando lo desee. Simplemente configure el parámetro `MAINTAINER` con su propia dirección de correo electrónico y envíe un PR (informe de problemas) con el cambio. Si el port tiene errores de compilación o necesita actualizarse, es posible que desee aprovechar la oportunidad para incluir cualquier otro cambio que se requiera en ese mismo PR. Esto acelerará el proceso, ya que muchos committers no están dispuestos a asignar la responsabilidad del mantenimiento del port a alguien que no tenga un historial de trabajo con FreeBSD. La mejor forma de crear un historial de trabajo es enviando PRs corrigiendo errores de compilación o actualizando ports.
-Envíe su PR a la categoría `ports`y utilice la clase `change-request`. Un committer revisará su PR, commiteará los cambios y finalmente cerrará el PR. En algunas ocasiones, este proceso puede llevar cierto tiempo (los committers también son voluntarios :).
+Envíe su PR a la categoría `ports` y utilice la clase `change-request`. Un committer revisará su PR, commiteara los cambios y finalmente cerrará el PR. En algunas ocasiones, este proceso puede llevar cierto tiempo (los committers también son voluntarios :).
[[maintain-port]]
=== El desafío para los maintainers de un port
@@ -235,76 +230,76 @@ Esta sección le dará una visión general de por qué los ports deben manteners
[[why-maintenance]]
==== Por qué los ports requieren mantenimiento
-Crear un port es una tarea que se realiza una vez. Pero asegurar que un port esté siempre actualizado y continúe compilándose y ejecutándose correctamente requiere de un esfuerzo de mantenimiento continuo. Los Maintainers son las personas que dedican parte de su tiempo a cumplir estos objetivos.
+Crear un port es una tarea que se realiza una vez. Pero asegurar que un port esté siempre actualizado y continúe compilandose y ejecutándose correctamente requiere de un esfuerzo de mantenimiento continuo. Los Maintainers son las personas que dedican parte de su tiempo a cumplir estos objetivos.
-La razón principal por la que los ports necesitan mantenimiento es para disponga de las versiones más actualizadas y mejor software de terceros a la comunidad de FreeBSD. Un desafío adicional es mantener los ports para que continúen funcionando dentro del framework de la colección de ports a medida que este evoluciona.
+La razón principal por la que los ports necesitan mantenimiento es para disponga de las versiones más actualizadas y mejor software de terceros a la comunidad de FreeBSD. Un desafío adicional es mantener los ports para que continuen funcionando dentro del framework de la colección de ports a medida que este evoluciona.
Como maintainer deberá enfrentarse a los siguientes desafíos:
-* *Nuevas versiones de software y actualizaciones.* Las nuevas versiones y actualizaciones de software están disponibles todo el tiempo para las aplicaciones que ya han sido portadas y deben incorporarse a la colección de ports para proporcionar un software actualizado.
+* *Nuevas versiones y actualizaciones de software.* Las nuevas versiones y actualizaciones de software están disponibles todo el tiempo para las aplicaciones que ya han sido portadas, y deben incorporarse a la colección de ports para proporcionar un software actualizado.
-* *Cambios en las dependencias.* Si se realizan cambios significativos en las dependencias de tu port es posible que debas actualizarlas para que continúe funcionando correctamente.
+* *Cambios en las dependencias.* Si se realizan cambios significativos en las dependencias de su port es posible que deba actualizarlas para que continúe funcionando correctamente.
-* *Cambios que afectan a los ports dependientes.* Si otros ports dependen de un port que tú mantienes, cambios en tu port podrían requerir coordinación con otros maintainers.
+* *Cambios que afectan a los ports que dependen de los suyos.* Si otros ports depende de un port que mantiene, los cambios en su port pueden requerir que se coordine con otros maintainers.
-* *Interacción con otros usuarios, maintainers y desarrolladores.* Una parte de ser maintainer implica tener u rol de apoyo. No se espera de ti que proporciones suporte general (pero damos la bienvenida y escoges hacerlo). Lo que deberías proporcionar es un punto de coordinación para problemas específicos de FreeBSD que atañen a tus ports.
+* *Interacción con otros usuarios, maintainers y desarrolladores.* Parte de ser maintainer es asumir el rol de proporcionar soporte. No esperamos que de soporte a nivel general (pero aceptaremos gustosos si decide hacerlo). Lo que debe proporcionar es un punto de apoyo para los problemas específicos de FreeBSD que estén relacionados con sus ports.
-* *Cazar bugs.* Un port puede verse afectado por errores específicos de FreeBSD. Deberá investigar, encontrar y corregir estos errores cuando sean reportados. Es mucho mejor probar meticulosamente un port para identificar todos sus potenciales problemas antes de añadirlo a la Colección de Ports.
+* *Caza de bugs.* Un port puede verse afectado por errores específicos de FreeBSD. Deberá investigar, encontrar y corregir estos errores cuando sean reportados. Es mucho mejor probar meticulosamente un port para identificar todos sus potenciales problemas antes de añadirlo a la colección de ports.
-* *Cambios en la política y la infraestructura de ports.* Ocasionalmente, los sistemas que se utilizan para compilar los ports y paquetes se actualizan o se hace una nueva recomendación que afecta a la infraestructura. Debes tener en cuenta estos cambios en caso de que tus ports se vean afectados y requieran de una actualización.
+* *Cambios en la infraestructura y política de ports.* Ocasionalmente, los sistemas que se utilizan para compilar los ports y paquetes se actualizan o se hace una nueva recomendación que afecta a la infraestructura. Debe tener en cuenta estos cambios en caso de que sus ports se vean afectados y requieran de una actualización.
-* *Cambios en el sistema base.* FreeBSD está constantemente bajo desarrollo. Cambios en el software, librerías, el kernel o incluso cambios en las políticas pueden derivar en cambios en los requisitos de los ports.
+* *Cambios en el sistema base.* FreeBSD está en constante desarrollo. Los cambios en el software, en las bibliotecas, en el kernel o incluso los cambios en las políticas pueden hacer necesarios ciertos de cambios en los ports.
==== Responsabilidades del maintainer
-===== Mantén sus ports actualizados
+===== Mantenga sus ports actualizados
Esta sección describe el proceso a seguir para mantener sus ports actualizados.
-Esto es un resumen. Hay más información disponible acerca de cómo actualizar un port en el link:{porters-handbook}[Porter's Handbook].
+Esto es un resumen. Dispone de más información sobre la actualización de un port en el extref:{porters-handbook}[Handbook del Porter].
[.procedure]
====
-. Mantente atento a las actualizaciones
-+
-Monitoriza el desarrollo para estar al tanto de nuevas versiones, actualizaciones y correcciones de seguridad. Las listas de correo de anuncios o las páginas web de noticias son útiles para este propósito. En ocasiones los usuarios se pondrán en contacto contigo para preguntarte cuándo se actualizará tu port. Si estás ocupado con otras cosas o simplemente no puedes actualizarlo por alguna razón pregunta al usuario si puede ayudarte enviándote una actualización.
-+
+. Esté atento a las actualizaciones
++
+Monitorice el desarrollo para estar al tanto de nuevas versiones, actualizaciones y correcciones de seguridad. Las listas de correo de anuncios o las páginas web de noticias son útiles para este propósito. En ocasiones los usuarios se pondrán en contacto con usted para preguntarle cuándo se actualizará su port. Si está ocupado con otras cosas o simplemente no puede actualizarlo por alguna razón pregunte al usuario si puede ayudarlo enviándole una actualización.
++
También puede recibir un correo electrónico automatizado de `FreeBSD Ports Version Check` informándole que ya hay una nueva versión disponible del distfile de su port. En el mensaje se incluirá más información (incluido el cómo dejar de recibir los correos electrónicos en el futuro).
. Incorporar cambios
-+
-Una vez que estén disponibles incorpora los cambios en el port. Es necesario generar un parche con las diferencias entre el port original y el port actualizado.
++
+Una vez que estén disponibles incorpore los cambios en el port. Es necesario generar un parche con las diferencias entre el port original y el port actualizado.
. Revisar y probar
-+
-Revisa y prueba a fondo sus cambios:
++
+Revise y pruebe a fondo sus cambios:
-** Compila, instala y prueba tu port en tantas plataformas y arquitecturas como puedas. Es común que un port funcione en una rama o plataforma y falle en otra.
-** Asegúrate de que las dependencias de tu port están completas. El método recomendado para hacer esto es instalando tu propio tinderbox. Ver <<resources>> para más información.
+** Compile, instale y pruebe su port en tantas plataformas y arquitecturas como pueda. Es común que un port funcione en una rama o plataforma y falle en otra.
+** Asegúrese de que las dependencias de su port estén completas. La forma recomendada de hacerlo es instalando su propio tinderbox de ports. Tiene más información en la sección de <<resources>>.
** Compruebe que la lista de componentes del paquete esté actualizada. Esto implica añadir nuevos archivos y directorios, así como eliminar entradas no utilizadas.
-** Verifica tu port utilizando man:portlint[1] como guía. Ver <<resources>> para información importante acerca del uso de portlint.
-** Considera si cambios en tu port pueden provocar que otros ports se rompan. Si es el caso, coordina los cambios con los maintainers de esos ports. Esto es especialmente importante si tus cambios actualizan la versión de una librería compartida; en este caso, como mínimo, los ports dependientes necesitan incrementar su `PORTREVISION`para que sean actualizados automáticamente por las herramientas de automatización como portmaster o man:portupgrade[1].
+** Compruebe su port utilizando man:portlint[1] como guía. Consulte los <<resources>> para obtener información importante sobre el uso de portlint.
+** Tenga presente la posilidad de que los cambios en su port puedan causar que otros ports dejen de funcionar (se rompan). Si este es el caso coordine los cambios con los maintainers de esos ports. Esto cobra especial importancia si su actualización cambia la versión de la librería compartida; en este caso, como mínimo, los ports que dependan del suyo deberán aumentar de versión su `PORTREVISION` para que puedan actualizarse de forma automática con herramientas como portmaster o man:portupgrade[1].
. Enviar los cambios
-+
-Envía tu actualización mediante un PR con una explicación de los cambios y un parche que contenga las diferencias entre el port original y el actualizado. Por favor, consulta link:{problem-reports}[Writing FreeBSD Problem Reports] para más información sobre cómo escribir un PR realmente bueno.
++
+Envíe su actualización enviando un PR con una explicación de los cambios y un parque que contenga las diferencias entre el port original y el actualizado. Consulte el artículo extref:{problem-reports}[Cómo enviar informes de problemas de FreeBSD] para obtener más información sobre como escribir un PR correctamente.
+
[NOTE]
======
-Por favor no envíes un archivo man:shar[1] de todo el port; en su lugar, utiliza man:diff[1] `-ruN`. De este modo, los committers pueden ver mucho más fácilmente qué cambios se están haciendo exactamente. La sección link:{porters-handbook}#port-upgrading[Upgrading] del Porter's Handbook tiene más información.
+No envíe un archivo man:shar[1] de todo el port; en su lugar, utilice el comando man:diff[1] `-ruN`. De esta forma, los committers pueden ver más fácilmente de forma exacta qué cambios se están están realizando. Consulte la sección de extref:{porters-handbook}[actualización, port-upgrading] del Handbook del Porter para más información.
======
. Esperar
-+
-En algún momento un committer tratará tu PR. Podría llevar minutos, o podría llevar una o dos semanas - así que por favor, sé paciente. Si transcurre más tiempo, por favor busca ayuda en las listas de correo ({freebsd-ports}), IRC: #bsdports en EFNet o #freebsd-ports en Libera por ejemplo.
-. Proporciona feedback
-+
-Si un committer encuentra algún problema en tus cambios lo más probable es que se los devuelva. Una respuesta rápida ayudará a que se haga más rápido el commit. Es muy importante mantener abierto el canal de comunicación para acelerar la resolución de cualquier problema.
++
+Llegado el momento un committer se encargará de su PR. Esto puede llevar entre unos minutos y varias semanas, así que tenga paciencia.
+. Proporcione feedback
++
+Si un committer encuentra algún problema en sus cambios lo más probable es que se los devuelva. Una respuesta rápida ayudará a que se haga más rápido el commit. Es muy importante mantener abierto el canal de comunicación para acelerar la resolución de cualquier problema.
. Y para concluir
-+
-Se hará el commit con tus cambios y el port habrá sido actualizado. Después se cerrará el PR. ¡Eso es todo!
++
+Se hará el commit con sus cambios y el port habrá sido actualizado. Después se cerrará el PR. ¡Eso es todo!
====
-===== Asegúrate de que tus ports continúan compilando correctamente
+===== Asegúrese de que sus ports continuan compilando correctamente.
-Esta sección trata sobre descubrir y solucionar problemas que impiden que tus ports se compilen correctamente.
+Esta sección trata sobre descubrir y solucionar problemas que impiden que sus ports se compilen correctamente.
El proyecto FreeBSD solo garantiza que la colección de ports funcione en la rama `-STABLE`. En teoría debería poder ejecutarse la última versión de cada rama estable (ya que se espera que las ABIs no cambien) pero si funciona también en las demás ramas es aun mejor.
@@ -312,147 +307,136 @@ Dado que la mayor parte de las instalaciones de FreeBSD se ejecutan en ordenador
[NOTE]
====
-Los fallos habituales para ordenadores que no son `x86` se producen porque los programadores originales asumieron que, por ejemplo, los punteros son `int`s, o que se utilizaría una versión mas antigua del compilador gcc. Cada vez más, los autores de las aplicaciones están reescribiendo su código para eliminar estos fallos — pero si el autor no mantiene activamente su código, es posible que debas hacerlo tú mismo.
+Los fallos habituales para ordenadores que no son `x86` se producen porque los programadores originales asumieron que, por ejemplo, los punteros son `int`s, o que se utilizaría una versión mas antigua del compilador gcc. Cada vez más, los autores de las aplicaciones están reescribiendo su código para eliminar estos fallos -- pero si el autor no mantiene activamente su código, es posible que deba hacerlo usted mismo.
====
Estas son las tareas que debe realizar para garantizar que su port pueda compilarse:
[.procedure]
====
-. Mantente atento a los fallos en la compilación
-+
-Comprueba tu correo para mensajes de `pkg-fallout@FreeBSD.org` y el http://portscout.FreeBSD.org[distfiles scanner] para ver alguno de los ports que están fallando están desactualizados.
-. Recopila información
-+
-Cuando encuentres algún problema recopila información para ayudar a solucionarlo. Los errores de compilación reportados por `pkg-fallout` incluyen registros que te mostrarán dónde falló la compilación. Si un usuario te informó sobre el fallo pídele que te envíe información que puedas ayudar a identificar el problema, como por ejemplo:
+. Esté atento a los fallos en la compilación
++
+Revise su correo y busque mensajes de `pkg-fallout@FreeBSD.org` y revise el http://portscout.FreeBSD.org[distfiles scanner] para ver si alguno de los ports que mantiene y que no se está compilando está desactualizado.
+. Recopile información
++
+Cuando encuentre algún problema recopile información para ayudar a solucionarlo. Los errores de compilación reportados por `pkg-fallout` incluyen registros que le mostrarán dónde falló la compilación. Si un usuario le informó sobre el fallo pídale que le envíe información que pueda ayudar a identificar el problema, como por ejemplo:
** Logs de la compilación
** Los comandos y opciones utilizados para compilar el port (incluidas las opciones establecidas en [.filename]#/etc/make.conf#)
-** Una lista de paquetes instalados en su sistema tal como los muestra man:pkg-info[8]
-** La versión de FreeBSD que están corriendo como la muestra man:uname[1] `-a`
+** Un listado de los paquetes instalados en su sistema, por ejemplo la salida del comando man:pkg-info[8]
+** La versión de FreeBSD que está ejecutando, es decir, la salida del comando man:uname[1] `-a`
** Cuándo se actualizó por última vez su colección de ports
-** Cuándo han sido actualizados por última vez su árbol de ports y su [.filename]#INDEX#
+** Cuándo se actualizó por última vez su árbol de ports e [.filename]#INDEX#
-. Investiga y encuentra una solución
-+
-Desgraciadamente no hay un método directo que seguir para hacer esto. De todos modos, recuerda: si te atascas, ¡pide ayuda! La {freebsd-ports} es un buen lugar para empezar, y los desarrolladores del proyecto original suelen ser de mucha ayuda.
+. Investigue y encuentre una solución
++
+Lamentablemente no hay un proceso a seguir que sea sencillo. Sin embargo, recuerde que si está atascado puede pedir ayuda. La http://lists.FreeBSD.org/mailman/listinfo/freebsd-ports[lista de correo de los ports de FreeBSD] es un buen sitio para encontrarla, así como los desarrolladores originales del programa.
. Enviar los cambios
-+
-Al igual que con la actualización de un port, ahora debes incorporar los cambios, revisar, probar y enviar tus cambios en eun PR y proporcionar feedback si es necesario.
++
+Al igual que con la actualización de un port, ahora debe incorporar los cambios, revisar, probar y enviar sus cambios en eun PR y proporcionar feedback si es necesario.
. Enviar parches a los autores originales
-+
-En algunos casos necesitarás aplicar parches un port para que se ejecute en FreeBSD. Algunos autores originales (aunque no todos) aceptarán incorporar dichos parches en su código en la próxima versión. Si lo hacen esto podría ayudar a los usuarios de otros sistemas BSD y tal vez evitar duplicar esfuerzos. Como cortesía, recomendamos enviar los parches de este tipo a los autores originales.
++
+En algunos casos necesitará aplicar parches un port para que se ejecute en FreeBSD. Algunos autores originales (aunque no todos) aceptarán incorporar dichos parches en su código en la próxima versión. Si lo hacen esto podría ayudar a los usuarios de otros sistemas BSD y tal vez evitar duplicar esfuerzos. Como cortesía, recomendamos enviar los parches de este tipo a los autores originales.
====
-===== Investiga los informes de errores y PRs relacionados con tu port
+===== Investigue los informes de errores y PRs relacionados con su port
Esta sección trata sobre encontrar y corregir errores.
-Los errores específicos de FreeBSD son causados generalmente por suposiciones sobre los entornos de compilación y ejecución que no afectan a FreeBSD. Es poco probable que encuentres este tipo de problemas, pero pueden ser sutiles y difíciles de diagnosticar.
+Los errores específicos de FreeBSD son causados generalmente por suposiciones sobre los entornos de compilación y ejecución que no afectan a FreeBSD. Es poco probable que encuentre este tipo de problemas, pero pueden ser sutiles y difíciles de diagnosticar.
Estas son las tareas que debe realizar para garantizar que su port continúe funcionando según lo previsto:
[.procedure]
====
-. Responde a los informes de errores
-+
-Los errores se te pueden reportar a través de email vía la https://bugs.FreeBSD.org/search/[Base de datos de Informes de Error]. Los errores también se te pueden reportar directamente por los usuarios.
-+
-Debes responder a los PRs y otros reportes en máximo 14 días, pero trata de no demorarte tanto. Intenta responder lo antes posible, incluso si es solo para decir que necesitas más tiempo antes de empezar a trabajar en el PR.
-+
-Si no has respondido en 14 días, cualquier committer mediante un `maintainer-timeout` puede hacer commit desde un PR al que no hayas respondido.
-. Recopila información
-+
-Si la persona que informó del error no ha proporcionado una solución es tu obligación recopilar la suficiente información para proporcionar una.
-+
-Si puedes reproducir el error podrás recoger la mayor parte de la información que necesitas. Si esto no es posible solicita a la persona que reportó el error que te proporcione la siguiente información:
-
-** Una descripción detallada de sus acciones, comportamiento esperado del programa y comportamiento real
+. Responda a los informes de errores
++
+Los errores le pueden llegar por correo electrónico a través del https://bugs.FreeBSD.org/search/[sistema de informe de problemas]. Los usuarios también le pueden informar de los errores directamente.
++
+Debe responder a los PRs y otros reportes en máximo 14 días, pero trate de no demorarse tanto. Intente responder lo antes posible, incluso si es solo para decir que necesita más tiempo antes de empezar a trabajar en el PR.
++
+Si no ha respondido después de 14 días, cualquier committer puede realizar el commit de un PR al que no ha respondido utilizando la regla `maintainer-timeout`.
+. Recopile información
++
+Si la persona que informó del error no ha proporcionado una solución es su obligación recopilar la suficiente información para proporcionar una.
++
+Si puede reproducir el error podrá recoger la mayor parte de la información que necesita. Si esto no es posible solicite a la persona que reportó el error que le proporcione la siguiente información:
+
+** Una descripción detallada de sus acciones, comportamiento esperado del programa y comportamiento real.
** Una copia de los datos de entrada que producen el error
-** Información acerca de su entorno de ejecución y compilación - por ejemplo, una lista de paquetes instalados y la salida de man:env[1]
+** Información sobre su entorno de compilación y ejecución, por ejemplo, una lista de los paquetes instalados y la salida del comando man:env[1]
** Core dumps
** Stack traces
. Eliminar informes incorrectos
-+
-Algunos informes de error pueden ser incorrectos. Por ejemplo el usuario podría simplemente haber usado mal el programa, o los paquetes que tiene instalados pueden estar desactualizados y necesitan actualizarse. Algunas veces un error reportado no es específico de FreeBSD. En este caso informa del error a los desarrolladores originales del software. Si puedes corregir el error también puedes aplicar el parche al port para que se aplique antes de la próxima versión original.
++
+Algunos informes de errores pueden ser incorrectos. Por ejemplo el usuario podría simplemente haber usado mal el programa, o los paquetes que tiene instalados pueden estar desactualizados y necesitan actualizarse. Algunas veces un error reportado no es específico de FreeBSD. En este caso informe del error a los desarrolladores originales del software. Si puede corregir el error también puede aplicar el parche al port para que se aplique antes de la próxima versión original.
. Encontrar una solución
-+
-Al igual que sucede con los errores de compilación tu tarea es encontrar una solución al problema. Una vez más, ¡recuerda preguntar si te atascas!
++
+Al igual que sucede con los errores de compilación su tarea es encontrar una solución para el problema. Una vez más, tenga presente que si se atasca puede (y debe) pedir ayuda.
. Enviar o aprobar cambios
-+
-Al igual que sucede con la actualización de un port debes incorporar los cambios, revisar, probar y enviar tus cambios en un PR (o hacer un seguimiento si ya existe un PR para el problema). Si otro usuario ha enviado cambios en el PR también puedes enviar un seguimiento diciendo si apruebas o no los cambios.
++
+Al igual que sucede con la actualización de un port debe incorporar los cambios, revisar, probar y enviar sus cambios en un PR (o hacer un seguimiento si ya existe un PR para el problema). Si otro usuario ha enviado cambios en el PR también puede enviar un seguimiento diciendo si aprueba o no los cambios.
====
===== Proporcionar ayuda
-Parte de las funciones de un maintainer es proporcionar soporte, no para el software en general sino para el port y las peculiaridades y problemas específicos de FreeBSD. Los usuarios pueden contactarte con preguntas, sugerencias, problemas y parches. La mayoría de las veces serán para asuntos específicos de FreeBSD.
+Parte de las funciones de un maintainer es proporcionar soporte, no para el software en general sino para el port y las peculiaridades y problemas específicos de FreeBSD. Los usuarios pueden contactarle con preguntas, sugerencias, problemas y parches. La mayoría de las veces serán para asuntos específicos de FreeBSD.
-Puede que ocasionalmente tenga que usar sus habilidades diplomáticas y dirigir amablemente a los usuarios que buscan asistencia técnica hacia los recursos apropiados. Alguna que otra vez te encontrarás con que alguien te preguntará que por qué los `RPM`s no están actualizados o qué hay que hacer para ejecutar tal software en tal o cual distribución de Linux. Aprovecha la oportunidad para decirle que tu port está actualizado (si ese es el caso, claro). Y sugiérele que pruebe FreeBSD.
+Puede que ocasionalmente tenga que usar sus habilidades diplomáticas y dirigir amablemente a los usuarios que buscan asistencia técnica hacia los recursos apropiados. Alguna que otra vez se encontrará con que alguien le preguntará que por qué los `RPMs` no están actualizados o qué hay que hacer para ejecutar tal software en tal o cual distribución de Linux. Aproveche la oportunidad para decirle que su port está actualizado (si ese es el caso, claro). Y sugiérale que pruebe FreeBSD.
-A veces, los usuarios y desarrolladores decidirán que eres una persona ocupada cuyo tiempo es valioso y harán parte del trabajo por ti. Por ejemplo, podrían:
+A veces, los usuarios y desarrolladores decidirán que usted es una persona icupada cuyo tiempo es valioso y harán parte del trabajo por usted. Por ejemplo, podrían:
-* enviar un PR o enviarle parches para actualizar tu port
+* enviar un PR o enviarle parches para actualizar su port
* investigar y tal vez proporcionar una solución a un PR o
-* incluso enviar cambios para tu port.
+* incluso enviar cambios para su port.
-En estos casos tu obligación principal es responder rápidamente. Una vez más, el tiempo de espera para los maintainers es de 14 días. Después de este período se puede realizar el commit sin aprobación. Se han tomado la molestia de hacerlo por ti, así que por lo menos intenta responder lo más rápido posible. Hecho esto, revisa, aprueba, modifica o discute los cambios con ellos lo antes posible.
+En estos casos su obligación principal es responder rápidamente. Una vez más, el tiempo de espera para los maintainers es de 14 días. Después de este período se puede realizar el commit sin aprobación. Se han tomado la molestia de hacerlo por usted, así que por lo menos intente responder lo más rápido posible. Hecho esto, revise, apruebe, modifique o discuta los cambios con ellos lo antes posible.
Si puede hacerles saber que su contribución no cae en saco roto (y así debería ser) será posible que le ayuden en otras ocasiones más adelante :-).
[[fix-broken]]
=== Encontrar y arreglar un port roto
-Hay algunos lugares realmente buenos para encontrar un port que necesite atención.
-
-Puedes utilizar el https://bugs.freebsd.org/search[interfaz web] de la base de datos de Informes de Error para buscar y ver PRs sin resolver. La mayoría de los PRs de ports son actualizaciones, pero con una pequeña búsqueda y echando un vistazo a las sinopsis deberías ser capaz de encontrar algo interesante en lo que trabajar (la clase `sw-bug` es un buen sitio para empezar).
+Hay dos lugares realmente buenos para encontrar un port que necesite atención.
-El otro sitio es el http://portsmon.FreeBSD.org/[Sistema de Monitorización de Ports de FreeBSD]. En particular busca ports sin matener con errores de compilación y ports que están marcados como `BROKEN`.
+Puede usar la https://bugs.freebsd.org/search[interfaz web] de la base de datos de informes de problemas para buscar PRs que no están resueltos. La mayoría de los PRs relacionados con ports son actualizaciones, pero con un poco de investigación y hojeando las sinopsis debería encontrar algo interesante en lo que trabajar (la clase `sw-bug` es un buen lugar para empezar).
-https://portsfallout.com/[PortsFallout] muestra problemas con los ports recogidos de la construcción de paquetes de FreeBSD.
+El otro sitio es el http://portsmon.FreeBSD.org/[FreeBSD Ports Monitoring System]. En particular busque ports que no están mantenidos, con errores de compilación y marcados como `BROKEN`. Es totalmente correcto enviar cambios para un port que está mantenido, pero recuerde preguntar al maintainer para así saber si ya están trabajando en el problema.
-Está bien mandar cambios para un port que está mantenido, pero recuerda preguntar al mantainer en caso de que ya esté trabajando en el problema.
-
-Una vez que hayas encontrado un error o problema recopila información, investiga y arréglalo. Si ya existe un PR haz seguimiento del PR. Si no existe un PR créalo. Tus cambios serán revisados. Si son correctos serán aceptados y se hará el commit.
-
-[NOTE]
-======
-El Sistema de Monitorización de Ports de FreeBSD (portsmon) actualmente no está en funcionamiento debido a las últimas actualizaciones de Python.
-======
+Una vez que haya encontrado un error o problema recopile información, investigue y arréglelo. Si ya existe un PR haga seguimiento del PR. Si no existe un PR créelo. Sus cambios serán revisados. Si son correctos serán aceptados y se hará el commit.
[[mortal-coil]]
=== Cuándo dejarlo
-Conforme tus intereses y compromisos cambian, podrías encontrar que ya no tienes tiempo para continuar con algunas (o todas) de tus contribuciones a los ports. ¡Está bien! Por favor haznos saber si ya no utilizas un port o si ya no tienes tiempo o has perdido el interés en ser maintainer. De este modo podemos avanzar y permitir que otra gente trabaje en los problemas que existan con el port sin esperar a tu respuesta. Recuerda, FreeBSD es un proyecto voluntario, así que si mantener un port ya no es divertido, ¡probablemente es hora de permitir que otros lo hagan!
+En cualquier caso el Ports Management Team (portmgr) se reserva el derecho a revocar su estatus de maintainer si no ha mantenido activamente su port durante un cierto periodo de tiempo. Actualmente este periodo se establece en 3 meses. Es decir, que transcurran tres meses durante los que haya problemas no resueltos o actualizaciones pendientes que no hayan sido abordadas en tiempo y forma.
-En cualquier caso, el Ports Management Team (`portmgr`) se reserva el derecho a revocar tu estatus de maintainer si no has mantenido activamente su port durante un cierto periodo de tiempo. (Actualmente, este periodo se establece en 3 meses). Con esto, queremos decir que haya problemas no resueltos o actualizaciones pendientes que no hayan sido abordadas durante este periodo.
+En cualquier caso, el Ports Management Team (`portmgr`) se reserva el derecho a revocar su estatus de maintainer si no ha mantenido activamente su port durante un cierto periodo de tiempo. (Actualmente, este periodo se establece en 3 meses). Con esto, queremos decir que haya problemas no resueltos o actualizaciones pendientes que no hayan sido abordadas durante este periodo.
[[resources]]
=== Recursos para maintainers y colaboradores de los ports
-El link:{porters-handbook}[Porter's Handbook] es tu guía del autoestopista para el sistema de ports. ¡Mantenlo a mano!
-
-link:{problem-reports}[Writing FreeBSD Problem Reports] describe como formular y enviar PRs de la mejor forma. ¡En 2005 se enviaron más de once mil PRs de ports! Seguir este artículo nos ayudará a reducir el tiempo necesario para tratar tus PRs.
+El extref:{porters-handbook}[Handbook del Porter] es su guía de referencia para el sistema de ports. ¡Tengala a mano!
-La https://bugs.freebsd.org/bugzilla/query.cgi[base de datos de Informes de Error].
+El artículo extref:{problem-reports}[Cómo enviar informes de problemas de FreeBSD] describe la mejor forma de formular y enviar un PR. ¡En 2005, se enviaron más de once mil PR relacionados con los ports! Seguir este artículo nos ayudará enormemente a reducir el tiempo necesario para lidiar con sus PRs.
-El http://portsmon.FreeBSD.org/[Sistema de Monitorización de Ports de FreeBSD (portsmon)] puede mostrarte información cruzada acerca de ports como errores de construcción e informes de error. Si eres un maintainer puedes usarlo para comprobar el estado de construcción de tus ports. Como colaborador puedes utilizarlo para encontrar ports rotos o sin mantener que necesitan ser arreglados.
+La https://bugs.freebsd.org/bugzilla/query.cgi[base de datos de informes de problemas].
-El http://portscout.FreeBSD.org[Escáner de distfiles de ports de FreeBSD (portscout)] puede mostrarte tus puertos cuyos distfiles no se pueden conseguir. Puedes comprobar tus propios puertos o utilizarlo para encontrar otros ports que necesitan actualizar sus `MASTER_SITES`.
+El http://portsmon.FreeBSD.org/[FreeBSD Ports Monitoring System] puede mostrarle información con referencias cruzadas sobre los ports, como errores de compilación e informes de problemas. Si es un maintainer, puede usarlo para verificar el estado de la compilación de sus ports. Como colaborador, puede usarlo para encontrar ports rotos y sin mantenimiento que deban ser reparados.
-package:ports-mgmt/poudriere[] es la forma más rigurosa de probar un port a través del ciclo completo de instalación, empaquetado y desinstalación. La documentación se encuentra en el https://github.com/freebsd/poudriere[repositorio GitHub de poudriere]
+El http://portscout.FreeBSD.org[FreeBSD Ports distfile scanner] puede mostrarle los ports para los cuales los archivos distfiles no están disponibles. Puede usarlo para verificar sus propios ports o para encontrar ports que necesiten actualizar sus `MASTER_SITES`.
-man:portlint[1] es una aplicación que puede ser utilizada para verificar que tu port cumple con muchas de las importantes directrices funcionales y de estilo. portlint es una aplicación con una heurística simple, así que deberías utilizarla __sólo como una guía__. Si portlint sugiere cambios que no parecen razonables, consulta el link:{porters-handbook}[Porter's Handbook] o busca consejo.
+package:print/ports-mgmt/poudriere[] es la forma más completa de probar un port a través de todo el ciclo de instalación, empaquetado y desinstalación. La documentación se encuentra en el repositorio de https://github.com/freebsd/poudriere[poudriere en github].
-{freebsd-ports} es para discusiones generales relacionadas con ports. Es un buen sitio para pedir ayuda. Puedes https://lists.freebsd.org/mailman/listinfo[suscribirte, o leer y buscar en el archivo de la lista]. Leer los archivos de {freebsd-ports-bugs} y {svn-ports-head} también podría ser de interés.
+man:portlint[1] es una aplicación que permite verificar que su port cumple con muchas pautas importantes de estilo y funcionamiento. portlint es una aplicación heurística simple, por lo que __solo debe utilizarla como guía__. Si portlint sugiere cambios que parecen no tener sentido, consulte el extref:{porters-handbook}[Handbook del Porter] o pida consejo.
-https://portsfallout.com/[PortsFallout] es un sitio para ayudar en la búsqueda del https://lists.freebsd.org/archives/freebsd-pkg-fallout/[archivo de package-fallout de FreeBSD].
+La http://lists.FreeBSD.org/mailman/listinfo/freebsd-ports[lista de correo de ports de FreeBSD] está destinada a discusiones generales relacionadas con los ports. Es un buen lugar para pedir ayuda. Puede https://lists.freebsd.org/mailman/listinfo[suscribirse, leer y buscar en los archivos historicos de la lista]. También puede ser de su interés leer los archivos de la http://lists.FreeBSD.org/mailman/listinfo/freebsd-ports-bugs[lista de correo de errores en los ports de FreeBSD] y los http://lists.FreeBSD.org/mailman/listinfo/svn-ports-head[mensajes de commit en el árbol del código fuente de los ports de la rama head/].
[[ideas-contributing]]
== Empezar en otras áreas
-¿Buscas algo interesante para empezar que no haya sido mencionado en el artículo? El proyecto FreeBSD tiene varias páginas en la wiki que contienen áreas dentro de las cuales las nuevas personas que tengan interés en contribuir pueden obtener ideas sobre cómo empezar.
+¿Busca algo interesante para empezar que no haya sido mencionado en el artículo? El proyecto FreeBSD tiene varias páginas en la wiki que contienen áreas dentro de las cuales las nuevas personas que tengan interes en contribuir pueden obtener ideas sobre cómo empezar.
-La página https://wiki.freebsd.org/JuniorJobs[Junior Jobs] tiene una lista de proyectos que podrían ser de interés para gente que está empezando con FreeBSD y quiere trabajar en cosas interesantes para introducirse.
+La página https://wiki.freebsd.org/JuniorJobs[Junior Jobs] tiene una lista de proyectos que pueden ser de interés para las personas que acaban de empezar a usar FreeBSD y desean trabajar en cosas interesantes por primera vez.
-La página https://wiki.freebsd.org/IdeasPage[Ideas Page] contiene varias cosas que "sería bueno tener" o "interesantes" para trabajar en el Proyecto.
+La https://wiki.freebsd.org/IdeasPage[Ideas Page] contiene propuestas sobre cosas que "sería bueno tener" o son "interesantes" para trabajar en el proyecto.
diff --git a/documentation/content/es/articles/contributors/_index.adoc b/documentation/content/es/articles/contributors/_index.adoc
index 3c3de409b2..7c2a59fe56 100644
--- a/documentation/content/es/articles/contributors/_index.adoc
+++ b/documentation/content/es/articles/contributors/_index.adoc
@@ -11,25 +11,31 @@ trademarks: ["freebsd", "sun", "general"]
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:sectnumlevels: 6
+:images-path: articles/contributors/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/es/urls.adoc[]
-:include-path: content/es/articles/contributors/
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+:include-path: content/{{% lang %}}/articles/contributors/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/es/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
:include-path:
endif::[]
+endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/es/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
:include-path:
endif::[]
@@ -106,7 +112,7 @@ Las siguientes personas y empresas han contribuido generosamente con hardware pa
* _Colaboradores especiales:_
-** http://www.osd.bsdi.com/[BSDi] (anteriormente Walnut Creek CDROM) ha donado más de lo que podemos decir (vea la sección 'Acerca del Proyecto FreeBSD' del link:{handbook}[FreeBSD Handbook] para más detalles). En concreto, nos gustaría agradecerles por el hardware original usado para `freefall.FreeBSD.org`, nuestra principal máquina d desarrollo, y por `thud.FreeBSD.org`, una máquina de testeo y construcción. También estamos en deuda con ellos por financiar a varios colaboradores durante años y por proporcionarnos acceso sin restricciones a su conexión T1 de acceso a Internet.
+** http://www.osd.bsdi.com/[BSDi] (anteriormente Walnut Creek CDROM) ha donado más de lo que podemos decir (vea la sección 'Acerca del Proyecto FreeBSD' del extref:{handbook}[FreeBSD Handbook] para más detalles). En concreto, nos gustaría agradecerles por el hardware original usado para `freefall.FreeBSD.org`, nuestra principal máquina d desarrollo, y por `thud.FreeBSD.org`, una máquina de testeo y construcción. También estamos en deuda con ellos por financiar a varios colaboradores durante años y por proporcionarnos acceso sin restricciones a su conexión T1 de acceso a Internet.
** El http://www.interface-business.de/[interface business GmbH, Dresden] ha apoyado pacientemente a {joerg} que a menudo ha preferido trabajar en FreeBSD antes que trabajar cobrando, y solía utilizar su conexión a Internet EUnet (bastante cara) cuando su conexión privada se volvía muy lenta o fallona como para trabajar con ella...
** http://www.bsdi.com/[Berkeley Software Design, Inc.] ha proporcionado su código de emulación DOS al resto del mundo BSD, el cual es usado en el comando _doscmd_.
@@ -117,7 +123,7 @@ Estas son las personas que tienen derechos de commit y realizan el trabajo de in
(en orden alfabético por apellido):
-include::content/en/articles/contributors/contrib-committers.adoc[]
+include::{include-path}contrib-committers.adoc[]
[[contrib-corealumni]]
== Antiguos miembros del core team
@@ -126,7 +132,7 @@ Las siguientes personas fueron miembros del core team de FreeBSD durante los per
_En orden cronológico inverso aproximado:_
-include::content/en/articles/contributors/contrib-corealumni.adoc[]
+include::{include-path}contrib-corealumni.adoc[]
[[contrib-develalumni]]
== Antiguos miembros del equipo de desarrollo
@@ -135,7 +141,7 @@ Las siguientes personas fueron miembros del equipo de desarrollo de FreeBSD dura
_En orden cronológico inverso aproximado:_
-include::content/en/articles/contributors/contrib-develalumni.adoc[]
+include::{include-path}contrib-develalumni.adoc[]
[[contrib-portmgralumni]]
== Antiguos miembros del equipo de gestión de Ports
@@ -144,7 +150,7 @@ Las siguientes personas fueron miembros del equipo portmgr de FreeBSD durante lo
_En orden cronológico inverso aproximado:_
-include::content/en/articles/contributors/contrib-portmgralumni.adoc[]
+include::{include-path}contrib-portmgralumni.adoc[]
[[contrib-develinmemoriam]]
== Equipo de desarrollo: en homenaje
@@ -167,11 +173,11 @@ Hay partes de NetBSD y OpenBSD que también se han integrado en FreeBSD, y nos g
(en orden alfabético por nombre):
-include::content/en/articles/contributors/contrib-additional.adoc[]
+include::{include-path}contrib-additional.adoc[]
[[contrib-386bsd]]
== Colaboradores del 386BSD Patch Kit
(en orden alfabético por nombre):
-include::content/en/articles/contributors/contrib-386bsd.adoc[]
+include::{include-path}contrib-386bsd.adoc[]
diff --git a/documentation/content/es/articles/contributors/_index.po b/documentation/content/es/articles/contributors/_index.po
index d289495773..218715762f 100644
--- a/documentation/content/es/articles/contributors/_index.po
+++ b/documentation/content/es/articles/contributors/_index.po
@@ -447,7 +447,7 @@ msgstr "_Colaboradores especiales:_"
msgid ""
"http://www.osd.bsdi.com/[BSDi] (formerly Walnut Creek CDROM) has donated "
"almost more than we can say (see the 'About the FreeBSD Project' section of "
-"the link:{handbook}[FreeBSD Handbook] for more details). In particular, we "
+"the extref:{handbook}[FreeBSD Handbook] for more details). In particular, we "
"would like to thank them for the original hardware used for `freefall."
"FreeBSD.org`, our primary development machine, and for `thud.FreeBSD.org`, a "
"testing and build box. We are also indebted to them for funding various "
@@ -456,7 +456,7 @@ msgid ""
msgstr ""
"http://www.osd.bsdi.com/[BSDi] (anteriormente Walnut Creek CDROM) ha donado "
"más de lo que podemos decir (vea la sección 'Acerca del Proyecto FreeBSD' "
-"del link:{handbook}[FreeBSD Handbook] para más detalles). En concreto, nos "
+"del extref:{handbook}[FreeBSD Handbook] para más detalles). En concreto, nos "
"gustaría agradecerles por el hardware original usado para `freefall.FreeBSD."
"org`, nuestra principal máquina d desarrollo, y por `thud.FreeBSD.org`, una "
"máquina de testeo y construcción. También estamos en deuda con ellos por "
diff --git a/documentation/content/es/articles/contributors/contrib-386bsd.adoc b/documentation/content/es/articles/contributors/contrib-386bsd.adoc
new file mode 100644
index 0000000000..0aa8ef1036
--- /dev/null
+++ b/documentation/content/es/articles/contributors/contrib-386bsd.adoc
@@ -0,0 +1,95 @@
+* Adam Glass mailto:glass@postgres.berkeley.edu[glass@postgres.berkeley.edu]
+* Adrian Hall mailto:ahall@mirapoint.com[ahall@mirapoint.com]
+* Andrey A. Chernov mailto:ache@astral.msk.su[ache@astral.msk.su]
+* Andrew Gerweck mailto:andy@gerweck.dynup.net[andy@gerweck.dynup.net]
+* Andrew Herbert mailto:andrew@werple.apana.org.au[andrew@werple.apana.org.au]
+* Andrew Moore mailto:alm@netcom.com[alm@netcom.com]
+* Andy Valencia mailto:ajv@csd.mot.com[ajv@csd.mot.com]mailto:jtk@netcom.com[jtk@netcom.com]
+* Arne Henrik Juul mailto:arnej@Lise.Unit.NO[arnej@Lise.Unit.NO]
+* Bakul Shah mailto:bvs@bitblocks.com[bvs@bitblocks.com]
+* Barry Irwin mailto:bvi@moria.org[bvi@moria.org]
+* Barry Lustig mailto:barry@ictv.com[barry@ictv.com]
+* Bob Wilcox mailto:bob@obiwan.uucp[bob@obiwan.uucp]
+* Branko Lankester
+* Brett Lymn mailto:blymn@mulga.awadi.com.AU[blymn@mulga.awadi.com.AU]
+* Charles Hannum mailto:mycroft@ai.mit.edu[mycroft@ai.mit.edu]
+* Chris G. Demetriou mailto:cgd@postgres.berkeley.edu[cgd@postgres.berkeley.edu]
+* Chris Torek mailto:torek@ee.lbl.gov[torek@ee.lbl.gov]
+* Christoph Robitschko mailto:chmr@edvz.tu-graz.ac.at[chmr@edvz.tu-graz.ac.at]
+* Daniel Poirot mailto:poirot@aio.jsc.nasa.gov[poirot@aio.jsc.nasa.gov]
+* Dave Burgess mailto:burgess@hrd769.brooks.af.mil[burgess@hrd769.brooks.af.mil]
+* Dave Rivers mailto:rivers@ponds.uucp[rivers@ponds.uucp]
+* David Dawes mailto:dawes@physics.su.OZ.AU[dawes@physics.su.OZ.AU]
+* David Greenman mailto:dg@Root.COM[dg@Root.COM]
+* Eric J. Haug mailto:ejh@slustl.slu.edu[ejh@slustl.slu.edu]
+* Felix Gaehtgens mailto:felix@escape.vsse.in-berlin.de[felix@escape.vsse.in-berlin.de]
+* Frank Maclachlan mailto:fpm@crash.cts.com[fpm@crash.cts.com]
+* Gary A. Browning mailto:gab10@griffcd.amdahl.com[gab10@griffcd.amdahl.com]
+* Gary Howland mailto:gary@hotlava.com[gary@hotlava.com]
+* Geoff Rehmet mailto:csgr@alpha.ru.ac.za[csgr@alpha.ru.ac.za]
+* Goran Hammarback mailto:goran@astro.uu.se[goran@astro.uu.se]
+* Guido van Rooij mailto:guido@gvr.org[guido@gvr.org]
+* Guy Antony Halse mailto:guy@rucus.ru.ac.za[guy@rucus.ru.ac.za]
+* Guy Harris mailto:guy@auspex.com[guy@auspex.com]
+* Havard Eidnes mailto:Havard.Eidnes@runit.sintef.no[Havard.Eidnes@runit.sintef.no]
+* Herb Peyerl mailto:hpeyerl@novatel.cuc.ab.ca[hpeyerl@novatel.cuc.ab.ca]
+* Holger Veit mailto:Holger.Veit@gmd.de[Holger.Veit@gmd.de]
+* Ishii Masahiro, R. Kym Horsell
+* J.T. Conklin mailto:jtc@cygnus.com[jtc@cygnus.com]
+* Jagane D Sundar mailto:jagane@netcom.com[jagane@netcom.com]
+* James Clark mailto:jjc@jclark.com[jjc@jclark.com]
+* James Jegers mailto:jimj@miller.cs.uwm.edu[jimj@miller.cs.uwm.edu]
+* James W. Dolter
+* James da Silva mailto:jds@cs.umd.edu[jds@cs.umd.edu] et al
+* Jay Fenlason mailto:hack@datacube.com[hack@datacube.com]
+* Jim Wilson mailto:wilson@moria.cygnus.com[wilson@moria.cygnus.com]
+* Jörg Lohse mailto:lohse@tech7.informatik.uni-hamburg.de[lohse@tech7.informatik.uni-hamburg.de]
+* Jörg Wunsch mailto:joerg_wunsch@uriah.heep.sax.de[joerg_wunsch@uriah.heep.sax.de]
+* John Dyson
+* John Woods mailto:jfw@eddie.mit.edu[jfw@eddie.mit.edu]
+* Jordan K. Hubbard mailto:jkh@whisker.hubbard.ie[jkh@whisker.hubbard.ie]
+* Julian Elischer mailto:julian@dialix.oz.au[julian@dialix.oz.au]
+* Karl Dietz mailto:Karl.Dietz@triplan.com[Karl.Dietz@triplan.com]
+* Karl Lehenbauer mailto:karl@NeoSoft.com[karl@NeoSoft.com]mailto:karl@one.neosoft.com[karl@one.neosoft.com]
+* Keith Bostic mailto:bostic@toe.CS.Berkeley.EDU[bostic@toe.CS.Berkeley.EDU]
+* Ken Hughes
+* Kent Talarico mailto:kent@shipwreck.tsoft.net[kent@shipwreck.tsoft.net]
+* Kevin Lahey mailto:kml%rokkaku.UUCP@mathcs.emory.edu[kml%rokkaku.UUCP@mathcs.emory.edu]mailto:kml@mosquito.cis.ufl.edu[kml@mosquito.cis.ufl.edu]
+* Konstantinos Konstantinidis mailto:kkonstan@duth.gr[kkonstan@duth.gr]
+* Marc Frajola mailto:marc@dev.com[marc@dev.com]
+* Mark Tinguely mailto:tinguely@plains.nodak.edu[tinguely@plains.nodak.edu]mailto:tinguely@hookie.cs.ndsu.NoDak.edu[tinguely@hookie.cs.ndsu.NoDak.edu]
+* Martin Renters mailto:martin@tdc.on.ca[martin@tdc.on.ca]
+* Michael Clay mailto:mclay@weareb.org[mclay@weareb.org]
+* Michael Galassi mailto:nerd@percival.rain.com[nerd@percival.rain.com]
+* Mike Durkin mailto:mdurkin@tsoft.sf-bay.org[mdurkin@tsoft.sf-bay.org]
+* Naoki Hamada mailto:nao@tom-yam.or.jp[nao@tom-yam.or.jp]
+* Nate Williams mailto:nate@bsd.coe.montana.edu[nate@bsd.coe.montana.edu]
+* Nick Handel mailto:nhandel@NeoSoft.com[nhandel@NeoSoft.com]mailto:nick@madhouse.neosoft.com[nick@madhouse.neosoft.com]
+* Pace Willisson mailto:pace@blitz.com[pace@blitz.com]
+* Paul Kranenburg mailto:pk@cs.few.eur.nl[pk@cs.few.eur.nl]
+* Paul Mackerras mailto:paulus@cs.anu.edu.au[paulus@cs.anu.edu.au]
+* Paul Popelka mailto:paulp@uts.amdahl.com[paulp@uts.amdahl.com]
+* Peter da Silva mailto:peter@NeoSoft.com[peter@NeoSoft.com]
+* Phil Sutherland mailto:philsuth@mycroft.dialix.oz.au[philsuth@mycroft.dialix.oz.au]
+* Poul-Henning Kamp mailto:phk@FreeBSD.org[phk@FreeBSD.org]
+* Ralf Friedl mailto:friedl@informatik.uni-kl.de[friedl@informatik.uni-kl.de]
+* Rick Macklem mailto:root@snowhite.cis.uoguelph.ca[root@snowhite.cis.uoguelph.ca]
+* Robert D. Thrush mailto:rd@phoenix.aii.com[rd@phoenix.aii.com]
+* Rodney W. Grimes mailto:rgrimes@cdrom.com[rgrimes@cdrom.com]
+* Sascha Wildner mailto:swildner@channelz.GUN.de[swildner@channelz.GUN.de]
+* Scott Burris mailto:scott@pita.cns.ucla.edu[scott@pita.cns.ucla.edu]
+* Scott Reynolds mailto:scott@clmqt.marquette.mi.us[scott@clmqt.marquette.mi.us]
+* Seamus Venasse mailto:svenasse@polaris.ca[svenasse@polaris.ca]
+* Sean Eric Fagan mailto:sef@kithrup.com[sef@kithrup.com]
+* Sean McGovern mailto:sean@sfarc.net[sean@sfarc.net]
+* Simon J Gerraty mailto:sjg@melb.bull.oz.au[sjg@melb.bull.oz.au]mailto:sjg@zen.void.oz.au[sjg@zen.void.oz.au]
+* Stephen McKay mailto:syssgm@devetir.qld.gov.au[syssgm@devetir.qld.gov.au]
+* Terry Lambert mailto:terry@icarus.weber.edu[terry@icarus.weber.edu]
+* Terry Lee mailto:terry@uivlsi.csl.uiuc.edu[terry@uivlsi.csl.uiuc.edu]
+* Tor Egge mailto:Tor.Egge@idi.ntnu.no[Tor.Egge@idi.ntnu.no]
+* Warren Toomey mailto:wkt@csadfa.cs.adfa.oz.au[wkt@csadfa.cs.adfa.oz.au]
+* Wiljo Heinen mailto:wiljo@freeside.ki.open.de[wiljo@freeside.ki.open.de]
+* William Jolitz mailto:withheld[withheld]
+* Wolfgang Solfrank mailto:ws@tools.de[ws@tools.de]
+* Wolfgang Stanglmeier mailto:wolf@dentaro.GUN.de[wolf@dentaro.GUN.de]
+* Yuval Yarom mailto:yval@cs.huji.ac.il[yval@cs.huji.ac.il]
diff --git a/documentation/content/es/articles/contributors/contrib-additional.adoc b/documentation/content/es/articles/contributors/contrib-additional.adoc
new file mode 100644
index 0000000000..0871236204
--- /dev/null
+++ b/documentation/content/es/articles/contributors/contrib-additional.adoc
@@ -0,0 +1,2387 @@
+* ABURAYA Ryushirou mailto:rewsirow@ff.iij4u.or.jp[rewsirow@ff.iij4u.or.jp]
+* AIDA Shinra mailto:aida-s@jcom.home.ne.jp[aida-s@jcom.home.ne.jp]
+* AMAGAI Yoshiji mailto:amagai@nue.org[amagai@nue.org]
+* Aaron Bornstein mailto:aaronb@j51.com[aaronb@j51.com]
+* Aaron Myles Landwehr mailto:aaron@snaphat.com[aaron@snaphat.com]
+* Aaron Smith mailto:aaron@mutex.org[aaron@mutex.org]
+* Aaron Straup Cope mailto:ascope@cpan.org[ascope@cpan.org]
+* Aaron Voisine mailto:voisine@gmail.com[voisine@gmail.com]
+* Aaron Zauner mailto:az_mail@gmx.at[az_mail@gmx.at]
+* Aasmund Eikli mailto:inter@o12a.com[inter@o12a.com]
+* Achim Patzner mailto:ap@noses.com[ap@noses.com]
+* Ada T Lim mailto:ada@bsd.org[ada@bsd.org]
+* Adam Baran mailto:badam@mw.mil.pl[badam@mw.mil.pl]
+* Adam C. Migus mailto:adam@migus.org[adam@migus.org]
+* Adam Glass mailto:glass@postgres.berkeley.edu[glass@postgres.berkeley.edu]
+* Adam Herzog mailto:adam@herzogdesigns.com[adam@herzogdesigns.com]
+* Adam Jette mailto:jettea46@yahoo.com[jettea46@yahoo.com]
+* Adam Kranzel mailto:adam@alameda.edu[adam@alameda.edu]
+* Adam McDougall mailto:mcdouga9@egr.msu.edu[mcdouga9@egr.msu.edu]
+* Adam McLaurin mailto:adam.freebsd@fastmail.fm[adam.freebsd@fastmail.fm]
+* Adam Strohl mailto:troll@digitalspark.net[troll@digitalspark.net]
+* Adam Wight mailto:adamw@tulum.brsys.com[adamw@tulum.brsys.com]
+* Adoal Xu mailto:adoal@iname.com[adoal@iname.com]
+* Adrian Colley mailto:aecolley@ois.ie[aecolley@ois.ie]
+* Adrian Filipi-Martin mailto:adrian@ubergeeks.com[adrian@ubergeeks.com]
+* Adrian Hall mailto:ahall@mirapoint.com[ahall@mirapoint.com]
+* Adrian Mariano mailto:adrian@cam.cornell.edu[adrian@cam.cornell.edu]
+* Adrian Pircalabu mailto:apircalabu@bitdefender.com[apircalabu@bitdefender.com]
+* Adrian Steinmann mailto:ast@marabu.ch[ast@marabu.ch]
+* Adrian T. Filipi-Martin mailto:atf3r@agate.cs.virginia.edu[atf3r@agate.cs.virginia.edu]
+* Aftab Jahan Subedar mailto:jahan@bol-online.com[jahan@bol-online.com]
+* Ajit Thyagarajan
+* Akinori YAMADA mailto:yamada-a@nextcom.co.jp[yamada-a@nextcom.co.jp]
+* Akira Ikeuchi mailto:a_ikeuchi@mic.mitsumi.co.jp[a_ikeuchi@mic.mitsumi.co.jp]
+* Akira SAWADA
+* Akira Watanabe mailto:akira@myaw.ei.meisei-u.ac.jp[akira@myaw.ei.meisei-u.ac.jp]
+* Akito Fujita mailto:fujita@zoo.ncl.omron.co.jp[fujita@zoo.ncl.omron.co.jp]
+* Akos Somfai mailto:akos.somfai@gmail.com[akos.somfai@gmail.com]
+* Al Hoang mailto:hoanga@mac.com[hoanga@mac.com]
+* Alain Kalker mailto:A.C.P.M.Kalker@student.utwente.nl[A.C.P.M.Kalker@student.utwente.nl]
+* Alan Amesbury mailto:amesbury@indefi.net[amesbury@indefi.net]
+* Alan Bawden mailto:alan@curry.epilogue.com[alan@curry.epilogue.com]
+* Alan Snelson mailto:Alan@Wave2.co.uk[Alan@Wave2.co.uk]
+* Alban Maire mailto:a.maire@s2mi.fr[a.maire@s2mi.fr]
+* Albert Graef mailto:Dr.Graef@t-online.de[Dr.Graef@t-online.de]
+* Aldert Nooitgedagt mailto:aldert@nooitgedagt.net[aldert@nooitgedagt.net]
+* Aldis Berjoza mailto:killasmurf86@gmail.com[killasmurf86@gmail.com]
+* Alec Wolman mailto:wolman@cs.washington.edu[wolman@cs.washington.edu]
+* Aled Morris mailto:aledm@routers.co.uk[aledm@routers.co.uk]
+* Aleksander Fafula mailto:alex@fafula.com[alex@fafula.com]
+* Aleksandr A Babaylov mailto:.@babolo.ru[.@babolo.ru]
+* Aleksandr S. Goncharov mailto:mraleks@bk.ru[mraleks@bk.ru]
+* Alessandro Sagratini mailto:ale_sagra@hotmail.com[ale_sagra@hotmail.com]
+* Alex D. Chen mailto:dhchen@elearning.nsysu.edu.tw[dhchen@elearning.nsysu.edu.tw]
+* Alex Deiter mailto:tiamat@komi.mts.ru[tiamat@komi.mts.ru]
+* Alex G. Bulushev mailto:bag@demos.su[bag@demos.su]
+* Alex Kapranoff mailto:alex@kapranoff.ru[alex@kapranoff.ru]
+* Alex Keda mailto:admin@lissyara.su[admin@lissyara.su]
+* Alex Kiesel mailto:kiesel@schlund.de[kiesel@schlund.de]
+* Alex Le Heux mailto:alexlh@funk.org[alexlh@funk.org]
+* Alex M mailto:alex@myzona.net[alex@myzona.net]
+* Alex Miller mailto:asm@asm.kiev.ua[asm@asm.kiev.ua]
+* Alex Nunes Soares mailto:alexnunessoares@gmail.com[alexnunessoares@gmail.com]
+* Alex Perel mailto:veers@disturbed.net[veers@disturbed.net]
+* Alex Pesternikov mailto:ap@page2rss.com[ap@page2rss.com]
+* Alex Rodioukov mailto:simuran@shaw.ca[simuran@shaw.ca]
+* Alex Rousskov mailto:rousskov@measurement-factory.com[rousskov@measurement-factory.com]
+* Alex Semenyaka mailto:alex@rinet.ru[alex@rinet.ru]
+* Alex Steiner mailto:ast@treibsand.com[ast@treibsand.com]
+* Alex Trull mailto:alexander@trull.com[alexander@trull.com]
+* Alex Varju mailto:freebsd-ports@varju.ca[freebsd-ports@varju.ca]
+* Alex Vasylenko mailto:lxv@omut.org[lxv@omut.org]
+* Alex Wilkinson mailto:alex.wilkinson@dsto.defence.gov.au[alex.wilkinson@dsto.defence.gov.au]
+* Alex Zepeda mailto:garbanzo@hooked.net[garbanzo@hooked.net]
+* Alexander Bechikov mailto:goo@t72.ru[goo@t72.ru]
+* {arundel}
+* Alexander Churanov mailto:alexanderchuranov@gmail.com[alexanderchuranov@gmail.com]
+* Alexander B. Povolotsky mailto:tarkhil@mgt.msk.ru[tarkhil@mgt.msk.ru]
+* Alexander Gelfenbain mailto:mail@gelf.com[mail@gelf.com]
+* Alexander Pereira Girald mailto:girald@etcom.ufrgs.br[girald@etcom.ufrgs.br]
+* Alexander Grigoryev mailto:alexander.4mail@gmail.com[alexander.4mail@gmail.com]
+* Alexander Gromnizki mailto:gromnizki@unixdev.net[gromnizki@unixdev.net]
+* Alexander Haderer mailto:alexander.haderer@charite.de[alexander.haderer@charite.de]
+* Alexander Koch mailto:fbsd@meersau.de[fbsd@meersau.de]
+* Alexander Kojevnikov mailto:alexander@kojevnikov.com[alexander@kojevnikov.com]
+* Alexander Kovalenko mailto:never@nevermind.kiev.ua[never@nevermind.kiev.ua]
+* Alexander Moisseev mailto:moiseev@mezonplus.ru[moiseev@mezonplus.ru]
+* Alexander Novitsky mailto:alecn2002@yandex.ru[alecn2002@yandex.ru]
+* Alexander Nusov mailto:alexander.nusov@nfvexpress.com[alexander.nusov@nfvexpress.com]
+* Alexander Peresunko mailto:alex@freeman.org.ua[alex@freeman.org.ua]
+* Alexander Pohoyda mailto:alexander.pohoyda@gmx.net[alexander.pohoyda@gmx.net]
+* Alexander Pyhalov mailto:alp@sfedu.ru[alp@sfedu.ru]
+* alexander smishlajev mailto:alex@ank-sia.com[alex@ank-sia.com]
+* Alexander V. Ribchansky mailto:triosoft@triosoft.com.ua[triosoft@triosoft.com.ua]
+* Alexander Yerenkow mailto:yerenkow@gmail.com[yerenkow@gmail.com]
+* Alexander Sieg mailto:alex@xanderio.de[alex@xanderio.de]
+* Alexander Zagrebin mailto:alexz@visp.ru[alexz@visp.ru]
+* Alexander Zhuravlev mailto:zaa@zaa.pp.ru[zaa@zaa.pp.ru]
+* Alexandre Liberato mailto:alexandre@feiler.co[alexandre@feiler.co]
+* Alexandre Peixoto mailto:alexandref@tcoip.com.br[alexandref@tcoip.com.br]
+* Alexandre Snarskii mailto:snar@paranoia.ru[snar@paranoia.ru]
+* Alexandre Vasconcelos mailto:alex.vasconcelos@gmail.com[alex.vasconcelos@gmail.com]
+* Alexandros Kosiaris mailto:akosiaris+ports@gmail.com[akosiaris+ports@gmail.com]
+* Alexandru Ciobanu mailto:iscandr@gmail.com[iscandr@gmail.com]
+* Alexey Bobkov mailto:mr.deadlystorm@gmail.com[mr.deadlystorm@gmail.com]
+* Alexey Illarionov mailto:littlesavage@rambler.ru[littlesavage@rambler.ru]
+* Alexey V. Antipovsky mailto:kemm@in-line.ru[kemm@in-line.ru]
+* Alexey V. Degtyarev mailto:alexey@renatasystems.org[alexey@renatasystems.org]
+* Alexey V. Neyman mailto:alex.neyman@auriga.ru[alex.neyman@auriga.ru]
+* Alexey Y. Mikhailov mailto:karma@ez.pereslavl.ru[karma@ez.pereslavl.ru]
+* Alexey Shuvaev mailto:shuvaev@physik.uni-wuerzburg.de[shuvaev@physik.uni-wuerzburg.de]
+* Alexey Zaytsev mailto:mangoost@inetcomm.ru[mangoost@inetcomm.ru]
+* Alexis Yushin mailto:alexis@forest.NLnetLabs.nl[alexis@forest.NLnetLabs.nl]
+* Alfonso S. Siciliano mailto:alfix86@gmail.com[alfix86@gmail.com]
+* Ali Mashtizadeh mailto:mashtizadeh@gmail.com[mashtizadeh@gmail.com]
+* Alistair G. Crooks mailto:agc@uts.amdahl.com[agc@uts.amdahl.com]
+* Allan Bowhill mailto:bowhill@bowhill.vservers.com[bowhill@bowhill.vservers.com]
+* Allan Saddi mailto:asaddi@philosophysw.com[asaddi@philosophysw.com]
+* Allen Campbell mailto:allenc@verinet.com[allenc@verinet.com]
+* Alphons "Fonz" van Werven mailto:freebsd@skysmurf.nl[freebsd@skysmurf.nl]
+* Amakawa Shuhei mailto:amakawa@hoh.t.u-tokyo.ac.jp[amakawa@hoh.t.u-tokyo.ac.jp]
+* Amar Takhar mailto:verm@drunkmonk.net[verm@drunkmonk.net]
+* Amaziles José Antonio Martins de Carvalho mailto:amazilesjose@gmail.com[amazilesjose@gmail.com]
+* Amir Farah mailto:amir@comtrol.com[amir@comtrol.com]
+* Amir Shalem mailto:amir@boom.org.il[amir@boom.org.il]
+* Amarendra Godbole mailto:amarendra.godbole@gmail.com[amarendra.godbole@gmail.com]
+* Amy Baron mailto:amee@beer.org[amee@beer.org]
+* Anthony Garcia mailto:agarcia@experts-exchange.com[agarcia@experts-exchange.com]
+* Anatoliy Dmytriyev mailto:tolid@plab.ku.dk[tolid@plab.ku.dk]
+* Anatoly A. Orehovsky mailto:tolik@mpeks.tomsk.su[tolik@mpeks.tomsk.su]
+* Anatoly Borodin mailto:anatoly.borodin@gmail.com[anatoly.borodin@gmail.com]
+* Anatoly Vorobey mailto:mellon@pobox.com[mellon@pobox.com]
+* Anatoly Zherdev mailto:tolyar@mx.ru[tolyar@mx.ru]
+* Anders Andersson mailto:anders@codefactory.se[anders@codefactory.se]
+* Anders Nor Berle mailto:debolaz@debolaz.com[debolaz@debolaz.com]
+* Anders Thulin mailto:Anders.X.Thulin@telia.se[Anders.X.Thulin@telia.se]
+* Anders Troback mailto:freebsd@troback.com[freebsd@troback.com]
+* Anderson Aguiar mailto:anderson.n.aguair@gmail.com[anderson.n.aguair@gmail.com]
+* Anderson S. Ferreira mailto:anderson@cnpm.embrapa.br[anderson@cnpm.embrapa.br]
+* Andi Payn mailto:andi_payn@speedymail.org[andi_payn@speedymail.org]
+* Andre Albsmeier mailto:Andre.Albsmeier@mchp.siemens.de[Andre.Albsmeier@mchp.siemens.de]
+* André Franciosi mailto:andre@franciosi.org[andre@franciosi.org]
+* Andre Goeree mailto:abgoeree@uwnet.nl[abgoeree@uwnet.nl]
+* Andre Yelistratov mailto:andre@andre.net.ru[andre@andre.net.ru]
+* Andrea Venturoli mailto:a.ventu@flashnet.it[a.ventu@flashnet.it]
+* Andreas Andersson mailto:a.andersson.thn@gmail.com[a.andersson.thn@gmail.com]
+* Andreas Berg mailto:aberg@doomnet.de[aberg@doomnet.de]
+* Andreas Bilke mailto:andreas@bilke.org[andreas@bilke.org]
+* Andreas Fehlner mailto:fehlner@gmx.de[fehlner@gmx.de]
+* Andreas Fuchs mailto:asf@boinkor.net[asf@boinkor.net]
+* Andreas Gustafsson mailto:gson@araneus.fi[gson@araneus.fi]
+* Andreas Haakh mailto:ah@alman.robin.de[ah@alman.robin.de]
+* Andreas Heil mailto:ah@linux-hq.de[ah@linux-hq.de]
+* Andreas K Foerster mailto:akf3@akfoerster.de[akf3@akfoerster.de]
+* Andreas Karlsson mailto:norrland@nullbyte.se[norrland@nullbyte.se]
+* Andreas Kasparz mailto:andy@interface-business.de[andy@interface-business.de]
+* Andreas Kohn mailto:andreas@syndrom23.de[andreas@syndrom23.de]
+* Andreas Kohout mailto:shanee@rabbit.augusta.de[shanee@rabbit.augusta.de]
+* Andreas Lohr mailto:andreas@marvin.RoBIN.de[andreas@marvin.RoBIN.de]
+* Andreas Möller mailto:segfault@gmx.net[segfault@gmx.net]
+* Andreas Riedel mailto:rian@hrz.tu-chemnitz.de[rian@hrz.tu-chemnitz.de]
+* Andreas Sommer mailto:andreas.sommer87@googlemail.com[andreas.sommer87@googlemail.com]
+* Andreas Wetzel mailto:mickey@deadline.snafu.de[mickey@deadline.snafu.de]
+* Andreas Wrede mailto:andreas@planix.com[andreas@planix.com]
+* Andrei V. Shetuhin mailto:shetuhin@corp.mail.ru[shetuhin@corp.mail.ru]
+* Andrej Ebert mailto:andrej@ebert.su[andrej@ebert.su]
+* Andres Vega Garcia
+* Andrew Arensburger mailto:arensb@ooblick.com[arensb@ooblick.com]
+* Andrew Atrens mailto:atreand@statcan.ca[atreand@statcan.ca]
+* Andrew Boothman mailto:andrew@cream.org[andrew@cream.org]
+* Andrew Gillham mailto:gillham@andrews.edu[gillham@andrews.edu]
+* Andrew Gordon mailto:andrew.gordon@net-tel.co.uk[andrew.gordon@net-tel.co.uk]
+* Andrew Greenwood mailto:greenwood.andy@gmail.com[greenwood.andy@gmail.com]
+* Andrew Herbert mailto:andrew@werple.apana.org.au[andrew@werple.apana.org.au]
+* Andrew J. Caines mailto:A.J.Caines@halplant.com[A.J.Caines@halplant.com]
+* Andrew J. Korty mailto:ajk@iu.edu[ajk@iu.edu]
+* Andrew Khlebutin mailto:andrey@hm.perm.ru[andrey@hm.perm.ru]
+* Andrew Kochetkov mailto:kochetkov.andrew@gmail.com[kochetkov.andrew@gmail.com]
+* Andrew Kolchoogin mailto:andrew@rinet.ru[andrew@rinet.ru]
+* Andrew L. Kilpatrick mailto:tiger@whitetigersd.com[tiger@whitetigersd.com]
+* Andrew L. Neporada mailto:andrew@chg.ru[andrew@chg.ru]
+* Andrew Marks mailto:andrew@amrx.net[andrew@amrx.net]
+* Andrew McKay mailto:andy@openirc.co.uk[andy@openirc.co.uk]
+* Andrew McNaughton mailto:andrew@scoop.co.nz[andrew@scoop.co.nz]
+* Andrew McRae mailto:amcrae@cisco.com[amcrae@cisco.com]
+* Andrew Morton mailto:drewish@katherinehouse.com[drewish@katherinehouse.com]
+* Andrew P. Lentvorski mailto:bsder@allcaps.org[bsder@allcaps.org]
+* Andrew Predoehl mailto:predoehl@mail.kg[predoehl@mail.kg]
+* Andrew Reilly mailto:a.reilly@lake.com[a.reilly@lake.com]
+* Andrew Romanenko mailto:melanhit@gmail.com[melanhit@gmail.com]
+* Andrew S. Midthune mailto:amidthune@cableone.net[amidthune@cableone.net]
+* Andrew Shevtsov mailto:nyxo@dnuc.polyn.kiae.su[nyxo@dnuc.polyn.kiae.su]
+* Andrew Stevenson mailto:andrew@ugh.net.au[andrew@ugh.net.au]
+* Andrew Timonin mailto:tim@pool1.convey.ru[tim@pool1.convey.ru]
+* Andrew V. Stesin mailto:stesin@elvisti.kiev.ua[stesin@elvisti.kiev.ua]
+* Andrew V. Stikheev mailto:sand@links.ru[sand@links.ru]
+* Andrew Webster mailto:awebster@dataradio.com[awebster@dataradio.com]
+* Andrey Cherkashin mailto:andoriyu@gmail.com[andoriyu@gmail.com]
+* Andrey Fesenko mailto:andrey@bsdnir.info[andrey@bsdnir.info]
+* Andrey Novikov mailto:andrey@novikov.com[andrey@novikov.com]
+* Andrey Simonenko mailto:simon@comsys.ntu-kpi.kiev.ua[simon@comsys.ntu-kpi.kiev.ua]
+* Andrey Surkov mailto:nsand@sura.ru[nsand@sura.ru]
+* Andrey Sverdlichenko mailto:rblaze@users.sourceforge.net[rblaze@users.sourceforge.net]
+* Andrey Tchoritch mailto:andy@venus.sympad.net[andy@venus.sympad.net]
+* Andris Raugulis mailto:moo@arthepsy.eu[moo@arthepsy.eu]
+* Andy Farkas mailto:andyf@speednet.com.au[andyf@speednet.com.au]
+* Andy Fawcett mailto:andy@athame.co.uk[andy@athame.co.uk]
+* Andy Gilligan mailto:andy@evo6.org[andy@evo6.org]
+* Andy Kosela mailto:andy.kosela@gmail.com[andy.kosela@gmail.com]
+* Andy Miller mailto:andy@trit.org[andy@trit.org]
+* Andy Newman mailto:atrn@zeta.org.au[atrn@zeta.org.au]
+* Andy Pavlo mailto:amp0928@rit.edu[amp0928@rit.edu]
+* Andy Sparrow mailto:spadger@best.com[spadger@best.com]
+* Andy Valencia mailto:ajv@csd.mot.com[ajv@csd.mot.com]
+* Andy Whitcroft mailto:andy@sarc.city.ac.uk[andy@sarc.city.ac.uk]
+* Anes Muhametov mailto:anes@anes.su[anes@anes.su]
+* Angel Todorov mailto:todorov_bg@gmx.net[todorov_bg@gmx.net]
+* Angelo Turetta mailto:aturetta@commit.it[aturetta@commit.it]
+* Anish Mistry mailto:amistry@am-productions.biz[amistry@am-productions.biz]
+* Anthony C. Chavez mailto:acc@anthonychavez.org[acc@anthonychavez.org]
+* Anthony Ginepro mailto:anthony.ginepro@laposte.net[anthony.ginepro@laposte.net]
+* Anthony Mawer mailto:gnats@mawer.org[gnats@mawer.org]
+* Anthony Yee-Hang Chan mailto:yeehang@netcom.com[yeehang@netcom.com]
+* Antoine Beaupre mailto:anarcat@anarcat.ath.cx[anarcat@anarcat.ath.cx]
+* Antoine Pelisse mailto:apelisse@gmail.com[apelisse@gmail.com]
+* Anton Hryciuk mailto:gnixua@gmail.com[gnixua@gmail.com]
+* Anton N. Bruesov mailto:antonz@library.ntu-kpi.kiev.ua[antonz@library.ntu-kpi.kiev.ua]
+* Anton Shterenlikht mailto:mexas@bris.ac.uk[mexas@bris.ac.uk]
+* Anton Tornqvist mailto:antont@inbox.lv[antont@inbox.lv]
+* Anton Voronin mailto:anton@urc.ac.ru[anton@urc.ac.ru]
+* Anton Yuzhaninov mailto:citrin@citrin.ru[citrin@citrin.ru]
+* Antonio Bonifati mailto:ant@monitor.deis.unical.it[ant@monitor.deis.unical.it]
+* Antonio Carlos Venancio Junior mailto:antonio@php.net[antonio@php.net]
+* Antti Kaipila mailto:anttik@iki.fi[anttik@iki.fi]
+* Aragon Gouveia mailto:aragon@phat.za.net[aragon@phat.za.net]
+* Are Bryne mailto:are.bryne@communique.no[are.bryne@communique.no]
+* Ari Suutari mailto:ari@suutari.iki.fi[ari@suutari.iki.fi]
+* Arindum Mukerji mailto:raja@moselle.com[raja@moselle.com]
+* Arjan de Vet mailto:devet@devet.nl[devet@devet.nl]
+* Arnaud Berthomier mailto:oz@cyprio.net[oz@cyprio.net]
+* Arnaud Launay mailto:asl@launay.org[asl@launay.org]
+* Arne Henrik Juul mailto:arnej@Lise.Unit.NO[arnej@Lise.Unit.NO]
+* Aron Schlesinger mailto:as@bsdgroup.de[as@bsdgroup.de]
+* Aron Stansvik mailto:elvstone@gmail.com[elvstone@gmail.com]
+* Artem Kazakov mailto:kazakov@gmail.com[kazakov@gmail.com]
+* Artem Naluzhnyy mailto:tut@nhamon.com.ua[tut@nhamon.com.ua]
+* Artem Nosov mailto:chip-set@mail.ru[chip-set@mail.ru]
+* Ashley Penney mailto:ashp@unloved.org[ashp@unloved.org]
+* Ask Bjoern Hansen mailto:ask@valueclick.com[ask@valueclick.com]
+* Athanasios Douitsis mailto:aduitsis@cpan.org[aduitsis@cpan.org]
+* Atsushi Furuta mailto:furuta@sra.co.jp[furuta@sra.co.jp]
+* Atsushi Murai mailto:amurai@spec.co.jp[amurai@spec.co.jp]
+* Attila Nagy mailto:bra@fsn.hu[bra@fsn.hu]
+* Atushi Sakauchi mailto:sakauchi@yamame.to[sakauchi@yamame.to]
+* Autrijus Tang mailto:autrijus@autrijus.org[autrijus@autrijus.org]
+* Axel Gonzalez mailto:loox@e-shell.net[loox@e-shell.net]
+* Balázs Nagy mailto:js@iksz.hu[js@iksz.hu]
+* Barry Bierbauch mailto:pivrnec@vszbr.cz[pivrnec@vszbr.cz]
+* Barry Lustig mailto:barry@ictv.com[barry@ictv.com]
+* Bartosz Fabianowski mailto:freebsd@chillt.de[freebsd@chillt.de]
+* Bayanzul Lodoysamba mailto:baynaa@yahoo.com[baynaa@yahoo.com]
+* Ben Hutchinson mailto:benhutch@xfiles.org.uk[benhutch@xfiles.org.uk]
+* Ben Jackson
+* Ben Walter mailto:bwalter@itachi.swcp.com[bwalter@itachi.swcp.com]
+* Ben Woolley mailto:ports@tautology.org[ports@tautology.org]
+* Benedikt Köhler mailto:benedikt@furukama.de[benedikt@furukama.de]
+* Beni Keller mailto:navigium@grindcore.ch[navigium@grindcore.ch]
+* Benjamin Lewis mailto:bhlewis@gte.net[bhlewis@gte.net]
+* Benjamin Lutz mailto:benlutz@datacomm.ch[benlutz@datacomm.ch]
+* Benny Kjrgaard mailto:benny@catpipe.net[benny@catpipe.net]
+* Benoit Calvez mailto:benoit@litchis.org[benoit@litchis.org]
+* Berend de Boer mailto:berend@pobox.com[berend@pobox.com]
+* Bernd Luevelsmeyer mailto:bdluevel@heitec.net[bdluevel@heitec.net]
+* Bernd Rosauer mailto:br@schiele-ct.de[br@schiele-ct.de]
+* Bill Cadwallader mailto:hurbold@yahoo.com[hurbold@yahoo.com]
+* Bill Kish mailto:kish@osf.org[kish@osf.org]
+* Bill Lloyd mailto:wlloyd@mpd.ca[wlloyd@mpd.ca]
+* Bill Moran mailto:wmoran@collaborativefusion.com[wmoran@collaborativefusion.com]
+* Bill Trost mailto:trost@cloud.rain.com[trost@cloud.rain.com]
+* Björn König mailto:bkoenig@cs.tu-berlin.de[bkoenig@cs.tu-berlin.de]
+* Björn Lindström mailto:bkhl@elektrubadur.se[bkhl@elektrubadur.se]
+* Blaz Zupan mailto:blaz@amis.net[blaz@amis.net]
+* BluePex Security Solutions mailto:freebsd-ports@bluepex.com[freebsd-ports@bluepex.com]
+* Bob Eager mailto:bob@eager.cx[bob@eager.cx]
+* Bob Frazier mailto:bobf@mrp3.com[bobf@mrp3.com]
+* Bob Van Valzah mailto:Bob@whitebarn.com[Bob@whitebarn.com]
+* Bob Willcox mailto:bob@luke.pmr.com[bob@luke.pmr.com]
+* Boris Kovalenko mailto:boris@tagnet.ru[boris@tagnet.ru]
+* Boris Lytochkin mailto:lytboris@gmail.com[lytboris@gmail.com]
+* Boris Staeblow mailto:balu@dva.in-berlin.de[balu@dva.in-berlin.de]
+* Boyd R. Faulkner mailto:faulkner@asgard.bga.com[faulkner@asgard.bga.com]
+* Brad Chapman mailto:chapmanb@arches.uga.edu[chapmanb@arches.uga.edu]
+* Brad Hendrickse mailto:bradh@uunet.co.za[bradh@uunet.co.za]
+* Brad Jones mailto:brad@kazrak.com[brad@kazrak.com]
+* Brad Karp mailto:karp@eecs.harvard.edu[karp@eecs.harvard.edu]
+* Brad Lanam mailto:bll@gentoo.com[bll@gentoo.com]
+* Bradley Dunn mailto:bradley@dunn.org[bradley@dunn.org]
+* Bram Moolenaar mailto:bram@moolenaar.net[bram@moolenaar.net]
+* Brandon Fosdick mailto:bfoz@glue.umd.edu[bfoz@glue.umd.edu]
+* Brandon Gillespie mailto:brandon@roguetrader.com[brandon@roguetrader.com]
+* Brent B. Powers mailto:bbp2006@columbia.edu[bbp2006@columbia.edu]
+* Brent J. Nordquist mailto:bjn@visi.com[bjn@visi.com]
+* Brett Lymn mailto:blymn@mulga.awadi.com.AU[blymn@mulga.awadi.com.AU]
+* Brett Taylor mailto:brett@peloton.runet.edu[brett@peloton.runet.edu]
+* Brian Campbell mailto:brianc@pobox.com[brianc@pobox.com]
+* Brian Cully mailto:shmit@kublai.com[shmit@kublai.com]
+* Brian Gardner mailto:brian@getsnappy.com[brian@getsnappy.com]
+* Brian Handy mailto:handy@lambic.space.lockheed.com[handy@lambic.space.lockheed.com]
+* Brian Litzinger mailto:brian@MediaCity.com[brian@MediaCity.com]
+* Brian M. Clapper mailto:bmc@clapper.com[bmc@clapper.com]
+* Brian McGovern mailto:bmcgover@cisco.com[bmcgover@cisco.com]
+* Brian Moore mailto:ziff@houdini.eecs.umich.edu[ziff@houdini.eecs.umich.edu]
+* Brian R. Gaeke mailto:brg@dgate.org[brg@dgate.org]
+* Brian R. Haug mailto:haug@conterra.com[haug@conterra.com]
+* Brian Skrab mailto:brian@quynh-and-brian.org[brian@quynh-and-brian.org]
+* Brian Tao mailto:taob@risc.org[taob@risc.org]
+* Brion Moss mailto:brion@queeg.com[brion@queeg.com]
+* Bruce Albrecht mailto:bruce@zuhause.mn.org[bruce@zuhause.mn.org]
+* Bruce Gingery mailto:bgingery@gtcs.com[bgingery@gtcs.com]
+* Bruce J. Keeler mailto:loodvrij@gridpoint.com[loodvrij@gridpoint.com]
+* Bruce Murphy mailto:packrat@iinet.net.au[packrat@iinet.net.au]
+* Bruce Walter mailto:walter@fortean.com[walter@fortean.com]
+* Bruno Schwander mailto:bruno@tinkerbox.org[bruno@tinkerbox.org]
+* Byung-Hee HWANG mailto:bh@izb.knu.ac.kr[bh@izb.knu.ac.kr]
+* Camson Huynh mailto:chuynh@biolateral.com.au[chuynh@biolateral.com.au]
+* Carey Jones mailto:mcj@acquiesce.org[mcj@acquiesce.org]
+* Carl Fongheiser mailto:kf0yn@mchsi.com[kf0yn@mchsi.com]
+* Carl Makin mailto:carl@stagecraft.cx[carl@stagecraft.cx]
+* Carl Mascott mailto:cmascott@world.std.com[cmascott@world.std.com]
+* Carl Schmidt mailto:carl@perlpimp.codersluts.net[carl@perlpimp.codersluts.net]
+* Carlos A. M. dos Santos mailto:unixmania@gmail.com[unixmania@gmail.com]
+* Carlos Eduardo G. Carvalho mailto:cartola@openit.com.br[cartola@openit.com.br]
+* Carsten Larsen mailto:cs@innolan.dk[cs@innolan.dk]
+* Casper mailto:casper@acc.am[casper@acc.am]
+* Castor Fu mailto:castor@geocast.com[castor@geocast.com]
+* Cédric Lamalle mailto:cedric@cedric.trix.net[cedric@cedric.trix.net]
+* Cezary Morga mailto:cm@therek.net[cm@therek.net]
+* Chad Castleberry mailto:crcastle@ius.edu[crcastle@ius.edu]
+* Chad Jacob Milios mailto:milios@ccsys.com[milios@ccsys.com]
+* Chain Lee mailto:chain@110.net[chain@110.net]
+* Charles Hannum mailto:mycroft@ai.mit.edu[mycroft@ai.mit.edu]
+* Charles Henrich mailto:henrich@msu.edu[henrich@msu.edu]
+* Charles Mott mailto:cmott@scientech.com[cmott@scientech.com]
+* Charles Owens mailto:owensc@enc.edu[owensc@enc.edu]
+* Charles Swiger mailto:chuck@pkix.net[chuck@pkix.net]
+* Cheng-Tao Lin mailto:b89605222@ntu.edu.tw[b89605222@ntu.edu.tw]
+* ChenGuang LI mailto:horus.li@gmail.com[horus.li@gmail.com]
+* Chess Griffin mailto:chess@chessgriffin.com[chess@chessgriffin.com]
+* Chet Ramey mailto:chet@odin.INS.CWRU.Edu[chet@odin.INS.CWRU.Edu]
+* Chi-Feng QU mailto:chifeng@gmail.com[chifeng@gmail.com]
+* Chia-Hsing Yu mailto:davidyu@ucsd.edu[davidyu@ucsd.edu]
+* Chia-liang Kao mailto:clkao@CirX.ORG[clkao@CirX.ORG]
+* Chiang Cheng-Hsiung mailto:elvis@sslab.cs.ccu.edu.tw[elvis@sslab.cs.ccu.edu.tw]
+* Chie Taguchi mailto:taguchi.ch@gmail.com[taguchi.ch@gmail.com]
+* Chiharu Shibata mailto:chi@bd.mbn.or.jp[chi@bd.mbn.or.jp]
+* Chip Norkus
+* Choe, Cheng-Dae mailto:whitekid@netian.com[whitekid@netian.com]
+* Chris Burkert mailto:chris@chrisburkert.de[chris@chrisburkert.de]
+* Chris Csanady mailto:cc@tarsier.ca.sandia.gov[cc@tarsier.ca.sandia.gov]
+* Chris Dabrowski mailto:chris@vader.org[chris@vader.org]
+* Chris Dillon mailto:cdillon@wolves.k12.mo.us[cdillon@wolves.k12.mo.us]
+* Chris Hutchinson mailto:portmaster@BSDforge.com[portmaster@BSDforge.com]
+* Chris Howells mailto:howells@kde.org[howells@kde.org]
+* Chris Jones mailto:chris.jones@ualberta.ca[chris.jones@ualberta.ca]
+* Chris Knight mailto:chris@e-easy.com.au[chris@e-easy.com.au]
+* Chris Larsen mailto:darth@vader.dk[darth@vader.dk]
+* Chris Laverdure mailto:dashevil@gmail.com[dashevil@gmail.com]
+* Chris Pepper mailto:pepper@mail.rockefeller.edu[pepper@mail.rockefeller.edu]
+* Chris Pressey mailto:chris_pressey@yahoo.ca[chris_pressey@yahoo.ca]
+* Chris Shenton mailto:cshenton@angst.it.hq.nasa.gov[cshenton@angst.it.hq.nasa.gov]
+* Chris Stenton mailto:jacs@gnome.co.uk[jacs@gnome.co.uk]
+* Chris Torek mailto:torek@ee.lbl.gov[torek@ee.lbl.gov]
+* Christian Geier mailto:geier@lostpackets.de[geier@lostpackets.de]
+* Christian Gusenbauer mailto:c47g@gmx.at[c47g@gmx.at]
+* Christian Haury mailto:Christian.Haury@sagem.fr[Christian.Haury@sagem.fr]
+* Christian Heckendorf mailto:heckend@bu.edu[heckend@bu.edu]
+* Christian Lackas mailto:delta@lackas.net[delta@lackas.net]
+* Christian Laursen mailto:xi@borderworlds.dk[xi@borderworlds.dk]
+* Christian Schade mailto:christian.schade@interface-projects.de[christian.schade@interface-projects.de]
+* Christian Ullrich mailto:chris@chrullrich.net[chris@chrullrich.net]
+* Christian Zander mailto:zander@minion.de[zander@minion.de]
+* {kuku}
+* Christoph Robitschko mailto:chmr@edvz.tu-graz.ac.at[chmr@edvz.tu-graz.ac.at]
+* Christoph Weber-Fahr mailto:wefa@callcenter.systemhaus.net[wefa@callcenter.systemhaus.net]
+* Christophe Juniet mailto:cjuniet@entreview.com[cjuniet@entreview.com]
+* Christopher Boumenot mailto:boumenot@gmail.com[boumenot@gmail.com]
+* Christopher G. Demetriou mailto:cgd@postgres.berkeley.edu[cgd@postgres.berkeley.edu]
+* Christopher Hall mailto:hsw@bitmark.com[hsw@bitmark.com]
+* Christopher Illies mailto:christopher.illies@ki.se[christopher.illies@ki.se]
+* Christopher J. Ruwe mailto:cjr@cruwe.de[cjr@cruwe.de]
+* Christopher K. Davis mailto:ckd-freebsd@ckdhr.com[ckd-freebsd@ckdhr.com]
+* Christopher Key mailto:cjk32@cam.ac.uk[cjk32@cam.ac.uk]
+* Christopher Knaust mailto:jigboe@gmx.de[jigboe@gmx.de]
+* Christopher N. Harrell mailto:cnh@ivmg.net[cnh@ivmg.net]
+* Christopher Nehren mailto:apeiron@comcast.net[apeiron@comcast.net]
+* Christopher Preston mailto:rbg@gayteenresource.org[rbg@gayteenresource.org]
+* Christopher T. Johnson mailto:cjohnson@neunacht.netgsi.com[cjohnson@neunacht.netgsi.com]
+* Christopher Vance mailto:vance@aurema.com[vance@aurema.com]
+* Chrisy Luke mailto:chrisy@flix.net[chrisy@flix.net]
+* Chuck Hein mailto:chein@cisco.com[chein@cisco.com]
+* Clayton Eduardo dos Santos mailto:claytones@gmail.com[claytones@gmail.com]
+* Clayton Rollins mailto:crollins666@hotmail.com[crollins666@hotmail.com]
+* Clement MOULIN mailto:moeti-freebsd@ouestil.com[moeti-freebsd@ouestil.com]
+* Cliff Rowley mailto:dozprompt@onsea.com[dozprompt@onsea.com]
+* clutton mailto:clutton@zoho.com[clutton@zoho.com]
+* Clive Crous mailto:clive@darkarts.co.za[clive@darkarts.co.za]
+* Colin Booth mailto:colin@heliocat.net[colin@heliocat.net]
+* Colman Reilly mailto:careilly@tcd.ie[careilly@tcd.ie]
+* Conor McDermottroe mailto:ports@mcdermottroe.com[ports@mcdermottroe.com]
+* Conrad Sabatier mailto:conrads@cox.net[conrads@cox.net]
+* Constantin S. Svintsoff mailto:kostik@iclub.nsu.ru[kostik@iclub.nsu.ru]
+* Coranth Gryphon mailto:gryphon@healer.com[gryphon@healer.com]
+* Corey Smith mailto:corsmith@gmail.com[corsmith@gmail.com]
+* Cornelis van der Laan mailto:nils@guru.ims.uni-stuttgart.de[nils@guru.ims.uni-stuttgart.de]
+* Cosmin Stroe mailto:cstroe1@uic.edu[cstroe1@uic.edu]
+* Cove Schneider mailto:cove@brazil.nbn.com[cove@brazil.nbn.com]
+* Craig Boston mailto:craig@yekse.gank.org[craig@yekse.gank.org]
+* Craig Butler mailto:craig001@lerwick.hopto.org[craig001@lerwick.hopto.org]
+* Craig Loomis
+* Craig Metz mailto:cmetz@inner.net[cmetz@inner.net]
+* Craig Spannring mailto:cts@internetcds.com[cts@internetcds.com]
+* Craig Struble mailto:cstruble@vt.edu[cstruble@vt.edu]
+* Cristian Ferretti mailto:cfs@riemann.mat.puc.cl[cfs@riemann.mat.puc.cl]
+* Cristiano Rolim Pereira mailto:cristianorolim@hotmail.com[cristianorolim@hotmail.com]
+* Curt Mayer mailto:curt@toad.com[curt@toad.com]
+* Cyril Guibourg mailto:aragorn+ports@teaser.fr[aragorn+ports@teaser.fr]
+* Cyrille Lefevre mailto:clefevre@citeweb.net[clefevre@citeweb.net]
+* Cyrus Rahman mailto:cr@jcmax.com[cr@jcmax.com]
+* Daan Vreeken mailto:Danovitsch@Vitsch.net[Danovitsch@Vitsch.net]
+* Dai Ishijima mailto:ishijima@tri.pref.osaka.jp[ishijima@tri.pref.osaka.jp]
+* Daisuke Aoyama mailto:aoyama@peach.ne.jp[aoyama@peach.ne.jp]
+* Daisuke Watanabe mailto:NU7D-WTNB@asahi-net.or.jp[NU7D-WTNB@asahi-net.or.jp]
+* Damian Gerow mailto:dgerow@afflictions.org[dgerow@afflictions.org]
+* Damian Hamill mailto:damian@cablenet.net[damian@cablenet.net]
+* Damien Tougas mailto:damien@tougas.net[damien@tougas.net]
+* Dan Angelescu mailto:mrhsaacdoh@yahoo.com[mrhsaacdoh@yahoo.com]
+* Dan Caescu mailto:daniel@freebsd.ro[daniel@freebsd.ro]
+* Dan Cross mailto:tenser@spitfire.ecsel.psu.edu[tenser@spitfire.ecsel.psu.edu]
+* Dan Lukes mailto:dan@obluda.cz[dan@obluda.cz]
+* Dan Nelson mailto:dnelson@allantgroup.com[dnelson@allantgroup.com]
+* Dan Papasian mailto:bugg@bugg.strangled.net[bugg@bugg.strangled.net]
+* Dan Pelleg mailto:dpelleg+unison@cs.cmu.edu[dpelleg+unison@cs.cmu.edu]
+* Dan Piponi mailto:wmtop@tanelorn.demon.co.uk[wmtop@tanelorn.demon.co.uk]
+* Dan Rench mailto:citric@cubicone.tmetic.com[citric@cubicone.tmetic.com]
+* Dan Smith mailto:dan@algenta.com[dan@algenta.com]
+* Dan Walters mailto:hannibal@cyberstation.net[hannibal@cyberstation.net]
+* Daniel Austin mailto:freebsd-ports@dan.me.uk[freebsd-ports@dan.me.uk]
+* Daniel B. Hemmerich mailto:dan@spot.org[dan@spot.org]
+* Daniel Blankensteiner mailto:db@TruNet.dk[db@TruNet.dk]
+* Daniel Bretoi mailto:daniel@netwalk.org[daniel@netwalk.org]
+* Daniel Bryan mailto:sisko@bsdmail.com[sisko@bsdmail.com]
+* Daniel Hagan mailto:dhagan@acm.vt.edu[dhagan@acm.vt.edu]
+* Daniel Levai mailto:leva@ecentrum.hu[leva@ecentrum.hu]
+* Daniel J. O'Connor mailto:darius@dons.net.au[darius@dons.net.au]
+* Daniel O'Connor mailto:doconnor@gsoft.com.au[doconnor@gsoft.com.au]
+* Daniel Poirot mailto:poirot@aio.jsc.nasa.gov[poirot@aio.jsc.nasa.gov]
+* Daniel Rock mailto:rock@cs.uni-sb.de[rock@cs.uni-sb.de]
+* Daniel Roethlisberger mailto:daniel@roe.ch[daniel@roe.ch]
+* Daniel Tihanyi mailto:daniel.tihanyi@tetragir.com[daniel.tihanyi@tetragir.com]
+* Daniel W. McRobb mailto:dwm@caimis.com[dwm@caimis.com]
+* Daniel W. Steinbrook mailto:dsteinbr@fas.harvard.edu[dsteinbr@fas.harvard.edu]
+* Daniel Wijnands mailto:daniel@itxl.nl[daniel@itxl.nl]
+* Daniel Ylitalo mailto:daniel@blodan.se[daniel@blodan.se]
+* Danny Braniss mailto:danny@cs.huji.ac.il[danny@cs.huji.ac.il]
+* Danny Egen
+* Danny Howard mailto:dannyman@toldme.com[dannyman@toldme.com]
+* Danny J. Zerkel mailto:dzerkel@phofarm.com[dzerkel@phofarm.com]
+* Danny Pansters mailto:danny@ricin.com[danny@ricin.com]
+* Dario Freni mailto:saturnero@gufi.org[saturnero@gufi.org]
+* Darren Pilgrim mailto:ports.maintainer@evilphi.com[ports.maintainer@evilphi.com]
+* Dave Adkins mailto:adkin003@tc.umn.edu[adkin003@tc.umn.edu]
+* Dave Andersen mailto:angio@aros.net[angio@aros.net]
+* Dave Blizzard mailto:dblizzar@sprynet.com[dblizzar@sprynet.com]
+* Dave Bodenstab mailto:imdave@synet.net[imdave@synet.net]
+* Dave Burgess mailto:burgess@hrd769.brooks.af.mil[burgess@hrd769.brooks.af.mil]
+* Dave Chapeskie mailto:dchapes@ddm.on.ca[dchapes@ddm.on.ca]
+* Dave Cornejo mailto:dave@dogwood.com[dave@dogwood.com]
+* Dave Edmondson mailto:davided@sco.com[davided@sco.com]
+* Dave Glowacki mailto:dglo@ssec.wisc.edu[dglo@ssec.wisc.edu]
+* Dave Green mailto:dg@fastmail.co.uk[dg@fastmail.co.uk]
+* Dave Marquardt mailto:marquard@austin.ibm.com[marquard@austin.ibm.com]
+* {tweten}
+* David A. Adkins mailto:adkin003@tc.umn.edu[adkin003@tc.umn.edu]
+* David A. Bader mailto:dbader@eece.unm.edu[dbader@eece.unm.edu]
+* David Borman mailto:dab@bsdi.com[dab@bsdi.com]
+* David Bremner mailto:bremner@unb.ca[bremner@unb.ca]
+* David Bushong mailto:david+ports@bushong.net[david+ports@bushong.net]
+* David Chaplin-Loebell mailto:direct@klatha.com[direct@klatha.com]
+* Davide D'Amico mailto:dave@gufi.org[dave@gufi.org]
+* David Dawes mailto:dawes@XFree86.org[dawes@XFree86.org]
+* David Demelier mailto:markand@malikania.fr[markand@malikania.fr]
+* David Filo
+* David G. Holm mailto:harbour@netfang.net[harbour@netfang.net]
+* David Gardner mailto:david@pinko.net[david@pinko.net]
+* David Gilbert mailto:dave@daveg.ca[dave@daveg.ca]
+* David H. Munro mailto:munro1@llnl.gov[munro1@llnl.gov]
+* David Holland mailto:dholland@eecs.harvard.edu[dholland@eecs.harvard.edu]
+* David Holloway mailto:daveh@gwythaint.tamis.com[daveh@gwythaint.tamis.com]
+* David Horwitt mailto:dhorwitt@ucsd.edu[dhorwitt@ucsd.edu]
+* David Hovemeyer mailto:daveho@infocom.com[daveho@infocom.com]
+* David Johnson mailto:david@usermode.org[david@usermode.org]
+* David Jones mailto:dej@qpoint.torfree.net[dej@qpoint.torfree.net]
+* David Julien mailto:david.julien@gmail.com[david.julien@gmail.com]
+* David K. Gerry mailto:David.K.Gerry@GMail.com[David.K.Gerry@GMail.com]
+* David Kalliecharan mailto:dave@dal.ca[dave@dal.ca]
+* David Kelly mailto:dkelly@tomcat1.tbe.com[dkelly@tomcat1.tbe.com]
+* David Kirchner mailto:dpk@dpk.net[dpk@dpk.net]
+* David Kulp mailto:dkulp@neomorphic.com[dkulp@neomorphic.com]
+* David L. Nugent mailto:davidn@blaze.net.au[davidn@blaze.net.au]
+* David Landgren mailto:david@landgren.net[david@landgren.net]
+* David Lay mailto:dsl@webize.com.au[dsl@webize.com.au]
+* David Le Brun mailto:david@trucs.org[david@trucs.org]
+* David Leonard mailto:d@scry.dstc.edu.au[d@scry.dstc.edu.au]
+* David Magda mailto:dmagda@magda.ca[dmagda@magda.ca]
+* David Muir Sharnoff mailto:muir@idiom.com[muir@idiom.com]
+* David O'Rourke mailto:dor.bsd@xm0.uk[dor.bsd@xm0.uk]
+* David Otto mailto:ottodavid@gmx.net[ottodavid@gmx.net]
+* David Quattlebaum mailto:drq@drqware.com[drq@drqware.com]
+* David Romano mailto:unobe@cpan.org[unobe@cpan.org]
+* David S. Miller mailto:davem@jenolan.rutgers.edu[davem@jenolan.rutgers.edu]
+* David Shane Holden mailto:dpejesh@yahoo.com[dpejesh@yahoo.com]
+* David Siebörger mailto:drs@rucus.ru.ac.za[drs@rucus.ru.ac.za]
+* David Sugar mailto:dyfet@gnu.org[dyfet@gnu.org]
+* David Syphers mailto:dsyphers@u.washington.edu[dsyphers@u.washington.edu]
+* David Sze mailto:dsze@alumni.uwaterloo.ca[dsze@alumni.uwaterloo.ca]
+* David Terry mailto:dterry@digifonica.com[dterry@digifonica.com]
+* David Vachulka mailto:arch_dvx@users.sourceforge.net[arch_dvx@users.sourceforge.net]
+* David Wolfskill mailto:david@catwhisker.org[david@catwhisker.org]
+* David Yeske mailto:dyeske@yahoo.com[dyeske@yahoo.com]
+* Dax Labrador mailto:semprix@bsdmail.org[semprix@bsdmail.org]
+* Dean Gaudet mailto:dgaudet@arctic.org[dgaudet@arctic.org]
+* Dean Hollister mailto:dean@odyssey.apana.org.au[dean@odyssey.apana.org.au]
+* Dean Huxley mailto:dean@fsa.ca[dean@fsa.ca]
+* Demetris Procopiou mailto:dem.procopiou@gmail.com[dem.procopiou@gmail.com]
+* Denis Barov mailto:dindin@dindin.ru[dindin@dindin.ru]
+* Denis Fortin
+* Denis Generalov mailto:gd@rambler-co.ru[gd@rambler-co.ru]
+* Denis Philippov mailto:for_spam@mezon.ru[for_spam@mezon.ru]
+* Denis E. Podolskiy mailto:bytestore@yandex.ru[bytestore@yandex.ru]
+* Denis Pokataev mailto:catone@cpan.org[catone@cpan.org]
+* Denis Shaposhnikov mailto:dsh@vlink.ru[dsh@vlink.ru]
+* Dennis Cabooter mailto:dennis@rootxs.org[dennis@rootxs.org]
+* Dennis Glatting mailto:dennis.glatting@software-munitions.com[dennis.glatting@software-munitions.com]
+* Dennis S. Davidoff mailto:null@cvs.1system.ru[null@cvs.1system.ru]
+* Denton Gentry mailto:denny1@home.com[denny1@home.com]
+* Derek E. Schrock mailto:dereks@lifeofadishwasher.com[dereks@lifeofadishwasher.com]
+* Derek Inksetter mailto:derek@saidev.com[derek@saidev.com]
+* Derik van Zuetphen mailto:dz@426.ch[dz@426.ch]
+* Dermot Tynan mailto:dtynan@kalopa.com[dtynan@kalopa.com]
+* Dhananjay Balan mailto:mail@dbalan.in[mail@dbalan.in]
+* Diego Depaoli mailto:trebestie@gmail.com[trebestie@gmail.com]
+* Dikshie mailto:dikshie@lapi.itb.ac.id[dikshie@lapi.itb.ac.id]
+* Dikshie mailto:dikshie@sfc.wide.ad.jp[dikshie@sfc.wide.ad.jp]
+* Dierk Sacher mailto:dierk@blaxxtarz.de[dierk@blaxxtarz.de]
+* Dirk Engling mailto:erdgeist@erdgeist.org[erdgeist@erdgeist.org]
+* Dirk Gouders mailto:gouders@et.bocholt.fh-gelsenkirchen.de[gouders@et.bocholt.fh-gelsenkirchen.de]
+* Dirk Jagdmann mailto:doj@cubic.org[doj@cubic.org]
+* Dirk Keunecke mailto:dk@panda.rhein-main.de[dk@panda.rhein-main.de]
+* Dirk Nehrling mailto:nerle@pdv.de[nerle@pdv.de]
+* Dirk-Willem van Gulik mailto:dirkx@webweaving.org[dirkx@webweaving.org]
+* Ditesh Shashikant Gathani mailto:ditesh@gathani.org[ditesh@gathani.org]
+* Dmitri Nikulin mailto:setagllib@optusnet.com.au[setagllib@optusnet.com.au]
+* Dmitriy Limonov mailto:earl1k@mail.ru[earl1k@mail.ru]
+* Dmitry A. Yanko mailto:fm@astral.ntu-kpi.kiev.ua[fm@astral.ntu-kpi.kiev.ua]
+* Dmitry Afanasiev mailto:KOT@MATPOCKuH.Ru[KOT@MATPOCKuH.Ru]
+* Dmitry Dyomin mailto:old@old.com.ua[old@old.com.ua]
+* Dmitry Karasik mailto:dmitry@karasik.eu.org[dmitry@karasik.eu.org]
+* Dmitry Kazarov mailto:d.y.kazarov@mail.ru[d.y.kazarov@mail.ru]
+* Dmitry Khrustalev mailto:dima@xyzzy.machaon.ru[dima@xyzzy.machaon.ru]
+* Dmitry Kohmanyuk mailto:dk@farm.org[dk@farm.org]
+* Dmitry Pryadko mailto:d.pryadko@rambler-co.ru[d.pryadko@rambler-co.ru]
+* Dmitry Semkin mailto:ds@tic-tac.ru[ds@tic-tac.ru]
+* Dmitry V. Sukhodoyev mailto:raven428@gmail.com[raven428@gmail.com]
+* Dmitry Wagin mailto:dmitry.wagin@ya.ru[dmitry.wagin@ya.ru]
+* Dmytro Rud mailto:unixoid@yahoo.com[unixoid@yahoo.com]
+* Dom Mitchell mailto:dom@myrddin.demon.co.uk[dom@myrddin.demon.co.uk]
+* Domas Mituzas mailto:midom@dammit.lt[midom@dammit.lt]
+* Dominic Marks mailto:dominic_marks@btinternet.com[dominic_marks@btinternet.com]
+* Dominic Mitchell mailto:dom@happygiraffe.net[dom@happygiraffe.net]
+* Dominik Brettnacher mailto:domi@saargate.de[domi@saargate.de]
+* Dominik Rothert mailto:dr@domix.de[dr@domix.de]
+* Dominique Goncalves mailto:dominique.goncalves@gmail.com[dominique.goncalves@gmail.com]
+* Don Croyle mailto:croyle@gelemna.org[croyle@gelemna.org]
+* Don Morrison mailto:dmorrisn@u.washington.edu[dmorrisn@u.washington.edu]
+* Don Owens mailto:don@regexguy.com[don@regexguy.com]
+* {whiteside}
+* Don Yuniskis mailto:dgy@rtd.com[dgy@rtd.com]
+* Donald Maddox mailto:dmaddox099@yahoo.com[dmaddox099@yahoo.com]
+* Donn Miller mailto:dmmiller@cvzoom.net[dmmiller@cvzoom.net]
+* Doug Harple mailto:dharple@nycap.rr.com[dharple@nycap.rr.com]
+* Doug Penner mailto:darwinsurvivor@gmail.com[darwinsurvivor@gmail.com]
+* Douglas A. Maske mailto:maske@rungepaper.com[maske@rungepaper.com]
+* Douglas Carmichael mailto:dcarmich@mcs.com[dcarmich@mcs.com]
+* Douglas Crosher mailto:dtc@scrooge.ee.swin.oz.au[dtc@scrooge.ee.swin.oz.au]
+* Douglas K. Rand mailto:rand@meridian-enviro.com[rand@meridian-enviro.com]
+* Douglas W. Thrift mailto:douglas@douglasthrift.net[douglas@douglasthrift.net]
+* Drew Derbyshire mailto:ahd@kew.com[ahd@kew.com]
+* Dries Michiels mailto:driesm.michiels@gmail.com[driesm.michiels@gmail.com]
+* Dustin Sallings mailto:dustin@spy.net[dustin@spy.net]
+* Dylan Carlson mailto:absinthe@retrovertigo.com[absinthe@retrovertigo.com]
+* Dylan Simon mailto:dylan@dylex.net[dylan@dylex.net]
+* ELISA Font Project
+* Eckart "Isegrim" Hofmann mailto:Isegrim@Wunder-Nett.org[Isegrim@Wunder-Nett.org]
+* Ed Gold mailto:vegold01@starbase.spd.louisville.edu[vegold01@starbase.spd.louisville.edu]
+* Ed Hudson mailto:elh@p5.spnet.com[elh@p5.spnet.com]
+* Ederson de Moura mailto:ederbs@ederbs.org[ederbs@ederbs.org]
+* Edgardo Garcia Hoeffler mailto:edybsd@yahoo.com.ar[edybsd@yahoo.com.ar]
+* Edmondas Girkantas mailto:eg@fbsd.lt[eg@fbsd.lt]
+* Eduard Martinescu mailto:martines@rochester.rr.com[martines@rochester.rr.com]
+* Edward Chuang mailto:edwardc@firebird.org.tw[edwardc@firebird.org.tw]
+* Edward Wang mailto:edward@edcom.com[edward@edcom.com]
+* Edwin Mons mailto:e@ik.nu[e@ik.nu]
+* Eero Hänninen mailto:fax@nohik.ee[fax@nohik.ee]
+* Ege Rekk mailto:aagero@aage.priv.no[aagero@aage.priv.no]
+* Eiji-usagi-MATSUmoto mailto:usagi@clave.gr.jp[usagi@clave.gr.jp]
+* Eijiro Shibusawa mailto:ej-sib@ice.uec.ac.jp[ej-sib@ice.uec.ac.jp]
+* Eike Bernhardt mailto:eike.bernhardt@gmx.de[eike.bernhardt@gmx.de]
+* Eintisy Chuang mailto:eintisy@gmail.com[eintisy@gmail.com]
+* Eliane Vidal mailto:macevidal@gmail.com[macevidal@gmail.com]
+* Elias Mandouvalos mailto:ocean@mail.gr[ocean@mail.gr]
+* Elisey Savateev mailto:b3k@mail.ru[b3k@mail.ru]
+* Elmar Bartel mailto:bartel@informatik.tu-muenchen.de[bartel@informatik.tu-muenchen.de]
+* Emily Boyd mailto:emily@emilyboyd.com[emily@emilyboyd.com]
+* Eoin Lawless mailto:eoin@maths.tcd.ie[eoin@maths.tcd.ie]
+* Eric A. Griff mailto:eric@talesfromthereal.com[eric@talesfromthereal.com]
+* Eric Anderson mailto:anderson@centtech.com[anderson@centtech.com]
+* Eric Blood mailto:eblood@cs.unr.edu[eblood@cs.unr.edu]
+* Eric Camachat mailto:eric@camachat.org[eric@camachat.org]
+* Eric Cronin mailto:ecronin@eecs.umich.edu[ecronin@eecs.umich.edu]
+* Eric D. Futch mailto:efutch@nyct.net[efutch@nyct.net]
+* Eric F. Crist mailto:ecrist@secure-computing.net[ecrist@secure-computing.net]
+* Eric Freeman mailto:freebsdports@chillibear.com[freebsdports@chillibear.com]
+* Eric J. Haug mailto:ejh@slustl.slu.edu[ejh@slustl.slu.edu]
+* Eric J. Schwertfeger mailto:eric@cybernut.com[eric@cybernut.com]
+* Eric Kjeldergaard mailto:kjelderg@gmail.com[kjelderg@gmail.com]
+* Eric L. Hernes mailto:erich@lodgenet.com[erich@lodgenet.com]
+* Eric Masson mailto:e-masson@kisoft-services.com[e-masson@kisoft-services.com]
+* Eric Ogren mailto:eogren@stanford.edu[eogren@stanford.edu]
+* Eric P. Scott mailto:eps@sirius.com[eps@sirius.com]
+* Eric Schnoebelen mailto:eric@cirr.com[eric@cirr.com]
+* Eric Shao-yu Cheng mailto:eric@fractal.csie.org[eric@fractal.csie.org]
+* Eric Sprinkle mailto:eric@ennovatenetworks.com[eric@ennovatenetworks.com]
+* Eric W. Bates mailto:ericx@vineyard.net[ericx@vineyard.net]
+* Eric Yu mailto:ericyu@mail2000.com.tw[ericyu@mail2000.com.tw]
+* Erich Stefan Boleyn mailto:erich@uruk.org[erich@uruk.org]
+* Erich Zigler mailto:erich@tacni.net[erich@tacni.net]
+* Erik E. Rantapaa mailto:rantapaa@math.umn.edu[rantapaa@math.umn.edu]
+* Erik Greenwald mailto:erik@smluc.org[erik@smluc.org]
+* Erik H. Bakke mailto:erikhb@bgnett.no[erikhb@bgnett.no]
+* Erik H. Moe mailto:ehm@cris.com[ehm@cris.com]
+* Erik L. Chen mailto:d9364104@mail.nchu.edu.tw[d9364104@mail.nchu.edu.tw]
+* Ernie Smallis mailto:esmallis@stbernard.com[esmallis@stbernard.com]
+* Ernst Winter (http://berklix.org/ewinter/[Deceased])
+* Espen Skoglund mailto:esk@ira.uka.de[esk@ira.uka.de]
+* Espen Tagestad mailto:espen@tagestad.no[espen@tagestad.no]
+* Eugene M. Kim mailto:astralblue@usa.net[astralblue@usa.net]
+* Eugene Ossintsev mailto:eugos@gmx.net[eugos@gmx.net]
+* Eugene Radchenko mailto:genie@qsar.chem.msu.su[genie@qsar.chem.msu.su]
+* Eugene Ray mailto:pal@paladin7.net[pal@paladin7.net]
+* Eugene Zheganin mailto:eugene@zhegan.in[eugene@zhegan.in]
+* Eugeney Ryzhyk mailto:rzheka@users.sourceforge.net[rzheka@users.sourceforge.net]
+* Eugeny Kuzakov mailto:CoreDumped@coredumped.null.ru[CoreDumped@coredumped.null.ru]
+* Evan Champion mailto:evanc@synapse.net[evanc@synapse.net]
+* Evan Sarmiento mailto:esarmiento@wayfair.com[esarmiento@wayfair.com]
+* Evgueni V. Gavrilov mailto:aquatique@rusunix.org[aquatique@rusunix.org]
+* Ewgenij Gawrilow mailto:gawrilow@math.tu-berlin.de[gawrilow@math.tu-berlin.de]
+* FUJIMOTO Kensaku mailto:fujimoto@oscar.elec.waseda.ac.jp[fujimoto@oscar.elec.waseda.ac.jp]
+* FURUSAWA Kazuhisa mailto:furusawa@com.cs.osakafu-u.ac.jp[furusawa@com.cs.osakafu-u.ac.jp]
+* Fabian Freyer mailto:fabian.freyer@physik.tu-berlin.de[fabian.freyer@physik.tu-berlin.de]
+* Fabian Keil mailto:fk@fabiankeil.de[fk@fabiankeil.de]
+* Fabian M. Borschel mailto:fmb@onibox.net[fmb@onibox.net]
+* Fabiano Sidler mailto:fabianosidler@swissonline.ch[fabianosidler@swissonline.ch]
+* Fabien Devaux mailto:fab@gcu.info[fab@gcu.info]
+* Fabio Tosques mailto:fabio.tosques@rz.hu-berlin.de[fabio.tosques@rz.hu-berlin.de]
+* Fabrice Aneche mailto:akh@nobugware.com[akh@nobugware.com]
+* Fangrui Song mailto:i@maskray.me[i@maskray.me]
+* Fanying Jen mailto:fanying@fynet.com[fanying@fynet.com]
+* Faried Nawaz mailto:fn@Hungry.COM[fn@Hungry.COM]
+* Felix Palmen mailto:felix@palmen-it.de[felix@palmen-it.de]
+* Fernan Aguero mailto:fernan@iib.unsam.edu.ar[fernan@iib.unsam.edu.ar]
+* Ferruccio Vitale mailto:vitale@cs.tin.it[vitale@cs.tin.it]
+* Filipe Rocha mailto:filiperocha@gmail.com[filiperocha@gmail.com]
+* Filippo Natali mailto:filippo@widestore.net[filippo@widestore.net]
+* Flemming Jacobsen mailto:fj@batmule.dk[fj@batmule.dk]
+* Florian Unglaub mailto:usenet04@rootofallevil.net[usenet04@rootofallevil.net]
+* Fong-Ching Liaw mailto:fong@juniper.net[fong@juniper.net]
+* Francis M J Hsieh mailto:mjshieh@life.nthu.edu.tw[mjshieh@life.nthu.edu.tw]
+* Francisco Cabrita mailto:include@npf.pt.freebsd.org[include@npf.pt.freebsd.org]
+* Francisco Gomez mailto:francisco@gomezmarin.com[francisco@gomezmarin.com]
+* Francisco Reyes mailto:fjrm@yahoo.com[fjrm@yahoo.com]
+* François Tamone mailto:tamone@eig.unige.ch[tamone@eig.unige.ch]
+* Frank Bartels mailto:knarf@camelot.de[knarf@camelot.de]
+* Frank Behrens mailto:frank@pinky.sax.de[frank@pinky.sax.de]
+* Frank Börner mailto:frank-freebsd@online.de[frank-freebsd@online.de]
+* Frank Chen Hsiung Chan mailto:frankch@waru.life.nthu.edu.tw[frankch@waru.life.nthu.edu.tw]
+* Frank Denis mailto:j@pureftpd.org[j@pureftpd.org]
+* Frank Gründer mailto:elwood@mc5sys.in-berlin.de[elwood@mc5sys.in-berlin.de]
+* Frank MacLachlan mailto:fpm@n2.net[fpm@n2.net]
+* Frank Mayhar mailto:frank@exit.com[frank@exit.com]
+* Frank Nobis mailto:fn@Radio-do.de[fn@Radio-do.de]
+* Frank Ruell mailto:stoerte@dreamwarrior.net[stoerte@dreamwarrior.net]
+* Frank Steinborn mailto:steinex@nognu.de[steinex@nognu.de]
+* Frank Volf mailto:volf@oasis.IAEhv.nl[volf@oasis.IAEhv.nl]
+* Frank Wall mailto:fw@moov.de[fw@moov.de]
+* Frank W. Josellis mailto:frank@dynamical-systems.org[frank@dynamical-systems.org]
+* Frank ten Wolde mailto:franky@pinewood.nl[franky@pinewood.nl]
+* Frank van der Linden mailto:frank@fwi.uva.nl[frank@fwi.uva.nl]
+* Franz Klammer mailto:klammer@webonaut.com[klammer@webonaut.com]
+* Fraser Tweedale mailto:frase@frase.id.au[frase@frase.id.au]
+* Fred Cawthorne mailto:fcawth@jjarray.umn.edu[fcawth@jjarray.umn.edu]
+* Fred Gilham mailto:gilham@csl.sri.com[gilham@csl.sri.com]
+* Fred Templin mailto:templin@erg.sri.com[templin@erg.sri.com]
+* Freddie Cash mailto:fcash@bigfoot.com[fcash@bigfoot.com]
+* Frederic Dubuy mailto:fdubuy@free.fr[fdubuy@free.fr]
+* Frédéric Praca mailto:frederic.praca@freebsd-fr.org[frederic.praca@freebsd-fr.org]
+* Frederick Earl Gray mailto:fgray@rice.edu[fgray@rice.edu]
+* Fredrik Lennmark mailto:fredrik@min-hemsida.net[fredrik@min-hemsida.net]
+* Fredrik Lindberg mailto:fli@shapeshifter.se[fli@shapeshifter.se]
+* Frerich Raabe mailto:frerich.raabe@gmx.de[frerich.raabe@gmx.de]
+* Fumihiko Kimura mailto:jfkimura@yahoo.co.jp[jfkimura@yahoo.co.jp]
+* Fuyuhiko Maruyama mailto:fuyuhik8@is.titech.ac.jp[fuyuhik8@is.titech.ac.jp]
+* {stanislav}
+* Gábor Kincses mailto:gabor@acm.org[gabor@acm.org]
+* Gábor Zahemszky mailto:zgabor@CoDe.hu[zgabor@CoDe.hu]
+* Gasol Wu mailto:gasol.wu@gmail.com[gasol.wu@gmail.com]
+* Gabriel Dutra mailto:0xdutra@gmail.com[0xdutra@gmail.com]
+* Gabriel Rizzo mailto:gabriel96.gsr@gmail.com[gabriel96.gsr@gmail.com]
+* Gareth McCaughan mailto:gjm11@dpmms.cam.ac.uk[gjm11@dpmms.cam.ac.uk]
+* Garrett Rooney mailto:rooneg@electricjellyfish.net[rooneg@electricjellyfish.net]
+* Gary A. Browning mailto:gab10@griffcd.amdahl.com[gab10@griffcd.amdahl.com]
+* Gary Hayers mailto:gary@hayers.org[gary@hayers.org]
+* Gary Howland mailto:gary@hotlava.com[gary@hotlava.com]
+* Gary J. mailto:garyj@rks32.pcs.dec.com[garyj@rks32.pcs.dec.com]
+* Gary Kline mailto:kline@thought.org[kline@thought.org]
+* Gaspar Chilingarov mailto:nightmar@lemming.acc.am[nightmar@lemming.acc.am]
+* Gautam Mani mailto:execve@gmail.com[execve@gmail.com]
+* Gavin McDonald mailto:gavin@16degrees.com.au[gavin@16degrees.com.au]
+* Gavin Mu mailto:gavin@FreeBSDChina.org[gavin@FreeBSDChina.org]
+* Gea-Suan Lin mailto:gslin@gslin.org[gslin@gslin.org]
+* Geoff Glasson mailto:g_glasson@jimali.dyndns.org[g_glasson@jimali.dyndns.org]
+* Geoff Rehmet mailto:csgr@alpha.ru.ac.za[csgr@alpha.ru.ac.za]
+* Geoffrey Mainland mailto:mainland@apeiron.net[mainland@apeiron.net]
+* Geoffroy Rivat mailto:grivat@sicfa.net[grivat@sicfa.net]
+* Georg Graf mailto:georg@graf.priv.at[georg@graf.priv.at]
+* Georg Wagner mailto:georg.wagner@ubs.com[georg.wagner@ubs.com]
+* George Hartzell mailto:hartzell@kestrel.alerce.com[hartzell@kestrel.alerce.com]
+* George Liaskos mailto:geo.liaskos@gmail.com[geo.liaskos@gmail.com]
+* Gerasimos Dimitriadis mailto:gedimitr@auth.gr[gedimitr@auth.gr]
+* Geraud Continsouzas mailto:geraud@gcu.info[geraud@gcu.info]
+* Gerhard Gonter mailto:g.gonter@ieee.org[g.gonter@ieee.org]
+* Gerrit Beine mailto:tux@pinguru.net[tux@pinguru.net]
+* Giacomo Mariani mailto:giacomomariani@yahoo.it[giacomomariani@yahoo.it]
+* Gianlorenzo Masini mailto:masini@uniroma3.it[masini@uniroma3.it]
+* Gianmarco Giovannelli mailto:gmarco@giovannelli.it[gmarco@giovannelli.it]
+* Gil Kloepfer Jr. mailto:gil@limbic.ssdl.com[gil@limbic.ssdl.com]
+* Gilad Rom mailto:rom_glsa@ein-hashofet.co.il[rom_glsa@ein-hashofet.co.il]
+* Gilbert Morgan mailto:gmm@tutanota.com[gmm@tutanota.com]
+* Giles Lean mailto:giles@nemeton.com.au[giles@nemeton.com.au]
+* Ginga Kawaguti mailto:ginga@amalthea.phys.s.u-tokyo.ac.jp[ginga@amalthea.phys.s.u-tokyo.ac.jp]
+* Gleb Sushko mailto:neuroworker@gmail.com[neuroworker@gmail.com]
+* Glen Foster mailto:gfoster@gfoster.com[gfoster@gfoster.com]
+* Giel van Schijndel mailto:me@mortis.eu[me@mortis.eu]
+* Glenn Johnson mailto:gljohns@bellsouth.net[gljohns@bellsouth.net]
+* Godmar Back mailto:gback@facility.cs.utah.edu[gback@facility.cs.utah.edu]
+* Goran Hammarback mailto:goran@astro.uu.se[goran@astro.uu.se]
+* Goran Mekić mailto:meka@tilda.center[meka@tilda.center]
+* Gord Matzigkeit mailto:gord@enci.ucalgary.ca[gord@enci.ucalgary.ca]
+* Gordon Greeff mailto:gvg@uunet.co.za[gvg@uunet.co.za]
+* Graham Wheeler mailto:gram@cdsec.com[gram@cdsec.com]
+* Greg A. Woods mailto:woods@zeus.leitch.com[woods@zeus.leitch.com]
+* Greg Albrecht mailto:gregoryba@gmail.com[gregoryba@gmail.com]
+* Greg Ansley mailto:gja@ansley.com[gja@ansley.com]
+* Greg Becker mailto:greg@codeconcepts.com[greg@codeconcepts.com]
+* Greg Fitzgerald mailto:gregf@hugops.pw[gregf@hugops.pw]
+* Greg J. mailto:xcas@cox.net[xcas@cox.net]
+* Greg Kennedy mailto:kennedy.greg@gmail.com[kennedy.greg@gmail.com]
+* Greg Robinson mailto:greg@rosevale.com.au[greg@rosevale.com.au]
+* Greg Troxel mailto:gdt@ir.bbn.com[gdt@ir.bbn.com]
+* Greg Ungerer mailto:gerg@stallion.oz.au[gerg@stallion.oz.au]
+* Gregory Bond mailto:gnb@itga.com.au[gnb@itga.com.au]
+* Gregory D. Moncreaff mailto:moncrg@bt340707.res.ray.com[moncrg@bt340707.res.ray.com]
+* Grün Christian-Rolf mailto:kiki@bsdro.org[kiki@bsdro.org]
+* Guillaume Paquet mailto:amyfoub@videotron.ca[amyfoub@videotron.ca]
+* Gurkan Sengun mailto:grknsngn@gmail.com[grknsngn@gmail.com]
+* Gustau Pérez mailto:gustau.perez@gmail.com[gustau.perez@gmail.com]
+* Gustavo Fukao mailto:gustavofukao@gmail.com[gustavofukao@gmail.com]
+* Guy Brand mailto:gb@isis.u-strasbg.fr[gb@isis.u-strasbg.fr]
+* Guy Coleman mailto:gtchask@mm.st[gtchask@mm.st]
+* Guy Harris mailto:guy@netapp.com[guy@netapp.com]
+* Guy Poizat mailto:guy@device.dyndns.org[guy@device.dyndns.org]
+* Guy Tabrar mailto:guy.tabrar@me.com[guy.tabrar@me.com]
+* H. Wade Minter mailto:minter@lunenburg.org[minter@lunenburg.org]
+* HAMADA Naoki mailto:hamada@astec.co.jp[hamada@astec.co.jp]
+* HATANOU Tomomi mailto:hatanou@infolab.ne.jp[hatanou@infolab.ne.jp]
+* HIYAMA Takeshi mailto:gibbon@cocoa.freemail.ne.jp[gibbon@cocoa.freemail.ne.jp]
+* HONDA Yasuhiro mailto:honda@kashio.info.mie-u.ac.jp[honda@kashio.info.mie-u.ac.jp]
+* HOSOBUCHI Noriyuki mailto:hoso@buchi.tama.or.jp[hoso@buchi.tama.or.jp]
+* HOTARU-YA mailto:hotaru@tail.net[hotaru@tail.net]
+* Haesu Jeon mailto:haesu@towardex.com[haesu@towardex.com]
+* Hakisho Nukama mailto:nukama@gmail.com[nukama@gmail.com]
+* Hammurabi Mendes mailto:hmendes_br@yahoo.com[hmendes_br@yahoo.com]
+* Hannes Frederic Sowa mailto:hannes@stressinduktion.org[hannes@stressinduktion.org]
+* Hannu Savolainen mailto:hannu@voxware.pp.fi[hannu@voxware.pp.fi]
+* Hans Huebner mailto:hans@artcom.de[hans@artcom.de]
+* Hans Petter Bieker mailto:zerium@webindex.no[zerium@webindex.no]
+* Hans Petter Selasky mailto:hselasky@c2i.net[hselasky@c2i.net]
+* Hans Zuidam mailto:hans@brandinnovators.com[hans@brandinnovators.com]
+* Hans-Christian Ebke mailto:hans-christian_ebke@gmx.de[hans-christian_ebke@gmx.de]
+* Hansjoerg Pehofer mailto:hansjoerg.pehofer@uibk.ac.at[hansjoerg.pehofer@uibk.ac.at]
+* Harald Schmalzbauer mailto:h.schmalzbauer@omnisec.de[h.schmalzbauer@omnisec.de]
+* Harald Wille mailto:harald.wille@students.jku.at[harald.wille@students.jku.at]
+* Hardy Schumacher mailto:hardy.schumacher@gmx.de[hardy.schumacher@gmx.de]
+* Harlan Stenn mailto:Harlan.Stenn@pfcs.com[Harlan.Stenn@pfcs.com]
+* Harold Barker mailto:hbarker@dsms.com[hbarker@dsms.com]
+* Harry Coin mailto:harrycoin@qconline.com[harrycoin@qconline.com]
+* Harry Newton mailto:harry_newton@telinco.co.uk[harry_newton@telinco.co.uk]
+* Havard Eidnes mailto:Havard.Eidnes@runit.sintef.no[Havard.Eidnes@runit.sintef.no]
+* Heath Nielson mailto:heath@cs.byu.edu[heath@cs.byu.edu]
+* Heikki Suonsivu mailto:hsu@cs.hut.fi[hsu@cs.hut.fi]
+* Heiko W. Rupp
+* Heiner Eichmann mailto:h.eichmann@gmx.de[h.eichmann@gmx.de]
+* Heiner Strauss mailto:heiner@bilch.com[heiner@bilch.com]
+* Helko Glathe mailto:glathe.helko@googlemail.com[glathe.helko@googlemail.com]
+* Helmut F. Wirth mailto:hfwirth@ping.at[hfwirth@ping.at]
+* Hendrik Scholz mailto:hendrik@scholz.net[hendrik@scholz.net]
+* Henning Matyschok mailto:henning.matyschok@outlook.com[henning.matyschok@outlook.com]
+* Henri Michelon mailto:michelon@e-cml.org[michelon@e-cml.org]
+* Henrik Brautaset Aronsen mailto:freebsd-ports@henrik.synth.no[freebsd-ports@henrik.synth.no]
+* Henrik Friedrichsen mailto:hrkfrd@googlemail.com[hrkfrd@googlemail.com]
+* Henrik Holst mailto:henrik.holst@millistream.com[henrik.holst@millistream.com]
+* Henrik Motakef mailto:henrik.motakef@web.de[henrik.motakef@web.de]
+* Henrik Nymann Jensen mailto:henriknj@0xmilk.org[henriknj@0xmilk.org]
+* Henrik Vestergaard Draboel mailto:hvd@terry.ping.dk[hvd@terry.ping.dk]
+* Henry Hu mailto:henry.hu.sh@gmail.com[henry.hu.sh@gmail.com]
+* Henry Whincup mailto:henry@techiebod.com[henry@techiebod.com]
+* Herb Peyerl mailto:hpeyerl@NetBSD.org[hpeyerl@NetBSD.org]
+* Herbert J. Skuhra mailto:herbert.skuhra@gmx.at[herbert.skuhra@gmx.at]
+* Hernan Di Pietro mailto:hernan.di.pietro@gmail.com[hernan.di.pietro@gmail.com]
+* Hideaki Machida mailto:hido@coreblack.com[hido@coreblack.com]
+* Hideaki Ohmon mailto:ohmon@tom.sfc.keio.ac.jp[ohmon@tom.sfc.keio.ac.jp]
+* Hidekazu Kuroki mailto:hidekazu@cs.titech.ac.jp[hidekazu@cs.titech.ac.jp]
+* Hideki Yamamoto mailto:hyama@acm.org[hyama@acm.org]
+* Hideyuki Suzuki mailto:hideyuki@sat.t.u-tokyo.ac.jp[hideyuki@sat.t.u-tokyo.ac.jp]
+* Hirayama Issei mailto:iss@mail.wbs.ne.jp[iss@mail.wbs.ne.jp]
+* Hiroaki Sakai mailto:sakai@miya.ee.kagu.sut.ac.jp[sakai@miya.ee.kagu.sut.ac.jp]
+* Hiroharu Tamaru mailto:tamaru@ap.t.u-tokyo.ac.jp[tamaru@ap.t.u-tokyo.ac.jp]
+* Hirohisa Yamaguchi mailto:umq@ueo.co.jp[umq@ueo.co.jp]
+* Hironori Ikura mailto:hikura@kaisei.org[hikura@kaisei.org]
+* Hiroshi Nishikawa mailto:nis@pluto.dti.ne.jp[nis@pluto.dti.ne.jp]
+* Hiroto Kagotani mailto:hiroto.kagotani@gmail.com[hiroto.kagotani@gmail.com]
+* Hiroya Tsubakimoto
+* Holger Lamm mailto:holger@eit.uni-kl.de[holger@eit.uni-kl.de]
+* Holger Veit mailto:Holger.Veit@gmd.de[Holger.Veit@gmd.de]
+* Holm Tiffe mailto:holm@geophysik.tu-freiberg.de[holm@geophysik.tu-freiberg.de]
+* Horance Chou mailto:horance@freedom.ie.cycu.edu.tw[horance@freedom.ie.cycu.edu.tw]
+* Horia Racoviceanu mailto:horia@racoviceanu.com[horia@racoviceanu.com]
+* Horihiro Kumagai mailto:kuma@jp.FreeBSD.org[kuma@jp.FreeBSD.org]
+* Hr.Ladavac mailto:lada@ws2301.gud.siemens.co.at[lada@ws2301.gud.siemens.co.at]
+* Hsin-Hsiung Chang mailto:sexbear@tmu.edu.tw[sexbear@tmu.edu.tw]
+* Hubert Feyrer mailto:hubertf@NetBSD.ORG[hubertf@NetBSD.ORG]
+* Hubert Tournier mailto:hubert@frbsd.org[hubert@frbsd.org]
+* Hugh Mahon mailto:h_mahon@fc.hp.com[h_mahon@fc.hp.com]
+* Hugo Leisink mailto:hugo@leisink.net[hugo@leisink.net]
+* Hung-Chi Chu mailto:hcchu@r350.ee.ntu.edu.tw[hcchu@r350.ee.ntu.edu.tw]
+* Hung-Yi Chen mailto:gaod.chen@gmail.com[gaod.chen@gmail.com]
+* Hyogeol Lee mailto:hyogeollee@gmail.com[hyogeollee@gmail.com]
+* IMAI Takeshi mailto:take-i@ceres.dti.ne.jp[take-i@ceres.dti.ne.jp]
+* IMAMURA Tomoaki mailto:tomoak-i@is.aist-nara.ac.jp[tomoak-i@is.aist-nara.ac.jp]
+* IWASHITA Yoji mailto:shuna@pop16.odn.ne.jp[shuna@pop16.odn.ne.jp]
+* IWATSUKI Hiroyuki mailto:don@na.rim.or.jp[don@na.rim.or.jp]
+* Ian Holland mailto:ianh@tortuga.com.au[ianh@tortuga.com.au]
+* Ian Struble mailto:ian@broken.net[ian@broken.net]
+* Ian Vaudrey mailto:i.vaudrey@bigfoot.com[i.vaudrey@bigfoot.com]
+* Iblis Lin mailto:iblis@hs.ntnu.edu.tw[iblis@hs.ntnu.edu.tw]
+* Igor Artemiev mailto:ai@kliksys.ru[ai@kliksys.ru]
+* Igor Khasilev mailto:igor@jabber.paco.odessa.ua[igor@jabber.paco.odessa.ua]
+* Igor Leonenko mailto:bananaz@bk.ru[bananaz@bk.ru]
+* Igor Ostapenko mailto:igor.ostapenko@gmail.com[igor.ostapenko@gmail.com]
+* Igor Pokrovsky mailto:ip@doom.homeunix.org[ip@doom.homeunix.org]
+* Igor Roshchin mailto:str@giganda.komkon.org[str@giganda.komkon.org]
+* Igor Serikov mailto:bt@turtle.pangeatech.com[bt@turtle.pangeatech.com]
+* Igor Sviridov mailto:siac@ua.net[siac@ua.net]
+* Igor Vinokurov mailto:igor@zynaps.ru[igor@zynaps.ru]
+* Ikuo Nakagawa mailto:ikuo@isl.intec.co.jp[ikuo@isl.intec.co.jp]
+* Ildar Hizbulin mailto:hizel@vyborg.ru[hizel@vyborg.ru]
+* Ilia Chipitsine mailto:ilia@rediska.ru[ilia@rediska.ru]
+* Ilya Khamushkin mailto:ilya@space.rootshell.ru[ilya@space.rootshell.ru]
+* Ilya V. Komarov mailto:mur@lynx.ru[mur@lynx.ru]
+* Ismail Yenigul mailto:ismail@enderunix.org[ismail@enderunix.org]
+* Itsuro Saito mailto:saito@miv.t.u-tokyo.ac.jp[saito@miv.t.u-tokyo.ac.jp]
+* Ivan Klymenko mailto:fidaj@ukr.net[fidaj@ukr.net]
+* Ivan Rozhuk mailto:rozhuk.im@gmail.com[rozhuk.im@gmail.com]
+* Ivan Sharov mailto:ivan.sharov@iname.com[ivan.sharov@iname.com]
+* Ivan Sviridov mailto:sin@vimcom.net[sin@vimcom.net]
+* J Shoemaker mailto:shoemaker@softhome.net[shoemaker@softhome.net]
+* J. Bryant mailto:jbryant@argus.flash.net[jbryant@argus.flash.net]
+* J. David Lowe mailto:lowe@saturn5.com[lowe@saturn5.com]
+* J. Han mailto:hjh@photino.com[hjh@photino.com]
+* J. Hawk mailto:jhawk@MIT.EDU[jhawk@MIT.EDU]
+* J. Randolph mailto:snortsms@servangle.net[snortsms@servangle.net]
+* J.R. Oldroyd mailto:fbsd@opal.com[fbsd@opal.com]
+* J.T. Conklin mailto:jtc@cygnus.com[jtc@cygnus.com]
+* Jacek Pelka mailto:jacek@combit.com.pl[jacek@combit.com.pl]
+* Jack mailto:jack@zeus.xtalwind.net[jack@zeus.xtalwind.net]
+* Jackson Low mailto:xxjack12xx@gmail.com[xxjack12xx@gmail.com]
+* Jacob Atzen mailto:jatzen@gmail.com[jatzen@gmail.com]
+* Jacob Bohn Lorensen mailto:jacob@jblhome.ping.mk[jacob@jblhome.ping.mk]
+* Jacques Marneweck mailto:jacques@php.net[jacques@php.net]
+* Jagane D Sundar mailto:jagane@netcom.com[jagane@netcom.com]
+* Jake Hamby mailto:jehamby@anobject.com[jehamby@anobject.com]
+* Jake Smith mailto:jake@xz.cx[jake@xz.cx]
+* Jakub Klausa mailto:jacke@bofh.pl[jacke@bofh.pl]
+* James Bailie mailto:jimmy@mammothcheese.ca[jimmy@mammothcheese.ca]
+* James Buren mailto:ryu0@ymail.com[ryu0@ymail.com]
+* James Clark mailto:jjc@jclark.com[jjc@jclark.com]
+* James D. Stewart mailto:jds@c4systm.com[jds@c4systm.com]
+* James E Keenan mailto:jkeenan@cpan.org[jkeenan@cpan.org]
+* James Jegers mailto:jimj@miller.cs.uwm.edu[jimj@miller.cs.uwm.edu]
+* James McNaughton mailto:bitbucket63-it@yahoo.com[bitbucket63-it@yahoo.com]
+* James O'Gorman mailto:james@netinertia.co.uk[james@netinertia.co.uk]
+* James P. Howard, II mailto:jh@jameshoward.us[jh@jameshoward.us]
+* James Raftery mailto:james@now.ie[james@now.ie]
+* James Raynard mailto:fhackers@jraynard.demon.co.uk[fhackers@jraynard.demon.co.uk]
+* James T. Liu mailto:jtliu@phlebas.rockefeller.edu[jtliu@phlebas.rockefeller.edu]
+* James da Silva mailto:jds@cs.umd.edu[jds@cs.umd.edu]
+* James Wright mailto:james.wright@digital-chaos.com[james.wright@digital-chaos.com]
+* Jamie Heckford mailto:jamie@jamiesdomain.co.uk[jamie@jamiesdomain.co.uk]
+* Jamie Jones mailto:jamie@bishopston.net[jamie@bishopston.net]
+* Jan Conard mailto:charly@fachschaften.tu-muenchen.de[charly@fachschaften.tu-muenchen.de]
+* Jan Henrik Sylvester mailto:me@janh.de[me@janh.de]
+* Jan Jungnickel mailto:Jan@Jungnickel.com[Jan@Jungnickel.com]
+* {jkb}
+* Jan L. Peterson mailto:jlp@flipdog.com[jlp@flipdog.com]
+* Jan Rochel mailto:jan.rochel@epost.de[jan.rochel@epost.de]
+* Jan Siml mailto:jsi@jules.de[jsi@jules.de]
+* Jan Srzednicki mailto:w@wrzask.pl[w@wrzask.pl]
+* Jan Stocker mailto:jan.stocker@t-online.de[jan.stocker@t-online.de]
+* Jan-Peter Koopmann mailto:j.koopmann@seceidos.de[j.koopmann@seceidos.de]
+* Janaka Wickramasinghe mailto:janaka@opensource.lk[janaka@opensource.lk]
+* Janick Taillandier mailto:Janick.Taillandier@ratp.fr[Janick.Taillandier@ratp.fr]
+* Janky Jay mailto:ek@purplehat.org[ek@purplehat.org]
+* János Mohácsi mailto:janos.mohacsi@bsd.hu[janos.mohacsi@bsd.hu]
+* Janusz Kokot mailto:janek@gaja.ipan.lublin.pl[janek@gaja.ipan.lublin.pl]
+* Jarle Greipsland mailto:jarle@idt.unit.no[jarle@idt.unit.no]
+* Jason Burgess mailto:dev@fenux.net[dev@fenux.net]
+* Jason DiCioccio mailto:geniusj@ods.org[geniusj@ods.org]
+* Jason Garman mailto:init@risen.org[init@risen.org]
+* Jason Harris mailto:jharris@widomaker.com[jharris@widomaker.com]
+* Jason R. Mastaler mailto:jason-freebsd@mastaler.com[jason-freebsd@mastaler.com]
+* Jason Stone mailto:jason-fbsd-ports@shalott.net[jason-fbsd-ports@shalott.net]
+* Jason Thorpe mailto:thorpej@NetBSD.org[thorpej@NetBSD.org]
+* Jason Wright mailto:jason@OpenBSD.org[jason@OpenBSD.org]
+* Jason Young mailto:doogie@forbidden-donut.anet-stl.com[doogie@forbidden-donut.anet-stl.com]
+* Javad Kouhi mailto:javad.kouhi@gmail.com[javad.kouhi@gmail.com]
+* Javier Martin Rueda mailto:jmrueda@diatel.upm.es[jmrueda@diatel.upm.es]
+* Jay Fenlason mailto:hack@datacube.com[hack@datacube.com]
+* Jay Krell mailto:jay.krell@cornell.edu[jay.krell@cornell.edu]
+* Jaye Mathisen mailto:mrcpu@cdsnet.net[mrcpu@cdsnet.net]
+* Jaap Akkerhuis mailto:jaap@NLnetLabs.nl[jaap@NLnetLabs.nl]
+* Jean-Baptiste Quenot mailto:jb.quenot@caraldi.com[jb.quenot@caraldi.com]
+* Jean Benoit mailto:jean@unistra.fr[jean@unistra.fr]
+* Jean-Sebastien Roy mailto:js@jeannot.org[js@jeannot.org]
+* Jeff Bartig mailto:jeffb@doit.wisc.edu[jeffb@doit.wisc.edu]
+* Jeff Brown mailto:jabrown@caida.org[jabrown@caida.org]
+* Jeff Burchell mailto:toxic@doobie.com[toxic@doobie.com]
+* Jeff Forys mailto:jeff@forys.cranbury.nj.us[jeff@forys.cranbury.nj.us]
+* Jeff Kletsky mailto:Jeff@Wagsky.com[Jeff@Wagsky.com]
+* Jeff Palmer mailto:scorpio@drkshdw.org[scorpio@drkshdw.org]
+* Jeffrey Baitis mailto:jeff@baitis.net[jeff@baitis.net]
+* Jeffrey Evans mailto:evans@scnc.k12.mi.us[evans@scnc.k12.mi.us]
+* Jeffrey H. Johnson mailto:CPE1704TKS@bellsouth.net[CPE1704TKS@bellsouth.net]
+* Jeffrey Leung mailto:zenoss@experts-exchange.com[zenoss@experts-exchange.com]
+* Jeff Molofee mailto:nehe@cruzinternet.com[nehe@cruzinternet.com]
+* Jeffrey Wheat mailto:jeff@cetlink.net[jeff@cetlink.net]
+* Jens Grassel mailto:freebsd-ports@jan0sch.de[freebsd-ports@jan0sch.de]
+* Jens Holmqvist mailto:zparta@hispan.se[zparta@hispan.se]
+* Jens K. Loewe mailto:bsd@tuxproject.de[bsd@tuxproject.de]
+* Jens Rehsack mailto:rehsack@liwing.de[rehsack@liwing.de]
+* Jeremy Allison mailto:jallison@whistle.com[jallison@whistle.com]
+* Jeremy Baggs mailto:jbaggs2016@gmail.com[jbaggs2016@gmail.com]
+* Jeremy C. Reed mailto:reed@pugetsoundtechnology.com[reed@pugetsoundtechnology.com]
+* Jeremy Chatfield mailto:jdc@xinside.com[jdc@xinside.com]
+* Jeremy Karlson mailto:karlj000@unbc.ca[karlj000@unbc.ca]
+* Jeremy Prior
+* Jeremy Shaffner mailto:jeremy@external.org[jeremy@external.org]
+* Jeroen Schot mailto:schot@a-askwadraat.nl[schot@a-askwadraat.nl]
+* Jerry Eriksson mailto:jerry@freebsd.se[jerry@freebsd.se]
+* Jesper Dalberg mailto:jesper@jdn.dk[jesper@jdn.dk]
+* Jesper Noehr mailto:jesper@noehr.org[jesper@noehr.org]
+* Jesse Kempf mailto:jessekempf@gmail.com[jessekempf@gmail.com]
+* Jesse McConnell mailto:jesse@cylant.com[jesse@cylant.com]
+* Jesse Rosenstock mailto:jmr@ugcs.caltech.edu[jmr@ugcs.caltech.edu]
+* Jesse Smith mailto:jsmith@resonatingmedia.com[jsmith@resonatingmedia.com]
+* Jesse van den Kieboom mailto:troplosti@orcaweb.cjb.net[troplosti@orcaweb.cjb.net]
+* Jia-Wei Ye mailto:leafy7382@gmail.com[leafy7382@gmail.com]
+* Jian-Da Li mailto:jdli@csie.nctu.edu.tw[jdli@csie.nctu.edu.tw]
+* Jie Gao mailto:gaoj@cpsc.ucalgary.ca[gaoj@cpsc.ucalgary.ca]
+* {babb}
+* Jim Binkley mailto:jrb@cs.pdx.edu[jrb@cs.pdx.edu]
+* Jim Bloom mailto:bloom@acm.org[bloom@acm.org]
+* Jim Carroll mailto:jim@carroll.com[jim@carroll.com]
+* Jim Flowers mailto:jflowers@ezo.net[jflowers@ezo.net]
+* Jim Geovedi mailto:jim@corebsd.or.id[jim@corebsd.or.id]
+* Jim Leppek mailto:jleppek@harris.com[jleppek@harris.com]
+* Jim Lowe mailto:james@cs.uwm.edu[james@cs.uwm.edu]
+* Jim Mattson mailto:jmattson@sonic.net[jmattson@sonic.net]
+* Jim Mercer mailto:jim@komodo.reptiles.org[jim@komodo.reptiles.org]
+* Jim Ohlstein mailto:jim@ohlste.in[jim@ohlste.in]
+* Jim Pirzyk mailto:pirzyk@uiuc.edu[pirzyk@uiuc.edu]
+* Jim Riggs mailto:ports@christianserving.org[ports@christianserving.org]
+* Jim Shewmaker mailto:jim@bluenotch.com[jim@bluenotch.com]
+* Jim Sloan mailto:odinn@atlantabiker.net[odinn@atlantabiker.net]
+* Jim Stapleton mailto:sjss@var-dev.net[sjss@var-dev.net]
+* Jim Wilson mailto:wilson@moria.cygnus.com[wilson@moria.cygnus.com]
+* Jimbo Bahooli mailto:griffin@blackhole.iceworld.org[griffin@blackhole.iceworld.org]
+* Jin Guojun mailto:jin@george.lbl.gov[jin@george.lbl.gov]
+* Jin-Shan Tseng mailto:tjs@cdpa.nsysu.edu.tw[tjs@cdpa.nsysu.edu.tw]
+* Jin-Sih Lin mailto:linpct@gmail.com[linpct@gmail.com]
+* Jo Rhett mailto:jrhett@netconsonance.com[jrhett@netconsonance.com]
+* Joachim Kuebart mailto:kuebart@mathematik.uni-ulm.de[kuebart@mathematik.uni-ulm.de]
+* Joachim Strombergson mailto:Watchman@ludd.luth.se[Watchman@ludd.luth.se]
+* Joao Carlos Mendes Luis mailto:jonny@jonny.eng.br[jonny@jonny.eng.br]
+* Jochen Pohl mailto:jpo.drs@sni.de[jpo.drs@sni.de]
+* Joe Abley mailto:jabley@automagic.org[jabley@automagic.org]
+* Joe Barbish mailto:barbish@a1poweruser.com[barbish@a1poweruser.com]
+* Joe Halpin mailto:joe.halpin@attbi.com[joe.halpin@attbi.com]
+* Joe Holden mailto:joe@joeholden.co.uk[joe@joeholden.co.uk]
+* Joe Horn mailto:joehorn@gmail.com[joehorn@gmail.com]
+* Joe Jih-Shian Lu mailto:jslu@dns.ntu.edu.tw[jslu@dns.ntu.edu.tw]
+* Joe Kelsey mailto:joek@flyingcroc.net[joek@flyingcroc.net]
+* Joe Orthoefer mailto:j_orthoefer@tia.net[j_orthoefer@tia.net]
+* Joe Smith mailto:inwap@best.com[inwap@best.com]
+* Joe Traister mailto:traister@mojozone.org[traister@mojozone.org]
+* Joel Diaz mailto:joeldiaz@bellsouth.net[joeldiaz@bellsouth.net]
+* Joel Faedi mailto:Joel.Faedi@esial.u-nancy.fr[Joel.Faedi@esial.u-nancy.fr]
+* Joel Ray Holveck mailto:joelh@gnu.org[joelh@gnu.org]
+* Joel Sutton mailto:jsutton@bbcon.com.au[jsutton@bbcon.com.au]
+* Joerg Pulz mailto:Joerg.Pulz@frm2.tum.de[Joerg.Pulz@frm2.tum.de]
+* Joerg Schilling mailto:schilling@fokus.gmd.de[schilling@fokus.gmd.de]
+* Johan Granlund mailto:johan@granlund.nu[johan@granlund.nu]
+* Johan Larsson mailto:johan@moon.campus.luth.se[johan@moon.campus.luth.se]
+* Johan Strom mailto:johan@stromnet.org[johan@stromnet.org]
+* Johann Tonsing mailto:jtonsing@mikom.csir.co.za[jtonsing@mikom.csir.co.za]
+* Johannes 5 Joemann mailto:joemann@beefree.free.de[joemann@beefree.free.de]
+* Johannes Grødem mailto:johs@copyleft.no[johs@copyleft.no]
+* Johannes Helander
+* Johannes Stille
+* John Beckett mailto:jbeckett@southern.edu[jbeckett@southern.edu]
+* John Beukema mailto:jbeukema@hk.super.net[jbeukema@hk.super.net]
+* John Brezak
+* John Capo mailto:jc@irbs.com[jc@irbs.com]
+* John F. Woods mailto:jfw@jfwhome.funhouse.com[jfw@jfwhome.funhouse.com]
+* John Ferrel mailto:jdferrell3@yahoo.com[jdferrell3@yahoo.com]
+* John Goerzen mailto:jgoerzen@alexanderwohl.complete.org[jgoerzen@alexanderwohl.complete.org]
+* John Heidemann mailto:johnh@isi.edu[johnh@isi.edu]
+* John Hood mailto:cgull@owl.org[cgull@owl.org]
+* John Kohl
+* John Lind mailto:john@starfire.mn.org[john@starfire.mn.org]
+* John Mackin mailto:john@physiol.su.oz.au[john@physiol.su.oz.au]
+* John McAree mailto:john@mcaree.org[john@mcaree.org]
+* John MacFarlane mailto:jgm@berkeley.edu[jgm@berkeley.edu]
+* John Mehr mailto:jcm@visi.com[jcm@visi.com]
+* John Merryweather Cooper mailto:jmcoopr@webmail.bmi.net[jmcoopr@webmail.bmi.net]
+* John Nielsen mailto:john@jnielsen.net[john@jnielsen.net]
+* John Oxley mailto:john@yoafrica.com[john@yoafrica.com]
+* John P mailto:johnp@lodgenet.com[johnp@lodgenet.com]
+* John Perry mailto:perry@vishnu.alias.net[perry@vishnu.alias.net]
+* John Prather mailto:john.c.prather@gmail.com[john.c.prather@gmail.com]
+* John Preisler mailto:john@vapornet.com[john@vapornet.com]
+* John Reynolds mailto:johnjen@reynoldsnet.org[johnjen@reynoldsnet.org]
+* John Rochester mailto:jr@cs.mun.ca[jr@cs.mun.ca]
+* John Sadler mailto:john_sadler@alum.mit.edu[john_sadler@alum.mit.edu]
+* John Saunders mailto:john@pacer.nlc.net.au[john@pacer.nlc.net.au]
+* John Von Essen mailto:john@essenz.com[john@essenz.com]
+* John W. O'Brien mailto:john@saltant.com[john@saltant.com]
+* John Wehle mailto:john@feith.com[john@feith.com]
+* John Woods mailto:jfw@eddie.mit.edu[jfw@eddie.mit.edu]
+* Johny Mattsson mailto:lonewolf@flame.org[lonewolf@flame.org]
+* Jon Amundsen mailto:online@jamundsen.dyndns.org[online@jamundsen.dyndns.org]
+* Jon Morgan mailto:morgan@terminus.trailblazer.com[morgan@terminus.trailblazer.com]
+* Jon Nistor mailto:nistor@snickers.org[nistor@snickers.org]
+* Jon Passki mailto:cykyc@yahoo.com[cykyc@yahoo.com]
+* Jon Wilson mailto:jon@phuq.co.uk[jon@phuq.co.uk]
+* Jona Joachim mailto:walkingshadow@grummel.net[walkingshadow@grummel.net]
+* Jonas Ferreira mailto:jonas.h.ferreira@me.com[jonas.h.ferreira@me.com]
+* Jonathan Belson mailto:jon@witchspace.com[jon@witchspace.com]
+* Jonathan Bokovza mailto:Jonathan@afarsec.com[Jonathan@afarsec.com]
+* Jonathan Chen mailto:jonc@chen.org.nz[jonc@chen.org.nz]
+* Jonathan Drews mailto:j.e.drews@att.net[j.e.drews@att.net]
+* Jonathan H N Chin mailto:jc254@newton.cam.ac.uk[jc254@newton.cam.ac.uk]
+* Jonathan Hanna mailto:jhanna@shaw.ca[jhanna@shaw.ca]
+* Jonathan Lennox mailto:lennox@cs.columbia.edu[lennox@cs.columbia.edu]
+* Jonathan Liu mailto:Net147@hotmail.com[Net147@hotmail.com]
+* Jonathan McDowell mailto:noodles@earth.li[noodles@earth.li]
+* Jonathan Pennington mailto:john@coastalgeology.org[john@coastalgeology.org]
+* Jonathan Price mailto:freebsd@jonathanprice.org[freebsd@jonathanprice.org]
+* Jordan DeLong mailto:fracture@allusion.net[fracture@allusion.net]
+* Jordi Haarman mailto:jhaarman-keyword-tinyerpPort.fd583c@projects.synantics.net[jhaarman-keyword-tinyerpPort.fd583c@projects.synantics.net]
+* Jorge Goncalves mailto:j@bug.fe.up.pt[j@bug.fe.up.pt]
+* Jorge M. Goncalves mailto:ee96199@tom.fe.up.pt[ee96199@tom.fe.up.pt]
+* Joris Vandalon mailto:joris@vandalon.nl[joris@vandalon.nl]
+* Jos Backus mailto:jos@catnook.com[jos@catnook.com]
+* Jose Abelardo Martinez mailto:jamartinez@altern.org[jamartinez@altern.org]
+* Jose Liang mailto:jose@jose.idv.tw[jose@jose.idv.tw]
+* Jose Marques mailto:jose@nobody.org[jose@nobody.org]
+* Jose Rodriguez mailto:king@v2project.com[king@v2project.com]
+* José García Juanino mailto:jjuanino@gmail.com[jjuanino@gmail.com]
+* Josef Grosch mailto:jgrosch@superior.mooseriver.com[jgrosch@superior.mooseriver.com]
+* Joseph Haga mailto:tuximus@tcsn.net[tuximus@tcsn.net]
+* Joseph Scott mailto:joseph@randomnetworks.com[joseph@randomnetworks.com]
+* Joseph Stein mailto:joes@wstein.com[joes@wstein.com]
+* Josh Carroll mailto:josh.carroll@gmail.com[josh.carroll@gmail.com]
+* Josh Elsasser mailto:jre@vineyard.net[jre@vineyard.net]
+* Josh Gilliam mailto:josh@quick.net[josh@quick.net]
+* Josh Tiefenbach mailto:josh@ican.net[josh@ican.net]
+* Josh Tolbert mailto:hemi@puresimplicity.net[hemi@puresimplicity.net]
+* Joshua D. Abraham mailto:jabra@ccs.neu.edu[jabra@ccs.neu.edu]
+* Joshua Goodall mailto:joshua@roughtrade.net[joshua@roughtrade.net]
+* Jostein Trondal mailto:jostein.trondal@sikkerhet.no[jostein.trondal@sikkerhet.no]
+* Juan Salaverria mailto:rael@vectorstar.net[rael@vectorstar.net]
+* Juha Inkari mailto:inkari@cc.hut.fi[inkari@cc.hut.fi]
+* Juha Nygard mailto:juha.nygard1@netikka.fi[juha.nygard1@netikka.fi]
+* Juha Ylitalo mailto:juha.ylitalo@iki.fi[juha.ylitalo@iki.fi]
+* Jui-Nan Lin mailto:jnlin@csie.nctu.edu.tw[jnlin@csie.nctu.edu.tw]
+* Jukka A. Ukkonen mailto:jau@iki.fi[jau@iki.fi]
+* Julian Assange mailto:proff@suburbia.net[proff@suburbia.net]
+* Julian C. Dunn mailto:jdunn@aquezada.com[jdunn@aquezada.com]
+* Julian Coleman mailto:j.d.coleman@ncl.ac.uk[j.d.coleman@ncl.ac.uk]
+* {jhs}
+* Julian Jenkins mailto:kaveman@magna.com.au[kaveman@magna.com.au]
+* Julian Stecklina mailto:der_julian@web.de[der_julian@web.de]
+* Jun Mukai mailto:mukai@jmuk.org[mukai@jmuk.org]
+* Junichi Satoh mailto:junichi@jp.FreeBSD.org[junichi@jp.FreeBSD.org]
+* Junji NAKANISHI mailto:jun-g@daemonfreaks.com[jun-g@daemonfreaks.com]
+* Junji SAKAI mailto:sakai@jp.FreeBSD.org[sakai@jp.FreeBSD.org]
+* Junya WATANABE mailto:junya-w@remus.dti.ne.jp[junya-w@remus.dti.ne.jp]
+* Justas mailto:justas@mbank.lv[justas@mbank.lv]
+* Justin Stanford mailto:jus@security.za.net[jus@security.za.net]
+* Jyun-Yan You mailto:jyyou@cs.nctu.edu.tw[jyyou@cs.nctu.edu.tw]
+* Gergely CZUCZY mailto:gergely.czuczy@harmless.hu[gergely.czuczy@harmless.hu]
+* K.Higashino mailto:a00303@cc.hc.keio.ac.jp[a00303@cc.hc.keio.ac.jp]
+* KANOU Hiroki mailto:kanou@khdd.net[kanou@khdd.net]
+* KATO Tsuguru mailto:tkato@prontomail.ne.jp[tkato@prontomail.ne.jp]
+* KIMURA Shigekazu mailto:zau50357@lion.zero.ad.jp[zau50357@lion.zero.ad.jp]
+* KIMURA Yasuhiro mailto:yasu@utahime.org[yasu@utahime.org]
+* KUNISHIMA Takeo mailto:kunishi@c.oka-pu.ac.jp[kunishi@c.oka-pu.ac.jp]
+* Kai Vorma mailto:vode@snakemail.hut.fi[vode@snakemail.hut.fi]
+* Kai Wang mailto:kaiwang27@gmail.com[kaiwang27@gmail.com]
+* Kaleb S. Keithley mailto:kaleb@ics.com[kaleb@ics.com]
+* Kalle R. Møller mailto:freebsb_contrib@k-moeller.dk[freebsb_contrib@k-moeller.dk]
+* Kan Sasaki mailto:sasaki@fcc.ad.jp[sasaki@fcc.ad.jp]
+* Kaneda Hiloshi mailto:vanitas@ma3.seikyou.ne.jp[vanitas@ma3.seikyou.ne.jp]
+* Kang Liu mailto:liukang@bjut.edu.cn[liukang@bjut.edu.cn]
+* Kang-ming Liu mailto:gugod@gugod.org[gugod@gugod.org]
+* Kapil Chowksey mailto:kchowksey@hss.hns.com[kchowksey@hss.hns.com]
+* Karel Miklav mailto:karel@lovetemple.net[karel@lovetemple.net]
+* Karl Denninger mailto:karl@mcs.com[karl@mcs.com]
+* Karl Dietz mailto:Karl.Dietz@triplan.com[Karl.Dietz@triplan.com]
+* Karl Lehenbauer mailto:karl@NeoSoft.com[karl@NeoSoft.com]
+* Karsten W. Rohrbach mailto:karsten@rohrbach.de[karsten@rohrbach.de]
+* Katalin Konkoly mailto:katalin.konkoly@gmail.com[katalin.konkoly@gmail.com]
+* Katsura Matsumoto mailto:katsura@cc.osaka-kyoiku.ac.jp[katsura@cc.osaka-kyoiku.ac.jp]
+* Kawanobe Koh mailto:kawanobe@st.rim.or.jp[kawanobe@st.rim.or.jp]
+* Kay Abendroth mailto:kay.abendroth@raxion.net[kay.abendroth@raxion.net]
+* Kay Lehmann mailto:kay_lehmann@web.de[kay_lehmann@web.de]
+* Kazami mailto:kazami@angels.vg[kazami@angels.vg]
+* Kazuhito HONDA mailto:kazuhito@ph.noda.tus.ac.jp[kazuhito@ph.noda.tus.ac.jp]
+* Kees Jan Koster mailto:kjkoster@kjkoster.org[kjkoster@kjkoster.org]
+* Keith Bostic mailto:bostic@bostic.com[bostic@bostic.com]
+* Keith E. Walker mailto:kew@icehouse.net[kew@icehouse.net]
+* Keith Moore
+* Keith Sklower
+* Kelley Reynolds mailto:kelley@insidesystems.net[kelley@insidesystems.net]
+* Ken Hornstein
+* Ken Key mailto:key@cs.utk.edu[key@cs.utk.edu]
+* Ken Mayer mailto:kmayer@freegate.com[kmayer@freegate.com]
+* Ken McGlothlen mailto:mcglk@artlogix.com[mcglk@artlogix.com]
+* Ken Menzel mailto:kenm@icarz.com[kenm@icarz.com]
+* Ken Tom mailto:subd@mui.net[subd@mui.net]
+* Kenji Rikitake mailto:kenji@k2r.org[kenji@k2r.org]
+* Kenji Saito mailto:marukun@mx2.nisiq.net[marukun@mx2.nisiq.net]
+* Kenji Takefu mailto:takefu@airport.fm[takefu@airport.fm]
+* Kenji Tomita mailto:tommyk@da2.so-net.or.jp[tommyk@da2.so-net.or.jp]
+* Kenneth Furge mailto:kenneth.furge@us.endress.com[kenneth.furge@us.endress.com]
+* Kenneth Monville mailto:desmo@bandwidth.org[desmo@bandwidth.org]
+* Kenneth R. Westerback mailto:krw@tcn.net[krw@tcn.net]
+* Kenneth Stailey mailto:kstailey@yahoo.com[kstailey@yahoo.com]
+* Kenneth Vestergaard Schmidt mailto:kvs@pil.dk[kvs@pil.dk]
+* Kent Talarico mailto:kent@shipwreck.tsoft.net[kent@shipwreck.tsoft.net]
+* Kent Vander Velden mailto:graphix@iastate.edu[graphix@iastate.edu]
+* Kentaro Inagaki mailto:JBD01226@niftyserve.ne.jp[JBD01226@niftyserve.ne.jp]
+* Kevin Bracey mailto:kbracey@art.acorn.co.uk[kbracey@art.acorn.co.uk]
+* Kevin Brunelle mailto:kruptos@mlinux.org[kruptos@mlinux.org]
+* Kevin Day mailto:toasty@dragondata.com[toasty@dragondata.com]
+* Kevin Golding mailto:kevin@caomhin.demon.co.uk[kevin@caomhin.demon.co.uk]
+* Kevin Lahey mailto:kml@nas.nasa.gov[kml@nas.nasa.gov]
+* Kevin Meltzer mailto:perlguy@perlguy.com[perlguy@perlguy.com]
+* Kevin Oberman mailto:oberman@es.net[oberman@es.net]
+* Kevin Street mailto:street@iname.com[street@iname.com]
+* Kevin Van Maren mailto:vanmaren@fast.cs.utah.edu[vanmaren@fast.cs.utah.edu]
+* Kevin Zheng mailto:kevinz5000@gmail.com[kevinz5000@gmail.com]
+* Key-Teck SIN mailto:ktsin@acm.org[ktsin@acm.org]
+* Khairil Yusof mailto:kaeru@inigo-tech.com[kaeru@inigo-tech.com]
+* Killer mailto:killer@prosalg.no[killer@prosalg.no]
+* Kim Scarborough mailto:sluggo@unknown.nu[sluggo@unknown.nu]
+* Kimura Fuyuki mailto:fuyuki@hadaly.org[fuyuki@hadaly.org]
+* Kiril Mitev mailto:kiril@ideaglobal.com[kiril@ideaglobal.com]
+* Kirill Bezzubets mailto:kirill@solaris.ru[kirill@solaris.ru]
+* Kirill A. Korinskiy mailto:catap@catap.ru[catap@catap.ru]
+* Kirk Strauser mailto:kirk@strauser.com[kirk@strauser.com]
+* Kiroh HARADA mailto:kiroh@kh.rim.or.jp[kiroh@kh.rim.or.jp]
+* Klaus Aehlig mailto:aehlig@linta.de[aehlig@linta.de]
+* Klaus Goger mailto:klaus.goger@reflex.at[klaus.goger@reflex.at]
+* Klaus Herrmann mailto:klaus.herrmann@gmx.net[klaus.herrmann@gmx.net]
+* Klaus Klein mailto:kleink@layla.inka.de[kleink@layla.inka.de]
+* Klaus Michael Indlekofer mailto:M.Indlekofer@gmx.de[M.Indlekofer@gmx.de]
+* Klaus-J. Wolf mailto:Yanestra@t-online.de[Yanestra@t-online.de]
+* Koichi Sato mailto:copan@ppp.fastnet.or.jp[copan@ppp.fastnet.or.jp]
+* Konrad Heuer mailto:kheuer@gwdu60.gwdg.de[kheuer@gwdu60.gwdg.de]
+* Konrad Lapsz mailto:konrad.lapsz@gmail.com[konrad.lapsz@gmail.com]
+* Konstantin Chuguev mailto:Konstantin.Chuguev@dante.org.uk[Konstantin.Chuguev@dante.org.uk]
+* Konstantin Reznichenko mailto:kot@premierbank.dp.ua[kot@premierbank.dp.ua]
+* Konstantin Stroikovsky mailto:bonkor@gmail.com[bonkor@gmail.com]
+* Konstantinos Mplekos mailto:mplekos@physics.upatras.gr[mplekos@physics.upatras.gr]
+* Kostya Lukin mailto:lukin@okbmei.msk.su[lukin@okbmei.msk.su]
+* Kouichi Hirabayashi mailto:kh@mogami-wire.co.jp[kh@mogami-wire.co.jp]
+* Kris Dow mailto:kris@vilnya.demon.co.uk[kris@vilnya.demon.co.uk]
+* Krzysztof Kowalewski mailto:pyzmen@kam.pl[pyzmen@kam.pl]
+* Krzysztof Pawlowski mailto:msciciel@darkzone.ma.cx[msciciel@darkzone.ma.cx]
+* Kuan-Chung Chiu mailto:buganini@gmail.com[buganini@gmail.com]
+* Kuang-che Wu mailto:kcwu@csie.org[kcwu@csie.org]
+* Kuo-Feng Tseng mailto:kftseng@iyard.org[kftseng@iyard.org]
+* Kurt D. Zeilenga mailto:Kurt@Boolean.NET[Kurt@Boolean.NET]
+* Kurt Kanzenbach mailto:kurt@kmk-computers.de[kurt@kmk-computers.de]
+* Kurt Olsen mailto:kurto@tiny.mcs.usu.edu[kurto@tiny.mcs.usu.edu]
+* Kyle Martin mailto:mkm@ieee.org[mkm@ieee.org]
+* L. Jonas Olsson mailto:ljo@ljo-slip.DIALIN.CWRU.Edu[ljo@ljo-slip.DIALIN.CWRU.Edu]
+* Lacey Powers mailto:lacey.leanne@gmail.com[lacey.leanne@gmail.com]
+* Lapo Luchini mailto:lapo@lapo.it[lapo@lapo.it]
+* Larry Altneu mailto:larry@ALR.COM[larry@ALR.COM]
+* Larry P. Maloney mailto:larry@kiputers.com[larry@kiputers.com]
+* Lars Bernhardsson mailto:lab@fnurt.net[lab@fnurt.net]
+* Lars Eggert mailto:lars.eggert@gmx.net[lars.eggert@gmx.net]
+* Lars Erik Gullerud mailto:lerik@nolink.net[lerik@nolink.net]
+* Lasse L. Johnsen mailto:lasse@freebsdcluster.org[lasse@freebsdcluster.org]
+* Laurence Lopez mailto:lopez@mv.mv.com[lopez@mv.mv.com]
+* Laurent Courty mailto:lrntct@gmail.com[lrntct@gmail.com]
+* Laurent Levier mailto:llevier@argosnet.com[llevier@argosnet.com]
+* Lauri Watts mailto:lauri@kde.org[lauri@kde.org]
+* Laust S. Jespersen mailto:L@ust.dk[L@ust.dk]
+* Leandro Luiz Pereira mailto:leandro@fullonmorning.com[leandro@fullonmorning.com]
+* Lee Cremeans mailto:lcremean@tidalwave.net[lcremean@tidalwave.net]
+* Lefteris Chatzibarbas mailto:lefcha@hellug.gr[lefcha@hellug.gr]
+* Leif Pedersen mailto:pedersen@meridian-enviro.com[pedersen@meridian-enviro.com]
+* Len Sassaman mailto:rabbi@abditum.com[rabbi@abditum.com]
+* Leo Kim mailto:leo@florida.sarang.net[leo@florida.sarang.net]
+* Leo Vandewoestijne mailto:freebsd@dns.company[freebsd@dns.company]
+* Leonardo Silveira de A. Martins mailto:lmartins@nepe.eee.ufg.br[lmartins@nepe.eee.ufg.br]
+* Leonhard Wimmer mailto:leo@mediatomb.cc[leo@mediatomb.cc]
+* Leonid Zolotarev mailto:leoz.2005@gmail.com[leoz.2005@gmail.com]
+* Lev Walkin mailto:vlm@lionet.info[vlm@lionet.info]
+* Levent Kayan mailto:levent@corehack.org[levent@corehack.org]
+* Lewis Thompson mailto:purple@lewiz.net[purple@lewiz.net]
+* Li-lun Wang mailto:llwang@infor.org[llwang@infor.org]
+* Liam Foy mailto:liamfoy@sepulcrum.org[liamfoy@sepulcrum.org]
+* Linh Pham mailto:question+freebsdpr@closedsrc.org[question+freebsdpr@closedsrc.org]
+* Loganaden Velvindron mailto:logan@cyberstorm.mu[logan@cyberstorm.mu]
+* Lon Willett mailto:lon%softt.uucp@math.utah.edu[lon%softt.uucp@math.utah.edu]
+* Loren J. Rittle mailto:ljrittle@acm.org[ljrittle@acm.org]
+* Loren M. Lang mailto:lorenl@alzatex.com[lorenl@alzatex.com]
+* Louis A. Mamakos mailto:loiue@TransSys.com[loiue@TransSys.com]
+* Lowell Gilbert mailto:lowell@world.std.com[lowell@world.std.com]
+* Lubomir Metodiev Marinov mailto:lubomir.marinov@gmail.com[lubomir.marinov@gmail.com]
+* Lucas Andrade mailto:slucasandrade@protonmail.ch[slucasandrade@protonmail.ch]
+* Lucas James mailto:Lucas.James@ldjpc.apana.org.au[Lucas.James@ldjpc.apana.org.au]
+* Lucio Costa mailto:lucio@zetasolucoes.com.br[lucio@zetasolucoes.com.br]
+* Luiz Eduardo Roncato Cordeiro mailto:cordeiro@nic.br[cordeiro@nic.br]
+* Lukasz Komsta mailto:luqqe@users.sourceforge.net[luqqe@users.sourceforge.net]
+* Lukasz Stelmach mailto:lukasz.stelmach@iem.pw.edu.pl[lukasz.stelmach@iem.pw.edu.pl]
+* Lukasz Wasikowski mailto:lukasz@wasikowski.net[lukasz@wasikowski.net]
+* Lupe Christoph mailto:lupe@lupe-christoph.de[lupe@lupe-christoph.de]
+* Lutz Boehne mailto:lboehne@damogran.de[lboehne@damogran.de]
+* Lyndon Nerenberg mailto:lyndon@orthanc.ab.ca[lyndon@orthanc.ab.ca]
+* M Rothwell mailto:freebsd-ports@coreland.ath.cx[freebsd-ports@coreland.ath.cx]
+* M. L. Dodson mailto:bdodson@scms.utmb.EDU[bdodson@scms.utmb.EDU]
+* M.C. Wong
+* MOROHOSHI Akihiko mailto:moro@remus.dti.ne.jp[moro@remus.dti.ne.jp]
+* Machiel Mastenbroek mailto:machiel_mastenbroek@hotmail.com[machiel_mastenbroek@hotmail.com]
+* Magnus Enbom mailto:dot@tinto.campus.luth.se[dot@tinto.campus.luth.se]
+* Mahesh Neelakanta mailto:mahesh@gcomm.com[mahesh@gcomm.com]
+* Mahlon E. Smith mailto:mahlon@martini.nu[mahlon@martini.nu]
+* Makoto WATANABE mailto:watanabe@zlab.phys.nagoya-u.ac.jp[watanabe@zlab.phys.nagoya-u.ac.jp]
+* Makoto YAMAKURA mailto:makoto@pinpott.spnet.ne.jp[makoto@pinpott.spnet.ne.jp]
+* Malte Lance mailto:malte.lance@gmx.net[malte.lance@gmx.net]
+* Manish Jain mailto:bourne.identity@hotmail.com[bourne.identity@hotmail.com]
+* Mantas Kaulakys mailto:stone@tainet.lt[stone@tainet.lt]
+* Manu Iyengar mailto:iyengar@grunthos.pscwa.psca.com[iyengar@grunthos.pscwa.psca.com]
+* Manuel Creach mailto:manuel.creach@me.com[manuel.creach@me.com]
+* Manuel Rabade Garcia mailto:mig@mig-29.net[mig@mig-29.net]
+* Marc Blanchet mailto:marc.blanchet@viagenie.qc.ca[marc.blanchet@viagenie.qc.ca]
+* Marc Frajola mailto:marc@dev.com[marc@dev.com]
+* Marc Olzheim mailto:marcolz@stack.nl[marcolz@stack.nl]
+* Marc Ramirez mailto:mrami@mramirez.sy.yale.edu[mrami@mramirez.sy.yale.edu]
+* Marc Recht mailto:marc@informatik.uni-bremen.de[marc@informatik.uni-bremen.de]
+* Marc Silver mailto:marcs@draenor.org[marcs@draenor.org]
+* Marc Slemko mailto:marcs@znep.com[marcs@znep.com]
+* Marc van Kempen mailto:wmbfmk@urc.tue.nl[wmbfmk@urc.tue.nl]
+* Marc van Woerkom mailto:marc.vanwoerkom@fernuni-hagen.de[marc.vanwoerkom@fernuni-hagen.de]
+* Marcel Bischoff mailto:marcel@herrbischoff.com[marcel@herrbischoff.com]
+* Marcel Kaiser mailto:mk@nic-nac-project.org[mk@nic-nac-project.org]
+* Marcello Silva Coutinho mailto:marcellocoutinho@gmail.com[marcellocoutinho@gmail.com]
+* Marcelo/Porks Rossi mailto:marcelorossi@gmail.com[marcelorossi@gmail.com]
+* Marcin Cieslak mailto:saper@system.pl[saper@system.pl]
+* Marcin Gondek mailto:drixter@e-utp.net[drixter@e-utp.net]
+* Marcin Jessa mailto:yazzy@yazzy.org[yazzy@yazzy.org]
+* Marcin Wisnicki mailto:mwisnicki@gmail.com[mwisnicki@gmail.com]
+* Marco Molteni mailto:molter@tin.it[molter@tin.it]
+* Marco Steinbach mailto:coco@executive-computing.de[coco@executive-computing.de]
+* Marco van de Voort mailto:marcov@stack.nl[marcov@stack.nl]
+* Marcos Andre Hermann mailto:udialup@gmail.com[udialup@gmail.com]
+* Marcus Vinicius Bastos Leandro mailto:mvleandro@gmail.com[mvleandro@gmail.com]
+* Marin Atanasov mailto:dnaeon@gmail.com[dnaeon@gmail.com]
+* Mario Lobo mailto:lobo@bsd.com.br[lobo@bsd.com.br]
+* Marius Nünnerich mailto:marius@nuenneri.ch[marius@nuenneri.ch]
+* Mark A. Wicks mailto:mwicks@kettering.edu[mwicks@kettering.edu]
+* Mark Andrews
+* Mark Blackman mailto:freebsd-ports@blackmans.org[freebsd-ports@blackmans.org]
+* Mark Cammidge mailto:mark@gmtunx.ee.uct.ac.za[mark@gmtunx.ee.uct.ac.za]
+* Mark Daniel Reidel mailto:ports@mark.reidel.info[ports@mark.reidel.info]
+* Mark Diekhans mailto:markd@grizzly.com[markd@grizzly.com]
+* Mark Foster mailto:mark@foster.cc[mark@foster.cc]
+* Mark Hannon mailto:markhannon@optusnet.com.au[markhannon@optusnet.com.au]
+* Mark Huizer mailto:xaa+freebsd@timewasters.nl[xaa+freebsd@timewasters.nl]
+* Mark J. Miller mailto:joup@bigfoot.com[joup@bigfoot.com]
+* Mark J. Taylor mailto:mtaylor@cybernet.com[mtaylor@cybernet.com]
+* Mark Johnston mailto:mjohnston@skyweb.ca[mjohnston@skyweb.ca]
+* Mark Kane mailto:mark@mkproductions.org[mark@mkproductions.org]
+* Mark Knight mailto:markk@knigma.org[markk@knigma.org]
+* Mark Krentel mailto:krentel@rice.edu[krentel@rice.edu]
+* Mark Mayo mailto:markm@vmunix.com[markm@vmunix.com]
+* Mark Starovoytov mailto:mark_sf@kikg.ifmo.ru[mark_sf@kikg.ifmo.ru]
+* Mark Stosberg mailto:mark@summersault.com[mark@summersault.com]
+* Mark Thompson mailto:thompson@tgsoft.com[thompson@tgsoft.com]
+* Mark Tinguely mailto:tinguely@plains.nodak.edu[tinguely@plains.nodak.edu]
+* Mark Treacy
+* Mark Valentine mailto:mark@thuvia.org[mark@thuvia.org]
+* Mark Walker mailto:ziggimon@raindogs.dk[ziggimon@raindogs.dk]
+* Markus Holmberg mailto:saska@acc.umu.se[saska@acc.umu.se]
+* Markus Niemistö mailto:markus.niemisto@gmx.net[markus.niemisto@gmx.net]
+* Martijn Lina mailto:martijn@pacno.net[martijn@pacno.net]
+* Martin Dieringer mailto:martin.dieringer@gmx.de[martin.dieringer@gmx.de]
+* Martin Filla mailto:freebsd@sysctl.cz[freebsd@sysctl.cz]
+* Martin Hinner mailto:mhi@linux.gyarab.cz[mhi@linux.gyarab.cz]
+* Martin Ibert mailto:mib@ppe.bb-data.de[mib@ppe.bb-data.de]
+* Martin Jackson mailto:mhjacks@swbell.net[mhjacks@swbell.net]
+* Martin Kammerhofer mailto:mkamm@gmx.net[mkamm@gmx.net]
+* Martin Karlsson mailto:martin.karlsson@visit.se[martin.karlsson@visit.se]
+* Martin Klaffenboeck mailto:martin.klaffenboeck@gmx.at[martin.klaffenboeck@gmx.at]
+* Martin Kraft mailto:martin.kraft@fal.de[martin.kraft@fal.de]
+* Martin Kropfinger mailto:freebsd@rakor-net.de>[freebsd@rakor-net.de>]
+* Martin Mersberger mailto:gremlin@portal-to-web.de[gremlin@portal-to-web.de]
+* Martin Minkus mailto:diskiller@cnbinc.com[diskiller@cnbinc.com]
+* Martin Neubauer mailto:m.ne@gmx.net[m.ne@gmx.net]
+* Martin Otto mailto:gamato@users.sf.net[gamato@users.sf.net]
+* Martin Pala mailto:martinp@tildeslash.com[martinp@tildeslash.com]
+* Martin Preuss mailto:martin@libchipcard.de[martin@libchipcard.de]
+* Martin Sugioarto mailto:martin.sugioarto@udo.edu[martin.sugioarto@udo.edu]
+* Martin Tournoij mailto:carpetsmoker@gmail.com[carpetsmoker@gmail.com]
+* Martin Waschbüsch mailto:martin@waschbuesch.de[martin@waschbuesch.de]
+* Martti Kuparinen mailto:martti.kuparinen@ericsson.com[martti.kuparinen@ericsson.com]
+* Marwan Burelle mailto:marwan.burelle@lri.fr[marwan.burelle@lri.fr]
+* Masachika ISHIZUKA mailto:ishizuka@isis.min.ntt.jp[ishizuka@isis.min.ntt.jp]
+* Masafumi Otsune mailto:info@otsune.com[info@otsune.com]
+* Masahiro Sekiguchi mailto:seki@sysrap.cs.fujitsu.co.jp[seki@sysrap.cs.fujitsu.co.jp]
+* Masahiro TAKEMURA mailto:mastake@msel.t.u-tokyo.ac.jp[mastake@msel.t.u-tokyo.ac.jp]
+* Masahiro Teramoto mailto:markun@onohara.to[markun@onohara.to]
+* Masakazu HIGAKI mailto:higamasa@dream.com[higamasa@dream.com]
+* Masaki TAGAWA mailto:masaki@club.kyutech.ac.jp[masaki@club.kyutech.ac.jp]
+* Masanobu Saitoh mailto:msaitoh@spa.is.uec.ac.jp[msaitoh@spa.is.uec.ac.jp]
+* Masanori Kanaoka mailto:kana@saijo.mke.mei.co.jp[kana@saijo.mke.mei.co.jp]
+* Masanori Kiriake mailto:seiken@ARGV.AC[seiken@ARGV.AC]
+* Masanori OZAWA mailto:ozawa@ongs.co.jp[ozawa@ongs.co.jp]
+* Masashi CHIBA mailto:chiba.masashi@gmail.com[chiba.masashi@gmail.com]
+* Masatoshi TAMURA mailto:tamrin@shinzan.kuee.kyoto-u.ac.jp[tamrin@shinzan.kuee.kyoto-u.ac.jp]
+* Matheus Estrela mailto:matheus@arroway.org[matheus@arroway.org]
+* Mathias Monnerville mailto:mathias@monnerville.com[mathias@monnerville.com]
+* Mathieu Simon mailto:freebsd@simweb.ch[freebsd@simweb.ch]
+* Mats Lofkvist mailto:mal@algonet.se[mal@algonet.se]
+* Matt Bartley mailto:mbartley@lear35.cytex.com[mbartley@lear35.cytex.com]
+* Matt Dawson mailto:matt@mattsnetwork.co.uk[matt@mattsnetwork.co.uk]
+* Matt Douhan mailto:matt@athame.co.uk[matt@athame.co.uk]
+* Matt Emmerton mailto:matt@gsicomp.on.ca[matt@gsicomp.on.ca]
+* Matt Heckaman mailto:matt@LUCIDA.QC.CA[matt@LUCIDA.QC.CA]
+* Matt Jibson mailto:dolmant@dolmant.net[dolmant@dolmant.net]
+* Matt Lancereau mailto:matt@bsdfly.org[matt@bsdfly.org]
+* Matt Loschert mailto:loschert@servint.com[loschert@servint.com]
+* Matt Mills mailto:matt_mills@btopenworld.com[matt_mills@btopenworld.com]
+* Matt Peterson mailto:matt@peterson.org[matt@peterson.org]
+* Matt Smith mailto:matt@xtaz.net[matt@xtaz.net]
+* Matt Stofko mailto:matt@mjslabs.com[matt@mjslabs.com]
+* Matt Thomas mailto:matt@3am-software.com[matt@3am-software.com]
+* Matt Tosto mailto:datahead4@gmail.com[datahead4@gmail.com]
+* Matt White mailto:mwhite+@CMU.EDU[mwhite+@CMU.EDU]
+* Matteo Cypriani mailto:mcy@lm7.fr[mcy@lm7.fr]
+* Matthew Braithwaite mailto:mab@red-bean.com[mab@red-bean.com]
+* Matthew C. Mead mailto:mmead@Glock.COM[mmead@Glock.COM]
+* Matthew Cashdollar mailto:mattc@rfcnet.com[mattc@rfcnet.com]
+* Matthew Donovan mailto:kitchetech@gmail.com[kitchetech@gmail.com]
+* Matthew Emmerton mailto:root@gabby.gsicomp.on.ca[root@gabby.gsicomp.on.ca]
+* Matthew Flatt mailto:mflatt@cs.rice.edu[mflatt@cs.rice.edu]
+* Matthew Fuller mailto:fullermd@over-yonder.net[fullermd@over-yonder.net]
+* Matthew George mailto:mdg@secureworks.net[mdg@secureworks.net]
+* Matthew Gibson mailto:mdg583@hotmail.com[mdg583@hotmail.com]
+* Matthew Grooms mailto:mgrooms@shrew.net[mgrooms@shrew.net]
+* Matthew Holder mailto:sixxgate@hotmail.com[sixxgate@hotmail.com]
+* Matthew Luckie mailto:mjl@luckie.org.nz[mjl@luckie.org.nz]
+* Matthew Stein mailto:matt@bdd.net[matt@bdd.net]
+* Matthew West mailto:mwest@uct.ac.za[mwest@uct.ac.za]
+* Matthew Will mailto:mwill@spingen.com[mwill@spingen.com]
+* Matthew X. Economou mailto:xenophon+fbsdports@irtnog.org[xenophon+fbsdports@irtnog.org]
+* Matthias Petermann mailto:matthias@d2ux.net[matthias@d2ux.net]
+* Matthias Pfaller mailto:leo@dachau.marco.de[leo@dachau.marco.de]
+* Matthias Scheler mailto:tron@netbsd.org[tron@netbsd.org]
+* Matthias Schmidt mailto:schmidtm@mathematik.uni-marburg.de[schmidtm@mathematik.uni-marburg.de]
+* Matthias Sund mailto:m.sund@arcor.de[m.sund@arcor.de]
+* Matthias Schündehütte mailto:msch@snafu.de[msch@snafu.de]
+* Matthias Teege mailto:mteege.de[mteege.de]
+* Matthieu Guegan mailto:matt.guegan@free.fr[matt.guegan@free.fr]
+* Matthieu Volat mailto:mazhe@alkumuna.eu[mazhe@alkumuna.eu]
+* Mattias Gronlund mailto:Mattias.Gronlund@sa.erisoft.se[Mattias.Gronlund@sa.erisoft.se]
+* Mattias Pantzare mailto:pantzer@ludd.luth.se[pantzer@ludd.luth.se]
+* Matus Uhlar mailto:uhlar@fantomas.sk[uhlar@fantomas.sk]
+* Maurice Castro mailto:maurice@planet.serc.rmit.edu.au[maurice@planet.serc.rmit.edu.au]
+* Mauricio Herrera Cuadra mailto:mauricio@arareko.net[mauricio@arareko.net]
+* Mauro Risonho de Paula Assumpção mailto:mauro.risonho@gmail.com[mauro.risonho@gmail.com]
+* Max Campos mailto:mcampos@bpsw.biz[mcampos@bpsw.biz]
+* Max E. Kuznecov mailto:mek@mek.uz.ua[mek@mek.uz.ua]
+* Max Euston mailto:meuston@jmrodgers.com[meuston@jmrodgers.com]
+* Max N. Boyarov mailto:m.boyarov@bsd.by[m.boyarov@bsd.by]
+* Max V. Kostikov mailto:max@kostikov.co[max@kostikov.co]
+* Maxim Bolotin mailto:max@rsu.ru[max@rsu.ru]
+* Maxim Dounin mailto:mdounin@mdounin.ru[mdounin@mdounin.ru]
+* Maxim Filimonov mailto:che@bein.link[che@bein.link]
+* Maxim Ignatenko mailto:gelraen.ua@gmail.com[gelraen.ua@gmail.com]
+* Maxim Loginov mailto:zeliboba@mail.ru[zeliboba@mail.ru]
+* Maxim Samsonov mailto:xors@sendmail.ru[xors@sendmail.ru]
+* Maxim Tuliuk mailto:mt@primats.org.ua[mt@primats.org.ua]
+* Maxime Romano mailto:verbophobe@hotmail.com[verbophobe@hotmail.com]
+* Meikel Brandmeyer mailto:Brandels_Mikesh@web.de[Brandels_Mikesh@web.de]
+* Mel Flynn mailto:rflynn@acsalaska.net[rflynn@acsalaska.net]
+* Meno Abels mailto:meno.abels@adviser.com[meno.abels@adviser.com]
+* Meyer Wolfsheim mailto:wolf@priori.net[wolf@priori.net]
+* Micha Class mailto:michael_class@hpbbse.bbn.hp.com[michael_class@hpbbse.bbn.hp.com]
+* Michael A. Kohn mailto:naken@naken.cc[naken@naken.cc]
+* Michael Alyn Miller mailto:malyn@strangeGizmo.com[malyn@strangeGizmo.com]
+* Michael Butler mailto:imb@scgt.oz.au[imb@scgt.oz.au]
+* Michael Butschky mailto:butsch@computi.erols.com[butsch@computi.erols.com]
+* Michael C. Shultz mailto:ringworm@inbox.lv[ringworm@inbox.lv]
+* Michael Clay mailto:mclay@weareb.org[mclay@weareb.org]
+* Michael Collette mailto:metrol@metrol.net[metrol@metrol.net]
+* Michael Ebert mailto:ebert@informatik.unibw-muenchen.de[ebert@informatik.unibw-muenchen.de]
+* Michael Edenfield mailto:kutulu@kutulu.org[kutulu@kutulu.org]
+* Michael Galassi mailto:nerd@percival.rain.com[nerd@percival.rain.com]
+* Michael Hancock mailto:michaelh@cet.co.jp[michaelh@cet.co.jp]
+* Michael Handler mailto:handler@grendel.net[handler@grendel.net]
+* Michael Hohmuth mailto:hohmuth@inf.tu-dresden.de[hohmuth@inf.tu-dresden.de]
+* Michael Iatrou mailto:m_iatrou@freemail.gr[m_iatrou@freemail.gr]
+* Michael Lyngbøl mailto:michael@lyngbol.dk[michael@lyngbol.dk]
+* Michael Muenz mailto:m.muenz@gmail.com[m.muenz@gmail.com]
+* Michael Neumann mailto:mneumann@ntecs.de[mneumann@ntecs.de]
+* Michael O. Boev mailto:mike@tric.tomsk.gov.ru[mike@tric.tomsk.gov.ru]
+* Michael Perlman mailto:canuck@caam.rice.edu[canuck@caam.rice.edu]
+* Michael Petry mailto:petry@netwolf.NetMasters.com[petry@netwolf.NetMasters.com]
+* Michael Ranner mailto:mranner@inode.at[mranner@inode.at]
+* Michael Sanders mailto:mike@topcat.hypermart.net[mike@topcat.hypermart.net]
+* Michael Sardo mailto:jaeger16@yahoo.com[jaeger16@yahoo.com]
+* Michael Schout mailto:mschout@gkg.net[mschout@gkg.net]
+* Michael Searle mailto:searle@longacre.demon.co.uk[searle@longacre.demon.co.uk]
+* Michael Seyfert mailto:michaels@sdf.lonestar.org[michaels@sdf.lonestar.org]
+* Michael Urban mailto:murban@tznet.com[murban@tznet.com]
+* Michael Vasilenko mailto:acid@stu.cn.ua[acid@stu.cn.ua]
+* Michal Hanula mailto:michal@hanu.la[michal@hanu.la]
+* Michal Listos mailto:mcl@Amnesiac.123.org[mcl@Amnesiac.123.org]
+* Michal Pasternak mailto:dotz@irc.pl[dotz@irc.pl]
+* Michel Lavondés mailto:fox@vader.aacc.cc.md.us[fox@vader.aacc.cc.md.us]
+* Michele Possamai mailto:possamai@xs4all.nl[possamai@xs4all.nl]
+* Michelle Sullivan mailto:michelle@sorbs.net[michelle@sorbs.net]
+* Michio Karl Jinbo mailto:karl@marcer.nagaokaut.ac.jp[karl@marcer.nagaokaut.ac.jp]
+* Micho Durdevich mailto:micho@math.unam.mx[micho@math.unam.mx]
+* Mickael Maillot mailto:mickael.maillot@gmail.com[mickael.maillot@gmail.com]
+* Miguel Angel Sagreras mailto:msagre@cactus.fi.uba.ar[msagre@cactus.fi.uba.ar]
+* Miguel Mendez mailto:flynn@energyhq.es.eu.org[flynn@energyhq.es.eu.org]
+* Mihoko Tanaka mailto:m_tonaka@pa.yokogawa.co.jp[m_tonaka@pa.yokogawa.co.jp]
+* Mij mailto:mij@bitchx.it[mij@bitchx.it]
+* Mika Nystrom mailto:mika@cs.caltech.edu[mika@cs.caltech.edu]
+* Mikael Hybsch mailto:micke@dynas.se[micke@dynas.se]
+* Mikael Karpberg mailto:karpen@ocean.campus.luth.se[karpen@ocean.campus.luth.se]
+* Mike Andrews mailto:mandrews@bit0.com[mandrews@bit0.com]
+* Mike Bowie mailto:mbowie@buzmo.com[mbowie@buzmo.com]
+* Mike Bristow mailto:mike@urgle.com[mike@urgle.com]
+* Mike Del mailto:repenting@hotmail.com[repenting@hotmail.com]
+* Mike Durian mailto:durian@boogie.com[durian@boogie.com]
+* Mike Durkin mailto:mdurkin@tsoft.sf-bay.org[mdurkin@tsoft.sf-bay.org]
+* Mike E. Matsnev mailto:mike@azog.cs.msu.su[mike@azog.cs.msu.su]
+* Mike Edenfield mailto:kutulu@kutulu.org[kutulu@kutulu.org]
+* Mike Erickson mailto:mee@quidquam.com[mee@quidquam.com]
+* Mike Evans mailto:mevans@candle.com[mevans@candle.com]
+* Mike Futerko mailto:mike@LITech.lviv.ua[mike@LITech.lviv.ua]
+* Mike Grupenhoff mailto:kashmir@umiacs.umd.edu[kashmir@umiacs.umd.edu]
+* Mike Harding mailto:mvh@ix.netcom.com[mvh@ix.netcom.com]
+* Mike Hibler mailto:mike@marker.cs.utah.edu[mike@marker.cs.utah.edu]
+* Mike Karels
+* Mike Krutov mailto:neko@takino.org[neko@takino.org]
+* Mike Lockwood mailto:mike@mikelockwood.com[mike@mikelockwood.com]
+* Mike McGaughey mailto:mmcg@cs.monash.edu.au[mmcg@cs.monash.edu.au]
+* Mike Meyer mailto:mwm@mired.org[mwm@mired.org]
+* Mike Mitchell mailto:mitchell@ref.tfs.com[mitchell@ref.tfs.com]
+* Mike Murphy mailto:mrm@alpharel.com[mrm@alpharel.com]
+* Mike Patterson mailto:mike.patterson@unb.ca[mike.patterson@unb.ca]
+* Mike Peck mailto:mike@binghamton.edu[mike@binghamton.edu]
+* Mike Sherwood mailto:mike@fate.com[mike@fate.com]
+* Mike Spengler mailto:mks@msc.edu[mks@msc.edu]
+* Mike Tancsa mailto:mike@sentex.net[mike@sentex.net]
+* Mikhail A. Sokolov mailto:mishania@demos.su[mishania@demos.su]
+* Mikhail T. mailto:michael@fun-box.ru[michael@fun-box.ru]
+* Mikhail Zakharov mailto:zmey20000@yahoo.com[zmey20000@yahoo.com]
+* Mikolaj Rydzewski mailto:miki@ceti.pl[miki@ceti.pl]
+* Mikolaj Golub mailto:to.my.trociny@gmail.com[to.my.trociny@gmail.com]
+* Miks Mikelsons mailto:miks@cubesystems.lv[miks@cubesystems.lv]
+* Milan Obuch mailto:bsd@dino.sk[bsd@dino.sk]
+* Milosz Galazka mailto:milosz.galazka@gmail.com[milosz.galazka@gmail.com]
+* Ming-I Hseh mailto:PA@FreeBSD.ee.Ntu.edu.TW[PA@FreeBSD.ee.Ntu.edu.TW]
+* Mitsuru Yoshida mailto:mitsuru@riken.go.jp[mitsuru@riken.go.jp]
+* Mohammad S. Babaei mailto:info@babaei.net[info@babaei.net]
+* Monte Mitzelfelt mailto:monte@gonefishing.org[monte@gonefishing.org]
+* Mooneer Salem mailto:mooneer@translator.cx[mooneer@translator.cx]
+* Morgan Davis mailto:root@io.cts.com[root@io.cts.com]
+* Morten Slot Kristensen mailto:ontherenth@gmail.com[ontherenth@gmail.com]
+* Mostyn Lewis mailto:mostyn@mrl.com[mostyn@mrl.com]
+* Motomichi Matsuzaki mailto:mzaki@e-mail.ne.jp[mzaki@e-mail.ne.jp]
+* Motoyuki Kasahara mailto:m-kasahr@sra.co.jp[m-kasahr@sra.co.jp]
+* Munish Chopra mailto:munish@engmail.uwaterloo.ca[munish@engmail.uwaterloo.ca]
+* Murilo Opsfelder mailto:mopsfelder@gmail.com[mopsfelder@gmail.com]
+* Mustafa Arif mailto:ma499@doc.ic.ac.uk[ma499@doc.ic.ac.uk]
+* Mykola Dzham mailto:i@levsha.me[i@levsha.me]
+* Mykola Khotyaintsev mailto:ko@irfu.se[ko@irfu.se]
+* Mykola Marzhan mailto:delgod@portaone.com[delgod@portaone.com]
+* N.G.Smith mailto:ngs@sesame.hensa.ac.uk[ngs@sesame.hensa.ac.uk]
+* Nadilson Ferreira mailto:nadilson@gmail.com[nadilson@gmail.com]
+* NAGAO Tadaaki mailto:nagao@cs.titech.ac.jp[nagao@cs.titech.ac.jp]
+* NAKAJI Hiroyuki mailto:nakaji@jp.freebsd.org[nakaji@jp.freebsd.org]
+* NAKAMURA Kazushi mailto:kaz@kobe1995.net[kaz@kobe1995.net]
+* NAKAMURA Motonori mailto:motonori@econ.kyoto-u.ac.jp[motonori@econ.kyoto-u.ac.jp]
+* NIIMI Satoshi mailto:sa2c@and.or.jp[sa2c@and.or.jp]
+* NOKUBI Hirotaka mailto:h-nokubi@yyy.or.jp[h-nokubi@yyy.or.jp]
+* Nadav Eiron mailto:nadav@barcode.co.il[nadav@barcode.co.il]
+* Nanbor Wang mailto:nw1@cs.wustl.edu[nw1@cs.wustl.edu]
+* Naofumi Honda mailto:honda@Kururu.math.sci.hokudai.ac.jp[honda@Kururu.math.sci.hokudai.ac.jp]
+* Naoki Hamada mailto:nao@tom-yam.or.jp[nao@tom-yam.or.jp]
+* Naram Qashat mailto:cyberbotx@cyberbotx.com[cyberbotx@cyberbotx.com]
+* Narayan Namdev Newton mailto:narayannewton@gmail.com[narayannewton@gmail.com]
+* Narvi mailto:narvi@haldjas.folklore.ee[narvi@haldjas.folklore.ee]
+* Nate Eldredge mailto:neldredge@math.ucsd.edu[neldredge@math.ucsd.edu]
+* Nathan Dorfman mailto:nathan@rtfm.net[nathan@rtfm.net]
+* Nathaniel Roark mailto:robb_force@holybuffalo.net[robb_force@holybuffalo.net]
+* Natsagdorj Shagdar mailto:natsag2000@yahoo.com[natsag2000@yahoo.com]
+* Neal Fachan mailto:kneel@ishiboo.com[kneel@ishiboo.com]
+* Neal Nelson mailto:ports@nicandneal.net[ports@nicandneal.net]
+* Necati Ersen Siseci mailto:siseci@enderunix.org[siseci@enderunix.org]
+* Ned Wolpert mailto:wolpert@codeheadsystems.com[wolpert@codeheadsystems.com]
+* Neil Booth mailto:kyuupichan@gmail.com[kyuupichan@gmail.com]
+* Nguyen Tam Chinh mailto:chinhngt@sectorb.msk.ru[chinhngt@sectorb.msk.ru]
+* Niall Smart mailto:rotel@indigo.ie[rotel@indigo.ie]
+* Nicholas Esborn mailto:nick@netdot.net[nick@netdot.net]
+* Nick Barnes mailto:Nick.Barnes@pobox.com[Nick.Barnes@pobox.com]
+* Nick Black mailto:nickblack@linux.com[nickblack@linux.com]
+* Nick Dewing mailto:nickdewing@gmail.com[nickdewing@gmail.com]
+* Nick Handel mailto:nhandel@NeoSoft.com[nhandel@NeoSoft.com]
+* Nick Hilliard mailto:nick@foobar.org[nick@foobar.org]
+* Nick Johnson mailto:freebsd@spatula.net[freebsd@spatula.net]
+* Nicole Reid mailto:root@cooltrainer.org[root@cooltrainer.org]
+* Nikos Kokkalis mailto:nickkokkalis@gmail.com[nickkokkalis@gmail.com]
+* Nick Leuta mailto:skynick@mail.sc.ru[skynick@mail.sc.ru]
+* Nick Rogness mailto:nick@rogness.net[nick@rogness.net]
+* Nick Williams mailto:njw@cs.city.ac.uk[njw@cs.city.ac.uk]
+* Nick Withers mailto:nick@nickwithers.com[nick@nickwithers.com]
+* Nicko Dehaine mailto:nicko@stbernard.com[nicko@stbernard.com]
+* Nickolay N. Dudorov mailto:nnd@itfs.nsk.su[nnd@itfs.nsk.su]
+* Nicolas Embriz mailto:nbari@tequila.io[nbari@tequila.io]
+* Nicolas Jombart mailto:ecu@ipv42.net[ecu@ipv42.net]
+* Niklas Hallqvist mailto:niklas@filippa.appli.se[niklas@filippa.appli.se]
+* Nikola Lecic mailto:nikola.lecic@anthesphoria.net[nikola.lecic@anthesphoria.net]
+* Nikola Kolev mailto:koue@chaosophia.net[koue@chaosophia.net]
+* Nikos Ntarmos mailto:ntarmos@ceid.upatras.gr[ntarmos@ceid.upatras.gr]
+* Nils M. Holm mailto:nmh@t3x.org[nmh@t3x.org]
+* Nilton Jose Rizzo mailto:rizzo@rizzo.eng.br[rizzo@rizzo.eng.br]
+* Nisha Talagala mailto:nisha@cs.berkeley.edu[nisha@cs.berkeley.edu]
+* No Name mailto:ZW6T-KND@j.asahi-net.or.jp[ZW6T-KND@j.asahi-net.or.jp]
+* No Name mailto:adrian@virginia.edu[adrian@virginia.edu]
+* No Name mailto:alex@elvisti.kiev.ua[alex@elvisti.kiev.ua]
+* No Name mailto:anto@netscape.net[anto@netscape.net]
+* No Name mailto:bobson@egg.ics.nitch.ac.jp[bobson@egg.ics.nitch.ac.jp]
+* No Name mailto:bovynf@awe.be[bovynf@awe.be]
+* No Name mailto:burg@is.ge.com[burg@is.ge.com]
+* No Name mailto:chris@gnome.co.uk[chris@gnome.co.uk]
+* No Name mailto:colsen@usa.net[colsen@usa.net]
+* No Name mailto:coredump@nervosa.com[coredump@nervosa.com]
+* No Name mailto:dannyman@arh0300.urh.uiuc.edu[dannyman@arh0300.urh.uiuc.edu]
+* No Name mailto:davids@SECNET.COM[davids@SECNET.COM]
+* No Name mailto:derek@free.org[derek@free.org]
+* No Name mailto:dvv@sprint.net[dvv@sprint.net]
+* No Name mailto:enami@ba2.so-net.or.jp[enami@ba2.so-net.or.jp]
+* No Name mailto:flash@eru.tubank.msk.su[flash@eru.tubank.msk.su]
+* No Name mailto:flash@hway.ru[flash@hway.ru]
+* No Name mailto:fn@pain.csrv.uidaho.edu[fn@pain.csrv.uidaho.edu]
+* No Name mailto:frf@xocolatl.com[frf@xocolatl.com]
+* No Name mailto:gclarkii@netport.neosoft.com[gclarkii@netport.neosoft.com]
+* No Name mailto:gordon@sheaky.lonestar.org[gordon@sheaky.lonestar.org]
+* No Name mailto:graaf@iae.nl[graaf@iae.nl]
+* No Name mailto:greg@greg.rim.or.jp[greg@greg.rim.or.jp]
+* No Name mailto:grossman@cygnus.com[grossman@cygnus.com]
+* No Name mailto:gusw@fub46.zedat.fu-berlin.de[gusw@fub46.zedat.fu-berlin.de]
+* No Name mailto:hfir@math.rochester.edu[hfir@math.rochester.edu]
+* No Name mailto:hnokubi@yyy.or.jp[hnokubi@yyy.or.jp]
+* No Name mailto:iaint@css.tuu.utas.edu.au[iaint@css.tuu.utas.edu.au]
+* No Name mailto:invis@visi.com[invis@visi.com]
+* No Name mailto:ishisone@sra.co.jp[ishisone@sra.co.jp]
+* No Name mailto:iverson@lionheart.com[iverson@lionheart.com]
+* No Name mailto:jpt@magic.net[jpt@magic.net]
+* No Name mailto:junker@jazz.snu.ac.kr[junker@jazz.snu.ac.kr]
+* No Name mailto:k-sugyou@ccs.mt.nec.co.jp[k-sugyou@ccs.mt.nec.co.jp]
+* No Name mailto:kenji@reseau.toyonaka.osaka.jp[kenji@reseau.toyonaka.osaka.jp]
+* No Name mailto:kfurge@worldnet.att.net[kfurge@worldnet.att.net]
+* No Name mailto:lh@aus.org[lh@aus.org]
+* No Name mailto:lhecking@nmrc.ucc.ie[lhecking@nmrc.ucc.ie]
+* No Name mailto:mrgreen@mame.mu.oz.au[mrgreen@mame.mu.oz.au]
+* No Name mailto:nakagawa@jp.FreeBSD.org[nakagawa@jp.FreeBSD.org]
+* No Name mailto:ohki@gssm.otsuka.tsukuba.ac.jp[ohki@gssm.otsuka.tsukuba.ac.jp]
+* No Name mailto:owaki@st.rim.or.jp[owaki@st.rim.or.jp]
+* No Name mailto:pechter@shell.monmouth.com[pechter@shell.monmouth.com]
+* No Name mailto:pete@pelican.pelican.com[pete@pelican.pelican.com]
+* No Name mailto:pritc003@maroon.tc.umn.edu[pritc003@maroon.tc.umn.edu]
+* No Name mailto:risner@stdio.com[risner@stdio.com]
+* No Name mailto:root@ns2.redline.ru[root@ns2.redline.ru]
+* No Name mailto:root@uglabgw.ug.cs.sunysb.edu[root@uglabgw.ug.cs.sunysb.edu]
+* No Name mailto:stephen.ma@jtec.com.au[stephen.ma@jtec.com.au]
+* No Name mailto:sumii@is.s.u-tokyo.ac.jp[sumii@is.s.u-tokyo.ac.jp]
+* No Name mailto:takas-su@is.aist-nara.ac.jp[takas-su@is.aist-nara.ac.jp]
+* No Name mailto:tjevans@raleigh.ibm.com[tjevans@raleigh.ibm.com]
+* No Name mailto:torii@tcd.hitachi.co.jp[torii@tcd.hitachi.co.jp]
+* No Name mailto:uenami@imasy.or.jp[uenami@imasy.or.jp]
+* No Name mailto:vode@hut.fi[vode@hut.fi]
+* No Name mailto:wlloyd@mpd.ca[wlloyd@mpd.ca]
+* No Name mailto:wlr@furball.wellsfargo.com[wlr@furball.wellsfargo.com]
+* No Name mailto:wmbfmk@urc.tue.nl[wmbfmk@urc.tue.nl]
+* No Name mailto:yamagata@nwgpc.kek.jp[yamagata@nwgpc.kek.jp]
+* No Name mailto:ziggy@ryan.org[ziggy@ryan.org]
+* No Name mailto:salexanov@gmail.com[salexanov@gmail.com]
+* Nobuhiro Yasutomi mailto:nobu@psrc.isac.co.jp[nobu@psrc.isac.co.jp]
+* Nobuyuki Koganemaru mailto:kogane@koganemaru.co.jp[kogane@koganemaru.co.jp]
+* Norberto Lopes mailto:nlopes.ml@gmail.com[nlopes.ml@gmail.com]
+* Norio Suzuki mailto:nosuzuki@e-mail.ne.jp[nosuzuki@e-mail.ne.jp]
+* Noritaka Ishizumi mailto:graphite@jp.FreeBSD.org[graphite@jp.FreeBSD.org]
+* Noritoshi Demizu mailto:demizu@dd.iij4u.or.jp[demizu@dd.iij4u.or.jp]
+* Noriyuki Soda mailto:soda@sra.co.jp[soda@sra.co.jp]
+* Oddbjorn Steffensen mailto:oddbjorn@tricknology.org[oddbjorn@tricknology.org]
+* Oh Junseon mailto:hollywar@mail.holywar.net[hollywar@mail.holywar.net]
+* Olaf Wagner mailto:wagner@luthien.in-berlin.de[wagner@luthien.in-berlin.de]
+* Olafur Osvaldsson mailto:oli@isnic.is[oli@isnic.is]
+* Oleg Alexeenkov mailto:proler@gmail.com[proler@gmail.com]
+* Oleg Ginzburg mailto:olevole@olevole.ru[olevole@olevole.ru]
+* Oleg Kiselyov mailto:oleg@pobox.com[oleg@pobox.com]
+* Oleg A. Mamontov mailto:oleg@mamontov.net[oleg@mamontov.net]
+* Oleg M. Golovanov mailto:olmi@rentech.ru[olmi@rentech.ru]
+* Oleg Moskalenko mailto:mom040267@gmail.com[mom040267@gmail.com]
+* Oleg R. Muhutdinov mailto:mor@whiteluna.com[mor@whiteluna.com]
+* Oleg Semyonov mailto:os@altavista.net[os@altavista.net]
+* Oleg Sharoiko mailto:os@rsu.ru[os@rsu.ru]
+* Oleg Ukraincev mailto:oleg@ht-systems.ru[oleg@ht-systems.ru]
+* Oleg V. Volkov mailto:rover@lglobus.ru[rover@lglobus.ru]
+* Oleh Hushchenkov mailto:gor@clogic.com.ua[gor@clogic.com.ua]
+* Oleksandr Lystopad mailto:laa@laa.zp.ua[laa@laa.zp.ua]
+* Olexander Kunytsa mailto:kunia@wolf.istc.kiev.ua[kunia@wolf.istc.kiev.ua]
+* Oliver Breuninger mailto:ob@seicom.NET[ob@seicom.NET]
+* Oliver Dunkl mailto:odunkl@gmx.net[odunkl@gmx.net]
+* Oliver Fischer mailto:plexus@snafu.de[plexus@snafu.de]
+* Oliver Friedrichs mailto:oliver@secnet.com[oliver@secnet.com]
+* Oliver Hartmann mailto:ohartman@zedat.fu-berlin.de[ohartman@zedat.fu-berlin.de]
+* Oliver Heesakkers mailto:dev2@heesakkers.info[dev2@heesakkers.info]
+* Oliver Helmling mailto:oliver.helmling@stud.uni-bayreuth.de[oliver.helmling@stud.uni-bayreuth.de]
+* Oliver Laumann mailto:net@informatik.uni-bremen.de[net@informatik.uni-bremen.de]
+* Oliver Oberdorf mailto:oly@world.std.com[oly@world.std.com]
+* Oliver Peter mailto:hoschi@mouhaha.de[hoschi@mouhaha.de]
+* Olivier Beyssac mailto:obld@r14.freenix.org[obld@r14.freenix.org]
+* Olivier Tharan mailto:olive@oban.frmug.org[olive@oban.frmug.org]
+* Olof Johansson mailto:offe@ludd.luth.se[offe@ludd.luth.se]
+* Omer Faruk Sen mailto:ofsen@enderunix.org[ofsen@enderunix.org]
+* Oscar Bonilla mailto:obonilla@galileo.edu[obonilla@galileo.edu]
+* Otacílio de Araújo Ramos Neto mailto:otacilio.neto@ee.ufcg.edu.br[otacilio.neto@ee.ufcg.edu.br]
+* Otávio Fernandes mailto:otaviof@gmail.com[otaviof@gmail.com]
+* Ozkan KIRIK mailto:ozkan@enderunix.org[ozkan@enderunix.org]
+* Pace Willisson mailto:pace@blitz.com[pace@blitz.com]
+* Paco Rosich mailto:rosich@modico.eleinf.uv.es[rosich@modico.eleinf.uv.es]
+* Pakhom Golynga mailto:pg@pakhom.spb.ru[pg@pakhom.spb.ru]
+* Panagiotis Astithas mailto:past@noc.ntua.gr[past@noc.ntua.gr]
+* Panagiotis Kritikakos mailto:panoskrt@googlemail.com[panoskrt@googlemail.com]
+* Parag Patel mailto:parag@cgt.com[parag@cgt.com]
+* Pascal Pederiva mailto:pascal@zuo.dec.com[pascal@zuo.dec.com]
+* Pascal Vizeli mailto:pvizeli@yahoo.de[pvizeli@yahoo.de]
+* Pasi Hirvonen mailto:psh@iki.fi[psh@iki.fi]
+* Pasvorn Boonmark mailto:boonmark@juniper.net[boonmark@juniper.net]
+* Patrick Alken mailto:cosine@ellipse.mcs.drexel.edu[cosine@ellipse.mcs.drexel.edu]
+* Patrick Atamaniuk mailto:atamaniuk-ports@frobs.net[atamaniuk-ports@frobs.net]
+* Patrick Bihan-Faou mailto:patrick@mindstep.com[patrick@mindstep.com]
+* Patrick Dung mailto:patrick_dkt@yahoo.com.hk[patrick_dkt@yahoo.com.hk]
+* Patrick Hausen
+* Patrick MARIE mailto:mycroft@virgaria.org[mycroft@virgaria.org]
+* Patrick Powell mailto:papowell@astart.com[papowell@astart.com]
+* Patrick Rinke mailto:patrick@rinke-bochum.de[patrick@rinke-bochum.de]
+* Patrick Seal mailto:patseal@hyperhost.net[patseal@hyperhost.net]
+* Patrick Tracanelli mailto:eksffa@freebsdbrasil.com.br[eksffa@freebsdbrasil.com.br]
+* Paul mailto:onemda@gmail.com[onemda@gmail.com]
+* Paul A. Hoadley mailto:paulh@logicsquad.net[paulh@logicsquad.net]
+* Paul Antonov mailto:apg@demos.su[apg@demos.su]
+* Paul Chvostek mailto:paul@it.ca[paul@it.ca]
+* Paul Dlug mailto:paul@aps.org[paul@aps.org]
+* Paul F. Werkowski
+* Paul Fox mailto:pgf@foxharp.boston.ma.us[pgf@foxharp.boston.ma.us]
+* Paul Koch mailto:koch@thehub.com.au[koch@thehub.com.au]
+* Paul Kranenburg mailto:pk@NetBSD.org[pk@NetBSD.org]
+* Paul M. Lambert mailto:plambert@plambert.net[plambert@plambert.net]
+* Paul Mackerras mailto:paulus@cs.anu.edu.au[paulus@cs.anu.edu.au]
+* Paul Popelka mailto:paulp@uts.amdahl.com[paulp@uts.amdahl.com]
+* Paul S. LaFollette, Jr.
+* Paul Sandys mailto:myj@nyct.net[myj@nyct.net]
+* Paul Schmehl mailto:pauls@utdallas.edu[pauls@utdallas.edu]
+* Paul T. Root mailto:proot@horton.iaces.com[proot@horton.iaces.com]
+* Paul Vixie mailto:paul@vix.com[paul@vix.com]
+* Paulo Fragoso mailto:paulo@nlink.com.br[paulo@nlink.com.br]
+* Paulo Menezes mailto:paulo@isr.uc.pt[paulo@isr.uc.pt]
+* Paulo Menezes mailto:pm@dee.uc.pt[pm@dee.uc.pt]
+* Pavel Janik mailto:Pavel@Janik.cz[Pavel@Janik.cz]
+* Pavel Novikov mailto:pavel@ext.by[pavel@ext.by]
+* Pavel Pankov mailto:pankov_p@mail.ru[pankov_p@mail.ru]
+* Pavel Timofeev mailto:timp87@gmail.com[timp87@gmail.com]
+* Pavel Veretennikov mailto:vermut@kid.lv[vermut@kid.lv]
+* Pavel I Volkov mailto:pavelivolkov@googlemail.com[pavelivolkov@googlemail.com]
+* Pawel Worach mailto:pawel.worach@gmail.com[pawel.worach@gmail.com]
+* Pedro A M Vazquez mailto:vazquez@IQM.Unicamp.BR[vazquez@IQM.Unicamp.BR]
+* Pengfei JU mailto:jupengfei@gmail.com[jupengfei@gmail.com]
+* Per Wigren mailto:wigren@home.se[wigren@home.se]
+* Pete Bentley mailto:pete@demon.net[pete@demon.net]
+* Peter Ankerstål mailto:peter@pean.org[peter@pean.org]
+* Peter Avalos mailto:pavalos@theshell.com[pavalos@theshell.com]
+* Peter Childs mailto:pjchilds@imforei.apana.org.au[pjchilds@imforei.apana.org.au]
+* Peter Cornelius mailto:pc@inr.fzk.de[pc@inr.fzk.de]
+* Pete French mailto:pete@twisted.org.uk[pete@twisted.org.uk]
+* Peter Haight mailto:peterh@prognet.com[peterh@prognet.com]
+* Peter Holub mailto:hopet@ics.muni.cz[hopet@ics.muni.cz]
+* Peter Klatt mailto:glocke@bsdstammtisch.at[glocke@bsdstammtisch.at]
+* Peter Kolmisoppi mailto:growspd@brokep.com[growspd@brokep.com]
+* Peter M. Chen mailto:pmchen@eecs.umich.edu[pmchen@eecs.umich.edu]
+* Peter Much mailto:peter@citylink.dinoex.sub.org[peter@citylink.dinoex.sub.org]
+* Peter Olsson
+* Peter Philipp mailto:pjp@bsd-daemon.net[pjp@bsd-daemon.net]
+* Peter S. Housel mailto:housel@acm.org[housel@acm.org]
+* Peter Schuller mailto:peter.schuller@infidyne.com[peter.schuller@infidyne.com]
+* Peter Stubbs mailto:PETERS@staidan.qld.edu.au[PETERS@staidan.qld.edu.au]
+* Péter Terbe mailto:sncdev@gmail.com[sncdev@gmail.com]
+* Peter Thoenen mailto:peter.thoenen@yahoo.com[peter.thoenen@yahoo.com]
+* Peter Vereshagin mailto:peter@vereshagin.org[peter@vereshagin.org]
+* Peter W. Schmiedeskamp mailto:pschmied@qwest.net[pschmied@qwest.net]
+* Peter van Dijk mailto:peter@dataloss.nl[peter@dataloss.nl]
+* Peter van Heusden mailto:pvh@wfeet.za.net[pvh@wfeet.za.net]
+* Petr Macek mailto:pm@kostax.cz[pm@kostax.cz]
+* Petr Rehor mailto:prehor@gmail.com[prehor@gmail.com]
+* Phil Budne mailto:phil@ultimate.com[phil@ultimate.com]
+* Phil Maker mailto:pjm@gnu.org[pjm@gnu.org]
+* Phil Oleson mailto:oz@nixil.net[oz@nixil.net]
+* Phil Phillips mailto:pphillips@experts-exchange.com[pphillips@experts-exchange.com]
+* Phil Sutherland mailto:philsuth@mycroft.dialix.oz.au[philsuth@mycroft.dialix.oz.au]
+* Phil Taylor mailto:phil@zipmail.co.uk[phil@zipmail.co.uk]
+* Philip Musumeci mailto:p.musumeci@ieee.org[p.musumeci@ieee.org]
+* Philip Reynolds mailto:philip.reynolds@rfc-networks.ie[philip.reynolds@rfc-networks.ie]
+* Philip Schulz mailto:phs@deadc0.de[phs@deadc0.de]
+* Philip Stoev mailto:philip.stoev@galeracluster.com[philip.stoev@galeracluster.com]
+* Philippe Lefebvre mailto:nemesis@balistik.net[nemesis@balistik.net]
+* Philippe Maechler mailto:plcmaechler@gmail.com[plcmaechler@gmail.com]
+* Philippe Pepiot mailto:phil@philpep.org[phil@philpep.org]
+* Philippe Rocques mailto:phil@teaser.fr[phil@teaser.fr]
+* Pierre David mailto:pdagog@gmail.com[pdagog@gmail.com]
+* Pierre Y. Dampure mailto:pierre.dampure@k2c.co.uk[pierre.dampure@k2c.co.uk]
+* Pierre-Paul Lavoie mailto:ppl@nbnet.nb.ca[ppl@nbnet.nb.ca]
+* Pieter Danhieux mailto:opr@bsdaemon.be[opr@bsdaemon.be]
+* Piotr Florczyk mailto:p.florczyk@adminworkshop.pl[p.florczyk@adminworkshop.pl]
+* Piotr Rybicki mailto:meritus@innervision.pl[meritus@innervision.pl]
+* Piotr Smyrak mailto:piotr.smyrak@heron.pl[piotr.smyrak@heron.pl]
+* Pius Fischer mailto:pius@ienet.com[pius@ienet.com]
+* Pomegranate mailto:daver@flag.blackened.net[daver@flag.blackened.net]
+* Pontus Stenetorp mailto:ninjin@kth.se[ninjin@kth.se]
+* Powerdog Industries mailto:kevin.ruddy@powerdog.com[kevin.ruddy@powerdog.com]
+* Priit Järv mailto:priit@cc.ttu.ee[priit@cc.ttu.ee]
+* Prudhvi Krishna mailto:prudhvikrishna@gmail.com[prudhvikrishna@gmail.com]
+* Qiang Guo mailto:guoqiang_cn@126.com[guoqiang_cn@126.com]
+* Qing Feng mailto:qingfeng@me.com[qingfeng@me.com]
+* Quentin Baker mailto:bsd@quentb.com[bsd@quentb.com]
+* Quentin Stievenart mailto:acieroid@awesom.eu[acieroid@awesom.eu]
+* Quinton Dolan mailto:q@onthenet.com.au[q@onthenet.com.au]
+* R Joseph Wright mailto:rjoseph@mammalia.org[rjoseph@mammalia.org]
+* R. Kym Horsell
+* R Skinner mailto:port_maintainer@herveybayaustralia.com.au[port_maintainer@herveybayaustralia.com.au]
+* Radek Kozlowski mailto:radek@raadradd.com[radek@raadradd.com]
+* Radim Kolar mailto:hsn@netmag.cz[hsn@netmag.cz]
+* Radoslav Vasilev mailto:rvasilev@uni-svishtov.bg[rvasilev@uni-svishtov.bg]
+* Rafael Mentz Aquino mailto:rafael@lk6.com.br[rafael@lk6.com.br]
+* Rafal Lesniak mailto:fbsd@grid.einherjar.de[fbsd@grid.einherjar.de]
+* Raffaele De Lorenzo mailto:raffaele.delorenzo@libero.it[raffaele.delorenzo@libero.it]
+* Rainer Duffer mailto:rainer@ultra-secure.de[rainer@ultra-secure.de]
+* Ralf Friedl mailto:friedl@informatik.uni-kl.de[friedl@informatik.uni-kl.de]
+* Ralf Gebhart mailto:gebhart@secnetix.de[gebhart@secnetix.de]
+* Ralf van der Enden mailto:tremere@cainites.net[tremere@cainites.net]
+* Ralf van Dooren mailto:r.vdooren@snow.nl[r.vdooren@snow.nl]
+* Randal S. Masutani mailto:randal@comtest.com[randal@comtest.com]
+* Randall Hopper mailto:rhh@ct.picker.com[rhh@ct.picker.com]
+* Randall W. Dean mailto:rwd@osf.org[rwd@osf.org]
+* Randy Bush mailto:rbush@bainbridge.verio.net[rbush@bainbridge.verio.net]
+* Rashid N. Achilov mailto:shelton@sentry.granch.ru[shelton@sentry.granch.ru]
+* Rasmus Kaj mailto:rasmus@kaj.se[rasmus@kaj.se]
+* Raul Pollicino mailto:email-ports@def-defying.com[email-ports@def-defying.com]
+* Razi Khaja mailto:razi@genet.sickkids.on.ca[razi@genet.sickkids.on.ca]
+* Reed A. Cartwright mailto:cartwright@asu.edu[cartwright@asu.edu]
+* Reinier Bezuidenhout mailto:rbezuide@mikom.csir.co.za[rbezuide@mikom.csir.co.za]
+* Remington Lang mailto:MrL0L@charter.net[MrL0L@charter.net]
+* Remy Card mailto:Remy.Card@masi.ibp.fr[Remy.Card@masi.ibp.fr]
+* Renato P. S. Saoud mailto:renatofreerider@hotmail.com[renatofreerider@hotmail.com]
+* Revis Zinkov mailto:rzinkov@gmail.com[rzinkov@gmail.com]
+* Ricardas Cepas mailto:rch@richard.eu.org[rch@richard.eu.org]
+* Ricardo A. Reis mailto:ricardo.areis@gmail.com[ricardo.areis@gmail.com]
+* Riccardo Veraldi mailto:veraldi@cs.unibo.it[veraldi@cs.unibo.it]
+* Rich Morin mailto:rdm@cfcl.com[rdm@cfcl.com]
+* Rich Wood mailto:rich@FreeBSD.org.uk[rich@FreeBSD.org.uk]
+* Richard Arends mailto:richard@unixguru.nl[richard@unixguru.nl]
+* Richard Henderson mailto:richard@atheist.tamu.edu[richard@atheist.tamu.edu]
+* Richard Hwang mailto:rhwang@bigpanda.com[rhwang@bigpanda.com]
+* Richard J Kuhns mailto:rjk@watson.grauel.com[rjk@watson.grauel.com]
+* Richard Kiss mailto:richard@homemail.com[richard@homemail.com]
+* Richard M. Neswold mailto:rneswold@enteract.com[rneswold@enteract.com]
+* Richard Stallman mailto:rms@gnu.ai.mit.edu[rms@gnu.ai.mit.edu]
+* Richard Straka mailto:straka@user1.inficad.com[straka@user1.inficad.com]
+* Richard Tobin mailto:richard@cogsci.ed.ac.uk[richard@cogsci.ed.ac.uk]
+* Richard Wackerbarth mailto:rkw@Dataplex.NET[rkw@Dataplex.NET]
+* Richard Winkel mailto:rich@math.missouri.edu[rich@math.missouri.edu]
+* Richard Wiwatowski mailto:rjwiwat@adelaide.on.net[rjwiwat@adelaide.on.net]
+* Rick Fournier mailto:rick@help-desk.ca[rick@help-desk.ca]
+* Rick Macklin
+* Rick van der Zwet mailto:rick@wzoeterwoude.net[rick@wzoeterwoude.net]
+* Rihaz Jerrin mailto:rihaz.jerrin@gmail.com[rihaz.jerrin@gmail.com]
+* Roar Pettersen mailto:roar.pettersen@it.uib.no[roar.pettersen@it.uib.no]
+* Rob Austein mailto:sra@epilogue.com[sra@epilogue.com]
+* Rob Evers mailto:rob@debank.tv[rob@debank.tv]
+* Rob Mallory mailto:rmallory@qualcomm.com[rmallory@qualcomm.com]
+* Rob Snow mailto:rsnow@txdirect.net[rsnow@txdirect.net]
+* Robert Crossfield mailto:robcrossfield@gmail.com[robcrossfield@gmail.com]
+* Robert Crowe mailto:bob@speakez.com[bob@speakez.com]
+* Robert D. Thrush mailto:rd@phoenix.aii.com[rd@phoenix.aii.com]
+* Robert Eckardt mailto:roberte@MEP.Ruhr-Uni-Bochum.de[roberte@MEP.Ruhr-Uni-Bochum.de]
+* Robert Felber mailto:robtone@ek-muc.de[robtone@ek-muc.de]
+* Robert Kruus mailto:rob.kruus@gmail.com[rob.kruus@gmail.com]
+* Robert P Ricci mailto:ricci@cs.utah.edu[ricci@cs.utah.edu]
+* Robert Sanders mailto:rsanders@mindspring.com[rsanders@mindspring.com]
+* Robert Schlotterbeck mailto:robert@rs.tarrant.tx.us[robert@rs.tarrant.tx.us]
+* Robert Sexton mailto:robert@kudra.com[robert@kudra.com]
+* Robert Shady mailto:rls@id.net[rls@id.net]
+* Robert Simmons mailto:rsimmons0@gmail.com[rsimmons0@gmail.com]
+* Robert Swindells mailto:swindellsr@genrad.co.uk[swindellsr@genrad.co.uk]
+* Robert Withrow mailto:witr@rwwa.com[witr@rwwa.com]
+* Robert Yoder
+* Robert Zelaya mailto:rob@theseusnetworking.com[rob@theseusnetworking.com]
+* Roberto Fernandez Cueto mailto:roberfern@gmail.com[roberfern@gmail.com]
+* Robin Carey mailto:robin@mailgate.dtc.rankxerox.co.uk[robin@mailgate.dtc.rankxerox.co.uk]
+* Robin Elfrink mailto:elfrink@introweb.nl[elfrink@introweb.nl]
+* Robin Schilham mailto:co9@xs4all.nl[co9@xs4all.nl]
+* Robin Schoonover mailto:robin.schoonover@gmail.google.com[robin.schoonover@gmail.google.com]
+* Robson Mantovani mailto:robsonmantovani@gmail.com[robsonmantovani@gmail.com]
+* Rod Taylor mailto:ports@rbt.ca[ports@rbt.ca]
+* Rodrigo Graeff mailto:delphus@gmail.com[delphus@gmail.com]
+* Roger Hardiman mailto:roger@cs.strath.ac.uk[roger@cs.strath.ac.uk]
+* Roger Leigh mailto:rleigh@codelibre.net[rleigh@codelibre.net]
+* Roland Jesse mailto:jesse@cs.uni-magdeburg.de[jesse@cs.uni-magdeburg.de]
+* Roland Smith mailto:rsmith@xs4all.nl[rsmith@xs4all.nl]
+* Dr. Rolf Jansen mailto:cyclaero@gmail.com[cyclaero@gmail.com]
+* Roman Neuhauser mailto:neuhauser@chello.cz[neuhauser@chello.cz]
+* Roman Shterenzon mailto:roman@xpert.com[roman@xpert.com]
+* Roman Synyuk mailto:roman@univ.kiev.ua[roman@univ.kiev.ua]
+* Roman V. Palagin mailto:romanp@unshadow.net[romanp@unshadow.net]
+* Roman Y. Bogdanov mailto:sam@brj.pp.ru[sam@brj.pp.ru]
+* Ron Bickers mailto:rbickers@intercenter.net[rbickers@intercenter.net]
+* Ron Lenk mailto:rlenk@widget.xmission.com[rlenk@widget.xmission.com]
+* Ron van Daal mailto:ronvdaal@n1x.nl[ronvdaal@n1x.nl]
+* Ronald F. Guilmette mailto:rfg@monkeys.com[rfg@monkeys.com]
+* Ronald Klop mailto:ronald@echteman.nl[ronald@echteman.nl]
+* Ronald Kuehn mailto:kuehn@rz.tu-clausthal.de[kuehn@rz.tu-clausthal.de]
+* Roselyn Lee mailto:rosel@verniernetworks.com[rosel@verniernetworks.com]
+* Ross West mailto:freebsd@linepoint.com[freebsd@linepoint.com]
+* Rostislav Krasny mailto:rosti.bsd@gmail.com[rosti.bsd@gmail.com]
+* Roy Maples mailto:roy@marples.name[roy@marples.name]
+* Ruben mailto:chromium@hybridsource.org[chromium@hybridsource.org]
+* Rudolf Cejka mailto:cejkar@fit.vutbr.cz[cejkar@fit.vutbr.cz]
+* Rui Lopes mailto:rui@ruilopes.com[rui@ruilopes.com]
+* Ruslan Belkin mailto:rus@home2.UA.net[rus@home2.UA.net]
+* Ruslan Shevchenko mailto:rssh@cam.grad.kiev.ua[rssh@cam.grad.kiev.ua]
+* Russell Jackson mailto:rjackson@cserv62.csub.edu[rjackson@cserv62.csub.edu]
+* Russell L. Carter mailto:rcarter@pinyon.org[rcarter@pinyon.org]
+* Russell Vincent mailto:rv@groa.uct.ac.za[rv@groa.uct.ac.za]
+* Rusty Nejdl mailto:rnejdl@ringofsaturn.com[rnejdl@ringofsaturn.com]
+* Ryan Frederick mailto:ryanrfrederick@gmail.com[ryanrfrederick@gmail.com]
+* Ryan Grove mailto:ryan@wonko.com[ryan@wonko.com]
+* Ryan Moe mailto:ryan@transaeris.com[ryan@transaeris.com]
+* Ryan T. Dean mailto:rtdean@cytherianage.net[rtdean@cytherianage.net]
+* Ryan Thompson mailto:ryan@sasknow.com[ryan@sasknow.com]
+* Ryan Younce mailto:ryany@pobox.com[ryany@pobox.com]
+* Ryo MIYAMOTO mailto:rmiya@cc.hirosaki-u.ac.jp[rmiya@cc.hirosaki-u.ac.jp]
+* Ryo Okamoto mailto:ryo@aquahill.net[ryo@aquahill.net]
+* RyoTa SimaMoto mailto:liangtai.s4@gmail.com[liangtai.s4@gmail.com]
+* Ryuichiro IMURA mailto:imura@af.airnet.ne.jp[imura@af.airnet.ne.jp]
+* SANETO Takanori mailto:sanewo@strg.sony.co.jp[sanewo@strg.sony.co.jp]
+* SASAKI Shunsuke mailto:ele@pop17.odn.ne.jp[ele@pop17.odn.ne.jp]
+* SAWADA Mizuki mailto:miz@qb3.so-net.ne.jp[miz@qb3.so-net.ne.jp]
+* SPF mailto:spf@xslt.cs.nccu.edu.tw[spf@xslt.cs.nccu.edu.tw]
+* SUGIMURA Takashi mailto:sugimura@jp.FreeBSD.org[sugimura@jp.FreeBSD.org]
+* SURANYI Peter mailto:suranyip@jks.is.tsukuba.ac.jp[suranyip@jks.is.tsukuba.ac.jp]
+* Sakai Hiroaki mailto:sakai@miya.ee.kagu.sut.ac.jp[sakai@miya.ee.kagu.sut.ac.jp]
+* Sakari Jalovaara mailto:sja@tekla.fi[sja@tekla.fi]
+* Sam Hartman mailto:hartmans@mit.edu[hartmans@mit.edu]
+* Samee Shahzada mailto:onestsam@gmail.com[onestsam@gmail.com]
+* Samuel Lam mailto:skl@ScalableNetwork.com[skl@ScalableNetwork.com]
+* Samuel Tardieu mailto:sam@rfc1149.net[sam@rfc1149.net]
+* Samuele Zannoli mailto:zannoli@cs.unibo.it[zannoli@cs.unibo.it]
+* Samy Al Bahra mailto:samy@kerneled.com[samy@kerneled.com]
+* Sander Janssen mailto:janssen@rendo.dekooi.nl[janssen@rendo.dekooi.nl]
+* Sander Vesik mailto:sander@haldjas.folklore.ee[sander@haldjas.folklore.ee]
+* Sandro Sigala mailto:ssigala@globalnet.it[ssigala@globalnet.it]
+* Sarod Yatawatta mailto:sarod@users.sf.net[sarod@users.sf.net]
+* Sascha Biberhofer mailto:ports@skyforge.at[ports@skyforge.at]
+* Sascha Blank mailto:blank@fox.uni-trier.de[blank@fox.uni-trier.de]
+* Sascha Holzleiter mailto:sascha@root-login.org[sascha@root-login.org]
+* Sascha Klauder mailto:sklauder@trimind.de[sklauder@trimind.de]
+* Sascha Wildner mailto:swildner@channelz.GUN.de[swildner@channelz.GUN.de]
+* Satoh Junichi mailto:junichi@astec.co.jp[junichi@astec.co.jp]
+* Saulius Menkevicius mailto:bob@nulis.lt[bob@nulis.lt]
+* Scot Elliott mailto:scot@poptart.org[scot@poptart.org]
+* Scot W. Hetzel mailto:hetzels@westbend.net[hetzels@westbend.net]
+* Scott A. Kenney mailto:saken@rmta.ml.org[saken@rmta.ml.org]
+* Scott A. Moberly mailto:smoberly@xavier.dyndns.org[smoberly@xavier.dyndns.org]
+* Scott Blachowicz mailto:scott.blachowicz@seaslug.org[scott.blachowicz@seaslug.org]
+* Scott Burris mailto:scott@pita.cns.ucla.edu[scott@pita.cns.ucla.edu]
+* Scott Flatman mailto:sf@slappy.org[sf@slappy.org]
+* Scott Hazen Mueller mailto:scott@zorch.sf-bay.org[scott@zorch.sf-bay.org]
+* Scott Kleihege mailto:scott-ports@tummy.com[scott-ports@tummy.com]
+* Scott Lambert mailto:lambert@lambertfam.org[lambert@lambertfam.org]
+* Scott Michel mailto:scottm@cs.ucla.edu[scottm@cs.ucla.edu]
+* Scott Reynolds mailto:scott@clmqt.marquette.mi.us[scott@clmqt.marquette.mi.us]
+* Scott Ullrich mailto:sullrich@gmail.com[sullrich@gmail.com]
+* SeaD mailto:sead@mail.ru[sead@mail.ru]
+* Sean McLaughlin mailto:sigma.zx@gmail.com[sigma.zx@gmail.com]
+* Seamus Venasse mailto:svenasse@polaris.ca[svenasse@polaris.ca]
+* Sébastian Santoro mailto:dereckson@gmail.com[dereckson@gmail.com]
+* Sebastian Schwarz mailto:seschwar@gmail.com[seschwar@gmail.com]
+* Sebastian Strollo mailto:seb@erix.ericsson.se[seb@erix.ericsson.se]
+* Sebastian Yepes mailto:esn@x123.info[esn@x123.info]
+* Seiya Yanagita mailto:s_yanagita@ybb.ne.jp[s_yanagita@ybb.ne.jp]
+* Serge Gagnon mailto:gagnon_s@sympatico.ca[gagnon_s@sympatico.ca]
+* Serge Negodyuck mailto:petr@petrovich.kiev.ua[petr@petrovich.kiev.ua]
+* Serge V. Vakulenko mailto:vak@zebub.msk.su[vak@zebub.msk.su]
+* Sergei Chechetkin mailto:csl@whale.sunbay.crimea.ua[csl@whale.sunbay.crimea.ua]
+* Sergei S. Laskavy mailto:laskavy@pc759.cs.msu.su[laskavy@pc759.cs.msu.su]
+* Sergei Vyshenski mailto:svysh.fbsd@gmail.com[svysh.fbsd@gmail.com]
+* Sergey Akhmatov mailto:sergey@akhmatov.ru[sergey@akhmatov.ru]
+* Sergey Akifyev mailto:asa@gascom.ru[asa@gascom.ru]
+* Sergey Anohin mailto:admin@5034.ru[admin@5034.ru]
+* Sergey V. Dyatko mailto:sergey.dyatko@gmail.com[sergey.dyatko@gmail.com]
+* Sergey Gershtein mailto:sg@mplik.ru[sg@mplik.ru]
+* Sergey Glushchenko mailto:deen@smz.com.ua[deen@smz.com.ua]
+* Sergey Kosyakov mailto:ks@itp.ac.ru[ks@itp.ac.ru]
+* Sergey Lyubka mailto:valenok@gmail.com[valenok@gmail.com]
+* Sergey Matveev mailto:stargrave@stargrave.org[stargrave@stargrave.org]
+* Sergey N. Vorokov mailto:serg@tmn.ru[serg@tmn.ru]
+* Sergey Potapov mailto:sp@alkor.ru[sp@alkor.ru]
+* Sergey Samoyloff mailto:gonza@techline.ru[gonza@techline.ru]
+* Sergey Shkonda mailto:serg@bcs.zp.ua[serg@bcs.zp.ua]
+* Sergey V. Dorokhov mailto:svd@kbtelecom.nalnet.ru[svd@kbtelecom.nalnet.ru]
+* Sergey Velichkevych mailto:serg@cad.kiev.ua[serg@cad.kiev.ua]
+* Sergio Lenzi mailto:lenzi@bsi.com.br[lenzi@bsi.com.br]
+* Serguei Okladnikov mailto:oklaspec@gmail.com[oklaspec@gmail.com]
+* Shane Ambler mailto:freebsd@shaneware.biz[freebsd@shaneware.biz]
+* Shane Kinney mailto:mod6@freebsdhackers.net[mod6@freebsdhackers.net]
+* Shaun Courtney mailto:shaun@emma.eng.uct.ac.za[shaun@emma.eng.uct.ac.za]
+* Shawn M. Carey mailto:smcarey@mailbox.syr.edu[smcarey@mailbox.syr.edu]
+* Shell Hung mailto:shell@shellhung.org[shell@shellhung.org]
+* Shen Chuan-Hsing mailto:statue@freebsd.sinica.edu.tw[statue@freebsd.sinica.edu.tw]
+* Shigeru Yamamoto mailto:shigeru@iij.ad.jp[shigeru@iij.ad.jp]
+* Shigio Yamaguchi mailto:shigio@tamacom.com[shigio@tamacom.com]
+* Shin'ya Murakami mailto:murakami@ahs.scitec.kobe-u.ac.jp[murakami@ahs.scitec.kobe-u.ac.jp]
+* Shinichiro Komatsu mailto:koma2@ms.u-tokyo.ac.jp[koma2@ms.u-tokyo.ac.jp]
+* Shinsuke Matsui mailto:smatsui@karashi.org[smatsui@karashi.org]
+* Shinya Esu mailto:esu@yk.rim.or.jp[esu@yk.rim.or.jp]
+* Shinya FUJIE mailto:fujie@tk.elec.waseda.ac.jp[fujie@tk.elec.waseda.ac.jp]
+* Shuichi Tanaka mailto:stanaka@bb.mbn.or.jp[stanaka@bb.mbn.or.jp]
+* Siebrand Mazeland mailto:s.mazeland@xs4all.nl[s.mazeland@xs4all.nl]
+* Sijmen J. Mulder mailto:ik@sjmulder.nl[ik@sjmulder.nl]
+* Silvio Ap Silva mailto:alvolivre@live.com[alvolivre@live.com]
+* Simeon Simeonov mailto:sgs@pichove.org[sgs@pichove.org]
+* Simon mailto:simon@masi.ibp.fr[simon@masi.ibp.fr]
+* Simon Burge mailto:simonb@telstra.com.au[simonb@telstra.com.au]
+* Simon Cornelius P. Umacob mailto:simoncpu@infoweapons.com[simoncpu@infoweapons.com]
+* Simon Dick mailto:simond@irrelevant.org[simond@irrelevant.org]
+* Simon Lang mailto:simon@lang-clan.de[simon@lang-clan.de]
+* Simon Marlow mailto:simonmar@microsoft.com[simonmar@microsoft.com]
+* Simon Olofsson mailto:simon@olofsson.de[simon@olofsson.de]
+* Simon Peter mailto:probono@puredarwin.org[probono@puredarwin.org]
+* Simon Schubert mailto:corecode@corecode.ath.cx[corecode@corecode.ath.cx]
+* Simon Shapiro mailto:shimon@simon-shapiro.org[shimon@simon-shapiro.org]
+* Simun Mikecin mailto:numisemis@yahoo.com[numisemis@yahoo.com]
+* Sin'ichiro MIYATANI mailto:siu@phaseone.co.jp[siu@phaseone.co.jp]
+* Slaven Rezic mailto:slaven@rezic.de[slaven@rezic.de]
+* Snow Chyld mailto:snowchyld+freebsdports@gmail.com[snowchyld+freebsdports@gmail.com]
+* Soochon Radee mailto:slr@mitre.org[slr@mitre.org]
+* Soren Dayton mailto:csdayton@midway.uchicago.edu[csdayton@midway.uchicago.edu]
+* Soren Debois mailto:debois@diku.dk[debois@diku.dk]
+* Soren Dossing mailto:sauber@netcom.com[sauber@netcom.com]
+* Soren S. Jorvang mailto:soren@wheel.dk[soren@wheel.dk]
+* Stan Barber mailto:sob@academ.com[sob@academ.com]
+* Stanislav A. Svirid mailto:count@riss-telecom.ru[count@riss-telecom.ru]
+* Stanislav Grozev mailto:tacho@daemonz.org[tacho@daemonz.org]
+* Stanislaw Halik mailto:sthalik@tehran.lain.pl[sthalik@tehran.lain.pl]
+* Stanislav Shalunov mailto:shalunov@internet2.edu[shalunov@internet2.edu]
+* Stas Timokhin mailto:devel@stasyan.com[devel@stasyan.com]
+* Stefan A. Deutscher mailto:sad@mailaps.org[sad@mailaps.org]
+* Stefan Eggers mailto:seggers@semyam.dinoco.de[seggers@semyam.dinoco.de]
+* Stefan Ehmann mailto:shoesoft@gmx.net[shoesoft@gmx.net]
+* Stefan Grundmann mailto:sg-sendpr@waset.de[sg-sendpr@waset.de]
+* Stefan Jahn mailto:stefan.jahn@nemesis-sektor.de[stefan.jahn@nemesis-sektor.de]
+* Stefan Lambrev mailto:cheffo@freebsd-bg.org[cheffo@freebsd-bg.org]
+* Stefan Moeding mailto:s.moeding@ndh.net[s.moeding@ndh.net]
+* Stefan Petri
+* Stefan Rumetshofer mailto:sterum@overrider.at[sterum@overrider.at]
+* Stefan Schmidt mailto:stefan.schmidt@twest.de[stefan.schmidt@twest.de]
+* Stefan Schwarzer mailto:sschwarzer@sschwarzer.net[sschwarzer@sschwarzer.net]
+* Stefan Tell mailto:stefan.tell@crashmail.de[stefan.tell@crashmail.de]
+* Stefan `Sec` Zehl mailto:sec@42.org[sec@42.org]
+* Steffen Fritz mailto:steffen@fritz.wtf[steffen@fritz.wtf]
+* Steffen Mazanek mailto:steffen.mazanek@unibw-muenchen.de[steffen.mazanek@unibw-muenchen.de]
+* Steffen Vogelreuter mailto:Steffen@Vogelreuter.De[Steffen@Vogelreuter.De]
+* Steinar Haug mailto:sthaug@nethelp.no[sthaug@nethelp.no]
+* Sten Poldma mailto:exile@chamber.ee[exile@chamber.ee]
+* Sten Spans mailto:sten@blinkenlights.nl[sten@blinkenlights.nl]
+* Stepan Zastupov mailto:redchrom@gmail.com[redchrom@gmail.com]
+* Stephane Lapie mailto:stephane.lapie@darkbsd.org[stephane.lapie@darkbsd.org]
+* Stephen Clawson mailto:sclawson@marker.cs.utah.edu[sclawson@marker.cs.utah.edu]
+* Stephen F. Combs mailto:combssf@salem.ge.com[combssf@salem.ge.com]
+* Stephen Farrell mailto:stephen@farrell.org[stephen@farrell.org]
+* Stephen Fisher mailto:stephentfisher@yahoo.com[stephentfisher@yahoo.com]
+* Stephen Gunn mailto:csg@fedex.com[csg@fedex.com]
+* Stephen Hocking mailto:sysseh@devetir.qld.gov.au[sysseh@devetir.qld.gov.au]
+* Stephen J. Roznowski mailto:sjr@home.net[sjr@home.net]
+* Stephen McKay mailto:syssgm@devetir.qld.gov.au[syssgm@devetir.qld.gov.au]
+* Stephen Melvin mailto:melvin@zytek.com[melvin@zytek.com]
+* Stephen Weeks mailto:sweeks@sweeks.com[sweeks@sweeks.com]
+* Stephon Chen mailto:stephon@gmail.com[stephon@gmail.com]
+* Steve Ames mailto:steve@energistic.com[steve@energistic.com]
+* Steve Bauer mailto:sbauer@rock.sdsmt.edu[sbauer@rock.sdsmt.edu]
+* Steve Coltrin mailto:spcoltri@unm.edu[spcoltri@unm.edu]
+* Steve Deering
+* Steve Franks mailto:bahamasfranks@gmail.com[bahamasfranks@gmail.com]
+* Steve Gerakines mailto:steve2@genesis.tiac.net[steve2@genesis.tiac.net]
+* Steve Gericke mailto:steveg@comtrol.com[steveg@comtrol.com]
+* Steve O'Hara-Smith mailto:steve@sohara.org[steve@sohara.org]
+* Steve Piette mailto:steve@simon.chi.il.US[steve@simon.chi.il.US]
+* Steve Roome mailto:steve@pepcross.com[steve@pepcross.com]
+* Steve Schwarz mailto:schwarz@alpharel.com[schwarz@alpharel.com]
+* Steven Enderle mailto:panic@subphase.de[panic@subphase.de]
+* Steven H. Samorodin mailto:samorodi@NUXI.com[samorodi@NUXI.com]
+* Steven Hartland mailto:steven.hartland@multiplay.co.uk[steven.hartland@multiplay.co.uk]
+* Steven Honson mailto:steven@honson.org[steven@honson.org]
+* Steven McCanne mailto:mccanne@cs.berkeley.edu[mccanne@cs.berkeley.edu]
+* Steven Plite mailto:splite@purdue.edu[splite@purdue.edu]
+* Steven Wallace
+* Stig Inge Lea Bjørnsen mailto:stiginge@pvv.org[stiginge@pvv.org]
+* Stijn Hoop mailto:stijn@win.tue.nl[stijn@win.tue.nl]
+* Stuart Henderson mailto:stuart@internationalschool.co.uk[stuart@internationalschool.co.uk]
+* Stylianos Sideridis mailto:siderste@yahoo.gr[siderste@yahoo.gr]
+* Sue Blake mailto:sue@welearn.com.au[sue@welearn.com.au]
+* Sugimoto Sadahiro mailto:ixtl@komaba.utmc.or.jp[ixtl@komaba.utmc.or.jp]
+* Sugiura Shiro mailto:ssugiura@duo.co.jp[ssugiura@duo.co.jp]
+* Sujal Patel mailto:smpatel@wam.umd.edu[smpatel@wam.umd.edu]
+* Sulev-Madis Silber mailto:madis555@hot.ee[madis555@hot.ee]
+* Sune Stjerneby mailto:sst@vmunix.dk[sst@vmunix.dk]
+* Sungman Cho mailto:smcho@tsp.korea.ac.kr[smcho@tsp.korea.ac.kr]
+* Sutra Zhou mailto:zhoushuqun@gmail.com[zhoushuqun@gmail.com]
+* Suzuki Yoshiaki mailto:zensyo@ann.tama.kawasaki.jp[zensyo@ann.tama.kawasaki.jp]
+* Svein Skogen mailto:tds@dmnstech.net[tds@dmnstech.net]
+* Sven Klose mailto:pixel@hugbox.org[pixel@hugbox.org]
+* Sven Mohr mailto:svmohr@rm6.net[svmohr@rm6.net]
+* Svyatoslav Lempert mailto:svyatoslav.lempert@gmail.com[svyatoslav.lempert@gmail.com]
+* Sybolt de Boer mailto:bolt@xs4all.nl[bolt@xs4all.nl]
+* TAKAHASHI Kaoru mailto:kaoru@kaisei.org[kaoru@kaisei.org]
+* TERAMOTO Masahiro mailto:markun@onohara.to[markun@onohara.to]
+* Tadashi Kumano mailto:kumano@strl.nhk.or.jp[kumano@strl.nhk.or.jp]
+* Taguchi Takeshi mailto:taguchi@tohoku.iij.ad.jp[taguchi@tohoku.iij.ad.jp]
+* Takahiro Yugawa mailto:yugawa@orleans.rim.or.jp[yugawa@orleans.rim.or.jp]
+* Takashi Mega mailto:mega@minz.org[mega@minz.org]
+* Takashi Uozu mailto:j1594016@ed.kagu.sut.ac.jp[j1594016@ed.kagu.sut.ac.jp]
+* Takayuki Ariga mailto:a00821@cc.hc.keio.ac.jp[a00821@cc.hc.keio.ac.jp]
+* Takayuki Nakao mailto:t@nakao.org[t@nakao.org]
+* Takeru NAIKI mailto:naiki@bfd.es.hokudai.ac.jp[naiki@bfd.es.hokudai.ac.jp]
+* Takeshi Amaike mailto:amaike@iri.co.jp[amaike@iri.co.jp]
+* Takeshi MUTOH mailto:mutoh@info.nara-k.ac.jp[mutoh@info.nara-k.ac.jp]
+* Takeshi Ohashi mailto:ohashi@mickey.ai.kyutech.ac.jp[ohashi@mickey.ai.kyutech.ac.jp]
+* Takeshi WATANABE mailto:watanabe@crayon.earth.s.kobe-u.ac.jp[watanabe@crayon.earth.s.kobe-u.ac.jp]
+* Takuya SHIOZAKI mailto:tshiozak@makino.ise.chuo-u.ac.jp[tshiozak@makino.ise.chuo-u.ac.jp]
+* Talal Al Dik mailto:tad@vif.com[tad@vif.com]
+* Tanja Wittke mailto:tawi@gruft.de[tawi@gruft.de]
+* Tarasov Alexey mailto:master@preved.cn[master@preved.cn]
+* Tassilo Philipp mailto:tphilipp@potion-studios.com[tphilipp@potion-studios.com]
+* Tatoku Ogaito mailto:tacha@tera.fukui-med.ac.jp[tacha@tera.fukui-med.ac.jp]
+* Tatsuki Makino mailto:tatsuki_makino@hotmail.com[tatsuki_makino@hotmail.com]
+* Tatsuya Kudoh mailto:cdr@cosmonet.org[cdr@cosmonet.org]
+* Tatsuya Ueda mailto:ml+freebsd@tatsuya.info[ml+freebsd@tatsuya.info]
+* Taylor Dondich mailto:tdondich@majiknetworks.com[tdondich@majiknetworks.com]
+* Ted Buswell mailto:tbuswell@mediaone.net[tbuswell@mediaone.net]
+* Ted Faber mailto:faber@isi.edu[faber@isi.edu]
+* Ted Lemon mailto:mellon@isc.org[mellon@isc.org]
+* Ted Stodgell mailto:trs137@psu.edu[trs137@psu.edu]
+* Teodor Sigaev mailto:teodor@sigaev.ru[teodor@sigaev.ru]
+* Terry Lambert mailto:terry@lambert.org[terry@lambert.org]
+* Terry Lee mailto:terry@uivlsi.csl.uiuc.edu[terry@uivlsi.csl.uiuc.edu]
+* Terry Sposato mailto:terry@sucked-in.com[terry@sucked-in.com]
+* Teruaki Ata mailto:PFA03027@nifty.ne.jp[PFA03027@nifty.ne.jp]
+* Tetsuro Yabu mailto:yabu@uopmu.ees.osakafu-u.ac.jp[yabu@uopmu.ees.osakafu-u.ac.jp]
+* Tetsuya Furukawa mailto:tetsuya@secom-sis.co.jp[tetsuya@secom-sis.co.jp]
+* Thaddeus Covert mailto:tcovert+ports@sahuagin.net[tcovert+ports@sahuagin.net]
+* Theo de Raadt mailto:deraadt@OpenBSD.org[deraadt@OpenBSD.org]
+* Thierry Dussuet mailto:thierry@dussuet.lugs.ch[thierry@dussuet.lugs.ch]
+* Thomas mailto:thomas@mathematik.uni-Bremen.de[thomas@mathematik.uni-Bremen.de]
+* Thomas A. Stephens mailto:tas@stephens.org[tas@stephens.org]
+* Thomas Bartelmess mailto:thomas@bartelmess.io[thomas@bartelmess.io]
+* Thomas BRETON mailto:tom@h-inventory.com[tom@h-inventory.com]
+* Thomas Cort mailto:linuxgeek@gmail.com[linuxgeek@gmail.com]
+* Thomas D. Dean mailto:tomdean@ix.netcom.com[tomdean@ix.netcom.com]
+* Thomas David Rivers mailto:rivers@dignus.com[rivers@dignus.com]
+* Thomas Dreibholz mailto:dreibh@iem.uni-due.de[dreibh@iem.uni-due.de]
+* Thomas G. McWilliams mailto:tgm@netcom.com[tgm@netcom.com]
+* Thomas Hurst mailto:tom@hur.st[tom@hur.st]
+* Thomas Kempka mailto:t.kempka@web.de[t.kempka@web.de]
+* Thomas König mailto:Thomas.Koenig@ciw.uni-karlsruhe.de[Thomas.Koenig@ciw.uni-karlsruhe.de]
+* Thomas M. Hermann mailto:Thomas.Hermann@cox.net[Thomas.Hermann@cox.net]
+* Thomas Melzer mailto:tmelzer@tomesoft.de[tmelzer@tomesoft.de]
+* Thomas Ptacek
+* Thomas Spreng mailto:spreng@socket.ch[spreng@socket.ch]
+* Thomas Stromberg mailto:tstrombe@rtci.com[tstrombe@rtci.com]
+* Thomas Valentino Crimi mailto:tcrimi+@andrew.cmu.edu[tcrimi+@andrew.cmu.edu]
+* Thomas Vogt mailto:thomas.vogt@bsdunix.ch[thomas.vogt@bsdunix.ch]
+* Thorsten Greiner mailto:thorsten@tgreiner.net[thorsten@tgreiner.net]
+* Þórður Ívarsson mailto:totii@est.is[totii@est.is]
+* Tillman Hodgson mailto:tillman@seekingfire.com[tillman@seekingfire.com]
+* Tim Daneliuk mailto:tundra@tundraware.com[tundra@tundraware.com]
+* Tim Hemel mailto:tim@n2it.net[tim@n2it.net]
+* Tim Little mailto:tim@wallago.co.uk[tim@wallago.co.uk]
+* Tim Niemueller mailto:tim@niemueller.de[tim@niemueller.de]
+* Tim Pozar mailto:pozar@lns.com[pozar@lns.com]
+* Tim Singletary mailto:tsingle@sunland.gsfc.nasa.gov[tsingle@sunland.gsfc.nasa.gov]
+* Tim Welch mailto:ports@thepentagon.org[ports@thepentagon.org]
+* Tim Wilkinson mailto:tim@sarc.city.ac.uk[tim@sarc.city.ac.uk]
+* Timo J. Rinne mailto:tri@iki.fi[tri@iki.fi]
+* Timofeev Vladimir mailto:vovkasm@gmail.com[vovkasm@gmail.com]
+* Timothy Beyer mailto:beyert@cs.ucr.edu[beyert@cs.ucr.edu]
+* Timothy Bourke mailto:timbob@bigpond.com[timbob@bigpond.com]
+* Timothy Jensen mailto:toast@blackened.com[toast@blackened.com]
+* Timothy Redaelli mailto:drizzt@drizzt.ath.cx[drizzt@drizzt.ath.cx]
+* Ting-Wei Lan mailto:lantw44@gmail.com[lantw44@gmail.com]
+* Tobias Begalke mailto:tobega@spyz.org[tobega@spyz.org]
+* Tobias Reifenberger mailto:treif@mayn.de[treif@mayn.de]
+* Tobias Roth mailto:ports@fsck.ch[ports@fsck.ch]
+* Toby Allsopp mailto:toby@mi6.gen.nz[toby@mi6.gen.nz]
+* Todd Miller mailto:millert@openbsd.org[millert@openbsd.org]
+* Todd Mortensen mailto:todd@thisisa.com[todd@thisisa.com]
+* Tofig Suleymanov mailto:tofig@freebsd.az[tofig@freebsd.az]
+* Tom mailto:root@majestix.cmr.no[root@majestix.cmr.no]
+* Tom Carrick mailto:knyghtmare@knyghtmare.com[knyghtmare@knyghtmare.com]
+* Tom Gray - DCA mailto:dcasba@rain.org[dcasba@rain.org]
+* Tom Jobbins mailto:tom@tom.tj[tom@tom.tj]
+* Tom Mortensen mailto:tom@tavrasm.org[tom@tavrasm.org]
+* Tom Mueller-Kortkamp mailto:tmueko@kommunity.net[tmueko@kommunity.net]
+* Tom Pusateri mailto:pusateri@juniper.net[pusateri@juniper.net]
+* Tom Rush mailto:tarush@mindspring.com[tarush@mindspring.com]
+* Tom Samplonius mailto:tom@misery.sdf.com[tom@misery.sdf.com]
+* Tomas Verbaitis mailto:tomasv@megalogika.lt[tomasv@megalogika.lt]
+* Tomasz Walaszek mailto:tmwalaszek@gmail.com[tmwalaszek@gmail.com]
+* Tomaž Muraus mailto:kami@k5-storitve.net[kami@k5-storitve.net]
+* Tomek Cedro mailto:tomek.cedro@gmail.com[tomek.cedro@gmail.com]
+* Tomohiko Kurahashi mailto:kura@melchior.q.t.u-tokyo.ac.jp[kura@melchior.q.t.u-tokyo.ac.jp]
+* Tomoyuki Sakurai mailto:cherry@trombik.org[cherry@trombik.org]
+* Toni Andjelkovic mailto:toni@soth.at[toni@soth.at]
+* Toni Gundogdu mailto:legatvs@gmail.com[legatvs@gmail.com]
+* Toni Viemero mailto:toni.viemero@iki.fi[toni.viemero@iki.fi]
+* Tony Kimball mailto:alk@Think.COM[alk@Think.COM]
+* Tony Li mailto:tli@jnx.com[tli@jnx.com]
+* Tony Lynn mailto:wing@cc.nsysu.edu.tw[wing@cc.nsysu.edu.tw]
+* Tony Maher mailto:tonym@biolateral.com.au[tonym@biolateral.com.au]
+* Tony Shadwick mailto:numbski@hksilver.net[numbski@hksilver.net]
+* Tor Halvard "Squat" Furulund mailto:squat@squat.no[squat@squat.no]
+* Torbjorn Granlund mailto:tege@matematik.su.se[tege@matematik.su.se]
+* Toshiharu Ohno mailto:tony-o@iij.ad.jp[tony-o@iij.ad.jp]
+* Toshihiko SHIMOKAWA mailto:toshi@tea.forus.or.jp[toshi@tea.forus.or.jp]
+* Toshihiro Kanda mailto:candy@kgc.co.jp[candy@kgc.co.jp]
+* Toshiomi Moriki mailto:Toshiomi.Moriki@ma1.seikyou.ne.jp[Toshiomi.Moriki@ma1.seikyou.ne.jp]
+* Toshiya SAITOH mailto:toshiya@saitoh.nu[toshiya@saitoh.nu]
+* Travis Campbell mailto:hcoyote@ghostar.org[hcoyote@ghostar.org]
+* Travis Poppe mailto:tlp@liquidx.org[tlp@liquidx.org]
+* Trefor S. mailto:trefor@flevel.co.uk[trefor@flevel.co.uk]
+* Trenton Schulz mailto:twschulz@cord.edu[twschulz@cord.edu]
+* Trevor Blackwell mailto:tlb@viaweb.com[tlb@viaweb.com]
+* Trevor Cornpropst mailto:tcornpropst@cox.net[tcornpropst@cox.net]
+* Trober mailto:trober@trober.com[trober@trober.com]
+* Troels Kofoed Jacobsen mailto:tkjacobsen@gmail.com[tkjacobsen@gmail.com]
+* Tsung-Han Yeh mailto:snowfly@yuntech.edu.tw[snowfly@yuntech.edu.tw]
+* Tz-Huan Huang mailto:tzhuan@gmail.com[tzhuan@gmail.com]
+* Tzanetos Balitsaris mailto:tzabal@it.teithe.gr[tzabal@it.teithe.gr]
+* UMENO Takashi mailto:umeno@rr.iij4u.or.jp[umeno@rr.iij4u.or.jp]
+* URATA Shuichiro mailto:s-urata@nmit.tmg.nec.co.jp[s-urata@nmit.tmg.nec.co.jp]
+* Udo Schweigert mailto:udo.schweigert@siemens.com[udo.schweigert@siemens.com]
+* Uffe Jakobsen mailto:uffe@uffe.org[uffe@uffe.org]
+* Ugo Paternostro mailto:paterno@dsi.unifi.it[paterno@dsi.unifi.it]
+* Ulf Kieber mailto:kieber@sax.de[kieber@sax.de]
+* Ulli Linzen mailto:ulli@perceval.camelot.de[ulli@perceval.camelot.de]
+* Ullrich Franke mailto:trash.esiac@googlemail.com[trash.esiac@googlemail.com]
+* Uwe Arndt mailto:arndt@mailhost.uni-koblenz.de[arndt@mailhost.uni-koblenz.de]
+* Uwe Pierau mailto:uwe.pierau@tu-clausthal.de[uwe.pierau@tu-clausthal.de]
+* Vaggelis Typaldos mailto:frances@mylannet.gr[frances@mylannet.gr]
+* Vadim Belman mailto:voland@catpipe.net[voland@catpipe.net]
+* Vadim Chekan mailto:vadim@gc.lviv.ua[vadim@gc.lviv.ua]
+* Vadim Goncharov mailto:vadim_nuclight@mail.ru[vadim_nuclight@mail.ru]
+* Vadim Kolontsov mailto:vadim@tversu.ac.ru[vadim@tversu.ac.ru]
+* Vadim Kurland mailto:vadim@fwbuilder.org[vadim@fwbuilder.org]
+* Vadim Mikhailov mailto:mvp@braz.ru[mvp@braz.ru]
+* Vaida Bogdan mailto:vaida.bogdan@gmail.com[vaida.bogdan@gmail.com]
+* Vaidas Zlotkus mailto:r2@music.lt[r2@music.lt]
+* Valentin Nechayev mailto:netch@lucky.net[netch@lucky.net]
+* Valentin Zahariev mailto:curly@e-card.bg[curly@e-card.bg]
+* Valery Komarov mailto:komarov@valerka.net[komarov@valerka.net]
+* Van Jacobson mailto:van@ee.lbl.gov[van@ee.lbl.gov]
+* Vany Serezhkin mailto:ivan@serezhkin.com[ivan@serezhkin.com]
+* Vaclav Haisman mailto:v.haisman@sh.cvut.cz[v.haisman@sh.cvut.cz]
+* Vasek Balcar mailto:vasek@ti.cz[vasek@ti.cz]
+* Vasily V. Grechishnikov mailto:bazilio@ns1.ied-vorstu.ac.ru[bazilio@ns1.ied-vorstu.ac.ru]
+* Vasim Valejev mailto:vasim@uddias.diaspro.com[vasim@uddias.diaspro.com]
+* Vassili Tchersky mailto:vt@bsd-fr.org[vt@bsd-fr.org]
+* Vernon J. Schryver mailto:vjs@mica.denver.sgi.com[vjs@mica.denver.sgi.com]
+* Veselin Slavov mailto:vess@btc.net[vess@btc.net]
+* Viacheslav Mikerov mailto:SlavaMikerov@gmail.com[SlavaMikerov@gmail.com]
+* Vic Abell mailto:abe@cc.purdue.edu[abe@cc.purdue.edu]
+* Victor Cruceru mailto:victor.cruceru@gmail.com[victor.cruceru@gmail.com]
+* Victor Popov mailto:v.a.popov@gmail.com[v.a.popov@gmail.com]
+* Victor Semionov mailto:semionov@mail.bg[semionov@mail.bg]
+* Vidar Karlsen mailto:vidar@karlsen.tech[vidar@karlsen.tech]
+* Viktor Fomichev mailto:vfom@narod.ru[vfom@narod.ru]
+* Ville Eerola mailto:ve@sci.fi[ve@sci.fi]
+* Vince Valenti mailto:vince@blue-box.net[vince@blue-box.net]
+* Vincent DEFERT mailto:20.100@defert.com[20.100@defert.com]
+* Vincent Poy mailto:vince@DNALOGIC.NET[vince@DNALOGIC.NET]
+* Vincent Tantardini mailto:vinc@freebsd-fr.org[vinc@freebsd-fr.org]
+* Vincenzo Capuano mailto:VCAPUANO@vmprofs.esoc.esa.de[VCAPUANO@vmprofs.esoc.esa.de]
+* Virgil Champlin mailto:champlin@pa.dec.com[champlin@pa.dec.com]
+* Vitaly Magerya mailto:vmagerya@gmail.com[vmagerya@gmail.com]
+* Vivek Khera mailto:vivek@khera.org[vivek@khera.org]
+* Vlad GALU mailto:dudu@dudu.ro[dudu@dudu.ro]
+* Vlad V. Teterya mailto:vlad@vlad.uz.ua[vlad@vlad.uz.ua]
+* Vladimir A. Jakovenko mailto:vovik@ntu-kpi.kiev.ua[vovik@ntu-kpi.kiev.ua]
+* Vladimir Chukharev mailto:vladimir.chukharev@gmail.com[vladimir.chukharev@gmail.com]
+* Vladimir Gorelov mailto:virtual.lark@gmail.com[virtual.lark@gmail.com]
+* Vladimir Kurtikov mailto:vk@vk.pp.ru[vk@vk.pp.ru]
+* Vladimir Kushnir mailto:kushn@mail.kar.net[kushn@mail.kar.net]
+* Vladimir Osintsev mailto:oc@nm.ru[oc@nm.ru]
+* Vladimir Savichev mailto:vlad@ariel.phys.wesleyan.edu[vlad@ariel.phys.wesleyan.edu]
+* Volker Theile mailto:votdev@gmx.de[votdev@gmx.de]
+* Volker Quetschke mailto:quetschke@scytek.de[quetschke@scytek.de]
+* Volodymyr Kostyrko mailto:c.kworr@gmail.com[c.kworr@gmail.com]
+* Vsevolod Lobko mailto:seva@ip.net.ua[seva@ip.net.ua]
+* Vyacheslav Anikin mailto:ghos@mail.ru[ghos@mail.ru]
+* Vyacheslav Ivanchenko mailto:ivi@dhs.net.ru[ivi@dhs.net.ru]
+* W. Gerald Hicks mailto:wghicks@bellsouth.net[wghicks@bellsouth.net]
+* W. Richard Stevens mailto:rstevens@noao.edu[rstevens@noao.edu]
+* Waitman Gobble mailto:waitman@waitman.net[waitman@waitman.net]
+* Walt Howard mailto:howard@ee.utah.edu[howard@ee.utah.edu]
+* Walt M. Shandruk mailto:walt@erudition.net[walt@erudition.net]
+* Walter Hop mailto:walter@binity.com[walter@binity.com]
+* Walter Venable mailto:weaseal@hotmail.com[weaseal@hotmail.com]
+* Warren Toomey mailto:wkt@csadfa.cs.adfa.oz.au[wkt@csadfa.cs.adfa.oz.au]
+* Watanabe Kazuhiro mailto:CQG00620@nifty.ne.jp[CQG00620@nifty.ne.jp]
+* Wayne Scott mailto:wscott@ichips.intel.com[wscott@ichips.intel.com]
+* Wei-Hao Syu mailto:whsyu@arbor.ee.ntu.edu.tw[whsyu@arbor.ee.ntu.edu.tw]
+* Wei-Yu Chen mailto:weiyu.csie@gmail.com[weiyu.csie@gmail.com]
+* Wendell Borges mailto:perlporter@gmail.com[perlporter@gmail.com]
+* Wei Guo mailto:darcsis@gmail.com[darcsis@gmail.com]
+* Wei Zhao mailto:amutu@amutu.com[amutu@amutu.com]
+* Werner Griessl mailto:werner@btp1da.phy.uni-bayreuth.de[werner@btp1da.phy.uni-bayreuth.de]
+* Wes Santee mailto:wsantee@wsantee.oz.net[wsantee@wsantee.oz.net]
+* Wietse Venema mailto:wietse@wzv.win.tue.nl[wietse@wzv.win.tue.nl]
+* Wiljo Heinen mailto:wiljo@freeside.ki.open.de[wiljo@freeside.ki.open.de]
+* Willem Jan Withagen mailto:wjw@withagen.nl[wjw@withagen.nl]
+* Willem van Engen mailto:wvengen@stack.nl[wvengen@stack.nl]
+* William Jolitz mailto:withheld[withheld]
+* William Josephson mailto:wkj-freebsd@honk.eecs.harvard.edu[wkj-freebsd@honk.eecs.harvard.edu]
+* William Liao mailto:william@tale.net[william@tale.net]
+* Wojtek Pilorz mailto:wpilorz@celebris.bdk.lublin.pl[wpilorz@celebris.bdk.lublin.pl]
+* Wolfgang Helbig mailto:helbig@ba-stuttgart.de[helbig@ba-stuttgart.de]
+* Wolfgang Solfrank mailto:ws@tools.de[ws@tools.de]
+* {wolf}
+* Woodchuck Dave mailto:djv@bedford.net[djv@bedford.net]
+* Woody Carey mailto:woodycarey@hotmail.com[woodycarey@hotmail.com]
+* Wouter Van Hemel mailto:wouter@pair.com[wouter@pair.com]
+* Wu Ching-hong mailto:woju@FreeBSD.ee.Ntu.edu.TW[woju@FreeBSD.ee.Ntu.edu.TW]
+* {wylie}
+* Xavier Beaudouin mailto:kiwi@oav.net[kiwi@oav.net]
+* Xiaoding Liu mailto:xiaoding+freebsd@xiaoding.org[xiaoding+freebsd@xiaoding.org]
+* Yamagi Burmeister mailto:yamagi@yamagi.org[yamagi@yamagi.org]
+* Yanhui Shen mailto:shen.elf@gmail.com[shen.elf@gmail.com]
+* Yann Berthier mailto:yb@bachibouzouk.org[yb@bachibouzouk.org]
+* Yannis Kotsinos mailto:zookie@med.auth.gr[zookie@med.auth.gr]
+* Yarema mailto:yds@ingress.com[yds@ingress.com]
+* Yaroslav Terletsky mailto:ts@polynet.lviv.ua[ts@polynet.lviv.ua]
+* Yasuhiro Fukama mailto:yasuf@big.or.jp[yasuf@big.or.jp]
+* Yasuhito FUTATSUKI mailto:futatuki@fureai.or.jp[futatuki@fureai.or.jp]
+* Yen-Shuo Su mailto:yssu@CCCA.NCTU.edu.tw[yssu@CCCA.NCTU.edu.tw]
+* Yi-Feng Tzeng mailto:yftzeng@gmail.com[yftzeng@gmail.com]
+* Yi-Hsuan Hsin mailto:mhsin@mhsin.org[mhsin@mhsin.org]
+* Ying-Chieh Chen mailto:yinjieh@csie.nctu.edu.tw[yinjieh@csie.nctu.edu.tw]
+* Yinghong Liu mailto:relaxbsd@gmail.com[relaxbsd@gmail.com]
+* Yixin Jin mailto:yjin@rain.cs.ucla.edu[yjin@rain.cs.ucla.edu]
+* Yoichi Asai mailto:yatt@msc.biglobe.ne.jp[yatt@msc.biglobe.ne.jp]
+* Yoshiaki Uchikawa mailto:yoshiaki@kt.rim.or.jp[yoshiaki@kt.rim.or.jp]
+* Yoshihiko SARUMRU mailto:mistral@imasy.or.jp[mistral@imasy.or.jp]
+* Yoshihisa NAKAGAWA mailto:y-nakaga@ccs.mt.nec.co.jp[y-nakaga@ccs.mt.nec.co.jp]
+* Yoshikazu Goto mailto:gotoh@ae.anritsu.co.jp[gotoh@ae.anritsu.co.jp]
+* Yoshimasa Ohnishi mailto:ohnishi@isc.kyutech.ac.jp[ohnishi@isc.kyutech.ac.jp]
+* Yoshishige Arai mailto:ryo2@on.rim.or.jp[ryo2@on.rim.or.jp]
+* Yu-Shun Wang mailto:yushunwa@isi.edu[yushunwa@isi.edu]
+* Yuan-Chung Hsiao mailto:ychsiao@ychsiao.idv.tw[ychsiao@ychsiao.idv.tw]
+* Yuan Jue mailto:yuanjue@yuanjue.net[yuanjue@yuanjue.net]
+* Yuichi MATSUTAKA mailto:matutaka@osa.att.ne.jp[matutaka@osa.att.ne.jp]
+* Yuichiro AIZAWA mailto:yaizawa@mdbl.sfc.keio.ac.jp[yaizawa@mdbl.sfc.keio.ac.jp]
+* Yuichiro NAITO mailto:naito.yuichiro@gmail.com[naito.yuichiro@gmail.com]
+* Yujiro MIYATA mailto:miyata@bioele.nuee.nagoya-u.ac.jp[miyata@bioele.nuee.nagoya-u.ac.jp]
+* Yuki SHIMAZU mailto:y.shimazu@nifty.com[y.shimazu@nifty.com]
+* Yuri Kurenkov mailto:y.kurenkov@init.ru[y.kurenkov@init.ru]
+* Yuriy N. Shkandybin mailto:jura@netams.com[jura@netams.com]
+* Yuriy Tsibizov mailto:Yuriy.Tsibizov@gfk.ru[Yuriy.Tsibizov@gfk.ru]
+* Yusuke Nawano mailto:azuki@azkey.org[azuki@azkey.org]
+* Yu-Xi Lim mailto:yuxi@gmx.net[yuxi@gmx.net]
+* Yuu Yashiki mailto:s974123@cc.matsuyama-u.ac.jp[s974123@cc.matsuyama-u.ac.jp]
+* Yuuichi Narahara mailto:aconitum@po.teleway.ne.jp[aconitum@po.teleway.ne.jp]
+* Yuuki SAWADA mailto:mami@whale.cc.muroran-it.ac.jp[mami@whale.cc.muroran-it.ac.jp]
+* Yuukis mailto:Ys@PixyGarden.net[Ys@PixyGarden.net]
+* Yuval Yarom mailto:yval@cs.huji.ac.il[yval@cs.huji.ac.il]
+* Yves Fonk mailto:yves@cpcoup5.tn.tudelft.nl[yves@cpcoup5.tn.tudelft.nl]
+* Yves Fonk mailto:yves@dutncp8.tn.tudelft.nl[yves@dutncp8.tn.tudelft.nl]
+* Zach Garner mailto:zach@neurosoft.org[zach@neurosoft.org]
+* Zach Heilig mailto:zach@gaffaneys.com[zach@gaffaneys.com]
+* Zach Thompson mailto:hideo@lastamericanempire.com[hideo@lastamericanempire.com]
+* Zach Zurflu mailto:zach@pabst.bendnet.com[zach@pabst.bendnet.com]
+* Zachariah Thompson mailto:lin-chi@lastamericanempire.com[lin-chi@lastamericanempire.com]
+* Zak Johnson mailto:zakj@nox.cx[zakj@nox.cx]
+* Zane C. Bowers mailto:vvelox@vvelox.net[vvelox@vvelox.net]
+* Zhen REN mailto:bg1tpt@gmail.com[bg1tpt@gmail.com]
+* Zhihao Yuan mailto:lichray@gmail.com[lichray@gmail.com]
+* Zhixiang JIANG mailto:luckrill@yahoo.com.cn[luckrill@yahoo.com.cn]
+* Zhong Ming-Xun mailto:zmx@mail.CDPA.nsysu.edu.tw[zmx@mail.CDPA.nsysu.edu.tw]
+* Zsolt Udvari mailto:udvzsolt@gmail.com[udvzsolt@gmail.com]
+* appleboy mailto:appleboy.tw@gmail.com[appleboy.tw@gmail.com]
+* arci mailto:vega@sophia.inria.fr[vega@sophia.inria.fr]
+* ayunyan mailto:ayunyan@gmail.com[ayunyan@gmail.com]
+* der Mouse mailto:mouse@Collatz.McRCIM.McGill.EDU[mouse@Collatz.McRCIM.McGill.EDU]
+* geoffroy desvernay mailto:dgeo@centrale-marseille.fr[dgeo@centrale-marseille.fr]
+* gspu mailto:gspurki@gmail.com[gspurki@gmail.com]
+* lightside mailto:lightside@gmx.com[lightside@gmx.com]
+* Piotr Szerman mailto:pmsz@tlen.pl[pmsz@tlen.pl]
+* rossiya mailto:rossiya@gmail.com[rossiya@gmail.com]
diff --git a/documentation/content/es/articles/contributors/contrib-committers.adoc b/documentation/content/es/articles/contributors/contrib-committers.adoc
new file mode 100644
index 0000000000..5b1dc6105d
--- /dev/null
+++ b/documentation/content/es/articles/contributors/contrib-committers.adoc
@@ -0,0 +1,399 @@
+
+* {eadler}
+* {ambrisko}
+* {shaun}
+* {jonathan}
+* {mandree}
+* {will}
+* {dim}
+* {fernape}
+* {mat}
+* {gavin}
+* {jwb}
+* {badger}
+* {dbaio}
+* {timur}
+* {jhb}
+* {gjb}
+* {lbartoletti}
+* {jbeich}
+* {kib}
+* {kibab}
+* {gbe}
+* {bdragon}
+* {tcberner}
+* {kaktus}
+* {tdb}
+* {wblock}
+* {zbb}
+* {novel}
+* {garga}
+* {kbowling}
+* {sbz}
+* {ebrandi}
+* {harti}
+* {makc}
+* {dab}
+* {antoine}
+* {db}
+* {sbruno}
+* {brueffer}
+* {br}
+* {oleg}
+* {jchandra}
+* {acm}
+* {carlavilla}
+* {gahr}
+* {adrian}
+* {dchagin}
+* {jch}
+* {nc}
+* {loader}
+* {melifaro}
+* {theraven}
+* {davidcs}
+* {marcus}
+* {lcook}
+* {ngie}
+* {tijl}
+* {rakuco}
+* {dch}
+* {alc}
+* {olivier}
+* {cracauer}
+* {jeb}
+* {bcran}
+* {joel}
+* {alfredo}
+* {bapt}
+* {ceri}
+* {brd}
+* {brooks}
+* {pjd}
+* {jwd}
+* {jmd}
+* {vd}
+* {danfe}
+* {donner}
+* {bdrewery}
+* {gad}
+* {ale}
+* {deischen}
+* {julian}
+* {ae}
+* {diizzy}
+* {lme}
+* {se}
+* {jasone}
+* {kevans}
+* {madpilot}
+* {kami}
+* {scf}
+* {farrokhi}
+* {mfechner}
+* {afedorov}
+* {feld}
+* {landonf}
+* {fanf}
+* {mdf}
+* {blackend}
+* {decke}
+* {sgalabov}
+* {ultima}
+* {gallatin}
+* {avg}
+* {beat}
+* {danger}
+* {sjg}
+* {gibbs}
+* {pfg}
+* {girgen}
+* {grembo}
+* {trociny}
+* {danilo}
+* {dmgk}
+* {sg}
+* {grehan}
+* {rgrimes}
+* {jamie}
+* {adridg}
+* {eugen}
+* {wg}
+* {bar}
+* {rigoletto}
+* {anish}
+* {jmg}
+* {mjg}
+* {jhale}
+* {jah}
+* {smh}
+* {ehaupt}
+* {bhd}
+* {jgh}
+* {wen}
+* {jhibbits}
+* {nhibma}
+* {jhixson}
+* {pho}
+* {oh}
+* {mhorne}
+* {cognet}
+* {sunpoet}
+* {lwhsu}
+* {whu}
+* {jkh}
+* {bhughes}
+* {shurd}
+* {rhurlin}
+* {davide}
+* {meta}
+* {pi}
+* {sevan}
+* {debdrup}
+* {peterj}
+* {markj}
+* {thj}
+* {mjoras}
+* {erj}
+* {allanjude}
+* {kan}
+* {bjk}
+* {phk}
+* {pluknet}
+* {karels}
+* {pkelsey}
+* {pkubaj}
+* {keramida}
+* {arved}
+* {fjoe}
+* {kientzle}
+* {stevek}
+* {jkim}
+* {jceel}
+* {kai}
+* {wulf}
+* {koobs}
+* {jkois}
+* {maxim}
+* {tobik}
+* {ak}
+* {skozlov}
+* {skra}
+* {skreuzer}
+* {gabor}
+* {rajeshasp}
+* {kuriyama}
+* {rene}
+* {mich}
+* {dvl}
+* {erwin}
+* {martymac}
+* {dru}
+* {jlh}
+* {oliver}
+* {grog}
+* {netchild}
+* {leitao}
+* {ian}
+* {achim}
+* {truckman}
+* {glewis}
+* {vishwin}
+* {qingli}
+* {delphij}
+* {avatar}
+* {rlibby}
+* {linimon}
+* {issyl0}
+* {scottl}
+* {jtl}
+* {imp}
+* {johalun}
+* {luporl}
+* {otis}
+* {eri}
+* {wma}
+* {rmacklem}
+* {vmaffione}
+* {bmah}
+* {rm}
+* {jmallett}
+* {dwmalone}
+* {nobutaka}
+* {amdmi3}
+* {kwm}
+* {emaste}
+* {mm}
+* {slavash}
+* {slm}
+* {mckusick}
+* {jmcneill}
+* {mmel}
+* {jmmv}
+* {kadesai}
+* {ken}
+* {cem}
+* {dinoex}
+* {jrm}
+* {freqlabs}
+* {cmt}
+* {stephen}
+* {marcel}
+* {dougm}
+* {marck}
+* {mav}
+* {jsm}
+* {tmunro}
+* {markm}
+* {trasz}
+* {neel}
+* {bland}
+* {joneum}
+* {gnn}
+* {khng}
+* {tychon}
+* {obrien}
+* {nick}
+* {ohauer}
+* {olgeni}
+* {osa}
+* {rodrigo}
+* {philip}
+* {hiren}
+* {yuripv}
+* {fluffy}
+* {np}
+* {royger}
+* {rpaulo}
+* {misha}
+* {dumbbell}
+* {mp}
+* {cperciva}
+* {alfred}
+* {csjp}
+* {gerald}
+* {scottph}
+* {0mp}
+* {pizzamig}
+* {rpokala}
+* {arrowd}
+* {kp}
+* {thomas}
+* {dfr}
+* {bofh}
+* {fox}
+* {attilio}
+* {crees}
+* {mr}
+* {bcr}
+* {trhodes}
+* {benno}
+* {arichardson}
+* {luigi}
+* {jeff}
+* {roberto}
+* {rodrigc}
+* {ler}
+* {leres}
+* {robak}
+* {ray}
+* {arybchik}
+* {bsam}
+* {samm}
+* {hrs}
+* {rscheff}
+* {wosch}
+* {cy}
+* {schweikh}
+* {matthew}
+* {tmseck}
+* {stas}
+* {hselasky}
+* {lev}
+* {phil}
+* {gshapiro}
+* {syrinx}
+* {vanilla}
+* {ashish}
+* {silby}
+* {chs}
+* {bms}
+* {demon}
+* {flo}
+* {glebius}
+* {kensmith}
+* {des}
+* {sobomax}
+* {asomers}
+* {tsoome}
+* {loos}
+* {brnrd}
+* {uqs}
+* {vsevolod}
+* {pstef}
+* {zi}
+* {lstewart}
+* {rrs}
+* {rstone}
+* {xride}
+* {marius}
+* {cs}
+* {ryusuke}
+* {nyan}
+* {tagattie}
+* {tota}
+* {romain}
+* {eduardo}
+* {dteske}
+* {mi}
+* {gordon}
+* {lx}
+* {fabient}
+* {thierry}
+* {thompsa}
+* {jilles}
+* {andreast}
+* {ganbold}
+* {tuexen}
+* {chuck}
+* {ericbsd}
+* {andrew}
+* {gonzo}
+* {ume}
+* {fsu}
+* {mikael}
+* {ivadasz}
+* {manu}
+* {vangyzen}
+* {ram}
+* {bryanv}
+* {yuri}
+* {nivit}
+* {avos}
+* {kaiw}
+* {takawata}
+* {rwatson}
+* {adamw}
+* {naddy}
+* {peter}
+* {nwhitehorn}
+* {bwidawsk}
+* {swills}
+* {rew}
+* {def}
+* {mw}
+* {wollman}
+* {woodsb02}
+* {joerg}
+* {ygy}
+* {emax}
+* {yongari}
+* {rcyu}
+* {oshogbo}
+* {riggs}
+* {egypcio}
+* {zec}
+* {bz}
+* {zeising}
+* {mizhka}
+* {tz}
diff --git a/documentation/content/es/articles/contributors/contrib-corealumni.adoc b/documentation/content/es/articles/contributors/contrib-corealumni.adoc
new file mode 100644
index 0000000000..6210ade1cc
--- /dev/null
+++ b/documentation/content/es/articles/contributors/contrib-corealumni.adoc
@@ -0,0 +1,56 @@
+
+* {kmoore} (2016 - 2020)
+* {jhb} (2002 - 2006, 2010 - 2014, 2016 - 2020)
+* {jeff} (2018 - 2020)
+* {brooks} (2006 - 2012, 2018 - 2020)
+* {bcr} (2016 - 2020)
+* {allanjude} (2016 - 2020)
+* {bapt} (2016 - 2018)
+* {emaste} (2016 - 2018)
+* {gnn} (2006 - 2010, 2016 - 2018)
+* {benno} (2016 - 2018)
+* {tabthorpe} (2012 - 2014)
+* {kib} (2010 - 2014)
+* {miwi} (2012 - 2014)
+* {attilio} (2012)
+* {wilko} (2006 - 2012)
+* {imp} (2000 - 2008, 2010 - 2012)
+* {pav} (2010 - 2012)
+* {cperciva} (2010 - 2012)
+* {rwatson} (2000 - 2012)
+* {keramida} (2006 - 2010)
+* {kris} (2008 - 2010)
+* {murray} (2002 - 2010)
+* {peter} (1995 - 2006, 2008 - 2010)
+* {wes} (2002 - 2008)
+* {markm} (2002 - 2006)
+* {kuriyama} (2002 - 2006)
+* {scottl} (2004 - 2005)
+* {grog} (2000 - 2004)
+* {dg} (1992 - 2002)
+* {dfr} (1999 - 2002)
+* {msmith} (2000 - 2002)
+* {jkh} (1992 - 2002)
+* {asami} (1993 - 2001)
+* {ache} (1993 - 2000)
+* {jmb} (1993 - 2000)
+* {bde} (1992 - 2000)
+* {gibbs} (1993 - 2000)
+* {rich} (1994 - 2000)
+* {phk} (1992 - 2000)
+* {gpalmer} (1993 - 2000)
+* {sos} (1993 - 2000)
+* {wollman} (1993 - 2000)
+* {joerg} (1995 - 2000)
+* {jdp} (1997 - 2000)
+* {guido} (1995 - 1999)
+* {dyson} (1993 - 1998)
+* {nate} (1992 - 1996)
+* {rgrimes} (1992 - 1995)
+* {ats} (1992 - 1995)
+* {csgr} (1993 - 1995)
+* {paul} (1992 - 1995)
+* {smace} (1993 - 1994)
+* {alm} (1993 - 1994)
+* {chmr} (1993 - 1994)
+* {jtc} (1992 - 1993)
diff --git a/documentation/content/es/articles/contributors/contrib-develalumni.adoc b/documentation/content/es/articles/contributors/contrib-develalumni.adoc
new file mode 100644
index 0000000000..8b190ce76f
--- /dev/null
+++ b/documentation/content/es/articles/contributors/contrib-develalumni.adoc
@@ -0,0 +1,499 @@
+
+* {culot} (2010 - 2021)
+* {jlaffaye} (2011 - 2021)
+* {kmoore} (2009 - 2021)
+* {lifanov} (2016 - 2021)
+* {miwi} (2006 - 2021)
+* {jpaetzel} (2008 - 2021)
+* {araujo} (2007 - 2021)
+* {ed} (2008 - 2020)
+* {mmokhi} (2017 - 2020)
+* {knu} (2000 - 2020)
+* {cpm} (2015 - 2020)
+* {jadawin} (2008 - 2020)
+* {mahrens} (2016 - 2020)
+* {gblach} (2012 - 2020)
+* {salvadore} (2020)
+* {seanc} (2002 - 2020)
+* {zleslie} (2017 - 2020)
+* {dbn} (2013 - 2020)
+* {wollman} (1993 - 2020)
+* {johans} (2006 - 2019)
+* {remko} (2004 - 2019)
+* {az} (2005 - 2019)
+* {bde} (1994 - 2019)
+* {murray} (2000 - 2019)
+* {taras} ( - 2019)
+* {simon} (2003 - 2019)
+* {manolis} ( - 2019)
+* {pgj} (2009 - 2019)
+* {dexter} (2018 - 2019)
+* {tobez} (2001 - 2019)
+* {badger} (2016 - 2019)
+* {zbb} (2013 - 2019)
+* {jwd} (2000 - 2019)
+* {deischen} (1999 - 2019)
+* {fanf} (2002 - 2019)
+* {gibbs} (1994 - 2019)
+* {eri} (2008 - 2019)
+* {jmmv} (2013 - 2019)
+* {lidl} (2015 - 2019)
+* {neel} (2009 - 2019)
+* {alfred} (1999 - 2019)
+* {thomas} (2002 - 2019)
+* {rezny} (2017 - 2019)
+* {luigi} (1998 - 2019)
+* {rodrigc} (2005 - 2019)
+* {stas} (2006 - 2019)
+* {thompsa} (2005 - 2019)
+* {ivadasz} (2016 - 2019)
+* {kaiw} (2014 - 2019)
+* {yongari} (2004 - 2019)
+* {benno} (2000 - 2018)
+* {def} (2016 - 2018)
+* {jeb} (2018 - 2018)
+* {jimharris} (2011 - 2018)
+* {tj} (2012 - 2018)
+* {dryice} (2006 - 2018)
+* {lth} (2004 - 2018)
+* {avilla} (2010 - 2018)
+* {nemysis}(2013 - 2018)
+* {rea} (2010 - 2018)
+* {bryanv} (2012 - 2018)
+* {daichi} (2002 - 2018)
+* {wxs} (2008 - 2018)
+* {maho} (2002 - 2018)
+* {pawel} (2011 - 2018)
+* {tabthorpe} (2007 - 2018)
+* {vg} (2013 - 2018)
+* {silby} (2001 - 2018)
+* {skra} (2015 - 2018)
+* {jonathan} (2010 - 2017)
+* {kevlo} (1999 - 2017)
+* {junovitch} (2015 - 2017)
+* {olivierd} (2012 - 2017)
+* {marino} (2013 - 2017)
+* {akiyama} (2000 - 2017)
+* {andre} (2003 - 2017)
+* {charnier} (1997 - 2017)
+* {cherry} (2012 - 2017)
+* {das} (2003 - 2017)
+* {davidch} (2006 - 2017)
+* {edavis} (2013 - 2017)
+* {iwasaki} (1999 - 2017)
+* {monthadar} (2012 - 2017)
+* {ps} (2000 - 2017)
+* {rnoland} (2008 - 2017)
+* {ru} (1999 - 2017)
+* {sanpei} (2000 - 2017)
+* {sephe} (2007 - 2017)
+* {stefanf} (2004 - 2017)
+* {syuu} (2012 - 2017)
+* {benl} (2011 - 2017)
+* {jhay} (1996 - 2017)
+* {raj} (2007 - 2017)
+* {theraven} (2011 - 2017)
+* {ups} (2004 - 2017)
+* {wkoszek} (2006 - 2017)
+* {mckay} (1996 - 2017)
+* {bschmidt} (2010 - 2017)
+* {dmarion} (2012 - 2017)
+* {ghelmer} (1998 - 2017)
+* {jfv} (2006 - 2017)
+* {jh} (2009 - 2017)
+* {jmcneill} (2016 - 2017)
+* {rmh} (2011 - 2017)
+* {slm} (2014 - 2017)
+* {versus} (2008 - 2017)
+* {brian} (1996 - 2017)
+* {gber} (2011 - 2017)
+* {gleb} (2011 - 2017)
+* {ivoras} (2008 - 2017)
+* {rdivacky} (2008 - 2017)
+* {vanhu} (2008 - 2017)
+* {zont} (2012 - 2017)
+* {mva} (2009 - 2017)
+* {alonso} (2014 - 2016)
+* {edwin} (2002 - 2016)
+* {erwin} (2003 - 2016)
+* {leeym} (2002 - 2016)
+* {mmoll} (2015 - 2016)
+* {sem} (2004 - 2016)
+* {bf} (2010 - 2015)
+* {pgollucci} (2008 - 2015)
+* {itetcu} (2006 - 2015)
+* {achim} (2013 - 2015)
+* {ade} (2000 - 2015)
+* {alexey} (2013 - 2015)
+* {brix} (2007 - 2015)
+* {clsung} (2004 - 2015)
+* {dhn} (2009 - 2015)
+* {jase} (2012 - 2015)
+* {kargl} (2011 - 2015)
+* {rafan} (2006 - 2015)
+* {sahil} (2010 - 2015)
+* {stefan} (2006 - 2015)
+* {xmj} (2014 - 2015)
+* {anders} (2001 - 2014)
+* {beech} (2007 - 2014)
+* {davidxu} (2002 - 2014)
+* {glarkin} (2008 - 2014)
+* {hq} (2004 - 2014)
+* {lioux} (2000 - 2014)
+* {lippe} ( - 2014)
+* {max} ( - 2014)
+* {milki} (2013 - 2014)
+* {sperber} (2012 - 2014)
+* {sumikawa} (2003 - 2014)
+* {tmseck} (2013 - 2014)
+* {ru} (1999 - 2014)
+* {carl} (2013 - 2014)
+* {ahze} (2004 - 2013)
+* {avl} (2009 - 2013)
+* {chinsan} (2007 - 2013)
+* {clement} (2003 - 2013)
+* {jsa} (2010 - 2013)
+* {jmelo} (2006 - 2013)
+* {lbr} (2006 - 2013)
+* {matusita} (2001 - 2013)
+* {mezz} (2004 - 2013)
+* {mjacob} (1997 - 2013)
+* {motoyuki} (1998 - 2013)
+* {pav} (2003 - 2013)
+* {pclin} (2013)
+* {qingli} (2005 - 2013)
+* {roam} (2000 - 2013)
+* {scheidell} (2011 - 2013)
+* {skv} (2001 - 2013)
+* {sylvio} (2009 - 2013)
+* {yzlin} (2009 - 2013)
+* {flz} (2005 - 2013)
+* {scf} (2007 - 2012)
+* {gj} (2003 - 2012)
+* {kmacy} (2005 - 2012)
+* {zml} (2009 - 2012)
+* {jkoshy} (1998 - 2012)
+* {brucec} (2010 - 2012)
+* {bgray} (2012)
+* {randi} (2010 - 2012)
+* {zack} (2010 - 2012)
+* {erik} (2008 - 2012)
+* {carvay} (2008 - 2012)
+* {lulf} (2007 - 2012)
+* {mnag} (2005 - 2012)
+* Doug Barton (2000 - 2012)
+* {wilko} (2000 - 2012)
+* {murray} (2000 - 2012)
+* {steve} (1996 - 2012)
+* {weongyo} (2007 - 2011)
+* {ticso} (2002 - 2011)
+* {rse} (1997 - 2011)
+* {mlaier} (2004 - 2011)
+* {art} (2011)
+* {jacula} (2010 - 2011)
+* {nemoliu} (2007 - 2011)
+* {alexbl} (2006 - 2011)
+* {alepulver} (2006 - 2011)
+* {tmclaugh} (2005 - 2011)
+* {anray} (2005 - 2011)
+* {niels} (2004 - 2011)
+* {sergei} (2003 - 2011)
+* {mux} (2002 - 2011)
+* {hm} (1998 - 2011)
+* {ijliao} (2001 - 2011)
+* {scrappy} (1996 - 2011)
+* {wes} (1998 - 2010)
+* {simokawa} (1999 - 2010)
+* {sepotvin} (2007 - 2010)
+* {sam} (2002 - 2010)
+* {nork} (2002 - 2010)
+* {mbr} (2001 - 2010)
+* {dd} (2001 - 2010)
+* {anchie} (2010)
+* {olli} (2008 - 2010)
+* {kato} (1996 - 2010)
+* {bruno} (2005 - 2010)
+* {snb} (2009 - 2010)
+* {cbzimmer} (2009 - 2010)
+* {bushman} (2007 - 2010)
+* {benjsc} (2007 - 2010)
+* {rink} (2006 - 2010)
+* {piso} (2006 - 2010)
+* {laszlof} (2006 - 2010)
+* {bvs} (2005 - 2010)
+* {barner} (2005 - 2010)
+* {vs} (2004 - 2010)
+* {dds} (2003 - 2010)
+* {perky} (2002 - 2010)
+* {yoichi} (2001 - 2010)
+* {okazaki} (2000 - 2010)
+* {cjh} (2000 - 2010)
+* {jesusr} (1998 - 2010)
+* {ssouhlal} (2004 - 2009)
+* {sson} (2008 - 2009)
+* {markus} (2006 - 2009)
+* {green} (1999 - 2009)
+* {darrenr} (1997 - 2009)
+* {ariff} (2005 - 2009)
+* {sos} (1993 - 2009)
+* {mtm} (2003 - 2009)
+* {matteo} (2006 - 2009)
+* {jon} (2000 - 2009)
+* {guido} (1993 - 2009)
+* {dwhite} (1998 - 2009)
+* {cokane} (2000 - 2009)
+* {sat} (2006 - 2009)
+* {jcamou} (2005 - 2009)
+* {rushani} (2003 - 2009)
+* {nik} (1998 - 2009)
+* {lofi} (2003 - 2009)
+* {den} (2003 - 2009)
+* {obraun} (2002 - 2009)
+* {anholt} (2002 - 2009)
+* {mwlucas} (2001 - 2009)
+* {chern} (2001 - 2009)
+* {mita} (2000 - 2009)
+* {horikawa} (2000 - 2009)
+* {clive} (2000 - 2009)
+* {gioria} (1999 - 2009)
+* {rik} (2003 - 2008)
+* {pb} (2003 - 2008)
+* {mpp} (1995 - 2008)
+* {luoqi} (1998 - 2008)
+* {iedowse} (2000 - 2008)
+* {tg} (1995 - 2009)
+* {kris} (1999 - 2008)
+* {sephe} (2007 - 2008)
+* {davidc} (2001 - 2008)
+* {kishore} (2007 - 2008)
+* {twinterg} (2006 - 2008)
+* {koitsu} (2006 - 2008)
+* {bakul} (2006 - 2008)
+* {jylefort} (2005 - 2008)
+* {garys} (2005 - 2008)
+* {damien} (2005 - 2008)
+* {aaron} (2005 - 2008)
+* {tackerman} (2004 - 2008)
+* {metal} (2004 - 2008)
+* {marks} (2004 - 2008)
+* {lesi} (2004 - 2008)
+* {josef} (2004 - 2008)
+* {dhartmei} (2004 - 2008)
+* {sah} (2004 - 2008)
+* {rsm} (2003 - 2008)
+* {hoek} (2003 - 2008)
+* {eik} (2003 - 2008)
+* {matk} (2003 - 2008)
+* {njl} (2002 - 2008)
+* {ikob} (2002 - 2008)
+* {pdeuskar} (2001 - 2008)
+* {mikeh} (2001 - 2008)
+* {shiba} (2000 - 2008)
+* {pat} (2000 - 2008)
+* {onoe} (2000 - 2008)
+* {lkoeller} (2000 - 2008)
+* {jayanth} (2000 - 2008)
+* {jake} (2000 - 2008)
+* {dmlb} (2000 - 2008)
+* {bmilekic} (2000 - 2008)
+* {babkin} (2000 - 2008)
+* {joe} (1999 - 2008)
+* {imura} (1999 - 2008)
+* {andy} (1999 - 2008)
+* {shige} (1999 - 2008)
+* {hosokawa} (1998 - 2008)
+* {foxfair} (1998 - 2008)
+* {billf} (1998 - 2008)
+* {tegge} (1997 - 2008)
+* {jlemon} (1997 - 2008)
+* {fenner} (1996 - 2008)
+* {andreas} (1996 - 2008)
+* {jdp} ( - 2008)
+* {hsu} ( - 2008)
+* {wpaul} (1995 - 2007)
+* {suz} (2002 - 2007)
+* {le} (2004 - 2007)
+* {jls} (2006 - 2007)
+* {jinmei} (2007)
+* {hmp} (2004 - 2007)
+* {phantom} (1999 - 2007)
+* {mohans} (2006 - 2007)
+* {cel} (2006 - 2007)
+* {lawrance} (2005 - 2007)
+* {rees} (2004 - 2007)
+* {tjr} (2002 - 2007)
+* {johan} (2002 - 2007)
+* {markp} (2001 - 2007)
+* {jesper} (2001 - 2007)
+* {eric} (2001 - 2007)
+* {trevor} (2000 - 2007)
+* {non} (2000 - 2007)
+* {kbyanc} (2000 - 2007)
+* {jeh} (2000 - 2007)
+* {gsutter} (2000 - 2007)
+* {bsd} (2000 - 2007)
+* {tom} (1999 - 2007)
+* {mharo} (1999 - 2007)
+* {chris} (1999 - 2007)
+* {bp} (1999 - 2007)
+* {archie} (1998 - 2007)
+* {yar} ( - 2007)
+* {tanimura} (1999 - 2006)
+* {peadar} (2004 - 2006)
+* {wsalamon} (2005 - 2006)
+* {mdodd} (1999 - 2006)
+* {vkashyap} (2004 - 2006)
+* {niklas} (2004 - 2006)
+* {smkelly} (2003 - 2006)
+* {arun} (2003 - 2006)
+* {am} (2003 - 2006)
+* {scop} (2002 - 2006)
+* {mheinen} (2002 - 2006)
+* {jennifer} (2002 - 2006)
+* {znerd} (2001 - 2006)
+* {keichii} (2001 - 2006)
+* {ue} (2001 - 2006)
+* {tmm} (2001 - 2006)
+* {robert} (2001 - 2006)
+* {petef} (2001 - 2006)
+* {mike} (2001 - 2006)
+* {greid} (2001 - 2006)
+* {cjc} (2001 - 2006)
+* {bbraun} (2001 - 2006)
+* {sf} (2000 - 2006)
+* {kiri} (2000 - 2006)
+* {dannyboy} (2000 - 2006)
+* {ben} (2000 - 2006)
+* {sheldonh} (1999 - 2006)
+* {roger} (1999 - 2006)
+* {nsayer} (1999 - 2006)
+* {nbm} (1999 - 2006)
+* {jedgar} (1999 - 2006)
+* {nsouch} (1998 - 2006)
+* {nectar} (1998 - 2006)
+* {mph} (1998 - 2006)
+* {kjc} (1997 - 2006)
+* {hanai} (1997 - 2006)
+* {eivind} (1997 - 2005)
+* {viny} (2004 - 2005)
+* {stephane} (2002 - 2005)
+* {arr} (2001 - 2005)
+* {sada} (1998 - 2005)
+* {flathill} (1998 - 2005)
+* {paul} (1993 - 2005)
+* {mini} (2002 - 2004)
+* {emoore} (2002 - 2004)
+* {wjv} (2001 - 2004)
+* {rpratt} (2001 - 2004)
+* {orion} (2001 - 2004)
+* {logo} (2001 - 2004)
+* {tomsoft} (2000 - 2004)
+* {patrick} (2000 - 2004)
+* {chm} (2000 - 2004)
+* {taoka} (1999 - 2004)
+* {jmas} (1999 - 2004)
+* {dcs} (1999 - 2004)
+* {dan} (1999 - 2004)
+* {smace} (1993 - 2004)
+* {alex} ( - 2004)
+* {dg} (1993 - 2003)
+* {dwcjr} (2002 - 2003)
+* {zarzycki} (2001 - 2003)
+* {tshiozak} (2001 - 2003)
+* {pirzyk} (2001 - 2003)
+* {wsanchez} (2000 - 2003)
+* {toshi} (2000 - 2003)
+* {mb} (2000 - 2003)
+* {marko} (2000 - 2003)
+* {furuta} (2000 - 2003)
+* {bean} (2000 - 2003)
+* {shin} (1999 - 2003)
+* {pho} (1999 - 2003)
+* {newton} (1999 - 2003)
+* {mtaylor} (1999 - 2003)
+* {lile} (1999 - 2003)
+* {jim} (1999 - 2003)
+* {ejc} (1999 - 2003)
+* {dick} (1999 - 2003)
+* {dbaker} (1999 - 2003)
+* {cpiazza} (1999 - 2003)
+* {cp} (1999 - 2003)
+* {thepish} (1998 - 2003)
+* {semenu} (1998 - 2003)
+* {rvb} (1998 - 2003)
+* {rnordier} (1998 - 2003)
+* {dt} (1998 - 2003)
+* {dirk} (1998 - 2003)
+* {dillon} (1998 - 2003)
+* {stark} (1997 - 2003)
+* {pds} (1997 - 2003)
+* {jseger} (1997 - 2003)
+* {helbig} (1997 - 2003)
+* {fsmp} (1997 - 2003)
+* {cwt} (1997 - 2003)
+* {brandon} (1997 - 2003)
+* {smpatel} (1996 - 2003)
+* {msmith} (1996 - 2003)
+* {mbarkah} (1996 - 2003)
+* {jfitz} (1996 - 2003)
+* {davidn} (1996 - 2003)
+* {lars} (1995 - 2003)
+* {jfieber} (1995 - 2003)
+* {dufault} (1995 - 2003)
+* {amurai} (1995 - 2003)
+* {ugen} (1994 - 2003)
+* {swallace} (1994 - 2003)
+* {stb} (1994 - 2003)
+* {rich} (1994 - 2003)
+* {pst} (1994 - 2003)
+* {mks} (1994 - 2003)
+* {ljo} (1994 - 2003)
+* {csgr} (1994 - 2003)
+* {adam} (1994 - 2003)
+* {nate} (1993 - 2003)
+* {gpalmer} (1993 - 2003)
+* {amorita} (2001 - 2002)
+* {uch} (2000 - 2002)
+* {shafeeq} (2000 - 2002)
+* {reg} (2000 - 2002)
+* {keith} (2000 - 2002)
+* {issei} (2000 - 2002)
+* {cshumway} (2000 - 2002)
+* {assar} (2000 - 2002)
+* {nakai} (1999 - 2002)
+* {asmodai} (1999 - 2002)
+* {dburr} (1998 - 2002)
+* {abial} (1998 - 2002)
+* {jmb} (1997 - 2002)
+* {danny} (1997 - 2002)
+* {graichen} (1996 - 2002)
+* {torstenb} (1995 - 2002)
+* {jmacd} (1995 - 2002)
+* {erich} (1995 - 2002)
+* {martin} (1994 - 2002)
+* {unfurl} (2000 - 2001)
+* {rv} (2000 - 2001)
+* {dec} (2000 - 2001)
+* {groudier} (1999 - 2001)
+* {yokota} (1997 - 2001)
+* {dima} (1995 - 2001)
+* {sef} (1993 - 2001)
+* {asami} (1993 - 2001)
+* {gehenna} (1999 - 2000)
+* {tedm} (1997 - 2000)
+* {nsj} (1996 - 2000)
+* {jraynard} (1996 - 2000)
+* {chuckr} (1996 - 2000)
+* {karl} (1995 - 2000)
+* {gclarkii} (1993 - 2000)
+* {jgreco} (1997 - 1999)
+* {jamil} (1997 - 1999)
+* {ats} (1992 - 1999)
+* {meganm} (1997 - 1998)
+* {ahd} (1997 - 1998)
+* {ahasty} (1997 - 1998)
+* {dyson} (1993 - 1998)
+* {olah} (1995 - 1996)
+* {jhs} (1995 - 1995)
+* gjp (1995 - 1995)
+* {alm} (1993 - 1995)
diff --git a/documentation/content/es/articles/contributors/contrib-portmgralumni.adoc b/documentation/content/es/articles/contributors/contrib-portmgralumni.adoc
new file mode 100644
index 0000000000..aeb02070b2
--- /dev/null
+++ b/documentation/content/es/articles/contributors/contrib-portmgralumni.adoc
@@ -0,0 +1,23 @@
+
+* {feld} (2016 - 2019)
+* {miwi} (2009 - 2016)
+* {erwin} (2004 - 2016)
+* {decke} (2012 - 2015)
+* {tabthorpe} (2011 - 2014)
+* {itetcu} (2009 - 2014)
+* {marcus} (2004 - 2014)
+* {beat} (2011 - 2013)
+* {linimon} (2004 - 2013)
+* {pav} (2006 - 2012)
+* {flz} (2008 - 2012)
+* {kris} (2001 - 2010)
+* {krion} (2004 - 2009)
+* {clement} (2005 - 2007)
+* {eik} (2004 - 2005)
+* {will} (2001 - 2004)
+* {knu} (2001 - 2004)
+* {lioux} (2001 - 2004)
+* {sobomax} (2001 - 2004)
+* {steve} (2001 - 2004)
+* {ade} (2001 - 2002)
+* {asami} ( - 2001)
diff --git a/documentation/content/es/articles/cups/_index.adoc b/documentation/content/es/articles/cups/_index.adoc
index 2858f08fb1..1cb57202aa 100644
--- a/documentation/content/es/articles/cups/_index.adoc
+++ b/documentation/content/es/articles/cups/_index.adoc
@@ -18,6 +18,27 @@ trademarks: ["freebsd", "general"]
:source-highlighter: rouge
:experimental:
:sectnumlevels: 6
+:images-path: articles/cups/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumen
diff --git a/documentation/content/es/articles/explaining-bsd/_index.adoc b/documentation/content/es/articles/explaining-bsd/_index.adoc
index 00df426343..64562789c9 100644
--- a/documentation/content/es/articles/explaining-bsd/_index.adoc
+++ b/documentation/content/es/articles/explaining-bsd/_index.adoc
@@ -1,12 +1,9 @@
---
+title: Explicando BSD
authors:
- -
- author: 'Greg Lehey'
+ - author: Greg Lehey
email: grog@FreeBSD.org
-description: 'Breve explicación acerca de BSD'
-tags: ["Explaining BSD", "BSD", "FreeBSD", "operating system"]
-title: 'Explicando BSD'
-trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sun", "unix", "general"]
+trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sparc", "sun", "unix", "general"]
---
= Explicando BSD
@@ -15,18 +12,39 @@ trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sun", "u
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:sectnumlevels: 6
+:images-path: articles/explaining-bsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumen
-En el mundo open source, la palabra "Linux" es casi un sinónimo de "Sistema Operativo", pero no es el único sistema operativo UNIX(R) open source.
+En el mundo del código abierto, la palabra "Linux" es casi un sinónimo de "Sistema Operativo", pero no es el único sistema operativo de código abierto UNIX(R).
-Entonces, ¿cuál es el secreto? ¿Por qué BSD no es más conocido? Este documento técnico aborda estas y otras preguntas.
+¿Así que cuál es el secreto? ¿Por qué BSD no es más conocido? Este artículo trata sobre esa y otras cuestiones.
-A lo largo de este documento, las diferencias entre BSD y Linux serán señaladas __así__.
+A lo largo de este documento, las diferencias entre BSD y Linux se __mostrarán en cursiva__.
'''
@@ -35,107 +53,107 @@ toc::[]
[[what-is-bsd]]
== ¿Qué es BSD?
-BSD significa "Berkeley Software Distribution". Es el nombre de las distribuciones de código fuente de la Universidad de California, Berkeley, que fueron originalmente extensiones al sistema operativo UNIX(R) de investigación de AT&T. Varios proyectos de sistemas operativos open source se basan en una versión de este código fuente conocida como 4.4BSD-Lite. Además, constan de cierto número de paquetes de otros proyectos Open Source, incluyendo especialmente el proyecto GNU. El sistema operativo en general se compone de:
+BSD significa "Berkeley Software Distribution". Es el nombre de las distribuciones de código fuente de la Universidad de California, Berkeley, que originalmente eran extensiones del sistema operativo UNIX(R) de AT&T Research. Varios proyectos de sistemas operativos de código abierto tienen su origen en una distribución de éste código conocida como 4.4BSD-Lite. Además, comprenden una serie de paquetes de otros proyectos de código abierto, incluido especialmente el proyecto GNU. El sistema operativo completo incluye:
* El kernel BSD, que se encarga de la programación de procesos, la gestión de la memoria, el multiprocesamiento simétrico (SMP), los controladores de dispositivos, etc.
* La biblioteca C, la API base del sistema.
-+
-__La librería C de BSD está basada en código de Berkeley, no del proyecto GNU.__
++
+__La biblioteca C de BSD está basada en código procedente de Berkeley, no del proyecto GNU.__
* Utilidades como shells, utilidades de archivos, compiladores y enlazadores.
-+
-__Algunas utilidades se derivan del proyecto GNU, otras no.__
-* El sistema X Ventanas, que maneja la visualización gráfica.
-+
-El sistema X Window usado por la mayoría de las versiones de BSD es mantenido por el http://www.X.org/[Proyecto X.Org]. FreeBSD permite al usuario escoger de entre una variedad de entornos de escritorio, tales como Gnome, KDE o Xfce; y gestores de ventanas ligeros como Openbox, Fluxbox o Awesome.
++
+__Algunas de las utilidades derivan del proyecto GNU, otras no.__
+* El sistema X Window, que gestiona el entorno gráfico.
++
+El sistema X Window utilizado en la mayoría de las versiones de BSD es mantenido por el http://www.X.org/[proyecto X.Org]. FreeBSD permite al usuario elegir entre una variedad de entornos de escritorio, como GNOME, KDE o Xfce; y administradores de ventanas ligeros como Openbox, Fluxbox o Awesome.
* Muchos otros programas y utilidades.
[[what-a-real-unix]]
-== Cómo, ¿Un UNIX(R) de verdad?
+== ¿Qué, un verdadero UNIX(R)?
-Los sistemas operativos BSD no son clones, sino derivados open source del sistema operativo UNIX(R) de investigación de AT&T que es también el ancestro del moderno UNIX(R) System V. Esto podría sorprenderte. ¿Cómo pudo ocurrir esto si AT&T nunca ha liberado su código como open source?
+Los sistemas operativos BSD no son clones, sino derivados de código abierto del sistema operativo AT&T's Research UNIX(R), el cual es a su vez ancestro del moderno UNIX(R) System V. Esto puede sorprenderle. ¿Cómo puede haber sucedido si AT&T jamás liberó su código?
-Es cierto que UNIX(R) de AT&T no es open source y en el sentido del copyright, BSD definitivamente _no_ es UNIX(R), pero por otro lado, AT&T ha importado las fuentes de otros proyectos, principalmente del Computer Sciences Research Group (CSRG) de la Universidad de California en Berkeley, CA. A comienzos de 1976, el CSRG empezó a liberar cintas con su software, llamándolas _Berkeley Software Distribution_ o __BSD__.
+Cierto es que AT&T UNIX(R) no es código abierto y que en sentido estricto del copyright BSD no es _en absoluto_ UNIX(R), pero por otra parte AT&T incluyó código fuente de otros proyectos, teniendo como caso notable el Computer Sciences Research Group (CSRG) de la Universidad de California en Berkeley, CA. A partir de 1976, el CSRG comenzó a lanzar cintas de su software, llamándolas _Berkeley Software Distribution_ o _BSD_.
Las versiones iniciales de BSD consistían principalmente en programas de usuario, pero cambió drásticamente cuando el CSRG consiguió un contrato con el Defense Advanced Research Projects Agency (DARPA) para actualizar los protocolos de comunicaciones en su red, ARPANET. Los nuevos protocolos fueron conocidos como __Internet Protocols__, más adelante _TCP/IP_ y más tarde se covertirían en los protocolos más importantes. La primera implementación ampliamente distribuida fue parte de 4.2BSD, en 1982.
-A lo largo de los años 1980, surgieron unas cuantas empresas de estaciones de trabajo. Muchas prefirieron licenciar UNIX(R) en lugar de desarrollar sistemas operativos ellos mismos. En particular, Sun Microsystems licenció UNIX(R) e implementó una versión de 4.2BSD que llamaron SunOS(TM). Cuando a AT&T se le permitió vender UNIX(R) comercialmente, empezaron con una implementación algo básica llamada System III, que sería seguida rápidamente por System V. El código base de System V no incluyó código de red, así que todas las implementaciones incluyeron software adicional de BSD, incluyendo el software de TCP/IP, pero también utilidades como el _csh_ shell y el editor _vi_. De forma colectiva, estas mejoras fueron conocidas como __Berkeley Extensions__.
+Durante la década de los 80 comienzan a surgir compañías que ofrecían estaciones de trabajo. Muchas preferían obtener licencias de UNIX(R) en lugar de desarrollar sistemas operativos por sí mismas. En particular, Sun Microsystems adquirió una licencia de UNIX(R) e implementó una versión de 4.2BSD, que denominaron SunOS(TM). Cuando la propia AT&T fue autorizada para vender UNIX(R) comercialmente, iniciaron una implementación un tanto rudimentaria llamada System III, seguida rápidamente por System V. El código base de System V no incluía el soporte de red, por lo que todas las implementaciones incluían software adicional de BSD, incluido el software TCP/IP, pero también utilidades como el shell _csh_ y el editor __vi__. En conjunto, estas mejoras se conocían como las __Berkeley Extensions__.
-Las cintas de BSD contenían código fuente de AT&T y por lo tanto requerían una licencia de fuentes de UNIX(R). En 1990, la financiación del CSRG se terminó y se enfrentó a su cierre. Algunos miembros del grupo decidieron liberar el código BSD, que era Open Source, sin el código propietario de AT&T. Esto sucedió finalmente con el __Networking Tape 2__, habitualmente conocido como __Net/2__. Net/2 no era un sistema operativo completo: faltaba alrededor del 20% del código del núcleo. Uno de los miembros del CSRG, William F. Jolitz, escribió el código que faltaba y lo liberó a comienzos de 1992 como __386BSD__. Al mismo tiempo, otro grupo de antiguos miembros del CSRG formó una compañía comercial llamada http://www.bsdi.com/[Berkeley Software Design Inc.] y liberó una versión beta de un sistema operativo llamado http://www.bsdi.com/[BSD/386] que estaba basada en las mismas fuentes. El nombre del sistema operativo se cambió posteriormente a BSD/OS.
+Las cintas BSD contenían código fuente de AT&T y en consecuencia requerían una licencia de código UNIX(R). Hacia 1990, la financiación del CSRG se estaba agotando y se enfrentaba al cierre. Algunos miembros del grupo decidieron liberar el código BSD, que era Código Abierto, sin el código propiedad de AT&T. Finalmente esto sucede con la __Networking Tape 2__, más conocida como __Net/2__. Net/2 no era un sistema operativo completo: faltaba aproximadamente un 20% del código del kernel. Uno de los miembros del CSRG, William F. Jolitz, escribió el código restante y lo distribuyó a principios de 1992 como __386BSD__. Al mismo tiempo, otro grupo de antiguos miembros del CSRG fundaron una empresa llamada http://www.bsdi.com/[Berkeley Software Design Inc.] y distribuyó una versión beta de un sistema operativo llamado http://www.bsdi.com/[BSD/386], que se basó en las mismas fuentes. El sistema operativo pasó a denominarse BSD/OS.
-386BSD nunca se convirtió en un sistema operativo estable. En su lugar, dos proyectos se separaron de él en 1993: http://www.NetBSD.org/[NetBSD] y link:https://www.FreeBSD.org/[FreeBSD]. Los dos proyectos divergieron originalmente debido a diferencias en el nivel de paciencia esperando las mejoras de 386BSD: la gente de NetBSD empezó a comienzos de año y la primera versión de FreeBSD no estuvo lista hasta final de año. Mientras tanto, el código base había divergido lo suficiente como para hacer difícil su unión. Además los proyectos tenían distintos objetivos, como veremos abajo. En 1996, http://www.OpenBSD.org/[OpenBSD] se escindió de NetBSD, y en 2003, http://www.dragonflybsd.org/[DragonFlyBSD] se escindió de FreeBSD.
+386BSD jamás llegó a ser un sistema operativo estable. En cambio, otros dos proyectos se separaron de él en 1993: http://www.NetBSD.org/[NetBSD] y link:https://www.FreeBSD.org[FreeBSD]. Ambos proyectos se forman gracias a la falta de paciencia que origina la espera de mejoras en 386BSD: La gente de NetBSD comenzó a principios de año, y la primera versión de FreeBSD no estuvo lista hasta final de año. En ese proceso el código base tomó caminos diferentes hasta tal punto que se hizo difícil de fusionar. Además, los proyectos tenían diferentes objetivos, como veremos más adelante. En 1996, http://www.OpenBSD.org/[OpenBSD] se separó de NetBSD, y en 2003, http://www.dragonflybsd.org/[DragonFlyBSD] se separó de FreeBSD.
[[why-is-bsd-not-better-known]]
== ¿Por qué BSD no es más conocido?
Por varias razones, BSD es relativamente desconocido:
-. Los desarrolladores de BSD suelen estar más interesados en pulir su código que en comercializarlo.
-. Gran parte de la popularidad de Linux se debe a factores externos a los proyectos de Linux, como la prensa, y a las empresas formadas para proporcionar servicios de Linux. Hasta hace poco, los BSD de código abierto no tenían tales defensores.
-. En 1992, AT&T demandó a http://www.bsdi.com/[BSDI], el fabricante de BSD/386, alegando que el código contenía código con derechos de AT&T. El caso se resolvió en los tribunales en 1994, pero el espectro del litigio continúa persiguiendo a la gente. En marzo de 2000 un artículo publicado en la web declaraba que el caso judicial se había "resuelto recientemente".
-+
-Un detalle que clarificó el proceso judicial fue el nombre: en la década de 1980, BSD era conocido como "BSD UNIX(R)". Con la eliminación de los últimos vestigios de código de AT&T de BSD, también perdió el derecho al nombre UNIX(R). Por lo tanto verás referencias en títulos de libros a "el sistema operativo 4.3BSD UNIX(R)" y "el sistema operativo 4.4.BSD".
+. Los desarrolladores de BSD a menudo están más interesados en mejorar su código que en comercializarlo.
+. Gran parte de la popularidad de Linux se debe a factores externos a los proyectos de Linux, como la prensa y las empresas formadas para proporcionar servicios de Linux. Hasta hace poco, los BSD de código abierto no tenían tales partidarios.
+. En 1992 AT&T denunció a http://www.bsdi.com/[BSDI], el distribuidor de BSD/386, alegando que el producto contenía código propiedad de AT&T. El caso se resolvió fuera de los tribunales en 1994, pero el espectro del litigio sigue atormentando a las personas. En marzo de 2000, un artículo publicado en la web afirmaba que el caso judicial había sido "resuelto recientemente".
++
+Un detalle que el proceso judicial aclaró fue el de la nomenclatura: en la década de los 80, BSD era conocido como "BSD UNIX(R)". Con la eliminación del último vestigio del código AT&T de BSD, también perdió el derecho a llamarse UNIX(R). Por lo tanto, es posible encontrar títulos de libros referentes a "the 4.3BSD UNIX(R) operating system" y "the 4.4BSD operating system".
[[comparing-bsd-and-linux]]
== Comparando BSD y Linux
-Entonces ¿cuál es la diferencia entre, digamos, Debian Linux y FreeBSD? Para el usuario medio, la diferencia es sorprendentemente pequeña: Ambos son sistemas operativos tipo UNIX(R). Ambos son desarrollados por proyectos no comerciales (esto no se aplica a muchas otras distribuciones Linux, por supuesto). En la siguiente sección, miraremos a BSD y lo compararemos con Linux. La descripción es más cercana a FreeBSD, que cuenta con un total estimado del 80% de las instalaciones de BSD, pero las diferencias con NetBSD, OpenBSD y DragonFlyBSD son pequeñas.
+Entonces, ¿cuál es realmente la diferencia entre, digamos, Debian Linux y FreeBSD? Para el usuario promedio, la diferencia es sorprendentemente pequeña: Ambos son sistemas operativos tipo UNIX(R). Ambos están desarrollados por proyectos no comerciales (esto no se aplica a muchas otras distribuciones de Linux, por supuesto). En la siguiente sección, veremos BSD y lo compararemos con Linux. La descripción se ajusta más a FreeBSD, que representa aproximadamente el 80% de las instalaciones de BSD, pero las diferencias entre NetBSD, OpenBSD y DragonFlyBSD son pequeñas.
=== ¿Quién es dueño de BSD?
-Ninguna persona o corporación es propietaria de BSD. Es creado y distribuido por una comunidad de colaboradores altamente técnicos y comprometidos en todo el mundo. Algunos de los componentes de BSD son proyectos de código abierto por derecho propio y gestionados por diferentes encargados de mantenimiento de proyectos.
+Ninguna persona o empresa es dueña de BSD. Es creado y distribuido por una comunidad de colaboradores altamente cualificados y comprometidos a lo largo y ancho del mundo. Algunos de los componentes de BSD son proyectos de código abierto con sus propios derechos que se administran y mantienen por separado.
=== ¿Cómo se desarrolla y actualiza BSD?
Los kernel de BSD se desarrollan y actualizan siguiendo el modelo de desarrollo de código abierto. Cada proyecto mantiene un _árbol de código fuente_ de acceso público que contiene todos los archivos del proyecto, incluida la documentación y otros ficheros relacionados. Los usuarios pueden obtener una copia completa de cualquier versión.
-Una gran cantidad de desarrolladores en todo el mundo contribuyen a las mejoras de BSD. Se dividen en tres tipos:
+Un gran número de desarrolladores de todo el mundo contribuyen a mejorar BSD. Se dividen en tres tipos:
-* _Contributors (colaboradores)_ escriben código o documentación. No tienen permitido hacer commit (añadir código) directamente al árbol de fuentes. Para que su código sea incluido en el sistema, tiene que ser revisado y comprobado por un desarrollador registrado, conocimo como __committer__.
-* _Committers_ son desarrolladores con permiso de escritura al árbol de fuentes. Para convertirse en un committer, una persona debe mostrar habilidad en el área en el que está activa.
-+
+* Los _Contributors_ escriben código o documentación. No se les permite hacer commit (añadir código) directamente al árbol de fuentes. Para que su código sea incluido en el sistema debe ser revisado y probado por un desarrollador registrado, conocido como __committer__.
+* Los _Committers_ son desarrolladores que disponen de acceso de escritura en el árbol de fuentes. Para convertirse en committer es necesario demostrar habilidad en el área en la cual él o ella trabaja.
++
Depende del criterio individual de cada committer cuándo pedir autorización antes de hacer cambios en el árbol de fuentes. En general, un committer experimentado puede realizar cambios que obviamente son correctos sin obtener consenso. Por ejemplo, un committer que trabaje en un proyecto de documentación puede corregir errores tipográficos o gramaticales sin necesidad de revisión. Por otra parte, se espera que los desarrolladores que pretendan realizar cambios de gran calado o complicados envíen sus cambios para que sean revisados antes de ser incluidos. En casos extremos un miembro del core team con una función como la del Principal Architect puede ordenar que los cambios sean retirados del árbol, es lo que llamamos _backing out_. Todos los committers reciben un correo electrónico que describe cada commit, por lo que no es posible hacer un commit en secreto.
* El _Core team_. Tanto FreeBSD como NetBSD disponen de un core team que administra el proyecto. Los core teams dirigen el rumbo de los proyectos pero sus funciones no siempre están claras. No es necesario ser desarrollador para ser un miembro del core team pero suele ser lo habitual. Las normas del core team varían de un proyecto a otro, pero en general tienen más voz en la dirección del proyecto que los miembros del equipo que no son del Core.
-Esta disposición se diferencia de Linux en varias formas:
+Esta gestión difiere de la de Linux en algunos aspectos:
-. Nadie controla el contenido del sistema. En la práctica, esta diferencia está sobrevalorada, ya que el arquitecto principal puede requerir que el código se restituya, e incluso en el proyecto de Linux se permite a varias personas realizar cambios.
-. Por otro lado, _hay_ un repositorio central, un único lugar donde puedes encontrar las fuentes del sistema operativo completo, incluyendo todas las versiones antiguas.
+. Ninguna persona controla el contenido del sistema. En la práctica eso es muy relativo, ya que el Principal Architect puede requerir que el código sea retirado, e incluso en el proyecto Linux a ciertas personas les está permitido hacer cambios.
+. Por otro lado, _hay_ un repositorio central, un único lugar donde se pueden encontrar las fuentes de todo el sistema operativo, incluidas todas las versiones anteriores.
. Los proyectos BSD mantienen todo el "Sistema Operativo", no solo el kernel. Esta distinción tiene una utilidad marginal: ni BSD ni Linux son útiles sin aplicaciones. Las aplicaciones utilizadas en BSD son con frecuencia las mismas que las utilizadas en Linux.
-. Como resultado del mantenimiento formalizado de un único árbol de fuentes SVN, el desarrollo de BSD es claro y es posible acceder a cualquier versión del sistema por número de versión o por fecha. SVN también permite actualizaciones incrementales del sistema: por ejemplo, el repositorio de FreeBSD se actualiza unas 100 veces al día. La mayoría de estos cambios son pequeños.
+. Como resultado del mantenimiento estructurado de un único árbol de fuentes SVN, el desarrollo de BSD es limpio y es posible acceder a cualquier versión del sistema por su número de versión o por la fecha. SVN también permite actualizaciones incrementales del sistema: por ejemplo, el repositorio de FreeBSD se actualiza aproximadamente 100 veces al día. La mayoría de estos cambios son pequeños.
=== Versiones de BSD
-FreeBSD, NetBSD y OpenBSD proporcionan el sistema en tres "versiones" diferentes. Al igual que Linux, a los lanzamientos se les asigna un número como 1.4.1 ó 3.5. Además, el número de versión tiene un sufijo que indica su propósito:
+FreeBSD, NetBSD y OpenBSD proporcionan el sistema en tres "versiones" diferentes. Al igual que Linux, a los lanzamientos se les asigna un número como 1.4.1 ó 3.5. Además, el número de versión tiene un sufijo que indica su propósito
-. La versión del sistema que está en desarrollo se llama _CURRENT_. FreeBSD asigna números a CURRENT, por ejemplo FreeBSD 5.0-CURRENT. NetBSD utiliza un esquena de nombrado ligeramente diferente y añade un sufijo de una única letra que indica cambios en los interfaces internos, por ejemplo NetBSD 1.4.3G. OpenBSD no asigna un número ("OpenBSD-current"). Todo el desarrollo nuevo del sistema se realiza en esta rama.
-. A intervalos regulares, entre dos y cuatro veces al año, el proyecto saca una versión _RELEASE_ del sistema, que está disponible en CD-ROM y libre para descargar desde los sitios FTP, por ejemplo OpenBSD 2.6-RELEASE o NetBSD 1.4-RELEASE. La versión RELEASE está pensada para usuarios finales y es la versión normal del sistema. NetBSD también proporciona _patch releases_ con un tercer dígito, por ejemplo NetBSD 1.4.2.
+. La versión de desarrollo del sistema recibe el nombre de _CURRENT_. FreeBSD asigna un número a CURRENT, por ejemplo FreeBSD 5.0-CURRENT. NetBSD utiliza un sistema ligeramente diferente y añade un sufijo compuesto por una única letra que indica cambios en las interfaces internas, por ejemplo NetBSD 1.4.3G. OpenBSD no asigna ningún número ("OpenBSD-current"). Todo nuevo desarrollo en el sistema entra en esta rama.
+. A intervalos regulares, entre dos y cuatro veces al año, los proyectos liberan una versión _RELEASE_ del sistema, que está disponible en CD-ROM y mediante FTP para su descarga gratuita, por ejemplo OpenBSD 2.6-RELEASE o NetBSD 1.4-RELEASE. La versión RELEASE está dirigida al usuario final y es la versión estándar del sistema. NetBSD también dispone de _patch releases_ que incluyen un tercer dígito, como por ejemplo NetBSD 1.4.2.
. A medida que se van encontrando errores en la versión RELEASE, se corrigen y las correcciones se agregan al árbol del SVN. En FreeBSD la versión resultante se denomina versión _STABLE_, mientras que en NetBSD y OpenBSD continúa siendo la versión RELEASE. También se pueden agregar nuevas funcionalidades más pequeñas a esta rama después de un período de prueba en la rama CURRENT. La seguridad y otras correcciones importantes de errores también se aplican en todas las versiones soportadas de RELEASE.
_Linux, en cambio, mantiene dos árboles de código separados: la versión estable y la versión de desarrollo. Las versiones estables añaden un número par de versión, como 2.0, 2.2 ó 2.4. Las versiones de desarrollo añaden un número impar, como en 2.1, 2.3 ó 2.5. En ambos casos a ese número se le añade otro más que indica la versión exacta. Además, cada proveedor agrega sus propios programas de usuario y utilidades, por lo que el nombre de la distribución también es importante. Cada distribuidor además asigna números de versión a la distribución, así pues la descripción completa podría ser algo como "TurboLinux 6.0 with kernel 2.2.14"_
=== ¿Qué versiones de BSD están disponibles?
-A diferencia de las numerosas distribuciones de Linux, solo hay cuatro BSD principales de código abierto. Cada proyecto BSD mantiene su propio árbol de fuentes y su propio kernel. En la práctica, sin embargo, parece haber menos divergencias entre el código de usuario de los proyectos que en Linux.
+A diferencia de las numerosas distribuciones de Linux, solo hay cuatro BSDs principales de código abierto. Cada proyecto BSD mantiene su propio árbol de fuentes y su propio kernel. En la práctica, sin embargo, parece haber menos diferencias entre el código de usuario de los proyectos que en Linux.
Es difícil categorizar los objetivos de cada proyecto: las diferencias son muy subjetivas. Básicamente,
-* FreeBSD aspira a proporcionar alto rendimiento y facilidad de uso para los usuarios finales y es uno de los favoritos para los proveedores de contenido web. Se puede ejecutar en link:https://www.FreeBSD.org/platforms/[diferentes plataformas] y tiene un número significativo mayor de usuarios que otros proyectos.
-* NetBSD aspira a ofrecer máxima portabilidad: "por supuesto ejecuta NetBSD". Se puede ejecutar en máquinas desde palmtops a grandes servidores y ha sido utilizado en misiones espaciales de la NASA. Es una opción particularmente buena para ejecutar en hardware antiguo que no sea Intel(R).
-* OpenBSD tiene como objetivo la seguridad y la pureza del código: utiliza una combinación del concepto de código abierto y revisiones rigurosas del código para crear un sistema que sea demostrablemente correcto, lo que lo convierte en la elección de organizaciones preocupadas por la seguridad, como bancos, bolsas de valores y departamentos del gobierno de EE. UU. Como NetBSD, se ejecuta en varias plataformas.
-* DragonFlyBSD tiene como objetivo un alto rendimiento y escalabilidad en todo, desde un sistema UP de un solo nodo hasta un sistema masivamente agrupado. DragonFlyBSD tiene varios objetivos técnicos de largo alcance, pero el enfoque radica en proporcionar una infraestructura compatible con SMP que sea fácil de entender, mantener y desarrollar.
+* FreeBSD tiene como meta ofrecer un alto rendimiento y facilidad de uso al usuario final, y es uno de los favoritos de los proveedores de contenido web. Se ejecuta en link:https://www.FreeBSD.org/platforms/[varias plataformas] y tiene significativamente más usuarios que los otros proyectos.
+* NetBSD tiene como meta la máxima portabilidad: "of course it runs NetBSD". Se ejecuta en máquinas que abarcan desde PDAs hasta grandes servidores, e incluso se ha utilizado en misiones espaciales de la NASA. Es una opción particularmente buena para ejecutar en hardware antiguo que no sea Intel(R).
+* OpenBSD tiene como meta la seguridad y la integridad del código: combina del concepto de código abierto y una revisión rigurosa del código que dan como fruto un sistema muy correcto, elegido por instituciones preocupadas por la seguridad como bancos, bolsas de valores y departamentos gubernamentales de los EEUU. Al igual que NetBSD funciona en gran variedad de plataformas.
+* DragonFlyBSD tiene como meta ofrecer un alto rendimiento y escalabilidad bajo cualquier entorno, desde computadoras de un solo usuario hasta enormes sistemas de clústeres. DragonFlyBSD tiene varios objetivos técnicos a largo plazo, pero el desarrollo se centra en ofrecer una infraestructura habilitada para SMP que sea fácil de entender, mantener y desarrollar.
-Hay también dos sistemas operativos BSD UNIX(R) adicionales que no son open source, BSD/OS y el Mac OS(R) X de Apple:
+También hay dos sistemas operativos BSD UNIX(R) adicionales que no son de código abierto, BSD/OS y Mac OS(R) X de Apple:
-* BSD/OS fue el más antiguo de los derivados 4.4BSD. No era de código abierto, aunque las licencias de código fuente estaban disponibles a un costo relativamente bajo. Se parecía a FreeBSD en muchos aspectos. Dos años después de la adquisición de BSDi por Wind River Systems, BSD / OS no logró sobrevivir como un producto independiente. El soporte y el código fuente aún pueden estar disponibles en Wind River, pero todo el desarrollo nuevo se centra en el sistema operativo integrado VxWorks.
-* http://www.apple.com/macosx/server/[Mac OS(R) X] es la última versión del sistema operativo para la línea Mac(R) de Apple(R). El núcleo BSD de este sistema operativo, http://developer.apple.com/darwin/[Darwin], está disponible como un sistema operativo open source completamente funcional para ordenadores x86 y PPC. El sistema gráfico Aqua/Quartz y otros muchos aspectos propietarios de Mac OS(R) X sin embargo permanecen cerrados. Varios desarrolladores de Darwin son también committers de FreeBSD y vice versa.
+* BSD/OS fue el derivado más antiguo de 4.4BSD. No era de código abierto, aunque las licencias de código fuente estaban disponibles a un precio relativamente bajo. Se parecía a FreeBSD en muchos aspectos. Dos años después de la adquisición de BSDi por Wind River Systems, BSD/OS no logró sobrevivir como un producto independiente. El soporte y el código fuente podrían estar todavía disponibles por parte de Wind River, pero todos los desarrollos nuevos se centran en el sistema operativo embebido VxWorks.
+* http://www.apple.com/macosx/server/[Mac OS(R) X] es la última versión del sistema operativo para la línea Mac(R) de Apple(R). El núcleo BSD de este sistema operativo, http://developer.apple.com/darwin/[Darwin], está disponible libremente como sistema operativo de código abierto totalmente funcional para arquitecturas x86 y PPC. Sin embargo, el sistema gráfico Aqua/Quartz y otros aspectos muy característicos de Mac OS(R) X siguen siendo de código cerrado. Varios desarrolladores de Darwin son también committers de FreeBSD y viceversa.
=== ¿En qué se diferencia la licencia BSD de la licencia pública GNU?
-Linux está disponible bajo la http://www.fsf.org/copyleft/gpl.html[GNU General Public License] (GPL), que está diseñada para eliminar el software de código cerrado. En particular, cualquier trabajo derivado de un producto publicado bajo la GPL también debe suministrarse con el código fuente si se solicita. Por el contrario, la http://www.opensource.org/licenses/bsd-license.html[licencia BSD] es menos restrictiva: permite la distribución en forma exclusivamente binaria. Esto es particularmente atractivo para aplicaciones integradas.
+Linux está disponible bajo la http://www.fsf.org/copyleft/gpl.html[GNU General Public License ](GPL), que está diseñada para eliminar el software de código cerrado. En particular, cualquier trabajo derivado de un producto publicado bajo la GPL también debe suministrarse con el código fuente si se solicita. Por el contrario, la http://www.opensource.org/licenses/bsd-license.html[licencia BSD] es menos restrictiva: permite la distribución en forma exclusivamente binaria. Esto es particularmente atractivo para aplicaciones encastradas.
=== ¿Qué más debo saber?
-Dado que hay menos aplicaciones disponibles para BSD que Linux, los desarrolladores de BSD crearon un paquete de compatibilidad con Linux, que permite que los programas de Linux se ejecuten bajo BSD. El paquete incluye modificaciones del kernel para realizar correctamente las llamadas al sistema Linux y archivos de compatibilidad de Linux, como la biblioteca C. No hay una diferencia notable en la velocidad de ejecución entre una aplicación Linux que se ejecuta en una máquina Linux y una aplicación Linux que se ejecuta en una máquina BSD de la misma velocidad.
+Como hay menos aplicaciones disponibles para BSD que para Linux, los desarrolladores de BSD crearon un paquete de compatibilidad con Linux, que permite que los programas de Linux se ejecuten bajo BSD. El paquete incluye modificaciones del kernel para realizar correctamente las llamadas al sistema Linux y archivos de compatibilidad con Linux, como la biblioteca de C. No hay una diferencia notable en la velocidad de ejecución entre una aplicación Linux que se ejecuta en una máquina Linux y una aplicación Linux que se ejecuta en una máquina BSD de la misma velocidad.
El modelo "todo del mismo proveedor" de BSD implica que las actualizaciones son mucho más sencillas de gestionar de lo que son con frecuencia en Linux. BSD maneja las actualizaciones de versiones de bibliotecas suministrando módulos de compatibilidad para versiones anteriores, de modo que es posible ejecutar binarios con varios años de antigüedad sin problemas.
@@ -146,14 +164,14 @@ El modelo "todo del mismo proveedor" de BSD implica que las actualizaciones son
Esta es una pregunta muy difícil de responder. Aquí hay algunas pautas:
* "Si no está roto no lo arregles": Si ya usa un sistema operativo de código abierto y está satisfecho con él, probablemente no haya ninguna buena razón para cambiar.
-* Los sistemas BSD, en particular FreeBSD, pueden tener un rendimiento notablemente superior al de Linux. Pero esto no es generalizado. En muchos casos, hay poca o ninguna diferencia en el rendimiento. En algunos casos, Linux puede funcionar mejor que FreeBSD.
-* En general, los sistemas BSD tienen una mejor reputación de confiabilidad, principalmente como resultado de una base de código más madura.
-* Los proyectos BSD gozan de una mejor reputación por la calidad e integridad de su documentación. Los diversos proyectos de documentación tienen como objetivo proporcionar documentación actualizada activamente, en muchos idiomas, y que cubra todos los aspectos del sistema.
-* La licencia BSD puede resultar más atractiva que la licencia GPL.
-* BSD puede ejecutar la mayoría de binarios de Linux, mientras que Linux no puede ejecutar binarios de BSD. Muchas implementaciones de BSD también pueden ejecutar binarios de otros sistemas tipo UNIX(R). Como resultado, BSD podría presentar una ruta de migración desde otros sistemas más sencilla de lo que sería capaz Linux.
+* Los sistemas BSD, especialmente FreeBSD, pueden proporcionar un rendimiento notablemente superior que Linux, pero esto no es una ley inmutable. En muchos casos no hay diferencia de rendimiento o esta es muy pequeña. En algunos casos Linux podría tener un rendimiento mejor que FreeBSD.
+* En general los sistemas BSD gozan de una mejor reputación en cuanto a confiabilidad, principalmente por la mayor madurez de su código base.
+* Los proyectos BSD tienen una mejor reputación por la calidad y la integridad de su documentación. Los diversos proyectos de documentación tienen como objetivo proporcionar documentación actualizada activamente, en muchos idiomas, y que cubra todos los aspectos del sistema.
+* La licencia BSD puede resultar más atractiva que la GPL.
+* BSD puede ejecutar la mayoría de los binarios de Linux, mientras que Linux no puede ejecutar los binarios de BSD. Muchas implementaciones de BSD también pueden ejecutar binarios desde otros sistemas similares a UNIX(R). Como resultado, BSD puede presentar una ruta de migración más fácil desde otros sistemas que Linux.
-=== ¿Quién brinda soporte, servicio y capacitación para BSD?
+=== ¿Quién proporciona soporte, servicio y formación orientada a BSD?
BSDi / http://www.freebsdmall.com[FreeBSD Mall, Inc.] ha estado proporcionando contratos de soporte para FreeBSD durante casi una década.
-Además, cada uno de los proyectos tiene una lista de consultores para contratar: link:https://www.FreeBSD.org/commercial/consult_bycat/[FreeBSD], http://www.netbsd.org/gallery/consultants.html[NetBSD], y http://www.openbsd.org/support.html[OpenBSD].
+Además, cada uno de los proyectos tiene una lista de consultores para contratar: link:https://www.FreeBSD.org/commercial/consult_bycat/[FreeBSD], http://www.netbsd.org/gallery/consultants.html[NetBSD] y http://www.openbsd.org/support.html[OpenBSD].
diff --git a/documentation/content/es/articles/filtering-bridges/_index.adoc b/documentation/content/es/articles/filtering-bridges/_index.adoc
index 9dbb309c53..86abd00d2e 100644
--- a/documentation/content/es/articles/filtering-bridges/_index.adoc
+++ b/documentation/content/es/articles/filtering-bridges/_index.adoc
@@ -1,34 +1,40 @@
---
+title: Filtering Bridges
authors:
- -
- author: 'Alex Dupre'
+ - author: Alex Dupre
email: ale@FreeBSD.org
-description: 'Configurando firewalls y filtrando en hosts FreeBSD que actúan como bridges en lugar de routers'
-tags: ["network", "filtering", "bridges", "FreeBSD"]
-title: 'Bridges de Filtrado'
trademarks: ["freebsd", "3com", "intel", "general"]
---
-= Bridges de Filtrado
+= Filtering Bridges
:doctype: article
:toc: macro
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:sectnumlevels: 6
-
-ifeval::["{backend}" == "html5"]
-include::shared/es/urls.adoc[]
+:images-path: articles/filtering-bridges/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/es/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/es/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -45,7 +51,7 @@ toc::[]
[[filtering-bridges-why]]
== ¿Por qué utilizar un bridge que haga filtrado?
-Sucede con bastante frecuencia que, gracias a la reducción del coste de las conexiones de banda ancha a Internet (xDSL) y a la reducción de las direcciones IPv4 disponibles, muchas empresas están conectadas a Internet las 24 horas del día y con pocas (a veces ni siquiera dos) direcciones IP. A menudo en estas situaciones es necesario tener un firewall (también conocido como cortafuegos) que filtre el tráfico entrante y saliente desde y hacia Internet, pero una solución de filtrado de paquetes puede que no sea posible, ya sea por problemas de subredes, porque el router sea de propiedad del proveedor de servicios de internet (ISP), o porque no admite tales funcionalidades. En escenarios como estos se recomienda el uso de un brigde que realice el filtrado.
+Sucede con bastante frecuencia que, gracias a la reducción del coste de las conexiones de banda ancha a Internet (xDSL) y a la reducción de las direcciones IPv4 disponibles, muchas empresas están conectadas a Internet las 24 horas del día y con pocas (a veces ni siquiera dos) direcciones IP. A menudo en estas situaciones es necesario tener un firewall (también conocido como cortafuegos) que filtre el tráfico entrante y saliente desde y hacia Internet, pero una solución de filtrado de paquetes puede que no sea posible posible, ya sea por problemas de subredes, porque el router sea de propiedad del proveedor de servicios de internet (ISP), o porque no admite tales funcionalidades. En escenarios como estos se recomienda el uso de un brigde que realice el filtrado.
Una buena solución sería configurar un firewall basado en un bridge. Lo instalaremos entre el router xDSL y su hub/switch Ethernet, evitando así problemas de numeración IP.
@@ -56,7 +62,7 @@ No es difícil añadir funcionalidades de brigde a un sistema FreeBSD. Desde la
[IMPORTANT]
====
-_No sigas_ ambas instrucciones: un procedimiento _es excluyente_ con el otro. Escoge la mejor opción de acuerdo a tus necesidades y habilidades.
+_No_ siga ambas instrucciones: un procedimiento _excluye_ el otro. Seleccione la mejor opción de acuerdo a sus necesidades y habilidades.
====
Antes de continuar asegúrese de tener al menos dos tarjetas Ethernet que admitan el modo promiscuo tanto para la recepción como para la transmisión, ya que deben poder enviar paquetes Ethernet con cualquier dirección, no solo la suya. Además, para tener una buena tasa de transferencia, las tarjetas deben ser tarjetas del bus PCI. Las mejores opciones siguen siendo Intel EtherExpress(TM) Pro, seguida de la 3Com(R) 3c9xx series. Para simplificar la configuración del firewall, puede ser útil tener dos tarjetas de diferentes fabricantes (con diferentes controladores) para distinguir claramente qué interfaz está conectada al router y cuál a la red interna.
@@ -64,7 +70,7 @@ Antes de continuar asegúrese de tener al menos dos tarjetas Ethernet que admita
[[filtering-bridges-kernel]]
=== Configuración del kernel
-Si sigues este método es porque has decidido utilizar el método de instalación más antiguo y también el que ha sido más probado. Para empezar, debes agregar las siguientes líneas a tu archivo de configuración del kernel:
+Si sigue este método es porque ha decidido utilizar el método de instalación más antiguo y también el que ha sido probado más. Para empezar, debe agregar las siguientes líneas a su archivo de configuración del kernel:
[.programlisting]
....
@@ -75,12 +81,12 @@ options IPFIREWALL_VERBOSE
La primera línea añade el soporte para el bridge, la segunda añade la compatibilidad con el firewall y la tercera se refiere a las funciones de logging del firewall.
-Ahora es necesario construir e instalar el nuevo kernel. Puedes encontrar información detallada en la sección link:{handbook}#kernelconfig-building[Building and Installing a Custom Kernel] del FreeBSD Handbook.
+Ahora es necesario compilar e instalar el nuevo kernel. Puede encontrar instrucciones detalladas en la sección extref:{handbook}kernelconfig/[compilar e instalar un kernel personalizado, kernelconfig-building] del manual de FreeBSD.
[[filtering-bridges-modules]]
=== Carga de módulos
-Si has elegido usar el nuevo método de instalación (más simple), lo único que debes hacer es añadir la siguiente línea a [.filename]#/boot/loader.conf#::
+Si ha elegido usar el nuevo método de instalación (más simple), lo único que debe hacer es añadir la siguiente línea a [.filename]#/boot/loader.conf#:
[.programlisting]
....
@@ -92,7 +98,7 @@ Así el módulo [.filename]#bridge.ko# se cargará junto con el kernel durante e
[[filtering-bridges-finalprep]]
== Preparación final
-Antes de reiniciar para cargar el nuevo kernel o los módulos requeridos (de acuerdo con el método de instalación elegido anteriormente) debes realizar algunos cambios en el archivo de configuración [.filename]#/etc/rc.conf#. La regla predeterminada del firewall es rechazar todos los paquetes IP. Inicialmente configuraremos un firewall en modo `open` para verificar que funciona sin ningún problema en relación con el filtrado de paquetes (en el caso de que vaya a ejecutar este procedimiento de forma remota dicha configuración evitará que permanezca aislado de la red). Coloca estas líneas en el archivo [.filename]#/etc/rc.conf#:
+Antes de reiniciar para cargar el nuevo kernel o los módulos requeridos (de acuerdo con el método de instalación elegido anteriormente) debe realizar algunos cambios en el archivo de configuración [.filename]#/etc/rc.conf#. La regla predeterminada del firewall es rechazar todos los paquetes IP. Inicialmente configuraremos un firewall en modo `open` para verificar que funciona sin ningún problema en relación con el filtrado de paquetes (en el caso de que vaya a ejecutar este procedimiento de forma remota dicha configuración evitará que permanezca aislado de la red). Coloque estas líneas en el archivo [.filename]#/etc/rc.conf#:
[.programlisting]
....
@@ -102,22 +108,22 @@ firewall_quiet="YES"
firewall_logging="YES"
....
-La primera línea activará el firewall (y cargará el módulo [.filename]#ipfw.ko# si no está compilado en el kernel), la segunda lo configurará en modo `open` (como se explica en el archivo <[.filename]#/etc/rc.firewall#), la tercera hará que no se muestren la carga de las reglas y la cuarta habilitará el soporte de logging.
+La primera línea activará el firewall (y cargará el módulo [.filename]#ipfw.ko# si no está compilado en el kernel), la segunda lo configurará en modo `open` (como se explica en el archivo [.filename]#/etc/rc.firewall#), la tercera hará que no se muestren la carga de las reglas y la cuarta habilitará el soporte de logging.
-En cuanto a la configuración de las interfaces de red la forma más utilizada es asignar solo una IP a una de las tarjetas de red; el bridge funcionará igualmente, aunque ambas interfaces tengan una o no tengan ninguna IP configurada. En el último caso (IP-less) la máquina bridge quedará aún más oculta, ya que es inaccesible desde la red. Para configurarla, debes iniciar sesión desde la consola o mediante una tercera interfaz de red separada del bridge. A veces durante el inicio del sistema algunos programas requieren acceso a la red, por ejemplo para la resolución del dominio. En este caso es necesario asignar una IP a la interfaz externa (la que está conectada a Internet, donde se encuentra el servidor DNS) ya que el bridge se activará al final del procedimiento de arranque. Esto significa que la interfaz [.filename]#fxp0# (en nuestro caso) debe añadirse en la sección ifconfig del archivo [.filename]#/etc/rc.conf#, mientras que [.filename]#fxp0# no. Asignar una IP a ambas tarjetas de red no tiene mucho sentido, a menos que durante el procedimiento de inicio las aplicaciones tengan que acceder a servicios en ambos segmentos Ethernet.
+En cuanto a la configuración de las interfaces de red la forma más utilizada es asignar solo una IP a una de las tarjetas de red; el bridge funcionará igualmente, aunque ambas interfaces tengan una o no tengan ninguna IP configurada. En el último caso (IP-less) la máquina bridge quedará aún más oculta, ya que es inaccesible desde la red. Para configurarla, debe iniciar sesión desde la consola o mediante una tercera interfaz de red separada del bridge. A veces durante el inicio del sistema algunos programas requieren acceso a la red, por ejemplo para la resolución del dominio. En este caso es necesario asignar una IP a la interfaz externa (la que está conectada a Internet, donde se encuentra el servidor `DNS`) ya que el bridge se activará al final del procedimiento de arranque. Esto significa que la interfaz [.filename]#fxp0# (en nuestro caso) debe añadirse en la sección ifconfig del archivo [.filename]#/etc/rc.conf#, mientras que [.filename]#xl0# no. Asignar una IP a ambas tarjetas de red no tiene mucho sentido, a menos que durante el procedimiento de inicio las aplicaciones tengan que acceder a servicios en ambos segmentos Ethernet.
-Hay otra cosa importante que hay que saber. Cuando se ejecuta IP over Ethernet, en realidad hay dos protocolos Ethernet en uso: uno es IP, el otro es ARP. ARP realiza la conversión de la dirección IP de un host a su dirección de Ethernet (capa MAC). Para permitir la comunicación entre dos hosts separados por el bridge, es necesario que el bridge reenvíe los paquetes ARP. Dicho protocolo no está incluido en la capa IP, ya que solo existe con IP over Ethernet. El firewall de FreeBSD filtra exclusivamente en la capa IP y, por lo tanto, todos los paquetes no IP (ARP incluido) se reenvían sin ser filtrados, aunque el firewall esté configurado para no permitir nada.
+Hay otra cosa importante que hay que saber. Cuando se ejecuta IP over Ethernet, en realidad hay dos protocolos Ethernet en uso: uno es IP, el otro es `ARP`. `ARP` realiza la conversión de la dirección IP de un host a su dirección de Ethernet (capa MAC). Para permitir la comunicación entre dos hosts separados por el bridge, es necesario que el bridge reenvíe los paquetes `ARP`. Dicho protocolo no está incluido en la capa IP, ya que solo existe con IP over Ethernet. El firewall de FreeBSD filtra exclusivamente en la capa IP y, por lo tanto, todos los paquetes no IP (`ARP` incluido) se reenvían sin ser filtrados, aunque el firewall esté configurado para no permitir nada.
Ahora es el momento de reiniciar el sistema y usarlo como antes: habrá algunos mensajes nuevos sobre el bridge y el firewall, pero el bridge no se activará y el firewall, en el modo `open`, no bloqueará ninguna operación.
-Si hay algún problema, debes solucionarlo ahora antes de continuar.
+Si hay algún problema, debe solucionarlo ahora antes de continuar.
[[filtering-bridges-enabling]]
== Habilitando el bridge
-En este momento para habilitar el bridge debes ejecutar los siguientes comandos (no olvide reemplazar los nombres de las dos interfaces de red <[.filename]#fxp0# y [.filename]#xl0# por las suyas):
+En este momento para habilitar el bridge debe ejecutar los siguientes comandos (no olvide reemplazar los nombres de las dos interfaces de red [.filename]#fxp0# y [.filename]#xl0# por las suyas):
-[source, shell]
+[source,shell]
....
# sysctl net.link.ether.bridge.config=fxp0:0,xl0:0
# sysctl net.link.ether.bridge.ipfw=1
@@ -126,16 +132,16 @@ En este momento para habilitar el bridge debes ejecutar los siguientes comandos
La primera línea especifica qué interfaces deben ser activadas por el bridge, la segunda habilitará el firewall en el bridge y finalmente la tercera habilitará el bridge.
-En este punto deberías poder insertar la máquina entre dos conjuntos de hosts sin comprometer las habilidades de comunicación entre ellas. Si es así, el siguiente paso es añadir las partes `net.link.ether.bridge._[blah]_=_[blah]_` de estas filas al fichero [.filename]#/etc/sysctl.conf# para que se ejecuten en el arranque.
+En este momento debería poder insertar la máquina entre dos conjuntos de host sin comprometer ninguna capacidad de comunicación entre ellos. Si ha funcionado, el siguiente paso es añadir lo siguiente `net.link.ether.bridge._[blah]_=_[blah]_` al archivo [.filename]#/etc/sysctl.conf#, para que se ejecute al inicio.
[[filtering-bridges-ipfirewall]]
== Configurando el firewall
-Ahora es el momento de crear tu propio archivo de configuración con las reglas personalizadas del firewall para proteger la red interna. Te encontrarás con algunas complicaciones porque no todas las funcionalidades del firewall están disponibles en los paquetes bridge. Hay además una diferencia entre los paquetes que están en proceso de reenvío y los paquetes que estás recibiendo la máquina local. En general, los paquetes de entrada pasan por el firewall solo una vez, no dos veces, como suele ser el caso; en realidad se filtran solo después de la recepción, por lo que las reglas que usan `out` o `xmit` nunca coincidirán. Yo utilizo`in via`, que es una sintaxis más antigua pero tiene sentido cuando la lees. Otra limitación es que solo puedes usar solo los comandos `pass` o `reject` para los paquetes filtrados por un bridge. Opciones más complejas como `divert`, `forward` o `reject` no están disponibles. Estas opciones pueden seguir utilizándose, pero solo en el tráfico hacia o desde la propia máquina bridge (si tiene una dirección IP).
+Ahora es el momento de crear su propio archivo de configuración con las reglas personalizadas del firewall para proteger la red interna. Se encontrará con algunas complicaciones porque no todas las funcionalidades del firewall están disponibles en los paquetes bridge. Hay además una diferencia entre los paquetes que están en proceso de reenvío y los paquetes que está recibiendo la máquina local. En general, los paquetes de entrada pasan por el firewall solo una vez, no dos veces, como suele ser el caso; en realidad se filtran solo después de la recepción, por lo que las reglas que usan `out` o `xmit` nunca coincidirán. Yo utilizo `in via`, que es una sintaxis más antigua pero tiene sentido cuando la lees. Otra limitación es que usted solo puede usar solo los comandos `pass` o `reject` para los paquetes filtrados por un bridge. Opciones más complejas como `divert`, `forward` o `reject` no están disponibles. Estas opciones pueden seguir utilizándose, pero solo en el tráfico hacia o desde la propia máquina bridge (si tiene una dirección IP).
-El concepto de firewall con estado se incluyó por primera vez en FreeBSD 4.0. Es una gran mejora para el tráfico UDP, el cual generalmente es una solicitud de salida seguida poco después por una respuesta con exactamente el mismo conjunto de direcciones IP y números de puerto (pero obviamente con origen y destino invertidos). Con los firewalls que no mantienen el estado no hay forma de lidiar con este tipo de tráfico en una única sesión. Pero con un firewall que puede "recordar" un paquete saliente de UDP y, durante los próximos minutos, permitir una respuesta el manejo de servicios UDP es trivial. El siguiente ejemplo muestra cómo hacerlo. Es posible hacer lo mismo con los paquetes TCP. Esto le permite evitar algunos ataques de denegación de servicio y y otras maldades, pero también hace que su tabla de estado crezca rápidamente de tamaño.
+El concepto de firewall con estado se incluyó por primera vez en FreeBSD 4.0. Es una gran mejora para el tráfico `UDP`, el cual generalmente es una solicitud de salida seguida poco después por una respuesta con exactamente el mismo conjunto de direcciones IP y números de puerto (pero obviamente con origen y destino invertidos). Con los firewalls que no mantienen el estado no hay forma de lidiar con este tipo de tráfico en una única sesión. Pero con un firewall que puede "recordar" un paquete saliente de `UDP` y, durante los próximos minutos, permitir una respuesta el manejo de servicios `UDP` es trivial. El siguiente ejemplo muestra cómo hacerlo. Es posible hacer lo mismo con los paquetes `TCP`. Esto le permite evitar algunos ataques de denegación de servicio y y otras maldades, pero también hace que su tabla de estado crezca rápidamente de tamaño.
-Veamos una configuración de ejemplo. Lo primero, ten en cuenta que en la parte superior del archivo [.filename]#/etc/rc.firewall# ya existen reglas predeterminadas para la interfaz de loopback [.filename]#lo0#, por lo que no es necesario preocuparse de ellas. Las reglas personalizadas deben colocarse en un archivo separado (por ejemplo, [.filename]#/etc/rc.firewall.local#) y cargarse al inicio del sistema, modificando la línea en el archivo [.filename]#/etc/rc.conf# donde definimos el firewall en modo `open`:
+Veamos una configuración de ejemplo. Lo primero, tenga en cuenta que en la parte superior del archivo [.filename]#/etc/rc.firewall# ya existen reglas predeterminadas para la interfaz de loopback [.filename]#lo0#, por lo que no es necesario preocuparse de ellas. Las reglas personalizadas deben colocarse en un archivo separado (por ejemplo, [.filename]#/etc/rc.firewall.local#) y cargarse al inicio del sistema, modificando la línea en el archivo [.filename]#/etc/rc.conf# donde definimos el firewall en modo `open`:
[.programlisting]
....
@@ -144,82 +150,82 @@ firewall_type="/etc/rc.firewall.local"
[IMPORTANT]
====
-Tienes que especificar la ruta _completa_, de otro modo no será cargada con el riesgo de quedar aislado de la red.
+Debe especificar la ruta __completa__, de lo contrario, no se cargará, con el riesgo de permanecer aislado de la red.
====
-Para nuestro ejemplo imagina tener el interfaz [.filename]#fxp0# conectado hacia el exterior (Internet) y el [.filename]#xl0# hacia el interior (LAN). La máquina bridge tiene la IP `1.2.3.4` (no es posible que tu ISP te proporcione una dirección como esta, pero para nuestro ejemplo vale).
+Para nuestro ejemplo, imagine que tiene la interfaz [.filename]#fxp0# conectada hacia el exterior (Internet) y la [.filename]#xl0# hacia el interior (LAN). La máquina que haga de brigde tiene la IP `1.2.3.4` (su ISP no puede proporcionarle una dirección así, pero para nuestro ejemplo nos sirve).
[.programlisting]
....
-# Things that we have kept state on before get to go through in a hurry
+# Cosas para las que tenemos que mantener el estado
add check-state
-# Throw away RFC 1918 networks
+# Desechar todas las redes RFC 1918
add drop all from 10.0.0.0/8 to any in via fxp0
add drop all from 172.16.0.0/12 to any in via fxp0
add drop all from 192.168.0.0/16 to any in via fxp0
-# Allow the bridge machine to say anything it wants
-# (if the machine is IP-less do not include these rows)
+# Permitir que la máquina bridge diga lo que quiera
+# (si la máquina es IP-less no incluya estas líneas)
add pass tcp from 1.2.3.4 to any setup keep-state
add pass udp from 1.2.3.4 to any keep-state
add pass ip from 1.2.3.4 to any
-# Allow the inside hosts to say anything they want
+# Permitir que los hosts internos digan lo que quieran
add pass tcp from any to any in via xl0 setup keep-state
add pass udp from any to any in via xl0 keep-state
add pass ip from any to any in via xl0
-# TCP section
-# Allow SSH
+# Sección TCP
+# Permitir SSH
add pass tcp from any to any 22 in via fxp0 setup keep-state
-# Allow SMTP only towards the mail server
+# Permitir SMTP solo hacia el servidor de correo
add pass tcp from any to relay 25 in via fxp0 setup keep-state
-# Allow zone transfers only by the secondary name server [dns2.nic.it]
+# Permitir transferencias de zona solo por el servidor de nombres esclavo [dns2.nic.it]
add pass tcp from 193.205.245.8 to ns 53 in via fxp0 setup keep-state
-# Pass ident probes. It is better than waiting for them to timeout
+# Dejar pasar ident probes. Es mejor que esperar a que se agote el tiempo
add pass tcp from any to any 113 in via fxp0 setup keep-state
-# Pass the "quarantine" range
+# Dejar paso al rango "quarantine"
add pass tcp from any to any 49152-65535 in via fxp0 setup keep-state
-# UDP section
-# Allow DNS only towards the name server
+# Sección UDP
+# Permitir DNS solo hacia el servidor de nombres
add pass udp from any to ns 53 in via fxp0 keep-state
-# Pass the "quarantine" range
+# Dejar pasar el rango "quarantine"
add pass udp from any to any 49152-65535 in via fxp0 keep-state
-# ICMP section
-# Pass 'ping'
+# Sección ICMP
+# Dejar paso a 'ping'
add pass icmp from any to any icmptypes 8 keep-state
-# Pass error messages generated by 'traceroute'
+# Dejar paso a los mensajes de error generados por 'traceroute'
add pass icmp from any to any icmptypes 3
add pass icmp from any to any icmptypes 11
-# Everything else is suspect
+# Todo lo demás es sospechoso.
add drop log all from any to any
....
-Aquellos de vosotros que hayáis configurado firewalls antes habréis notado que faltan algunas cosas. En particular, no hay reglas anti-spoofing, de hecho _no_ añadimos:
+Aquellos de ustedes que hayan instalado firewalls antes notarán que faltan algunas cosas. En particular, no hay reglas contra la suplantación de identidad, de hecho, _no_ las añadimos:
[.programlisting]
....
add deny all from 1.2.3.4/8 to any in via fxp0
....
-Es decir, descarta paquetes que vienen de fuera pero que dicen que son de nuestra red. Esto es algo que harías de forma habitual para intentar que nadie evita el filtrado de paquetes generando paquetes malvados que parece que provienen del interior. El problema con eso es que hay _al menos_ un host en el interfaz exterior que no quieres ignorar: el router. Pero normalmente, el ISP hace anti-spoofing en su router, así que no nos tenemos que preocupar demasiado.
+Es decir, descartar los paquetes que vienen del exterior diciendo pertenecer a nuestra red. Esto es algo que normalmente haría para asegurarse de que alguien no trata de evadir el filtrado de paquetes, generando paquetes corruptos que parecen ser de dentro de la red. El problema es que hay _al menos_ un host en la interfaz externa que no desea ignorar: el router. Pero, por lo general, el ISP tiene reglas contra la suplantación de identidad en su router, por lo que no tenemos que preocuparnos excesivamente.
La última regla parece ser un duplicado exacto de la regla predeterminada, es decir, no dejar pasar nada que no esté específicamente permitido. Pero hay una diferencia: todo tráfico sospechoso será registrado.
-Hay dos reglas para pasar el tráfico SMTP y DNS hacia el servidor de correo y el servidor de nombres si los tienes. Obviamente el conjunto entero de reglas debería estar personalizado al estilo de cada uno, esto es sólo un ejemplo específico (el formato de las reglas está descrito con detalle en la página de manual de man:ipfw[8]). Como alternativa es posible especificar la dirección IP en lugar del nombre del host (requerido si la máquina no tiene IP).
+Hay dos reglas para permitir el tráfico SMTP y `DNS` hacia los servidores de correo y de nombres, si dispone de ellos. Obviamente todo el conjunto de reglas debe ser definido de acuerdo con sus preferencias personales; esto es solo un ejemplo específico (el formato de la regla se describe con precisión en la página del manual de man:ipfw[8]). Tenga en cuenta que para que el "relay" y el "ns" funcionen las búsquedas del servicio de nombres deben funcionar _antes de_ que el bridge esté activado. Este es un ejemplo de cómo asegurarse de configurar la IP en la tarjeta de red correcta. Otra forma de hacer las cosas sería especificar la dirección IP en lugar del nombre del host (requerido si la máquina no tiene IP).
-Quienes estén acostumbrados a configurar firewalls probablemente también suelan usar una regla `reset` o `forward` para los paquetes ident (`TCP` puerto 113). Por desgracia esta no es una opción válida con el bridge, por lo tanto la mejor opción es simplemente pasarlos a su destino. A menos que la máquina de destino esté ejecutando un demonio ident es realmente inofensivo. La alternativa es eliminar las conexiones en el puerto 113, lo que creará algunos problemas con servicios como IRC (el probe del ident dará timeout).
+Quienes estén acostumbrados a configurar firewalls probablemente también suelan usar una regla `reset` o `forward` para los paquetes ident (`TCP` puerto 113). Por desgracia esta no es una opción válida con el bridge, por lo tanto la mejor opción es simplemente pasarlos a su destino. A menos que la máquina de destino esté ejecutando un dæmon ident es realmente inofensivo. La alternativa es eliminar las conexiones en el puerto 113, lo que creará algunos problemas con servicios como IRC (el probe del ident dará timeout).
Lo único raro que puede haber notado es que existe una regla para permitir que la máquina que hace de bridge hable y otra para los hosts internos. Recuerde que esto sucede porque los dos conjuntos de tráfico tendrán diferentes rutas a través del kernel y del filtro de paquetes. La red interna pasará por el bridge, mientras que la máquina local utilizará el stack normal de IP para hablar. Por lo tanto, cada regla se ocupa de una cosa diferente. Las reglas `in via fxp0` funcionan para ambas rutas. En general, si utiliza las reglas `in via` en todo el filtro, debe añadir una excepción para los paquetes generados localmente, ya que no llegaron a través de ninguna de nuestras interfaces.
[[filtering-bridges-contributors]]
== Colaboradores
-Muchas partes de este artículo han sido obtenidas, actualizadas y adaptadas de un texto antiguo sobre bridging, editado por Nick Sayer. Unas cuantas ideas muy inspiradoras vienen de una introducción sobre bridging que escribió Steve Peterson.
+Muchas partes de este artículo han sido obtenidas, actualizadas y adaptadas de un texto antiguo sobre el bridging, editado por Nick Sayer. Unas cuantas ideas muy inspiradoras vienen de una introducción sobre el bridging que escribió Steve Peterson.
Mi más sincero agradecimiento a Luigi Rizzo por la implementación del código de bridge en FreeBSD y por el tiempo que ha dedicado a responder todas mis preguntas.
diff --git a/documentation/content/es/articles/fonts/_index.adoc b/documentation/content/es/articles/fonts/_index.adoc
index b2554c5b3c..33eec768af 100644
--- a/documentation/content/es/articles/fonts/_index.adoc
+++ b/documentation/content/es/articles/fonts/_index.adoc
@@ -4,7 +4,6 @@ subtitle: Un tutorial
authors:
- author: Dave Bodenstab
email: imdave@synet.net
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "adobe", "apple", "linux", "microsoft", "opengroup", "general"]
---
@@ -17,14 +16,27 @@ trademarks: ["freebsd", "adobe", "apple", "linux", "microsoft", "opengroup", "ge
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
+:images-path: articles/fonts/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumen
diff --git a/documentation/content/es/articles/freebsd-questions/_index.adoc b/documentation/content/es/articles/freebsd-questions/_index.adoc
index 91c56ddbb4..5c1f2ece04 100644
--- a/documentation/content/es/articles/freebsd-questions/_index.adoc
+++ b/documentation/content/es/articles/freebsd-questions/_index.adoc
@@ -3,7 +3,6 @@ title: Cómo obtener los mejores resultados de la lista de correo FreeBSD-questi
authors:
- author: Greg Lehey
email: grog@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "microsoft", "opengroup", "qualcomm", "general"]
---
@@ -16,25 +15,26 @@ trademarks: ["freebsd", "microsoft", "opengroup", "qualcomm", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/es/urls.adoc[]
+:images-path: articles/freebsd-questions/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/es/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/es/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -134,14 +134,14 @@ Dos listas de correo manejan las preguntas generales sobre FreeBSD, `FreeBSD-que
. Si la pregunta está relacionada con un error, y está _seguro_ de que se trata de un error (por ejemplo, puede ubicar el lugar en el código donde ocurre, y quizás tenga una solución), envíe el mensaje a `FreeBSD-hackers`.
. Si la pregunta está relacionada con mejoras en FreeBSD, y puede sugerir cómo implementarlas, envíe el mensaje a `FreeBSD-hackers`.
-También hay una serie de link:{handbook}#eresources-mail[listas de correo especializadas], que atienden a intereses más específicos. Los criterios anteriores se aplican, y es de su interés atenerse a ellos, ya que es más probable que obtenga buenos resultados de esa manera.
+También hay una serie de extref:{handbook}eresources[listas de correo especializadas, eresources-mail], que atienden a intereses más específicos. Los criterios anteriores se aplican, y es de su interés atenerse a ellos, ya que es más probable que obtenga buenos resultados de esa manera.
== Antes de enviar una pregunta
Usted puede (y debe) hacer algunas cosas antes de realizar una pregunta en una de las listas de correo:
* Intente resolver el problema por su cuenta. Si publica una pregunta que demuestra que ha intentado resolver el problema, generalmente atraerá una atención más positiva de las personas que la lean. Tratar de resolver el problema por sí mismo también mejorará su comprensión de FreeBSD y, eventualmente, le permitirá utilizar su conocimiento para ayudar a otros respondiendo las preguntas publicadas en las listas de correo.
-* Lea las páginas del manual y la documentación de FreeBSD (ya sea la instalada en [.filename]#/usr/doc# o accesible a través de WWW en link:{handbook}[http://www.FreeBSD.org]), especialmente el manual y las link:{faq}[FAQ].
+* Lea las páginas del manual y la documentación de FreeBSD (ya sea la instalada en [.filename]#/usr/doc# o accesible a través de WWW en extref:{handbook}[http://www.FreeBSD.org]), especialmente el manual y las extref:{faq}[FAQ].
* Navegue y/o busque en los archivos de la lista de correo, para ver si su pregunta o una similar ya ha sido preguntada (y posiblemente contestada) en la lista. Puede navegar y/o buscar en los archivos de las listas de correo en https://www.FreeBSD.org/mail[https://www.FreeBSD.org/mail] y https://www.FreeBSD.org/search#mailinglists[https://www.FreeBSD.org/search/#mailinglists] respectivamente. También se puede hacer en otros sitios Web, por ejemplo en http://marc.theaimsgroup.com[http://marc.theaimsgroup.com].
* Use un motor de búsqueda como http://www.google.com[Google] o http://www.yahoo.com[Yahoo] para encontrar respuestas a su pregunta.
diff --git a/documentation/content/es/articles/ipsec-must/_index.adoc b/documentation/content/es/articles/ipsec-must/_index.adoc
index eaed91e109..e584b3d893 100644
--- a/documentation/content/es/articles/ipsec-must/_index.adoc
+++ b/documentation/content/es/articles/ipsec-must/_index.adoc
@@ -3,7 +3,6 @@ title: Verificación independiente de la funcionalidad de IPsec en FreeBSD
authors:
- author: David Honig
email: honig@sprynet.com
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "opengroup", "general"]
---
@@ -16,25 +15,26 @@ trademarks: ["freebsd", "opengroup", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/es/urls.adoc[]
+:images-path: articles/ipsec-must/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/es/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/es/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -126,7 +126,7 @@ Extensiones de seguridad del Protocolo de Internet para IPv4; requerido para IPv
La mayoría de las versiones modernas de FreeBSD soportan IPsec en su código base. Por lo tanto, deberá incluir la opción `IPSEC` en la configuración de su kernel y, después de recompilar y reinstalar el kernel, configure las conexiones de IPsec usando el comando man:setkey[8].
-En el link:{handbook}#ipsec[Manual de FreeBSD] se proporciona una guía completa sobre cómo ejecutar IPsec en FreeBSD.
+En el extref:{handbook}security[Manual de FreeBSD, ipsec] se proporciona una guía completa sobre cómo ejecutar IPsec en FreeBSD.
[[kernel]]
== src/sys/i386/conf/KERNELNAME
diff --git a/documentation/content/es/articles/leap-seconds/_index.adoc b/documentation/content/es/articles/leap-seconds/_index.adoc
index 63cefd7dc0..a017de0258 100644
--- a/documentation/content/es/articles/leap-seconds/_index.adoc
+++ b/documentation/content/es/articles/leap-seconds/_index.adoc
@@ -1,6 +1,5 @@
---
title: Soporte para segundos intercalares en FreeBSD
-releaseinfo: "$FreeBSD$"
---
= Soporte para segundos intercalares en FreeBSD
@@ -12,25 +11,26 @@ releaseinfo: "$FreeBSD$"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/es/urls.adoc[]
+:images-path: articles/leap-seconds/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/es/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/es/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -51,7 +51,7 @@ El comportamiento estándar de los segundos intercalares se describe en https://
[[leapseconds-posix]]
== Manejo por defecto de los segundos intercalares en FreeBSD
-La manera más fácil de manejar segundos intercalares es con las reglas de tiempo de POSIX que FreeBSD utiliza por defecto, combinadas con link:{handbook}#network-ntp[NTP]. Cuando man:ntpd[8] se esté ejecutando y el tiempo esté sincronizado con servidores remotos de NTP que manejen segundos intercalares correctamente, dicho segundo intercalar hará que el tiempo del sistema automáticamente repita el último segundo del dí­a. Ningún otro ajuste es necesario.
+La manera más fácil de manejar segundos intercalares es con las reglas de tiempo de POSIX que FreeBSD utiliza por defecto, combinadas con extref:{handbook}network-servers[NTP, network-ntp]. Cuando man:ntpd[8] se esté ejecutando y el tiempo esté sincronizado con servidores remotos de NTP que manejen segundos intercalares correctamente, dicho segundo intercalar hará que el tiempo del sistema automáticamente repita el último segundo del dí­a. Ningún otro ajuste es necesario.
Si los servidores remotos de NTP no manejan los segundos intercalares correctamente, man:ntpd[8] aumentará el tiempo en un segundo, después de que el servidor errático lo haya notado y haya saltado él mismo ese segundo.
diff --git a/documentation/content/es/articles/linux-users/_index.adoc b/documentation/content/es/articles/linux-users/_index.adoc
index fa4e7f8451..1b3837fce6 100644
--- a/documentation/content/es/articles/linux-users/_index.adoc
+++ b/documentation/content/es/articles/linux-users/_index.adoc
@@ -3,7 +3,6 @@ title: Guía de inicio rápido en FreeBSD para usuarios de Linux
authors:
- author: John Ferrell
copyright: 2008 El Proyecto de Documentación de FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"]
---
@@ -16,25 +15,26 @@ trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/es/urls.adoc[]
+:images-path: articles/linux-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/es/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/es/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -51,14 +51,14 @@ toc::[]
Este documento destaca algunas de las diferencias técnicas entre FreeBSD y Linux(R) para que los usuarios intermedios y avanzados de Linux(R) puedan familiarizarse rápidamente con los conceptos básicos de FreeBSD.
-This document assumes that FreeBSD is already installed. Refer to the link:{handbook}#bsdinstall[Installing FreeBSD] chapter of the FreeBSD Handbook for help with the installation process.
+This document assumes that FreeBSD is already installed. Refer to the extref:{handbook}bsdinstall[Installing FreeBSD, bsdinstall] chapter of the FreeBSD Handbook for help with the installation process.
[[shells]]
== Shell por defecto
Los usuarios de Linux(R) a menudo se sorprenden al descubrir que Bash no es la shell por defecto en FreeBSD. De hecho, Bash no está incluido en la instalación predeterminada. En su lugar, FreeBSD utiliza man:tcsh[1]como shell predeterminada para el usuario root y man:sh[1] como shell compatible con Bourne shell por defecto. man:sh[1] es muy similar a Bash pero con un conjunto de características mucho más pequeño. Generalmente, los scripts escritos para man:sh[1] se ejecutarán en Bash, pero al contrario no siempre es así.
-Sin embargo, Bash y otras shells están disponibles para la instalación utilizando los link:{handbook}#ports[paquetes de FreeBSD y la Colección de Ports].
+Sin embargo, Bash y otras shells están disponibles para la instalación utilizando los extref:{handbook}ports[paquetes de FreeBSD y la Colección de Ports, ports].
Después de instalar otra shell, use man:chsh[1] para cambiar la shell predeterminada de un usuario. Se recomienda mantener la shell del usuario `root`, ya que las shells que no están incluidas en el sistema base se instalan en [.filename]#/usr/local/bin#. Si hay un problema, el sistema de archivos donde se encuentra [.filename]#/usr/local/bin# podría no estar montado. En este caso, el usuario `root` podría no tener acceso a su shell por defecto, impidiendo que el usuario `root` inicie sesión y solucione el problema.
@@ -90,14 +90,14 @@ Packages are pre-compiled applications, the FreeBSD equivalents of [.filename]#.
# pkg install apache24
....
-Para obtener más información sobre los paquetes, consulte la sección 5.4 del Manual de FreeBSD: link:{handbook}#pkgng-intro[Uso de pkgng para la administración de paquetes binarios].
+Para obtener más información sobre los paquetes, consulte la sección 5.4 del Manual de FreeBSD: extref:{handbook}ports[Uso de pkgng para la administración de paquetes binarios, pkgng-intro].
[[ports]]
=== Ports
La Colección de Ports de FreeBSD es un framework de [.filename]#Makefiles# y parches específicamente personalizados para instalar aplicaciones con su código fuente en FreeBSD. Al instalar un port, el sistema buscará el códifo fuente, aplicará los parches necesarios, compilará el código e instalará la aplicación y las dependencias necesarias.
-La Colección de Ports, a veces llamada el árbol de ports, se puede instalar en [.filename]#/usr/ports# utilizando man:portsnap[8]. Se pueden encontrar instrucciones detalladas para instalar la Colección de Ports en la link:{handbook}#ports-using[sección 5.5] del Manual de FreeBSD.
+La Colección de Ports, a veces llamada el árbol de ports, se puede instalar en [.filename]#/usr/ports# utilizando man:portsnap[8]. Se pueden encontrar instrucciones detalladas para instalar la Colección de Ports en la extref:{handbook}ports[sección 5.5, ports-using] del Manual de FreeBSD.
Para compilar un port, acceda al directorio del port e inicie el proceso de build. El siguiente ejemplo instala Apache 2.4 de la colección de ports:
@@ -115,7 +115,7 @@ El beneficio de usar ports para instalar software es la capacidad de personaliza
# make WITH_LDAP="YES" install clean
....
-Consulte link:{handbook}#ports-using[Usando la Colección de Ports] para obtener más información.
+Consulte extref:{handbook}ports[Usando la Colección de Ports, ports-using] para obtener más información.
[[startup]]
== Inicio del sistema
@@ -124,7 +124,7 @@ Muchas distribuciones de Linux(R) usan el sistema de inicio SysV, mientras que F
Los scripts ubicados en [.filename]#/etc/rc.d/# son para las aplicaciones que forman parte del sistema "base", como man:cron[8], man:sshd[8], y man:syslog[3]. Los scripts ubicados en [.filename]#/usr/local/etc/rc.d/# son para aplicaciones instaladas por el usuario como Apache y Squid.
-Dado que FreeBSD se desarrolla como un sistema operativo completo, las aplicaciones instaladas por el usuario no se consideran parte del sistema "base". Las aplicaciones instaladas por el usuario generalmente se instalan utilizando link:{handbook}#ports-using[Paquetes o Ports]. Para mantenerlas separadas del sistema base, las aplicaciones instaladas por el usuario se instalan en [.filename]#/usr/local/#. Por lo tanto, los binarios instalados por el usuario están ubicados en [.filename]#/usr/local/bin/#, los archivos de configuración están en [.filename]#/usr/local/etc/#, y así sucesivamente.
+Dado que FreeBSD se desarrolla como un sistema operativo completo, las aplicaciones instaladas por el usuario no se consideran parte del sistema "base". Las aplicaciones instaladas por el usuario generalmente se instalan utilizando extref:{handbook}ports[Paquetes o Ports, ports-using]. Para mantenerlas separadas del sistema base, las aplicaciones instaladas por el usuario se instalan en [.filename]#/usr/local/#. Por lo tanto, los binarios instalados por el usuario están ubicados en [.filename]#/usr/local/bin/#, los archivos de configuración están en [.filename]#/usr/local/etc/#, y así sucesivamente.
Los servicios se habilitan añadiendo una entrada para el servicio en [.filename]#/etc/rc.conf#. Los valores predeterminados del sistema se encuentran en [.filename]#/etc/defaults/rc.conf# y las configuraciones por defecto se sobreescriben con [.filename]#/etc/rc.conf#. Consulte man:rc.conf[5] para obtener más información sobre las entradas disponibles. Al instalar aplicaciones adicionales, revise el mensaje de instalación para determinar cómo habilitar los servicios asociados.
@@ -198,9 +198,9 @@ ifconfig_em0="DHCP"
FreeBSD no usa las IPTABLES de Linux(R) para su firewall. En su lugar, FreeBSD ofrece tres firewalls a nivel del kernel:
-* link:{handbook}#firewalls-pf[PF]
-* link:{handbook}#firewalls-ipf[IPFILTER]
-* link:{handbook}#firewalls-ipfw[IPFW]
+* extref:{handbook}firewalls[PF, firewalls-pf]
+* extref:{handbook}firewalls[IPFILTER, firewalls-ipf]
+* extref:{handbook}firewalls[IPFW, firewalls-ipfw]
PF está desarrollado por el proyecto OpenBSD y portado a FreeBSD. PF fue creado como un reemplazo para IPFILTER y su sintaxis es similar. PF se puede combinar con man:altq[4] para proporcionar QoS.
@@ -249,7 +249,7 @@ Cuando use man:cron[8] para programar actualizaciones, use `freebsd-update cron`
====
-Para obtener más información de las actualizaciones de código y binarias, consulte el link:{handbook}#updating-upgrading[capítulo sobre la actualización] en el Manual de FreeBSD.
+Para obtener más información de las actualizaciones de código y binarias, consulte el extref:{handbook}updating-upgrading[capítulo sobre la actualización, updating-upgrading] en el Manual de FreeBSD.
[[procfs]]
== procfs: Desaparecido pero no olvidado
@@ -331,4 +331,4 @@ Algunos equivalentes de los comandos comunes son los siguientes:
[[conclusion]]
== Conclusión
-This document has provided an overview of FreeBSD. Refer to the link:{handbook}[FreeBSD Handbook] for more in-depth coverage of these topics as well as the many topics not covered by this document.
+This document has provided an overview of FreeBSD. Refer to the extref:{handbook}[FreeBSD Handbook] for more in-depth coverage of these topics as well as the many topics not covered by this document.
diff --git a/documentation/content/es/articles/mailing-list-faq/_index.adoc b/documentation/content/es/articles/mailing-list-faq/_index.adoc
index 0f480e5049..5f7968458d 100644
--- a/documentation/content/es/articles/mailing-list-faq/_index.adoc
+++ b/documentation/content/es/articles/mailing-list-faq/_index.adoc
@@ -3,7 +3,6 @@ title: Preguntas más frecuentes sobre las listas de correo de FreeBSD
authors:
- author: The FreeBSD Documentation Project
copyright: 2004-2005 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
---
= Preguntas más frecuentes sobre las listas de correo de FreeBSD
@@ -15,31 +14,32 @@ releaseinfo: "$FreeBSD$"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/es/urls.adoc[]
+:images-path: articles/mailing-list-faq/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/es/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/es/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
Resumen
-Estas son las FAQ de las listas de correo de FreeBSD. Si está interesado en ayudar con este proyecto, envíe un correo electrónico a la http://lists.FreeBSD.org/mailman/listinfo/freebsd-doc[lista de correo del proyecto de documentación de FreeBSD]. La última versión de este documento está siempre disponible en el link:{mailing-list-faq}[servidor de FreeBSD]. También se puede descargar como un único archivo link:.[HTML] con HTTP o como texto plano, PostScript, PDF, etc. desde el https://download.freebsd.org/ftp/doc/[servidor FTP de FreeBSD]. También es posible que desee https://www.FreeBSD.org/search/[Buscar en las FAQ].
+Estas son las FAQ de las listas de correo de FreeBSD. Si está interesado en ayudar con este proyecto, envíe un correo electrónico a la http://lists.FreeBSD.org/mailman/listinfo/freebsd-doc[lista de correo del proyecto de documentación de FreeBSD]. La última versión de este documento está siempre disponible en el extref:{mailing-list-faq}[servidor de FreeBSD]. También se puede descargar como un único archivo link:.[HTML] con HTTP o como texto plano, PostScript, PDF, etc. desde el https://download.freebsd.org/ftp/doc/[servidor FTP de FreeBSD]. También es posible que desee https://www.FreeBSD.org/search/[Buscar en las FAQ].
'''
@@ -93,7 +93,7 @@ La participación en listas de correo, como la colaboración en cualquier otra c
=== ¿Qué debo hacer antes de enviar un correo?
-Usted ha completado el paso más importante al comenzar a leer este documento. Sin embargo, si es nuevo en FreeBSD, es posible que primero deba familiarizarse con el software y toda la historia social que lo rodea, leyendo los numerosos https://www.FreeBSD.org/docs/books/[libros y artículos disponibles]. Son puntos de particular interés el documento link:{faq}[Las preguntas más frecuentes en FreeBSD (FAQ)], el link:{handbook}[Manual de FreeBSD] y los artículos link:{freebsd-questions-article}[Cómo obtener los mejores resultados de la lista de correo FreeBSD-questions], link:{explaining-bsd}[Explicando BSD], y link:{new-users}[Primeros pasos en FreeBSD].
+Usted ha completado el paso más importante al comenzar a leer este documento. Sin embargo, si es nuevo en FreeBSD, es posible que primero deba familiarizarse con el software y toda la historia social que lo rodea, leyendo los numerosos https://www.FreeBSD.org/docs/books/[libros y artículos disponibles]. Son puntos de particular interés el documento extref:{faq}[Las preguntas más frecuentes en FreeBSD (FAQ)], el extref:{handbook}[Manual de FreeBSD] y los artículos extref:{freebsd-questions-article}[Cómo obtener los mejores resultados de la lista de correo FreeBSD-questions], extref:{explaining-bsd}[Explicando BSD], y extref:{new-users}[Primeros pasos en FreeBSD].
Enviar una consulta sobre algo que ya está respondido en los documentos anteriores se considera malas formas. Esto no ocurre porque los voluntarios que colaboran en las listas sean personas especialmente susceptibles, sino porque después de un cierto tiempo respondiendo una y otra vez las mismas preguntas las personas comienzan a sentirse frustradas. Tenga siempre en cuenta que casi todo el trabajo realizado en FreeBSD lo realizan voluntarios, y que solo somos humanos.
@@ -158,7 +158,7 @@ No hay duda de que los archivos son bastante extensos, y algunas preguntas se re
[[bikeshed]]
== ¿Qué es un "Bikeshed"?
-Literalmente, un `bikeshed` es un cobertizo exterior donde se puede almacenar un vehículo de dos ruedas. No obstante, en la jerga de FreeBSD, el término se refiere a temas que son tan simples que (casi) cualquiera puede ofrecer una opinión y, a menudo (casi), todos lo hacen. El origen de este término se explica con más detalle en link:{faq}#bikeshed-painting[este documento]. Simplemente debe tener un conocimiento práctico de este concepto antes de publicar en cualquier lista de correo de FreeBSD.
+Literalmente, un `bikeshed` es un cobertizo exterior donde se puede almacenar un vehículo de dos ruedas. No obstante, en la jerga de FreeBSD, el término se refiere a temas que son tan simples que (casi) cualquiera puede ofrecer una opinión y, a menudo (casi), todos lo hacen. El origen de este término se explica con más detalle en extref:{faq}[este documento, bikeshed-painting]. Simplemente debe tener un conocimiento práctico de este concepto antes de publicar en cualquier lista de correo de FreeBSD.
De una forma más general, un bikeshed es un asunto que tiende a generar meta-discusiones y ataques si no se han leído las discusiones anteriores.
@@ -168,7 +168,7 @@ Por favor, colabore en el mantenimiento de las listas de correo evitando los bik
== Agradecimientos
Greg Lehey mailto:grog@FreeBSD.org[grog@FreeBSD.org]::
-Autor original de la mayor parte del material que cubre las normas de etiqueta de las listas, tomadas del artículo link:{freebsd-questions-article}[Cómo obtener los mejores resultados de la lista de correo FreeBSD-questions].
+Autor original de la mayor parte del material que cubre las normas de etiqueta de las listas, tomadas del artículo extref:{freebsd-questions-article}[Cómo obtener los mejores resultados de la lista de correo FreeBSD-questions].
Mark Linimon mailto:linimon@FreeBSD.org[linimon@FreeBSD.org]::
Por la creación del borrador inicial de estas FAQ.
diff --git a/documentation/content/es/articles/nanobsd/_index.adoc b/documentation/content/es/articles/nanobsd/_index.adoc
index b6f890e683..fa0446375c 100644
--- a/documentation/content/es/articles/nanobsd/_index.adoc
+++ b/documentation/content/es/articles/nanobsd/_index.adoc
@@ -3,7 +3,6 @@ title: Introducción a NanoBSD
authors:
- author: Daniel Gerzo
copyright: 2006 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -16,14 +15,27 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
+:images-path: articles/nanobsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumen
diff --git a/documentation/content/es/articles/port-mentor-guidelines/_index.adoc b/documentation/content/es/articles/port-mentor-guidelines/_index.adoc
index 28265201a6..848aae8b44 100644
--- a/documentation/content/es/articles/port-mentor-guidelines/_index.adoc
+++ b/documentation/content/es/articles/port-mentor-guidelines/_index.adoc
@@ -3,7 +3,6 @@ title: Instrucciones para los mentores de ports
organizations:
- organization: The FreeBSD Ports Management Team
copyright: 2011 Thomas Abthorpe, Chris Rees
-releaseinfo: "$FreeBSD$"
trademarks: []
---
@@ -16,25 +15,26 @@ trademarks: []
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/es/urls.adoc[]
+:images-path: articles/port-mentor-guidelines/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/es/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/es/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -77,7 +77,7 @@ Esperamos que los mentores revisen y prueben todos los parches propuestos, al me
Esperamos que los mentores se responsabilicen de las acciones de su aprendiz. Un mentor debe hacer un seguimiento con todos los commits que el aprendiz hace, tanto los aprobados como los implícitos.
-Esperamos que los mentores se aseguren de que sus aprendices lean el link:{porters-handbook}[Manual del Porter], la link:{pr-guidelines}[Guía para el manejo de informes de problemas], y la link:{committers-guide}[Guía del Committer]. Si bien no es necesario memorizar todos los detalles, cada persona debe tener una visión general de estas cosas para ser parte efectiva de la comunidad (y evitar tantos errores de novato como sea posible).
+Esperamos que los mentores se aseguren de que sus aprendices lean el extref:{porters-handbook}[Manual del Porter], la extref:{pr-guidelines}[Guía para el manejo de informes de problemas], y la extref:{committers-guide}[Guía del Committer]. Si bien no es necesario memorizar todos los detalles, cada persona debe tener una visión general de estas cosas para ser parte efectiva de la comunidad (y evitar tantos errores de novato como sea posible).
[[mentees]]
=== Selección de un aprendiz
diff --git a/documentation/content/es/articles/pr-guidelines/_index.adoc b/documentation/content/es/articles/pr-guidelines/_index.adoc
index ae1f519715..8f22947060 100644
--- a/documentation/content/es/articles/pr-guidelines/_index.adoc
+++ b/documentation/content/es/articles/pr-guidelines/_index.adoc
@@ -3,7 +3,6 @@ title: Guía para el manejo de informes de problemas
authors:
- author: Dag-Erling Smørgrav
- author: Hiten Pandya
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -16,25 +15,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/es/urls.adoc[]
+:images-path: articles/pr-guidelines/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/es/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/es/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -486,4 +486,4 @@ Establecer la categoría en `junk` indica que no hay contenido útil dentro del
Esta es una lista de recursos relevantes para la correcta escritura y procesamiento de informes de problemas. De ninguna manera debe considerarse completa.
-* link:{problem-reports}[Cómo escribir informes de problemas para FreeBSD] -- directrices para los usuarios que envían un PR.
+* extref:{problem-reports}[Cómo escribir informes de problemas para FreeBSD] -- directrices para los usuarios que envían un PR.
diff --git a/documentation/content/es/articles/problem-reports/_index.adoc b/documentation/content/es/articles/problem-reports/_index.adoc
index 9b7242043d..678bdfc25a 100644
--- a/documentation/content/es/articles/problem-reports/_index.adoc
+++ b/documentation/content/es/articles/problem-reports/_index.adoc
@@ -3,7 +3,6 @@ title: Escribiendo informes de problemas de FreeBSD
authors:
- author: Dag-Erling Smørgrav
- author: Mark Linimon
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "intel", "sun", "general"]
---
@@ -16,25 +15,26 @@ trademarks: ["freebsd", "ibm", "intel", "sun", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/es/urls.adoc[]
+:images-path: articles/problem-reports/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/es/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/es/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -68,7 +68,7 @@ Tenga en cuenta estos factores al enviar PRs sobre ports u otro software que no
* Por favor, no envíe informes de problemas que simplemente indiquen la disponibilidad de una nueva versión de una aplicación. Los maintainers de ports son notificados automáticamente por portscout cuando una nueva versión de una aplicación esta disponible. Los parches para actualizar un port a la última versión son bien recibidos.
* Para los ports que no están mantenidos (el `MAINTAINER` es `ports@FreeBSD.org`), es poco probable que un PR sin un parche adjunto sea cogido por un committer. Para convertirse en el maintainer de un port que no este mantenido, envíe un PR con la petición (sería ideal si viene con un parche adjunto, pero no es necesario).
-* En cualquier caso, seguir el proceso descrito en el link:{porters-handbook}#port-upgrading[Manual del Porter] dará los mejores resultados. (Es posible que también desee leer link:{contributing}#ports-contributing[Cómo contribuir a la colección de ports de FreeBSD]).
+* En cualquier caso, seguir el proceso descrito en el extref:{porters-handbook}[Manual del Porter, port-upgrading] dará los mejores resultados. (Es posible que también desee leer extref:{contributing}[Cómo contribuir a la colección de ports de FreeBSD, ports-contributing]).
Un error que no se puede reproducir rara vez se podrá arreglar. Si el error solo ocurrió una vez y no puede reproducirlo, y no parece que le ocurra a nadie más, es probable que ninguno de los desarrolladores pueda reproducirlo o descubrir qué es lo que está mal. Eso no significa que no haya ocurrido, significa que las posibilidades de que su informe de problemas lleve a la corrección del error son muy escasas. Para empeorar las cosas, a menudo, este tipo de errores son en realidad causados por fallos en los discos duros o procesadores con sobrecalentamiento, siempre debe intentar descartar estas causas, siempre que sea posible, antes de enviar un PR.
@@ -80,7 +80,7 @@ A continuación, para decidir a quién debe presentar su informe de problemas, d
Después, averigüe si es un problema puntual. Existen pocas cosas que molesten más a un desarrollador que recibir un informe de problemas sobre un error que ya ha solucionado.
-Si el problema está en el sistema base, primero lea la sección de preguntas frecuentes sobre las link:{faq}#LATEST-VERSION[versiones de FreeBSD], si aún no está familiarizado con el tema. FreeBSD no puede solucionar problemas en otras ramas que no sean las más recientes del sistema base, por lo que presentar un informe de error sobre una versión anterior probablemente hará que un desarrollador le aconseje que se actualice a una versión soportada para comprobar si el problema todavía sucede. El equipo Security Officer mantiene https://www.FreeBSD.org/security/[la lista de versiones soportadas].
+Si el problema está en el sistema base, primero lea la sección de preguntas frecuentes sobre las extref:{faq}[versiones de FreeBSD, LATEST-VERSION], si aún no está familiarizado con el tema. FreeBSD no puede solucionar problemas en otras ramas que no sean las más recientes del sistema base, por lo que presentar un informe de error sobre una versión anterior probablemente hará que un desarrollador le aconseje que se actualice a una versión soportada para comprobar si el problema todavía sucede. El equipo Security Officer mantiene https://www.FreeBSD.org/security/[la lista de versiones soportadas].
Si el problema está en un port, considere enviar el error al upstream. El proyecto FreeBSD no puede corregir todos los errores en todo el software.
@@ -89,8 +89,8 @@ Si el problema está en un port, considere enviar el error al upstream. El proye
Una buena regla que se puede seguir consiste en realizar siempre una búsqueda antes de enviar un informe de problemas. Quizá nuestro problema ya ha sido reportado; quizá se está discutiendo en las listas de correo o fue discutido hace poco; incluso puede que ya esté arreglado en una versión más nueva que la que está ejecutando. Por lo tanto, se deben consultar los sitios y fuentes más obvias antes de proceder con el envío del informe de errores. En FreeBSD, esto significa:
-* La lista de link:{faq}[preguntas más frecuentes] (FAQ) de FreeBSD. Las preguntas frecuentes intentan proporcionar respuestas a una amplia gama de preguntas, como las relacionadas con la link:{faq}#hardware[compatibilidad del hardware], las link:{faq}#applications[aplicaciones de usuario] y la link:{faq}#kernelconfig[configuración del kernel].
-* Las link:{handbook}#eresources-mail[listas de correo], si no está suscrito, utilice la https://www.FreeBSD.org/search/#mailinglists[búsqueda en los archivos] del sitio web de FreeBSD. Si el problema no se ha discutido con anterioridad en las listas, se puede intentar enviar un mensaje y esperar unos pocos días para ver si alguien puede aconsejarle adecuadamente sobre algún punto que quizá haya pasado por alto en relación con el problema.
+* La lista de extref:{faq}[preguntas más frecuentes] (FAQ) de FreeBSD. Las preguntas frecuentes intentan proporcionar respuestas a una amplia gama de preguntas, como las relacionadas con la extref:{faq}[compatibilidad del hardware, hardware], las extref:{faq}[aplicaciones de usuario, applications] y la extref:{faq}[configuración del kernel, kernelconfig].
+* Las extref:{handbook}eresources[listas de correo, eresources-mail], si no está suscrito, utilice la https://www.FreeBSD.org/search/#mailinglists[búsqueda en los archivos] del sitio web de FreeBSD. Si el problema no se ha discutido con anterioridad en las listas, se puede intentar enviar un mensaje y esperar unos pocos días para ver si alguien puede aconsejarle adecuadamente sobre algún punto que quizá haya pasado por alto en relación con el problema.
* Opcionalmente, toda la web: utilice su motor de búsqueda favorito para localizar cualquier referencia al problema. Incluso puede obtener listas de correo archivadas o grupos de noticias que no conocía o en los que no había pensado buscar.
* A continuación, la búsqueda a través de la https://bugs.freebsd.org/bugzilla/query.cgi[base de datos de PR de FreeBSD] (Bugzilla). A menos que el problema sea muy reciente o rebuscado, existe un gran número de posibilidades de que ya haya sido informado o reportado.
* Lo más importante, se debería intentar comprobar si la documentación existente en el código fuente del programa puede resolver el problema.
@@ -227,9 +227,9 @@ A veces hay un retraso de una o dos semanas en las cuales el informe del problem
Hay varias formas de hacerlo, lo ideal es el orden siguiente, con algunos días entre cada intento:
-* Encuentre la lista de correo de FreeBSD que sea relevante para el informe de problemas en link:{handbook}#eresources-mail[la lista del manual] y envíe un mensaje a esa lista preguntando por asistencia o comentarios sobre el informe de problemas.
+* Encuentre la lista de correo de FreeBSD que sea relevante para el informe de problemas en extref:{handbook}eresources[la lista del manual, eresources-mail] y envíe un mensaje a esa lista preguntando por asistencia o comentarios sobre el informe de problemas.
* Únase a los canales de IRC relevantes. Aquí un listado parcial: https://wiki.freebsd.org/IrcChannels[]. Informe a las personas en ese canal sobre el informe del problema y solicite asistencia. Sea paciente y permanezca en el canal después de la publicación, para que las personas de diferentes zonas horarias de todo el mundo tengan la oportunidad de ponerse al día.
-* Encuentre a committers interesados en el problema que reportó. Si el problema estaba en una herramienta, binario, port, documento o un fichero de código fuente en particular, verifique el http://svnweb.FreeBSD.org[repositorio SVN]. Localice a los últimos committers que realizaron cambios sustanciales en el archivo e intente acceder a ellos a través de IRC o correo electrónico. Puede encontrar una lista de los committers y sus correos electrónicos en el artículo link:{contributors}[Colaboradores de FreeBSD].
+* Encuentre a committers interesados en el problema que reportó. Si el problema estaba en una herramienta, binario, port, documento o un fichero de código fuente en particular, verifique el http://svnweb.FreeBSD.org[repositorio SVN]. Localice a los últimos committers que realizaron cambios sustanciales en el archivo e intente acceder a ellos a través de IRC o correo electrónico. Puede encontrar una lista de los committers y sus correos electrónicos en el artículo extref:{contributors}[Colaboradores de FreeBSD].
Recuerde que estas personas son voluntarios, al igual que los maintainers y usuarios, por lo que es posible que no estén disponibles de inmediato para ayudar con el informe del problema. La paciencia y la constancia en los seguimientos son altamente recomendadas y apreciadas. Con el suficiente cuidado y esfuerzo dedicado al proceso de seguimiento, encontrar un committer para encargarse del informe del problema es solo cuestión de tiempo.
@@ -244,4 +244,4 @@ Si ha encontrado un problema con el sistema de errores, ¡presente un error! Hay
A continuación se muestra una lista de recursos relacionados con la escritura adecuada de informes y con el procesamiento de dichos informes. No pretende ser una completa enumeración.
* https://github.com/smileytechguy/reporting-bugs-effectively/blob/master/ENGLISH.md[Cómo informar errores de forma efectiva]--un excelente ensayo por Simon G. Tatham sobre la redacción de informes de problemas (el texto no es específico sobre FreeBSD).
-* link:{pr-guidelines}[Guía para el manejo de informes de problemas]--contiene una información valiosa sobre cómo los informes de problemas son manejados por los desarrolladores de FreeBSD.
+* extref:{pr-guidelines}[Guía para el manejo de informes de problemas]--contiene una información valiosa sobre cómo los informes de problemas son manejados por los desarrolladores de FreeBSD.
diff --git a/documentation/content/es/articles/releng/_index.adoc b/documentation/content/es/articles/releng/_index.adoc
index d995f7636f..bf257f5eea 100644
--- a/documentation/content/es/articles/releng/_index.adoc
+++ b/documentation/content/es/articles/releng/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Murray Stokely
email: murray@FreeBSD.org
webpage: https://people.FreeBSD.org/~murray/
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "cvsup", "intel", "xfree86", "general"]
---
@@ -17,42 +16,26 @@ trademarks: ["freebsd", "cvsup", "intel", "xfree86", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:xrefstyle: full
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-
-
-ifeval::["{backend}" == "html5"]
-include::shared/releases.adoc[]
+:images-path: articles/releng/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/urls.adoc[]
-:imagesdir: ../../../images/articles/releng/
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/es/teams.adoc[]
-include::../../../../shared/es/mailing-lists.adoc[]
-include::../../../../shared/es/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/releng/
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/es/teams.adoc[]
-include::../../../../shared/es/mailing-lists.adoc[]
-include::../../../../shared/es/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/releng/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -205,7 +188,7 @@ Para poder construir la releases de una forma exitosa se debe rellenar primero e
* `CVSROOT` - La ubicación del repositorio de CVS.
* `RELEASETAG` - La etiqueta CVS correspondiente con la release que se quiere construir.
-Si no se dispone de acceso a un repositorio de CVS local, se puede realizar una copia espejo (un mirror) con link:{handbook}#synching[CVSup]. El fichero [.filename]#/usr/shared/examples/cvsup/cvs-supfile#, sirve como buen punto de partida para realizar un mirror del repositorio de CVS.
+Si no se dispone de acceso a un repositorio de CVS local, se puede realizar una copia espejo (un mirror) con extref:{handbook}updating-upgrading[CVSup, synching]. El fichero [.filename]#/usr/shared/examples/cvsup/cvs-supfile#, sirve como buen punto de partida para realizar un mirror del repositorio de CVS.
Si se omite `RELEASETAG`, la release se construirá a partir de la rama `HEAD` (también conocida como -CURRENT). Las releases que se construyen desde el principio se conocen normalmente con el nombre de "-CURRENT snapshots".
@@ -304,7 +287,7 @@ Un enlace simbólico a [.filename]#../../../ports/arch/packages-X.Y-release#.
[.filename]#/pub/FreeBSD/releases/arch/ISO-IMAGES/X.Y/X.Y-RELEASE-arch-*.iso#::
Las imágenes ISO. El "*" se sustituye por [.filename]#disc1#, [.filename]#disc2#, etc. Solo si existe [.filename]#disc1# junto con un CD de primera instalación alternativo (por ejemplo una instalación recortada o reducida sin sistema de ventanas) puede existir también un [.filename]#mini#.
-Para obtener más información sobre la arquitectura de mirrors para la distribución del sistema FreeBSD, se ruega al lector que consulte el artículo link:{hubs}[Mirroring FreeBSD].
+Para obtener más información sobre la arquitectura de mirrors para la distribución del sistema FreeBSD, se ruega al lector que consulte el artículo extref:{hubs}[Mirroring FreeBSD].
Puede que transcurran desde varias horas hasta varios días hasta que la mayoría de los sitios FTP Tier-1 se actualicen con respecto al `ftp-master`, esto depende de si un determinado paquete se cargó o no se cargó en determinado instante. Es imperativo que los ingenieros de releases se coordinen con {mirror-announce} antes de anunciar la disponibilidad general del nuevo software en los sitios FTP. Para que todo fuera bien el paquete de la release se debería cargar al menos cuatro días antes del día oficial de lanzamiento de la release. Los permisos para el grupo "other" deben desactivarse completamente para que los sitios espejos puedan descargar la release pero no así los usuarios finales, hasta que llegue el día oficial del lanzamiento. Se debe enviar un correo a {mirror-announce} cuando se publican la release con los permisos modificados, diciendo que la release ha sido puesta en escena y proporcionando la fecha a partir de la cual los mirrors deben comenzar a dar permisos de acceso para el público en general. Se debe comprobar que se incluye información relativa a zonas horarias, por ejemplo información relativa a GMT.
@@ -372,11 +355,11 @@ Me gustaría agradecer a Jordan Hubbard por darme la oportunidad de colaborar en
(5) The libh Project http://www.FreeBSD.org/projects/libh/[http://www.FreeBSD.org/projects/libh/]
-(6) link:{contributors}#staff-committers[FreeBSD Committers]
+(6) extref:{contributors}[FreeBSD Committers, staff-committers]
-(7) link:{contributors}#staff-core[FreeBSD Core-Team]
+(7) extref:{contributors}[FreeBSD Core-Team, staff-core]
-(8) link:{handbook}[FreeBSD Handbook]
+(8) extref:{handbook}[FreeBSD Handbook]
(9) GNATS: The GNU Bug Tracking System http://www.gnu.org/software/gnats[http://www.gnu.org/software/gnats]
diff --git a/documentation/content/es/articles/remote-install/_index.adoc b/documentation/content/es/articles/remote-install/_index.adoc
index f125a99c75..08519b2825 100644
--- a/documentation/content/es/articles/remote-install/_index.adoc
+++ b/documentation/content/es/articles/remote-install/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Daniel Gerzo
email: danger@FreeBSD.org
copyright: 2008 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -17,25 +16,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/es/urls.adoc[]
+:images-path: articles/remote-install/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/es/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/es/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -202,7 +202,7 @@ Al principio, marque todos los discos del sistema como vacíos. Repita el siguie
# dd if=/dev/zero of=/dev/ad0 count=2
....
-A continuación, cree las slices y etiquételas con su herramienta preferida. A pesar de que se considera más fácil usar Sysinstall, un método potente y probablemente menos defectuoso será usar herramientas estándar de UNIX(R) basadas en texto, como man:fdisk[8] y man:bsdlabel[8], también tratadas en esta sección. La primera opción está bien documentada en el capítulo de link:{handbook}#install-steps[Instalación de FreeBSD] del Manual de FreeBSD. Como se mencionó en la introducción, este artículo explicará cómo configurar un sistema con RAID-1 y ZFS. Nuestra configuración consistirá en una pequeña partición [.filename]#/# (raíz), con un conjunto de datos compuesto por [.filename]#/usr# y [.filename]#/var#, todos en mirror con man:gmirror[8] y el resto del espacio en disco asignado a un sistema de archivos ZFS en mirror con man:zpool[8]. Por favor, tenga en cuenta que el sistema de archivos ZFS se configurará después de que el sistema operativo FreeBSD se instale y se inicie correctamente.
+A continuación, cree las slices y etiquételas con su herramienta preferida. A pesar de que se considera más fácil usar Sysinstall, un método potente y probablemente menos defectuoso será usar herramientas estándar de UNIX(R) basadas en texto, como man:fdisk[8] y man:bsdlabel[8], también tratadas en esta sección. La primera opción está bien documentada en el capítulo de extref:{handbook}install-steps[Instalación de FreeBSD, install] del Manual de FreeBSD. Como se mencionó en la introducción, este artículo explicará cómo configurar un sistema con RAID-1 y ZFS. Nuestra configuración consistirá en una pequeña partición [.filename]#/# (raíz), con un conjunto de datos compuesto por [.filename]#/usr# y [.filename]#/var#, todos en mirror con man:gmirror[8] y el resto del espacio en disco asignado a un sistema de archivos ZFS en mirror con man:zpool[8]. Por favor, tenga en cuenta que el sistema de archivos ZFS se configurará después de que el sistema operativo FreeBSD se instale y se inicie correctamente.
El siguiente ejemplo describirá cómo crear slices y etiquetas, inicializar man:gmirror[8] en cada partición y cómo crear un sistema de archivos UFS2 en cada partición en mirror:
diff --git a/documentation/content/es/articles/solid-state/_index.adoc b/documentation/content/es/articles/solid-state/_index.adoc
index 40f5fd3a59..196569f725 100644
--- a/documentation/content/es/articles/solid-state/_index.adoc
+++ b/documentation/content/es/articles/solid-state/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: John Kozubik
email: john@kozubik.com
copyright: 2001, 2009 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -17,14 +16,27 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
+:images-path: articles/solid-state/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumen
diff --git a/documentation/content/es/articles/vinum/_index.adoc b/documentation/content/es/articles/vinum/_index.adoc
index 4f3a47b710..798c43d82e 100644
--- a/documentation/content/es/articles/vinum/_index.adoc
+++ b/documentation/content/es/articles/vinum/_index.adoc
@@ -26,20 +26,26 @@ For the FreeBSD Documentation Project
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-
-
-ifeval::["{backend}" == "html5"]
-include::shared/es/urls.adoc[]
-:imagesdir: ../../../images/articles/vinum/
+:images-path: articles/vinum/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/es/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/vinum/
endif::[]
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/articles/vinum/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -57,7 +63,7 @@ Este capítulo proporciona una visión general de los problemas potenciales del
[NOTE]
====
-Comenzando con FreeBSD 5, [.filename]#vinum# ha sido reescrito para adaptarlo a la link:{handbook}#geom[arquitectura GEOM], a la vez que se mantienen las ideas originales, terminología, y metadata en disco. Esta reescritura se llama _gvinum_ (por _GEOM vinum_). Aunque este capítulo utiliza el término [.filename]#vinum#, cualquier invocación de comando se debe realizar con `gvinum`. El nombre del módulo del kernel ha cambiado del original [.filename]#vinum.ko# a [.filename]#geom_vinum.ko#, y todos los nodos de dispositivo residen bajo [.filename]#/dev/gvinum# en lugar de [.filename]#/dev/vinum#. A partir de FreeBSD 6, la implementación original de [.filename]#vinum# no está disponible en el código base.
+Comenzando con FreeBSD 5, [.filename]#vinum# ha sido reescrito para adaptarlo a la extref:{handbook}geom[arquitectura GEOM, geom], a la vez que se mantienen las ideas originales, terminología, y metadata en disco. Esta reescritura se llama _gvinum_ (por _GEOM vinum_). Aunque este capítulo utiliza el término [.filename]#vinum#, cualquier invocación de comando se debe realizar con `gvinum`. El nombre del módulo del kernel ha cambiado del original [.filename]#vinum.ko# a [.filename]#geom_vinum.ko#, y todos los nodos de dispositivo residen bajo [.filename]#/dev/gvinum# en lugar de [.filename]#/dev/vinum#. A partir de FreeBSD 6, la implementación original de [.filename]#vinum# no está disponible en el código base.
====
[[vinum-access-bottlenecks]]
@@ -580,11 +586,11 @@ En el prompt en el que se pregunta por el sistema de ficheros raíz a montar, se
==== Sólo Arranca la Configuración de Arranque Primaria
-Si [.filename]#/boot/loader# falla al cargar, pero la configuración de arranque primaria todavía carga (visible mediante un sólo guión en la columna de la izquierda de la pantalla justo después de que comience el proceso de arranque), se puede intentar interrumpir el arranque primario presionando kbd:[espacio]. Esto hará que el proceso de arranque se pare en link:{handbook}#boot-boot1[stage two]. Aquí se puede intentar arrancar desde una partición alternativa, como la partición que contiene sl sistema de ficheros raíz anterior que ha sido movido desde `a`.
+Si [.filename]#/boot/loader# falla al cargar, pero la configuración de arranque primaria todavía carga (visible mediante un sólo guión en la columna de la izquierda de la pantalla justo después de que comience el proceso de arranque), se puede intentar interrumpir el arranque primario presionando kbd:[espacio]. Esto hará que el proceso de arranque se pare en extref:{handbook}boot[stage two, boot-boot1]. Aquí se puede intentar arrancar desde una partición alternativa, como la partición que contiene sl sistema de ficheros raíz anterior que ha sido movido desde `a`.
[[vinum-root-panic]]
==== Nada Arranca, el Proceso de Arranque entra en Pánico
Esta situación ocurrirá si el código de arranque ha sido destruido por la instalación de [.filename]#vinum#. Desafortunadamente, [.filename]#vinum# deja por accidente sólo 4KB libres al comienzo de su partición antes de empezar a escribir la información de cabecera de [.filename]#vinum#. Sin embargo, los códigos de arranque de las fases uno y dos más bsdlabel requieren 8 KB. Así que si una partición [.filename]#vinum# empezó en un offset 0 dentro de una rebanada o disco que se pretendía que fuera arrancable, la configuración de [.filename]#vinum# se llevará por delante el código de arranque.
-De forma similar, si se ha recuperado de la situación anterior, arrancando desde un medio "Fixit", y el código de arranque ha sido reinstalado utilizando `bsdlabel -B` como se describe en link:{handbook}#boot-boot1[stage two], el código de arranque destruirá la cabecera [.filename]#vinum#, y [.filename]#vinum# ya no podrá encontrar su(s) disco(s). Aunque ningún volumen [.filename]#vinum# o datos de configuración de [.filename]#vinum# serán destruidos, y sería posible recuperar todos los datos introduciendo de nuevo exactamente los mismos datos de configuración de [.filename]#vinum# la situación es difícil de arreglar. Es necesario mover la partición [.filename]#vinum# entera al menos 4 KB, para que la cabecera [.filename]#vinum# y el código de arranque del sistema ya no colisionen.
+De forma similar, si se ha recuperado de la situación anterior, arrancando desde un medio "Fixit", y el código de arranque ha sido reinstalado utilizando `bsdlabel -B` como se describe en extref:{handbook}boot[stage two, boot-boot1], el código de arranque destruirá la cabecera [.filename]#vinum#, y [.filename]#vinum# ya no podrá encontrar su(s) disco(s). Aunque ningún volumen [.filename]#vinum# o datos de configuración de [.filename]#vinum# serán destruidos, y sería posible recuperar todos los datos introduciendo de nuevo exactamente los mismos datos de configuración de [.filename]#vinum# la situación es difícil de arreglar. Es necesario mover la partición [.filename]#vinum# entera al menos 4 KB, para que la cabecera [.filename]#vinum# y el código de arranque del sistema ya no colisionen.
diff --git a/documentation/content/es/articles/vm-design/_index.adoc b/documentation/content/es/articles/vm-design/_index.adoc
index c1ef6407f3..bb876b2738 100644
--- a/documentation/content/es/articles/vm-design/_index.adoc
+++ b/documentation/content/es/articles/vm-design/_index.adoc
@@ -18,17 +18,26 @@ trademarks: ["freebsd", "linux", "microsoft", "opengroup", "daemon-news", "gener
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/articles/vm-design/
+:images-path: articles/vm-design/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/articles/vm-design/
endif::[]
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/articles/vm-design/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
diff --git a/documentation/content/es/books/faq/_index.adoc b/documentation/content/es/books/faq/_index.adoc
index a3d93f115a..34dd886647 100644
--- a/documentation/content/es/books/faq/_index.adoc
+++ b/documentation/content/es/books/faq/_index.adoc
@@ -1,70 +1,56 @@
---
-title: Preguntas Frecuentes para FreeBSD 9.X y 10.X
+title: Preguntas Frecuentes para FreeBSD 11.X, 12.X, y 13.X
authors:
- author: El proyecto de documentación de FreeBSD
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
+trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
+isIndex: true
---
-= Preguntas Frecuentes para FreeBSD 9.X y 10.X
+= Preguntas Frecuentes para FreeBSD {rel2-relx} y {rel-relx}
:doctype: book
:toc: macro
:toclevels: 1
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:rel-numbranch: 3
-:rel-head: 13-CURRENT
-:rel-head-relx: 13.X
+:images-path: books/faq/
+:rel-numbranch: 4
+:rel-head: 14-CURRENT
+:rel-head-relx: 14.X
:rel-head-releng: head/
-:rel-relx: 12.X
-:rel-stable: 12-STABLE
-:rel-releng: stable/12/
+:rel-relx: 13.X
+:rel-stable: 13-STABLE
+:rel-releng: stable/13/
:rel-relengdate: December 2018
-:rel2-relx: 11.X
-:rel2-stable: 11-STABLE
-:rel2-releng: stable/11/
-:rel2-relengdate: October 2016
-
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+:rel2-relx: 12.X
+:rel2-stable: 12-STABLE
+:rel2-releng: stable/12/
+:rel2-relengdate: December 2018
+:rel3-relx: 11.X
+:rel3-stable: 11-STABLE
+:rel3-releng: stable/11/
+:rel3-relengdate: October 2016
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/es/mailing-lists.adoc[]
-include::../../../../shared/es/teams.adoc[]
-include::../../../../shared/es/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/es/mailing-lists.adoc[]
-include::../../../../shared/es/teams.adoc[]
-include::../../../../shared/es/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -88,7 +74,7 @@ Esta basado en la versión "4.4BSD-Lite" de la U.C. Berkeley, con algunas mejora
FreeBSD es usado por compañias, proveedores de internet, investigadores, profesionales de las computadoras, estudiantes y usuarios hogareños alrededor del mundo para su trabajo educación y recreación.
-Para información más detallada acerca de FreeBSD, vea el link:{handbook}[manual de FreeBSD].
+Para información más detallada acerca de FreeBSD, vea el extref:{handbook}[manual de FreeBSD].
[[FreeBSD-goals]]
=== ¿Cual es el objetivo del proyecto FreeBSD?
@@ -115,7 +101,7 @@ La mayoría de la gente no usa realmente un sistema operativo. Usan aplicaciones
Si una aplicación solo esta disponible en un sistema operativo, ese sistema operativo no puede ser reemplazado. De todas maneras, hay muchas posibilidades de que haya una aplicación muy similar en FreeBSD. Como un sólido servidor para la oficina o internet o una confiable estación de trabajo, FreeBSD con toda seguridad hara todo lo que usted necesita. Muchos usuarios de computadoras alrededor del mundo, incluyendo novatos y administradores UNIX(TM) experimentados, utilizan FreeBSD como su único sistema operativo de escritorio.
-Los usuarios que migren a FreeBSD desde otro ambiente estilo UNIX(TM) encontraran que FreeBSD es similar. Los usuarios de Windows(TM) y Mac OS(TM) pueden estar interesados en utilizar http://www.pcbsd.org/[PC-BSD], una distribución de escritorio basada en FreeBSD. Los usuarios no-UNIX(TM) deberían esperar invertir más tiempo aprendiendo la manera UNIX(TM) de hacer las cosas. Este FAQ y el link:{handbook}[manual de FreeBSD] son excelentes lugares para empezar.
+Los usuarios que migren a FreeBSD desde otro ambiente estilo UNIX(TM) encontraran que FreeBSD es similar. Los usuarios de Windows(TM) y Mac OS(TM) pueden estar interesados en utilizar http://www.pcbsd.org/[PC-BSD], una distribución de escritorio basada en FreeBSD. Los usuarios no-UNIX(TM) deberían esperar invertir más tiempo aprendiendo la manera UNIX(TM) de hacer las cosas. Este FAQ y el extref:{handbook}[manual de FreeBSD] son excelentes lugares para empezar.
=== ¿Porque se llama FreeBSD?
@@ -151,7 +137,7 @@ Puede encontrarse más información acerca de las versiones de FreeBSD en la htt
=== ¿Qué es FreeBSD-CURRENT?
-link:{handbook}#current[FreeBSD-CURRENT] es la versión de desarrollo del sistema operativo, la cual a su debido tiempo se convertira en la nueva rama FreeBSD-STABLE. Como tal, solo sirve de interes a los desarrolladores trabajando en el sistema y entusiastas acérrimos. Vea la link:{handbook}#current[sección reelevante] en el link:{handbook}[manual] para obtener detalles acerca de correr _-CURRENT_.
+extref:{handbook}updating-upgrading[FreeBSD-CURRENT, current] es la versión de desarrollo del sistema operativo, la cual a su debido tiempo se convertira en la nueva rama FreeBSD-STABLE. Como tal, solo sirve de interes a los desarrolladores trabajando en el sistema y entusiastas acérrimos. Vea la extref:{handbook}updating-upgrading[sección reelevante, current] en el extref:{handbook}[manual] para obtener detalles acerca de correr _-CURRENT_.
Los usuarios que no esten familiarizados con FreeBSD no deberían usar FreeBSD-CURRENT. Esta rama suele evolucionar rápidamente y a veces, debido a errores puede ser imposible de compilar. Se espera que la gente que usa FreeBSD-CURRENT sea capaz de analizar, debuggear y reportar problemas.
@@ -170,7 +156,7 @@ Los snapshots oficiales se generan regularmente para todas las ramas desarrollad
=== ¿Cual es el concepto de FreeBSD-STABLE?
-Cuando se lanzo FreeBSD 2.0.5, el desarrollo de FreeBSD se ramifico en dos. Una rama fue llamada link:{handbook}#stable[-STABLE], y otra link:{handbook}#current[-CURRENT]. _FreeBSD-STABLE_ esta pensada para ser usada por proveedores de internet, y otras compañías comerciales para las cuales cambios bruscos o características experimentales son indeseables. Solo recibe arreglos de errores que hayan sido probados en profundidad y otras pequeñas mejoras incrementales. _FreeBSD-CURRENT_, por otra parte ha sido una linea continua desde que se lanzo 2.0 hasta 10.2-RELEASE y más allá. Para información más detallada acerca de las ramas vea "link:{releng}#rel-branch[Ingenieria de lanzamientos de FreeBSD: Creando la Rama de Lanzamiento]", el estado de las ramas y la agenda de lanzamientos futuros puede encontrarse en la página de http://www.FreeBSD.org/releng[Información de ingeniería de lanzamientos].
+Cuando se lanzo FreeBSD 2.0.5, el desarrollo de FreeBSD se ramifico en dos. Una rama fue llamada extref:{handbook}updating-upgrading[-STABLE, stable], y otra extref:{handbook}updating-upgrading[-CURRENT, current]. _FreeBSD-STABLE_ esta pensada para ser usada por proveedores de internet, y otras compañías comerciales para las cuales cambios bruscos o características experimentales son indeseables. Solo recibe arreglos de errores que hayan sido probados en profundidad y otras pequeñas mejoras incrementales. _FreeBSD-CURRENT_, por otra parte ha sido una linea continua desde que se lanzo 2.0 hasta 10.2-RELEASE y más allá. Para información más detallada acerca de las ramas vea "extref:{releng}[Ingenieria de lanzamientos de FreeBSD: Creando la Rama de Lanzamiento, rel-branch]", el estado de las ramas y la agenda de lanzamientos futuros puede encontrarse en la página de http://www.FreeBSD.org/releng[Información de ingeniería de lanzamientos].
10.2-STABLE es la rama activamente desarrollada de _-STABLE_. La última versión de la rama 10.2-STABLE es 10.2-RELEASE, la cual fue lanzada en Agosto del 2015.
@@ -186,7 +172,7 @@ Para la gente que quiere o necesita algo de emoción, snapshots binarios se hace
=== ¿Quien es responsable por FreeBSD?
-Las decisiones clave que tengan que ver con el proyecto FreeBSD, tales como la dirección general del proyecto y quien puede agregar codigo al arbol fuente, son hechas por un https://www.FreeBSD.org/administration/#t-core[equipo central] de 9 personas. Existe un equipo mucho más grande de más de 350 link:{contributors}#staff-committers[committers] que estan autorizados a hacer cambios directamente al árbol de fuentes.
+Las decisiones clave que tengan que ver con el proyecto FreeBSD, tales como la dirección general del proyecto y quien puede agregar codigo al arbol fuente, son hechas por un https://www.FreeBSD.org/administration/#t-core[equipo central] de 9 personas. Existe un equipo mucho más grande de más de 350 extref:{contributors}[committers, staff-committers] que estan autorizados a hacer cambios directamente al árbol de fuentes.
No obstante, la mayoría de los cambios no triviales se discuten por adelantado en las <<mailing,listas de correo>>, y no existen restricciones acerca de quien puede participar en la discusión.
@@ -198,7 +184,7 @@ Cada lanzamiento importante de FreeBSD esta disponible via FTP anónimo desde el
* Versiones https://www.FreeBSD.org/snapshots/[Snapshot] se hacen mensualmente para las ramas <<current,-CURRENT>> y <<stable,-STABLE>>, siendo estas útiles unicamente para probadores de vanguardia y desarrolladores.
* La última versión _9-STABLE_, 9.3-RELEASE puede encontrarse en el link:ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/9.3-RELEASE/[directorio 9.3-RELEASE].
-Información acerca de como obtener FreeBSD en CD, DVD y otros medios puede encontrarse en link:{handbook}#mirrors/[el manual].
+Información acerca de como obtener FreeBSD en CD, DVD y otros medios puede encontrarse en extref:{handbook}mirrors/[el manual, mirrors].
=== ¿Como accedo a la base de datos de reporte de problemas?
@@ -206,13 +192,13 @@ La base de datos de reporte de problemas de todos los pedidos de cambio por part
La https://www.FreeBSD.org/support/bugreports/[interfaz basada en web de envio de reporte de problemas] puede ser usada para enviar reportes a través de un navegador web.
-Antes de envíar un reporte de problemas, lea link:{problem-reports}[Escribiendo reportes de problemas para FreeBSD], un artículo acerca de como escribir buenos reportes de problemas.
+Antes de envíar un reporte de problemas, lea extref:{problem-reports}[Escribiendo reportes de problemas para FreeBSD], un artículo acerca de como escribir buenos reportes de problemas.
== Documentación y soporte
=== ¿Qué buenos libros hay acerca de FreeBSD?
-El proyecto produce un amplio rango de documentación, disponible en linea a través de este link:http://www.FreeBSD.org/docs/[http://www.FreeBSD.org/docs/]. Adicionalmente, <<bibliography,la bibliografía>> al final de este FAQ, y link:{handbook}#bibliography/[la del manual] referencian otros libros recomendados.
+El proyecto produce un amplio rango de documentación, disponible en linea a través de este link:http://www.FreeBSD.org/docs/[http://www.FreeBSD.org/docs/]. Adicionalmente, <<bibliography,la bibliografía>> al final de este FAQ, y extref:{handbook}bibliography/[la del manual, bibliography] referencian otros libros recomendados.
=== ¿Esta la documentación disponible en otros formatos, tales como texto plano (ASCII), o PostScript?
@@ -349,7 +335,7 @@ Si el archivo esta comprimido, tar detectara automaticamente el formato apropiad
=== ¿Donde encuentro información acerca de las listas de correo de FreeBSD? ¿Qué grupos de noticias de FreeBSD estan disponibles?
-Vea la link:{handbook}#eresources-mail[entrada del manual acerca de listas de correo] y la link:{handbook}#eresources-news/[entrada del manual acerca de grupos de noticias].
+Vea la extref:{handbook}eresources[entrada del manual acerca de listas de correo, eresources-mail] y la extref:{handbook}eresources/[entrada del manual acerca de grupos de noticias, eresources-news].
=== ¿Hay canales de IRC (Internet Relay Chat) de FreeBSD?
@@ -411,7 +397,7 @@ Cualquiera de los siguientes puede ser usado:
Los usuarios de pc98 requerirán las siguientes imágenes de disquete: [.filename]#floppies/boot.flp#, [.filename]#floppies/kern1.flp#, [.filename]#floppies/kern2.flp#, y [.filename]#floppies/mfsroot1.flp#. Estas imagenes necesitaran ser escritas a disquetes por herramientas como man:dd[1].
-Instrucciones completas acerca de este procedimiento y mas información acerca de problemas de instalación en general puede encontrarse en este la link:{handbook}#bsdinstall/[entra de manual acerca de instalar FreeBSD].
+Instrucciones completas acerca de este procedimiento y mas información acerca de problemas de instalación en general puede encontrarse en este la extref:{handbook}bsdinstall/[entra de manual acerca de instalar FreeBSD, bsdinstall].
=== ¿Qué debo hacer si la imagen de instalación no arranca?
@@ -423,7 +409,7 @@ Cuando use un cliente de FTP por línea de comandos, escriba _binary_ en la pant
=== ¿Cuáles son las instrucciones para instalar FreeBSD?
-Las instrucciones de instalación pueden encontrarse en link:{handbook}#bsdinstall/[la entrada del manual acerca de instalar FreeBSD].
+Las instrucciones de instalación pueden encontrarse en extref:{handbook}bsdinstall/[la entrada del manual acerca de instalar FreeBSD, bsdinstall].
=== ¿Cuáles son los requisitos mínimos para correr FreeBSD?
@@ -431,7 +417,7 @@ FreeBSD requiere una PC 486 o mejor PC, 64 MB o más de RAM, y como mínimo 1.1
=== ¿Como puedo hacer mi propia versión personalizada o disco de instalación?
-Medios de instalación personalizados de FreeBSD pueden crearse compilando una versión personalizada. Siga las instrucciones en el artículo de link:{releng}[Ingeniería de Lanzamientos ].
+Medios de instalación personalizados de FreeBSD pueden crearse compilando una versión personalizada. Siga las instrucciones en el artículo de extref:{releng}[Ingeniería de Lanzamientos ].
=== ¿Puede Windows coexistir con FreeBSD?
@@ -527,7 +513,7 @@ PAE no es muy usado hoy en día porque la mayoría del hardware x86 nuevo tambi
==== ¿Soporta FreeBSD otras arquitecturas aparte de x86?
-Si. FreeBSD divide el soporte en múltiples categorías. Las arquitecturas de Categoría 1, tales como i386 o amd64; están totalmente soportadas. Las categorías 2 y 3 están soportadas en una base del mejor esfuerzo. Una explicación completa del sistema de categorías esta disponible en la link:{committers-guide}#archs/[Guia del Committer.]
+Si. FreeBSD divide el soporte en múltiples categorías. Las arquitecturas de Categoría 1, tales como i386 o amd64; están totalmente soportadas. Las categorías 2 y 3 están soportadas en una base del mejor esfuerzo. Una explicación completa del sistema de categorías esta disponible en la extref:{committers-guide}[Guia del Committer., archs]
Una lista completa de arquitecturas soportadas puede encontrarse en la http://www.FreeBSD.org/platforms/[página de plataformas.]
@@ -702,7 +688,7 @@ Los desarrolladores de FreeBSD están interesados en estos errores, pero necesit
El kernel de FreeBSD solo permite que exista un cierto número de procesos en un punto determinado del tiempo. El número esta basado en la variable de man:sysctl[8]`kern.maxusers`. `kern.maxusers` también afecta varios otros límites del kernel, tales como los buffers de red. Si la máquina esta bajo una carga intensiva, incremente `kern.maxusers`. Esto incrementara estos otros límites del sistema, además del número máximo de procesos.
-Para ajustar el valor de `kern.maxusers`, vea la sección link:{handbook}#kern-maxfiles[Límites de proceso/archivo] del manual. Mientras que esa sección se refiere a archivos abierto, los mismos límites aplican para los procesos.
+Para ajustar el valor de `kern.maxusers`, vea la sección extref:{handbook}config-tuning[Límites de proceso/archivo, kern-maxfiles] del manual. Mientras que esa sección se refiere a archivos abierto, los mismos límites aplican para los procesos.
Si la máquina tiene una carga ligera pero esta corriendo número muy alto de proceso, ajuste la variable `kern.maxproc` definiendola en [.filename]#/boot/loader.conf#. La variable no se ajustara hasta que el sistema se reinicie. Para más información acerca de ajustar variables, vea man:loader.conf[5]. Si estos procesos están siendo corridos por un solo usuario, ajuste `kern.maxprocperuid` para que sea uno menos que el nuevo valor de `kern.maxproc`. Debe ser al menos uno menos porque hay un programa del sistema, man:init[8], que debe estar corriendo constantemente.
@@ -732,7 +718,7 @@ Luego de una instalación de cero de FreeBSD, también es posible que la informa
=== ¿Por qué file: table is full aparece repetidamente en dmesg8?
-Este mensaje de error indica que el número de descriptores de archivo disponibles en el sistema se agoto. Vea la subsección link:{handbook}#kern-maxfiles[kern.maxfiles] de la sección link:{handbook}#configtuning-kernel-limits/[Ajustando límites del kernel] del manual para una discusión y una solución.
+Este mensaje de error indica que el número de descriptores de archivo disponibles en el sistema se agoto. Vea la subsección extref:{handbook}config-tuning[kern.maxfiles, kern-maxfiles] de la sección extref:{handbook}config-tuning/[Ajustando límites del kernel, configtuning-kernel-limits] del manual para una discusión y una solución.
=== ¿Por qué el reloj de mi computadora tiene el tiempo incorrecto?
@@ -830,9 +816,9 @@ FreeBSD soporta paquetes binarios comprimidos para instalar y desinstalar ports
Cualquiera de los métodos listados aquí funciona:
-* Use portsnap para la mayoría de los casos. Vea link:{handbook}#ports-using/[Usando la colección de Ports] para instrucciones acerca de como usar esta herramienta.
-* Use SVN si se necesitan parches personalizados para el árbol de ports. Vea link:{handbook}#svn/[Usando Subversion] para más detalles.
-* Use CTM, como se describe en link:{handbook}#ctm/[Usando CTM] para recibir parches por correo electrónico sobre una conexión a internet poco confiable.
+* Use portsnap para la mayoría de los casos. Vea extref:{handbook}ports/[Usando la colección de Ports, ports-using] para instrucciones acerca de como usar esta herramienta.
+* Use SVN si se necesitan parches personalizados para el árbol de ports. Vea extref:{handbook}mirrors/[Usando Subversion, svn] para más detalles.
+* Use CTM, como se describe en extref:{handbook}[Usando CTM] para recibir parches por correo electrónico sobre una conexión a internet poco confiable.
=== ¿FreeBSD soporta Java?
@@ -840,7 +826,7 @@ Si. Vea https://www.FreeBSD.org/java/[http://www.FreeBSD.org/java/] para más in
=== ¿Porque no puedo compilar este port en mi máquina 9.X -, o 10.X -STABLE?
-Si la versión de FreeBSD instalada se atrasa significativamente de _-CURRENT_ o _-STABLE_, actualice la colección de ports usando las instrucciones en link:{handbook}#ports-using/[Usando la colección de ports]. Si el sistema esta actualizado, alguien puede haber commiteado un cambio al port que funciona para _-CURRENT_ pero que rompió el port para _-STABLE_. https://bugs.FreeBSD.org/submit/[Envíe] un reporte de errores, dado que se supone que la colección de ports funcione tanto para la rama _-CURRENT_ como para _-STABLE_.
+Si la versión de FreeBSD instalada se atrasa significativamente de _-CURRENT_ o _-STABLE_, actualice la colección de ports usando las instrucciones en extref:{handbook}ports/[Usando la colección de ports, ports-using]. Si el sistema esta actualizado, alguien puede haber commiteado un cambio al port que funciona para _-CURRENT_ pero que rompió el port para _-STABLE_. https://bugs.FreeBSD.org/submit/[Envíe] un reporte de errores, dado que se supone que la colección de ports funcione tanto para la rama _-CURRENT_ como para _-STABLE_.
=== Acabo de intentar compilar INDEX usando make index y fallo. ¿Porque?
@@ -850,7 +836,7 @@ Hay raras ocurrencias en las que [.filename]#INDEX# no compilara debido a casos
=== He actualizado el código fuente ¿Como actualizo mis ports instalados?
-FreeBSD no incluye una herramienta para actualizar ports, pero si tiene herramientas para hacer el proceso de actualización un poco más fácil. Herramientas adicionales están disponibles para simplificar el manejo de ports y son descriptas en la sección link:{handbook}#ports-using/[Actualizando ports]en el manual de FreeBSD.
+FreeBSD no incluye una herramienta para actualizar ports, pero si tiene herramientas para hacer el proceso de actualización un poco más fácil. Herramientas adicionales están disponibles para simplificar el manejo de ports y son descriptas en la sección extref:{handbook}ports/[Actualizando ports, ports-using] en el manual de FreeBSD.
=== ¿Es necesario que recompile todos los ports cada vez que hago una actualización a una versión mayor?
@@ -858,7 +844,7 @@ FreeBSD no incluye una herramienta para actualizar ports, pero si tiene herramie
Cuando el sistema se actualiza, varias librerías compartidas, módulos cargables y otras partes del sistema serán reemplazadas por versiones más nuevas. Las aplicaciones que estén vinculadas contra las version más viejas pueden fallar al iniciar o, en otros casos, fallar al funcionar con propiedad.
-Para más información, vea link:{handbook}#freebsdupdate-upgrade[la sección acerca de actualizaciones] en el manual de FreeBSD.
+Para más información, vea extref:{handbook}updating-upgrading[la sección acerca de actualizaciones, freebsdupdate-upgrade] en el manual de FreeBSD.
=== ¿Debo recompilar todos los ports cada vez que realizo una actualización a una versión menor?
@@ -879,14 +865,14 @@ Para crear CDs de audio a partir de archivos MIDI, primero instale package:audio
% timidity -Ow -s 44100 -o /tmp/juke/01.wav 01.mid
....
-Los archivos WAV pueden posteriormente convertirse a otros formatos o grabarse en CDs de audio, como se describe en el link:{handbook}#creating-cds/[manual de FreeBSD].
+Los archivos WAV pueden posteriormente convertirse a otros formatos o grabarse en CDs de audio, como se describe en el extref:{handbook}disks/[manual de FreeBSD, creating-cds].
== Configuración del Kernel
[[make-kernel]]
=== Quisiera personalizar mi kernel. ¿Es esto difícil?
-¡En absoluto! Vea la link:{handbook}#kernelconfig/[sección del manual acerca de configuración del kernel].
+¡En absoluto! Vea la extref:{handbook}kernelconfig/[sección del manual acerca de configuración del kernel, kernelconfig].
[NOTE]
====
@@ -932,7 +918,7 @@ Reemplaze _accf_httpd ipfw_ con una lista de los módulos que necesita. Solo los
Los dispositivos innecesarios pueden ser removidos del kernel para reducir aún más su tamaño. Vea <<make-kernel>> para más información.
-Para que estas opciones hagan efecto, siga las instrucciones para link:{handbook}#kernelconfig-building/[compilar y instalar] el nuevo kernel.
+Para que estas opciones hagan efecto, siga las instrucciones para extref:{handbook}kernelconfig/[compilar y instalar, kernelconfig-building] el nuevo kernel.
Para referencias, el kernel de FreeBSD 11 en amd64 ([.filename]#/boot/kernel/kernel#) ocupa aproximadamente approximately 25 MB.
@@ -962,7 +948,7 @@ kern.sched.name: ULE
=== ¿Como puedo agregar mi nuevo disco duro a mi sistema FreeBSD?
-Vea la sección link:{handbook}#disks-adding/[Añadir discos] en el manual de FreeBSD.
+Vea la sección extref:{handbook}disks/[Añadir discos, disks-adding] en el manual de FreeBSD.
=== ¿Como muevo mi sistema actual a mi nuevo y enorme disco?
@@ -1069,7 +1055,7 @@ Las particiones de DOS secundarias se encuentras luego de _todas_ las particione
=== ¿Existe un sistema de archivos criptográfico para FreeBSD?
-SI, man:gbde[8] y man:geli[8]. Vea la sección link:{handbook}#disks-encrypting[Encriptar particiones de disco] del manual de FreeBSD.
+SI, man:gbde[8] y man:geli[8]. Vea la sección extref:{handbook}disks[Encriptar particiones de disco, disks-encrypting] del manual de FreeBSD.
=== ¿Cómo hago para arrancar FreeBSD y Linux usando GRUB?
@@ -1135,23 +1121,23 @@ Es una buena idea agregar una línea a [.filename]#/etc/fstab# (vea man:fstab[5]
=== ¿Por qué obtengo Incorrect super block al montar un CD?
-El tipo de dispositivo a montar debe estar especificado. Esto se describe en la sección del manual acerca de link:{handbook}#mounting-cd[Usar CDs de datos].
+El tipo de dispositivo a montar debe estar especificado. Esto se describe en la sección del manual acerca de extref:{handbook}disks[Usar CDs de datos, mounting-cd].
=== ¿Por qué obtengo Device not configured al montar un CD?
-Esto usualmente significa que no hay CD en el dispositivo, o que el dispositivo no es visible en el bus. Refiérase a la sección link:{handbook}#mounting-cd[Usando CDs de datos] del manual para una discusión detallada de este problema.
+Esto usualmente significa que no hay CD en el dispositivo, o que el dispositivo no es visible en el bus. Refiérase a la sección extref:{handbook}disks[Usando CDs de datos, mounting-cd] del manual para una discusión detallada de este problema.
=== ¿Por qué todos los caracteres no ingleses en los nombres de archivo se muestran como ? en mis CDs cuando los monto en FreeBSD?
-El CD probablemente use la extensión "Joliet" para guardar información acerca de archivos y directorios. Esto se discute en la sección del manual link:{handbook}#mounting-cd[Usando CDs de datos].
+El CD probablemente use la extensión "Joliet" para guardar información acerca de archivos y directorios. Esto se discute en la sección del manual extref:{handbook}disks[Usando CDs de datos, mounting-cd].
=== Un CD grabado bajo FreeBSD no puede ser leído bajo ningún otro sistema operativo. ¿Porque?
-Esto significa que un archivo crudo fue grabado al CD, en lugar de crear un sistema de archivos ISO 9660. Dele un vistazo a la sección del manual acerca de link:{handbook}#mounting-cd[Utilizar CDs de datos].
+Esto significa que un archivo crudo fue grabado al CD, en lugar de crear un sistema de archivos ISO 9660. Dele un vistazo a la sección del manual acerca de extref:{handbook}disks[Utilizar CDs de datos, mounting-cd].
=== ¿Como puedo crear una imagen de un CD de datos?
-Esto se dicute en la sección del manual acerca de link:{handbook}#mkisofs[Escribir datos a un sistema de archivos ISO]. Para más información acerca de trabajar con CD-ROMs, vea la link:{handbook}#creating-cds/[sección acerca de crear CDs] en el capítulo de almacenamiento en el manual.
+Esto se dicute en la sección del manual acerca de extref:{handbook}disks[Escribir datos a un sistema de archivos ISO, mkisofs]. Para más información acerca de trabajar con CD-ROMs, vea la extref:{handbook}disks/[sección acerca de crear CDs, creating-cds] en el capítulo de almacenamiento en el manual.
=== ¿Porque no puedo hacer mount a un CD de audio?
@@ -1217,7 +1203,7 @@ Note que Soft Updates puede retrasar la liberación de espacio en el disco y que
=== ¿Como agrego más espacio swap?
-Esta sección link:{handbook}#adding-swap-space/[del manual] describe como hacer esto.
+Esta sección extref:{handbook}config-tuning/[del manual, adding-swap-space] describe como hacer esto.
=== ¿Por qué FreeBSD ve mi disco como mas pequeño de lo que el fabricante dice que es?
@@ -1352,11 +1338,11 @@ Luego de realizar estos pasos, edite [.filename]#/etc/rc.conf# para arreglar el
=== ¿Por qué tengo problemas para configurar mi impresora?
-Vea la link:{handbook}#printing/[entrada del manual acerca de imprimir] para consejos sobre como solucionar el problema.
+Vea la extref:{handbook}printing/[entrada del manual acerca de imprimir, printing] para consejos sobre como solucionar el problema.
=== ¿Como puedo corregir los mapeos del teclado para mi sistema?
-Vea la sección del manual acerca de link:{handbook}#using-localization/[utilizar localización], específicamente la sección acerca de link:{handbook}#setting-console[configuración de la consola].
+Vea la sección del manual acerca de extref:{handbook}l10n/[utilizar localización, using-localization], específicamente la sección acerca de extref:{handbook}l10n[configuración de la consola, setting-console].
=== ¿Por qué no consigo que las quotas de usuario funcionen adecuadamente?
@@ -1367,7 +1353,7 @@ Vea la sección del manual acerca de link:{handbook}#using-localization/[utiliza
options QUOTA
....
+
-Vea la link:{handbook}#quotas/[entrada de manual acerca de quotas] para más detalles.
+Vea laextref:{handbook}disks/[entrada de manual acerca de quotas, quotas] para más detalles.
. No ponga quotas sobre [.filename]#/#.
. Agregue el archivo de quota en el sistema de archivo en que se van a aplicar las quotas:
+
@@ -1415,7 +1401,7 @@ Si todavía se le pide la contraseña de `root` al ingresar en modo de un solo u
[NOTE]
====
-Si la partición raíz no puede ser montada en modo de un solo usuario, es posible que las particiones se encuentren encriptadas y es imposible montarlas sin las llaves de acceso. Para más información vea la sección acerca de discos encriptados en el link:{handbook}#disks-encrypting/[manual] de FreeBSD.
+Si la partición raíz no puede ser montada en modo de un solo usuario, es posible que las particiones se encuentren encriptadas y es imposible montarlas sin las llaves de acceso. Para más información vea la sección acerca de discos encriptados en el extref:{handbook}disks/[manual, disks-encrypting] de FreeBSD.
====
=== ¿Como prevengo que ControlAltDelete borre el sistema?
@@ -1480,7 +1466,7 @@ Respuesta larga: FreeBSD deriva sus lanzamientos actuales de uno de dos lugares.
Cuando esta a punto de hacerse un lanzamiento, la rama desde la cual sera derivada debe pasar por un cierto proceso. Parte de este proceso es un congelamiento de código. Cuando el mismo se inicia, el nombre de la rama se cambia para reflejar que esta a punto de convertirse en una versión. Por ejemplo, si la rama se solía llamar 6.2-STABLE, su nombre sera cambiado a 6.3-PRERELEASE para indicar el congelamiento de código y remarcar que habrá un testo extra pre-lanzamiento. Las correcciones de errores pueden seguir siendo commiteadas para formar parte del lanzamiento. Cuando el código fuente esta en forma para ser lanzado el nombre sera cambiado a 6.3-RC para indicar que se esta por hacer un lanzamiento a partir del mismo. Una vez en la fase de RC, solo los errores más críticos serán reparados. Una vez que el lanzamiento (6.3-RELEASE en este ejemplo) y la rama de la versión se hayan hecho, la rama sera renombrada a 6.3-STABLE.
-Para más información acerca de números de version y varias ramas de Subversion, vea el artículo de link:{releng}[Ingenieria de lanzamientos ].
+Para más información acerca de números de version y varias ramas de Subversion, vea el artículo de extref:{releng}[Ingenieria de lanzamientos ].
=== He intentado instalar un nuevo kernel y las chflags1 fallaron. ¿Como soluciono esto?
@@ -1578,7 +1564,7 @@ Instale Xorg desde los paquetes de FreeBSD:
# pkg install xorg
....
-Luego de la instalación de Xorg, siga las instrucciones de la sección link:{handbook}#x-config[Configuración de X11] del manual de FreeBSD.
+Luego de la instalación de Xorg, siga las instrucciones de la sección extref:{handbook}x11[Configuración de X11, x-config] del manual de FreeBSD.
=== He intentado correr X, pero obtengo el error No devices detected. cuando escribo startx. ¿Qué hago ahora?
@@ -1792,7 +1778,7 @@ Escriba `xmodmap -e "pointer = 3 2 1"`. Añada este comando a [.filename]#~/.xin
=== ¿Como instalo una splash screen y donde puedo encontrarlas?
-La respuesta detallada a esta pregunta puede encontrarse en la sección link:{handbook}#boot-splash[Splash Screens en tiempo de arranque] del manual de FreeBSD.
+La respuesta detallada a esta pregunta puede encontrarse en la sección extref:{handbook}boot[Splash Screens en tiempo de arranque, boot-splash] del manual de FreeBSD.
=== ¿Puedo usar las teclas Windows en mi teclado en X?
@@ -1858,29 +1844,29 @@ Para ATI Rage 128 y Radeon vea man:ati[4], man:r128[4] y man:radeon[4].
=== ¿Donde puedo obtener información acerca del arranque sin disco rígido?
-"Arranque sin disco rígido" significa que la instalación de FreeBSD se arranca desde la red, y lee los archivos necesarios desde un servidor en lugar del disco rígido. Para más detalles, vea link:{handbook}#network-diskless[la entrada del manual acerca del arranque sin disco rígido].
+"Arranque sin disco rígido" significa que la instalación de FreeBSD se arranca desde la red, y lee los archivos necesarios desde un servidor en lugar del disco rígido. Para más detalles, vea extref:{handbook}advanced-networking[la entrada del manual acerca del arranque sin disco rígido, network-diskless].
=== ¿Puede una instalación de FreeBSD usarse como un router dedicado?
-Si. Vea la entrada del manual acerca de link:{handbook}#advanced-networking[redes avanzadas], específicamente la sección acerca de link:{handbook}#network-routing[routing y gateways].
+Si. Vea la entrada del manual acerca de extref:{handbook}advanced-networking[redes avanzadas, advanced-networking], específicamente la sección acerca de extref:{handbook}advanced-networking[routing y gateways, network-routing].
=== ¿Puedo conectar mi instalación de Windows a la Internet mediante FreeBSD?
Usualmente, la gente que pregunta esto tiene dos PCs en su casa, una con FreeBSD y una con alguna versión de Windows(TM) la idea es usar la instalación de FreeBSD para conectarse a la Internet y así poder usar Internet desde la instalación de Windows(TM) a través de FreeBSD. Esto es únicamente un caso especial de la pregunta anterior y funciona perfectamente bien.
-Los usuarios de dialup deben usar `-nat` y ajustar `gateway_enable` a _YES_ en [.filename]#/etc/rc.conf#. Para más información, vea man:ppp[8] o la link:{handbook}#userppp[entrada del manual acerca de PPP de usuario].
+Los usuarios de dialup deben usar `-nat` y ajustar `gateway_enable` a _YES_ en [.filename]#/etc/rc.conf#. Para más información, vea man:ppp[8] o la extref:{handbook}ppp-and-slip[entrada del manual acerca de PPP de usuario, userppp].
-Si la conexión a Internet es sobre Ethernet, use man:natd[8]. Puede encontrarse un tutorial en la sección link:{handbook}#network-natd[natd] del manual.
+Si la conexión a Internet es sobre Ethernet, use man:natd[8]. Puede encontrarse un tutorial en la sección extref:{handbook}[natd, network-natd] del manual.
=== ¿FreeBSD soporta PPP?
Si. man:ppp[8] provee soporte para conexiones entrantes y salientes.
-Para más información acerca de como usar esto, vea el link:{handbook}#ppp-and-slip[capítulo del manual acerca de PPP].
+Para más información acerca de como usar esto, vea el extref:{handbook}ppp-and-slip[capítulo del manual acerca de PPP, ppp-and-slip].
=== ¿FreeBSD soporta NAT o Masquerading?
-Si. Para instrucciones acerca de como usar NAT sobre una conexión PPP, vea la link:{handbook}#userppp[entrada de manual acerca de PPP]. Para usar NAT sobre otro tipo de conección de red, vea la sección acerca de link:{handbook}#network-natd[natd] en el manual.
+Si. Para instrucciones acerca de como usar NAT sobre una conexión PPP, vea la extref:{handbook}ppp-and-slip[entrada de manual acerca de PPP, userppp]. Para usar NAT sobre otro tipo de conección de red, vea la sección acerca de extref:{handbook}[natd, network-natd] en el manual.
=== ¿Como configuro aliases de Ethernet?
@@ -1898,7 +1884,7 @@ De otro modo, especifique la dirección de red y netmask de la manera usual:
# ifconfig ed0 alias 172.16.141.5 netmask 0xffffff00
....
-Puede encontrarse más información en el manual link:{handbook}#configtuning-virtual-hosts[Handbook] de FreeBSD.
+Puede encontrarse más información en el manual extref:{handbook}config-tuning[Handbook, configtuning-virtual-hosts] de FreeBSD.
=== ¿Por qué no puedo realizar un montado NFS desde una instalación Linux?
@@ -1911,7 +1897,7 @@ Algunas versiones del código NFS de Linux(TM) solo aceptan pedidos de montaje d
=== ¿Porque mountd continua diciéndome can't change attributes (que no puedo cambiar atributos) y que tengo una bad exports list (lista de exports mala) en mi servidor NFS de FreeBSD?
-El problema mas frecuente es no entender el formato correcto de [.filename]#/etc/exports#. Revise man:exports[5] y la entrada de link:{handbook}#network-nfs[NFS] en el manual, especialmente la sección acerca de link:{handbook}#configuring-nfs[configurar NFS].
+El problema mas frecuente es no entender el formato correcto de [.filename]#/etc/exports#. Revise man:exports[5] y la entrada de extref:{handbook}network-servers[NFS, network-nfs] en el manual, especialmente la sección acerca de extref:{handbook}[configurar NFS, configuring-nfs].
=== ¿Como habilito soporte para IP multicast?
@@ -1919,7 +1905,7 @@ Instale el paquete o port package:net/mrouted[] y añada `mrouted_enable="YES"`
=== ¿Porque tengo que usar FQDN para hosts en mi sitio?
-Vea la respuesta en el link:{handbook}#mail-trouble[manual] de FreeBSD.
+Vea la respuesta en el extref:{handbook}mail[manual, mail-trouble] de FreeBSD.
=== ¿Porque obtengo un error, Permission denied, para todas las operaciones de red?
@@ -1934,7 +1920,7 @@ Si el firewall esta mal configurado, restaure la operabilidad de la red escribie
Considere ajustar `firewall_type="open"` en [.filename]#/etc/rc.conf#.
-Para más información acerca de configurar este firewall vea el link:{handbook}#firewalls-ipfw[capítulo del manual].
+Para más información acerca de configurar este firewall vea el extref:{handbook}firewalls[capítulo del manual, firewalls-ipfw].
=== ¿Por qué mi regla fwd de ipfw para redirigir un servicio a otra maquina no funciona?
@@ -2093,7 +2079,7 @@ Alguna gente usa `toor` para tareas diarias de `root` con un shell no estándar,
=== No puedo hacer que ppp8 funcione. ¿Qué estoy haciendo mal?
-Primero, lea man:ppp[8] y la link:{handbook}#userppp[sección del manual sobre PPP ]. Para asistir en la solución de problemas, habilite los logs con el siguiente comando:
+Primero, lea man:ppp[8] y la extref:{handbook}ppp-and-slip[sección del manual sobre PPP, userppp]. Para asistir en la solución de problemas, habilite los logs con el siguiente comando:
[.programlisting]
....
@@ -2143,7 +2129,7 @@ Otra razón para que la línea de la ruta por defecto falte es que se haya añad
delete ALL
....
-Si este es el caso, vuelva a la sección link:{handbook}#userppp-final[Configuración final del sistema] del manual.
+Si este es el caso, vuelva a la sección extref:{handbook}ppp-and-slip[Configuración final del sistema, userppp-final] del manual.
=== ¿Qué significa No route to host?
@@ -2164,7 +2150,7 @@ delete ALL
add 0 0 HISADDR
....
-Vea la sección sobre link:{handbook}#userppp-dynamicip[PPP y direcciones de IP dinámicas] del manual para más detalles.
+Vea la sección sobre extref:{handbook}[PPP y direcciones de IP dinámicas, userppp-dynamicip] del manual para más detalles.
=== ¿Por qué mi conexión se corta luego de 3 minutos?
@@ -2339,7 +2325,7 @@ set dfilter 3 permit 0/0 0/0
Esto no siempre es aceptable, dado que romperá las capacidades de demanda de marcado. La mayoría de los programas necesitaran una búsqueda de DNS antes de hacer otras cosas relacionadas con la red.
-En el caso del DNS, intente determinar que es lo que esta realmente intentando resolver un nombre de host. La mayoría del tiempo, Sendmail es el culpable. Asegúrese de configurar Sendmail para que no realize ninguna búsqueda de DNS en su archivo de configuración. Vea la sección acerca de link:{handbook}#smtp-dialup[usar email con una conexión de dialup] en el manual de FreeBSD para los detalles. Probablemente también quiera además agregar la siguiente línea a [.filename]#.mc#:
+En el caso del DNS, intente determinar que es lo que esta realmente intentando resolver un nombre de host. La mayoría del tiempo, Sendmail es el culpable. Asegúrese de configurar Sendmail para que no realize ninguna búsqueda de DNS en su archivo de configuración. Vea la sección acerca de extref:{handbook}mail[usar email con una conexión de dialup, smtp-dialup] en el manual de FreeBSD para los detalles. Probablemente también quiera además agregar la siguiente línea a [.filename]#.mc#:
[.programlisting]
....
@@ -2448,7 +2434,7 @@ Esta sección responde preguntas comunes acerca de comunicaciones en serie con F
=== ¿Qué tarjetas en serie multi-puerto están soportadas por FreeBSD?
-Hay una lista de las mismas en el capítulo link:{handbook}#serial[Comunicaciones en serie] del manual.
+Hay una lista de las mismas en el capítulo extref:{handbook}serialcomms[Comunicaciones en serie, serial] del manual.
Las tarjetas multipuertos PCI que estén basadas en 16550 o clones están soportadas sin ningún esfuerzo extra.
@@ -2458,7 +2444,7 @@ Vea man:uart[4] and man:sio[4] para obtener más información acerca de configur
=== ¿Como hago que boot: prompt se muestre en la consola de serie?
-Vea link:{handbook}#serialconsole-setup[esta sección del manual].
+Vea extref:{handbook}serialcomms[esta sección del manual, serialconsole-setup].
=== ¿Cómo puedo saber si FreeBSD encontró mis puertos en serie o tarjetas de modem?
@@ -2515,15 +2501,15 @@ Estas banderas indican que el puerto maestro tiene un número menor `7` (`0x700`
=== ¿Puedo ajustar los parámetros en serie por defecto para un port?
-Vea la sección link:{handbook}#serial-hw-config[Comunicaciones en serie]en el manual de FreeBSD.
+Vea la sección extref:{handbook}serialcomms[Comunicaciones en serie, serial-hw-config] en el manual de FreeBSD.
=== ¿Como puedo habilitar inicios de sesión por marcado en mi modem?
-Vea la sección acerca de link:{handbook}#dialup[Servicios de marcado] en el manual de FreeBSD.
+Vea la sección acerca de extref:{handbook}serialcomms[Servicios de marcado, dialup] en el manual de FreeBSD.
=== ¿Como puedo conectar una terminal gregaria a mi instalación de FreeBSD?
-Esta información puede encontrarse en la sección link:{handbook}#term[Terminales] del manual de FreeBSD.
+Esta información puede encontrarse en la sección extref:{handbook}serialcomms[Terminales, term] del manual de FreeBSD.
=== ¿Por qué no puedo correr tip o cu?
@@ -2585,7 +2571,7 @@ La colección de ports también tiene package:emulators/dosbox[]. El foco princi
=== ¿Qué necesito para traducir un documento de FreeBSD a mi lenguaje nativo?
-Vea el link:{fdp-primer}translations[FAQ de Traducciones] en la documentación en el Primer de documentación FreeBSD.
+Vea el extref:{fdp-primer}[FAQ de Traducciones, translations] en la documentación en el Primer de documentación FreeBSD.
=== ¿Por qué mi correo a cualquier dirección con el dominio FreeBSD.org rebota?
@@ -2625,7 +2611,7 @@ Dibujos en Xfig y eps están disponibles en [.filename]#/usr/shared/examples/BSD
=== He visto un acrónimo u otro término en las listas de correo y no entiendo que significa. ¿Dónde tendría que buscar?
-Vea el link:{handbook}#freebsd-glossary/[glosario de FreeBSD].
+Vea el extref:{handbook}glossary/[glosario de FreeBSD, freebsd-glossary].
=== ¿Por qué debería preocuparme de que color es el cobertizo para bicicletas?
@@ -2762,7 +2748,7 @@ Además, la mayor parte del conocimiento general acerca de UNIX(TM)es directamen
=== ¿Cómo puedo contribuir a FreeBSD?
-Vea el artículo acerca de link:{contributing}[Contribuir a FreeBSD] para consejos específicos acerca de como hacer esto. ¡La ayuda es más que bienvenida!
+Vea el artículo acerca de extref:{contributing}[Contribuir a FreeBSD] para consejos específicos acerca de como hacer esto. ¡La ayuda es más que bienvenida!
=== ¿Qué son snapshots y lanzamientos?
@@ -2778,11 +2764,11 @@ En este momento, _-CURRENT_ es el torrente de desarrollo 11._X_; la rama _10-STA
=== ¿Puedo seguir -CURRENT con una conexión a Internet limitada?
-Si, esto puede hacerse _sin_ descargar el árbol de código fuente entero usando la link:{handbook}#ctm[utilidad CTM].
+Si, esto puede hacerse _sin_ descargar el árbol de código fuente entero usando la extref:{handbook}[utilidad CTM].
=== He escrito una extensión para el kernel ¿A quien se la envío?
-Vea el artículo en link:{contributing}[Contribuyendo a FreeBSD] para aprender como enviar código.
+Vea el artículo en extref:{contributing}[Contribuyendo a FreeBSD] para aprender como enviar código.
¡Y gracias por haberlo pensado!
@@ -2926,7 +2912,7 @@ Para encontrar el valor correcto de _N_, divida el tamaño de espacio de direcci
Este inocente y pequeño documento de Preguntas Frecuentes ha sido escrito, reescrito, editado, doblado, girado, mutilado, eviscerado, contemplado, confundido, reflexionado, regurgitado, reconstruido, castigado y revitalizado en el curso de la ultima década, por un equipo de cientos si no miles. Repetidamente.
-Queremos agradecerles a cada una de las personas responsables, y lo animamos a que link:{contributing}[se les una] para hacer este FAQ aún mejor.
+Queremos agradecerles a cada una de las personas responsables, y lo animamos a que extref:{contributing}[se les una] para hacer este FAQ aún mejor.
[bibliography]
[[bibliography]]
diff --git a/documentation/content/es/books/handbook/_index.adoc b/documentation/content/es/books/handbook/_index.adoc
index 5aa8eb01a8..d6ba6671f2 100644
--- a/documentation/content/es/books/handbook/_index.adoc
+++ b/documentation/content/es/books/handbook/_index.adoc
@@ -3,9 +3,9 @@ title: Manual de FreeBSD
authors:
- author: Proyecto de Documentación de FreeBSD
copyright: 1995-2020 Proyecto de Documentación de FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
next: books/handbook/preface
+isIndex: true
---
= Manual de FreeBSD
@@ -15,19 +15,32 @@ next: books/handbook/preface
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
+:images-path: books/handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumen
@@ -36,10 +49,10 @@ Resumen
'''
-include::content/es/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
-include::content/es/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
-include::content/es/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
-include::content/es/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/es/books/handbook/advanced-networking/_index.adoc b/documentation/content/es/books/handbook/advanced-networking/_index.adoc
index e64aa73e01..f4c60fb6da 100644
--- a/documentation/content/es/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/es/books/handbook/advanced-networking/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 29
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 29
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[advanced-networking-synopsis]]
== Resumen
@@ -1739,7 +1737,7 @@ La mayoría de los demás TAs probablemente también funcionen puesto que los fa
El problema que existe con los TAs es que, como sucede con los modems, se necesita tener una buena tarjeta serie instalada en el sistema.
-Se recomienda consultar el tutorial link:{serial-uart}[FreeBSD Serial Hardware] para obtener una comprensión detallada del funcionamiento de los dispositivos serie en FreeBSD y para comprender las diferencias entre puertos serie síncronos y asíncronos.
+Se recomienda consultar el tutorial extref:{serial-uart}[FreeBSD Serial Hardware] para obtener una comprensión detallada del funcionamiento de los dispositivos serie en FreeBSD y para comprender las diferencias entre puertos serie síncronos y asíncronos.
Un TA que se ejecuta a través de un puerto serie (asíncrono) está limitado a 115.2 Kbs, aunque la conexión RDSI sea de 128 Kbs. Para utilizar completamente el ancho de banda que RDSI proporciona, se debe conectar el TA a una tarjeta serie síncrona.
diff --git a/documentation/content/es/books/handbook/audit/_index.adoc b/documentation/content/es/books/handbook/audit/_index.adoc
index aa286d9bcc..957251daaa 100644
--- a/documentation/content/es/books/handbook/audit/_index.adoc
+++ b/documentation/content/es/books/handbook/audit/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/disks
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[audit-synopsis]]
== *
diff --git a/documentation/content/es/books/handbook/basics/_index.adoc b/documentation/content/es/books/handbook/basics/_index.adoc
index d26da3677e..e53ee436af 100644
--- a/documentation/content/es/books/handbook/basics/_index.adoc
+++ b/documentation/content/es/books/handbook/basics/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ports
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[basics-synopsis]]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/bibliography/_index.adoc b/documentation/content/es/books/handbook/bibliography/_index.adoc
index 8ea2c23a82..604f0e2c50 100644
--- a/documentation/content/es/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/es/books/handbook/bibliography/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/eresources
[[bibliography]]
= Bibliografía
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Aunque las páginas del manual proveen la referencia definitiva para partes individuales del sistema operativo FreeBSD, son notorias por no ilustrar como poner todas las piezas juntas para hacer que todo el sistema operativo funcione fácilmente. Debido a esto, no hay sustituto para un buen libro de administración de sistemas UNIX y un buen manual de usuario.
diff --git a/documentation/content/es/books/handbook/book.adoc b/documentation/content/es/books/handbook/book.adoc
index ec8cf05539..b73958407e 100644
--- a/documentation/content/es/books/handbook/book.adoc
+++ b/documentation/content/es/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: Manual de FreeBSD
authors:
- author: Proyecto de Documentación de FreeBSD
copyright: 1995-2020 Proyecto de Documentación de FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
---
@@ -12,55 +11,35 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:lang: es
-:toc-title: Tabla de contenidos
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apéndice
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
:book: true
:pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
-:chapters-path: content/es/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/es/mailing-lists.adoc[]
-include::../../../../shared/es/teams.adoc[]
-include::../../../../shared/es/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/es/mailing-lists.adoc[]
-include::../../../../shared/es/teams.adoc[]
-include::../../../../shared/es/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -75,91 +54,91 @@ toc::[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
// Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..27;37..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
-include::{chapters-path}install/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}install/_index.adoc[leveloffset=+1]
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
-include::{chapters-path}users/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}users/_index.adoc[leveloffset=+1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}jails/_index.adoc[leveloffset=+1]
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
-include::{chapters-path}vinum/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}vinum/_index.adoc[leveloffset=+1]
-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=7..18]
+include::{chapters-path}partiv.adoc[lines=15..26]
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..39;49..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
// Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
:sectnums!:
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/es/books/handbook/boot/_index.adoc b/documentation/content/es/books/handbook/boot/_index.adoc
index 16d1b8fd93..81c2ae45d6 100644
--- a/documentation/content/es/books/handbook/boot/_index.adoc
+++ b/documentation/content/es/books/handbook/boot/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/users
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/config/_index.adoc b/documentation/content/es/books/handbook/config/_index.adoc
index de998ae503..c58d0e8cd9 100644
--- a/documentation/content/es/books/handbook/config/_index.adoc
+++ b/documentation/content/es/books/handbook/config/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/boot
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/config/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[config-network-setup]]
== Configuración de Tarjetas de Red
diff --git a/documentation/content/es/books/handbook/cutting-edge/_index.adoc b/documentation/content/es/books/handbook/cutting-edge/_index.adoc
index 1d6194bd3d..51c285eb90 100644
--- a/documentation/content/es/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/es/books/handbook/cutting-edge/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/desktop/_index.adoc b/documentation/content/es/books/handbook/desktop/_index.adoc
index 686727d508..3f4b7f4cc6 100644
--- a/documentation/content/es/books/handbook/desktop/_index.adoc
+++ b/documentation/content/es/books/handbook/desktop/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/multimedia
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[desktop-synopsis]]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/disks/_index.adoc b/documentation/content/es/books/handbook/disks/_index.adoc
index 7e88b73f26..3541af2fc0 100644
--- a/documentation/content/es/books/handbook/disks/_index.adoc
+++ b/documentation/content/es/books/handbook/disks/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/geom
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[disks-synopsis]]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/eresources/_index.adoc b/documentation/content/es/books/handbook/eresources/_index.adoc
index 0b018cf297..0ca771a098 100644
--- a/documentation/content/es/books/handbook/eresources/_index.adoc
+++ b/documentation/content/es/books/handbook/eresources/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/pgpkeys
[[eresources]]
= Recursos en Internet
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
La velocidad del desarrollo de FreeBSD hace imposible el uso de medios impresos como forma de seguir los últimos desarrollos. Los recursos electrónicos son la mejor, y con frecuencia la única, manera de estar informados de los últimos avances. Dado que FreeBSD es sacado adelante mediante el trabajo de voluntarios la propia comunidad de usuarios suele ejercer las funciones de lo que sería un "departamento de soporte técnico", siendo el correo electrónico y USENET la manera más efectiva de contactar con esa comunidad.
diff --git a/documentation/content/es/books/handbook/firewalls/_index.adoc b/documentation/content/es/books/handbook/firewalls/_index.adoc
index 37cb4bcb5e..0240074937 100644
--- a/documentation/content/es/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/es/books/handbook/firewalls/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mail
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[firewalls-intro]]
== *
diff --git a/documentation/content/es/books/handbook/geom/_index.adoc b/documentation/content/es/books/handbook/geom/_index.adoc
index 6498576280..248e1675c1 100644
--- a/documentation/content/es/books/handbook/geom/_index.adoc
+++ b/documentation/content/es/books/handbook/geom/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/vinum
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[GEOM-synopsis]]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/install/_index.adoc b/documentation/content/es/books/handbook/install/_index.adoc
index c97d990404..2afe00631d 100644
--- a/documentation/content/es/books/handbook/install/_index.adoc
+++ b/documentation/content/es/books/handbook/install/_index.adoc
@@ -13,38 +13,35 @@ next: books/handbook/basics
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:lang: es
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/install/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/install/
-endif::[]
+:images-path: books/handbook/install/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/install/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[install-synopsis]]
== Sinopsis
@@ -2529,7 +2526,7 @@ Las imágenes se hacen en un formato ISO estándar; si va a grabarlas en cualqui
[NOTE]
====
-Si lo que quiere hacer es crear una «release» personalizada de FreeBSD consulte el artículo link:{releng}[Release Engineering].
+Si lo que quiere hacer es crear una «release» personalizada de FreeBSD consulte el artículo extref:{releng}[Release Engineering].
====
[[install-ftp]]
diff --git a/documentation/content/es/books/handbook/introduction/_index.adoc b/documentation/content/es/books/handbook/introduction/_index.adoc
index 058b850ece..5d46b95a6a 100644
--- a/documentation/content/es/books/handbook/introduction/_index.adoc
+++ b/documentation/content/es/books/handbook/introduction/_index.adoc
@@ -13,26 +13,35 @@ next: books/handbook/install
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:lang: es
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/handbook/introduction/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introcution-synopsis]]
== Sinopsis
@@ -50,7 +59,7 @@ Después de leer este capítulo sabrá:
[[nutshell]]
== Bienvenido a FreeBSD
-FreeBSD es un sistema operativo basado en 4.4BSD-Lite para ordenadores Intel (x86 e Itanium(R)), AMD64, Alpha(TM) y Sun UltraSPARC(R). Se está trabajando también en versiones para otras arquitecturas. También puede leer sobre <<history,la historia de FreeBSD>>, o sobre la <<relnotes,distribución actual>>. Si cree que puede ayudar al proyecto de algún modo (desarrollando código, donando hardware, dinero, etc) consulte el artículo link:{contributing}[Contribuir a FreeBSD].
+FreeBSD es un sistema operativo basado en 4.4BSD-Lite para ordenadores Intel (x86 e Itanium(R)), AMD64, Alpha(TM) y Sun UltraSPARC(R). Se está trabajando también en versiones para otras arquitecturas. También puede leer sobre <<history,la historia de FreeBSD>>, o sobre la <<relnotes,distribución actual>>. Si cree que puede ayudar al proyecto de algún modo (desarrollando código, donando hardware, dinero, etc) consulte el artículo extref:{contributing}[Contribuir a FreeBSD].
[[os-overview]]
=== ¿Qué puede hacer FreeBSD?
@@ -163,7 +172,7 @@ El código fuente de nuestro árbol que se halla bajo la GNU General Public Lice
[[development]]
=== El modelo de desarrollo de FreeBSD
-El desarrollo de FreeBSD es un proceso muy abierto y flexible: FreeBSD está literalmente compuesto de partes hechas por centenares de personas de todo el mundo, como puede verse en link:{contributors}[este texto]. la infraestructura de desarrollo del proyecto FreeBSD permite a estos cientos de desarrolladores trabajar a través de Internet. Estamos buscando constantemente de nuevos desarrolladores e ideas. Las personas interesadas en vincularse más al proyecto tienen que ponerse en contacto con nosotros en la {freebsd-hackers}. La {freebsd-announce} está a disposición de quienes deseen dar a conocer a otros usuarios de FreeBSD grandes áreas de trabajo.
+El desarrollo de FreeBSD es un proceso muy abierto y flexible: FreeBSD está literalmente compuesto de partes hechas por centenares de personas de todo el mundo, como puede verse en extref:{contributors}[este texto]. la infraestructura de desarrollo del proyecto FreeBSD permite a estos cientos de desarrolladores trabajar a través de Internet. Estamos buscando constantemente de nuevos desarrolladores e ideas. Las personas interesadas en vincularse más al proyecto tienen que ponerse en contacto con nosotros en la {freebsd-hackers}. La {freebsd-announce} está a disposición de quienes deseen dar a conocer a otros usuarios de FreeBSD grandes áreas de trabajo.
Veamos unas cuantas cosas útiles sobre el Proyecto FreeBSD y su proceso de desarrollo, ya sea trabajando de forma independiente o en estrecha cooperación:
@@ -176,7 +185,7 @@ Los _committers_ son la gente que tienen permisos de _escritura_ en el los fuent
El Core Team de FreeBSD[[development-core]]::
El _Core Team de FreeBSD_ sería el equivalente a una junta directiva si el Proyecto FreeBSD fuese una compañía. La tarea principal del Core Team es la de garantizar que el Proyecto como un todo tenga salud y se mueva en las direcciones adecuadas. Otra de sus funciones es invitar a desarrolladores comprometidos y responsables a que se unan a nuestro equipo, además de reclutar nuevos miembros del Core Team cuando alguno se va. El Core Team actual fue elegido entre un conjunto de candidatos committers en julio de 2008. Se celebran elecciones cada dos años.
+
-Algunos miembros del Core Team tienen también áreas específicas de responsabilidad, pues se encargan de garantizar que grandes secciones del sistema funcionen según lo previsto. Hay una lista completa de desarrolladores de FreeBSD con sus áreas de responsabilidad en la link:{contributors}[lista de colaboradores]. .
+Algunos miembros del Core Team tienen también áreas específicas de responsabilidad, pues se encargan de garantizar que grandes secciones del sistema funcionen según lo previsto. Hay una lista completa de desarrolladores de FreeBSD con sus áreas de responsabilidad en la extref:{contributors}[lista de colaboradores]. .
+
[NOTE]
====
diff --git a/documentation/content/es/books/handbook/jails/_index.adoc b/documentation/content/es/books/handbook/jails/_index.adoc
index b2b9e1d6d5..493b8b2388 100644
--- a/documentation/content/es/books/handbook/jails/_index.adoc
+++ b/documentation/content/es/books/handbook/jails/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mac
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/jails/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
-endif::[]
+:images-path: books/handbook/jails/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[jails-synopsis]]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/kernelconfig/_index.adoc b/documentation/content/es/books/handbook/kernelconfig/_index.adoc
index 3123939f98..97ce6c259d 100644
--- a/documentation/content/es/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/es/books/handbook/kernelconfig/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/printing
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/bibliography/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/l10n/_index.adoc b/documentation/content/es/books/handbook/l10n/_index.adoc
index eb6db40e02..66d0b1386e 100644
--- a/documentation/content/es/books/handbook/l10n/_index.adoc
+++ b/documentation/content/es/books/handbook/l10n/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/cutting-edge
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-synopsis]]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/linuxemu/_index.adoc b/documentation/content/es/books/handbook/linuxemu/_index.adoc
index 9064517aba..12178648b4 100644
--- a/documentation/content/es/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/es/books/handbook/linuxemu/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[linuxemu-synopsis]]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/mac/_index.adoc b/documentation/content/es/books/handbook/mac/_index.adoc
index 1830f725a1..b0db5af889 100644
--- a/documentation/content/es/books/handbook/mac/_index.adoc
+++ b/documentation/content/es/books/handbook/mac/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/audit
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-synopsis]]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/mail/_index.adoc b/documentation/content/es/books/handbook/mail/_index.adoc
index bdc7e41125..6ab186ea91 100644
--- a/documentation/content/es/books/handbook/mail/_index.adoc
+++ b/documentation/content/es/books/handbook/mail/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/network-servers
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mail-synopsis]]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/mirrors/_index.adoc b/documentation/content/es/books/handbook/mirrors/_index.adoc
index 20668a9abd..35f5959d58 100644
--- a/documentation/content/es/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/es/books/handbook/mirrors/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/bibliography
[[mirrors]]
= Cómo obtener FreeBSD
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mirrors-ftp]]
== Servidores FTP
diff --git a/documentation/content/es/books/handbook/multimedia/_index.adoc b/documentation/content/es/books/handbook/multimedia/_index.adoc
index 4dc9c814cc..19d2b542c3 100644
--- a/documentation/content/es/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/es/books/handbook/multimedia/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/kernelconfig
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/network-servers/_index.adoc b/documentation/content/es/books/handbook/network-servers/_index.adoc
index 7834c18fe3..023d4974a9 100644
--- a/documentation/content/es/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/es/books/handbook/network-servers/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/advanced-networking
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 28
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 28
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[network-servers-synopsis]]
== *
diff --git a/documentation/content/es/books/handbook/parti.adoc b/documentation/content/es/books/handbook/parti.adoc
index cf66c7acf8..0e6f13763d 100644
--- a/documentation/content/es/books/handbook/parti.adoc
+++ b/documentation/content/es/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
next: books/handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[getting-started]]
= Primeros pasos
@@ -17,4 +25,4 @@ Esta parte del manual de FreeBSD es para usuarios y administradores nuevos en Fr
Se ha intentado minimizar el número de referencias a otras secciones de este documento para evitar el salto entre páginas y facilitar la lectura continuada.
-include::content/es/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/es/books/handbook/partii.adoc b/documentation/content/es/books/handbook/partii.adoc
index e33d68ae10..a68130917d 100644
--- a/documentation/content/es/books/handbook/partii.adoc
+++ b/documentation/content/es/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
next: books/handbook/desktop
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[common-tasks]]
= Tareas comunes
@@ -17,4 +25,4 @@ Una vez tratados los aspectos más básicos, pasaremos a detallar alguna de las
Algunos de los capítulos recomiendan lecturas de capítulos anteriores, lo que se indica al inicio de cada capítulo.
-include::content/es/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/es/books/handbook/partiii.adoc b/documentation/content/es/books/handbook/partiii.adoc
index e7335de05e..4711b9921d 100644
--- a/documentation/content/es/books/handbook/partiii.adoc
+++ b/documentation/content/es/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
next: books/handbook/config
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[system-administration]]
= Administración del sistema.
@@ -11,4 +19,4 @@ Los restantes capítulos de este libro cubren todos los aspectos de administraci
Estos capítulos están diseñados para leerse cuando se necesita la información. No es necesario leerlos en un determinado orden ni es necesario leerlos todos antes de comenzar a usar FreeBSD.
-include::content/es/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/es/books/handbook/partiv.adoc b/documentation/content/es/books/handbook/partiv.adoc
index 5e592f3cad..8e8cbe38fe 100644
--- a/documentation/content/es/books/handbook/partiv.adoc
+++ b/documentation/content/es/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/cutting-edge
next: books/handbook/serialcomms
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[network-communication]]
= Comunicaciones en red
@@ -17,4 +25,4 @@ FreeBSD es uno de los sistemas operativos más utilizados como servidores en red
Estos capítulos están diseñados para leerse según van haciendo falta. No tienen por qué leerse en un determinado orden, ni tiene por qué leerlos todos antes de poder usar FreeBSD en un entorno de red.
-include::content/es/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/es/books/handbook/partv.adoc b/documentation/content/es/books/handbook/partv.adoc
index eb9ff5a94f..e1ef7ca109 100644
--- a/documentation/content/es/books/handbook/partv.adoc
+++ b/documentation/content/es/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
next: books/handbook/mirrors
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= Apéndices
-include::content/es/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/es/books/handbook/pgpkeys/_index.adoc b/documentation/content/es/books/handbook/pgpkeys/_index.adoc
index 5c7d222ed9..99d7835571 100644
--- a/documentation/content/es/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/es/books/handbook/pgpkeys/_index.adoc
@@ -9,28 +9,44 @@ next: books/handbook/freebsd-glossary
[[pgpkeys]]
= PGP keys
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
En caso de que necesites verificar una firma o enviar un mail encriptado a alguno de los responsables o miembros del core team, aquí tienes una serie de claves para uso.
diff --git a/documentation/content/es/books/handbook/ports/_index.adoc b/documentation/content/es/books/handbook/ports/_index.adoc
index b668f56b59..ceda5dba93 100644
--- a/documentation/content/es/books/handbook/ports/_index.adoc
+++ b/documentation/content/es/books/handbook/ports/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/x11
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ports-synopsis]]
== Sinopsis
@@ -352,7 +350,7 @@ Es posible que este directorio tambié contenga algún otro fichero necesario pa
* Un fichero [.filename]#pkg-descr#. Es una descripción más detallada del programa. En algunas ocasiones ocupa varias líneas.
* Un fichero [.filename]#pkg-plist#. Es una lista de todos los ficheros que instalará el port. También le indica al sistema de ports qué ficheros eliminar durante la desinstalación del programa.
-Algunos ports tienen otros ficheros, como [.filename]#pkg-message#. El sistema de ports los usa para gestionar situaciones especiales. Si desea conocer los detalles, incluso sobre los ports en general, consulte el libro link:{porters-handbook}[FreeBSD Porter's Handbook].
+Algunos ports tienen otros ficheros, como [.filename]#pkg-message#. El sistema de ports los usa para gestionar situaciones especiales. Si desea conocer los detalles, incluso sobre los ports en general, consulte el libro extref:{porters-handbook}[FreeBSD Porter's Handbook].
El port incluye las instrucciones necesarias para obtener software a partir del código fuente, pero no incluye el código. Puede obtener el código desde un CDROM o desde Internet. El código se distribuye del modo que el autor estime oportuno. Normalmente es un fichero tar comprimido con gzip, pero puede comprimirse con otra herramienta o incluso no estar comprimido. El código del programa, venga como venga, se llama «distfile». A continuación veremos los dos métodos de instalación de un port.
@@ -763,12 +761,12 @@ Si encuentra un port que no funciona hay varias cosas que puede hacer:
+
[NOTE]
====
-Algunos ports no son responsabilidad de un individuo sino de link:{mailing-list-faq}[una lista de correo.] Muchas, aunque no todas, tienen un aspecto parecido a mailto:freebsd-nombredelalista@FreeBSD.org[freebsd-nombredelalista@FreeBSD.org]. Por favor, téngalo en cuenta cuando envie ese correo sobre el port que no funciona.
+Algunos ports no son responsabilidad de un individuo sino de extref:{mailing-list-faq}[una lista de correo.] Muchas, aunque no todas, tienen un aspecto parecido a mailto:freebsd-nombredelalista@FreeBSD.org[freebsd-nombredelalista@FreeBSD.org]. Por favor, téngalo en cuenta cuando envie ese correo sobre el port que no funciona.
Hay un caso especial: Los ports que tienen como «mantainer» mailto:freebsd-ports@FreeBSD.org[freebsd-ports@FreeBSD.org] en realidad no son responsabilidad de nadie. Los parches y el soporte, en caso de existir, vienen de la comunidad de usuarios y desarrolladores que están suscritos a la lista. Por cierto, siempre hacen falta más voluntarios.
====
+
-Si no recibe respuesta utilice man:send-pr[1] para enviar un informe de errores. Consulte link:{problem-reports}[Cómo escribir informes de error])
+Si no recibe respuesta utilice man:send-pr[1] para enviar un informe de errores. Consulte extref:{problem-reports}[Cómo escribir informes de error])
. _Arreglarlo_. El «Porter's Handbook» incluye información detallada sobre la infraestructura de los ports, así que puede arreglar un port roto o incluso enviar su propio port.
. Descargue el paquete de algún sitio FTP. El servidor «principal» de la colección de paquetes está en el link:ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/[directorio de paquetes] de `ftp.FreeBSD.org` _pero asegúrese de mirar antes en la réplica más próxima_. Esta es una forma de instalar aplicaciones más fácil y más rápida. Instale el paquete mediante man:pkg_add[1].
diff --git a/documentation/content/es/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/es/books/handbook/ppp-and-slip/_index.adoc
index e95a6b009e..14747ab90c 100644
--- a/documentation/content/es/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/es/books/handbook/ppp-and-slip/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/firewalls
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/preface/_index.adoc b/documentation/content/es/books/handbook/preface/_index.adoc
index b27b049aa2..464a5f0171 100644
--- a/documentation/content/es/books/handbook/preface/_index.adoc
+++ b/documentation/content/es/books/handbook/preface/_index.adoc
@@ -11,17 +11,33 @@ next: books/handbook/parti
:toc: macro
:toclevels: 1
:icons: font
-:sectnums!:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-audience]]
== A quién va dirigido este texto
diff --git a/documentation/content/es/books/handbook/printing/_index.adoc b/documentation/content/es/books/handbook/printing/_index.adoc
index d50df5ae45..a0a9d6a535 100644
--- a/documentation/content/es/books/handbook/printing/_index.adoc
+++ b/documentation/content/es/books/handbook/printing/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/linuxemu
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/printing/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/security/_index.adoc b/documentation/content/es/books/handbook/security/_index.adoc
index 956e1a374e..33c19cccb8 100644
--- a/documentation/content/es/books/handbook/security/_index.adoc
+++ b/documentation/content/es/books/handbook/security/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/jails
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-synopsis]]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/serialcomms/_index.adoc b/documentation/content/es/books/handbook/serialcomms/_index.adoc
index 8cb867c5b5..6cd7c1029a 100644
--- a/documentation/content/es/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/es/books/handbook/serialcomms/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ppp-and-slip
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[serial-synopsis]]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/users/_index.adoc b/documentation/content/es/books/handbook/users/_index.adoc
index a288c4615f..94a8da206f 100644
--- a/documentation/content/es/books/handbook/users/_index.adoc
+++ b/documentation/content/es/books/handbook/users/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/security
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/users/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/users/
-endif::[]
+:images-path: books/handbook/users/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/users/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[users-synopsis]]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/vinum/_index.adoc b/documentation/content/es/books/handbook/vinum/_index.adoc
index 9c73b6c73b..7c2c1b475a 100644
--- a/documentation/content/es/books/handbook/vinum/_index.adoc
+++ b/documentation/content/es/books/handbook/vinum/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/virtualization
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/vinum/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/vinum/
-endif::[]
+:images-path: books/handbook/vinum/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/vinum/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[vinum-synopsis]]
== Sinopsis
diff --git a/documentation/content/es/books/handbook/virtualization/_index.adoc b/documentation/content/es/books/handbook/virtualization/_index.adoc
index 1c69c37ed9..777fbdfdc6 100644
--- a/documentation/content/es/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/es/books/handbook/virtualization/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/l10n
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/virtualization/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
-endif::[]
+:images-path: books/handbook/virtualization/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[virtualization-synopsis]]
== *
diff --git a/documentation/content/es/books/handbook/x11/_index.adoc b/documentation/content/es/books/handbook/x11/_index.adoc
index afc0c96710..d892016d58 100644
--- a/documentation/content/es/books/handbook/x11/_index.adoc
+++ b/documentation/content/es/books/handbook/x11/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tabla de contenidos
-:table-caption: Tabla
-:figure-caption: Figura
-:example-caption: Ejemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/es/mailing-lists.adoc[]
-include::shared/es/teams.adoc[]
-include::shared/es/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[x11-synopsis]]
== Sinopsis
diff --git a/documentation/content/fr/articles/building-products/_index.adoc b/documentation/content/fr/articles/building-products/_index.adoc
index 28622f82b5..cca14d5c35 100644
--- a/documentation/content/fr/articles/building-products/_index.adoc
+++ b/documentation/content/fr/articles/building-products/_index.adoc
@@ -5,7 +5,6 @@ authors:
email: jkoshy@FreeBSD.org
organizations:
- organization: Le Projet FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -18,30 +17,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
+:images-path: articles/building-products/
-
-ifeval::["{backend}" == "html5"]
-include::shared/fr/urls.adoc[]
-include::shared/fr/mailing-lists.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-:imagesdir: ../../../images/articles/building-products/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/fr/mailing-lists.adoc[]
-include::../../../../shared/fr/urls.adoc[]
-include::../../../../shared/releases.adoc[]
-:imagesdir: ../../../../static/images/articles/building-products/
endif::[]
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/articles/building-products/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -165,7 +160,7 @@ image::freebsd-organization.png[]
La résolution des conflits est assurée par une équipe ("Core Team") de neuf membres qui est élue par le groupe des committers.
-Les committers ne sont pas employés par FreeBSD. Il est exigé de la part des committers qu'ils prennent la responsabilité des changements qu'ils introduisent dans le code. Le link:{committers-guide}[Guide du Committer FreeBSD] <<ComGuide>> documente les règles et responsabilités des committers.
+Les committers ne sont pas employés par FreeBSD. Il est exigé de la part des committers qu'ils prennent la responsabilité des changements qu'ils introduisent dans le code. Le extref:{committers-guide}[Guide du Committer FreeBSD] <<ComGuide>> documente les règles et responsabilités des committers.
Le modèle de projet de FreeBSD est examiné en détails dans <<Nik2005>>.
@@ -183,7 +178,7 @@ image::freebsd-branches.png[]
Les lignes de code sont maintenues aussi longtemps qu'il existe des utilisateurs et des développeurs qui s'y intéressent.
-Les architectures machine sont groupées en "niveaux". Les architectures de premier niveau (_Tier 1_) sont entièrement supportées par l'équipe en charge des versions et l'équipe sécurité. Les architectures de second niveau (_Tier 2_) sont supportées dans la mesure du possible, et les architectures expérimentales représentent le _Tier 3_. La liste des link:{committers-guide}#archs[architectures supportées] est incluse dans la documentation FreeBSD.
+Les architectures machine sont groupées en "niveaux". Les architectures de premier niveau (_Tier 1_) sont entièrement supportées par l'équipe en charge des versions et l'équipe sécurité. Les architectures de second niveau (_Tier 2_) sont supportées dans la mesure du possible, et les architectures expérimentales représentent le _Tier 3_. La liste des extref:{committers-guide}[architectures supportées, archs] est incluse dans la documentation FreeBSD.
L'équipe en charge des versions publie une link:https://www.FreeBSD.org/releng/[feuille de route] pour les futures versions de FreeBSD sur la page web du projet. Les dates qui sont mentionnées sur la feuille de route ne sont pas des dates butoirs: les versions de FreeBSD sont délivrées lorsque son code et sa documentation sont prêts.
@@ -316,7 +311,7 @@ Faire valoir auprès de la communauté FreeBSD que votre société utilise FreeB
Soutenez les développeurs de FreeBSD::
Parfois la manière la plus directe pour qu'une fonctionnalité dont on a besoin soit incluse dans FreeBSD est d'aider un développeur qui travaille déjà sur un problème ayant un rapport avec cette fonctionnalité. Ces aides peuvent prendre plusieurs formes, depuis le don de matériel jusqu'à des donations financières. Dans certains pays, les donations au projet FreeBSD peuvent bénéficier d'avantages au niveau des impôts. Le projet a un link:https://www.FreeBSD.org/donations/[interlocuteur dédié] pour assister les donateurs. Le projet maintien également une page web sur laquelle les développeurs link:https://www.FreeBSD.org/donations/wantlist/[recensent leurs besoins].
+
-Le projet FreeBSD met un point d'honneur à link:{contributors}[remercier] tous les donnateurs sur son site web.
+Le projet FreeBSD met un point d'honneur à extref:{contributors}[remercier] tous les donnateurs sur son site web.
[[conclusion]]
== Conclusion
@@ -333,21 +328,21 @@ Nous avons passé en revue les caractéristiques du projet FreeBSD qui en font u
[[Com2004]] [Com2004] http://csdl.computer.org/comp/mags/so/2004/01/s1028.pdf[How is Open-Source Affecting Software Development?] Diomidis Spinellis. Clemens Szyperski.IEEE Computer Copyright(R) Jan/Feb 2004. IEEE Computer Society.
-[[ComGuide]] [ComGuide] link:{committers-guide}[Committer's Guide] The FreeBSD Project. Copyright(R) 2005.
+[[ComGuide]] [ComGuide] extref:{committers-guide}[Committer's Guide] The FreeBSD Project. Copyright(R) 2005.
[[Cov2005]] [Cov2005] http://www.coverity.com/news/nf_news_06_27_05_story_9.html[Coverity study on kernel security holes in Linux and FreeBSD]Coverity Inc.. Copyright(R) 2005.
[[GoldGab2005]] [GoldGab2005] http://dreamsongs.com/IHE/IHE.html[Innovation Happens Elsewhere: Open Source as Business Strategy] Ron Goldman. Richard Gabriel. Copyright(R) 2005. Morgan-Kaufmann.
-[[Hub1994]] [Hub1994] link:{contributing}[Contributing to the FreeBSD Project] Jordan Hubbard. Copyright(R) 1994-2005. The FreeBSD Project.
+[[Hub1994]] [Hub1994] extref:{contributing}[Contributing to the FreeBSD Project] Jordan Hubbard. Copyright(R) 1994-2005. The FreeBSD Project.
[[McKu1999]] [McKu1999] http://www.usenix.org/publications/library/proceedings/usenix99/mckusick.html[Soft Updates: A Technique for Eliminating Most Synchronous Writes in the Fast Filesystem] Kirk McKusick. Gregory Ganger. Copyright(R) 1999.
[[McKu1999-1]] [McKu1999-1] http://www.oreilly.com/catalog/opensources/book/kirkmck.html[Twenty Years of Berkeley Unix: From AT&T-Owned to Freely Redistributable] Marshall Kirk McKusick. http://www.oreilly.com/catalog/opensources/book/toc.html[Open Sources: Voices from the Open Source Revolution] O'Reilly Inc.. Copyright(R) 1993.
-[[Mon2005]] [Mon2005] link:{bsdl-gpl}[Why you should use a BSD style license for your Open Source Project] Bruce Montague. The FreeBSD Project. Copyright(R) 2005.
+[[Mon2005]] [Mon2005] extref:{bsdl-gpl}[Why you should use a BSD style license for your Open Source Project] Bruce Montague. The FreeBSD Project. Copyright(R) 2005.
-[[Nik2005]] [Nik2005] link:{dev-model}[A project model for the FreeBSD Project] Niklas Saers. Copyright(R) 2005. The FreeBSD Project.
+[[Nik2005]] [Nik2005] extref:{dev-model}[A project model for the FreeBSD Project] Niklas Saers. Copyright(R) 2005. The FreeBSD Project.
[[Nor1993]] [Nor1993] http://www.norvig.com/luv-slides.ps[Tutorial on Good Lisp Programming Style] Peter Norvig. Kent Pitman. Copyright(R) 1993.
@@ -355,4 +350,4 @@ Nous avons passé en revue les caractéristiques du projet FreeBSD qui en font u
[[Ray2004]] [Ray2004] http://www.catb.org/~esr/faqs/smart-questions.html[How to ask questions the smart way] Eric Steven Raymond. Copyright(R) 2004.
-[[RelEngDoc]] [RelEngDoc] link:{releng}[FreeBSD Release Engineering] Murray Stokely. Copyright(R) 2001. The FreeBSD Project.
+[[RelEngDoc]] [RelEngDoc] extref:{releng}[FreeBSD Release Engineering] Murray Stokely. Copyright(R) 2001. The FreeBSD Project.
diff --git a/documentation/content/fr/articles/committers-guide/_index.adoc b/documentation/content/fr/articles/committers-guide/_index.adoc
index 99d34e26f8..5489b13f68 100644
--- a/documentation/content/fr/articles/committers-guide/_index.adoc
+++ b/documentation/content/fr/articles/committers-guide/_index.adoc
@@ -3,7 +3,6 @@ title: Le Guide du Nouveau Committer
authors:
- author: Projet de Documentation de FreeBSD
copyright: 1999-2019 Projet de Documentation de FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "coverity", "ibm", "intel", "sparc", "general"]
---
@@ -16,29 +15,26 @@ trademarks: ["freebsd", "coverity", "ibm", "intel", "sparc", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
-
-ifeval::["{backend}" == "html5"]
+:images-path: articles/committers-guide/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/fr/mailing-lists.adoc[lines=11..-1]
-include::shared/fr/urls.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/fr/mailing-lists.adoc[lines=11..-1]
-include::../../../../shared/fr/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/fr/mailing-lists.adoc[lines=11..-1]
-include::../../../../shared/fr/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -215,7 +211,7 @@ Ce n'est pas dans les archives CVS que les modifications doivent être intégré
En cas de doute, demandez une validation !
. Respectez les responsables de la maintenance, s'il y en a.
+
-De nombreuses parties de FreeBSD n'"appartiennent" à personne, c'est-à-dire qu'il n'y aura personne pour pousser de hauts cris si vous faites des modifications sur "leur" terrain, mais il vaut mieux s'en assurer d'abord. Une de nos convention est de mettre une ligne indiquant qui maintient dans le [.filename]#Makefile# du paquetage ou de la sous-arborescence activement maintenue par une ou plusieurs personnes voyez link:{handbook}policies[http://www.FreeBSD.org/handbook/policies/] pour plus d'information à ce sujet. Quand il y a plusieurs personnes qui maintiennent une même section de code, les soumissions d'une de ces personnes sur ces sections doivent être revues par au moins une des autres personnes qui la maintiennent. Dans le cas où l'"attribution" n'est pas claire, vous pouvez aussi consulter les messages de CVS pour les fichiers concernés, pour voir si quelqu'un a travaillé dessus récemment ou travaille de façon prédominante sur ce domaine.
+De nombreuses parties de FreeBSD n'"appartiennent" à personne, c'est-à-dire qu'il n'y aura personne pour pousser de hauts cris si vous faites des modifications sur "leur" terrain, mais il vaut mieux s'en assurer d'abord. Une de nos convention est de mettre une ligne indiquant qui maintient dans le [.filename]#Makefile# du paquetage ou de la sous-arborescence activement maintenue par une ou plusieurs personnes voyez extref:{handbook}[http://www.FreeBSD.org/handbook/policies/] pour plus d'information à ce sujet. Quand il y a plusieurs personnes qui maintiennent une même section de code, les soumissions d'une de ces personnes sur ces sections doivent être revues par au moins une des autres personnes qui la maintiennent. Dans le cas où l'"attribution" n'est pas claire, vous pouvez aussi consulter les messages de CVS pour les fichiers concernés, pour voir si quelqu'un a travaillé dessus récemment ou travaille de façon prédominante sur ce domaine.
+
Il y a d'autres parties de FreeBSD qui sont contrôlées par quelqu'un qui gère tout un domaine de l'évolution de FreeBSD, l'internationalisation ou le réseau par exemple. Reportez-vous à link:{handbook#staff-who[http://www.FreeBSD.org/handbook/staff-who/] pour avoir plus d'informations à ce sujet.
. N'intervenez jamais directement sur les archives. Demandez à un responsable des archives de le faire.
diff --git a/documentation/content/fr/articles/contributing/_index.adoc b/documentation/content/fr/articles/contributing/_index.adoc
index 2abb4b80d9..61ae417b2a 100644
--- a/documentation/content/fr/articles/contributing/_index.adoc
+++ b/documentation/content/fr/articles/contributing/_index.adoc
@@ -2,7 +2,6 @@
title: Collaborer à FreeBSD
authors:
- author: Jordan Hubbard
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ieee", "general"]
---
@@ -15,26 +14,26 @@ trademarks: ["freebsd", "ieee", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
-
-ifeval::["{backend}" == "html5"]
-include::shared/fr/urls.adoc[]
-include::shared/fr/mailing-lists.adoc[lines=11..-1]
+:images-path: articles/contributing/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/fr/urls.adoc[]
-include::../../../../shared/fr/mailing-lists.adoc[lines=11..-1]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/fr/urls.adoc[]
-include::../../../../shared/fr/mailing-lists.adoc[lines=11..-1]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -68,7 +67,7 @@ La liste suivante de tâches et de sous-projets représente une sorte d'amalgame
De nombreuses personnes impliquées dans FreeBSD ne sont pas des programmeurs. Le projet comprend des rédacteurs de documentation, des concepteurs de site web, et des personnes assurant le support. La contribution de ces personnes se matérialise sous la forme d'un investissement en temps et une volonté d'apprendre.
. Lisez la FAQ et le Manuel régulièrement. Si quelque chose est mal expliquée, pas à jour ou tout simplement complètement faux, signalez-le nous. Mieux, envoyez nous un correctif (le SGML n'est pas difficile à apprendre, mais il n'y aucune objection à des soumissions en format ASCII).
-. Aidez à traduire la documentation FreeBSD dans votre langue. Si la documentation existe déjà dans votre langue, vous pouvez aider à traduire des documents supplémentaires ou contrôler que les traductions sont à jour. Consultez tout d'abord la link:{fdp-primer}[FAQ sur les traductions] dans l'Introduction au Projet de Documentation de FreeBSD. Notez que vous ne vous engagez pas à traduire chacun des documents FreeBSD ce faisant - en tant que volontaire, vous pouvez faire autant que vous le désirez. Une fois que quelqu'un commence à traduire, presque toujours d'autres personnes rejoindront l'effort. Si vous n'avez le temps et l'énergie pour ne traduire qu'une partie de la documentation, traduisez les instructions d'installation.
+. Aidez à traduire la documentation FreeBSD dans votre langue. Si la documentation existe déjà dans votre langue, vous pouvez aider à traduire des documents supplémentaires ou contrôler que les traductions sont à jour. Consultez tout d'abord la extref:{fdp-primer}[FAQ sur les traductions] dans l'Introduction au Projet de Documentation de FreeBSD. Notez que vous ne vous engagez pas à traduire chacun des documents FreeBSD ce faisant - en tant que volontaire, vous pouvez faire autant que vous le désirez. Une fois que quelqu'un commence à traduire, presque toujours d'autres personnes rejoindront l'effort. Si vous n'avez le temps et l'énergie pour ne traduire qu'une partie de la documentation, traduisez les instructions d'installation.
. Lisez la {freebsd-questions} et le news:comp.unix.bsd.freebsd.misc de temps en temps (ou même régulièrement). Il peut être très gratifiant de partager son expérience et d'aider les gens à résoudre leurs problèmes; parfois vous pourrez même apprendre quelque chose de nouveau! Ces forums peuvent être également une source d'idées sur ce qu'il faut améliorer.
[[ongoing-programmer-tasks]]
@@ -101,7 +100,7 @@ Les contributions au système tombent généralement dans une ou plusieurs des 5
[[contrib-general]]
=== Rapport de bogue et commentaires généraux
-Une idée ou une suggestion d'intérêt technique _général_ devrait être envoyée à la {freebsd-hackers}. De même, les personnes intéressées par de telles choses (et qu'un _grand_ volume de courrier électronique ne dérange pas) devraient s'abonner à la {freebsd-hackers} en envoyant un courrier électronique à {majordomo}. Voir le link:{handbook}#eresources-mail[Manuel FreeBSD] pour plus d'information à ce propos et sur les autres listes de diffusion.
+Une idée ou une suggestion d'intérêt technique _général_ devrait être envoyée à la {freebsd-hackers}. De même, les personnes intéressées par de telles choses (et qu'un _grand_ volume de courrier électronique ne dérange pas) devraient s'abonner à la {freebsd-hackers} en envoyant un courrier électronique à {majordomo}. Voir le extref:{handbook}eresources[Manuel FreeBSD, eresources-mail] pour plus d'information à ce propos et sur les autres listes de diffusion.
Si vous trouvez un bogue ou que vous soumettez une modification spécifique, rapportez-le en utilisant le programme man:send-pr[1] ou son link:www.FreeBSD.org/fr/send-pr/[équivalent web]. Essayez de remplir chaque champ du rapport de bogue. A moins qu'ils ne dépassent 65KO, inclure tous les correctifs directement dans le rapport. Si le correctif peut être appliqué directement sur l'arbre des sources ajoutez `[PATCH]` dans le synopsis du rapport. Quand vous ajoutez des correctifs, _ne pas_ utiliser le copier-coller car ce dernier transforme les tabulations en espaces et rend les correctifs inutilisables. Pensez à compresser les correctifs et à utiliser man:uuencode[1] s'ils dépassent 20KO.
@@ -109,15 +108,15 @@ Après avoir rempli un rapport, vous devriez recevoir une confirmation accompagn
Si vous ne recevez aucune confirmation dans un temps raisonnable (de 3 jours à une semaine, en fonction de votre connexion pour le courrier électronique) ou qu'il vous est, pour quelque raison que ce soit, impossible d'utiliser la commande man:send-pr[1], vous pouvez demander à quelqu'un de le faire pour vous en envoyant un courrier électronique à la {freebsd-bugs}.
-Voir aussi link:{problem-reports}[cet article] sur comment écrire de bon rapports de bogue.
+Voir aussi extref:{problem-reports}[cet article] sur comment écrire de bon rapports de bogue.
=== Modifications de la documentation
-Les modifications de la documentation sont supervisées par la {freebsd-doc}. Veuillez consulter l'link:{fdp-primer}[Introduction au Projet de Documentation de FreeBSD] pour des instructions complètes. Envoyez les soumissions et les modifications (même les plus petites sont les bienvenues!) en utilisant la commande `send-pr` comme décrit dans <<contrib-general>>.
+Les modifications de la documentation sont supervisées par la {freebsd-doc}. Veuillez consulter l'extref:{fdp-primer}[Introduction au Projet de Documentation de FreeBSD] pour des instructions complètes. Envoyez les soumissions et les modifications (même les plus petites sont les bienvenues!) en utilisant la commande `send-pr` comme décrit dans <<contrib-general>>.
=== Modifications dans le code source existant
-Un ajout ou une modification du code source existant est une toute autre affaire et dépend beaucoup de comment est à jour votre version par rapport à l'état courant du développement de FreeBSD. Il y a une version spéciale de FreeBSD, connue sous le nom de "FreeBSD-CURRENT" qui est disponible de diverses manières pour le confort des développeurs qui travaillent activement sur le système. Voir le link:{handbook}#current-stable[Manuel FreeBSD] pour plus d'informations sur la manière d'obtenir et d'utiliser FreeBSD-CURRENT.
+Un ajout ou une modification du code source existant est une toute autre affaire et dépend beaucoup de comment est à jour votre version par rapport à l'état courant du développement de FreeBSD. Il y a une version spéciale de FreeBSD, connue sous le nom de "FreeBSD-CURRENT" qui est disponible de diverses manières pour le confort des développeurs qui travaillent activement sur le système. Voir le extref:{handbook}updating-upgrading[Manuel FreeBSD, current-stable] pour plus d'informations sur la manière d'obtenir et d'utiliser FreeBSD-CURRENT.
Travailler sur des sources plus anciennes signifie que malheureusement parfois vos modifications pourront être trop obsolètes ou trop divergentes pour permettre une réintégration aisée dans FreeBSD. On peut limiter ce type de changements en souscrivant à la {freebsd-announce} et la {freebsd-current}, où des discussions sur l'état courant du système ont lieu.
@@ -242,4 +241,4 @@ Le projet FreeBSD accepte avec joie les donations de matériel. Si vous êtes in
==== Contribution d'accès Internet
-Nous pouvons toujours utiliser de nouveau sites miroirs pour les site FTP, WWW ou `cvsup`. Si vous voulez devenir un tel miroir, voyez le document link:{hubs}[devenir un site mirroir FreeBSD] pour plus d'informations.
+Nous pouvons toujours utiliser de nouveau sites miroirs pour les site FTP, WWW ou `cvsup`. Si vous voulez devenir un tel miroir, voyez le document extref:{hubs}[devenir un site mirroir FreeBSD] pour plus d'informations.
diff --git a/documentation/content/fr/articles/explaining-bsd/_index.adoc b/documentation/content/fr/articles/explaining-bsd/_index.adoc
index 72d3a5190c..4223ee69a6 100644
--- a/documentation/content/fr/articles/explaining-bsd/_index.adoc
+++ b/documentation/content/fr/articles/explaining-bsd/_index.adoc
@@ -3,7 +3,6 @@ title: Expliquer BSD
authors:
- author: Greg Lehey
email: grog@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "amd", "apple", "intel", "xfree86", "linux", "opengroup", "sparc", "sun", "unix", "general"]
---
@@ -16,12 +15,27 @@ trademarks: ["freebsd", "amd", "apple", "intel", "xfree86", "linux", "opengroup"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
+:images-path: articles/explaining-bsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Résumé
diff --git a/documentation/content/fr/articles/filtering-bridges/_index.adoc b/documentation/content/fr/articles/filtering-bridges/_index.adoc
index dfd3acd4eb..d422f7fbfa 100644
--- a/documentation/content/fr/articles/filtering-bridges/_index.adoc
+++ b/documentation/content/fr/articles/filtering-bridges/_index.adoc
@@ -3,7 +3,6 @@ title: Ponts filtrants
authors:
- author: Alex Dupre
email: ale@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "3com", "intel", "general"]
---
@@ -16,23 +15,26 @@ trademarks: ["freebsd", "3com", "intel", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
-
-ifeval::["{backend}" == "html5"]
-include::shared/fr/urls.adoc[]
+:images-path: articles/filtering-bridges/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/fr/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/fr/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -81,7 +83,7 @@ options IPFIREWALL_VERBOSE
La première ligne est pour compiler le support du pont, la seconde est le coupe-feu et la troisième sont les fonctions de traces du coupe-feu.
-Maintenant il est nécessaire de compiler et d'installer le nouveau noyau. Vous pourrez trouver des instructions détaillées dans la section link:{handbook}#kernelconfig-building[Compiler et installer un noyau sur mesures] du Manuel de FreeBSD.
+Maintenant il est nécessaire de compiler et d'installer le nouveau noyau. Vous pourrez trouver des instructions détaillées dans la section extref:{handbook}kernelconfig/[Compiler et installer un noyau sur mesures, kernelconfig-building] du Manuel de FreeBSD.
[[filtering-bridges-modules]]
=== Le chargement de modules
diff --git a/documentation/content/fr/articles/fonts/_index.adoc b/documentation/content/fr/articles/fonts/_index.adoc
index f22e3a2f94..e6bdb4eb6d 100644
--- a/documentation/content/fr/articles/fonts/_index.adoc
+++ b/documentation/content/fr/articles/fonts/_index.adoc
@@ -4,7 +4,6 @@ subtitle: Un guide utilisateur
authors:
- author: Dave Bodenstab
email: imdave@synet.net
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "adobe", "apple", "linux", "microsoft", "opengroup", "general"]
---
@@ -17,12 +16,27 @@ trademarks: ["freebsd", "adobe", "apple", "linux", "microsoft", "opengroup", "ge
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
+:images-path: articles/fonts/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Résumé
diff --git a/documentation/content/fr/articles/ipsec-must/_index.adoc b/documentation/content/fr/articles/ipsec-must/_index.adoc
index d6d0ea1c06..f283275ef7 100644
--- a/documentation/content/fr/articles/ipsec-must/_index.adoc
+++ b/documentation/content/fr/articles/ipsec-must/_index.adoc
@@ -3,7 +3,6 @@ title: Vérification indépendante du fonctionnement d'IPSec sous FreeBSD
authors:
- author: David Honig
email: honig@sprynet.com
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "opengroup", "general"]
---
@@ -16,23 +15,26 @@ trademarks: ["freebsd", "opengroup", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
-
-ifeval::["{backend}" == "html5"]
-include::shared/fr/urls.adoc[]
+:images-path: articles/ipsec-must/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/fr/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/fr/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -122,7 +124,7 @@ Extensions de sécurité au protocole internet IPv4, requises pour l'IPv6. Un pr
La plupart des versions récentes de FreeBSD ont le support IPSec dans leurs sources de base. Aussi vous devrez probablement ajouter l'option `IPSEC` dans votre configuration de noyau et, après la compilation et l'installation du noyau, configurer les connexions IPSec en utilisant la commande man:setkey[8].
-Un guide complet sur l'utilisation d'IPSec sous FreeBSD est fourni dans le link:{handbook}#ipsec[Manuel de Freebsd].
+Un guide complet sur l'utilisation d'IPSec sous FreeBSD est fourni dans le extref:{handbook}security[Manuel de Freebsd, ipsec].
[[kernel]]
== src/sys/i386/conf/KERNELNAME
diff --git a/documentation/content/fr/articles/leap-seconds/_index.adoc b/documentation/content/fr/articles/leap-seconds/_index.adoc
index 19bc5b27f9..ad5f50b38c 100644
--- a/documentation/content/fr/articles/leap-seconds/_index.adoc
+++ b/documentation/content/fr/articles/leap-seconds/_index.adoc
@@ -1,6 +1,5 @@
---
title: Support des secondes intercalaires par FreeBSD
-releaseinfo: "$FreeBSD$"
---
= Support des secondes intercalaires par FreeBSD
@@ -12,23 +11,26 @@ releaseinfo: "$FreeBSD$"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
-
-ifeval::["{backend}" == "html5"]
-include::shared/fr/urls.adoc[]
+:images-path: articles/leap-seconds/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/fr/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/fr/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -51,7 +53,7 @@ Le principe des secondes intercalaires est décrit dans la https://tools.ietf.or
[[leapseconds-posix]]
== Gestion par défaut de la seconde intercalaire sous FreeBSD
-La méthode la plus simple pour gérer les secondes intercalaires est l'ensemble des règles POSIX de gestion du temps qu'utilise par défaut FreeBSD combiné avec link:{handbook}#network-ntp[NTP]. Quand man:ntpd[8] tourne sur le système et que l'heure est synchronisée avec des serveurs NTP qui gèrent correctement les secondes intercalaires, la seconde intercalaire fera que le système répétera automatiquement la dernière seconde de la journée. Aucun autre ajustement ne sera nécessaire.
+La méthode la plus simple pour gérer les secondes intercalaires est l'ensemble des règles POSIX de gestion du temps qu'utilise par défaut FreeBSD combiné avec extref:{handbook}network-servers[NTP, network-ntp]. Quand man:ntpd[8] tourne sur le système et que l'heure est synchronisée avec des serveurs NTP qui gèrent correctement les secondes intercalaires, la seconde intercalaire fera que le système répétera automatiquement la dernière seconde de la journée. Aucun autre ajustement ne sera nécessaire.
Si les serveurs NTP de référence ne gèrent pas correctement les secondes intercalaires, man:ntpd[8] mettra à jour l'heure d'une seconde après que le serveur en amont ait constaté la modification de l'heure et qu'il se soit mis lui-même à l'heure.
diff --git a/documentation/content/fr/articles/linux-users/_index.adoc b/documentation/content/fr/articles/linux-users/_index.adoc
index e6b6c1a487..a2634792b5 100644
--- a/documentation/content/fr/articles/linux-users/_index.adoc
+++ b/documentation/content/fr/articles/linux-users/_index.adoc
@@ -3,7 +3,6 @@ title: Guide rapide pour débuter avec FreeBSD à l'attention des utilisateurs d
authors:
- author: John Ferrell
copyright: 2008 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"]
---
@@ -16,23 +15,26 @@ trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
-
-ifeval::["{backend}" == "html5"]
-include::shared/fr/urls.adoc[]
+:images-path: articles/linux-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/fr/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/fr/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -51,14 +53,14 @@ toc::[]
Ce document met en évidence les différences entre FreeBSD et Linux(R) de telle sorte que les utilisateurs de Linux(R) d'un niveau intermédiaire jusqu'à avancé puissent se familiariser rapidement avec les fondamentaux de FreeBSD. Il s'agit ici simplement d'une courte introduction technique qui n'a pas pour objectif d'expliciter les différences "philosophiques" entre les deux systèmes d'exploitation.
-Ce document part du principe que vous avez déjà installé FreeBSD. Si vous n'avez pas installé FreeBSD ou que vous avez besoin d'aide pour mener à terme le processus d'installation, vous pouvez vous référer au chapitre link:{handbook}#install[Installer FreeBSD] du Manuel de Référence FreeBSD.
+Ce document part du principe que vous avez déjà installé FreeBSD. Si vous n'avez pas installé FreeBSD ou que vous avez besoin d'aide pour mener à terme le processus d'installation, vous pouvez vous référer au chapitre extref:{handbook}install[Installer FreeBSD, install] du Manuel de Référence FreeBSD.
[[shells]]
== Interpréteurs de commandes: Pas de Bash?
Ceux qui ont l'habitude de Linux(R) sont souvent surpris de voir que Bash n'est pas l'interpréteur de commandes par défaut de FreeBSD. En fait, Bash n'est même pas présent dans l'installation par défaut. À la place, FreeBSD utilise man:tcsh[1] comme interpréteur par défaut. Cependant, Bash ainsi que vos autres interpréteurs de commandes favoris sont disponibles dans les <<SOFTWARE, Paquetages et logiciels portés>> de FreeBSD.
-Si vous installez d'autres interpréteurs de commandes vous pouvez utiliser man:chsh[1] pour définir un interpréteur par défaut pour un utilisateur. Il est cependant recommandé de ne pas modifier l'interpréteur de commandes par défaut de `root`. La raison en est que les interpréteurs de commandes qui ne sont pas inclus dans la distribution de base sont normalement installés dans [.filename]#/usr/local/bin# ou [.filename]#/usr/bin#. Dans le cas d'un problème les systèmes de fichiers contenant [.filename]#/usr/local/bin# et [.filename]#/usr/bin# peuvent ne pas être montés. Dans ce cas `root` n'aurait pas accès à son interpréteur de commandes par défaut, ce qui empêcherait `root` de pouvoir se connecter. Pour cette raison un second compte `root`, le compte `toor`, a été créé pour l'utilisation avec des interpréteurs de commandes qui ne sont pas ceux par défaut. Vous pouvez consulter les questions fréquemment posées sur la sécurité concernant le link:{faq}#TOOR-ACCOUNT[compte toor] pour plus d'information.
+Si vous installez d'autres interpréteurs de commandes vous pouvez utiliser man:chsh[1] pour définir un interpréteur par défaut pour un utilisateur. Il est cependant recommandé de ne pas modifier l'interpréteur de commandes par défaut de `root`. La raison en est que les interpréteurs de commandes qui ne sont pas inclus dans la distribution de base sont normalement installés dans [.filename]#/usr/local/bin# ou [.filename]#/usr/bin#. Dans le cas d'un problème les systèmes de fichiers contenant [.filename]#/usr/local/bin# et [.filename]#/usr/bin# peuvent ne pas être montés. Dans ce cas `root` n'aurait pas accès à son interpréteur de commandes par défaut, ce qui empêcherait `root` de pouvoir se connecter. Pour cette raison un second compte `root`, le compte `toor`, a été créé pour l'utilisation avec des interpréteurs de commandes qui ne sont pas ceux par défaut. Vous pouvez consulter les questions fréquemment posées sur la sécurité concernant le extref:{faq}[compte toor, TOOR-ACCOUNT] pour plus d'information.
[[software]]
== Paquetages et logiciels portés: ajouter des logiciels sous FreeBSD
@@ -94,14 +96,14 @@ in your /etc/rc.conf. Extra options can be found in startup script.
Si vous utilisez une version RELEASE de FreeBSD (6.2, 6.3, 7.0, etc., généralement installée depuis un CD-ROM) `pkg_add -r` téléchargera les paquetages compilés spécifiquement pour cette version. Ces paquetages peuvent _ne pas_ être la version la plus récente de l'application. Vous pouvez utiliser la variable `PACKAGESITE` pour surcharger ce comportement par défaut. Par exemple, assignez link:ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-6-stable/Latest/[ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-6-stable/Latest/] à `PACKAGESITE` pour télécharger les paquetages les plus récents construits pour les versions 6.X.
====
-Pour plus d'information concernant les paquetages vous pouvez vous référer à la section 4.4 du Manuel FreeBSD: link:{handbook}#packages-using[Utiliser le système des logiciels pré-compilés].
+Pour plus d'information concernant les paquetages vous pouvez vous référer à la section 4.4 du Manuel FreeBSD: extref:{handbook}ports[Utiliser le système des logiciels pré-compilés, packages-using].
[[ports]]
=== Les logiciels portés
Le catalogue des logiciels portés est la seconde méthode proposée par FreeBSD pour installer des applications. Le catalogue des logiciels portés a pour architecture un ensemble de [.filename]#Makefiles# et de fichiers correctifs spécifiquement adaptés pour pouvoir installer depuis les sources des applications diverses sur FreeBSD. Lors de l'installation d'un logiciel porté le système téléchargera le code source, appliquera tous les correctifs nécessaires, compilera le code, et installera l'application (et fera de même pour toutes ses dépendances).
-Le catalogue des logiciels portés, parfois appelée l'arbre des ports (ports tree en anglais), peut être trouvé dans [.filename]#/usr/ports#. Nous partons ici du principe que le catalogue des logiciels portés a été installé pendant le processus d'installation de FreeBSD. Si le catalogue des logiciels portés n'a pas été installé, il peut être ajoutée à partir des disques d'installation en utilisant man:sysinstall[8], ou bien récupéré depuis les serveurs FreeBSD en utilisant man:csup[1] ou man:portsnap[8]. Des instructions détaillées concernant l'installation du catalogue des logiciels portés peuvent être consultées dans la link:{handbook}#ports-using[section 4.5.1] du Manuel.
+Le catalogue des logiciels portés, parfois appelée l'arbre des ports (ports tree en anglais), peut être trouvé dans [.filename]#/usr/ports#. Nous partons ici du principe que le catalogue des logiciels portés a été installé pendant le processus d'installation de FreeBSD. Si le catalogue des logiciels portés n'a pas été installé, il peut être ajoutée à partir des disques d'installation en utilisant man:sysinstall[8], ou bien récupéré depuis les serveurs FreeBSD en utilisant man:csup[1] ou man:portsnap[8]. Des instructions détaillées concernant l'installation du catalogue des logiciels portés peuvent être consultées dans la extref:{handbook}ports[section 4.5.1, ports-using] du Manuel.
Installer un logiciel porté est aussi simple (en général) que de se déplacer dans le répertoire du logiciel porté et de lancer le processus de compilation. L'exemple suivant installe Apache 2.2 depuis le catalogue des logiciels portés:
@@ -119,7 +121,7 @@ Un des avantages majeurs d'utiliser les logiciels portés pour installer des log
# make WITH_LDAP="YES" install clean
....
-Vous pouvez vous référer à la section 4.5 du Manuel FreeBSD, link:{handbook}#ports-using[Utiliser le catalogue des logiciels portés], pour obtenir plus d'information concernant le catalogue des logiciels portés.
+Vous pouvez vous référer à la section 4.5 du Manuel FreeBSD, extref:{handbook}ports[Utiliser le catalogue des logiciels portés, ports-using], pour obtenir plus d'information concernant le catalogue des logiciels portés.
[[which]]
=== Logiciel porté ou paquetage, lequel devrais-je utiliser?
@@ -225,9 +227,9 @@ ifconfig_em0="DHCP"
Tout comme IPTABLES pour Linux(R), FreeBSD offre également un pare-feu au niveau du noyau; en fait FreeBSD offre trois pare-feux distincts:
-* link:{handbook}#firewalls-ipfw[IPFIREWALL]
-* link:{handbook}#firewalls-ipf[IPFILTER]
-* link:{handbook}#firewalls-pf[PF]
+* extref:{handbook}firewalls[IPFIREWALL, firewalls-ipfw]
+* extref:{handbook}firewalls[IPFILTER, firewalls-ipf]
+* extref:{handbook}firewalls[PF, firewalls-pf]
IPFIREWALL ou IPFW (la commande pour gérer un jeu de règles IPFW est man:ipfw[8]) est le pare-feu développé et maintenu par les développeurs FreeBSD. IPFW peut être couplé avec man:dummynet[4] pour fournir des possibilités de régulation du trafic et simuler différents types de connections réseau.
@@ -261,7 +263,7 @@ pass in on $ext_if inet proto tcp from any to ($ext_if) port 22
Il existe trois méthodes différentes pour mettre à jour un système FreeBSD: à partir des sources, les mises à jour binaires, et les disques d'installation.
-Mettre à jour depuis les sources est la méthode la plus compliquée mais elle offre la plus grande flexibilité. Le processus implique de synchroniser une copie locale du code source de FreeBSD avec les serveurs CVS (Concurrent Versioning System - Système de gestion de Versions Concurrentes) de FreeBSD. Une fois que le code source local est à jour vous pouvez compiler les nouvelles versions du noyau et du système de base. Pour plus d'informations concernant les mises à jour depuis les sources vous pouvez consulter link:{handbook}#updating-upgrading[le chapitre sur la mise à jour] du manuel FreeBSD.
+Mettre à jour depuis les sources est la méthode la plus compliquée mais elle offre la plus grande flexibilité. Le processus implique de synchroniser une copie locale du code source de FreeBSD avec les serveurs CVS (Concurrent Versioning System - Système de gestion de Versions Concurrentes) de FreeBSD. Une fois que le code source local est à jour vous pouvez compiler les nouvelles versions du noyau et du système de base. Pour plus d'informations concernant les mises à jour depuis les sources vous pouvez consulter extref:{handbook}updating-upgrading[le chapitre sur la mise à jour, updating-upgrading] du manuel FreeBSD.
Les mises à jour binaires ressemblent aux commandes `yum` ou `apt-get` utilisées pour mettre à jour un système Linux(R). La commande man:freebsd-update[8] téléchargera les nouvelles mises à jour et les installera. Les mises à jour peuvent être programmées par l'intermédiaire de man:cron[8].
@@ -319,7 +321,7 @@ kern.posix1version: 200112
Certaines de ces valeurs `sysctl` sont uniquement accessibles en lecture.
====
-procfs est parfois nécessaire comme pour faire fonctionner de vieux logiciels, pour examiner des appels système en utilisant man:truss[1], et pour la link:{handbook}#linuxemu[Compatibilité Binaire avec Linux(R)] (celle-ci utilise cependant son propre procfs, man:linprocfs[5]). Si vous avez besoin de monter procfs vous pouvez ajouter la ligne suivante dans [.filename]#/etc/fstab#:
+procfs est parfois nécessaire comme pour faire fonctionner de vieux logiciels, pour examiner des appels système en utilisant man:truss[1], et pour la extref:{handbook}linuxemu[Compatibilité Binaire avec Linux(R), linuxemu] (celle-ci utilise cependant son propre procfs, man:linprocfs[5]). Si vous avez besoin de monter procfs vous pouvez ajouter la ligne suivante dans [.filename]#/etc/fstab#:
[source,shell]
....
@@ -394,4 +396,4 @@ Et ensuite montez procfs avec:
[[conclusion]]
== Conclusion
-Nous esperons que ce document vous a fourni suffisamment d'informations pour que vous puissiez faire vos premiers pas avec FreeBSD. Vous pouvez consulter link:{handbook}[le Manuel FreeBSD] pour une couverture plus complète des sujets abordés ici ainsi que de tous les autres sujets non abordés dans ce document.
+Nous esperons que ce document vous a fourni suffisamment d'informations pour que vous puissiez faire vos premiers pas avec FreeBSD. Vous pouvez consulter extref:{handbook}[le Manuel FreeBSD] pour une couverture plus complète des sujets abordés ici ainsi que de tous les autres sujets non abordés dans ce document.
diff --git a/documentation/content/fr/articles/nanobsd/_index.adoc b/documentation/content/fr/articles/nanobsd/_index.adoc
index b81e5863e4..540167a566 100644
--- a/documentation/content/fr/articles/nanobsd/_index.adoc
+++ b/documentation/content/fr/articles/nanobsd/_index.adoc
@@ -3,7 +3,6 @@ title: Introduction à NanoBSD
authors:
- author: Daniel Gerzo
copyright: 2006 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -16,23 +15,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
-
-ifeval::["{backend}" == "html5"]
+:images-path: articles/nanobsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
diff --git a/documentation/content/fr/articles/new-users/_index.adoc b/documentation/content/fr/articles/new-users/_index.adoc
index 1afdde681b..a6161eb660 100644
--- a/documentation/content/fr/articles/new-users/_index.adoc
+++ b/documentation/content/fr/articles/new-users/_index.adoc
@@ -3,7 +3,6 @@ title: Pour les Nouveaux Venus à FreeBSD et Unix
authors:
- author: Annelise Anderson
email: andrsn@andrsn.stanford.edu
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"]
---
@@ -16,23 +15,26 @@ trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
-
-ifeval::["{backend}" == "html5"]
-include::shared/fr/urls.adoc[]
+:images-path: articles/new-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/fr/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/fr/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -310,7 +312,7 @@ Pour pouvoir imprimer depuis FreeBSD, il faut définir l'imprimante dans le fich
# mkdir lpd
....
-L'imprimante devrait alors répondre si elle était sous tension au démarrage du système et les commandes lp ou lpr devraient envoyer un fichier à l'imprimante. Que le fichier s'imprime ou non dépend de la configuration de l'imprimante, qui est décrite dans le link:{handbook}[manuel FreeBSD.]
+L'imprimante devrait alors répondre si elle était sous tension au démarrage du système et les commandes lp ou lpr devraient envoyer un fichier à l'imprimante. Que le fichier s'imprime ou non dépend de la configuration de l'imprimante, qui est décrite dans le extref:{handbook}[manuel FreeBSD.]
== D'autres Commandes Utiles
@@ -348,7 +350,7 @@ Voici un excellent livre qui détaille les commandes et les utilitaires du syst
== Etapes Suivantes
-Vous avez maintenant les outils nécessaires à l'exploration du système et à l'édition de fichiers. Il y a énormément d'informations dans le link:{handbook}[manuel FreeBSD] (que vous avez probablement aussi sur votre disque dur) et sur le http://www.freebsd.org/[site Internet de FreeBSD]. Il y a un grand nombre de logiciels sur le CDROM de http://www.cdrom.com/[Walnut Creek] et sur leur site Internet. Le "manuel" vous explique comment les utiliser (installer le logiciel s'il existe, avec `pkg_add /cdrom/packages/All/nom_du_logiciel`, où _nom_du_logiciel_ est le nom du fichier correspondant au logiciel voulu). Le CDROM donne la liste des logiciels pré-compilés ou non footnote:[N.d.T: Les logiciels prévus pour être utilisés avec FreeBSD peuvent être pré-compilés (packages) ou disponibles sous forme de code source (ports) livré avec les procédures nécessaires à sa compilation.] avec une courte description de chacun dans [.filename]#/cdrom/packages/index#, [.filename]#/cdrom/packages/index.txt# et [.filename]#/cdrom/ports/index#. Il y a des descriptifs plus détaillés dans [.filename]#/cdrom/ports/\*/*/pkg/DESCR#, où les *s désignent respectivement les sous-répertoires regroupant les logiciels par catégories et les noms des logiciels.
+Vous avez maintenant les outils nécessaires à l'exploration du système et à l'édition de fichiers. Il y a énormément d'informations dans le extref:{handbook}[manuel FreeBSD] (que vous avez probablement aussi sur votre disque dur) et sur le http://www.freebsd.org/[site Internet de FreeBSD]. Il y a un grand nombre de logiciels sur le CDROM de http://www.cdrom.com/[Walnut Creek] et sur leur site Internet. Le "manuel" vous explique comment les utiliser (installer le logiciel s'il existe, avec `pkg_add /cdrom/packages/All/nom_du_logiciel`, où _nom_du_logiciel_ est le nom du fichier correspondant au logiciel voulu). Le CDROM donne la liste des logiciels pré-compilés ou non footnote:[N.d.T: Les logiciels prévus pour être utilisés avec FreeBSD peuvent être pré-compilés (packages) ou disponibles sous forme de code source (ports) livré avec les procédures nécessaires à sa compilation.] avec une courte description de chacun dans [.filename]#/cdrom/packages/index#, [.filename]#/cdrom/packages/index.txt# et [.filename]#/cdrom/ports/index#. Il y a des descriptifs plus détaillés dans [.filename]#/cdrom/ports/\*/*/pkg/DESCR#, où les *s désignent respectivement les sous-répertoires regroupant les logiciels par catégories et les noms des logiciels.
Si vous trouvez le "manuel" trop subtil (avec ses commandes `lndir` et ainsi de suite) en ce qui concerne l'installation des logiciel à compiler, voici une méthode qui fonctionne habituellement:
diff --git a/documentation/content/fr/articles/pam/_index.adoc b/documentation/content/fr/articles/pam/_index.adoc
index 1917721569..662603f936 100644
--- a/documentation/content/fr/articles/pam/_index.adoc
+++ b/documentation/content/fr/articles/pam/_index.adoc
@@ -3,7 +3,6 @@ title: Pluggable Authentication Modules
authors:
- author: Dag-Erling Smørgrav
copyright: 2001-2003 Networks Associates Technology, Inc.
-releaseinfo: "$FreeBSD$"
trademarks: ["pam", "freebsd", "linux", "opengroup", "sun", "general"]
---
@@ -50,12 +49,30 @@ SUCH DAMAGE.
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
+:images-path: articles/pam/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+:include-path: static/source/articles/pam/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:include-path: ../../../../static/source/articles/pam/
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:include-path: ../../../../static/source/articles/pam/
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Abstract
@@ -549,17 +566,7 @@ Ce qui suit est une implémentation minimale de man:su[1] en utilisant PAM. Note
[.programlisting]
....
-ifeval::["{backend}" == "html5"]
-include::static/source/articles/pam/su.c[]
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../static/source/articles/pam/su.c[]
-endif::[]
-
-ifeval::["{backend}" == "epub3"]
-include::../../../../static/source/articles/pam/su.c[]
-endif::[]
+include::{include-path}su.c[]
....
:sectnums!:
@@ -572,17 +579,7 @@ Ce qui suit est une implémentation minimale de man:pam_unix[8] offrant uniqueme
[.programlisting]
....
-ifeval::["{backend}" == "html5"]
-include::static/source/articles/pam/pam_unix.c[]
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../static/source/articles/pam/pam_unix.c[]
-endif::[]
-
-ifeval::["{backend}" == "epub3"]
-include::../../../../static/source/articles/pam/pam_unix.c[]
-endif::[]
+include::{include-path}pam_unix.c[]
....
:sectnums!:
@@ -595,17 +592,7 @@ La fonction de conversation présentée ci-dessous est une version grandement si
[.programlisting]
....
-ifeval::["{backend}" == "html5"]
-include::static/source/articles/pam/converse.c[]
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../static/source/articles/pam/converse.c[]
-endif::[]
-
-ifeval::["{backend}" == "epub3"]
-include::../../../../static/source/articles/pam/converse.c[]
-endif::[]
+include::{include-path}converse.c[]
....
:sectnums!:
diff --git a/documentation/content/fr/articles/pr-guidelines/_index.adoc b/documentation/content/fr/articles/pr-guidelines/_index.adoc
index edb27af05b..84b127cd9a 100644
--- a/documentation/content/fr/articles/pr-guidelines/_index.adoc
+++ b/documentation/content/fr/articles/pr-guidelines/_index.adoc
@@ -3,7 +3,6 @@ title: Directives d'utilisation des rapports de bogues
authors:
- author: Dag-Erling Smørgrav
- author: Hiten Pandya
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -16,12 +15,27 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
+:images-path: articles/pr-guidelines/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Résumé
diff --git a/documentation/content/fr/articles/problem-reports/_index.adoc b/documentation/content/fr/articles/problem-reports/_index.adoc
index 9672ac038d..2115233944 100644
--- a/documentation/content/fr/articles/problem-reports/_index.adoc
+++ b/documentation/content/fr/articles/problem-reports/_index.adoc
@@ -3,7 +3,6 @@ title: Ecrire des rapports de bogue pour FreeBSD
authors:
- author: Dag-Erling Smørgrav
- author: Mark Linimon
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "intel", "sun", "general"]
---
@@ -16,12 +15,27 @@ trademarks: ["freebsd", "ibm", "intel", "sun", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
+:images-path: articles/problem-reports/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Résumé
diff --git a/documentation/content/fr/books/developers-handbook/_index.adoc b/documentation/content/fr/books/developers-handbook/_index.adoc
index 4c6b24bbe8..b6c8ccfc27 100644
--- a/documentation/content/fr/books/developers-handbook/_index.adoc
+++ b/documentation/content/fr/books/developers-handbook/_index.adoc
@@ -3,8 +3,8 @@ title: Livre de chevet du développeur FreeBSD
authors:
- author: Le groupe du projet de documentation FreeBSD
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
+trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
+isIndex: true
---
= Livre de chevet du développeur FreeBSD
@@ -12,53 +12,35 @@ trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
-
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+:book: true
+:pdf: false
+:images-path: books/developers-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
-:imagesdir: ../../images/books/developers-handbook/
-:chapters-path: content/fr/books/developers-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/fr/mailing-lists.adoc[]
-include::../../../../shared/fr/teams.adoc[]
-include::../../../../shared/fr/urls.adoc[]
-:imagesdir: ../../../static/images/books/developers-handbook/
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/fr/mailing-lists.adoc[]
-include::../../../../shared/fr/teams.adoc[]
-include::../../../../shared/fr/urls.adoc[]
-:imagesdir: ../../../static/images/books/developers-handbook/
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
diff --git a/documentation/content/fr/books/developers-handbook/driverbasics/chapter.adoc b/documentation/content/fr/books/developers-handbook/driverbasics/chapter.adoc
index 33146c8066..225f150617 100644
--- a/documentation/content/fr/books/developers-handbook/driverbasics/chapter.adoc
+++ b/documentation/content/fr/books/developers-handbook/driverbasics/chapter.adoc
@@ -9,15 +9,36 @@ title: Chapitre 16. Ecrire des pilotes de périphériques pour FreeBSD
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/developers-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Ce chapitre a été écrit par {murray} avec des sélections depuis une variété de codes source inclus dans la page de manuel d'man:intro[4] de Joerg Wunsch.
diff --git a/documentation/content/fr/books/developers-handbook/locking/chapter.adoc b/documentation/content/fr/books/developers-handbook/locking/chapter.adoc
index f44b90b720..46a49e8eca 100644
--- a/documentation/content/fr/books/developers-handbook/locking/chapter.adoc
+++ b/documentation/content/fr/books/developers-handbook/locking/chapter.adoc
@@ -9,15 +9,36 @@ title: Chapitre 8. Notes sur le verrouillage
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/developers-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
_Ce chapître est maintenu par The FreeBSD SMP Next Generation Project. Envoyez leur directement les commentaires et les suggestions à link:{freebsd-smp}._
diff --git a/documentation/content/fr/books/developers-handbook/pci/chapter.adoc b/documentation/content/fr/books/developers-handbook/pci/chapter.adoc
index 2be3e44403..031ac096a7 100644
--- a/documentation/content/fr/books/developers-handbook/pci/chapter.adoc
+++ b/documentation/content/fr/books/developers-handbook/pci/chapter.adoc
@@ -9,15 +9,36 @@ title: Chapitre 17. Les périphériques PCI
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/developers-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Ce chapître traitera des mécanismes de FreeBSD pour écrire un pilote de périphérique pour un périphérique sur bus PCI.
diff --git a/documentation/content/fr/books/developers-handbook/scsi/chapter.adoc b/documentation/content/fr/books/developers-handbook/scsi/chapter.adoc
index 227b213f9f..51743590fa 100644
--- a/documentation/content/fr/books/developers-handbook/scsi/chapter.adoc
+++ b/documentation/content/fr/books/developers-handbook/scsi/chapter.adoc
@@ -9,15 +9,36 @@ title: Chapitre 18. Contrôleurs SCSI Common Access Method (CAM) **
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/developers-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
== En cours de traduction
diff --git a/documentation/content/fr/books/developers-handbook/secure/chapter.adoc b/documentation/content/fr/books/developers-handbook/secure/chapter.adoc
index 8d95787108..a8c22fb6a3 100644
--- a/documentation/content/fr/books/developers-handbook/secure/chapter.adoc
+++ b/documentation/content/fr/books/developers-handbook/secure/chapter.adoc
@@ -11,15 +11,36 @@ authors:
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/developers-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Ce chapître a été écrit par Murray Stokely.
diff --git a/documentation/content/fr/books/developers-handbook/tools/chapter.adoc b/documentation/content/fr/books/developers-handbook/tools/chapter.adoc
index 2ce8bddfbb..18ffd147cf 100644
--- a/documentation/content/fr/books/developers-handbook/tools/chapter.adoc
+++ b/documentation/content/fr/books/developers-handbook/tools/chapter.adoc
@@ -13,21 +13,39 @@ authors:
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-
:c-plus-plus-command: c++
:gcc-plus-plus-command: gcc++
-
:lg-plus-plus: -lg++
:lstdc-plus-plus: -lstdc++
+:images-path: books/developers-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
_Ce chapître a été écrit par James Raynard. Les modifications pour le livre de chevet du développeur par Murray Stokely._
diff --git a/documentation/content/fr/books/developers-handbook/usb/chapter.adoc b/documentation/content/fr/books/developers-handbook/usb/chapter.adoc
index 4d0f82bb27..0aaa69def8 100644
--- a/documentation/content/fr/books/developers-handbook/usb/chapter.adoc
+++ b/documentation/content/fr/books/developers-handbook/usb/chapter.adoc
@@ -9,15 +9,36 @@ title: Chapitre 19. Périphériques USB ***
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/developers-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
_Ce chapître a été écrit par {nhibma}. Les modifications pour le manuel par {murray}._
diff --git a/documentation/content/fr/books/faq/_index.adoc b/documentation/content/fr/books/faq/_index.adoc
index d2f96b899d..269dc500bd 100644
--- a/documentation/content/fr/books/faq/_index.adoc
+++ b/documentation/content/fr/books/faq/_index.adoc
@@ -3,8 +3,8 @@ title: Questions Fréquemment Posées sur FreeBSD 2.X, 3.X et 4.X
authors:
- author: The FreeBSD Documentation Project
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
+trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
+isIndex: true
---
= Questions Fréquemment Posées sur FreeBSD 2.X, 3.X et 4.X
@@ -12,59 +12,46 @@ trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "
:toc: macro
:toclevels: 1
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
-:rel-numbranch: 3
-:rel-head: 13-CURRENT
-:rel-head-relx: 13.X
+:images-path: books/faq/
+:rel-numbranch: 4
+:rel-head: 14-CURRENT
+:rel-head-relx: 14.X
:rel-head-releng: head/
-:rel-relx: 12.X
-:rel-stable: 12-STABLE
-:rel-releng: stable/12/
+:rel-relx: 13.X
+:rel-stable: 13-STABLE
+:rel-releng: stable/13/
:rel-relengdate: December 2018
-:rel2-relx: 11.X
-:rel2-stable: 11-STABLE
-:rel2-releng: stable/11/
-:rel2-relengdate: October 2016
-
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+:rel2-relx: 12.X
+:rel2-stable: 12-STABLE
+:rel2-releng: stable/12/
+:rel2-relengdate: December 2018
+:rel3-relx: 11.X
+:rel3-stable: 11-STABLE
+:rel3-releng: stable/11/
+:rel3-relengdate: October 2016
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/fr/mailing-lists.adoc[]
-include::../../../../shared/fr/teams.adoc[]
-include::../../../../shared/fr/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/fr/mailing-lists.adoc[]
-include::../../../../shared/fr/teams.adoc[]
-include::../../../../shared/fr/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -90,7 +77,7 @@ Pour résumer, FreeBSD 2.X est un système d'exploitation UN*X basé sur la dist
FreeBSD est utilisé par des sociétés commerciales, fournisseurs d'accès à l'Internet, chercheurs, professionnels de l'informatique, étudiants et particuliers à travers le monde entier pour travailler, apprendre et se divertir. Reportez-vous à la http://www.fr.freebsd.org/gallery/gallery.html[galerie FreeBSD] pour vous faire une idée.
-Pour plus de détails et d'informations sur FreeBSD, référez vous au link:{handbook}/[manuel de FreeBSD]
+Pour plus de détails et d'informations sur FreeBSD, référez vous au extref:{handbook}[manuel de FreeBSD]
=== Quels sont les buts de FreeBSD ?
@@ -114,7 +101,7 @@ En quelques mots, la branche _-stable_ est destinée aux fournisseurs d'accès
=== Qu'est-ce que FreeBSD-current ?
-link:{handbook}#current[FreeBSD-current] est la version de développement du système d'exploitation, qui deviendra en temps utile la version 4.0-RELEASE. Comme telle, cette version ne peut intéresser que les développeurs du noyau ainsi que certains passionnés. Voyez link:{handbook}#current[la section appropriée] du link:{handbook}[manuel] pour plus de détails sur l'utilisation de -current.
+extref:{handbook}updating-upgrading[FreeBSD-current, current] est la version de développement du système d'exploitation, qui deviendra en temps utile la version 4.0-RELEASE. Comme telle, cette version ne peut intéresser que les développeurs du noyau ainsi que certains passionnés. Voyez extref:{handbook}updating-upgrading[la section appropriée, current] du extref:{handbook}[manuel] pour plus de détails sur l'utilisation de -current.
Si vous n'êtes pas familier avec ce système d'exploitation, ou que vous n'êtes pas capable de différencier un problème temporaire d'un problème critique, vous ne devez pas utiliser FreeBSD-current. Cette branche évolue assez rapidement et peut ne pas être compilée pendant un certain temps. Les personnes utilisant FreeBSD-current doivent être capables d'analyser n'importe quel problème et de ne rapporter que les erreurs utiles.
@@ -184,7 +171,7 @@ Si vous disposez d'une autre architecture, nous vous conseillons d'aller voir au
=== Qui sont les responsables de FreeBSD ?
-Les décisions concernant le projet FreeBSD, comme les directions que vont prendre le projet ainsi que les personnes autorisées à ajouter du code dans le noyau, sont fixées par link:{handbook}#staff/[l'équipe principale ], composée d'environ 15 personnes. Il y a une équipe un peu plus large d'environ link:{handbook}#staff-committers/[150 personnes] qui ont le droit d'effectuer des changements dans le code.
+Les décisions concernant le projet FreeBSD, comme les directions que vont prendre le projet ainsi que les personnes autorisées à ajouter du code dans le noyau, sont fixées par extref:{handbook}[l'équipe principale], composée d'environ 15 personnes. Il y a une équipe un peu plus large d'environ extref:{handbook}[150 personnes] qui ont le droit d'effectuer des changements dans le code.
Bien sûr, la plupart des changements sont discutés au préalable dans les listes de messagerie, et il n'y a aucune restriction sur qui peut prendre part à la discussion.
@@ -273,11 +260,11 @@ Fax: +44 1892 667-473
=== Où trouver de l'information sur les listes de messagerie ?
-Vous trouverez ces informations dans link:{handbook}#eresources[la section sur les listes de diffusion du manuel]
+Vous trouverez ces informations dans extref:{handbook}eresources[la section sur les listes de diffusion du manuel, eresources]
=== Quels sont les forums de discussion disponibles sur FreeBSD ?
-Tous les forums sont listés dans la section sur link:{handbook}#eresources/[les forums de discussion] du manuel
+Tous les forums sont listés dans la section sur extref:{handbook}eresources[les forums de discussion, eresources] du manuel
=== Existe-t-il des canaux IRC(Internet Relay Chat) sur FreeBSD ?
@@ -296,7 +283,7 @@ Le livre de Greg Lehey's "stalling and Running FreeBSD" est disponible chez Waln
Il existe aussi un projet se nommant "FreeBSD Documentation Project", que vous pouvez contacter (ou mieux, joindre) sur la "liste de diffusion doc"link:mailto:freebsd-doc@FreeBSD.ORG[<freebsd-doc@FreeBSD.ORG>]. Cette liste a pour but de discuter sur la documentation de FreeBSD. Les questions plus générales sur FreeBSD sont à poser dans la "mailing list" link:mailto:freebsd-questions@FreeBSD.ORG[<freebsd-questions@FreeBSD.ORG>].
-Un link:{handbook}[manuel] sur FreeBSD est disponible. Sachez, pour information, que ce manuel est en perpétuelle évolution, et que certaines parties peuvent être incomplètes.
+Un extref:{handbook}[manuel] sur FreeBSD est disponible. Sachez, pour information, que ce manuel est en perpétuelle évolution, et que certaines parties peuvent être incomplètes.
Comme FreeBSD 2.2.X est basé sur la version 4.4.BSD-lite2, la plupart des manuels relatifs à 4.4BSD peuvent s'appliquer à FreeBSD. Des versions imprimées sont disponibles chez O'Reilly:
@@ -421,7 +408,7 @@ Ressources WWW:
* Pour plus d'informations sur SMP (Symmetric MultiProcessing) voyez la http://www.freebsd.org/~fsmp/SMP/SMP.html[page du support SMP]
* Pour plus d'informations sur les applications multimedia FreeBSD , voyez la page http://www.freebsd.org/~faulkner/multimedia/mm.html[ multimédia]. Si vous vous intéressez plus spécialement à la capture vidéo Bt848 suivez ce http://www.freebsd.org/~ahasty/Bt848.html[ lien].
-Le manuel de FreeBSD contient une section link:{handbook}#bibliography/[ bibliographie] plus importante, si vous recherchez d'autres livres ou informations.
+Le manuel de FreeBSD contient une section extref:{handbook}bibliography/[bibliographie, bibliography] plus importante, si vous recherchez d'autres livres ou informations.
== Installation. **Mise à jour en cours**
@@ -437,7 +424,7 @@ Si vous avez besoin de télécharger la distribution par vous même (pour une in
* Tout le répertoire [.filename]#doc#
* Tous les fichiers [.filename]#src/ssys.*#
-Vous trouverez les instructions complètes pour cette procédure et un peu plus au sujet de l'installation en général dans la section link:{handbook}#install[ installation de FreeBSD] du manuel.
+Vous trouverez les instructions complètes pour cette procédure et un peu plus au sujet de l'installation en général dans la section extref:{handbook}install[ installation de FreeBSD, install] du manuel.
=== A l'aide ! L'image-disque de démarrage ne tient pas sur une seule disquette !
@@ -452,11 +439,11 @@ Certains clients FTP mettent par défaut le transfert en mode _ASCII_, et essaye
Une solution simple : tapez `binary` à l'invite FTP, après la connexion sur le serveur et avant le démarrage du téléchargement de l'image.
* Vous avez utilisé la commande DOS `copy` (ou une commande équivalente) pour transférer l'image de démarrage sur la disquette.
+
-Les programmes comme `copy` ne fonctionnent pas correctement avec les images, car ils ne peuvent créer une disquette de démarrage. L'image est le contenu exact de la disquette, piste à piste, et ne peut être copiée sur la disquette comme un fichier normal. Vous devez la transférer sur la disquette en mode brut {raw} en utilisant les outils de bas niveau {low-level} `fdimage` ou `rawrite`. Ces outils sont décrits dans la section link:{handbook}#install/[installation de FreeBSD] du manuel.
+Les programmes comme `copy` ne fonctionnent pas correctement avec les images, car ils ne peuvent créer une disquette de démarrage. L'image est le contenu exact de la disquette, piste à piste, et ne peut être copiée sur la disquette comme un fichier normal. Vous devez la transférer sur la disquette en mode brut {raw} en utilisant les outils de bas niveau {low-level} `fdimage` ou `rawrite`. Ces outils sont décrits dans la section extref:{handbook}install/[installation de FreeBSD, install] du manuel.
=== Où sont les instructions pour installer FreeBSD ?
-Les instructions d'installation de FreeBSD se trouvent dans la section link:link:{handbook}#install[ installation de FreeBSD] du manuel.
+Les instructions d'installation de FreeBSD se trouvent dans la section extref:{handbook}install[installation de FreeBSD, install] du manuel.
=== De quoi ai-je besoin pour faire tourner FreeBSD ?
@@ -734,7 +721,7 @@ Pour résoudre ce problème, effectuez les opérations suivantes :
* Au message de démarrage tapez : `1:wd(2,a)kernel` puis Entrée. Si le système démarre, lancez la commande `echo "1:wd(2,a)kernel" > /boot.config` pour affecter la bonne chaîne de démarrage.
* Déplacez le disque FreeBSD sur le controleur primaire, les disques sont alors vus de façon contigus.
-* link:{handbook}#kernelconfig[Reconstruisez un noyau] en modifiant les lignes de configuration wd pour avoir:
+* extref:{handbook}kernelconfig[Reconstruisez un noyau, kernelconfig] en modifiant les lignes de configuration wd pour avoir:
+
[.programlisting]
....
@@ -814,7 +801,7 @@ FreeBSD supporte les disques EIDE et SCSI (pour les contrôleurs compatibles, vo
=== Quels sont les contrôleurs SCSI supportés ?
-Voir la liste complète dans le link:{handbook}#install[Handbook].
+Voir la liste complète dans le extref:{handbook}install[Handbook, install].
=== Quels sont les lecteurs CD-ROM supportés par FreeBSD ?
@@ -850,7 +837,7 @@ A part la version IDE du lecteur EZ, ce sont tous des périphériques SCSI, alor
=== Quelles sont les cartes séries multi-ports prises en charge par FreeBSD ?
-Une liste est disponible à la section link:{handbook}#INSTALL-HW[périphériques divers ] du handbook.
+Une liste est disponible à la section extref:{handbook}[périphériques divers ] du handbook.
A notre connaissance, certaines cartes clone sans marque sont connues pour fonctionner, en particulier celles qui se disent être compatibles AST.
@@ -879,7 +866,7 @@ Si vous utilisez une version plus ancienne du noyau, alors vous aurez à ajouter
device psm0 at isa? port "IO_KBD" conflicts tty irq 12 vector psmintr
....
-Voir la link:{handbook}#kernelconfig/[section du Handbook sur la configuration du noyau] si vous n'avez aucune expérience dans la construction d'un noyau.
+Voir la extref:{handbook}kernelconfig/[section du Handbook sur la configuration du noyau, kernelconfig] si vous n'avez aucune expérience dans la construction d'un noyau.
Un fois que vous aurez un noyau détectant correctement psm0 au moment du démarrage, assurez vous qu'une entrée pour psm0 existe bien dans /dev. Vous pouvez le faire en tapant :
@@ -962,7 +949,7 @@ Ceci n'est valable que pour les sons! Ce pilote ne supporte pas les CD-ROMs, SCS
=== Quels sont les cartes réseau supportées par FreeBSD ?
-Regarder la section link:{handbook}#INSTALL-HW[ cartes éthernet] du handbook pour une liste complète.
+Regarder la section extref:{handbook}[ cartes éthernet] du handbook pour une liste complète.
=== Je n'ai pas de coprocesseur arithmétique. Est-ce un problème ?
@@ -980,7 +967,7 @@ Certains coprocesseurs mathématiques sont meilleurs que d'autres. Cela nous pei
=== Quels autres périphériques la version 2.X supporte-t-elle ?
-Lire le link:{handbook}#INSTALL-HW[Handbook] pour obtenir la liste des périphériques supportés.
+Lire le extref:{handbook}[Handbook] pour obtenir la liste des périphériques supportés.
=== FreeBSD supporte-t-il le gestionnaire d'énergie de mon portable ?
@@ -1093,7 +1080,7 @@ Les cartes EISA 742q n'ont jamais eu le problème `>16Mo` mentionné dans la sec
C'est à la base un problème connu. Le contrôleur SCSI-EISA intégré sur la carte mère des machines HP Netserver occupe le slot EISA numéro 11, aussi tous les `vrais` slots EISA se retrouvent devant lui. Malheureusement, l'espace d'adressage pour les slots EISA >= 10 se retrouve en conflit avec l'espace d'adressage assigné aux slots PCI, et l'auto-configuration de FreeBSD ne peut actuellement pas très bien gérer cette situation.
-Donc, pour le moment, le mieux que vous ayez à faire, est de prétendre qu'il n'y a pas de conflit de plage d'adresse :-), en propulsant l'option du noyau [.filename]#EISA_SLOTS# à la valeur 12. Configurez et compilez un noyau comme décrit dans link:{handbook}#kernelconfig/[le manuel de référence sur la configuration du noyau].
+Donc, pour le moment, le mieux que vous ayez à faire, est de prétendre qu'il n'y a pas de conflit de plage d'adresse :-), en propulsant l'option du noyau [.filename]#EISA_SLOTS# à la valeur 12. Configurez et compilez un noyau comme décrit dans extref:{handbook}kernelconfig/[le manuel de référence sur la configuration du noyau, kernelconfig].
Bien sûr, cela se présente comme le problème bien connu de la poule et de l'oeuf lorsque l'on installe sur une telle machine. Afin de pouvoir contourner ce problème, un hack spécial est disponible au moment de la configuration utilisateur (UserConfig). Ne pas utiliser l'interface `visual`, mais l'interface en mode texte. Tapez simplement :
@@ -1371,7 +1358,7 @@ Pour plus d'informations : http://www.conetic.com/[ Conetic Software Systems ] o
=== Ou puis-je trouver toutes les applications utilisateurs?
-Allez voir sur la link:{handbook}#ports/[ page des ports] pour plus d'informations sur les packages portés sur FreeBSD. La liste complète inclut plus de 1000 ports, et grossit chaque jours, donc vérifiez souvent cette liste, ou souscrivez à la mailing liste link:freebsd-announce[ freebsd-announce ] pour vous tenir au courant des mises à jour.
+Allez voir sur la extref:{handbook}ports/[page des ports, ports] pour plus d'informations sur les packages portés sur FreeBSD. La liste complète inclut plus de 1000 ports, et grossit chaque jours, donc vérifiez souvent cette liste, ou souscrivez à la mailing liste link:freebsd-announce[ freebsd-announce ] pour vous tenir au courant des mises à jour.
La plupart des ports sont disponibles pour la branche 2.2 et 3.0, et la plupart d'entre eux sont susceptibles de fonctionner sur des systèmes 2.1.x. A chaque fois qu'une version de FreeBSD est livrée, une version des ports, au moment de la livraison de la version, est incluse dans le répertoire [.filename]#ports#.
@@ -1438,7 +1425,7 @@ Utilisez les ports ! Une pré-version patchée pour Apache est disponible dans l
=== J'aimerais personnaliser mon noyau. Est-ce difficile ?
-Pas du tout ! Jetez un coup d'oeil à link:{handbook}#kernelconfig/[ la section de la configuration du noyau du manuel de référence. ]
+Pas du tout ! Jetez un coup d'oeil à extref:{handbook}kernelconfig/[la section de la configuration du noyau du manuel de référence., kernelconfig]
NOTE : Je vous recommande de faire une sauvegarde datée de votre noyau dans [.filename]#kernel.YYMMDD# dès que vous arrivez à tout faire marcher. Ainsi, si jamais en jouant avec votre configuration du noyau, vous mélangez tout, vous pourrez démarrer sur ce noyau plutôt que de repartir depuis [.filename]#kernel.GENERIC#. Ceci est particulièrement important si vous démarrez actuellement depuis un contrôleur qui n'est pas supporté par le noyau GENERIC (oui, c'est une expérience personelle).
@@ -1774,7 +1761,7 @@ vnconfig -ce /dev/vn0c /usr/swap0 swap
=== J'ai des problèmes pour installer mon imprimante.
-Référez-vous à la section sur les link:{handbook}#printing/[imprimantes du Handbook]. Elle couvre l'essentiel des problèmes que l'on peut rencontrer.
+Référez-vous à la section sur les extref:{handbook}printing/[imprimantes du Handbook, printing]. Elle couvre l'essentiel des problèmes que l'on peut rencontrer.
=== Le clavier est mal configuré sur mon ordinateur.
@@ -2332,7 +2319,7 @@ Lancez la commande _xmodmap -e "pointer = 3 2 1"_ depuis votre .xinitrc ou .xses
=== Où puis-je trouver des informations sur le boot sans disque?
-Le boot sans disque veut dire que la machine sous FreeBSD est bootée depuis le réseau, et lit les fichiers nécessaires depuis un serveur et non depuis son disque dur. Pour plus de détails, lisez link:{handbook}#diskless[ la section du Handbook sur le Diskless booting ]
+Le boot sans disque veut dire que la machine sous FreeBSD est bootée depuis le réseau, et lit les fichiers nécessaires depuis un serveur et non depuis son disque dur. Pour plus de détails, lisez extref:{handbook}[la section du Handbook sur le Diskless booting]
=== Une machine sous FreeBSD peut-elle être utilisée comme routeur dédié ?
@@ -2367,12 +2354,12 @@ Il y a un conflit entre le fichier _cdefs.h_ de la distribution et celui fourni
Oui, regardez les pages de manuel http://www.freebsd.org/cgi/man.cgi?slattach[slattach], http://www.freebsd.org/cgi/man.cgi?sliplogin[sliplogin], http://www.freebsd.org/cgi/man.cgi?pppd[pppd] et http://www.freebsd.org/cgi/man.cgi?ppp[ppp]. _pppd_ et _ppp_ permettent les connexions entrantes et sortantes http://www.freebsd.org/cgi/man.cgi?sliplogin[Sliplogin] ne peut s'utiliser qu'avec des connexions entrantes et http://www.freebsd.org/cgi/man.cgi?slattach[slattach] qu'avec des connexions sortantes.
-Ces programmes sont décrits dans les sections suivantes du link:{handbook}[handbook]:
+Ces programmes sont décrits dans les sections suivantes du extref:{handbook}[handbook]:
-* link:link:{handbook}#slips[référence du handbook sur SLIP (côté serveur)]
-* link:.link:{handbook}#slipc[référence du handbook sur SLIP (côté client)]
-* link:link:{handbook}#ppp[référence du handbook sur PPP (mode noyau)]
-* link:link:{handbook}#USERPPP[référence du handbook sur PPP (mode utilisateur)]
+* extref:{handbook}ppp-and-slip[référence du handbook sur SLIP (côté serveur), slips]
+* extref:{handbook}ppp-and-slip[référence du handbook sur SLIP (côté client), slipc]
+* extref:{handbook}ppp-and-slip[référence du handbook sur PPP (mode noyau), ppp]
+* extref:{handbook}ppp-and-slip[référence du handbook sur PPP (mode utilisateur), userppp]
Si vous avez accès à l'Internet à travers un "compte shell" vous pouvez jeter un coup d'oeil au paquetage http://www.freebsd.org/cgi/ports.cgi?^slirp[slirp]. Il peut vous fournir un accès (limité) aux services tels que ftp et http directement depuis votre machine locale.
@@ -2384,7 +2371,7 @@ Le programme http://www.freebsd.org/cgi/man.cgi?ppp[ppp] a des fonctionnalités
=== Je n'arrive pas à faire marcher ppp. Où me suis-je trompé ?
-Vous devriez tout d'abord lire la page de manuel http://www.freebsd.org/cgi/man.cgi?ppp[ppp] et link:{handbook}#USERPPP[la section du handbook sur ppp]. Activer le logging avec la commande
+Vous devriez tout d'abord lire la page de manuel http://www.freebsd.org/cgi/man.cgi?ppp[ppp] et extref:{handbook}ppp-and-slip[la section du handbook sur ppp, userppp]. Activer le logging avec la commande
[.programlisting]
....
@@ -2446,7 +2433,7 @@ Une autre raison au fait que la ligne du routage par défaut soit manquante est
delete ALL
....
-from _ppp.conf_. Si cela est le cas, revenez à la section du handbook sur link:{handbook}#ppp-and-slip[la configuration finale du système] section of the handbook.
+from _ppp.conf_. Si cela est le cas, revenez à la section du handbook sur extref:{handbook}ppp-and-slip[la configuration finale du système, ppp-and-slip] section of the handbook.
==== Que veut dire "No route to host" ?
@@ -2467,7 +2454,7 @@ delete ALL
add 0 0 HISADDR
....
-Se référer à la section du handbook sur link:{handbook}#ppp-and-slip[ PPP et les adresses IP dynamiques ]pour plus de détails.
+Se référer à la section du handbook sur extref:{handbook}ppp-and-slip[ PPP et les adresses IP dynamiques, ppp-and-slip] pour plus de détails.
=== Ma connexion se termine au bout de 3 minutes
@@ -2814,7 +2801,7 @@ Si vous voulez utiliser les autres ports, vous avez à spécifier un paramêtre
Certaines cartes réseaux sont meilleures que d'autres et peuvent causer quelquefois des problèmes lors d'applications réseaux intensives comme NFS.
-Regarder link:{handbook}#nfs[la partie du Handbook sur NFS ]pour plus d'informations à ce sujet.
+Regarder extref:{handbook}[la partie du Handbook sur NFS] pour plus d'informations à ce sujet.
=== Pourquoi ne puis-je pas monter par NFS depuis une machine sous Linux ?
@@ -2916,7 +2903,7 @@ ipfw add 65534 allow all from any to any
Vous pouvez aussi régler "firewall_type='open'" dans _/etc/rc.conf_.
-Pour plus d'informations sur la configuration d'un firewall FreeBSD, voir la link:{handbook}#firewalls[section correspondante du handbook].
+Pour plus d'informations sur la configuration d'un firewall FreeBSD, voir la extref:{handbook}firewalls[section correspondante du handbook, firewalls].
=== Combien d'overhead, IPFW implique-t-il ?
@@ -3346,7 +3333,7 @@ Pour les systèmes pre-3.0, il y a un bel utiltaire appelé http://www.freebsd.o
http://www.freebsd.org/cgi/ports.cgi?^sup[SUP] veut dire Software Update Protocol, et a été développé par CMU pour pouvoir synchroniser leurs arbres de développement. Nous l'utilisons pour garder les sites distants en synchronisation avec nos sources centraux de développement
-SUP n'est pas très ami avec la bande passante et a été retiré. La méthode actuelle recommandé pour pouvoir garder vos sources à jour est link:{handbook}#synching[Handbook entry on CVSup]
+SUP n'est pas très ami avec la bande passante et a été retiré. La méthode actuelle recommandé pour pouvoir garder vos sources à jour est extref:{handbook}updating-upgrading[Handbook entry on CVSup, synching]
=== Jusqu'à quel point FreeBSD est-il cool ?
@@ -3395,7 +3382,7 @@ Pour créer votre propre version, vous devez effectuer trois choses. Premièreme
pseudo-device vn #Vnode driver (turns a file into a device)
....
-Ensuite, vous devez disposer de l'arbre CVS au complet. Pour l'obtenir, vous pouvez utiliser link:{handbook}#synching[CVSUP] et remplissez votre fichier de configuration de cvsup de la façon suivante:
+Ensuite, vous devez disposer de l'arbre CVS au complet. Pour l'obtenir, vous pouvez utiliser extref:{handbook}updating-upgrading[CVSUP, synching] et remplissez votre fichier de configuration de cvsup de la façon suivante:
[.programlisting]
....
@@ -3447,7 +3434,7 @@ Les cartes SCSI Adaptec 1542 permettent d'accéder à la configuration de la vit
=== Puis-je me tenir à jour par rapport à -current si j'ai un accès limité à l'Internet?
-Oui, vous pouvez le faire sans télécharger l'arbre complet des sources en utilisant la fonctionnalitée link:{handbook}#synching[CTM]
+Oui, vous pouvez le faire sans télécharger l'arbre complet des sources en utilisant la fonctionnalitée extref:{handbook}updating-upgrading[CTM, synching]
=== Comment faire pour couper la distribution en fichiers de 240Ko?
@@ -3467,7 +3454,7 @@ bin-tarball:
=== J'ai écrit une extension pour le noyau, comment l'incorporer?
-Regardez la partie du handbook sur la façon de link:{handbook}#contrib[soumettre du code]
+Regardez la partie du handbook sur la façon de extref:{handbook}[soumettre du code]
Et encore merci pour tout.
diff --git a/documentation/content/fr/books/handbook/_index.adoc b/documentation/content/fr/books/handbook/_index.adoc
index 26862de4fc..124f59dfc4 100644
--- a/documentation/content/fr/books/handbook/_index.adoc
+++ b/documentation/content/fr/books/handbook/_index.adoc
@@ -1,9 +1,9 @@
---
title: Manuel FreeBSD
authors:
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
next: books/handbook/preface
+isIndex: true
---
= Manuel FreeBSD
@@ -13,17 +13,32 @@ next: books/handbook/preface
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
+:images-path: books/handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Résumé
@@ -36,10 +51,10 @@ N.d.T.: Contactez {fonvieille} si vous voulez collaborer à la traduction.
'''
-include::content/fr/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
-include::content/fr/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
-include::content/fr/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
-include::content/fr/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/fr/books/handbook/advanced-networking/_index.adoc b/documentation/content/fr/books/handbook/advanced-networking/_index.adoc
index 23f9e88f2c..951362ea1a 100644
--- a/documentation/content/fr/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/fr/books/handbook/advanced-networking/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/partv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 32
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 32
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[advanced-networking-synopsis]]
== Synopsis
@@ -1532,7 +1531,7 @@ La plupart des adaptateurs terminaux fonctionneront probablement également, les
Le vrai problème avec les adaptateurs terminaux est que comme pour les modems, il vous faudra une bonne interface série dans votre ordinateur.
-Vous devriez lire le document sur link:{serial-uart}[les ports série sous FreeBSD] pour comprendre en détail le fonctionnement des périphériques série et les différences entre les ports séries asynchrones et synchrones.
+Vous devriez lire le document sur extref:{serial-uart}[les ports série sous FreeBSD] pour comprendre en détail le fonctionnement des périphériques série et les différences entre les ports séries asynchrones et synchrones.
Un adaptateur terminal sur un port série PC standard (asynchrone) vous limite à 115.2 Kbs, même si vous disposez d'une connexion à 128 Kbs. Pour utiliser complètement les 128 Kbs offert par l'ISDN, vous devez brancher l'adaptateur sur une carte série synchrone.
diff --git a/documentation/content/fr/books/handbook/audit/_index.adoc b/documentation/content/fr/books/handbook/audit/_index.adoc
index a882025fbf..a7c957f266 100644
--- a/documentation/content/fr/books/handbook/audit/_index.adoc
+++ b/documentation/content/fr/books/handbook/audit/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/disks
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[audit-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/basics/_index.adoc b/documentation/content/fr/books/handbook/basics/_index.adoc
index 34d561fe15..2907f7f467 100644
--- a/documentation/content/fr/books/handbook/basics/_index.adoc
+++ b/documentation/content/fr/books/handbook/basics/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/ports
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[basics-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/bibliography/_index.adoc b/documentation/content/fr/books/handbook/bibliography/_index.adoc
index 6729713cf0..daec1a613c 100644
--- a/documentation/content/fr/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/fr/books/handbook/bibliography/_index.adoc
@@ -9,25 +9,40 @@ next: books/handbook/eresources
[[bibliography]]
= Bibliographie
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Bien que les pages de manuel soient la documentation de référence pour chaque facette du système d'exploitation FreeBSD, il est de notoriété publique qu'elles n'expliquent pas comment assembler les morceaux pour avoir un système d'exploitation qui tourne sans encombre. Il n'y a pour cela pas d'autre alternative qu'un bon livre sur l'administration UNIX(R) et un bon manuel utilisateur.
@@ -119,7 +134,7 @@ Une https://www.FreeBSD.org/doc/it_IT.ISO8859-15/books/unix-introduction/index.h
* Leffler, Samuel J., Marshall Kirk McKusick, _The Design and Implementation of the 4.3BSD UNIX Operating System: Answer Book_. Reading, Mass. : Addison-Wesley, 1991. ISBN 0-201-54629-9
* McKusick, Marshall Kirk, Keith Bostic, Michael J Karels, and John Quarterman. _The Design and Implementation of the 4.4BSD Operating System_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-54979-4
+
-(Le chapitre 2 de ce livre est disponible link:{design-44bsd}[en ligne] en tant que partie du Projet de Documentation de FreeBSD, et le chapitre 9 http://www.netapp.com/tech_library/nfsbook.html[ ici].)
+(Le chapitre 2 de ce livre est disponible extref:{design-44bsd}[en ligne] en tant que partie du Projet de Documentation de FreeBSD, et le chapitre 9 http://www.netapp.com/tech_library/nfsbook.html[ ici].)
* Marshall Kirk McKusick, George V. Neville-Neil _The Design and Implementation of the FreeBSD Operating System_. Boston, Mass. : Addison-Wesley, 2004. ISBN 0-201-70245-2
* Stevens, W. Richard. _TCP/IP Illustrated, Volume 1: The Protocols_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-63346-9
* Schimmel, Curt. _Unix Systems for Modern Architectures_. Reading, Mass. : Addison-Wesley, 1994. ISBN 0-201-63338-8
diff --git a/documentation/content/fr/books/handbook/book.adoc b/documentation/content/fr/books/handbook/book.adoc
index e6df3e9bbf..7bd3bf930b 100644
--- a/documentation/content/fr/books/handbook/book.adoc
+++ b/documentation/content/fr/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: Manuel FreeBSD
authors:
- author: Groupe de Documentation FreeBSD
copyright: 1995-2020 Groupe de Documentation FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
---
@@ -12,53 +11,35 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
:book: true
:pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
-:chapters-path: content/fr/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/fr/mailing-lists.adoc[]
-include::../../../../shared/fr/teams.adoc[]
-include::../../../../shared/fr/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/fr/mailing-lists.adoc[]
-include::../../../../shared/fr/teams.adoc[]
-include::../../../../shared/fr/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -77,97 +58,97 @@ toc::[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
// Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
-include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1]
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
-include::{chapters-path}users/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}users/_index.adoc[leveloffset=+1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}jails/_index.adoc[leveloffset=+1]
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
-include::{chapters-path}zfs/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}zfs/_index.adoc[leveloffset=+1]
-include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}filesystems/_index.adoc[leveloffset=+1]
-include::{chapters-path}vinum/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}vinum/_index.adoc[leveloffset=+1]
-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
-include::{chapters-path}dtrace/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}dtrace/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=7..19]
+include::{chapters-path}partiv.adoc[lines=15..27]
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..37;47..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
// Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
:sectnums!:
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..24;33..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..24;32..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..24;33..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..24;34..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/fr/books/handbook/boot/_index.adoc b/documentation/content/fr/books/handbook/boot/_index.adoc
index 66237ab8a3..900aaf237b 100644
--- a/documentation/content/fr/books/handbook/boot/_index.adoc
+++ b/documentation/content/fr/books/handbook/boot/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/users
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/bsdinstall/_index.adoc b/documentation/content/fr/books/handbook/bsdinstall/_index.adoc
index 3954b31944..dd557c0907 100644
--- a/documentation/content/fr/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/fr/books/handbook/bsdinstall/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/basics
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/bsdinstall/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
-endif::[]
+:images-path: books/handbook/bsdinstall/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[bsdinstall-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/config/_index.adoc b/documentation/content/fr/books/handbook/config/_index.adoc
index 081f41e121..59f0d01245 100644
--- a/documentation/content/fr/books/handbook/config/_index.adoc
+++ b/documentation/content/fr/books/handbook/config/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/boot
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/config/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[config-synopsis]]
== Synopsis
@@ -230,7 +229,7 @@ Ceci est la configuration de base pour chaque fichier [.filename]#crontab#, bien
[IMPORTANT]
====
-Ne pas utiliser la procédure décrite ci-dessous pour éditer et installer le fichier [.filename]#crontab# système. Utilisez directement votre éditeur: l'utilitaire `cron` remarquera le changement au niveau de ce fichier et utilisera immédiatement la nouvelle version. Consultez link:{faq}#ROOT-NOT-FOUND-CRON-ERRORS[cette entrée de la FAQ] pour plus d'information.
+Ne pas utiliser la procédure décrite ci-dessous pour éditer et installer le fichier [.filename]#crontab# système. Utilisez directement votre éditeur: l'utilitaire `cron` remarquera le changement au niveau de ce fichier et utilisera immédiatement la nouvelle version. Consultez extref:{faq}[cette entrée de la FAQ, ROOT-NOT-FOUND-CRON-ERRORS] pour plus d'information.
====
Pour installer un fichier [.filename]#crontab# utilisateur fraîchement rédigé, tout d'abord utilisez votre éditeur favori pour créer un fichier dans le bon format, ensuite utilisez l'utilitaire `crontab`. L'usage le plus typique est:
@@ -320,7 +319,7 @@ Les mots clés suivants peuvent être ajoutés au début de chaque fichier de d
En utilisant avec soin ces mots clés pour chaque fichier de démarrage, un administrateur dispose d'un niveau de contrôle très fin de l'ordre d'exécution des procédures de démarrage sans les inconvénients des "runlevels" comme sur d'autres systèmes d'exploitation UNIX(R).
-Des informations supplémentaires concernant le système [.filename]#rc.d# peuvent être trouvées dans les pages de manuel man:rc[8] et man:rc.subr[8]. Si vous êtes intéressé par l'écriture de vos propres procédures [.filename]#rc.d# ou pour l'amélioration des procédures existantes, vous trouverez link:{rc-scripting}[cette article] utile.
+Des informations supplémentaires concernant le système [.filename]#rc.d# peuvent être trouvées dans les pages de manuel man:rc[8] et man:rc.subr[8]. Si vous êtes intéressé par l'écriture de vos propres procédures [.filename]#rc.d# ou pour l'amélioration des procédures existantes, vous trouverez extref:{rc-scripting}[cette article] utile.
[[config-network-setup]]
== Configuration des cartes réseaux
diff --git a/documentation/content/fr/books/handbook/cutting-edge/_index.adoc b/documentation/content/fr/books/handbook/cutting-edge/_index.adoc
index 9b6368e66f..5a36cc1084 100644
--- a/documentation/content/fr/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/fr/books/handbook/cutting-edge/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/dtrace
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[updating-upgrading-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/desktop/_index.adoc b/documentation/content/fr/books/handbook/desktop/_index.adoc
index 0cb69b3bc0..79cbf42384 100644
--- a/documentation/content/fr/books/handbook/desktop/_index.adoc
+++ b/documentation/content/fr/books/handbook/desktop/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/multimedia
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[desktop-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/disks/_index.adoc b/documentation/content/fr/books/handbook/disks/_index.adoc
index aa49241929..61393e07b9 100644
--- a/documentation/content/fr/books/handbook/disks/_index.adoc
+++ b/documentation/content/fr/books/handbook/disks/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/geom
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[disks-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/dtrace/_index.adoc b/documentation/content/fr/books/handbook/dtrace/_index.adoc
index 6573413bb1..a9e6c3d04b 100644
--- a/documentation/content/fr/books/handbook/dtrace/_index.adoc
+++ b/documentation/content/fr/books/handbook/dtrace/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/partiv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/dtrace/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
-endif::[]
+:images-path: books/handbook/dtrace/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dtrace-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/eresources/_index.adoc b/documentation/content/fr/books/handbook/eresources/_index.adoc
index 0bfbb1abf1..4a1cbdaebd 100644
--- a/documentation/content/fr/books/handbook/eresources/_index.adoc
+++ b/documentation/content/fr/books/handbook/eresources/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/pgpkeys
[[eresources]]
= Ressources sur Internet
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
L'évolution rapide de FreeBSD rend peu pratique le suivi des développements via des supports imprimés. Les supports électroniques sont le meilleur, sinon la plupart du temps le seul, moyen de se tenir au courant des dernières avancées. Comme FreeBSD est un effort basé sur le volontariat, la communauté des utilisateurs sert généralement de "service de support technique", le courrier électronique et les forums de discussion étant le meilleur moyen de contacter cette communauté.
@@ -46,9 +60,9 @@ Les chartes d'utilisation pour les différentes listes sont données à la fin d
_Si vous désirez tester votre capacité à envoyer du courrier aux listes FreeBSD, envoyez un message de test à la liste {freebsd-test}._ Veuillez ne pas envoyer de messages de test vers une autre liste.
====
-En cas de doute sur la liste sur laquelle poser une question, lisez link:{freebsd-questions-article}[Comment obtenir les meilleurs résultats sur la liste de diffusion FreeBSD-questions].
+En cas de doute sur la liste sur laquelle poser une question, lisez extref:{freebsd-questions-article}[Comment obtenir les meilleurs résultats sur la liste de diffusion FreeBSD-questions].
-Avant de poster sur une liste de diffusion, veuillez apprendre à utiliser au mieux les listes de diffusion, comme par exemple éviter de relancer des discussions qui reviennent régulièrement, en lisant le document (FAQ) sur link:{mailing-list-faq}[les questions fréquemment posées au sujet des listes de diffusion].
+Avant de poster sur une liste de diffusion, veuillez apprendre à utiliser au mieux les listes de diffusion, comme par exemple éviter de relancer des discussions qui reviennent régulièrement, en lisant le document (FAQ) sur extref:{mailing-list-faq}[les questions fréquemment posées au sujet des listes de diffusion].
Des archives de toutes les listes de diffusion sont conservées et on peut effectuer des recherches sur le link:https://www.FreeBSD.org/search/[serveur World Wide Web de FreeBSD]. Les archives interrogeables par mots-clés offrent un excellent moyen de trouver des réponses aux questions fréquemment posées et devraient être consultées avant de poster une question.
diff --git a/documentation/content/fr/books/handbook/filesystems/_index.adoc b/documentation/content/fr/books/handbook/filesystems/_index.adoc
index cc72823409..ce34e88010 100644
--- a/documentation/content/fr/books/handbook/filesystems/_index.adoc
+++ b/documentation/content/fr/books/handbook/filesystems/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/vinum
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/filesystems/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
-endif::[]
+:images-path: books/handbook/filesystems/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[filesystems-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/firewalls/_index.adoc b/documentation/content/fr/books/handbook/firewalls/_index.adoc
index 7627a4a8a5..acb4d83074 100644
--- a/documentation/content/fr/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/fr/books/handbook/firewalls/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/advanced-networking
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 31
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 31
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[firewalls-intro]]
== Introduction
diff --git a/documentation/content/fr/books/handbook/geom/_index.adoc b/documentation/content/fr/books/handbook/geom/_index.adoc
index 9d64fcd0ed..a084358728 100644
--- a/documentation/content/fr/books/handbook/geom/_index.adoc
+++ b/documentation/content/fr/books/handbook/geom/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/zfs
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[GEOM-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/introduction/_index.adoc b/documentation/content/fr/books/handbook/introduction/_index.adoc
index 3ae6a54e78..4cee12363a 100644
--- a/documentation/content/fr/books/handbook/introduction/_index.adoc
+++ b/documentation/content/fr/books/handbook/introduction/_index.adoc
@@ -13,24 +13,35 @@ next: books/handbook/bsdinstall
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/handbook/introduction/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-synopsis]]
== Synopsis
@@ -48,7 +59,7 @@ Après la lecture de ce chapitre, vous connaîtrez:
[[nutshell]]
== Bienvenue à FreeBSD!
-FreeBSD est une système d'exploitation basé sur 4.4BSD-Lite2 pour les ordinateurs à base d'architecture Intel (x86 et Itanium(R)), AMD64, les ordinateurs DEC Alpha(TM), et Sun UltraSPARC(R). Le portage pour d'autres architectures est également en cours. Pour connaître l'histoire du projet, lisez <<history,Un court historique de FreeBSD>>. Pour avoir une description de la version la plus récente, allez à la section <<relnotes,A propos de cette version>>. Si vous voulez contribuer d'une façon ou d'une autre au projet FreeBSD (code, matériel, dons), voyez s'il vous plaît à la section link:{contributing}[Contribuer à FreeBSD].
+FreeBSD est une système d'exploitation basé sur 4.4BSD-Lite2 pour les ordinateurs à base d'architecture Intel (x86 et Itanium(R)), AMD64, les ordinateurs DEC Alpha(TM), et Sun UltraSPARC(R). Le portage pour d'autres architectures est également en cours. Pour connaître l'histoire du projet, lisez <<history,Un court historique de FreeBSD>>. Pour avoir une description de la version la plus récente, allez à la section <<relnotes,A propos de cette version>>. Si vous voulez contribuer d'une façon ou d'une autre au projet FreeBSD (code, matériel, dons), voyez s'il vous plaît à la section extref:{contributing}[Contribuer à FreeBSD].
[[os-overview]]
=== Que peut faire FreeBSD?
@@ -162,7 +173,7 @@ Le code de l'arborescence des sources, qui est régi par la Licence Publique GNU
[[development]]
=== Le mode de développement de FreeBSD
-Le développement de FreeBSD est un processus très ouvert et très souple, c'est littéralement le résultat de contributions de centaines de personnes dans le monde entier, ce que reflète notre link:{contributors}[liste des participants]. L'infrastructure de développement de FreeBSD permet à ces centaines de développeurs de collaborer via l'Internet. Nous sommes toujours à l'affût de nouveaux développeurs et de nouvelles idées, et ceux que s'impliquer de plus près intéresse n'ont besoin que de contacter la {freebsd-hackers}. La {freebsd-announce} est aussi disponible pour ceux qui veulent faire connaître aux autres utilisateurs de FreeBSD les principaux domaines de développement en cours.
+Le développement de FreeBSD est un processus très ouvert et très souple, c'est littéralement le résultat de contributions de centaines de personnes dans le monde entier, ce que reflète notre extref:{contributors}[liste des participants]. L'infrastructure de développement de FreeBSD permet à ces centaines de développeurs de collaborer via l'Internet. Nous sommes toujours à l'affût de nouveaux développeurs et de nouvelles idées, et ceux que s'impliquer de plus près intéresse n'ont besoin que de contacter la {freebsd-hackers}. La {freebsd-announce} est aussi disponible pour ceux qui veulent faire connaître aux autres utilisateurs de FreeBSD les principaux domaines de développement en cours.
Quelques points utiles à connaître à propos du projet FreeBSD et de son processus de développement, que vous travailliez indépendamment ou en collaboration étroite:
@@ -175,7 +186,7 @@ Les personnes autorisées (_committers_) sont celles qui ont les droits en _écr
L'équipe de base de FreeBSD[[development-core]]::
_L'équipe de base de FreeBSD_ serait l'équivalent du comité de direction si le Projet FreeBSD était une entreprise. La responsabilité principale de l'équipe de base est de s'assurer que le projet, dans son ensemble, fonctionne correctement et va dans la bonne direction. Proposer à des développeurs impliqués et responsables de rejoindre notre groupe de personnes autorisées est une des fonctions de l'équipe de base, ainsi que le recrutement de nouveaux membres de l'équipe de base quand d'autres s'en vont. L'actuelle équipe de base a été élu à partir d'un ensemble de "committers" candidats en Juillet 2006. Des élections ont lieu tous les 2 ans.
+
-Certains membres de l'équipe de base ont aussi leur propre domaine de responsabilité, ce qui signifie qu'il leur est dévolu de veiller à ce qu'une partie significative du système satisfasse aux fonctionnalités annoncées. Pour une liste complète des développeurs FreeBSD et de leurs domaines de responsabilité, veuillez consulter la link:{contributors}[liste des participants au projet].
+Certains membres de l'équipe de base ont aussi leur propre domaine de responsabilité, ce qui signifie qu'il leur est dévolu de veiller à ce qu'une partie significative du système satisfasse aux fonctionnalités annoncées. Pour une liste complète des développeurs FreeBSD et de leurs domaines de responsabilité, veuillez consulter la extref:{contributors}[liste des participants au projet].
+
[NOTE]
====
@@ -185,7 +196,7 @@ La plupart des membres de l'équipe de base sont volontaires en ce qui concerne
Contributions extérieures::
Enfin, mais certainement pas des moindres, le groupe le plus important de développeurs est constitué par les utilisateurs eux-mêmes qui nous fournissent de façon quasi régulière leur retour d'expérience et leurs corrections de bogues. Le principal moyen d'entrer en contact avec le développement plus décentralisé de FreeBSD est de s'inscrire sur la {freebsd-hackers} où ces questions sont abordées. Voyez crossref:eresources[eresources,Ressources sur Internet] pour plus d'informations concernant les diverses listes de discussion FreeBSD.
+
-La link:{contributors}[liste] de ceux qui ont contribué au projet est longue et en augmentation, pourquoi donc ne pas vous y joindre et contribuer à quelque chose en retour dès aujourd'hui?
+La extref:{contributors}[liste] de ceux qui ont contribué au projet est longue et en augmentation, pourquoi donc ne pas vous y joindre et contribuer à quelque chose en retour dès aujourd'hui?
+
Fournir du code n'est pas la seule manière de contribuer au projet; pour avoir une liste plus complète de ce qu'il y a à faire, voyez s'il vous plaît le link:https://www.FreeBSD.org/[site du projet FreeBSD].
diff --git a/documentation/content/fr/books/handbook/jails/_index.adoc b/documentation/content/fr/books/handbook/jails/_index.adoc
index 8709ea4fb0..5ca283c38e 100644
--- a/documentation/content/fr/books/handbook/jails/_index.adoc
+++ b/documentation/content/fr/books/handbook/jails/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/mac
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/jails/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
-endif::[]
+:images-path: books/handbook/jails/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[jails-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/kernelconfig/_index.adoc b/documentation/content/fr/books/handbook/kernelconfig/_index.adoc
index c6c3b0c8c4..f0ef615613 100644
--- a/documentation/content/fr/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/fr/books/handbook/kernelconfig/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/printing
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kernelconfig-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/l10n/_index.adoc b/documentation/content/fr/books/handbook/l10n/_index.adoc
index eeb8195d4f..2b74ec7ed1 100644
--- a/documentation/content/fr/books/handbook/l10n/_index.adoc
+++ b/documentation/content/fr/books/handbook/l10n/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/cutting-edge
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/linuxemu/_index.adoc b/documentation/content/fr/books/handbook/linuxemu/_index.adoc
index 2510841864..4aefb9e620 100644
--- a/documentation/content/fr/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/fr/books/handbook/linuxemu/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/partiii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[linuxemu-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/mac/_index.adoc b/documentation/content/fr/books/handbook/mac/_index.adoc
index a88fc201f9..ccdedf1b47 100644
--- a/documentation/content/fr/books/handbook/mac/_index.adoc
+++ b/documentation/content/fr/books/handbook/mac/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/audit
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/mail/_index.adoc b/documentation/content/fr/books/handbook/mail/_index.adoc
index 58682acb27..0d44823e0a 100644
--- a/documentation/content/fr/books/handbook/mail/_index.adoc
+++ b/documentation/content/fr/books/handbook/mail/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/network-servers
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 29
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 29
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mail-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/mirrors/_index.adoc b/documentation/content/fr/books/handbook/mirrors/_index.adoc
index 43172f564b..71c92a492e 100644
--- a/documentation/content/fr/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/fr/books/handbook/mirrors/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/bibliography
[[mirrors]]
= Se procurer FreeBSD
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mirrors-cdrom]]
== Editeurs de CD-ROMs et DVDs
@@ -1013,7 +1027,7 @@ Si vous ne voulez pas mettre à jour l'intégralité du catalogue `ports-all` (l
+
[IMPORTANT]
====
-Si vous voulez construire votre propre version locale du fichier [.filename]#ports/INDEX#, vous _devez_ accepter le catalogue `ports-all` (l'intégralité du catalogue des logiciels portés). La construction de [.filename]#ports/INDEX# avec une arborescence partielle n'est pas supportée. Consultez la link:{faq}#MAKE-INDEX[FAQ].
+Si vous voulez construire votre propre version locale du fichier [.filename]#ports/INDEX#, vous _devez_ accepter le catalogue `ports-all` (l'intégralité du catalogue des logiciels portés). La construction de [.filename]#ports/INDEX# avec une arborescence partielle n'est pas supportée. Consultez la extref:{faq}[FAQ, MAKE-INDEX].
====
`ports-accessibility release=cvs`::::
@@ -1509,7 +1523,7 @@ Branche de développement de FreeBSD-2.2.X, aussi connue sous le nom de 2.2-STAB
=== Etiquettes de publication
-Ces étiquettes font référence à un moment bien précis dans le temps quand une version particulière de FreeBSD a été publiée. Le processus d'ingénierie des publications est documenté en détails dans les documents link:https://www.FreeBSD.org/releng/[Information sur la publication des versions] et link:{releng}#release-proc/[Processus de publication]. L'arborescence [.filename]#src# utilise des étiquettes commençant par `RELENG_`. Les arborescences [.filename]#ports# et [.filename]#doc# utilisent des étiquettes dont les noms commencent par `RELEASE`. Enfin, l'arborescence [.filename]#www# ne bénéficie pas d'étiquette particulière pour les publications.
+Ces étiquettes font référence à un moment bien précis dans le temps quand une version particulière de FreeBSD a été publiée. Le processus d'ingénierie des publications est documenté en détails dans les documents link:https://www.FreeBSD.org/releng/[Information sur la publication des versions] et extref:{releng}[Processus de publication, release-proc]. L'arborescence [.filename]#src# utilise des étiquettes commençant par `RELENG_`. Les arborescences [.filename]#ports# et [.filename]#doc# utilisent des étiquettes dont les noms commencent par `RELEASE`. Enfin, l'arborescence [.filename]#www# ne bénéficie pas d'étiquette particulière pour les publications.
RELENG_6_2_0_RELEASE::
FreeBSD 6.2
diff --git a/documentation/content/fr/books/handbook/multimedia/_index.adoc b/documentation/content/fr/books/handbook/multimedia/_index.adoc
index 888a0d1069..95a4525d3c 100644
--- a/documentation/content/fr/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/fr/books/handbook/multimedia/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/kernelconfig
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[multimedia-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/network-servers/_index.adoc b/documentation/content/fr/books/handbook/network-servers/_index.adoc
index 2cf5739ca4..d9ccaaad71 100644
--- a/documentation/content/fr/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/fr/books/handbook/network-servers/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/firewalls
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 30
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 30
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[network-servers-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/parti.adoc b/documentation/content/fr/books/handbook/parti.adoc
index 7602a277e3..a940045c7a 100644
--- a/documentation/content/fr/books/handbook/parti.adoc
+++ b/documentation/content/fr/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
next: books/handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[getting-started]]
= Pour commencer
@@ -17,4 +25,4 @@ Cette partie du Manuel FreeBSD est destinée aux nouveaux venus à FreeBSD, util
Le nombre de références dans le texte a été limité au minimum afin que cette section du Manuel puisse être lue du début jusqu'à la fin avec le moins de changements de pages possibles.
-include::content/fr/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/fr/books/handbook/partii.adoc b/documentation/content/fr/books/handbook/partii.adoc
index ee17e779f8..f8761c7a7f 100644
--- a/documentation/content/fr/books/handbook/partii.adoc
+++ b/documentation/content/fr/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
next: books/handbook/desktop
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[common-tasks]]
= Tâches courantes
@@ -17,4 +25,4 @@ Maintenant que les bases sont maîtrisées, cette partie du Manuel va traiter de
Certains de ces chapitres conseillent des lectures préalables, ceci est noté dans le synopsis au début de chaque chapitre.
-include::content/fr/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/fr/books/handbook/partiii.adoc b/documentation/content/fr/books/handbook/partiii.adoc
index 8724f9445f..b93de49f4b 100644
--- a/documentation/content/fr/books/handbook/partiii.adoc
+++ b/documentation/content/fr/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
next: books/handbook/config
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[system-administration]]
= Administration Système
@@ -11,4 +19,4 @@ Les chapitres restant couvrent tous les aspects de l'administration système de
Ces chapitres sont conçus pour être consultés dès qu'une information est nécessaire. Il n'est pas nécessaire de les lire suivant un ordre particulier, ni tous les lire avant de pouvoir utiliser FreeBSD.
-include::content/fr/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/fr/books/handbook/partiv.adoc b/documentation/content/fr/books/handbook/partiv.adoc
index d07a066d99..f81c0a7382 100644
--- a/documentation/content/fr/books/handbook/partiv.adoc
+++ b/documentation/content/fr/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/dtrace
next: books/handbook/serialcomms
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[network-communication]]
= Réseau
@@ -18,4 +26,4 @@ FreeBSD est un des systèmes d'exploitation les plus utilisé pour les serveurs
Ces chapitres sont destinés à être lus quand une information est nécessaire. Il n'est pas utile de les lire suivant un ordre particulier, ni de tous les lire avant de pouvoir utiliser FreeBSD dans un environnement réseau.
-include::content/fr/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/fr/books/handbook/partv.adoc b/documentation/content/fr/books/handbook/partv.adoc
index 73435a8887..78c7b52eb4 100644
--- a/documentation/content/fr/books/handbook/partv.adoc
+++ b/documentation/content/fr/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
next: books/handbook/mirrors
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= Annexes
-include::content/fr/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/fr/books/handbook/pgpkeys/_index.adoc b/documentation/content/fr/books/handbook/pgpkeys/_index.adoc
index febab06565..4b3373484e 100644
--- a/documentation/content/fr/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/fr/books/handbook/pgpkeys/_index.adoc
@@ -9,29 +9,46 @@ next: books/handbook/freebsd-glossary
[[pgpkeys]]
= Clés OpenPGP
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
-Les clés OpenPGP des officiers `FreeBSD.org` sont données ici. Ces clés peuvent être utilisées pour vérifier une signature ou pour envoyer un courrier électronique chiffré à un des officiers. Une liste complète des clés OpenPGP FreeBSD est disponible dans l'article link:{pgpkeys}[Clés PGP]. Le trouseau complet peut être télécharger depuis link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
+Les clés OpenPGP des officiers `FreeBSD.org` sont données ici. Ces clés peuvent être utilisées pour vérifier une signature ou pour envoyer un courrier électronique chiffré à un des officiers. Une liste complète des clés OpenPGP FreeBSD est disponible dans l'article extref:{pgpkeys}[Clés PGP]. Le trouseau complet peut être télécharger depuis link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
[[pgpkeys-officers]]
== Officers
diff --git a/documentation/content/fr/books/handbook/ports/_index.adoc b/documentation/content/fr/books/handbook/ports/_index.adoc
index 65968b03e4..83d2830152 100644
--- a/documentation/content/fr/books/handbook/ports/_index.adoc
+++ b/documentation/content/fr/books/handbook/ports/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/x11
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ports-synopsis]]
== Synopsis
@@ -413,7 +412,7 @@ Ce répertoire peut également contenir d'autres fichiers utilisés pour la comp
* Un fichier [.filename]#pkg-descr#. C'est une description plus détaillée du programme, souvent en plusieurs lignes.
* Un fichier [.filename]#pkg-plist#. C'est une liste de tous les fichiers qui seront installés par le logiciel porté. Il indique également au système des logiciels portés quels fichiers sont à effacer lors d'une désinstallation.
-Certains logiciels portés utilisent d'autres fichiers, comme [.filename]#pkg-message#. Le catalogue des logiciels portés utilise ces fichiers pour faire face à certaines situations spéciales. Si vous désirez plus de détails au sujet de ces fichiers, et sur les logiciels portés en général, consultez le link:{porters-handbook}[Manuel du développeur de logiciels portés].
+Certains logiciels portés utilisent d'autres fichiers, comme [.filename]#pkg-message#. Le catalogue des logiciels portés utilise ces fichiers pour faire face à certaines situations spéciales. Si vous désirez plus de détails au sujet de ces fichiers, et sur les logiciels portés en général, consultez le extref:{porters-handbook}[Manuel du développeur de logiciels portés].
Le logiciel porté contient les instructions pour compiler le code source, mais ne contient pas le code source. Vous pouvez obtenir le code source à partie d'un CDROM ou de l'Internet. Le code source est distribué de la façon dont l'auteur le désire. Fréquemment c'est une archive tar compressée avec gzip, mais elle pourra être compressée avec un autre outil ou même non compressée. Le code source d'un programme, peu importe la forme sous laquelle il est distribué, est appelé un fichier "distfile". Les deux méthodes pour l'installation d'un logiciel porté pour FreeBSD sont décrites ci-dessous.
@@ -813,11 +812,11 @@ Si vous rencontrez un portage qui ne fonctionne pas, il y a certaines choses que
+
[NOTE]
====
-Certains logiciels portés ne sont pas maintenus par une personne mais par une link:{mailing-list-faq}[liste de diffusion]. Plusieurs, si ce n'est toutes, les adresses de ces listes ressemblent à mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org]. Veuillez prendre cela en compte en rédigeant vos questions.
+Certains logiciels portés ne sont pas maintenus par une personne mais par une extref:{mailing-list-faq}[liste de diffusion]. Plusieurs, si ce n'est toutes, les adresses de ces listes ressemblent à mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org]. Veuillez prendre cela en compte en rédigeant vos questions.
En particulier, les logiciels portés apparaissant comme maintenus par mailto:ports@FreeBSD.org[ports@FreeBSD.org] ne sont en fait maintenus par personne. Correctifs et aide, s'ils y en a, provient de la communauté qui est abonnée à cette liste de diffusion. Des volontaires supplémentaires sont toujours les bienvenus!
====
+
-Si vous n'obtenez pas de réponse, vous pouvez utiliser man:send-pr[1] pour soumettre un rapport de bogue (consultez link:{problem-reports}[Ecrire des rapports de bogue pour FreeBSD]).
-. Corrigez le problème! Le link:{porters-handbook}[Manuel du développeur de logiciels portés] inclut des informations détaillées sur l'infrastructure des logiciels portés vous permettant de corriger le portage éventuellement défectueux ou même soumettre le votre!
+Si vous n'obtenez pas de réponse, vous pouvez utiliser man:send-pr[1] pour soumettre un rapport de bogue (consultez extref:{problem-reports}[Ecrire des rapports de bogue pour FreeBSD]).
+. Corrigez le problème! Le extref:{porters-handbook}[Manuel du développeur de logiciels portés] inclut des informations détaillées sur l'infrastructure des logiciels portés vous permettant de corriger le portage éventuellement défectueux ou même soumettre le votre!
. Récupérez la version pré-compilée sur un serveur FTP proche de vous. Le catalogue de "référence" des logiciels pré-compilés se trouve sur `ftp.FreeBSD.org` dans le répertoire link:ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/[packages], mais vérifiez _d'abord_ votre http://mirrorlist.FreeBSD.org/[miroir local]! Il y a globalement plus de chances que cela marche, que d'essayez de compiler à partir des sources, et cela va également beaucoup plus vite. Utilisez le programme man:pkg_add[1] pour installer le logiciel pré-compilé sur votre système.
diff --git a/documentation/content/fr/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/fr/books/handbook/ppp-and-slip/_index.adoc
index 210f262e9f..efa0cfa219 100644
--- a/documentation/content/fr/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/fr/books/handbook/ppp-and-slip/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/mail
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 28
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 28
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ppp-and-slip-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/preface/_index.adoc b/documentation/content/fr/books/handbook/preface/_index.adoc
index b1b1165ee5..5e8ef15671 100644
--- a/documentation/content/fr/books/handbook/preface/_index.adoc
+++ b/documentation/content/fr/books/handbook/preface/_index.adoc
@@ -13,13 +13,31 @@ next: books/handbook/parti
:icons: font
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-audience]]
== Public visé
diff --git a/documentation/content/fr/books/handbook/printing/_index.adoc b/documentation/content/fr/books/handbook/printing/_index.adoc
index e3d77dc6f3..1972c0fcbc 100644
--- a/documentation/content/fr/books/handbook/printing/_index.adoc
+++ b/documentation/content/fr/books/handbook/printing/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/linuxemu
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/printing/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[printing-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/security/_index.adoc b/documentation/content/fr/books/handbook/security/_index.adoc
index 69a3f7b699..ffcdc35e24 100644
--- a/documentation/content/fr/books/handbook/security/_index.adoc
+++ b/documentation/content/fr/books/handbook/security/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/jails
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-synopsis]]
== Synopsis
@@ -1027,7 +1026,7 @@ Dans tous les exemples de cette section, et d'autres sections, vous remarquerez
Pour d'autres documents détaillant l'implémentation d'IPsec, jetez un oeil à http://www.daemonnews.org/200101/ipsec-howto.html[http://www.daemonnews.org/200101/ipsec-howto.html] et http://www.freebsddiary.org/ipsec.php[http://www.freebsddiary.org/ipsec.php].
====
-Le mécanisme IPsec fournit des communications sécurisées sur couche IP ou à travers les _sockets_. Cette section explique comment l'utiliser. Pour des détails concernant l'implémentation d'IPsec, reportez-vous au link:{developers-handbook}#ipv6[Manuel du développeur].
+Le mécanisme IPsec fournit des communications sécurisées sur couche IP ou à travers les _sockets_. Cette section explique comment l'utiliser. Pour des détails concernant l'implémentation d'IPsec, reportez-vous au extref:{developers-handbook}[Manuel du développeur, ipv6].
L'implémentation actuelle d'IPsec supporte le mode transport et le mode tunnel. Cependant, il y a des restrictions au mode tunnel. http://www.kame.net/newsletter/[http://www.kame.net/newsletter/] fournit des exemples plus exhaustifs.
diff --git a/documentation/content/fr/books/handbook/serialcomms/_index.adoc b/documentation/content/fr/books/handbook/serialcomms/_index.adoc
index c9562b97dd..d16bc4083f 100644
--- a/documentation/content/fr/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/fr/books/handbook/serialcomms/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/ppp-and-slip
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[serial-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/users/_index.adoc b/documentation/content/fr/books/handbook/users/_index.adoc
index e8dbaeebe2..b0df81945c 100644
--- a/documentation/content/fr/books/handbook/users/_index.adoc
+++ b/documentation/content/fr/books/handbook/users/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/security
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/users/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/users/
-endif::[]
+:images-path: books/handbook/users/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/users/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[users-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/vinum/_index.adoc b/documentation/content/fr/books/handbook/vinum/_index.adoc
index e20cc16b7b..f611f01efb 100644
--- a/documentation/content/fr/books/handbook/vinum/_index.adoc
+++ b/documentation/content/fr/books/handbook/vinum/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/virtualization
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/vinum/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/vinum/
-endif::[]
+:images-path: books/handbook/vinum/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/vinum/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[vinum-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/virtualization/_index.adoc b/documentation/content/fr/books/handbook/virtualization/_index.adoc
index 4b0b1f0afd..8538c98ef9 100644
--- a/documentation/content/fr/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/fr/books/handbook/virtualization/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/l10n
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/virtualization/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
-endif::[]
+:images-path: books/handbook/virtualization/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[virtualization-synopsis]]
== Synopsis
diff --git a/documentation/content/fr/books/handbook/x11/_index.adoc b/documentation/content/fr/books/handbook/x11/_index.adoc
index 293170457c..53ea303602 100644
--- a/documentation/content/fr/books/handbook/x11/_index.adoc
+++ b/documentation/content/fr/books/handbook/x11/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/partii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[x11-synopsis]]
== Synopsis
@@ -1039,7 +1038,7 @@ L'installation du paquet binaire Compiz Fusion est simple, mais sa configuration
Les effets visuels dans l'environnement de bureau peuvent être à l'origine d'une charge non-négligeable pour la carte graphique. Pour les cartes graphiques nVidia, le pilote de périphérique propriétaire est nécessaire pour obtenir de bonnes performances. Les utilisateurs d'autres cartes graphiques peuvent sauter cette section et poursuivre avec la partie sur la configuration d'[.filename]#xorg.conf#.
-Pour déterminer quel pilote nVidia est requis, consultez la link:{faq}#idp59950544[FAQ à ce sujet].
+Pour déterminer quel pilote nVidia est requis, consultez la extref:{faq}[FAQ à ce sujet, idp59950544].
Après avoir déterminé le pilote correct à utiliser pour votre carte, l'installation est aussi simple que d'installer n'importe quel autre paquet binaire.
diff --git a/documentation/content/fr/books/handbook/zfs/_index.adoc b/documentation/content/fr/books/handbook/zfs/_index.adoc
index b781b1db93..215091fefb 100644
--- a/documentation/content/fr/books/handbook/zfs/_index.adoc
+++ b/documentation/content/fr/books/handbook/zfs/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/filesystems
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:table-caption: Tableau
-:example-caption: Exemple
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/zfs/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/zfs/
-endif::[]
+:images-path: books/handbook/zfs/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/zfs/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[zfs-differences]]
== What Makes ZFS Different
diff --git a/documentation/content/fr/books/porters-handbook/book.adoc b/documentation/content/fr/books/porters-handbook/book.adoc
index 78455565be..e95a1cea03 100644
--- a/documentation/content/fr/books/porters-handbook/book.adoc
+++ b/documentation/content/fr/books/porters-handbook/book.adoc
@@ -3,7 +3,6 @@ title: Le guide du créateur de ports
authors:
- author: The FreeBSD Documentation Project
copyright: 2000-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "sun", "unix", "general"]
---
@@ -12,50 +11,35 @@ trademarks: ["freebsd", "sun", "unix", "general"]
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Table des matières
-:part-signifier: Partie
-:chapter-signifier: Chapitre
-:appendix-caption: Annexe
-:table-caption: Tableau
-:example-caption: Exemple
-
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+:book: true
+:pdf: false
+:images-path: books/porters-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
-:chapters-path: content/fr/books/porters-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/porters-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/fr/mailing-lists.adoc[]
-include::../../../../shared/fr/teams.adoc[]
-include::../../../../shared/fr/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/fr/mailing-lists.adoc[]
-include::../../../../shared/fr/teams.adoc[]
-include::../../../../shared/fr/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
diff --git a/documentation/content/hu/articles/cups/_index.adoc b/documentation/content/hu/articles/cups/_index.adoc
index 9a37f2eca2..b53ea5c143 100644
--- a/documentation/content/hu/articles/cups/_index.adoc
+++ b/documentation/content/hu/articles/cups/_index.adoc
@@ -3,7 +3,6 @@ title: A CUPS használata FreeBSD rendszereken
authors:
- author: Chess Griffin
email: chess@chessgriffin.com
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -16,10 +15,27 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
+:images-path: articles/cups/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Kivonat
diff --git a/documentation/content/hu/articles/explaining-bsd/_index.adoc b/documentation/content/hu/articles/explaining-bsd/_index.adoc
index b2cb04bc6e..ac3c35dcd4 100644
--- a/documentation/content/hu/articles/explaining-bsd/_index.adoc
+++ b/documentation/content/hu/articles/explaining-bsd/_index.adoc
@@ -3,7 +3,6 @@ title: A BSD bemutatása
authors:
- author: Greg Lehey
email: grog@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "amd", "apple", "intel", "xfree86", "linux", "opengroup", "sparc", "sun", "unix", "general"]
---
@@ -16,21 +15,26 @@ trademarks: ["freebsd", "amd", "apple", "intel", "xfree86", "linux", "opengroup"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
+:images-path: articles/explaining-bsd/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
diff --git a/documentation/content/hu/articles/gjournal-desktop/_index.adoc b/documentation/content/hu/articles/gjournal-desktop/_index.adoc
index aade9b35ca..06a7c4fc85 100644
--- a/documentation/content/hu/articles/gjournal-desktop/_index.adoc
+++ b/documentation/content/hu/articles/gjournal-desktop/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Manolis Kiagias
email: manolis@FreeBSD.org
- author: Kiagias
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -17,32 +16,27 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
+:images-path: articles/gjournal-desktop/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/urls.adoc[]
-:imagesdir: ../../../images/articles/gjournal-desktop/
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/hu/mailing-lists.adoc[]
-include::../../../../shared/hu/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/hu/mailing-lists.adoc[]
-include::../../../../shared/hu/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
endif::[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Kivonat
@@ -315,7 +309,7 @@ options UFS_GJOURNAL # Megjegyzés: Ez része a GENERIC rendszermagnak
options GEOM_JOURNAL # Ezt se felejtsük ki
....
-A link:{handbook}#kernelconfig[FreeBSD kézikönyvben] szereplõ utasítások mentén fordítsuk le és telepítsük az új rendszermagot.
+A extref:{handbook}kernelconfig[FreeBSD kézikönyvben, kernelconfig] szereplõ utasítások mentén fordítsuk le és telepítsük az új rendszermagot.
Ha korábban használtuk volna a modult, akkor ezzel együtt ne felejtsük el kivenni a [.filename]#/boot/loader.conf# állományból sem a hozzá tartozó sort.
@@ -436,7 +430,7 @@ Végül a [.filename]#/boot/loader.conf# állományból távolítsuk el a `geom_
A naplózás még viszonylag újdonságnak számít a FreeBSD esetében, ezért nem feltétlenül találunk róla túlságosan sok dokumentációt. Ettõl függetlenül azonban a következõ források elolvasása azért hasznosnak bizonyulhat:
-* A FreeBSD kézikönyv naplózással foglalkozó link:{handbook}#geom-gjournal[szakasza].
+* A FreeBSD kézikönyv naplózással foglalkozó extref:{handbook}geom[szakasza, geom-gjournal].
* `{pjd}`, a man:gjournal[8] fejlesztõjének a {freebsd-current} levelezési listára küldött http://lists.freebsd.org/pipermail/freebsd-current/2006-June/064043.html[levele].
* `{ivoras}` a {freebsd-questions} levelezési listára küldött http://lists.freebsd.org/pipermail/freebsd-questions/2008-April/173501.html[levele].
* A man:gjournal[8] és man:geom[8] man oldalak.
diff --git a/documentation/content/hu/articles/linux-users/_index.adoc b/documentation/content/hu/articles/linux-users/_index.adoc
index 12b023c7de..59ffd0acab 100644
--- a/documentation/content/hu/articles/linux-users/_index.adoc
+++ b/documentation/content/hu/articles/linux-users/_index.adoc
@@ -3,7 +3,6 @@ title: FreeBSD gyorstalpaló Linux® felhasználók számára
authors:
- author: Ferrell, John
copyright: 2008 A FreeBSD Dokumentációs Projekt
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"]
---
@@ -16,21 +15,26 @@ trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-
-ifeval::["{backend}" == "html5"]
-include::shared/hu/urls.adoc[]
+:images-path: articles/linux-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/hu/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/hu/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -49,14 +53,14 @@ toc::[]
Ebben a leírásban a FreeBSD és a Linux(R) közti alapvetõ eltéréseket igyekszünk szemléltetni, aminek révén a középhaladó és haladó Linux(R) felhasználók pillanatok alatt bepillantást nyerhetnek a FreeBSD alapjaiba. Ez egyszerûen csak egy szakmai jellegû bevezetés, és nem foglalkozik a két rendszer felépítése közti "filozófiai" különbségekkel.
-A leírás feltételezi, hogy korábban már telepítettük a FreeBSD rendszert. Amennyiben ezt még nem tettük volna meg, vagy segítségre lenne szükségünk a telepítésben, akkor olvassuk el a FreeBSD kézikönyv link:{handbook}#install[A FreeBSD telepítése] címû fejezetét.
+A leírás feltételezi, hogy korábban már telepítettük a FreeBSD rendszert. Amennyiben ezt még nem tettük volna meg, vagy segítségre lenne szükségünk a telepítésben, akkor olvassuk el a FreeBSD kézikönyv extref:{handbook}install[A FreeBSD telepítése, install] címû fejezetét.
[[shells]]
== Parancsértelmezõk: hova tûnt a Bash?
A Linuxról áttérõ felhasználók gyakran meglepõdnek azon, hogy a FreeBSD-ben nem a Bash az alapértelmezett parancsértelmezõ. Sõt, a Bash még az alaprendszerben sem található meg. Helyette a man:tcsh[1] az alapértelmezett parancsértelmezõ a FreeBSD-ben. Természetesen a Bash, a többi szintén közkedvelt parancsértelmezõhöz hasonlóan megtalálható a FreeBSD <<SOFTWARE, Csomag- és Portgyûjteményében>>.
-Ha más parancsértelmezõket is telepítettünk, akkor a man:chsh[1] parancs segítségével tudjuk megváltoztatni az alapértelmezett parancsértelmezõnket. A `root` felhasználó alapértelmezett parancsértelmezõjének megváltoztatását azonban nem javasoljuk. Ennek oka, hogy azok a parancsértelmezõk, amelyek nem részei az alaprendszernek, általában a [.filename]#/usr/local/bin# vagy a [.filename]#/usr/bin# könyvtárakban találhatóak, és bizonyos vészhelyzetekben elõfordulhat, hogy ezeket az állományrendszereket nem tudjuk csatlakoztatni. Ilyen esetekben a `root` sem lesz képes elérni a saját alapértelmezett parancsértelmezõjét, amivel lényegében megakadályozzuk, hogy be tudjon jelentkezni. Erre a célra a `root` felhasználó egy alternatíváját, a `toor` felhasználót hozták létre, amelyet az alaprendszeren kívül található parancsértelmezõkkel is használhatunk. A link:{faq}#TOOR-ACCOUNT[toor hozzáférésérõl] a GYIK biztonsági kérdésekkel foglalkozó részében tudhatunk meg többet (angolul).
+Ha más parancsértelmezõket is telepítettünk, akkor a man:chsh[1] parancs segítségével tudjuk megváltoztatni az alapértelmezett parancsértelmezõnket. A `root` felhasználó alapértelmezett parancsértelmezõjének megváltoztatását azonban nem javasoljuk. Ennek oka, hogy azok a parancsértelmezõk, amelyek nem részei az alaprendszernek, általában a [.filename]#/usr/local/bin# vagy a [.filename]#/usr/bin# könyvtárakban találhatóak, és bizonyos vészhelyzetekben elõfordulhat, hogy ezeket az állományrendszereket nem tudjuk csatlakoztatni. Ilyen esetekben a `root` sem lesz képes elérni a saját alapértelmezett parancsértelmezõjét, amivel lényegében megakadályozzuk, hogy be tudjon jelentkezni. Erre a célra a `root` felhasználó egy alternatíváját, a `toor` felhasználót hozták létre, amelyet az alaprendszeren kívül található parancsértelmezõkkel is használhatunk. A extref:{faq}[toor hozzáférésérõl, TOOR-ACCOUNT] a GYIK biztonsági kérdésekkel foglalkozó részében tudhatunk meg többet (angolul).
[[software]]
== Csomagok és portok: szoftverek telepítése FreeBSD alatt
@@ -94,14 +98,14 @@ Ha a FreeBSD valamelyik kiadását használjuk (6.2, 6.3, 7.0 stb., tehát CD-r
A FreeBSD különbözõ változatairól a link:{version-guide}[Válasszuk ki a nekünk igazán megfelelõ FreeBSD verziót!] címû cikkben olvashatunk bõvebben.
====
-A csomagok használatával kapcsolatban a FreeBSD kézikönyvében kaphatunk részletesebb felvilágosítást, lásd link:{handbook}#packages-using[A csomagrendszer használata].
+A csomagok használatával kapcsolatban a FreeBSD kézikönyvében kaphatunk részletesebb felvilágosítást, lásd extref:{handbook}ports[A csomagrendszer használata, packages-using].
[[ports]]
=== Portok
A FreeBSD-ben az alkalmazások telepítésének másik módja a Portgyûjtemény használata. A Portgyûjtemény lényegében [.filename]#Makefile# állományok és javítások gyûjteménye, amelyek a különféle alkalmazások forráskódját készítik fel arra, hogy a FreeBSD-n is használhatóak legyenek. Amikor telepítünk egy portot, akkor a rendszer elõször letölti az alkalmazás forráskódját, elvégzi a szükséges módosításokat, lefordítja a forrást és végül telepíti az alkalmazást (valamint mindezt megteszi az összes függõsége esetében).
-A Portgyûjtemény, vagy gyakran egyszerûen csak a "portfa", a [.filename]#/usr/ports# könyvtárban található. Itt nyilván feltételezzük, hogy a Portgyûjteményt is kiválasztottuk a FreeBSD telepítése során. Amennyiben a Portgyûjteményt még nem telepítettük volna, a man:sysinstall[8] segítségével feltehetjük a telepítõlemezrõl, vagy esetleg a man:csup[1], illetve man:portsnap[8] használatával letölthetjük a FreeBSD Projekt valamelyik szerverérõl. A Portgyûjtemény telepítésének részletes bemutatása megtalálható a kézikönyv link:{handbook}#ports-using[4.5.1. szakaszában].
+A Portgyûjtemény, vagy gyakran egyszerûen csak a "portfa", a [.filename]#/usr/ports# könyvtárban található. Itt nyilván feltételezzük, hogy a Portgyûjteményt is kiválasztottuk a FreeBSD telepítése során. Amennyiben a Portgyûjteményt még nem telepítettük volna, a man:sysinstall[8] segítségével feltehetjük a telepítõlemezrõl, vagy esetleg a man:csup[1], illetve man:portsnap[8] használatával letölthetjük a FreeBSD Projekt valamelyik szerverérõl. A Portgyûjtemény telepítésének részletes bemutatása megtalálható a kézikönyv extref:{handbook}ports[4.5.1. szakaszában, ports-using].
A telepítéshez (általában) csak be kell lépnünk az adott port könyvtárába és el kell indítanunk a fordítást. A következõ példában az Apache 2.2 alkalmazást telepítjük a Portgyûjteménybõl:
@@ -119,7 +123,7 @@ A portok alkalmazásának egyik legnagyobb elõnye, hogy a szoftverek telepíté
# make WITH_LDAP="YES" install clean
....
-A Portgyûjteménnyel kapcsolatos további információk tekintetében olvassuk el a FreeBSD kézikönyv link:{handbook}#ports-using[A Portgyûjtemény használata] címû szakaszát.
+A Portgyûjteménnyel kapcsolatos további információk tekintetében olvassuk el a FreeBSD kézikönyv extref:{handbook}ports[A Portgyûjtemény használata, ports-using] címû szakaszát.
[[which]]
=== Portok vagy csomagok, mégis melyiket használjam?
@@ -225,9 +229,9 @@ ifconfig_em0="DHCP"
Hasonlóan a Linuxban található IPTABLES megoldáshoz, a FreeBSD is kínál fel rendszermagszintû tûzfalazást. A FreeBSD jelen pillanatban három tûzfalat támogat:
-* link:{handbook}#firewalls-ipfw[IPFIREWALL]
-* link:{handbook}#firewalls-ipf[IPFILTER]
-* link:{handbook}#firewalls-pf[PF]
+* extref:{handbook}firewalls[IPFIREWALL, firewalls-ipfw]
+* extref:{handbook}firewalls[IPFILTER, firewalls-ipf]
+* extref:{handbook}firewalls[PF, firewalls-pf]
Az IPFIREWALL, avagy IPFW (az IPFW szabályrendszereit az man:ipfw[8] paranccsal tudjuk kezelni) a FreeBSD fejlesztõi által készített és karbantartott tûzfal. A forgalomszabályozás megvalósításához és különbözõ típusú hálózati kapcsolatok szimulációjához az IPFW kiegészíthetõ a man:dummynet[4] használatával.
@@ -261,7 +265,7 @@ pass in on $ext_if inet proto tcp from any to ($ext_if) port 22
A FreeBSD rendszer háromféleképpen frissíthetõ: forráskódból, binárisan és telepítõlemezek használatával.
-A forráskódon keresztüli frissítés ugyan a legbonyolultabb ezek közül, azonban ez kínálja fel egyben a legnagyobb rugalmasságot is. Ennek során szinkronizálnunk kell a FreeBSD forráskódjának nálunk levõ (helyi) másolatát a FreeBSD CVS (Concurrent Versioning System) szervereivel. Miután ez megtörtént, le tudjuk fordítani a rendszermagot és a hozzá tartozó programokat. A források frissítésével kapcsolatban olvassuk el a FreeBSD kézikönyv link:{handbook}#updating-upgrading[frissítésrõl szóló fejezetét].
+A forráskódon keresztüli frissítés ugyan a legbonyolultabb ezek közül, azonban ez kínálja fel egyben a legnagyobb rugalmasságot is. Ennek során szinkronizálnunk kell a FreeBSD forráskódjának nálunk levõ (helyi) másolatát a FreeBSD CVS (Concurrent Versioning System) szervereivel. Miután ez megtörtént, le tudjuk fordítani a rendszermagot és a hozzá tartozó programokat. A források frissítésével kapcsolatban olvassuk el a FreeBSD kézikönyv extref:{handbook}updating-upgrading[frissítésrõl szóló fejezetét, updating-upgrading].
A bináris frissítés a Linux(R) típusú rendszereken elérhetõ `yum` vagy `apt-get` parancsok esetén megszokottakhoz hasonló. A man:freebsd-update[8] parancs letölti a frissítéseket és telepíti ezeket. Ez a frissítési folyamat a man:cron[8] használatával ütemezhetõ.
@@ -319,7 +323,7 @@ kern.posix1version: 200112
Bizonyos `sysctl`-értékek írásvédettek.
====
-Adódhatnak olyan alkalmak, amikor mégis szükségünk lehet a procfs használatára, mint például régi szoftverek futtatása, a rendszerhívások nyomkövetése a man:truss[1] segítségével, vagy a link:{handbook}#linuxemu[bináris Linux kompatibilitás] használata. (Noha a bináris Linux kompatibilitás egy saját procfs állományrendszert, egy man:linprocfs[5] rendszert használ.) A procfs típusú állományrendszerek csatlakoztatásához a következõt kell megadnunk az [.filename]#/etc/fstab# állományban:
+Adódhatnak olyan alkalmak, amikor mégis szükségünk lehet a procfs használatára, mint például régi szoftverek futtatása, a rendszerhívások nyomkövetése a man:truss[1] segítségével, vagy a extref:{handbook}linuxemu[bináris Linux kompatibilitás, linuxemu] használata. (Noha a bináris Linux kompatibilitás egy saját procfs állományrendszert, egy man:linprocfs[5] rendszert használ.) A procfs típusú állományrendszerek csatlakoztatásához a következõt kell megadnunk az [.filename]#/etc/fstab# állományban:
[source,shell]
....
@@ -394,4 +398,4 @@ A procfs típusú állományrendszereket így lehet csatlakoztatni:
[[conclusion]]
== Lezárás
-Bízunk benne, hogy ez a leírás eleget mutatott be ahhoz, hogy elkezdjünk ismerkedni a FreeBSD-vel. Ha az érintett témák még jobban érdekelnek minket, vagy olyanról szeretnénk többet megtudni, ami itt nem szerepelt, akkor mindenképpen olvassunk bele a link:{handbook}[FreeBSD kézikönyvbe].
+Bízunk benne, hogy ez a leírás eleget mutatott be ahhoz, hogy elkezdjünk ismerkedni a FreeBSD-vel. Ha az érintett témák még jobban érdekelnek minket, vagy olyanról szeretnénk többet megtudni, ami itt nem szerepelt, akkor mindenképpen olvassunk bele a extref:{handbook}[FreeBSD kézikönyvbe].
diff --git a/documentation/content/hu/books/faq/_index.adoc b/documentation/content/hu/books/faq/_index.adoc
index 3a61b2f468..851426cb3c 100644
--- a/documentation/content/hu/books/faq/_index.adoc
+++ b/documentation/content/hu/books/faq/_index.adoc
@@ -3,8 +3,8 @@ title: Gyakran Ismételt Kérdések a FreeBSD 6.X, 7.X és 8.X változatairól
authors:
- author: A FreeBSD Dokumentációs Projekt
copyright: 1995-2020 A FreeBSD Dokumentációs Projekt
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "ibm", "ieee", "3com", "adobe", "intel", "linux", "microsoft", "opengroup", "sparc", "sun", "oracle", "xfree86", "general"]
+trademarks: ["freebsd", "ibm", "ieee", "3com", "adobe", "intel", "linux", "microsoft", "opengroup", "sparc", "sun", "oracle", "xfree86", "general"]
+isIndex: true
---
= Gyakran Ismételt Kérdések a FreeBSD 6.X, 7.X és 8.X változatairól
@@ -12,63 +12,52 @@ trademarks: ["freebsd", "ibm", "ieee", "3com", "adobe", "intel", "linux", "micro
:toc: macro
:toclevels: 1
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:rel-numbranch: 3
-:rel-head: 13-CURRENT
-:rel-head-relx: 13.X
+:images-path: books/faq/
+:rel-numbranch: 4
+:rel-head: 14-CURRENT
+:rel-head-relx: 14.X
:rel-head-releng: head/
-:rel-relx: 12.X
-:rel-stable: 12-STABLE
-:rel-releng: stable/12/
+:rel-relx: 13.X
+:rel-stable: 13-STABLE
+:rel-releng: stable/13/
:rel-relengdate: December 2018
-:rel2-relx: 11.X
-:rel2-stable: 11-STABLE
-:rel2-releng: stable/11/
-:rel2-relengdate: October 2016
-
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+:rel2-relx: 12.X
+:rel2-stable: 12-STABLE
+:rel2-releng: stable/12/
+:rel2-relengdate: December 2018
+:rel3-relx: 11.X
+:rel3-stable: 11-STABLE
+:rel3-releng: stable/11/
+:rel3-relengdate: October 2016
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/hu/mailing-lists.adoc[]
-include::../../../../shared/hu/teams.adoc[]
-include::../../../../shared/hu/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/hu/mailing-lists.adoc[]
-include::../../../../shared/hu/teams.adoc[]
-include::../../../../shared/hu/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
Kivonat
-Ezek a gyakran ismételt kérdések a FreeBSD 6.__X__, 7.__X__ és 8.__X__ változataira vonatkoznak. Az összes bejegyzés a FreeBSD 6._X_ vagy annál újabb változataira vonatkozik, hacsak azt külön nem jelezzük. Ha szeretnénk segíteni a projektnek, akkor küldjünk egy levelet a {freebsd-doc} címére! Ennek a dokumentumnak a legfrissebb változata mindig elérhetõ a link:{faq}/[FreeBSD World Wide Web szerverérõl]. HTTP-n keresztül letölthetõ egyetlen nagy link:.[HTML] állományként, vagy link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[a FreeBSD FTP szerverérõl] szöveges, PostScript(R) PDF stb. formátumban. Továbbá link:https://www.FreeBSD.org/search/[keresni is tudunk a GYIK-ban].
+Ezek a gyakran ismételt kérdések a FreeBSD 6.__X__, 7.__X__ és 8.__X__ változataira vonatkoznak. Az összes bejegyzés a FreeBSD 6._X_ vagy annál újabb változataira vonatkozik, hacsak azt külön nem jelezzük. Ha szeretnénk segíteni a projektnek, akkor küldjünk egy levelet a {freebsd-doc} címére! Ennek a dokumentumnak a legfrissebb változata mindig elérhetõ a extref:{faq}/[FreeBSD World Wide Web szerverérõl]. HTTP-n keresztül letölthetõ egyetlen nagy link:.[HTML] állományként, vagy link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[a FreeBSD FTP szerverérõl] szöveges, PostScript(R) PDF stb. formátumban. Továbbá link:https://www.FreeBSD.org/search/[keresni is tudunk a GYIK-ban].
__Fordította: Páli Gábor, utolsó ellenõrzés: 2010.11.28.__
@@ -90,7 +79,7 @@ Ha tömören akarjuk összefoglalni, akkor a FreeBSD egy AMD64, Intel(R) EM64T,
A FreeBSD-t munkához, oktatáshoz és szórakozáshoz rengeteg cég, internetszolgáltató, kutató, informatikus, diák és otthoni felhasználó használja a világ minden táján.
-A FreeBSD bõvebb bemutatásához olvassuk el a link:{handbook}[FreeBSD kézikönyvet].
+A FreeBSD bõvebb bemutatásához olvassuk el a extref:{handbook}[FreeBSD kézikönyvet].
=== Mi a FreeBSD Projekt célja?
@@ -113,7 +102,7 @@ Sokan nem is magát az operációs rendszert, hanem inkább az alkalmazásokat h
Ha viszont olyan alkalmazást kívánunk használni, amely csak bizonyos operációs rendszereken érhetõ el, nem tudjuk magát az operációs rendszert egyszerûen lecserélni alatta. Bizonyos esetekben azonban elõfordulhat, hogy FreeBSD alatt is találunk hozzá hasonló alkalmazásokat. Amikor egy stabil irodai vagy internet szerverre van szükségünk, esetleg egy megbízható munkaállomásra, vagy egyszerûen csak megszakítások nélkül szeretnénk végezni a munkánkat, a FreeBSD-ben igényeinkhez mérten szinte minden megtalálhatunk. A világon rengeteg felhasználó, beleértve a kezdõket és a tapasztalt UNIX(R) rendszergazdákat egyaránt, asztali operációs rendszerként is a FreeBSD-t használja.
-Ha egy másik UNIX(R) környezetrõl akarunk FreeBSD-re váltani, akkor a legtöbb dolog már ismerõs lehet számunkra. Amennyiben viszont valamilyen grafikus operációs rendszerrõl, például Windows(R)-ról vagy a Mac OS(R) valamelyik régebbi változatáról szándékozunk átállni, minden bizonnyal idõt kell majd szánnunk a feladatok UNIX(R) stílusú megvalósításának megismerésére. Ez a GYIK és a link:{handbook}[FreeBSD kézikönyv] ehhez tökéletes kiindulási alapot biztosít.
+Ha egy másik UNIX(R) környezetrõl akarunk FreeBSD-re váltani, akkor a legtöbb dolog már ismerõs lehet számunkra. Amennyiben viszont valamilyen grafikus operációs rendszerrõl, például Windows(R)-ról vagy a Mac OS(R) valamelyik régebbi változatáról szándékozunk átállni, minden bizonnyal idõt kell majd szánnunk a feladatok UNIX(R) stílusú megvalósításának megismerésére. Ez a GYIK és a extref:{handbook}[FreeBSD kézikönyv] ehhez tökéletes kiindulási alapot biztosít.
=== Miért hívják FreeBSD-nek?
@@ -143,7 +132,7 @@ A FreeBSD egyes kiadásairól a http://www.FreeBSD.org/releng/[Kiadások megjele
=== Mi az a FreeBSD-CURRENT?
-A link:{handbook}#CURRENT[FreeBSD-CURRENT] az operációs rendszer aktív fejlesztés alatt álló változata, amely idõvel az új FreeBSD-STABLE ággá válik. Ez a változat tulajdonképpen csak a rendszeren dolgozó fejlesztõk és a megátalkodott hobbifelhasználók számára érdekes. A link:{handbook}[kézikönyv] link:{handbook}#CURRENT[erre vonatkozó szakaszában] olvashatunk részletesebben a _-CURRENT_ használatáról.
+A extref:{handbook}updating-upgrading[FreeBSD-CURRENT, current] az operációs rendszer aktív fejlesztés alatt álló változata, amely idõvel az új FreeBSD-STABLE ággá válik. Ez a változat tulajdonképpen csak a rendszeren dolgozó fejlesztõk és a megátalkodott hobbifelhasználók számára érdekes. A extref:{handbook}[kézikönyv] extref:{handbook}updating-upgrading[erre vonatkozó szakaszában, current] olvashatunk részletesebben a _-CURRENT_ használatáról.
Ha nem mozgunk otthonosan az operációs rendszerek világában, vagy ha nem tudjuk megmondani a különbséget egy valódi és egy ideiglenes probléma között, akkor nem javasoljuk a FreeBSD-CURRENT használatát. Ez a fejlesztési vonal nagyon gyorsan fejlõdik és néha lefordíthatatlan állapotba kerül. A FreeBSD-CURRENT változat használóitól elvárjuk, hogy képesek legyenek felmérni a felbukkanó problémákat, és közülük csak azokat jelenteni, amelyek valóban hibákat takarnak és nem pedig csak apró "bökkenõk". Ezért a {freebsd-current} olvasói általában "A make world parancs valami csoportra panaszkodik" típusú kérdéseket általában figyelembe se veszik.
@@ -162,7 +151,7 @@ Minden aktívan fejlesztett ághoz havonta készülnek hivatalos pillanatkiadás
=== Mit takar a FreeBSD-STABLE?
-Amikor a FreeBSD 2.0.5 megjelent, a FreeBSD fejlesztése kettévált. Az egyik ág neve link:{handbook}#STABLE[-STABLE], a másiké pedig link:{handbook}#CURRENT[-CURRENT] lett. A _FreeBSD-STABLE_ az olyan internet-szolgáltatók és egyéb vállalkozások számára készült, ahol a fejlesztés alatt álló újítások vagy a hirtelen váltások által okozott problémák gyakran nem engedhetõek meg. Ide csak olyan hibajavítások és kisebb módosítások kerülnek, amelyeket alaposan leteszteltek. A _FreeBSD-CURRENT_ ezzel szemben a 2.0 megjelenése óta egyetlen, szakadásmentes fejlesztési vonalat képvisel, amely a {rel120-current}-RELEASE és az azon túli kiadások felé halad. Ha többet szeretnénk megtudni a jelenlegi ágak állapotáról és a következõ kiadások ütemezésérõl, akkor ezzel kapcsolatban olvassuk el a link:{releng}#REL-BRANCH[FreeBSD Release Engineering] címû cikk kiadások leágaztatásáról szóló részét (angolul). Az ágak jelenlegi állapota és a jövõbeni kiadások ütemterve a https://www.FreeBSD.org/releng[Kiadások információk oldalán] található (angolul).
+Amikor a FreeBSD 2.0.5 megjelent, a FreeBSD fejlesztése kettévált. Az egyik ág neve extref:{handbook}updating-upgrading[-STABLE, stable], a másiké pedig extref:{handbook}updating-upgrading[-CURRENT, current] lett. A _FreeBSD-STABLE_ az olyan internet-szolgáltatók és egyéb vállalkozások számára készült, ahol a fejlesztés alatt álló újítások vagy a hirtelen váltások által okozott problémák gyakran nem engedhetõek meg. Ide csak olyan hibajavítások és kisebb módosítások kerülnek, amelyeket alaposan leteszteltek. A _FreeBSD-CURRENT_ ezzel szemben a 2.0 megjelenése óta egyetlen, szakadásmentes fejlesztési vonalat képvisel, amely a {rel120-current}-RELEASE és az azon túli kiadások felé halad. Ha többet szeretnénk megtudni a jelenlegi ágak állapotáról és a következõ kiadások ütemezésérõl, akkor ezzel kapcsolatban olvassuk el a extref:{releng}[FreeBSD Release Engineering, REL-BRANCH] címû cikk kiadások leágaztatásáról szóló részét (angolul). Az ágak jelenlegi állapota és a jövõbeni kiadások ütemterve a https://www.FreeBSD.org/releng[Kiadások információk oldalán] található (angolul).
A 2.2-STABLE ág a 2.2.8 megjelenésével nyugdíjba vonult. A 3-STABLE ág a 3.5.1 mint az utolsó 3._X_ kiadás megjelenésével ért véget. A 4-STABLE ág a 4.11 mint az utolsó 4._X_ kiadással fejezõdött be. Ezekbe az ágakban a legtöbb esetben már csak biztonsági javításokat végeznek. Az 5-STABLE ág fejlesztése az utolsó 5._X_ kiadás, az 5.5 megjelenésével lezárult. A 6-STABLE ág fejlesztése még folytatódik valameddig, de ez alatt leginkább már csak a biztonsági rések és egyéb komoly problémák javításait kell érteni.
@@ -180,7 +169,7 @@ Akik egy kicsivel több izgalomra vágynak, azok részére az elõbb említett,
=== Ki felel a FreeBSD-ért?
-A FreeBSD Projektre vonatkozó fontosabb döntéseket, mint például a Projekt haladási irányát vagy hogy vehet részt a forráskód fejlesztésében, egy 9 fõs https://www.FreeBSD.org/hu/administration/#t-core[irányító csoport] hozza. Rajtuk kívül még egy több mint 350 fõs link:{contributors}#STAFF-COMMITTERS[ fejlesztõi csapat] jogosult közvetlenül módosítani a FreeBSD forrásait.
+A FreeBSD Projektre vonatkozó fontosabb döntéseket, mint például a Projekt haladási irányát vagy hogy vehet részt a forráskód fejlesztésében, egy 9 fõs https://www.FreeBSD.org/hu/administration/#t-core[irányító csoport] hozza. Rajtuk kívül még egy több mint 350 fõs extref:{contributors}[fejlesztõi csapat, STAFF-COMMITTERS] jogosult közvetlenül módosítani a FreeBSD forrásait.
A legtöbb bonyolultabb változtatást általában azonban a megfelelõ <<mailing,levelezési listákon>> is megvitatják, amiben bárki különösebb korlátozás nélkül részt vehet.
@@ -192,7 +181,7 @@ A FreeBSD összes fontosabb kiadása elérhetõ anonim FTP-n keresztül a link:f
* Havonta készülnek link:https://www.FreeBSD.org/snapshots/[pillanatkiadások] a <<current,-CURRENT>> és a <<stable,-STABLE>> ágakból, de ezek leginkább a legújabb változatot tesztelõk és a fejlesztõk számára fontosak.
* A legfrissebb 7-STABLE kiadás, a {rel112-current}-RELEASE link:ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/{rel112-current}-RELEASE/[ebbõl] a könyvtárból érhetõ el.
-Ha a FreeBSD-t CD-n, DVD-n vagy más egyéb telepítõeszközön szeretnénk megkapni, akkor ezzel kapcsolatban nézzük meg link:{handbook}#mirrors/[a kézikönyvet].
+Ha a FreeBSD-t CD-n, DVD-n vagy más egyéb telepítõeszközön szeretnénk megkapni, akkor ezzel kapcsolatban nézzük meg extref:{handbook}mirrors/[a kézikönyvet, mirrors].
=== Hogyan lehet elérni a hibajelentések adatbázisát?
@@ -200,7 +189,7 @@ A felhasználók kéréseit tartalmazó hibajelentések adatbázisát a honlap w
A man:send-pr[1] parancs segítségével tudunk e-mailen keresztül hibajelentéseket és egyéb változtatási kéréseket küldeni. Emellett még böngészõ segítségével is tudunk hibajelentéseket küldeni a honlap http://www.freebsd.org/send-pr/[webes hibabejelentõ felületén].
-Mielõtt beküldenénk egy hibajelentést, olvassuk el a link:{problem-reports}[Writing FreeBSD Problem Reports] címû cikket (angolul), amelybõl megtudhatjuk, hogyan készítsünk jól hasznosítható hibajelentéseket.
+Mielõtt beküldenénk egy hibajelentést, olvassuk el a extref:{problem-reports}[Writing FreeBSD Problem Reports] címû cikket (angolul), amelybõl megtudhatjuk, hogyan készítsünk jól hasznosítható hibajelentéseket.
=== Honnan tudhatunk meg még többet?
@@ -210,7 +199,7 @@ Nézzük meg a http://www.FreeBSD.org[FreeBSD] Projekt honlapjáról elérhetõ
=== Milyen jó könyvek szólnak a FreeBSD-rõl?
-A Projekt igen széles körû dokumentációval rendelkezik, amely a következõ linkrõl érhetõ el: http://www.FreeBSD.org/docs/[http://www.FreeBSD.org/docs/]. Emellett a GYIK <<bibliography,végén szereplõ>>, valamint a kézikönyvben található link:{handbook}#bibliography/[irodalomjegyzék] tartalmazza az ajánlott könyveket.
+A Projekt igen széles körû dokumentációval rendelkezik, amely a következõ linkrõl érhetõ el: http://www.FreeBSD.org/docs/[http://www.FreeBSD.org/docs/]. Emellett a GYIK <<bibliography,végén szereplõ>>, valamint a kézikönyvben található extref:{handbook}bibliography/[irodalomjegyzék, bibliography] tartalmazza az ajánlott könyveket.
=== A dokumentáció elérhetõ más formátumokban is, például szöveges (ASCII) állományban vagy PostScript(R)-ben?
@@ -361,11 +350,11 @@ A mûvelet befejezõdésével kapunk néhány [.filename]#.html# kiterjesztésû
=== Hol található információ a FreeBSD levelezési listáiról?
-Az összes velük kapcsolatos információt a link:{handbook}#eresources-mail[kézikönyv levelezési listákról szóló részében] találjuk.
+Az összes velük kapcsolatos információt a extref:{handbook}eresources[kézikönyv levelezési listákról szóló részében, eresources-mail] találjuk.
=== Milyen FreeBSD hírcsoportok léteznek?
-Az összes rájuk vonatkozó információt a link:{handbook}#eresources-news/[kézikönyv hírcsoportokról szóló részében] találjuk meg.
+Az összes rájuk vonatkozó információt a extref:{handbook}eresources/[kézikönyv hírcsoportokról szóló részében, eresources-news] találjuk meg.
=== Vannak FreeBSD-s IRC (Internet Relay Chat) csatornák?
@@ -404,7 +393,7 @@ Ha magukat a terjesztéseket akarjuk letölteni (mert például egy DOS típusú
* doc/
* src/ssys.*
-A teljes folyamatot, valamint a telepítéssel kapcsolatos általános tudnivalókat valamivel bõvebben a link:{handbook}#install/[kézikönyv FreeBSD telepítésével foglalkozó részébõl] ismerhetjük meg.
+A teljes folyamatot, valamint a telepítéssel kapcsolatos általános tudnivalókat valamivel bõvebben a extref:{handbook}install/[kézikönyv FreeBSD telepítésével foglalkozó részébõl, install] ismerhetjük meg.
=== Mit tegyünk, ha a floppy image-ek nem férnek rá egyetlen lemezre?
@@ -419,11 +408,11 @@ Egyes FTP kliensek alapértelmezés szerint _szöveges_ (ascii) módban viszik
Megoldás: miután csatlakoztunk a szerverhez, de még mielõtt elkezdük volna a letöltést, az FTP kliens parancssorában gépeljük be, hogy _binary_.
* Az image lemezre másolása a DOS `copy` parancsának (vagy hasonló grafikus eszközök) használatával.
+
-A `copy` és a hozzá hasonló programok nem használhatóak erre a célra, mivel az image-eket közvetlenül a rendszeindításhoz hozták létre. Ennek megfelelõen az egyes image-ek a lemezek teljes tartalmát sávról sávra tartalmazzák, és így nem hétköznapi állományként kell velük bánni. Ezeket a floppykra alacsonyszintû eszközök (például az `fdimage` vagy `rawrite`) segítségével, "nyers" módban kell felvinni, ahogy azt a link:{handbook}#install/[FreeBSD telepítését leíró útmutatóban] is olvashatjuk.
+A `copy` és a hozzá hasonló programok nem használhatóak erre a célra, mivel az image-eket közvetlenül a rendszeindításhoz hozták létre. Ennek megfelelõen az egyes image-ek a lemezek teljes tartalmát sávról sávra tartalmazzák, és így nem hétköznapi állományként kell velük bánni. Ezeket a floppykra alacsonyszintû eszközök (például az `fdimage` vagy `rawrite`) segítségével, "nyers" módban kell felvinni, ahogy azt a extref:{handbook}install/[FreeBSD telepítését leíró útmutatóban, install] is olvashatjuk.
=== Hol található leírás a FreeBSD telepítésérõl?
-A telepítés részletes leírása a link:{handbook}#install/[kézikönyv FreeBSD telepítésérõl szóló részében] olvasható.
+A telepítés részletes leírása a extref:{handbook}install/[kézikönyv FreeBSD telepítésérõl szóló részében, install] olvasható.
=== Mire van szükség a FreeBSD használatához?
@@ -437,7 +426,7 @@ Lásd <<hardware>>.
Jelen pillanatban ennek nincs _egyszerû_ módja. Minden egyes kiadáshoz tartoznak telepítõfloppyk, használjuk ezeket.
-Ha egy módosított kiadást akarunk készíteni, kövessük a(z angol nyelvû) link:{releng}[Release Engineering] cikk útmutatásait.
+Ha egy módosított kiadást akarunk készíteni, kövessük a(z angol nyelvû) extref:{releng}[Release Engineering] cikk útmutatásait.
=== Windows(R) mellé is telepíhetõ FreeBSD?
@@ -553,7 +542,7 @@ Ezen úgy tudunk segíteni, ha a CD-meghajtónkat az IDE-vezérlõn átállítju
=== PLIP (Parallel Line IP) használatával lehet laptopra telepíteni?
-Igen. Ehhez csupán egy szabványos Laplink-kábel kell. Amennyiben szükséges, a párhuzamos vonali hálózatkezelés beállításához olvassuk el link:{handbook}#network-plip/[kézikönyv PLIP-rõl szóló részét].
+Igen. Ehhez csupán egy szabványos Laplink-kábel kell. Amennyiben szükséges, a párhuzamos vonali hálózatkezelés beállításához olvassuk el extref:{handbook}advanced-networking/[kézikönyv PLIP-rõl szóló részét, network-plip].
=== A lemezmeghajtók esetében milyen geometriai beállításokat érdemes használni?
@@ -966,7 +955,7 @@ A Broadcom nem hajlandó nyilvánossá tenni azokat az információkat, amik az
==== A FreeBSD milyen többportos soros vonali kártyákat ismer?
-Ezek listáját a kézikönyv link:{handbook}#serial/[Soros vonali kommunikációról szóló része] tartalmazza.
+Ezek listáját a kézikönyv extref:{handbook}serialcomms/[Soros vonali kommunikációról szóló része, serial] tartalmazza.
Bizonyos névtelen másolatok is használhatók, különösen azok, amelyek magukat AST-kompatibilisnek nevezik.
@@ -974,7 +963,7 @@ Az ilyen kártyák beállításáról a man:sio[4] man oldalon olvashatunk rész
==== Hogyan lehet a boot: parancssort elõhozni soros vonali konzolon?
-Olvassuk el a kézikönyvben link:{handbook}#serialconsole-setup/[ezt a fejezetet].
+Olvassuk el a kézikönyvben extref:{handbook}serialcomms/[ezt a fejezetet, serialconsole-setup].
[[compatibility-sound]]
=== Hang
@@ -1072,7 +1061,7 @@ Ha rossz szektorokra figyelmeztetõ hibaüzeneteket látunk (akármilyen típus
Ez tulajdonképpen egy ismert probléma. A HP Netserver gépekben egy integrált EISA buszos SCSI-vezérlõ található, amely a 11-es EISA bõvítõhelyen található, ezért az összes "valódi" EISA bõvítõhely ez elõtt helyezkedik el. Sajnos a 10 feletti EISA bõvítõhelyek címei ütköznek a PCI eszközök számára kiosztott címekkel, ezért a FreeBSD önmagától nem tudja valami jól kezelni az ilyen helyzeteket.
-Ezért a legjobban akkor járunk, ha egyszerûen letagadjuk a címterek ütközését :) Ezt úgy tudjuk megtenni, ha a rendszermag `EISA_SLOTS` nevû beállítását a 12 értékre állítjuk. Ezután már csak be kell konfigurálunk és újra kell fordítanunk a rendszermagot, ahogy azt a link:{handbook}#kernelconfig/[kézikönyv megfelelõ része is tárgyalja].
+Ezért a legjobban akkor járunk, ha egyszerûen letagadjuk a címterek ütközését :) Ezt úgy tudjuk megtenni, ha a rendszermag `EISA_SLOTS` nevû beállítását a 12 értékre állítjuk. Ezután már csak be kell konfigurálunk és újra kell fordítanunk a rendszermagot, ahogy azt a extref:{handbook}kernelconfig/[kézikönyv megfelelõ része is tárgyalja, kernelconfig].
Természetesen, amikor egy ilyen gépre akarunk telepíteni, a helyzet tovább bonyolódik. A telepítést úgy tudjuk megoldani, ha a _UserConfig_ programon belül alkalmazunk egy apró trükköt. Most ne a "vizuális" felületét használjuk, hanem a parancssoros részt. Gépeljük be, majd a megszokottak szerint telepítsük a rendszert:
@@ -1105,7 +1094,7 @@ Az ilyen típusú kártyák néha hajlamosak elfelejteni a beállításaikat. Fr
=== A párhuzamos nyomtató nevetségesen lassú. Mi lehet ezzel kezdeni?
-Ha csupán annyi a problémánk, hogy a nyomtató irdatlanul lassan mûködik, akkor próbáljuk meg a kézikönyv link:{handbook}#printing-intro-setup/[nyomtatásról szóló részében] leírtakhoz hasonlóan átállítani a link:{handbook}#PRINTING-PARALLEL-PORT-MODE[nyomtató portkezelését].
+Ha csupán annyi a problémánk, hogy a nyomtató irdatlanul lassan mûködik, akkor próbáljuk meg a kézikönyv extref:{handbook}printing/[nyomtatásról szóló részében, printing-intro-setup] leírtakhoz hasonlóan átállítani a extref:{handbook}printing[nyomtató portkezelését, printing-parallel-port-mode].
=== A programok miért állnak le idõnként Signal 11 hibákkal?
@@ -1179,17 +1168,17 @@ Készítsünk egy olyan saját rendszermagot, ahol a `VM_KMEM_SIZE_MAX` beállí
=== A számítógépben nincs 1 GB memória, a FreeBSD mégis kmem_map too small hibával leáll!
-Ez a hibaüzenet arra utal, hogy a rendszer kifogyott a hálózati pufferek (különösen az mbuf klaszterek) számára kiosztott virtuális memóriából. Az mbuf klaszterek részére fenntartott virtuális memória méretének beállításáról a kézikönyv link:{handbook}#NMBCLUSTERS[Hálózati korlátozások] címû szakaszában olvashatunk.
+Ez a hibaüzenet arra utal, hogy a rendszer kifogyott a hálózati pufferek (különösen az mbuf klaszterek) számára kiosztott virtuális memóriából. Az mbuf klaszterek részére fenntartott virtuális memória méretének beállításáról a kézikönyv extref:{handbook}config-tuning[Hálózati korlátozások, nmbclusters] címû szakaszában olvashatunk.
=== Miért jelenik meg a kernel: proc: table is full hibaüzenet?
A FreeBSD rendszermagja egyszerre csak bizonyos számú programot enged futni. Ezek konkrét száma a `kern.maxusers` man:sysctl[8]-változótól függ. A `kern.maxusers` ezenkívül még hatással van más belsõ korlátokra is, például a hálózati pufferekre (lásd <<panic-kmemmap-too-small,ezt>> a korábbi kérdést). Ha a számítógépünk túlságosan leterhelt, akkor érdemes megpróbálkoznunk a `kern.maxusers` értékének növelésével. Ennek átállítása a rendszerben egyszerre futtatható maximális programok számával együtt sok más rendszerszintû korlátozást is finomít.
-A `kern.maxusers` értékének beállításához nézzük meg a kézikönyv link:{handbook}#KERN-MAXFILES[Az állományok és futó programok korlátozásairól] szóló szakaszát. (Miközben ez a rész a megnyitható állományok maximális számáról szól, addig ugyanez érvényes a futó programokra is.)
+A `kern.maxusers` értékének beállításához nézzük meg a kézikönyv extref:{handbook}config-tuning[Az állományok és futó programok korlátozásairól, kern-maxfiles] szóló szakaszát. (Miközben ez a rész a megnyitható állományok maximális számáról szól, addig ugyanez érvényes a futó programokra is.)
Ha viszont a számítógépünk nem éri akkora terhelés, de mégis szeretnénk egyszerre nagyobb számú programot is futtatni rajta, akkor ehhez elegendõ csak `kern.maxproc` változót átállítanunk. Ezt úgy tudjuk megtenni, ha felvesszük a [.filename]#/boot/loader.conf# állományba. Ez az érték természetesen addig nem beállítódni, amíg a rendszerünket újra nem indítjuk. Ezekrõl a változókról a man:loader.conf[5] és man:sysctl.conf[5] man oldalakon tájékozódhatunk részletesebben. Ha az összes programot egyetlen felhasználóval akarjuk futtatni, akkor a `kern.maxprocperuid` változót értékét is át kell állítanunk, méghozzá a `kern.maxproc` új értékénél eggyel kisebbre. (Ezért kell így csinálni, mert egy rendszerprogram, az man:init[8] mindig fut.)
-A sysctl változók beállításait úgy is tudjuk véglegesíteni, ha felvesszük ezeket az [.filename]#/etc/sysctl.conf# állományba. A kézikönyv link:{handbook}#configtuning-sysctl/[A rendszermag korlátainak finomhangolása] címû szakaszában részletesebb is olvashatunk róla, hogy miként állítsuk be a rendszerünket.
+A sysctl változók beállításait úgy is tudjuk véglegesíteni, ha felvesszük ezeket az [.filename]#/etc/sysctl.conf# állományba. A kézikönyv extref:{handbook}config-tuning[A rendszermag korlátainak finomhangolása, configtuning-sysctl] címû szakaszában részletesebb is olvashatunk róla, hogy miként állítsuk be a rendszerünket.
=== Az új rendszermag indításakor miért keletkezik CMAP busy hibaüzenet?
@@ -1214,7 +1203,7 @@ Az alaplapon nem található olyan áramkör, amely támogatja az automatikus le
=== Miért küld a sendmail mail loops back to myself hibaüzenetet?
-Errõl részletesebben a link:{handbook}#Q26.5.2.[kézikönyvben] olvashatunk.
+Errõl részletesebben a extref:{handbook}[kézikönyvben] olvashatunk.
=== A távoli gépeken miért viselkednek olyan furcsán a teljes képernyõs alkalmazások?
@@ -1350,7 +1339,7 @@ Három dolgot tehetünk ezzel kapcsolatban:
=== Miért jelenik meg folyamatosan a file: table is full üzenet a rendszernaplóban?
-Ha ilyen hibaüzenetet látunk, akkor az arra utal, hogy kifogytunk a rendszerünkben egyszerre használható állományleírókból. A probléma leírásával és megoldásával kapcsolatban olvassuk el a kézikönyvben a link:{handbook}#KERN-MAXFILES[kern.maxfiles ] változóról szóló részt link:{handbook}#configtuning-kernel-limits/[A rendszermag korlátainak finomhangolása] címû szakaszban.
+Ha ilyen hibaüzenetet látunk, akkor az arra utal, hogy kifogytunk a rendszerünkben egyszerre használható állományleírókból. A probléma leírásával és megoldásával kapcsolatban olvassuk el a kézikönyvben a extref:{handbook}config-tuning[kern.maxfiles, kern-maxfiles] változóról szóló részt extref:{handbook}config-tuning/[A rendszermag korlátainak finomhangolása, configtuning-kernel-limits] címû szakaszban.
=== Miért árasztják el calcru: negative runtime vagy calcru: runtime went backwards üzenetek a konzolt?
@@ -1460,7 +1449,7 @@ Az man:atacontrol[8] segédprogram használatával ellenõrizni tudjuk, hogy jel
=== Mi az a lock order reversal?
-Erre a kérdésre a választ a FreeBSD-s szakkifejezések gyûjteményében találjuk meg a link:{handbook}#LOR-GLOSSARY[LOR] címszó alatt.
+Erre a kérdésre a választ a FreeBSD-s szakkifejezések gyûjteményében találjuk meg a extref:{handbook}glossary[LOR, lor-glossary] címszó alatt.
=== Mit jelent a Called ... with the following non-sleepable locks held üzenet?
@@ -1491,7 +1480,7 @@ A FreeBSD ezeken kívül még számos szövegszerkesztõt, táblázatkezelõt é
=== Honnan lehet a Motif(R)-ot szerezni a FreeBSD-hez?
-A The Open Group kiadta a Motif(R) 2.2.2 változatának forráskódját. Ez az package:x11-toolkits/open-motif[] csomagból vagy portból érhetõ el. A telepítésével kapcsolatban olvassuk el a kézikönyv link:{handbook}#ports/[portokról szóló részét].
+A The Open Group kiadta a Motif(R) 2.2.2 változatának forráskódját. Ez az package:x11-toolkits/open-motif[] csomagból vagy portból érhetõ el. A telepítésével kapcsolatban olvassuk el a kézikönyv extref:{handbook}ports/[portokról szóló részét, ports].
[NOTE]
====
@@ -1570,7 +1559,7 @@ Igen. Látogassunk el a link:https://www.FreeBSD.org/java/[http://www.FreeBSD.or
=== Miért nem fordul egy port a 6.X-STABLE, 7.X-STABLE vagy 8.X-STABLE változatot futtató gépeken?
-Ha olyan FreeBSD verziónk van, amely egy kicsit lemaradt az aktuális _-CURRENT_ vagy _-STABLE_ ágak mögött, akkor valószínûleg frissítenünk kell a Portgyûjteményünket. Ennek részleteirõl a Porterek kézikönyvében, a link:{porters-handbook}#keeping-up/[Keeping Up] címû részben olvashatunk (angolul). Ha viszont rendszerünkben minden a lehetõ legfrissebb, akkor elõfordulhat, hogy valaki olyan változtatást rakott fel a porthoz, amely a _-CURRENT_ esetén mûködik, de a _-STABLE_ változatban már nem. Ilyenkor feltétlenül küldjünk egy hibajelentést a man:send-pr[1] paranccsal, hiszen a Portgyûjteménynek a -CURRENT és -STABLE ágak esetén egyaránt mûködnie kell.
+Ha olyan FreeBSD verziónk van, amely egy kicsit lemaradt az aktuális _-CURRENT_ vagy _-STABLE_ ágak mögött, akkor valószínûleg frissítenünk kell a Portgyûjteményünket. Ennek részleteirõl a Porterek kézikönyvében, a extref:{porters-handbook}[Keeping Up, keeping-up] címû részben olvashatunk (angolul). Ha viszont rendszerünkben minden a lehetõ legfrissebb, akkor elõfordulhat, hogy valaki olyan változtatást rakott fel a porthoz, amely a _-CURRENT_ esetén mûködik, de a _-STABLE_ változatban már nem. Ilyenkor feltétlenül küldjünk egy hibajelentést a man:send-pr[1] paranccsal, hiszen a Portgyûjteménynek a -CURRENT és -STABLE ágak esetén egyaránt mûködnie kell.
=== A make index paranccsal nem sikerült létrehozni az INDEX állomyánt. Mi a gond?
@@ -1592,7 +1581,7 @@ Azonban a FreeBSD 6.2-RELEASE megjelenésétõl kezdve a FreeBSD felhasználók
=== A forrásokon kívül a telepített portokat is lehet valahogy frissíteni?
-A FreeBSD alaprendszere ehhez nem kínál fel semmilyen eszközt, de léteznek olyan segédeszközök, amelyekkel valamennyire meg tudjuk könnyíteni a frissítés folyamatát. További segédprogramok telepítésével pedig a portok kezelését tudjuk tovább egyszerûsíteni, amirõl a FreeBSD kézikönyv link:{handbook}#ports-using/[A portok frissítése] címû szakaszában olvashatunk bõvebben.
+A FreeBSD alaprendszere ehhez nem kínál fel semmilyen eszközt, de léteznek olyan segédeszközök, amelyekkel valamennyire meg tudjuk könnyíteni a frissítés folyamatát. További segédprogramok telepítésével pedig a portok kezelését tudjuk tovább egyszerûsíteni, amirõl a FreeBSD kézikönyv extref:{handbook}ports/[A portok frissítése, ports-using] címû szakaszában olvashatunk bõvebben.
=== Minden nagyobb verziófrissítésnél újra kell fordítani az összes telepített portot a rendszeren?
@@ -1600,7 +1589,7 @@ Mindenképpen! Noha látszólag a frissített rendszeren is remekül futnak a ko
Ne felejtsük el, hogy a rendszer frissítésekor a különféle osztott könyvtárak, betölthetõ modulok és a rendszer egyéb komponensei is lecserélõdnek. Ezért a régebbi változataikhoz fordított alkalmazások egyáltalán nem fognak elindulni vagy nem mûködnek rendesen.
-Ezzel kapcsolatban olvassuk el a FreeBSD kézikönyvének link:{handbook}#FREEBSDUPDATE-UPGRADE[frissítérõl szóló szakaszát].
+Ezzel kapcsolatban olvassuk el a FreeBSD kézikönyvének extref:{handbook}updating-upgrading[frissítérõl szóló szakaszát, freebsdupdate-upgrade].
=== Minden kisebb verziófrissítésnél újra kell fordítani az összes telepített portot a rendszeren?
@@ -1620,7 +1609,7 @@ Erre az az általános válasz, hogy a névfeloldás valószínûleg rosszul mû
=== Ha a CVSup használatával frissítjük a Portgyûjteményt, akkor sok port nem fordul le mindenféle rejtélyes hibaüzenet kíséretében! Valami nagy baj van a Portgyûjteménnyel?
-Ha úgy korábban úgy frissítettük a CVSup használatával a Portgyûjteményt, hogy nem adtuk meg a `ports-all` CVSup algyûjteményt, akkor a `ports-base` algyûjteményt is _mindig_ frissítenünk kell! Ennek okairól link:{handbook}#cvsup[a kézikönyvben] olvashatunk.
+Ha úgy korábban úgy frissítettük a CVSup használatával a Portgyûjteményt, hogy nem adtuk meg a `ports-all` CVSup algyûjteményt, akkor a `ports-base` algyûjteményt is _mindig_ frissítenünk kell! Ennek okairól extref:{handbook}mirrors[a kézikönyvben, cvsup] olvashatunk.
=== Hogyan lehet MIDI állományokból audio CD-t készíteni?
@@ -1631,13 +1620,13 @@ Ha MIDI állományokból akarunk audio CD-t készíteni, akkor elõször telepí
% timidity -Ow -s 44100 -o /tmp/juke/01.wav 01.mid
....
-A WAV állományok ezek után tetszõleges formátumba konvertálhatóak tovább vagy készíthetõ belõlük egy audio CD, ahogy azt a link:{handbook}#creating-cds/[FreeBSD kézikönyvben] is olvashatjuk.
+A WAV állományok ezek után tetszõleges formátumba konvertálhatóak tovább vagy készíthetõ belõlük egy audio CD, ahogy azt a extref:{handbook}disks/[FreeBSD kézikönyvben, creating-cds] is olvashatjuk.
== A rendszermag beállítása
=== Nehéz testreszabni a rendszermagot?
-Egyáltalán nem! Ezzel kapcsolatban olvassuk el link:{handbook}#kernelconfig/[a FreeBSD kézikönyv rendszermag beállításairól szóló részét].
+Egyáltalán nem! Ezzel kapcsolatban olvassuk el extref:{handbook}kernelconfig/[a FreeBSD kézikönyv rendszermag beállításairól szóló részét, kernelconfig].
[NOTE]
====
@@ -1724,7 +1713,7 @@ A `kern.sched.quantum` értéke határozza meg, hogy egy futó program legfeljeb
=== Hogyan adjunk lemezeket a FreeBSD rendszerünkhöz?
-Ezzel kapcsolatban olvassuk el a lemezek hozzáadásáról szóló részt a link:{handbook}#disks-adding/[FreeBSD kézikönyvben].
+Ezzel kapcsolatban olvassuk el a lemezek hozzáadásáról szóló részt a extref:{handbook}disks/[FreeBSD kézikönyvben, disks-adding].
=== Hogyan lehet átteni a rendszert egy nagyobb lemezre?
@@ -1902,7 +1891,7 @@ A logikai DOS partíciók az elsõdleges partíciók _után_ találhatóak. Pél
=== Használható titkosított állományrendszer FreeBSD alatt?
-Igen. Erre a célra a man:gbde[8] és a man:geli[8] is tökéletesen alkalmas. A részleteket lásd a FreeBSD kézikönyv link:{handbook}#disks-encrypting/[A lemezpartíciók titkosítása] címû fejezetében.
+Igen. Erre a célra a man:gbde[8] és a man:geli[8] is tökéletesen alkalmas. A részleteket lásd a FreeBSD kézikönyv extref:{handbook}disks/[A lemezpartíciók titkosítása, disks-encrypting] címû fejezetében.
=== A Windows NT(R) rendszertöltõjével is el lehet indítani a FreeBSD-t?
@@ -2047,23 +2036,23 @@ Emellett még hasznos lehet felvenni hozzá egy sort az [.filename]#/etc/fstab#
=== Miért ad a rendszer Incorrect super block hibát CD-k csatlakoztatásánál?
-Fel kell világosítanunk a man:mount[8] parancsot a csatlakoztatandó eszköz típusáról. Errõl a link:{handbook}#creating-cds/[kézikönyv lézeres tárolóeszközökrõl szóló részében] olvashatunk, innen is különösen a link:{handbook}#MOUNTING-CD[Adat CD-k használata] címû szakaszt ajánljuk.
+Fel kell világosítanunk a man:mount[8] parancsot a csatlakoztatandó eszköz típusáról. Errõl a extref:{handbook}disks/[kézikönyv lézeres tárolóeszközökrõl szóló részében, creating-cds] olvashatunk, innen is különösen a extref:{handbook}disks[Adat CD-k használata, mounting-cd] címû szakaszt ajánljuk.
=== Miért ad a rendszer Device not configured hibaüzenetet CD-k csatlakoztatásakor?
-Ez általában arra utal, hogy nincs CD a meghajtóban, vagy a meghajtó nem érhetõ el a buszon. Ezzel kapcsolatban a kézikönyv link:{handbook}#MOUNTING-CD[Adat CD-k használata] címû szakaszát javasoljuk elolvasásra.
+Ez általában arra utal, hogy nincs CD a meghajtóban, vagy a meghajtó nem érhetõ el a buszon. Ezzel kapcsolatban a kézikönyv extref:{handbook}disks[Adat CD-k használata, mounting-cd] címû szakaszát javasoljuk elolvasásra.
=== Miért jelenik meg az összes nemzeti karakter helyén ?, amikor FreeBSD alatt csatlakoztatunk egy CD-t?
-A CD-n valószínûleg a "Joliet" kiterjesztés használatával tárolják az állományok és könyvtárak adatait. Erre vonatkozóan a kézikönyvben a link:{handbook}#creating-cds/[Lézeres tárolóeszközök (CD-k) létrehozása és használata] címû rész elolvasását javasoljuk, különös tekintettel az link:{handbook}#MOUNTING-CD[Adat CD-k használata] címû szakaszra.
+A CD-n valószínûleg a "Joliet" kiterjesztés használatával tárolják az állományok és könyvtárak adatait. Erre vonatkozóan a kézikönyvben a extref:{handbook}disks/[Lézeres tárolóeszközök (CD-k) létrehozása és használata, creating-cds] címû rész elolvasását javasoljuk, különös tekintettel az extref:{handbook}disks[Adat CD-k használata, mounting-cd] címû szakaszra.
=== A FreeBSD alatt készített CD-ket nem lehet más operációs rendszerekkel olvasni. Miért nem?
-Ez minden bizonnyal abból fakad, hogy nem egy ISO 9660 állományrendszert vettük fel rá, hanem közvetlenül maguk az állományokat. Olvassuk el a kézikönyvben a link:{handbook}#creating-cds/[Lézeres tárolóeszközök (CD-k) létrehozása és használata] címû fejezetet, de különösen a link:{handbook}#creating-cds/#RAWDATA-CD[Nyers adat CD-k írása] címû részt.
+Ez minden bizonnyal abból fakad, hogy nem egy ISO 9660 állományrendszert vettük fel rá, hanem közvetlenül maguk az állományokat. Olvassuk el a kézikönyvben a extref:{handbook}disks/[Lézeres tárolóeszközök (CD-k) létrehozása és használata, creating-cds] címû fejezetet, de különösen a extref:{handbook}disks/#RAWDATA-CD[Nyers adat CD-k írása, creating-cds] címû részt.
=== Hogyan lehet lementeni egy adat CD tartalmát a merevlemezre?
-Errõl a kézikönyvben találunk hasznos információkat, azon belül is az link:{handbook}#IMAGING-CD[Adat CD-k másolása] címû szakaszban. A CD-kkel végezhetõ további mûveletekrõl a kézikönyv link:{handbook}#creating-cds/[Lézeres tárolóeszközök (CD-k) létrehozása és használata] címû részében találhatunk részletes útmutatásokat.
+Errõl a kézikönyvben találunk hasznos információkat, azon belül is az extref:{handbook}disks[Adat CD-k másolása, imaging-cd] címû szakaszban. A CD-kkel végezhetõ további mûveletekrõl a kézikönyv extref:{handbook}disks/[Lézeres tárolóeszközök (CD-k) létrehozása és használata, creating-cds] címû részében találhatunk részletes útmutatásokat.
=== Miért nem lehet audio CD-ket csatlakoztatni a mount paranccsal?
@@ -2169,7 +2158,7 @@ Ez a helyzet nagyon gyakori webszerverek esetén. Sokan úgy állítanak be a Fr
=== Hogyan lehet növelni a lapozóterületet?
-A kézikönyv link:{handbook}#config-tuning/[Beállítás és finomhangolás] címû fejezetében található link:{handbook}#adding-swap-space/[egyik szakaszban] olvashatunk errõl.
+A kézikönyv extref:{handbook}config-tuning[Beállítás és finomhangolás, config-tuning] címû fejezetében található extref:{handbook}config-tuning/[egyik szakaszban, adding-swap-space] olvashatunk errõl.
=== A FreeBSD miért látja kisebbnek a lemezeket mint amekkorának a gyártó mondja ezeket?
@@ -2244,13 +2233,13 @@ Miután megtettük ezeket a lépéseket, már a szokásos módon át tudjuk szer
=== Miért nem sikerül beállítani a nyomtatót?
-Olvassuk el a kézikönyv link:{handbook}#printing/[nyomtatókkal foglalkozó] részét, minden bizonnyal választ ad a legtöbb kérdésünkre.
+Olvassuk el a kézikönyv extref:{handbook}printing/[nyomtatókkal foglalkozó, printing] részét, minden bizonnyal választ ad a legtöbb kérdésünkre.
Bizonyos nyomtatókat azonban akkor tudunk használni, ha van hozzá meghajtónk. Ezeket gyakran csak "WinPrinter" néven emlegetik, amelyeket viszont a FreeBSD nem támogat. Ha a nyomtatónk nem használható DOS vagy Windows(R) alatt, akkor valószínûleg egy ilyen WinPrinterrel van dolgunk. Ebben az esetben egyedül abban reménykedhetünk, hogy a package:print/pnm2ppa[] port támogatja.
=== Hogyan lehet módosítani a rendszerünkhöz tartozó billentyûkiosztást?
-Olvassuk el a kézikönyv link:{handbook}#using-localization/[honosításssal] foglalkozó részét, különös tekintettel a link:{handbook}#SETTING-CONSOLE[konzol beállításaira].
+Olvassuk el a kézikönyv extref:{handbook}l10n/[honosításssal, using-localization] foglalkozó részét, különös tekintettel a extref:{handbook}l10n[konzol beállításaira, setting-console].
=== Miért jelenik meg az unknown: <PNP0303> can't assign resources hibaüzenet a rendszer indulásakor?
@@ -2269,7 +2258,7 @@ options QUOTA
....
+
-Ennek részleteit a link:{handbook}#quotas/[kézikönyv] kvótákkal foglalkozó részében találjuk.
+Ennek részleteit aextref:{handbook}disks/[kézikönyv, quotas] kvótákkal foglalkozó részében találjuk.
. Az [.filename]#/# állományrendszeren ne engedélyezzük a kvóták használatát.
. Tegyünk kvótaállományokat azokra az állományrendszerekre, ahol be akarjuk vezetni a használatukat, például:
+
@@ -2321,7 +2310,7 @@ Ha az egyfelhasználós módra váltás során a rendszer a `root` felhasználó
[NOTE]
====
-Ha egyfelhasználós módban nem tudjuk csatlakoztatni a rendszerindító partíciót, akkor ennek könnyen az lehet az oka, hogy a partíciókat titkosították, ezért a megfelelõ kulcsok nélkül nem tudjuk elérni ezeket. Ez leginkább adott implementációtól függ. A FreeBSD-ben elõforduló lemeztitkosításokkal kapcsolatban a link:{handbook}#disks-encrypting/[kézikönyv] ad bõvebb útmutatást.
+Ha egyfelhasználós módban nem tudjuk csatlakoztatni a rendszerindító partíciót, akkor ennek könnyen az lehet az oka, hogy a partíciókat titkosították, ezért a megfelelõ kulcsok nélkül nem tudjuk elérni ezeket. Ez leginkább adott implementációtól függ. A FreeBSD-ben elõforduló lemeztitkosításokkal kapcsolatban a extref:{handbook}disks/[kézikönyv, disks-encrypting] ad bõvebb útmutatást.
====
=== Hogyan akadályozható meg, hogy a ControlAltDelete billentyûkombináció újraindítsa a rendszert?
@@ -2431,7 +2420,7 @@ Valamivel bõvebben: A FreeBSD fejlesztésében a kiadások általában két hel
Amikor a fejlesztõk készíteni akarnak egy újabb kiadást, az alapjául szolgáló fejlesztési ágon elvégeznek bizonyos mûveleteket. Ennek egy része a források "befagyasztása". Amikor ez megkezdõdik, az ág neve megváltozik, és ezzel jelzik, hogy hamarosan kiadás készül belõle. Például, ha egy ág a 6.2-STABLE nevet viseli, akkor a 6.3-PRERELEASE névre vált arra az idõszakra, amíg tart a kódfagyasztás és lezajlik a kiadások megjelentetéséhez szükség további tesztelés. Hibajavítások ekkor továbbra is rakhatóak bele. Ahogy a források elérik a kiadáshoz szükséges szintet, az ág neve 6.3-RC-re vált, és ezzel jelzik, hogy a kiadás elõkészítése hamarosan befejezõdik. Az _RC_ állapotban csak a legfontosabb hibákat keresik meg és javítják. Miután a kiadás (jelen esetünkben a 6.3-RELEASE kiadás) és a hozzá tartozó ág elkészült, az ág neve ismét 6.3-STABLE lesz.
-A verziószámokról és a CVS-ben található különbözõ ágakról a link:{releng}[Release Engineering] címû cikkben olvashatunk (angolul).
+A verziószámokról és a CVS-ben található különbözõ ágakról a extref:{releng}[Release Engineering] címû cikkben olvashatunk (angolul).
=== Az új rendszermag telepítése során a man:chflags[1] program hibát jelez. Hogyan javítható ez a hiba?
@@ -2518,7 +2507,7 @@ Kezdetben a FreeBSD alapértelmezett X implementációja az XFree86(TM) volt, am
2004 júliusától kezdõdõen a FreeBSD-CURRENT változatban az XFree86(TM) helyett az Xorg lett az alapértelmezett X implementáció. A FreeBSD-ben azóta is alapból az Xorg X11 implementációja található meg.
-A témával kapcsolatban a kézikönyv link:{handbook}#x11/[X11-rõl szóló] fejezetében kaphatunk részletesebb felvilágosítást.
+A témával kapcsolatban a kézikönyv extref:{handbook}x11/[X11-rõl szóló, x11] fejezetében kaphatunk részletesebb felvilágosítást.
=== Mégis miért vált szét a két X projekt?
@@ -2539,7 +2528,7 @@ Amennyiben már egy meglévõ rendszerre szeretnénk telepíteni az X-et, úgy
Emellett az Xorg a man:sysinstall[8] használatával is telepíthetõ: válasszuk a [.guimenuitem]#Configure# (Beállítások), [.guimenuitem]#Distributions# (Terjesztések), végül a [.guimenuitem]#The X.Org Distribution# (Az X.Org terjesztés) menüpontokat.
-Az Xorg sikeres telepítése után kövessük a kézikönyv link:{handbook}#x-config/[X11 beállításával foglalkozó] szakaszában leírtakat.
+Az Xorg sikeres telepítése után kövessük a kézikönyv extref:{handbook}x11/[X11 beállításával foglalkozó, x-config] szakaszában leírtakat.
=== Az X indításakor egy KDENABIO failed (Operation not permitted) hiba keletkezik, közvetlenül a startx parancs kiadása után. Mi lehet ezzel kezdeni?
@@ -2799,7 +2788,7 @@ Futtassuk le a `xmodmap -e "pointer = 3 2 1"` parancsot az [.filename]#.xinitrc#
=== Hogyan lehet betöltõképet telepíteni és hol találhatóak ilyen képek?
-Erre a kérdésre részletes választ a FreeBSD kézikönyv link:{handbook}#BOOT-SPLASH[Rendszerbetöltõ képernyõk] címû szakaszában kapunk.
+Erre a kérdésre részletes választ a FreeBSD kézikönyv extref:{handbook}boot[Rendszerbetöltõ képernyõk, boot-splash] címû szakaszában kapunk.
=== X alatt lehet használni a billentyûzeten található Windows billentyûket?
@@ -2869,35 +2858,35 @@ ATI Rage 128 és Radeon kártyák számára a man:ati[4], man:r128[4] és man:ra
=== Honnan lehet többet megtudni a lemez nélküli mûködésrõl?
-A "lemez nélküli mûködés" kifejezés arra utal, hogy a FreeBSD rendszerünk hálózaton keresztül indul el, valamint a mûködéséhez szükséges állományokat nem merevlemezrõl, hanem egy szerverrõl olvassa be. Ennek részleteirõl link:{handbook}#network-diskless/[kézikönyv lemez nélküli mûködésrõl szóló részében] olvashatunk.
+A "lemez nélküli mûködés" kifejezés arra utal, hogy a FreeBSD rendszerünk hálózaton keresztül indul el, valamint a mûködéséhez szükséges állományokat nem merevlemezrõl, hanem egy szerverrõl olvassa be. Ennek részleteirõl extref:{handbook}advanced-networking/[kézikönyv lemez nélküli mûködésrõl szóló részében, network-diskless] olvashatunk.
=== A FreeBSD használható kizárólag csak hálózati útválasztóként?
-Igen. Ezzel kapcsolatban a kézikönyv link:{handbook}#advanced-networking/[ Egyéb haladó hálózati témák] címû fejezetét javasoljuk elolvasásra, különös tekintettel az link:{handbook}#network-routing/[útválasztás és az átjárók] bemutatására.
+Igen. Ezzel kapcsolatban a kézikönyv extref:{handbook}advanced-networking/[Egyéb haladó hálózati témák, advanced-networking] címû fejezetét javasoljuk elolvasásra, különös tekintettel az extref:{handbook}advanced-networking/[útválasztás és az átjárók, network-routing] bemutatására.
=== FreeBSD-n keresztül lehet Windows(R) operációs rendszerrel internetre csatlakozni?
Ezt a kérdést általában olyanok teszik fel, akiknek két számítógépük van otthon, és ezek közül az egyiken a FreeBSD, a másikon pedig a Windows(R) valamelyik változata fut. A FreeBSD rendszer fog az internethez csatlakozni, és ezen keresztül szeretnénk a windowsos géprõl is elérni azt. Ez tulajdonképpen az elõzõ kérdés egy speciális esete, és remekül megoldható.
-Ha betárcsázós kapcsolattal csatlakozunk az internethez, akkor érdemes tudnunk, hogy a felhasználói módban futó man:ppp[8] tartalmaz egy `-nat` kapcsolót. A man:ppp[8] programot úgy tudjuk a `-nat` kapcsolóval futtatni, ha az [.filename]#/etc/rc.conf# állományban a `gateway_enable` beállítást a _YES_ értékre állítjuk. Ezután állítsuk be a windowsos gépünket ennek megfelelõen és minden mûködni fog. A további részletekrõl a man:ppp[8] man oldalán vagy a link:{handbook}#userppp/[kézikönyv felhasználói PPP-rõl szóló bejegyzésében] olvashatunk.
+Ha betárcsázós kapcsolattal csatlakozunk az internethez, akkor érdemes tudnunk, hogy a felhasználói módban futó man:ppp[8] tartalmaz egy `-nat` kapcsolót. A man:ppp[8] programot úgy tudjuk a `-nat` kapcsolóval futtatni, ha az [.filename]#/etc/rc.conf# állományban a `gateway_enable` beállítást a _YES_ értékre állítjuk. Ezután állítsuk be a windowsos gépünket ennek megfelelõen és minden mûködni fog. A további részletekrõl a man:ppp[8] man oldalán vagy a extref:{handbook}ppp-and-slip/[kézikönyv felhasználói PPP-rõl szóló bejegyzésében, userppp] olvashatunk.
-Amennyiben rendszerszintû PPP-t használunk vagy Ethernettel csatlakozunk az internethez, akkor a man:natd[8] démonra lesz szükségünk. Erre vonatkozóan a kézikönyv link:{handbook}#network-natd/[natd] démonról szóló szakaszában találhatunk részletesebb információkat.
+Amennyiben rendszerszintû PPP-t használunk vagy Ethernettel csatlakozunk az internethez, akkor a man:natd[8] démonra lesz szükségünk. Erre vonatkozóan a kézikönyv extref:{handbook}/[natd, network-natd] démonról szóló szakaszában találhatunk részletesebb információkat.
=== A FreeBSD támogatja a SLIP és a PPP használatát?
Igen. Érdemes elolvasnunk az man:slattach[8], man:sliplogin[8], man:ppp[8] és man:pppd[8] man oldalakat. A man:ppp[8] és a man:pppd[8] egyaránt támogatja a beérkezõ és kimenõ kapcsolatokat, miközben a man:sliplogin[8] kizárólag csak beérkezõ kapcsolatokkal dolgozik, valamint a man:slattach[8] pedig csak kimenõ kapcsolatokkal.
-Ezek pontos használatáról olvassuk el a link:{handbook}#ppp-and-slip/[kézikönyv PPP-rõl és a SLIP-rõl szóló fejezetét].
+Ezek pontos használatáról olvassuk el a extref:{handbook}ppp-and-slip/[kézikönyv PPP-rõl és a SLIP-rõl szóló fejezetét, ppp-and-slip].
Ha viszont csak egy "shellen" keresztül érjük el az internetet, akkor hasznos lehet megnéznünk a package:net/slirp[] csomagot. Segítségével a helyi géprõl (korlátozott módon) hozzá tudunk férni különbözõ FTP és HTTP szolgáltatásokhoz.
=== A FreeBSD támogat hálózati címfordítást (NAT) vagy maszkolást?
-Igen. Ha egy felhasználói PPP kapcsolat esetén szeretnénk hálózati címfordítást alkalmazni, akkor olvassuk el a link:{handbook}#userppp/[kézikönyv felhasználói PPP-vel foglalkozó részét]. Ha viszont más típusú hálózati kapcsolatok esetén kívánunk címfordítást használni, akkor ahhoz a kézikönyv link:{handbook}#network-natd/[natd] démonnal kapcsolatos részét kell fellapoznunk.
+Igen. Ha egy felhasználói PPP kapcsolat esetén szeretnénk hálózati címfordítást alkalmazni, akkor olvassuk el a extref:{handbook}ppp-and-slip/[kézikönyv felhasználói PPP-vel foglalkozó részét, userppp]. Ha viszont más típusú hálózati kapcsolatok esetén kívánunk címfordítást használni, akkor ahhoz a kézikönyv extref:{handbook}/[natd, network-natd] démonnal kapcsolatos részét kell fellapoznunk.
=== A PLIP segítségével hogyan tudok két FreeBSD rendszert összekapcsolni párhuzamos porton keresztül?
-Ezt illetõen a kézikönyv link:{handbook}#network-plip/[PLIP-rõl szóló szakaszát] érdemes megnéznünk.
+Ezt illetõen a kézikönyv extref:{handbook}advanced-networking/[PLIP-rõl szóló szakaszát, network-plip] érdemes megnéznünk.
=== Hogyan lehet álneveket megadni az Ethernet eszközöknek?
@@ -2915,7 +2904,7 @@ Minden más esetben a hagyományos módon adjunk meg egy hálózati címet és e
# ifconfig ed0 alias 172.16.141.5 netmask 0xffffff00
....
-Errõl bõvebben a link:{handbook}#configtuning-virtual-hosts/[FreeBSD kézikönyvben] olvashatunk.
+Errõl bõvebben a extref:{handbook}config-tuning/[FreeBSD kézikönyvben, configtuning-virtual-hosts] olvashatunk.
=== A 3C503 kártya hogyan állítható másik hálózati portra?
@@ -2925,7 +2914,7 @@ Ha a kártyán egy másik portot szeretnénk használni, akkor ahhoz meg kell ad
A személyi számítógépekben található bizonyos hálózati kártyák (szépen szólva) ügyesebbek a többieknél, ami az olyan komolyabb hálózati alkalmazások, mint például az NFS esetén gondokat okozhat.
-Ezzel kapcsolatban link:{handbook}#network-nfs/[ kézikönyv NFS-rõl szóló részét] érdemes megnéznünk.
+Ezzel kapcsolatban extref:{handbook}network-servers/[kézikönyv NFS-rõl szóló részét, network-nfs] érdemes megnéznünk.
=== Miért nem lehet hálózati állományrendszereket csatlakoztatni Linux(R) alól?
@@ -2947,7 +2936,7 @@ A SunOS(TM) 4._X_ változatait futtató munkaállomások csak privilegizált por
=== A mountd miért küld folyton can't change attributes hibaüzenetet és miért jelenik meg a bad exports list hibaüzenet a FreeBSD alapú NFS szerveren?
-Ez leginkább azért történik, mert nem jól adtuk meg az [.filename]#/etc/exports# állomány tartalmát. Olvassuk át a man:exports[5] man oldalt és a kéziköny link:{handbook}#network-nfs/[NFS-rõl] szóló részét, különös tekintettel az link:{handbook}#CONFIGURING-NFS[NFS beállítására].
+Ez leginkább azért történik, mert nem jól adtuk meg az [.filename]#/etc/exports# állomány tartalmát. Olvassuk át a man:exports[5] man oldalt és a kéziköny extref:{handbook}network-servers/[NFS-rõl, network-nfs] szóló részét, különös tekintettel az extref:{handbook}[NFS beállítására].
=== A NeXTStep gépekkel miért nem sikerül PPP-n keresztül kommunikálni?
@@ -3032,7 +3021,7 @@ Glen Foster (mailto:gfoster@driver.nsta.org[gfoster@driver.nsta.org]) a követke
=== Miért kell teljes hálózati neveket megadni?
-Erre a link:{handbook}#mail-trouble/[FreeBSD kézikönyvben] találjuk meg a választ.
+Erre a extref:{handbook}mail/[FreeBSD kézikönyvben, mail-trouble] találjuk meg a választ.
=== Miért jelenik meg a Permission denied hibaüzenet minden egyes hálózati mûvelet esetén?
@@ -3047,7 +3036,7 @@ Ha véletlenül rosszul állítottuk volna be a rendszerünkön futó tûzfalat,
Az [.filename]#/etc/rc.conf# állományban is megadhatjuk ehhez a `firewall_type="open"` sort.
-Ha a tûzfalak beállításáról szeretnénk többet megtudni FreeBSD alatt, akkor olvassuk el a link:{handbook}#firewalls/[kézikönyv erre vonatkozó fejezetét].
+Ha a tûzfalak beállításáról szeretnénk többet megtudni FreeBSD alatt, akkor olvassuk el a extref:{handbook}firewalls[kézikönyv erre vonatkozó fejezetét, firewalls].
=== Az ipfw fwd szabálya miért nem irányít át más gépekre szolgáltatásokat?
@@ -3130,7 +3119,7 @@ Elõször is nézzük meg, hogy az iménti hibaüzenet mellett nem látunk-e val
/usr/libexec/ld-elf.so.1: Shared object "libXaw.so.6" not found
....
-Az ilyen jellegû hibák általában olyankor keletkeznek, amikor olyan gépre telepítjük a package:net/cvsup[] portot, amelyen viszont nem található meg a Xorg programcsomag. Amennyiben szükségünk lenne CVSup programhoz mellékelt grafikus felületre, akkor kénytelenek leszünk mellé az Xorg programjait is telepíteni. Ha viszont egyszerûen csak parancssorból szeretnénk használni a CVSup lehetõségeit, töröljük le a korábban telepített csomagot, majd helyette rakjuk fel a package:net/cvsup-without-gui[] vagy a package:net/csup[] portot. A FreeBSD újabb változataiban megpróbálkozhatunk a man:csup[1] használatával is. Ezzel a témával részletesebban a kézikönyv link:{handbook}#cvsup/[CVSup használatáról] szóló része foglalkozik.
+Az ilyen jellegû hibák általában olyankor keletkeznek, amikor olyan gépre telepítjük a package:net/cvsup[] portot, amelyen viszont nem található meg a Xorg programcsomag. Amennyiben szükségünk lenne CVSup programhoz mellékelt grafikus felületre, akkor kénytelenek leszünk mellé az Xorg programjait is telepíteni. Ha viszont egyszerûen csak parancssorból szeretnénk használni a CVSup lehetõségeit, töröljük le a korábban telepített csomagot, majd helyette rakjuk fel a package:net/cvsup-without-gui[] vagy a package:net/csup[] portot. A FreeBSD újabb változataiban megpróbálkozhatunk a man:csup[1] használatával is. Ezzel a témával részletesebban a kézikönyv extref:{handbook}mirrors/[CVSup használatáról, cvsup] szóló része foglalkozik.
== Biztonság
@@ -3223,7 +3212,7 @@ Biztonsági okokból a `suidperl` parancs alapértelmezés szerint nem kerül te
=== Nem mûködik a man:ppp[8]. Mit lehet a gond?
-Elsõként mindenképpen olvassuk el a man:ppp[8] man oldalt és a kézikönyv link:{handbook}#USERPPP[PPP-vel] foglalkozó részét. A következõ paranccsal engedélyezzük a naplózást:
+Elsõként mindenképpen olvassuk el a man:ppp[8] man oldalt és a kézikönyv extref:{handbook}ppp-and-slip[PPP-vel, userppp] foglalkozó részét. A következõ paranccsal engedélyezzük a naplózást:
[.programlisting]
....
@@ -3273,7 +3262,7 @@ Az alapértelmezett útvonal hiányának másik oka lehet még, ha az [.filename
delete ALL
....
-Ebben az esetben menjünk vissza a kézikönyv link:{handbook}#USERPPP-FINAL[A rendszer végsõ beállítása] címû részéhez.
+Ebben az esetben menjünk vissza a kézikönyv extref:{handbook}ppp-and-slip[A rendszer végsõ beállítása, userppp-final] címû részéhez.
=== Mit jelent a No route to host hibaüzenet?
@@ -3294,7 +3283,7 @@ delete ALL
add 0 0 HISADDR
....
-A kézikönyv link:{handbook}#USERPPP-DYNAMICIP[A PPP és a dinamikus IP-címek] címû részében olvashatunk errõl bõvebben.
+A kézikönyv extref:{handbook}ppp-and-slip[A PPP és a dinamikus IP-címek, userppp-dynamicip] címû részében olvashatunk errõl bõvebben.
=== Miért szakad meg a kapcsolat 3 perc után?
@@ -3483,7 +3472,7 @@ set dfilter 3 permit 0/0 0/0
Ezek az értékek nem minden esetben megfelelõek számunkra, hiszen ezzel együtt az igény szerinti tárcsázás kényelmét is szûkítjük, mivel a legtöbb program közvetlenül névfeloldással kezd, mielõtt komolyabb hálózati forgalmat bonyolítana le.
-A névfeloldás esetében igyekezzünk kideríteni, hogy pontosan melyik program is próbál hálózati neveket feloldatni. Az esetek többségében valószínûleg a man:sendmail[8] lesz a bûnös. Amennyiben ez a helyzet, akkor az sendmail démonnak a saját konfigurációs állományában kell beállítanunk, hogy ne oldasson fel hálózati neveket. Az érintett konfigurációs állomány módosításának pontos részleteirõl a kézikönyv link:{handbook}#smtp-dialup/[Levelezés betárcsázós kapcsolattal] címû szakszában olvashatunk bõvebben. Továbbá az [.filename]#.mc# állományunkba a következõ sort is érdemes felvennünk:
+A névfeloldás esetében igyekezzünk kideríteni, hogy pontosan melyik program is próbál hálózati neveket feloldatni. Az esetek többségében valószínûleg a man:sendmail[8] lesz a bûnös. Amennyiben ez a helyzet, akkor az sendmail démonnak a saját konfigurációs állományában kell beállítanunk, hogy ne oldasson fel hálózati neveket. Az érintett konfigurációs állomány módosításának pontos részleteirõl a kézikönyv extref:{handbook}mail/[Levelezés betárcsázós kapcsolattal, smtp-dialup] címû szakszában olvashatunk bõvebben. Továbbá az [.filename]#.mc# állományunkba a következõ sort is érdemes felvennünk:
[.programlisting]
....
@@ -3789,15 +3778,15 @@ Sajnos még nem. Minden kártyához másik megszakítást kell megadni.
=== Hogyan lehet beállítani a portok alapértelmezett paramétereit?
-Ezzel kapcsolatban olvassuk el a FreeBSD kézikönyv link:{handbook}#SERIAL-HW-CONFIG[soros kommunikációt] tárgyaló részét.
+Ezzel kapcsolatban olvassuk el a FreeBSD kézikönyv extref:{handbook}serialcomms[soros kommunikációt, serial-hw-config] tárgyaló részét.
=== Hogyan lehet a modemen betárcsázást beállítani?
-Erre vonatkozóan olvassuk el a FreeBSD kézikönyv link:{handbook}#dialup/[betárcsázós szolgáltatásokkal] kapcsolatos részét.
+Erre vonatkozóan olvassuk el a FreeBSD kézikönyv extref:{handbook}serialcomms/[betárcsázós szolgáltatásokkal, dialup] kapcsolatos részét.
=== Hogyan lehet buta terminálokat FreeBSD-re csatlakoztatni?
-Az ezzel kapcsolatos információkat a FreeBSD kézikönyv link:{handbook}#term/[terminálokról] szóló részében találhatjuk meg.
+Az ezzel kapcsolatos információkat a FreeBSD kézikönyv extref:{handbook}serialcomms/[terminálokról, term] szóló részében találhatjuk meg.
=== Miért nem indul el a tip vagy cu parancs?
@@ -3813,47 +3802,47 @@ A következõ parancs kiadásával viszont ettõl függetlenül is engedélyezhe
=== A rendszerhez csatlakozó Hayes szabványú modem támogatott - mi ilyenkor teendõ?
-A FreeBSD kézikönyvben lásd link:{handbook}#HAYES-UNSUPPORTED[ezt] a választ.
+A FreeBSD kézikönyvben lásd extref:{handbook}serialcomms[ezt, hayes-unsupported] a választ.
=== Hogyan adjuk meg az AT parancsokat?
-A FreeBSD kézikönyvben lásd link:{handbook}#DIRECT-AT[ezt] a választ.
+A FreeBSD kézikönyvben lásd extref:{handbook}serialcomms[ezt, direct-at] a választ.
=== A pn tulajdonságnál miért nem lehet @ jelet megadni?
-A FreeBSD kézikönyvben lásd link:{handbook}#GT-FAILURE[ezt] a választ.
+A FreeBSD kézikönyvben lásd extref:{handbook}serialcomms[ezt, gt-failure] a választ.
=== Hogyan lehet telefonszámokat tárcsázni parancssorból?
-A FreeBSD kézikönyvben lásd link:{handbook}#DIAL-COMMAND-LINE[ezt] a választ.
+A FreeBSD kézikönyvben lásd extref:{handbook}serialcomms[ezt, dial-command-line] a választ.
=== Minden alkalommal meg kell adni az adatátviteli sebességet?
-A FreeBSD kézikönyvben lásd link:{handbook}#SET-BPS[ezt] a választ.
+A FreeBSD kézikönyvben lásd extref:{handbook}serialcomms[ezt, set-bps] a választ.
=== Terminálszerver segítségével hogyan lehet könnyen elérni egyszerre több gépet is?
-A FreeBSD kézikönyvben lásd link:{handbook}#TERMINAL-SERVER[ezt] a választ.
+A FreeBSD kézikönyvben lásd extref:{handbook}serialcomms[ezt, terminal-server] a választ.
=== A man:tip[1] képes több vonalat is használni az egyes gépek eléréséhez?
-A FreeBSD kézikönyvben lásd link:{handbook}#TIP-MULTILINE[ezt] a választ.
+A FreeBSD kézikönyvben lásd extref:{handbook}serialcomms[ezt, tip-multiline] a választ.
=== Miért kell kétszer lenyomni a CtrlP billentyûket, hogy egyszer elküldjük ezeket?
-A FreeBSD kézikönyvben lásd link:{handbook}#MULTI-CONTROLP[ezt] a választ.
+A FreeBSD kézikönyvben lásd extref:{handbook}serialcomms[ezt, multi-contorlp] a választ.
=== Miért lett hirtelen minden NAGYBETûS?
-A FreeBSD kézikönyvben lásd link:{handbook}#UPPERCASE[ezt] a választ.
+A FreeBSD kézikönyvben lásd extref:{handbook}serialcomms[ezt, uppercase] a választ.
=== Hogyan lehet állományokat mozgatni a tip használatával?
-A FreeBSD kézikönyvben lásd link:{handbook}#TIP-FILETRANSFER[ezt] a választ.
+A FreeBSD kézikönyvben lásd extref:{handbook}serialcomms[ezt, tip-filetransfer] a választ.
=== Hogyan használható a zmodem protokoll a tip programmal?
-A FreeBSD kézikönyvben lásd link:{handbook}#ZMODEM-TIP[ezt] a választ.
+A FreeBSD kézikönyvben lásd extref:{handbook}serialcomms[ezt, zmode-tip] a választ.
== Egyéb kérdések
@@ -3903,7 +3892,7 @@ Amennyiben a doscmd önmagában még nem lenne elegendõ, egy másik segédprogr
=== Hogyan tudjuk az anyanyelvünkre lefordítani a FreeBSD dokumentációját?
-Olvassuk el a FreeBSD Dokumentációs Projekt bevezetõjében található link:{fdp-primer}#translations/[Fordítói GYIK-ot].
+Olvassuk el a FreeBSD Dokumentációs Projekt bevezetõjében található extref:{fdp-primer}[Fordítói GYIK-ot, translations].
=== A FreeBSD.org tartományon belüli e-mail címekre küldött levelek miért pattannak vissza?
@@ -3937,7 +3926,7 @@ A http://www.grex.org/[Grex] az _M-Net_ szolgáltatásához hasonlóan ugyanúgy
A http://www.FreeBSD.org/cgi/ports.cgi?^sup[SUP] mozaikszó mögött a "Software Update Protocol" ("Szoftverfrissítési protokoll") áll, amelyet fejlesztési fák szinkronban tartására dolgoztak ki a Carnegie-Mellon Egyetemen. Régebben ennek segítségével tartották frissítették magukat a fejlesztõi források különbözõ tükrözései a FreeBSD Projekten belül.
-A SUP nem kifejezetten egy sávszélesség-takarékos megoldás, és egy ideje már nyugdíjba vonult. A forrásainkat jelen pillanatban a link:{handbook}#CVSUP[CVSup] használatával tudjuk frissíteni.
+A SUP nem kifejezetten egy sávszélesség-takarékos megoldás, és egy ideje már nyugdíjba vonult. A forrásainkat jelen pillanatban a extref:{handbook}mirrors[CVSup, cvsup] használatával tudjuk frissíteni.
=== Hogy hívják azt a cuki kis vörös fickót?
@@ -3957,7 +3946,7 @@ EPS és XFig formátumú rajzok a [.filename]#/usr/shared/examples/BSD_daemon/#
=== A levelezési listákon szerepeltek ismeretlen kifejezések vagy rövidítések. Hol lehet ezeknek utánanézni?
-Olvassuk el a link:{handbook}#freebsd-glossary/[FreeBSD szakkifejezéseinek gyûjteményét].
+Olvassuk el a extref:{handbook}glossary/[FreeBSD szakkifejezéseinek gyûjteményét, freebsd-glossary].
=== Miért fontos annyira a biciklitároló színe?
@@ -4086,11 +4075,11 @@ Jelen pillanatban csak egyetlen mû foglalkozik az operációs rendszerek felép
Emellett a UNIX(R) típusú rendszerek használatával kapcsolatos ismeret remekül alkalmazható a FreeBSD esetén is.
-A témához tartozó többi könyvet a kézikönyv link:{handbook}#bibliography-osinternals/[Az operációs rendszerek belsõ mûködésével] foglalkozó irodalomjegyzékben találhatjuk meg.
+A témához tartozó többi könyvet a kézikönyv extref:{handbook}bibliography/[Az operációs rendszerek belsõ mûködésével, bibliography-osinternals] foglalkozó irodalomjegyzékben találhatjuk meg.
=== Hogyan lehet bekapcsolódni a FreeBSD fejlesztésébe?
-Pontosabb tanácsokat akkor kapunk, ha elolvassuk a link:{contributing}[FreeBSD fejlesztésérõl szóló cikket]. Nagyon is számítunk mindenki segítségére!
+Pontosabb tanácsokat akkor kapunk, ha elolvassuk a extref:{contributing}[FreeBSD fejlesztésérõl szóló cikket]. Nagyon is számítunk mindenki segítségére!
=== Mik azok a pillanatkiadások és kiadások?
@@ -4106,7 +4095,7 @@ Jelen pillanatban a _-CURRENT_ a 9._X_ fejlesztési irányát képviseli; az `6-
=== Hogyan lehet saját kiadást készíteni?
-Olvassuk el a link:{releng}[kiadások készítésérõl szóló] cikket.
+Olvassuk el a extref:{releng}[kiadások készítésérõl szóló] cikket.
=== A make world parancs miért írja felül a korábban telepített binárisokat?
@@ -4120,7 +4109,7 @@ Habár a CVSup tükrözések óránként frissítik magukat a központi CVSup sz
=== A -CURRENT forrásait korlátozott interneteléréssel is lehet követni?
-Igen, ezt a link:{handbook}#synching/#CTM[CTM] használatával _anélkül_ is megtudjuk tenni, hogy le kellene töltenünk az egész forrásfát.
+Igen, ezt a extref:{handbook}updating-upgrading[CTM, synching] használatával _anélkül_ is megtudjuk tenni, hogy le kellene töltenünk az egész forrásfát.
=== Hogyan lehet 1392 KB-os darabokra felosztani az egyes terjesztéseket?
@@ -4135,7 +4124,7 @@ ZIPNSPLIT= gzip --no-name -9 -c | split -b 1392k -
=== Hova lehet küldeni a rendszermaghoz írt kiegészítéseket?
-Erre vonatkozóan vessünk egy pillantást a link:{contributing}[FreeBSD továbbfejlesztésérõl szóló] cikkre.
+Erre vonatkozóan vessünk egy pillantást a extref:{contributing}[FreeBSD továbbfejlesztésérõl szóló] cikkre.
Köszönjük, hogy gondolt ránk!
@@ -4310,7 +4299,7 @@ Az _N_ megfelelõ értékének megállapításához osszuk el a beállítani kí
Ezt a szegény kis ártatlan GYIKocskát több százan, ha nem is éppen több ezren írták, újraírták, szerkesztették, hajtogatták, tekergették, csonkítgatták, kibelezték, nézegették, összekutyulták, emlegették, felöklendezték, újraépítették, javítgatták és felpezsdítették az utóbbi években. Folyamatosan.
-Ezúton is szeretnénk köszönetet mondani mindazoknak, akik gondozásukba vették, és mindenkit csak bátorítani tudunk, hogy link:{contributing}[csatlakozzon hozzájuk] a GYIK továbbfejlesztésében.
+Ezúton is szeretnénk köszönetet mondani mindazoknak, akik gondozásukba vették, és mindenkit csak bátorítani tudunk, hogy extref:{contributing}[csatlakozzon hozzájuk] a GYIK továbbfejlesztésében.
[bibliography]
[[bibliography]]
diff --git a/documentation/content/hu/books/handbook/_index.adoc b/documentation/content/hu/books/handbook/_index.adoc
index 81833867a9..aaf3cc0893 100644
--- a/documentation/content/hu/books/handbook/_index.adoc
+++ b/documentation/content/hu/books/handbook/_index.adoc
@@ -3,9 +3,9 @@ title: FreeBSD kézikönyv
authors:
- author: A FreeBSD Dokumentációs Projekt
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
next: books/handbook/preface
+isIndex: true
---
= FreeBSD kézikönyv
@@ -15,15 +15,32 @@ next: books/handbook/preface
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
+:images-path: books/handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Kivonat
@@ -34,10 +51,10 @@ _Fordította: Páli Gábor, utolsó ellenõrzés: 2010.11.28._
'''
-include::content/hu/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
-include::content/hu/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
-include::content/hu/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
-include::content/hu/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/hu/books/handbook/advanced-networking/_index.adoc b/documentation/content/hu/books/handbook/advanced-networking/_index.adoc
index e25dc4d69e..d9e6bf0301 100644
--- a/documentation/content/hu/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/hu/books/handbook/advanced-networking/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 31
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 31
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[advanced-networking-synopsis]]
== Áttekintés
@@ -2496,7 +2494,7 @@ Valószínûleg a többi terminál adapterrel is képes együttmûködni, mivel
Az igazi probléma a külsõ terminál adapterekkel adódik, mivel, akárcsak a modemek esetében, egy nagyon jó soros kártyát igényelnek.
-A soros eszközök mûködésének részleteit valamint az aszinkron és szinkron soros portok közti különbségeket a link:{serial-uart}[FreeBSD soros hardverekrõl] szóló cikkében olvashatjuk.
+A soros eszközök mûködésének részleteit valamint az aszinkron és szinkron soros portok közti különbségeket a extref:{serial-uart}[FreeBSD soros hardverekrõl] szóló cikkében olvashatjuk.
A terminál adaptereken keresztül elérhetõ sebességet a PC-kben található szabványos (aszinkron) soros port 115,2 Kb/mp-re korlátozza, még 128 Kb/mp-es adatátvitelû kapcsolatok esetében is. Az ISDN által nyújtott 128 Kb/mp kihasználásához a terminál adaptert egy szinkron soros kártyával kell összekötnünk.
diff --git a/documentation/content/hu/books/handbook/audit/_index.adoc b/documentation/content/hu/books/handbook/audit/_index.adoc
index 82089d2cd8..fe7edd5385 100644
--- a/documentation/content/hu/books/handbook/audit/_index.adoc
+++ b/documentation/content/hu/books/handbook/audit/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/disks
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[audit-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/basics/_index.adoc b/documentation/content/hu/books/handbook/basics/_index.adoc
index 3e3ba067c0..104f87ae40 100644
--- a/documentation/content/hu/books/handbook/basics/_index.adoc
+++ b/documentation/content/hu/books/handbook/basics/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ports
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[basics-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/bibliography/_index.adoc b/documentation/content/hu/books/handbook/bibliography/_index.adoc
index 9e0f0e56cc..9a8327d813 100644
--- a/documentation/content/hu/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/hu/books/handbook/bibliography/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/eresources
[[bibliography]]
= Irodalomjegyzék
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Míg a man oldalak a FreeBSD operációs rendszer egyes önálló részeit tárgyalják, ismert a tény, hogy arról egyáltalán nem szólnak, miképpen illeszkednek egymáshoz ezek az alkotóelemek, és ezáltal hogyan mûködik maga az operációs rendszer. Erre a célra egyedül csak egy jó UNIX(R)-os rendszeradminisztrációs szakkönyv és egy jó felhasználói kézikönyv alkalmas.
diff --git a/documentation/content/hu/books/handbook/book.adoc b/documentation/content/hu/books/handbook/book.adoc
index fc43655d1b..c73df509e8 100644
--- a/documentation/content/hu/books/handbook/book.adoc
+++ b/documentation/content/hu/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: FreeBSD kézikönyv
authors:
- author: A FreeBSD Dokumentációs Projekt
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
---
@@ -12,51 +11,35 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
:book: true
:pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
-:chapters-path: content/hu/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/hu/mailing-lists.adoc[]
-include::../../../../shared/hu/teams.adoc[]
-include::../../../../shared/hu/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/hu/mailing-lists.adoc[]
-include::../../../../shared/hu/teams.adoc[]
-include::../../../../shared/hu/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -73,95 +56,95 @@ toc::[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
// Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..26;36..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
-include::{chapters-path}install/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}install/_index.adoc[leveloffset=+1]
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
-include::{chapters-path}users/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}users/_index.adoc[leveloffset=+1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}jails/_index.adoc[leveloffset=+1]
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
-include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}filesystems/_index.adoc[leveloffset=+1]
-include::{chapters-path}vinum/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}vinum/_index.adoc[leveloffset=+1]
-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
-include::{chapters-path}dtrace/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}dtrace/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=7..19]
+include::{chapters-path}partiv.adoc[lines=15..27]
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
// Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
:sectnums!:
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/hu/books/handbook/boot/_index.adoc b/documentation/content/hu/books/handbook/boot/_index.adoc
index 63b61b9659..ed04f932e1 100644
--- a/documentation/content/hu/books/handbook/boot/_index.adoc
+++ b/documentation/content/hu/books/handbook/boot/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/users
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/config/_index.adoc b/documentation/content/hu/books/handbook/config/_index.adoc
index 031bdf4f20..3e11170a26 100644
--- a/documentation/content/hu/books/handbook/config/_index.adoc
+++ b/documentation/content/hu/books/handbook/config/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/boot
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/config/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/config/
-endif::[]
+:images-path: books/handbook/config/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/config/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[config-synopsis]]
== Áttekintés
@@ -269,7 +267,7 @@ Ez mindegyik [.filename]#crontab# állomány alapbeállítása, habár ettõl á
[IMPORTANT]
====
-Nem kötelezõ az itt ismertetésre kerülõ módon szerkeszteni vagy telepíteni a rendszer crontabját. Egyszerûen nyissuk meg a kedvenc szövegszerkesztõnkkel, és a `cron` segédprogram majd észreveszi, hogy az állomány megváltozott, majd ennek megfelelõen neki is lát a módosított változat használatának. Errõl link:{faq}#ROOT-NOT-FOUND-CRON-ERRORS[a GYIK-ban (angolul)] többet is megtudhatunk.
+Nem kötelezõ az itt ismertetésre kerülõ módon szerkeszteni vagy telepíteni a rendszer crontabját. Egyszerûen nyissuk meg a kedvenc szövegszerkesztõnkkel, és a `cron` segédprogram majd észreveszi, hogy az állomány megváltozott, majd ennek megfelelõen neki is lát a módosított változat használatának. Errõl extref:{faq}[a GYIK-ban (angolul), ROOT-NOT-FOUND-CRON-ERRORS] többet is megtudhatunk.
====
Egy frissen készített felhasználói [.filename]#crontab# telepítéséhez elõször a kedvenc szövegszerkesztõnk segítségével létre kell hoznunk a megfelelõ formátumú állományt, majd használnunk a `crontab` segédprogramot. Ennek általános alakja:
@@ -373,7 +371,7 @@ A következõ kulcsszavak az egyes indítóállományok elején szerepelhetnek.
Az indító szkriptekben a kulcsszavak ügyes megválasztásával a rendszergazda nagyon finoman képes az indításkor végrehajtódó szkriptek sorrendjét szabályozni és a többi UNIX(R) alapú operációs rendszerbõl ismert "futtatási szintek" használata nélkül vezérelni a rendszerben megjelenõ szolgáltatásokat.
-Az [.filename]#rc.d# rendszerrõl bõvebben az man:rc[8] és man:rc.subr[8] man oldalakon olvashatunk. Ha szeretnénk saját [.filename]#rc.d# szkripteket írni vagy javítani a már meglévõkön, akkor ez link:{rc-scripting}[a cikk] (angolul) segítségünkre lehet.
+Az [.filename]#rc.d# rendszerrõl bõvebben az man:rc[8] és man:rc.subr[8] man oldalakon olvashatunk. Ha szeretnénk saját [.filename]#rc.d# szkripteket írni vagy javítani a már meglévõkön, akkor ez extref:{rc-scripting}[a cikk] (angolul) segítségünkre lehet.
[[config-network-setup]]
== A hálózati kártyák beállítása
diff --git a/documentation/content/hu/books/handbook/cutting-edge/_index.adoc b/documentation/content/hu/books/handbook/cutting-edge/_index.adoc
index 1c93d1cb73..626c7cd1e9 100644
--- a/documentation/content/hu/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/hu/books/handbook/cutting-edge/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/dtrace
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[updating-upgrading-synopsis]]
== Áttekintés
@@ -519,7 +517,7 @@ Az elkészült dokumentáció telepítésének helye. Ez alapértelmezés szerin
A folyamathoz kapcsolódóan további rendszerszintû man:make[1] változókról a man:make.conf[5] man oldalon olvashatunk.
-A FreeBSD dokumentációjának elõállításáért felelõs rendszerben használható man:make[1] további változók bemutatásával kapcsolatban pedig olvassuk el az link:{fdp-primer}[A FreeBSD Dokumentációs Projekt irányelvei kezdõknek] címû könyvet.
+A FreeBSD dokumentációjának elõállításáért felelõs rendszerben használható man:make[1] további változók bemutatásával kapcsolatban pedig olvassuk el az extref:{fdp-primer}[A FreeBSD Dokumentációs Projekt irányelvei kezdõknek] címû könyvet.
[[updating-installed-documentation]]
=== A FreeBSD dokumentációjának telepítése forrásból
diff --git a/documentation/content/hu/books/handbook/desktop/_index.adoc b/documentation/content/hu/books/handbook/desktop/_index.adoc
index e7d58bc596..0135c84c82 100644
--- a/documentation/content/hu/books/handbook/desktop/_index.adoc
+++ b/documentation/content/hu/books/handbook/desktop/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/multimedia
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[desktop-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/disks/_index.adoc b/documentation/content/hu/books/handbook/disks/_index.adoc
index 1d9e4ec8b8..9f78a6f090 100644
--- a/documentation/content/hu/books/handbook/disks/_index.adoc
+++ b/documentation/content/hu/books/handbook/disks/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/geom
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[disks-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/dtrace/_index.adoc b/documentation/content/hu/books/handbook/dtrace/_index.adoc
index 8267402a09..0e94778c60 100644
--- a/documentation/content/hu/books/handbook/dtrace/_index.adoc
+++ b/documentation/content/hu/books/handbook/dtrace/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/dtrace/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
-endif::[]
+:images-path: books/handbook/dtrace/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dtrace-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/eresources/_index.adoc b/documentation/content/hu/books/handbook/eresources/_index.adoc
index a94005547b..61b112e028 100644
--- a/documentation/content/hu/books/handbook/eresources/_index.adoc
+++ b/documentation/content/hu/books/handbook/eresources/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/pgpkeys
[[eresources]]
= Források az interneten
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
A FreeBSD gyors ütemû fejlõdése a nyomtatott médiát alkalmatlanná teszi a legfrissebb fejlesztések nyomonkövetésére. Ezzel szemben az elektronikus erõforrások a biztos, ha gyakran nem is csak az egyetlen, módjai a legújabb elõrelépések figyelemmel követésének. Mivel a FreeBSD-t többségében önkéntesek fejlesztik, az õt körülvevõ felhasználói közösség önmaga is egyfajta "szakmai segélynyújtó egyletként" funkcionál, amelyet leghatékonyabban elektronikus levélben, webes fórumokon vagy USENET hírcsoportokon keresztül érhetünk el.
@@ -47,9 +60,9 @@ A különbözõ listák témájának rövid leírása a dokumentum alján olvash
_A {freebsd-test} címet használjuk, ha ki akarjuk próbálni, hogy tudunk-e levelet küldeni a FreeBSD listáira._ A többi listára viszont lehetõleg ne küldjünk teszt jellegû üzeneteket.
====
-Ha nem tudjuk eldönteni, hogy pontosan melyik listát is kellene megcímeznünk kérdésünkkel, olvassuk el a link:{freebsd-questions-article}[Hogyan kapjunk értékelhetõ választ a FreeBSD-questions levelezési listáról] címû leírást (angolul).
+Ha nem tudjuk eldönteni, hogy pontosan melyik listát is kellene megcímeznünk kérdésünkkel, olvassuk el a extref:{freebsd-questions-article}[Hogyan kapjunk értékelhetõ választ a FreeBSD-questions levelezési listáról] címû leírást (angolul).
-Mielõtt akármelyik listára is levelet küldenénk, olvassuk el a link:{mailing-list-faq}[Levelezési listák Gyakran Ismételt Kérdéseit] (angolul), amivel elkerülhetjük a gyakran feltett kérdések és témák ismételt felhozását.
+Mielõtt akármelyik listára is levelet küldenénk, olvassuk el a extref:{mailing-list-faq}[Levelezési listák Gyakran Ismételt Kérdéseit] (angolul), amivel elkerülhetjük a gyakran feltett kérdések és témák ismételt felhozását.
A levelezési listák tartalma folyamatosan archiválódik, és ezekben az archívumokban a link:https://www.FreeBSD.org/search/[FreeBSD honlapján] tudunk keresni. Az itt elérhetõ, kulcsszavak alapján történõ keresés remek módját nyújtja a gyakran felmerülõ kérdések egyszerû és gyors megválaszolásának, ezért ilyen esetekben elõször mindig ezt javasolt használni. Ez egyben mellesleg azt is jelenti, hogy a FreeBSD levelezési listáira küldött üzenetek fennmaradnak az örökkévalóságig. Ha a beküldendõ üzenet bizalmas információkat tartalmaz, érdemes megfontolni egy eldobható anonim e-mail cím használatát és kizárólag csak a publikus részet beküldeni.
diff --git a/documentation/content/hu/books/handbook/filesystems/_index.adoc b/documentation/content/hu/books/handbook/filesystems/_index.adoc
index 7897c3a055..fc837d3c37 100644
--- a/documentation/content/hu/books/handbook/filesystems/_index.adoc
+++ b/documentation/content/hu/books/handbook/filesystems/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/vinum
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/filesystems/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
-endif::[]
+:images-path: books/handbook/filesystems/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[filesystems-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/firewalls/_index.adoc b/documentation/content/hu/books/handbook/firewalls/_index.adoc
index e75d459fa6..c54c2eeeca 100644
--- a/documentation/content/hu/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/hu/books/handbook/firewalls/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/advanced-networking
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 30
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 30
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[firewalls-intro]]
== Bevezetés
diff --git a/documentation/content/hu/books/handbook/geom/_index.adoc b/documentation/content/hu/books/handbook/geom/_index.adoc
index 18c8499bc8..6bee710c1c 100644
--- a/documentation/content/hu/books/handbook/geom/_index.adoc
+++ b/documentation/content/hu/books/handbook/geom/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/filesystems
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[GEOM-synopsis]]
== Áttekintés
@@ -557,4 +555,4 @@ Ha több slice-unk is van, akkor a napló mindegyik slice-hoz külön létrejön
A jobb teljesítmény elérése érdekében kívánatos lehet a naplót egy másik lemezen tartani. Ilyen esetekben a naplózás bekapcsolásához a naplót biztosító szolgáltatót vagy tárolóeszközt a naplózni kívánt eszköz után kell szerepeltetni. A naplózás akár az aktuálisan használt állományrendszeren is aktiválható a `tunefs` használatával. Az állományrendszer módosításakor viszont mindig érdemes biztonsági másolatot készíteni! Az esetek többségében a `gjournal` hibát fog jelezni, mivel nem tudja létrehozni a naplót, azonban ez nem védi meg az adatainkat a `tunefs` helytelen használata által okozott sérülésektõl.
-A rendszerindító lemezen is lehet naplózást használni. Ennek részleit a link:{gjournal-desktop}[Naplózó UFS használata asztali számítógépeken] címû cikkbõl ismerhetjük meg.
+A rendszerindító lemezen is lehet naplózást használni. Ennek részleit a extref:{gjournal-desktop}[Naplózó UFS használata asztali számítógépeken] címû cikkbõl ismerhetjük meg.
diff --git a/documentation/content/hu/books/handbook/install/_index.adoc b/documentation/content/hu/books/handbook/install/_index.adoc
index 5ad9c171c0..f837e7dcf7 100644
--- a/documentation/content/hu/books/handbook/install/_index.adoc
+++ b/documentation/content/hu/books/handbook/install/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/basics
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/install/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/install/
-endif::[]
+:images-path: books/handbook/install/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/install/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[install-synopsis]]
== Áttekintés
@@ -2808,7 +2806,7 @@ Ha másik platformon végezzük ezt a mûveletet, akkor az adott platformon felk
[NOTE]
====
-Ha kíváncsiak vagyunk egy saját FreeBSD kiadás elkészítésére, olvassuk el a link:{releng}[kiadások szervezésérõl szóló cikket (angolul)].
+Ha kíváncsiak vagyunk egy saját FreeBSD kiadás elkészítésére, olvassuk el a extref:{releng}[kiadások szervezésérõl szóló cikket (angolul)].
====
[[install-ftp]]
@@ -2922,7 +2920,7 @@ Ezenkívül még ismernünk kell a hálózaton kapott IP-címünket, az általa
Ha modemet használunk, akkor a PPP szinte biztosan megfelel nekünk. Gondoskodjunk róla, hogy már a telepítés korai szakaszában rendelkezésünkre áll az internet-szolgáltatónkkal kapcsolatosan minden hasznos információ.
-Ha PAP vagy CHAP használatával kapcsolódunk a szolgáltatónkhoz (másképp szólva Windows(R)-ban így tudunk szkriptek nélkül csatlakozni), mindössze a `dial` parancsot kell kiadnunk a ppp parancssorában. Minden más esetben tudnunk kell a modemünk saját "AT parancsaival" tárcsázni az internet-szolgáltatónkat, hiszen ehhez a PPP tárcsázó csak egy nagyon kezdetleges terminálemulációt nyújt. Ezzel kapcsolatban olvassuk el crossref:ppp-and-slip[userppp,a kézikönyv] és a link:{faq}#ppp/[GYIK] idevágó részeit. Ha gondjaink akadnának, a naplózás a `set log local ...` parancs kiadásával átirányítható közvetlenül a képernyõre.
+Ha PAP vagy CHAP használatával kapcsolódunk a szolgáltatónkhoz (másképp szólva Windows(R)-ban így tudunk szkriptek nélkül csatlakozni), mindössze a `dial` parancsot kell kiadnunk a ppp parancssorában. Minden más esetben tudnunk kell a modemünk saját "AT parancsaival" tárcsázni az internet-szolgáltatónkat, hiszen ehhez a PPP tárcsázó csak egy nagyon kezdetleges terminálemulációt nyújt. Ezzel kapcsolatban olvassuk el crossref:ppp-and-slip[userppp,a kézikönyv] és a extref{faq}[GYIK, ppp] idevágó részeit. Ha gondjaink akadnának, a naplózás a `set log local ...` parancs kiadásával átirányítható közvetlenül a képernyõre.
Ha kötött módon tudunk csatlakozni egy másik (2.0-R vagy késõbbi verziójú) FreeBSD géphez, akkor megpróbálkozhatunk a párhuzamos "laplink" kábellel. A párhuzamos porton keresztüli adatátvitel sebessége a soros vonalénál jóval nagyobb (egészen 50 kbyte/mp), ezért vele a telepítés is gyorsabb.
diff --git a/documentation/content/hu/books/handbook/introduction/_index.adoc b/documentation/content/hu/books/handbook/introduction/_index.adoc
index 4d698c68d4..e41e327115 100644
--- a/documentation/content/hu/books/handbook/introduction/_index.adoc
+++ b/documentation/content/hu/books/handbook/introduction/_index.adoc
@@ -13,25 +13,35 @@ next: books/handbook/install
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/handbook/introduction/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-synopsis]]
== Áttekintés
@@ -49,7 +59,7 @@ A fejezet elolvasása során megismerjük:
[[nutshell]]
== Üdvözöljük a FreeBSD-ben!
-A FreeBSD egy 4.4BSD-Lite alapú operációs rendszer Intel(R) (x86 és Itanium(R)), AMD64, Alpha(TM), Sun UltraSPARC(R) számítógépekre. Jelenleg is portolás alatt áll további architektúrákra. Olvashatunk a <<history,FreeBSD történetérõl>> vagy éppen az <<relnotes,aktuális kiadásáról>>. Ha szeretnénk hozzájárulni a Projekt fejlõdéséhez (forráskód, hardver vagy pénz), olvassuk el a link:{contributing}[Hozzájárulás a FreeBSD-hez] címû cikket (angolul).
+A FreeBSD egy 4.4BSD-Lite alapú operációs rendszer Intel(R) (x86 és Itanium(R)), AMD64, Alpha(TM), Sun UltraSPARC(R) számítógépekre. Jelenleg is portolás alatt áll további architektúrákra. Olvashatunk a <<history,FreeBSD történetérõl>> vagy éppen az <<relnotes,aktuális kiadásáról>>. Ha szeretnénk hozzájárulni a Projekt fejlõdéséhez (forráskód, hardver vagy pénz), olvassuk el a extref:{contributing}[Hozzájárulás a FreeBSD-hez] címû cikket (angolul).
[[os-overview]]
=== Mire képes a FreeBSD?
@@ -176,7 +186,7 @@ A forrásfánkban található GNU General Public License (GPL) vagy a Library Ge
[[development]]
=== A FreeBSD fejlesztési modellje
-A FreeBSD fejlesztése egy nagyon nyitott és rugalmas folyamat, szó szerint a világ minden tájáról érkezõ többszáznyi segítségbõl építkezik, ahogy az látható is a link:{contributors}[résztvevõink listáján]. A FreeBSD fejlesztési infrastruktúrája lehetõvé teszi, hogy ez a többszáznyi résztvevõ az interneten keresztül mûködjön együtt. Folyamatosan várjuk az új fejlesztõket és ötleteket, és mindazok, akik komolyabban érdeklõdnek a Projekt iránt, egyszerûen felvehetik velünk a kapcsolatot a {freebsd-hackers} címén. Egy {freebsd-announce} is elérhetõ azok számára, akik értesíteni kívánják a többi FreeBSD felhasználót munkájuk fõbb eredményeirõl.
+A FreeBSD fejlesztése egy nagyon nyitott és rugalmas folyamat, szó szerint a világ minden tájáról érkezõ többszáznyi segítségbõl építkezik, ahogy az látható is a extref:{contributors}[résztvevõink listáján]. A FreeBSD fejlesztési infrastruktúrája lehetõvé teszi, hogy ez a többszáznyi résztvevõ az interneten keresztül mûködjön együtt. Folyamatosan várjuk az új fejlesztõket és ötleteket, és mindazok, akik komolyabban érdeklõdnek a Projekt iránt, egyszerûen felvehetik velünk a kapcsolatot a {freebsd-hackers} címén. Egy {freebsd-announce} is elérhetõ azok számára, akik értesíteni kívánják a többi FreeBSD felhasználót munkájuk fõbb eredményeirõl.
A FreeBSD Projektrõl és annak fejlesztési modelljérõl hasznos tudni az alábbiakat, függetlenül attól, hogy egyedül vagy másokkal szoros együttmûködésben dolgozunk:
@@ -189,7 +199,7 @@ A hivatalos fejlesztõk (_committerek_) azok az emberek, akik a CVS-fához írá
A FreeBSD Core Team[[development-core]]::
Ha a FreeBSD Projekt egy vállalat lenne, akkor a _FreeBSD Core Teamje_ (irányító csoportja) foglalná magában a vezetõséget. Ennek a csoportnak elsõdleges feladata, hogy fenntartsa a Projekt egészének kondícióját és gondoskodjon róla, hogy a megfelelõ irányba haladjon. Az irányító csoportnak ugyanígy feladata a megbízható és odaadó committerek tömörítése és az új tagok beszervezése, ha a csoportból kilépne valaki. A jelenlegi Core Team tagjait 2008 júliusában választották meg. A választásokat kétévente tartják.
+
-Ebben a csoportban egyes tagoknak ezenfelül még bizonyos területekre felügyelniük is kell. Ez azt jelenti, hogy felelõsek a rendszer valamelyik nagyobb részének az elõírásoknak megfelelõ mûködéséért. A FreeBSD fejlesztõk teljes felsorolása és a hozzájuk tartozó területek megtalálhatóak link:{contributors}[A résztvevõk listjában].
+Ebben a csoportban egyes tagoknak ezenfelül még bizonyos területekre felügyelniük is kell. Ez azt jelenti, hogy felelõsek a rendszer valamelyik nagyobb részének az elõírásoknak megfelelõ mûködéséért. A FreeBSD fejlesztõk teljes felsorolása és a hozzájuk tartozó területek megtalálhatóak extref:{contributors}[A résztvevõk listjában].
+
[NOTE]
====
@@ -199,7 +209,7 @@ A Core Team legtöbb tagja pusztán önkéntesen vesz részt a FreeBSD fejleszt
Külsõ résztvevõk::
Végül, de nem utoljára, következzen a fejlesztõk legnagyobb csoportja: õk maguk a felhasználók, akik rendszeres visszajelzéseket és hibajavításokat küldenek. A FreeBSD kevésbé központosított fejlesztésében elsõsorban a {freebsd-hackers} segítségével lehet felvenni a fonalat, ahol ezeket a témákat tárgyalják meg. A FreeBSD-hez kapcsolódó különféle levelezési listákról többet a crossref:eresources[eresources,Források az interneten]ben olvashatunk.
+
-link:{contributors}[A FreeBSD résztvevõinek listája] hosszú és még most is növekszik; miért nem próbálunk mi is visszaadni valamit a FreeBSD-nek?
+extref:{contributors}[A FreeBSD résztvevõinek listája] hosszú és még most is növekszik; miért nem próbálunk mi is visszaadni valamit a FreeBSD-nek?
+
Nem csak programozással lehet segíteni a Projektet: a megoldandó feladatok listáját megtalálhatjuk a link:https://www.FreeBSD.org/[FreeBSD Projekt honlapján].
diff --git a/documentation/content/hu/books/handbook/jails/_index.adoc b/documentation/content/hu/books/handbook/jails/_index.adoc
index cbe49c9e5c..e925fbdc70 100644
--- a/documentation/content/hu/books/handbook/jails/_index.adoc
+++ b/documentation/content/hu/books/handbook/jails/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mac
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/jails/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
-endif::[]
+:images-path: books/handbook/jails/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[jails-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/kernelconfig/_index.adoc b/documentation/content/hu/books/handbook/kernelconfig/_index.adoc
index 655b57957d..d31de6ea52 100644
--- a/documentation/content/hu/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/hu/books/handbook/kernelconfig/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/printing
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kernelconfig-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/l10n/_index.adoc b/documentation/content/hu/books/handbook/l10n/_index.adoc
index fc682a16a0..acf2265a85 100644
--- a/documentation/content/hu/books/handbook/l10n/_index.adoc
+++ b/documentation/content/hu/books/handbook/l10n/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/cutting-edge
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/linuxemu/_index.adoc b/documentation/content/hu/books/handbook/linuxemu/_index.adoc
index 664a604103..5140fffe48 100644
--- a/documentation/content/hu/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/hu/books/handbook/linuxemu/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[linuxemu-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/mac/_index.adoc b/documentation/content/hu/books/handbook/mac/_index.adoc
index 3a4c6a7da0..2e8fa44ede 100644
--- a/documentation/content/hu/books/handbook/mac/_index.adoc
+++ b/documentation/content/hu/books/handbook/mac/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/audit
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/mail/_index.adoc b/documentation/content/hu/books/handbook/mail/_index.adoc
index c23e6ba09c..bb2ffe7d5d 100644
--- a/documentation/content/hu/books/handbook/mail/_index.adoc
+++ b/documentation/content/hu/books/handbook/mail/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/network-servers
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 28
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 28
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mail-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/mirrors/_index.adoc b/documentation/content/hu/books/handbook/mirrors/_index.adoc
index 08d8bf94df..cbb50ce6fb 100644
--- a/documentation/content/hu/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/hu/books/handbook/mirrors/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/bibliography
[[mirrors]]
= A FreeBSD beszerzése
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mirrors-cdrom]]
== CD és DVD kiadók
@@ -1009,7 +1022,7 @@ Ha nem akarjuk a `ports-all` egészét (vagyis a teljes portfát) frissíteni, c
+
[IMPORTANT]
====
-Ha a [.filename]#ports/INDEX# állomány egy saját példányát kívánjuk létrehozni, akkor ahhoz a `ports-all` gyûjteményt (tehát a teljes portfát) le _kell_ kérnünk. A [.filename]#ports/INDEX# állományt a portfa egy része alapján nem készíthetjük el. Errõl bõvebben lásd a link:{faq}#MAKE-INDEX[ GYIK]-ot.
+Ha a [.filename]#ports/INDEX# állomány egy saját példányát kívánjuk létrehozni, akkor ahhoz a `ports-all` gyûjteményt (tehát a teljes portfát) le _kell_ kérnünk. A [.filename]#ports/INDEX# állományt a portfa egy része alapján nem készíthetjük el. Errõl bõvebben lásd a extref:{faq}[GYIK, MAKE-INDEX]-ot.
====
`ports-accessibility release=cvs`::::
@@ -1432,7 +1445,7 @@ A FreeBSD-2.2.X fejlesztési ága, más néven a 2.2-STABLE. Ez az ág manapság
=== A kiadások címkéi
-Ezek a címkék a FreeBSD egyes kiadásainak dátumára hivatkoznak. Egy kiadás elõkészítésének és terjesztésének folyamatáról részleteiben a link:https://www.FreeBSD.org/releng/[kiadásokat összefoglaló lapról] és a link:{releng}#release-proc/[ kiadások építésérõl szóló cikkbõl] tájékozódhatunk. Az [.filename]#src# fában `RELENG_` kezdetû címkéket találunk. A [.filename]#ports# és [.filename]#doc# fákban a címkék nevei a `RELEASE` elõtaggal kezdõdnek. Végezetül a [.filename]#www# fában nincsenek kiadásokhoz tartozó címkék.
+Ezek a címkék a FreeBSD egyes kiadásainak dátumára hivatkoznak. Egy kiadás elõkészítésének és terjesztésének folyamatáról részleteiben a link:https://www.FreeBSD.org/releng/[kiadásokat összefoglaló lapról] és a extref:{releng}[kiadások építésérõl szóló cikkbõl, release-proc] tájékozódhatunk. Az [.filename]#src# fában `RELENG_` kezdetû címkéket találunk. A [.filename]#ports# és [.filename]#doc# fákban a címkék nevei a `RELEASE` elõtaggal kezdõdnek. Végezetül a [.filename]#www# fában nincsenek kiadásokhoz tartozó címkék.
RELENG_8_1_0_RELEASE::
FreeBSD 8.1
diff --git a/documentation/content/hu/books/handbook/multimedia/_index.adoc b/documentation/content/hu/books/handbook/multimedia/_index.adoc
index a677aab248..e23e500620 100644
--- a/documentation/content/hu/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/hu/books/handbook/multimedia/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/kernelconfig
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[multimedia-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/network-servers/_index.adoc b/documentation/content/hu/books/handbook/network-servers/_index.adoc
index 570a0a3928..8d80480643 100644
--- a/documentation/content/hu/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/hu/books/handbook/network-servers/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/firewalls
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 29
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 29
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[network-servers-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/parti.adoc b/documentation/content/hu/books/handbook/parti.adoc
index 1ab9369501..73b3b686ca 100644
--- a/documentation/content/hu/books/handbook/parti.adoc
+++ b/documentation/content/hu/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
next: books/handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[getting-started]]
= Bevezetés
@@ -17,4 +25,4 @@ A FreeBSD kézikönyv ezen része azoknak a felhasználóknak és rendszergazdá
A fejezetek megírása során arra törekedtünk, hogy minél kevesebb hivatkozást tegyünk a könyv késõbb következõ részeire, így ennek köszönhetõen a kézikönyv ezen része anélkül olvasható, hogy közben folyamatosan elõre-hátra kellene lapozgatnunk benne.
-include::content/hu/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/hu/books/handbook/partii.adoc b/documentation/content/hu/books/handbook/partii.adoc
index 0aea6580c0..cf07f577c0 100644
--- a/documentation/content/hu/books/handbook/partii.adoc
+++ b/documentation/content/hu/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
next: books/handbook/desktop
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[common-tasks]]
= Gyakori feladatok
@@ -17,4 +25,4 @@ Miután az alapokat már átvettük, a FreeBSD kézikönyv következõ része n
Egyes fejezetek elolvasásához ajánlott bizonyos mértékû felkészülés, amely megemlítésre is kerül az érintett fejezetek áttekintésében.
-include::content/hu/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/hu/books/handbook/partiii.adoc b/documentation/content/hu/books/handbook/partiii.adoc
index 7ef11ae8b3..5b9dcc39a4 100644
--- a/documentation/content/hu/books/handbook/partiii.adoc
+++ b/documentation/content/hu/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
next: books/handbook/config
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[system-administration]]
= Rendszeradminisztráció
@@ -11,4 +19,4 @@ A FreeBSD kézikönyv fennmaradó fejezeteiben a FreeBSD rendszerek adminisztrá
Ezeket a fejezeteket annak érdekében alakítottuk ki, hogy az adott témákban ismereteket adjunk. Nincs köztük semmilyen sorrendi kötöttség, sõt, ezeket egyáltalán nem is szükséges elolvasni a FreeBSD alapvetõ használatához.
-include::content/hu/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/hu/books/handbook/partiv.adoc b/documentation/content/hu/books/handbook/partiv.adoc
index 962a386631..e05cf496bd 100644
--- a/documentation/content/hu/books/handbook/partiv.adoc
+++ b/documentation/content/hu/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/usb-device-mode
next: books/handbook/serialcomms
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[network-communication]]
= Hálózati kommunikáció
@@ -18,4 +26,4 @@ A FreeBSD az egyik legelterjedtebb operációs rendszer a legnagyobb hálózati
Ezek a fejezetek nem állnak egymással szoros kapcsolatban, csupán egy adott témáról adnak ismereteket. Ennélfogva nem kötelezõ ezeket sorrendben elolvasni, valamint egyáltalán nem is kell mindegyikõjüket átolvasni ahhoz, hogy a FreeBSD-t hálózati környezetben is használni tudjuk.
-include::content/hu/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/hu/books/handbook/partv.adoc b/documentation/content/hu/books/handbook/partv.adoc
index 1c2dc2e56c..46295aa36d 100644
--- a/documentation/content/hu/books/handbook/partv.adoc
+++ b/documentation/content/hu/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
next: books/handbook/mirrors
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= Függelék
-include::content/hu/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/hu/books/handbook/pgpkeys/_index.adoc b/documentation/content/hu/books/handbook/pgpkeys/_index.adoc
index 95794e5c26..07448118a5 100644
--- a/documentation/content/hu/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/hu/books/handbook/pgpkeys/_index.adoc
@@ -9,30 +9,46 @@ next: books/handbook/freebsd-glossary
[[pgpkeys]]
= PGP-kulcsok
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
-The OpenPGP keys of the `FreeBSD.org` officers are shown here. These keys can be used to verify a signature or send encrypted email to one of the officers. A full list of FreeBSD OpenPGP keys is available in the link:{pgpkeys}[PGP Keys] article. The complete keyring can be downloaded at link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
+The OpenPGP keys of the `FreeBSD.org` officers are shown here. These keys can be used to verify a signature or send encrypted email to one of the officers. A full list of FreeBSD OpenPGP keys is available in the extref:{pgpkeys}[PGP Keys] article. The complete keyring can be downloaded at link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
[[pgpkeys-officers]]
== Tisztségviselők
diff --git a/documentation/content/hu/books/handbook/ports/_index.adoc b/documentation/content/hu/books/handbook/ports/_index.adoc
index 6075aa1b60..234b858af0 100644
--- a/documentation/content/hu/books/handbook/ports/_index.adoc
+++ b/documentation/content/hu/books/handbook/ports/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/x11
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ports-synopsis]]
== Áttekintés
@@ -416,7 +414,7 @@ Ez a könyvtár tartalmazhat további állományokat is portok elkészítéséhe
* Egy [.filename]#pkg-descr# nevû állomány. Ez a program részletesebb, gyakran többsoros bemutatása.
* Egy [.filename]#pkg-plist# nevû állomány. Itt találjuk meg a port által telepítendõ összes állományt. Ez egyben közli a portrendszerrel is, hogy az eltávolítás során mely állományokat kell majd törölnie.
-Egyes portokban szerepelhetnek még egyéb állományok is, mint például a [.filename]#pkg-message#. Ezeket az állományokat a portrendszer különleges helyzetek kezelésére tartogatja. Ha még többet kívánunk megtudni ezekrõl az állományokról, vagy magukról a portokról általánosságban, lapozzuk fel a link:{porters-handbook}[FreeBSD porterek kézikönyv]ét.
+Egyes portokban szerepelhetnek még egyéb állományok is, mint például a [.filename]#pkg-message#. Ezeket az állományokat a portrendszer különleges helyzetek kezelésére tartogatja. Ha még többet kívánunk megtudni ezekrõl az állományokról, vagy magukról a portokról általánosságban, lapozzuk fel a extref:{porters-handbook}[FreeBSD porterek kézikönyv]ét.
A port ugyan tartalmazza a forráskód lefordításához szükséges utasításokat, de konkrétan a forráskódot nem. Ezt egy CD-rõl vagy az internetrõl tudjuk megszerezni. A forráskód általában a szerzõje által kedvelt formában jelenik meg: ez gyakran egy gzip-pel tömörített tar állomány, de lehet tömörítve mással is, vagy éppen lehet tömörítetlen. A program forráskódját, legyen akármilyen formában is, nevezik "distfile"-nak (terjesztési állománynak). A FreeBSD portok telepítésének két módszerét tárjuk fel a következõkben.
@@ -820,11 +818,11 @@ Ha véletlenül ráakadnánk egy olyan portra, ami nem mûködik megfelelõen, n
+
[NOTE]
====
-Némely portokat nem egyedülálló személyek tartanak karban, hanem egy link:{mailing-list-faq}[levelezési lista]. A legtöbbjük neve, ha nem is mindé, nagyjából ilyen alakú: mailto:freebsd-listanév@FreeBSD.org[freebsd-listanév@FreeBSD.org]. Egy ilyen jellegû kérdés megfogalmazása során ezt is vegyük figyelembe!
+Némely portokat nem egyedülálló személyek tartanak karban, hanem egy extref:{mailing-list-faq}[levelezési lista]. A legtöbbjük neve, ha nem is mindé, nagyjából ilyen alakú: mailto:freebsd-listanév@FreeBSD.org[freebsd-listanév@FreeBSD.org]. Egy ilyen jellegû kérdés megfogalmazása során ezt is vegyük figyelembe!
Kifejezetten a mailto:ports@FreeBSD.org[ports@FreeBSD.org] karbantartóval rendelkezõ portoknak nincs rendes gazdája. A hozzájuk kapcsolódó javítások és mindenféle segítség, ötlet errõl a levelezési listáról érkeznek. Ilyen esetekben számítunk az önkéntes segítõkre!
====
+
-Ha nem kapunk semmilyen választ, a hiba bejelentésére használhatjuk a man:send-pr[1] programot is (errõl bõvebben lásd a link:{problem-reports}[FreeBSD-s hibajelentések írása] címû cikket).
-. Javítsuk meg mi magunk! A link:{porters-handbook}[porterek kézikönyve] részletesen taglalja a "portok" belsõ felépítését, így onnan elindulva akár magunktól is meg tudunk javítani egy esetlegesen sérült portot, vagy be is küldhetjük a sajátunkat!
+Ha nem kapunk semmilyen választ, a hiba bejelentésére használhatjuk a man:send-pr[1] programot is (errõl bõvebben lásd a extref:{problem-reports}[FreeBSD-s hibajelentések írása] címû cikket).
+. Javítsuk meg mi magunk! A extref:{porters-handbook}[porterek kézikönyve] részletesen taglalja a "portok" belsõ felépítését, így onnan elindulva akár magunktól is meg tudunk javítani egy esetlegesen sérült portot, vagy be is küldhetjük a sajátunkat!
. Töltsük le a porthoz tartozó csomagot a hozzánk legközelebb levõ FTP oldalról. A "központi" csomaggyûjtemény az `ftp.FreeBSD.org` címen, a link:ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/[packages nevû könyvtárban] található, de mielõtt ide fordulnánk, nézzük meg a hozzánk http://mirrorlist.FreeBSD.org/[legközelebb levõ tükörszervert] is! Ha egy csomagot így telepítünk, akkor több eséllyel fog mûködni és ráadásul még jóval gyorsabb is. A csomag telepítésére használjuk a man:pkg_add[1] programot.
diff --git a/documentation/content/hu/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/hu/books/handbook/ppp-and-slip/_index.adoc
index 390704a2ba..b5bd18b8c3 100644
--- a/documentation/content/hu/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/hu/books/handbook/ppp-and-slip/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mail
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ppp-and-slip-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/preface/_index.adoc b/documentation/content/hu/books/handbook/preface/_index.adoc
index b5fef27efe..a552c3316a 100644
--- a/documentation/content/hu/books/handbook/preface/_index.adoc
+++ b/documentation/content/hu/books/handbook/preface/_index.adoc
@@ -11,17 +11,33 @@ next: books/handbook/parti
:toc: macro
:toclevels: 1
:icons: font
-:sectnums!:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-audience]]
== Kiknek szánjuk ezt a könyvet
diff --git a/documentation/content/hu/books/handbook/printing/_index.adoc b/documentation/content/hu/books/handbook/printing/_index.adoc
index bee6729a3c..e5f5df3bf4 100644
--- a/documentation/content/hu/books/handbook/printing/_index.adoc
+++ b/documentation/content/hu/books/handbook/printing/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/linuxemu
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/printing/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[printing-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/security/_index.adoc b/documentation/content/hu/books/handbook/security/_index.adoc
index 465a482c4e..29eb478e08 100644
--- a/documentation/content/hu/books/handbook/security/_index.adoc
+++ b/documentation/content/hu/books/handbook/security/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/jails
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/serialcomms/_index.adoc b/documentation/content/hu/books/handbook/serialcomms/_index.adoc
index cb68044a69..c2a6e8f544 100644
--- a/documentation/content/hu/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/hu/books/handbook/serialcomms/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ppp-and-slip
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[serial-synopsis]]
== Áttekintés
@@ -1143,7 +1141,7 @@ A konzolos mûködési mód engedélyezése az adott egységhez. Ha megadjuk ezt
Az egység konzollá nyilvánítása (hacsak nincs egy tõle nagyobb prioritású konzol), függetlenül a lentebb ismertetendõ `-h` opciótól. A `0x20` értéket a `0x10` értékkel együtt kell megadni.
`0x40`:::
-(A `0x10` értékkel együtt) az egységet kivonja a normális elérés alól. Ezt a beállítást ne használjuk, ha soros vonali konzolt akarunk üzemeltetni az adott porton. Ezzel az egységet csak a rendszermag távoli nyomkövetéséhez tudjuk használni. A távoli nyomkövetésrõl a link:{developers-handbook}[fejlesztõk kézikönyvében] olvastunk bõvebben.
+(A `0x10` értékkel együtt) az egységet kivonja a normális elérés alól. Ezt a beállítást ne használjuk, ha soros vonali konzolt akarunk üzemeltetni az adott porton. Ezzel az egységet csak a rendszermag távoli nyomkövetéséhez tudjuk használni. A távoli nyomkövetésrõl a extref:{developers-handbook}[fejlesztõk kézikönyvében] olvastunk bõvebben.
+
Példa:
+
diff --git a/documentation/content/hu/books/handbook/users/_index.adoc b/documentation/content/hu/books/handbook/users/_index.adoc
index 7456c3c4f0..78b9c0ff70 100644
--- a/documentation/content/hu/books/handbook/users/_index.adoc
+++ b/documentation/content/hu/books/handbook/users/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/security
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/users/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/users/
-endif::[]
+:images-path: books/handbook/users/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/users/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[users-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/vinum/_index.adoc b/documentation/content/hu/books/handbook/vinum/_index.adoc
index 6b0ae3f24a..d48a3a939f 100644
--- a/documentation/content/hu/books/handbook/vinum/_index.adoc
+++ b/documentation/content/hu/books/handbook/vinum/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/virtualization
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/vinum/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/vinum/
-endif::[]
+:images-path: books/handbook/vinum/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/vinum/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[vinum-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/virtualization/_index.adoc b/documentation/content/hu/books/handbook/virtualization/_index.adoc
index 2198ba15ec..a2206aa397 100644
--- a/documentation/content/hu/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/hu/books/handbook/virtualization/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/l10n
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/virtualization/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
-endif::[]
+:images-path: books/handbook/virtualization/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[virtualization-synopsis]]
== Áttekintés
diff --git a/documentation/content/hu/books/handbook/x11/_index.adoc b/documentation/content/hu/books/handbook/x11/_index.adoc
index db3a545b5e..b824a5e39f 100644
--- a/documentation/content/hu/books/handbook/x11/_index.adoc
+++ b/documentation/content/hu/books/handbook/x11/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Tartalom
-:table-caption: Táblázat
-:figure-caption: Ábra
-:example-caption: Példa
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/hu/mailing-lists.adoc[]
-include::shared/hu/teams.adoc[]
-include::shared/hu/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[x11-synopsis]]
== Áttekintés
diff --git a/documentation/content/it/articles/bsdl-gpl/_index.adoc b/documentation/content/it/articles/bsdl-gpl/_index.adoc
index 2a24086d01..33d70ef2f5 100644
--- a/documentation/content/it/articles/bsdl-gpl/_index.adoc
+++ b/documentation/content/it/articles/bsdl-gpl/_index.adoc
@@ -3,7 +3,6 @@ title: Perché dovresti usare una licenza in stile BSD per il tuo progetto Open
authors:
- author: Bruce Montague
email: brucem@alumni.cse.ucsc.edu
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "intel", "general"]
---
@@ -16,13 +15,27 @@ trademarks: ["freebsd", "intel", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Indice
-:part-signifier: Parte
-:chapter-signifier: Capitolo
-:appendix-caption: Appendice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
+:images-path: articles/bsdl-gpl/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
'''
diff --git a/documentation/content/it/books/handbook/_index.adoc b/documentation/content/it/books/handbook/_index.adoc
index 94fb80e27c..b9ef2beeca 100644
--- a/documentation/content/it/books/handbook/_index.adoc
+++ b/documentation/content/it/books/handbook/_index.adoc
@@ -3,9 +3,9 @@ title: Manuale di FreeBSD
authors:
- author: The FreeBSD Italian Documentation Project
copyright: 1995-2020 The FreeBSD Italian Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "3com", "3ware", "arm", "adaptec", "adobe", "apple", "corel", "creative", "cvsup", "heidelberger", "ibm", "ieee", "intel", "intuit", "linux", "lsilogic", "m-systems", "macromedia", "microsoft", "netscape", "nexthop", "opengroup", "oracle", "powerquest", "realnetworks", "redhat", "sap", "sun", "symantec", "themathworks", "thomson", "usrobotics", "vmware", "waterloomaple", "wolframresearch", "xfree86", "xiph", "general"]
next: books/handbook/preface
+isIndex: true
---
= Manuale di FreeBSD
@@ -15,18 +15,32 @@ next: books/handbook/preface
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:toc-title: Indice
-:part-signifier: Parte
-:chapter-signifier: Capitolo
-:appendix-caption: Appendice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
+:images-path: books/handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Sommario
@@ -35,10 +49,10 @@ Benvenuto in FreeBSD! Questo manuale copre l'installazione e l'uso giorno per gi
'''
-include::content/it/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
-include::content/it/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
-include::content/it/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
-include::content/it/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/it/books/handbook/advanced-networking/_index.adoc b/documentation/content/it/books/handbook/advanced-networking/_index.adoc
index 9a2a2c501d..997d08f64f 100644
--- a/documentation/content/it/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/it/books/handbook/advanced-networking/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/partv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 29
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 29
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[advanced-networking-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/audit/_index.adoc b/documentation/content/it/books/handbook/audit/_index.adoc
index d6ba3013dd..0787608b67 100644
--- a/documentation/content/it/books/handbook/audit/_index.adoc
+++ b/documentation/content/it/books/handbook/audit/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/disks
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[audit-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/basics/_index.adoc b/documentation/content/it/books/handbook/basics/_index.adoc
index 03c0cca504..475696bca1 100644
--- a/documentation/content/it/books/handbook/basics/_index.adoc
+++ b/documentation/content/it/books/handbook/basics/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/ports
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[basics-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/bibliography/_index.adoc b/documentation/content/it/books/handbook/bibliography/_index.adoc
index a9f5f19f89..d77715ec20 100644
--- a/documentation/content/it/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/it/books/handbook/bibliography/_index.adoc
@@ -9,25 +9,40 @@ next: books/handbook/eresources
[[bibliography]]
= Bibliografia
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Sebbene le pagine man forniscano la documentazione di riferimento definitiva per le singole parti del sistema operativo FreeBSD, sono famose per non illustrare come mettere insieme i pezzi per far andare uniformemente l'intero sistema operativo. Per questo, non esiste sostituto a un buon libro sull'amministrazione di un sistema UNIX(R) e a un buon manuale per gli utenti.
@@ -119,7 +134,7 @@ Una https://www.FreeBSD.org/doc/it/books/unix-introduction/book.html[traduzione]
* Leffler, Samuel J., Marshall Kirk McKusick, _The Design and Implementation of the 4.3BSD UNIX Operating System: Answer Book_. Reading, Mass. : Addison-Wesley, 1991. ISBN 0-201-54629-9
* McKusick, Marshall Kirk, Keith Bostic, Michael J Karels, e John Quarterman. _The Design and Implementation of the 4.4BSD Operating System_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-54979-4
+
-(Il capitolo 2 di questo libro è disponibile link:{design-44bsd}[online] come parte del FreeBSD Documentation Project, mentre il capitolo 9 è consultabile http://www.netapp.com/tech_library/nfsbook.html[qui].)
+(Il capitolo 2 di questo libro è disponibile extref:{design-44bsd}[online] come parte del FreeBSD Documentation Project, mentre il capitolo 9 è consultabile http://www.netapp.com/tech_library/nfsbook.html[qui].)
* Marshall Kirk McKusick, George V. Neville-Neil _The Design and Implementation of the FreeBSD Operating System_. Boston, Mass. : Addison-Wesley, 2004. ISBN 0-201-70245-2
* Stevens, W. Richard. _TCP/IP Illustrated, Volume 1: The Protocols_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-63346-9
* Schimmel, Curt. _Unix Systems for Modern Architectures_. Reading, Mass. : Addison-Wesley, 1994. ISBN 0-201-63338-8
diff --git a/documentation/content/it/books/handbook/book.adoc b/documentation/content/it/books/handbook/book.adoc
index aa8852b1bd..7094201940 100644
--- a/documentation/content/it/books/handbook/book.adoc
+++ b/documentation/content/it/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: Manuale di FreeBSD
authors:
- author: The FreeBSD Italian Documentation Project
copyright: 1995-2020 The FreeBSD Italian Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "3com", "3ware", "arm", "adaptec", "adobe", "apple", "corel", "creative", "cvsup", "heidelberger", "ibm", "ieee", "intel", "intuit", "linux", "lsilogic", "m-systems", "macromedia", "microsoft", "netscape", "nexthop", "opengroup", "oracle", "powerquest", "realnetworks", "redhat", "sap", "sun", "symantec", "themathworks", "thomson", "usrobotics", "vmware", "waterloomaple", "wolframresearch", "xfree86", "xiph", "general"]
---
@@ -12,54 +11,35 @@ trademarks: ["freebsd", "3com", "3ware", "arm", "adaptec", "adobe", "apple", "co
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:part-signifier: Parte
-:chapter-signifier: Capitolo
-:appendix-caption: Appendice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
:book: true
:pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
-include::shared/it/teams.adoc[]
-:chapters-path: content/it/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/it/mailing-lists.adoc[]
-include::../../../../shared/it/urls.adoc[]
-include::../../../../shared/it/teams.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/it/mailing-lists.adoc[]
-include::../../../../shared/it/urls.adoc[]
-include::../../../../shared/it/teams.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -74,91 +54,91 @@ toc::[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..23;30..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
// Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
-include::{chapters-path}install/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}install/_index.adoc[leveloffset=+1]
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
-include::{chapters-path}users/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}users/_index.adoc[leveloffset=+1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}jails/_index.adoc[leveloffset=+1]
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
-include::{chapters-path}vinum/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}vinum/_index.adoc[leveloffset=+1]
-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=7..19]
+include::{chapters-path}partiv.adoc[lines=15..27]
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..38;47..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
// Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
:sectnums!:
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..25;32..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/it/books/handbook/boot/_index.adoc b/documentation/content/it/books/handbook/boot/_index.adoc
index fc7ee7af34..3a5db2f253 100644
--- a/documentation/content/it/books/handbook/boot/_index.adoc
+++ b/documentation/content/it/books/handbook/boot/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/users
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/config/_index.adoc b/documentation/content/it/books/handbook/config/_index.adoc
index 51567c2e95..45b17a28bb 100644
--- a/documentation/content/it/books/handbook/config/_index.adoc
+++ b/documentation/content/it/books/handbook/config/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/boot
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/config/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/config/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/config/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[config-synopsis]]
== Sinossi
@@ -300,7 +299,7 @@ Questa è l'impostazione di base per ogni file [.filename]#crontab#, anche se c'
[IMPORTANT]
====
-Non devi usare la procedura descritta qui per editare/installare il crontab di sistema. Semplicemente usa il tuo editor favorito: l'utility `cron` noterà che il file è cambiato e immediatamente inizierà ad usare la versione aggiornata. Vedi link:{faq}#ROOT-NOT-FOUND-CRON-ERRORS[queste FAQ] per maggiori informazioni.
+Non devi usare la procedura descritta qui per editare/installare il crontab di sistema. Semplicemente usa il tuo editor favorito: l'utility `cron` noterà che il file è cambiato e immediatamente inizierà ad usare la versione aggiornata. Vedi extref:{faq}[queste FAQ, ROOT-NOT-FOUND-CRON-ERRORS] per maggiori informazioni.
====
Per installare un [.filename]#crontab# appena scritto, prima usa il tuo editor preferito per creare un file nel formato corretto, e poi usa l'utility `crontab`. L'uso più corretto è:
@@ -385,7 +384,7 @@ Molti servizi di sistema dipendono da altri servizi per poter funzionare in mani
Usando questo metodo, un amministratore può controllare facilmente i servizi di sistema senza il fastidio dei "runlevel" come alcuni altri sistemi operativi UNIX(R).
-Informazioni addizionali sul sistema [.filename]#rc.d# possono essere trovate nelle pagine man di man:rc[8] e man:rc.subr[8]. Se sei interessato a scrivere un tuo script [.filename]#rc.d# o a migliorarne uno esisente, ti può essere utile link:{rc-scripting}[questo articolo].
+Informazioni addizionali sul sistema [.filename]#rc.d# possono essere trovate nelle pagine man di man:rc[8] e man:rc.subr[8]. Se sei interessato a scrivere un tuo script [.filename]#rc.d# o a migliorarne uno esisente, ti può essere utile extref:{rc-scripting}[questo articolo].
[[config-network-setup]]
== Configurazione delle Interfacce di Rete
diff --git a/documentation/content/it/books/handbook/cutting-edge/_index.adoc b/documentation/content/it/books/handbook/cutting-edge/_index.adoc
index 851d6a8e2c..048638639b 100644
--- a/documentation/content/it/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/it/books/handbook/cutting-edge/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/partiv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
== Sinossi
diff --git a/documentation/content/it/books/handbook/desktop/_index.adoc b/documentation/content/it/books/handbook/desktop/_index.adoc
index c377ca70e7..b18a543c40 100644
--- a/documentation/content/it/books/handbook/desktop/_index.adoc
+++ b/documentation/content/it/books/handbook/desktop/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/multimedia
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[desktop-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/disks/_index.adoc b/documentation/content/it/books/handbook/disks/_index.adoc
index 1cfa6e1a92..7fde5d4326 100644
--- a/documentation/content/it/books/handbook/disks/_index.adoc
+++ b/documentation/content/it/books/handbook/disks/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/geom
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[disks-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/eresources/_index.adoc b/documentation/content/it/books/handbook/eresources/_index.adoc
index f35a96956d..71867ae7b2 100644
--- a/documentation/content/it/books/handbook/eresources/_index.adoc
+++ b/documentation/content/it/books/handbook/eresources/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/pgpkeys
[[eresources]]
= Risorse su Internet
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Il rapido sviluppo di FreeBSD rende la carta stampata un mezzo non pratico per poterne seguire l'evoluzione. Le risorse in rete sono il migliore, se non l'unico, modo per tenersi informati sulle novità di questo sistema. Dal momento che FreeBSD è il prodotto del lavoro di volontari, la comunità degli utenti generalmente si presta anche ad una funzione di "supporto tecnico" di varia natura, con l'email e le news USENET come il mezzo più efficace per entrare in contatto con queste comunità.
@@ -46,9 +60,9 @@ Gli argomenti delle varie liste sono elencati all'inizio del documento. _Si preg
_Se vuoi verificare la tua abilità nel spedire alle liste di FreeBSD, manda un messaggio testuale a {freebsd-test}._ Per favore non mandare messaggi di prova a altre liste.
====
-Se hai alcuni dubbi su quale lista postare una questione, leggi link:{freebsd-questions-article}[Come ottenere i migliori risultati dalla mailing list FreeBSD-questions].
+Se hai alcuni dubbi su quale lista postare una questione, leggi extref:{freebsd-questions-article}[Come ottenere i migliori risultati dalla mailing list FreeBSD-questions].
-Prima di postare su qualsiasi lista, per favore impara a come usare al meglio le mailing list, ad esempio come evitare discussioni che vengono richieste di frequente, leggendo il documento (FAQ) link:{mailing-list-faq}[Le Questioni Maggiormente Richieste sulle Mailing List].
+Prima di postare su qualsiasi lista, per favore impara a come usare al meglio le mailing list, ad esempio come evitare discussioni che vengono richieste di frequente, leggendo il documento (FAQ) extref:{mailing-list-faq}[Le Questioni Maggiormente Richieste sulle Mailing List].
Vengono tenuti archivi per tutte le mailing list, e questi possono essere esplorati usando il link:https://www.FreeBSD.org/search/[FreeBSD World Wide Web server]. L'archivio esplorabile per parole chiave costituisce un mezzo eccellente per trovare risposte a domande poste di frequente e dovrebbe essere consultato prima di spedire una domanda.
diff --git a/documentation/content/it/books/handbook/firewalls/_index.adoc b/documentation/content/it/books/handbook/firewalls/_index.adoc
index 94dab5d6b1..0ff5c1f8b1 100644
--- a/documentation/content/it/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/it/books/handbook/firewalls/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/advanced-networking
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 28
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 28
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/fr/mailing-lists.adoc[]
-include::shared/fr/teams.adoc[]
-include::shared/fr/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[firewalls-intro]]
== Introduzione
diff --git a/documentation/content/it/books/handbook/geom/_index.adoc b/documentation/content/it/books/handbook/geom/_index.adoc
index 97eb99ae01..070b024413 100644
--- a/documentation/content/it/books/handbook/geom/_index.adoc
+++ b/documentation/content/it/books/handbook/geom/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/vinum
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[GEOM-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/install/_index.adoc b/documentation/content/it/books/handbook/install/_index.adoc
index 9b4ee7e303..a4ae23bbcf 100644
--- a/documentation/content/it/books/handbook/install/_index.adoc
+++ b/documentation/content/it/books/handbook/install/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/basics
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/install/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/install/
-endif::[]
+:images-path: books/handbook/install/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/install/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[install-synopsis]]
== Sinossi
@@ -2798,7 +2797,7 @@ Se lo fai su un'altra piattaforma allora devi usare qualche utility per controll
[NOTE]
====
-Se sei interessato a costruirti una release di FreeBSD personalizzata, guarda l'link:{releng}[Articolo di Progettazione delle Release].
+Se sei interessato a costruirti una release di FreeBSD personalizzata, guarda l'extref:{releng}[Articolo di Progettazione delle Release].
====
[[install-ftp]]
@@ -2909,7 +2908,7 @@ Il supporto SLIP è piuttosto vecchio, e limitato principalmente a link connessi
Se userai un modem, allora PPP è quasi certamente la tua unica scelta. Assicurati di avere le informazioni del tuo provider a portata di mano che ti saranno richieste nel processo di installazione.
-Se usi PAP o CHAP per la connessione al tuo ISP (in altre parole, se puoi connetterti all'ISP in Windows(R) senza usare uno script), allora tutto quello che dovrai fare è digitare `dial` nel prompt di ppp. Altrimenti, avrai bisogno di sapere come chiamare il tuo ISP usando "comandi AT" specifici del tuo modem, poichè PPP fornisce solo un semplice emulatore di terminale. Per cortesia fai riferimento al crossref:ppp-and-slip[userppp,manuale] per il ppp-utente e alle link:{faq}#ppp/[FAQ]. Se hai problemi, puoi mandare i log a video usando il comando `set log local ...`.
+Se usi PAP o CHAP per la connessione al tuo ISP (in altre parole, se puoi connetterti all'ISP in Windows(R) senza usare uno script), allora tutto quello che dovrai fare è digitare `dial` nel prompt di ppp. Altrimenti, avrai bisogno di sapere come chiamare il tuo ISP usando "comandi AT" specifici del tuo modem, poichè PPP fornisce solo un semplice emulatore di terminale. Per cortesia fai riferimento al crossref:ppp-and-slip[userppp,manuale] per il ppp-utente e alle extref:{faq}[FAQ, ppp]. Se hai problemi, puoi mandare i log a video usando il comando `set log local ...`.
Se è disponibile una connessione fisica ad un altro FreeBSD (2.0-R o successivi), potresti considerare l'installazione via cavo parallelo "laplink". La velocità di trasferimento di dati via porta parallela è molto più alta rispetto a quella realizzabile via seriale (fino a 50 kbyte/sec), ottenendo quindi un'installazione rapida.
diff --git a/documentation/content/it/books/handbook/introduction/_index.adoc b/documentation/content/it/books/handbook/introduction/_index.adoc
index 40bc40990f..ef42b385ce 100644
--- a/documentation/content/it/books/handbook/introduction/_index.adoc
+++ b/documentation/content/it/books/handbook/introduction/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/install
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/introduction/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/introduction/
-endif::[]
+:images-path: books/handbook/introduction/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/introduction/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-synopsis]]
== Sinossi
@@ -60,7 +59,7 @@ Dopo aver letto questo capitolo, saprai:
[[nutshell]]
== Benvenuto in FreeBSD!
-FreeBSD è un sistema operativo basato su 4.4BSD-Lite per computer Intel (x86 e Itanium(R)), DEC Alpha(TM), e Sun UltraSPARC(R). Port verso altre architetture sono stati avviati. Puoi anche leggere <<history,la storia di FreeBSD>>, o la <<relnotes,release corrente>>. Se sei interessato a contribuire in qualche modo al progetto (codice, hardware, fondi), leggi l'articolo link:{contributing}[Contribuire a FreeBSD].
+FreeBSD è un sistema operativo basato su 4.4BSD-Lite per computer Intel (x86 e Itanium(R)), DEC Alpha(TM), e Sun UltraSPARC(R). Port verso altre architetture sono stati avviati. Puoi anche leggere <<history,la storia di FreeBSD>>, o la <<relnotes,release corrente>>. Se sei interessato a contribuire in qualche modo al progetto (codice, hardware, fondi), leggi l'articolo extref:{contributing}[Contribuire a FreeBSD].
[[os-overview]]
=== Cosa può fare FreeBSD?
@@ -174,7 +173,7 @@ Quel codice nel nostro albero dei sorgenti che cade sotto la GNU General Public
[[development]]
=== Il Modello di Sviluppo di FreeBSD
-Lo sviluppo di FreeBSD è un processo molto aperto e flessibile, essendo costruito dal contributo di centinaia di persone di tutto il mondo, come puoi vedere dalla nostra link:{contributors}[lista dei collaboratori]. L'infrastruttura di sviluppo di FreeBSD permette a queste centinaia di sviluppatori di collaborare su Internet. Siamo costantemente alla ricerca di nuovi sviluppatori e idee, e quelli interessati a essere coinvolti maggiormente nel progetto devono semplicemente contattarci sulla {freebsd-hackers}. La {freebsd-announce} è anche disponibile a quelli che vogliono informare altri utenti FreeBSD delle principali aree di lavoro.
+Lo sviluppo di FreeBSD è un processo molto aperto e flessibile, essendo costruito dal contributo di centinaia di persone di tutto il mondo, come puoi vedere dalla nostra extref:{contributors}[lista dei collaboratori]. L'infrastruttura di sviluppo di FreeBSD permette a queste centinaia di sviluppatori di collaborare su Internet. Siamo costantemente alla ricerca di nuovi sviluppatori e idee, e quelli interessati a essere coinvolti maggiormente nel progetto devono semplicemente contattarci sulla {freebsd-hackers}. La {freebsd-announce} è anche disponibile a quelli che vogliono informare altri utenti FreeBSD delle principali aree di lavoro.
Cose utili da sapere sul FreeBSD Project e il suo processo di sviluppo, sia lavorando in modo indipendente che in stretta cooperazione:
@@ -187,7 +186,7 @@ I _committer_ sono persone che hanno permesso di _scrivere_ nell'albero CVS, e s
Il core team di FreeBSD[[development-core]]::
Il _core team di FreeBSD_ dovrebbe essere equivalente al consiglio dirigente se il FreeBSD Project fosse una azienda. Il compito principale del core team è assicurarsi che il progetto, nella sua interezza, sia in buona salute e sia diretto nella giusta direzione. Una delle funzioni del core team è invitare sviluppatori responsabili e dedicati a unirsi al nostro gruppo di committer come altri ne escono. L'attuale core team è stato eletto da un insieme di candidati committer nel giugno 2006. Le elezioni vengono tenute ogni 2 anni.
+
-Alcuni membri del core team hanno anche aree specifiche di responsabilità, significando che sono impegnati ad assicurare che grandi porzioni del sistema funzionino come annunciato. Per una lista completa degli sviluppatori di FreeBSD e le loro aree di responsabilità, guarda la link:{contributors}[Contributors List]
+Alcuni membri del core team hanno anche aree specifiche di responsabilità, significando che sono impegnati ad assicurare che grandi porzioni del sistema funzionino come annunciato. Per una lista completa degli sviluppatori di FreeBSD e le loro aree di responsabilità, guarda la extref:{contributors}[Contributors List]
+
[NOTE]
====
@@ -197,7 +196,7 @@ Molti membri del core team sono volontari per quanto riguarda lo sviluppo di Fre
Collaboratori esterni::
Non da ultimo, il più grande gruppo di sviluppatori sono gli stessi utenti che ci forniscono feedback e correzioni di bug quasi costantemente. Il modo principale di tenersi in contatto con lo sviluppo non centralizzato di FreeBSD è iscriversi alla {freebsd-hackers} dove queste cose vengono discusse. Guarda il crossref:eresources[eresources,Risorse su Internet] per maggiori informazioni sulle varie mailing list di FreeBSD.
+
-link:{contributors}[La Lista dei Collaboratori di FreeBSD] è lunga e cresce continuamente, quindi perché non entri a far parte di essa contribuendo e dando tu qualcosa a FreeBSD?
+extref:{contributors}[La Lista dei Collaboratori di FreeBSD] è lunga e cresce continuamente, quindi perché non entri a far parte di essa contribuendo e dando tu qualcosa a FreeBSD?
+
Fornire codice non è il solo modo di contribuire al progetto, per una lista completa di cose che serve fare, fai riferimento al link:https://www.FreeBSD.org/it/[sito web del FreeBSD Project].
diff --git a/documentation/content/it/books/handbook/jails/_index.adoc b/documentation/content/it/books/handbook/jails/_index.adoc
index 907d81d112..c11e95da93 100644
--- a/documentation/content/it/books/handbook/jails/_index.adoc
+++ b/documentation/content/it/books/handbook/jails/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/mac
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/jails/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
-endif::[]
+:images-path: books/handbook/jails/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[jails-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/kernelconfig/_index.adoc b/documentation/content/it/books/handbook/kernelconfig/_index.adoc
index 93970edbf2..b5fa36025a 100644
--- a/documentation/content/it/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/it/books/handbook/kernelconfig/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/printing
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kernelconfig-synopsis]]
== Synopsis
diff --git a/documentation/content/it/books/handbook/l10n/_index.adoc b/documentation/content/it/books/handbook/l10n/_index.adoc
index d2004be4c2..0b8660a092 100644
--- a/documentation/content/it/books/handbook/l10n/_index.adoc
+++ b/documentation/content/it/books/handbook/l10n/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/cutting-edge
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-synopsys]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/linuxemu/_index.adoc b/documentation/content/it/books/handbook/linuxemu/_index.adoc
index 70512ba338..d4496d87a8 100644
--- a/documentation/content/it/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/it/books/handbook/linuxemu/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/partiii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[linuxemu-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/mac/_index.adoc b/documentation/content/it/books/handbook/mac/_index.adoc
index 3dfa8e0c1b..ff38c2cd37 100644
--- a/documentation/content/it/books/handbook/mac/_index.adoc
+++ b/documentation/content/it/books/handbook/mac/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/audit
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/mail/_index.adoc b/documentation/content/it/books/handbook/mail/_index.adoc
index bcd1bc41c4..ddf9abdd19 100644
--- a/documentation/content/it/books/handbook/mail/_index.adoc
+++ b/documentation/content/it/books/handbook/mail/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/network-servers
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mail-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/mirrors/_index.adoc b/documentation/content/it/books/handbook/mirrors/_index.adoc
index b1bcc823f1..db73a69eb6 100644
--- a/documentation/content/it/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/it/books/handbook/mirrors/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/bibliography
[[mirrors]]
= Ottenere FreeBSD
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mirrors-cdrom]]
== Editori di CDROM e DVD
@@ -1015,7 +1029,7 @@ Se non vuoi aggiornare per intero `ports-all` (l'interno albero dei port), ma us
+
[IMPORTANT]
====
-Se hai intenzione di creare localmente una copia di [.filename]#ports/INDEX#, _devi_ includere `ports-all` (l'intero albero dei port). Costruire [.filename]#ports/INDEX# con un albero non completo non è supportato. Consulta la link:{faq}#make-index[FAQ].
+Se hai intenzione di creare localmente una copia di [.filename]#ports/INDEX#, _devi_ includere `ports-all` (l'intero albero dei port). Costruire [.filename]#ports/INDEX# con un albero non completo non è supportato. Consulta la extref:{faq}[FAQ, make-index].
====
`ports-accessibility release=cvs`::::
@@ -1496,7 +1510,7 @@ La linea di sviluppo per FreeBSD-2.2.X, anche conosciuta come 2.2-STABLE. Questo
=== Tag di Release
-Questi tag si riferiscono a un preciso istante di tempo quando una versione di FreeBSD è stata rilasciata. Il processo di release engineering è documentato in dettaglio dai documenti link:https://www.FreeBSD.org/releng/[Release Engineering Information] e link:{releng}#release-proc/[Release Process]. L'albero [.filename]#src# usa nomi di tag che iniziano con `RELENG_`. Gli alberi [.filename]#ports# e [.filename]#doc# usano tag il cui nome inizia con `RELEASE`. Infine, l'albero [.filename]#www# non viene taggato con alcun nome particolare per le release.
+Questi tag si riferiscono a un preciso istante di tempo quando una versione di FreeBSD è stata rilasciata. Il processo di release engineering è documentato in dettaglio dai documenti link:https://www.FreeBSD.org/releng/[Release Engineering Information] e extref:{releng}[Release Process, release-proc]. L'albero [.filename]#src# usa nomi di tag che iniziano con `RELENG_`. Gli alberi [.filename]#ports# e [.filename]#doc# usano tag il cui nome inizia con `RELEASE`. Infine, l'albero [.filename]#www# non viene taggato con alcun nome particolare per le release.
RELENG_6_1_0_RELEASE::
FreeBSD 6.1
diff --git a/documentation/content/it/books/handbook/multimedia/_index.adoc b/documentation/content/it/books/handbook/multimedia/_index.adoc
index c6f9b1d2d3..9e237af8b8 100644
--- a/documentation/content/it/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/it/books/handbook/multimedia/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/kernelconfig
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[multimedia-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/network-servers/_index.adoc b/documentation/content/it/books/handbook/network-servers/_index.adoc
index 360073bac1..112bce1ead 100644
--- a/documentation/content/it/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/it/books/handbook/network-servers/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/firewalls
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[network-servers-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/parti.adoc b/documentation/content/it/books/handbook/parti.adoc
index 910b0d477f..5c422d8f61 100644
--- a/documentation/content/it/books/handbook/parti.adoc
+++ b/documentation/content/it/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
next: books/handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[getting-started]]
= Per Cominciare
@@ -17,4 +25,4 @@ Questa parte del Manuale di FreeBSD è per gli utenti e gli amministratori che s
Abbiamo cercato di mantenere il numero di riferimenti in avanti nel testo al minimo così che tu possa leggere questa sezione del Manuale dall'inizio alla fine con il minimo scorrimento di pagine possibile.
-include::content/it/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/it/books/handbook/partii.adoc b/documentation/content/it/books/handbook/partii.adoc
index ec3a26fa28..a44ed782c3 100644
--- a/documentation/content/it/books/handbook/partii.adoc
+++ b/documentation/content/it/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
next: books/handbook/desktop
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[common-tasks]]
= Compiti Ordinari
@@ -17,4 +25,4 @@ Ora che sono stati trattati gli elementi di base, questa parte del Manuale di Fr
Alcuni di questi capitoli raccomandano di leggere prima altri capitoli per una migliore comprensione degli stessi, e questo è segnalato nella sinossi all'inizio di ogni capitolo.
-include::content/it/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/it/books/handbook/partiii.adoc b/documentation/content/it/books/handbook/partiii.adoc
index b0b5bde659..ec05f87633 100644
--- a/documentation/content/it/books/handbook/partiii.adoc
+++ b/documentation/content/it/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
next: books/handbook/config
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[system-administration]]
= Amministrazione del Sistema
@@ -11,4 +19,4 @@ I rimanenti capitoli del Manuale di FreeBSD coprono tutti gli aspetti dell'ammin
Questi capitoli sono studiati per essere letti quando si ha bisogno di un'informazione. Non devi leggerli in un ordine particolare, né devi leggerli tutti prima di poter usare FreeBSD.
-include::content/it/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/it/books/handbook/partiv.adoc b/documentation/content/it/books/handbook/partiv.adoc
index dc266e58e0..5d3a214e5a 100644
--- a/documentation/content/it/books/handbook/partiv.adoc
+++ b/documentation/content/it/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/usb-device-mode
next: books/handbook/serialcomms
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[network-communication]]
= Comunicazione di Rete
@@ -18,4 +26,4 @@ FreeBSD è uno dei maggiori sistemi operativi schierati verso alte performance d
Questi capitoli sono studiati per essere letti quando si ha bisogno di un'informazione. Non devi leggerli in un ordine particolare, né devi leggerli tutti prima di poter usare FreeBSD in rete.
-include::content/it/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/it/books/handbook/partv.adoc b/documentation/content/it/books/handbook/partv.adoc
index eaa167632a..7a6f336f76 100644
--- a/documentation/content/it/books/handbook/partv.adoc
+++ b/documentation/content/it/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
next: books/handbook/mirrors
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= Appendici
-include::content/it/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/it/books/handbook/pgpkeys/_index.adoc b/documentation/content/it/books/handbook/pgpkeys/_index.adoc
index 9bfaf76a71..b0e1d09922 100644
--- a/documentation/content/it/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/it/books/handbook/pgpkeys/_index.adoc
@@ -9,28 +9,44 @@ next: books/handbook/freebsd-glossary
[[pgpkeys]]
= Chiavi PGP
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
-include::shared/it/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Nel caso tu debba verificare una firma o inviare un messaggio cifrato a una delle cariche ufficiali o a uno degli sviluppatori, qui puoi trovare per tua comodità una serie di chiavi. Un portachiavi completo degli utenti `FreeBSD.org` è disponibile per il download da link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
diff --git a/documentation/content/it/books/handbook/ports/_index.adoc b/documentation/content/it/books/handbook/ports/_index.adoc
index 2f6a1daeff..adfa81972f 100644
--- a/documentation/content/it/books/handbook/ports/_index.adoc
+++ b/documentation/content/it/books/handbook/ports/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/x11
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ports-synopsis]]
== Sinossi
@@ -364,7 +363,7 @@ Questa directory può anche contenere altri file utilizzati per la costruzione d
* Un file [.filename]#pkg-descr#. Questo file contiene una descrizione del programma più dettagliata, spesso su più righe di testo.
* Un file [.filename]#pkg-plist#. Questo file contiene l'elenco di tutti i file che saranno installati dal port. Dice anche al sistema dei port quale file rimuovere durante la disinstallazione.
-Alcuni port hanno altri file, come [.filename]#pkg-message#. Il sistema dei port li usa per affrontare speciali situazioni. Se vuoi maggiori dettagli su questi file, e sui port in generale, leggi attentamente il link:{porters-handbook}[Manuale del Porter di FreeBSD].
+Alcuni port hanno altri file, come [.filename]#pkg-message#. Il sistema dei port li usa per affrontare speciali situazioni. Se vuoi maggiori dettagli su questi file, e sui port in generale, leggi attentamente il extref:{porters-handbook}[Manuale del Porter di FreeBSD].
Il port include istruzioni su come compilare il codice sorgente, ma non include il codice sorgente stesso. Devi prendere il codice sorgente da un CDROM o da Internet. L'autore del codice sorgente può distribuirlo come desidera. Quasi sempre è un file di archivio tar compresso con gzip, ma potrebbe essere stato compresso con un altro tool o perfino potrebbe essere non compresso. Il codice sorgente del programma, in qualsiasi forma sia, è chiamato con il termine "distfile". I due metodi per installare un port di FreeBSD sono descritti qui sotto.
@@ -648,12 +647,12 @@ Se ti dovessi imbattere in un port che per te non funziona, ci sono alcune cose
+
[NOTE]
====
-Alcuni port non sono mantenuti da singole persone ma invece da una link:{mailing-list-faq}[mailing list]. La maggior parte di questi indirizzi sono simili a mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org]. Tieni conto di questo quando mandi le tue questioni.
+Alcuni port non sono mantenuti da singole persone ma invece da una extref:{mailing-list-faq}[mailing list]. La maggior parte di questi indirizzi sono simili a mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org]. Tieni conto di questo quando mandi le tue questioni.
In particolare, i port mantenuti da mailto:freebsd-ports@FreeBSD.org[freebsd-ports@FreeBSD.org] in realtà non sono mantenuti da nessuno. Il supporto e i fix, se ce ne sono, arrivano dalla comunità facente parte di quella mailing list. Sono necessari altri volontari!
====
+
-Se non ottieni una risposta, puoi usare man:send-pr[1] per segnalare un bug report (guarda l'articolo link:{problem-reports}[Come Scrivere i Report dei Problemi per FreeBSD]).
-. Aggiustarlo! Il link:{porters-handbook}[Manuale del Porter] contiene informazioni dettagliate sull'infrastruttura dei "Port" affinchè tu possa aggiustare quel port che occasionalmente non funziona o perfino proporne uno tutto tuo!
+Se non ottieni una risposta, puoi usare man:send-pr[1] per segnalare un bug report (guarda l'articolo extref:{problem-reports}[Come Scrivere i Report dei Problemi per FreeBSD]).
+. Aggiustarlo! Il extref:{porters-handbook}[Manuale del Porter] contiene informazioni dettagliate sull'infrastruttura dei "Port" affinchè tu possa aggiustare quel port che occasionalmente non funziona o perfino proporne uno tutto tuo!
. Prendi il package da un sito FTP vicino a te. La "principale" collezione dei package è su `ftp.FreeBSD.org` nella link:ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/[directory dei package], ma _prima_ assicurati di controllare il tuo http://mirrorlist.FreeBSD.org/[mirror locale]! È più probabile che funzionino i package rispetto alla compilazione dal sorgente e sono anche molto più sbrigativi. Usa il programma man:pkg_add[1] per installare i package sul tuo sistema.
diff --git a/documentation/content/it/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/it/books/handbook/ppp-and-slip/_index.adoc
index d9f9112b17..369e8b148a 100644
--- a/documentation/content/it/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/it/books/handbook/ppp-and-slip/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/mail
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
== Sinossi
diff --git a/documentation/content/it/books/handbook/preface/_index.adoc b/documentation/content/it/books/handbook/preface/_index.adoc
index c47da5b3ee..39894a8193 100644
--- a/documentation/content/it/books/handbook/preface/_index.adoc
+++ b/documentation/content/it/books/handbook/preface/_index.adoc
@@ -13,19 +13,31 @@ next: books/handbook/parti
:icons: font
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-audience]]
== A chi si rivolge
diff --git a/documentation/content/it/books/handbook/printing/_index.adoc b/documentation/content/it/books/handbook/printing/_index.adoc
index 6004da353a..3938b5d9bd 100644
--- a/documentation/content/it/books/handbook/printing/_index.adoc
+++ b/documentation/content/it/books/handbook/printing/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/linuxemu
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/printing/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
== Sinossi
diff --git a/documentation/content/it/books/handbook/security/_index.adoc b/documentation/content/it/books/handbook/security/_index.adoc
index 18b4fc00db..af3ca73a06 100644
--- a/documentation/content/it/books/handbook/security/_index.adoc
+++ b/documentation/content/it/books/handbook/security/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/jails
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/serialcomms/_index.adoc b/documentation/content/it/books/handbook/serialcomms/_index.adoc
index 4f6b3ee0d6..5a095d8fd8 100644
--- a/documentation/content/it/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/it/books/handbook/serialcomms/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/ppp-and-slip
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[serial-synopsis]]
== Sinossi
@@ -1154,7 +1153,7 @@ Abilita il supporto alla console per questa unità. Gli altri parametri di conso
Forza questa unità ad essere la console (a meno che sia presente un'altra console con priorità più alta), trascurando l'opzione `-h` discussa precedentemente. Il parametro `0x20` deve essere usato insieme al `0x10`.
`0x40`:::
-Riserva questa unità (insieme a `0x10`) e rende l'unità indisponibile per l'accesso normale. Non dovresti impostare questo parametro sull'unità della porta seriale che desideri usare come console seriale. L'unico uso di questo parametro è per designare l'unità per il debug remoto del kernel. Guarda il link:{developers-handbook}[Developer's Handbook] per maggiori informazioni sul debugging remoto.
+Riserva questa unità (insieme a `0x10`) e rende l'unità indisponibile per l'accesso normale. Non dovresti impostare questo parametro sull'unità della porta seriale che desideri usare come console seriale. L'unico uso di questo parametro è per designare l'unità per il debug remoto del kernel. Guarda il extref:{developers-handbook}[Developer's Handbook] per maggiori informazioni sul debugging remoto.
+
[NOTE]
======
diff --git a/documentation/content/it/books/handbook/users/_index.adoc b/documentation/content/it/books/handbook/users/_index.adoc
index 5179a5b183..35da21c4ce 100644
--- a/documentation/content/it/books/handbook/users/_index.adoc
+++ b/documentation/content/it/books/handbook/users/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/security
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/users/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/users/
-endif::[]
+:images-path: books/handbook/users/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/users/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[users-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/vinum/_index.adoc b/documentation/content/it/books/handbook/vinum/_index.adoc
index 8385713266..bff8930b57 100644
--- a/documentation/content/it/books/handbook/vinum/_index.adoc
+++ b/documentation/content/it/books/handbook/vinum/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/virtualization
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/vinum/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/vinum/
-endif::[]
+:images-path: books/handbook/vinum/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/vinum/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[vinum-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/virtualization/_index.adoc b/documentation/content/it/books/handbook/virtualization/_index.adoc
index 08352d38eb..93552deb2c 100644
--- a/documentation/content/it/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/it/books/handbook/virtualization/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/l10n
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/virtualization/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
-endif::[]
+:images-path: books/handbook/virtualization/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[virtualization-synopsis]]
== Sinossi
diff --git a/documentation/content/it/books/handbook/x11/_index.adoc b/documentation/content/it/books/handbook/x11/_index.adoc
index d4e58f21e1..372b39fba6 100644
--- a/documentation/content/it/books/handbook/x11/_index.adoc
+++ b/documentation/content/it/books/handbook/x11/_index.adoc
@@ -13,36 +13,35 @@ next: books/handbook/partii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Indice
-:table-caption: Tabella
-:figure-caption: Figura
-:example-caption: Esempio
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/it/mailing-lists.adoc[]
-include::shared/it/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[x11-synopsis]]
== Sinossi
diff --git a/documentation/content/ja/articles/contributing/_index.adoc b/documentation/content/ja/articles/contributing/_index.adoc
index 11982225c7..25e397133d 100644
--- a/documentation/content/ja/articles/contributing/_index.adoc
+++ b/documentation/content/ja/articles/contributing/_index.adoc
@@ -2,7 +2,6 @@
title: FreeBSD への貢献
authors:
- author: Hubbard Jordan [FAMILY Given]
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ieee", "general"]
---
@@ -15,27 +14,26 @@ trademarks: ["freebsd", "ieee", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目次
-:part-signifier: パート
-:chapter-signifier: 第
-:appendix-caption: 付録
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/urls.adoc[]
+:images-path: articles/contributing/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/ja/mailing-lists.adoc[]
-include::../../../../shared/ja/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/ja/mailing-lists.adoc[]
-include::../../../../shared/ja/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -66,7 +64,7 @@ FreeBSD 関連の事業に携わる商業団体が私たちにコンタクトす
FreeBSD に関わっている中には、プログラマではない人がたくさんいます。 プロジェクトには、文書を書く人、Web デザイナ、サポートを行う人がいます。 貢献するのに必要なのは、時間の投資と学ぶ意欲です。
. 定期的に FAQ とハンドブックを通して読んでみてください。 もしまずい説明や古い事柄や完全に間違っていることなどがあれば私達に教えてください。 さらに良いのは我々に修正案を送ることです (Docbook は学ぶのにそれほど難しくありませんが、 プレインテキストでも問題はありません)。
-. FreeBSD の文書を自分の母国語に翻訳するのを手伝ってください。 文書がすでに存在すれば、もっと文書を翻訳したり、 その翻訳が最新の状態かどうか確認するのを手伝うことができます。 まず FreeBSD ドキュメンテーションプロジェクト入門の link:{fdp-primer}#translations[翻訳に関する FAQ (よくある質問とその答え)] を一読してください。 とはいっても、 そうすることによってあなたがすべての FreeBSD 文書の翻訳に携わるようになるわけではないですからね。 - ボランティアとして、 多少に関わらず、自分がやろうと思うだけやってください。 いったん誰かが翻訳を始めたら、 たくさんの人達がいつだって協力してくれますから。 もし翻訳に費す時間やエネルギーが限られているなら、 まずインストール方法の翻訳からお願いします (訳注: なぜなら、 もっとも必要とされている文書がそれだからです)。
+. FreeBSD の文書を自分の母国語に翻訳するのを手伝ってください。 文書がすでに存在すれば、もっと文書を翻訳したり、 その翻訳が最新の状態かどうか確認するのを手伝うことができます。 まず FreeBSD ドキュメンテーションプロジェクト入門の extref:{fdp-primer}[翻訳に関する FAQ (よくある質問とその答え), translations] を一読してください。 とはいっても、 そうすることによってあなたがすべての FreeBSD 文書の翻訳に携わるようになるわけではないですからね。 - ボランティアとして、 多少に関わらず、自分がやろうと思うだけやってください。 いったん誰かが翻訳を始めたら、 たくさんの人達がいつだって協力してくれますから。 もし翻訳に費す時間やエネルギーが限られているなら、 まずインストール方法の翻訳からお願いします (訳注: なぜなら、 もっとも必要とされている文書がそれだからです)。
. たまに (もしくは定期的に) {freebsd-questions} を読んでください。 これは、あなたの持っている専門知識を共有したり、 誰かが抱えている問題を解決するのに非常に有効なものになり得ることです。 時にはあなた自身で新しいことを学ぶことさえできるかもしれません。 これらのフォーラムはやるべきことのアイディアの源にもなり得るのです。
[[ongoing-programmer-tasks]]
@@ -103,21 +101,21 @@ FreeBSD プロジェクトに貢献したい人のために http://wiki.freebsd.
[[contrib-general]]
=== バグ報告と一般的な論評
-__一般的な__技術的関心事に関するアイデアや提案は {freebsd-hackers} へメールしてください。同様に、このような事柄に興味のある (そして__膨大な__メール! に耐えられる) 人は、 {freebsd-hackers} に参加すると良いでしょう。 このメーリングリストや他のメーリングリストに関する詳しい情報については link:{handbook}#eresources-mail[FreeBSD ハンドブック] を参照してください。
+__一般的な__技術的関心事に関するアイデアや提案は {freebsd-hackers} へメールしてください。同様に、このような事柄に興味のある (そして__膨大な__メール! に耐えられる) 人は、 {freebsd-hackers} に参加すると良いでしょう。 このメーリングリストや他のメーリングリストに関する詳しい情報については extref:{handbook}eresources[FreeBSD ハンドブック, eresources-mail] を参照してください。
バグを発見したり変更を送付しようとしている場合は https://bugs.FreeBSD.org/submit/[障害報告提出フォーム] を使用して報告してください。 バグレポートの各項目を埋めるようにしてください。65KB を超えるのでなければ、 レポート中に直接パッチを入れてくださって結構です。 パッチがソースツリーにすぐ適用できるものならば、 報告の概要に `[PATCH]` と書いておいてください。 パッチを入れる場合、カット&ペーストは__しないで__ ください。 カット&ペーストではタブがスペースに展開されてパッチが使い物にならなくなってしまいます。 パッチが 20KB を超える場合は、アップロードをする前に、 それらを (man:gzip[1] や man:bzip2[1] で) 圧縮することを検討してください。
レポートがファイリングされれば、 バグ報告の確認とトラッキング番号をメールで受け取るはずです。 このトラッキング番号を覚えておき、 問題に関する詳細情報を更新できるようにしてください。
-良い障害報告を書く方法については link:{problem-reports}[この文書] をご覧ください。
+良い障害報告を書く方法については extref:{problem-reports}[この文書] をご覧ください。
=== 文書の変更
-文書の変更は {freebsd-doc} が監督しています。 完全な説明は、link:{fdp-primer}[ドキュメンテーションプロジェクト入門] をご覧ください。 他の障害報告と同様の方法で、提案や変更 (どんな些細なものでも歓迎します!) を送ってください。
+文書の変更は {freebsd-doc} が監督しています。 完全な説明は、extref:{fdp-primer}[ドキュメンテーションプロジェクト入門] をご覧ください。 他の障害報告と同様の方法で、提案や変更 (どんな些細なものでも歓迎します!) を送ってください。
=== 現存のソースコードの変更
-現存のソースコードへの追加または変更は、 いくらかトリッキーな仕事であり、FreeBSD 開発の現状にあなたがどれだけ通じているかに大きく依存します。 "FreeBSD-CURRENT" として知られる FreeBSD の特別な継続的リリースがあります。FreeBSD-CURRENT は開発者の積極的な活動の便宜のために、 色々な方法で利用可能になっています。FreeBSD-CURRENT の入手と使用方法についての詳しい情報については link:{handbook}#current-stable[FreeBSD ハンドブック] を参照してください。
+現存のソースコードへの追加または変更は、 いくらかトリッキーな仕事であり、FreeBSD 開発の現状にあなたがどれだけ通じているかに大きく依存します。 "FreeBSD-CURRENT" として知られる FreeBSD の特別な継続的リリースがあります。FreeBSD-CURRENT は開発者の積極的な活動の便宜のために、 色々な方法で利用可能になっています。FreeBSD-CURRENT の入手と使用方法についての詳しい情報については extref:{handbook}updating-upgrading[FreeBSD ハンドブック, current-stable] を参照してください。
古いソースをもとに作業すると、 残念ながらあなたの変更が時として時代遅れもしくは大きく異なるものになってしまって、 FreeBSD に再統合するのは困難になる恐れがあります。 システムの現状に関する議論がおこなわれている {freebsd-announce} と {freebsd-current} へ参加すれば、この可能性を最小限にできます。
diff --git a/documentation/content/ja/articles/fonts/_index.adoc b/documentation/content/ja/articles/fonts/_index.adoc
index 772c83ef7d..4f5181912a 100644
--- a/documentation/content/ja/articles/fonts/_index.adoc
+++ b/documentation/content/ja/articles/fonts/_index.adoc
@@ -4,7 +4,6 @@ subtitle: A Tutorial
authors:
- author: Bodenstab Dave [FAMILY Given]
email: imdave@synet.net
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "adobe", "apple", "linux", "microsoft", "opengroup", "general"]
---
@@ -17,24 +16,26 @@ trademarks: ["freebsd", "adobe", "apple", "linux", "microsoft", "opengroup", "ge
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目次
-:part-signifier: パート
-:chapter-signifier: 第
-:appendix-caption: 付録
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
-include::shared/ja/urls.adoc[]
+:images-path: articles/fonts/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/ja/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/ja/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -514,7 +515,7 @@ TrueType フォント形式は Windows、Windows 95、Mac で用いられます
このなんとも悲惨な状況は変わりつつあります。 http://www.freetype.org/[FreeType プロジェクト] では FreeType の便利なツールを開発しています。
-* XFree86 4.x に含まれている freetype モジュール。 詳細は link:{handbook}#x-fonts[FreeBSD ハンドブック] か http://www.xfree86.org/4.0.2/fonts.html[XFree86 4.0.2 Fonts] ページを見てください。
+* XFree86 4.x に含まれている freetype モジュール。 詳細は extref:{handbook}x11[FreeBSD ハンドブック, x-fonts] か http://www.xfree86.org/4.0.2/fonts.html[XFree86 4.0.2 Fonts] ページを見てください。
* X11 用の xfsft フォントサーバは 一般のフォントに加えて TrueType フォントを提供します。 現在ベータ版であるにもかかわらずたいへん評判がいいものです。 詳しくは http://www.dcs.ed.ac.uk/home/jec/programs/xfsft/[Juliusz Chroboczek's page] をごらんください。 FreeBSD への移植についての情報は http://math.missouri.edu/~stephen/software/[Stephen Montgomery's software page] にあります。
* xfstt は X11 用のもうひとつのフォントサーバで、 link: ftp://sunsite.unc.edu/pub/Linux/X11/fonts/[ftp://sunsite.unc.edu/pub/Linux/X11/fonts/] から入手できます。
* `ttf2bdf` というプログラムは、 X の環境下で TrueType フォントのセットから BDF 形式のファイルを作るものです。 Linux 用のバイナリが link:ftp://crl.nmsu.edu/CLR/multiling/General/[ftp://crl.nmsu.edu/CLR/multiling/General/] から 入手できます。
diff --git a/documentation/content/ja/articles/ipsec-must/_index.adoc b/documentation/content/ja/articles/ipsec-must/_index.adoc
index ce26a0f53a..7e175ef211 100644
--- a/documentation/content/ja/articles/ipsec-must/_index.adoc
+++ b/documentation/content/ja/articles/ipsec-must/_index.adoc
@@ -3,7 +3,6 @@ title: FreeBSD の IPsec 機能を独立検証するには
authors:
- author: Honig David [FAMILY Given]
email: honig@sprynet.com
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "opengroup", "general"]
---
@@ -11,29 +10,31 @@ trademarks: ["freebsd", "opengroup", "general"]
:doctype: article
:toc: macro
:toclevels: 1
-:sectnumlevels: 6
:icons: font
:sectnums:
+:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目次
-:part-signifier: パート
-:chapter-signifier: 第
-:appendix-caption: 付録
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
-include::shared/ja/urls.adoc[]
+:images-path: articles/ipsec-must/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/ja/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/ja/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -124,7 +125,7 @@ Expected value for L=8 is 7.1836656
FreeBSD の最近のバージョンでは IPsec のサポートが基本のソースコードに含まれています。 それ故、あなたはおそらく `IPSEC` オプションをカーネルコンフィグファイルに追加し、 カーネルを再構築/再インストールして man:setkey[8] コマンドで IPsec 接続を設定すればよいはずです。
-FreeBSD で IPsec を実行する包括的なガイドは link:{handbook}#ipsec[FreeBSD ハンドブック] で提供されています。
+FreeBSD で IPsec を実行する包括的なガイドは extref:{handbook}security[FreeBSD ハンドブック, ipsec] で提供されています。
[[kernel]]
== src/sys/i386/conf/KERNELNAME
diff --git a/documentation/content/ja/articles/leap-seconds/_index.adoc b/documentation/content/ja/articles/leap-seconds/_index.adoc
index 955fb81754..d9a6d70c75 100644
--- a/documentation/content/ja/articles/leap-seconds/_index.adoc
+++ b/documentation/content/ja/articles/leap-seconds/_index.adoc
@@ -1,6 +1,5 @@
---
title: FreeBSDにおける閏秒のサポートについて
-releaseinfo: "$FreeBSD$"
---
= FreeBSDにおける閏秒のサポートについて
@@ -12,24 +11,26 @@ releaseinfo: "$FreeBSD$"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目次
-:part-signifier: パート
-:chapter-signifier: 第
-:appendix-caption: 付録
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
-include::shared/ja/urls.adoc[]
+:images-path: articles/leap-seconds/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/ja/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/ja/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -50,7 +51,7 @@ __leap second__(閏秒)は地球の自転と時刻を同期させるために使
[[leapseconds-posix]]
== FreeBSDにおけるデフォルトの閏秒のハンドリング方法
-閏秒のもっとも簡単な取り扱い方法はFreeBSDがデフォルトで使っている POSIX のタイムルールとlink:{handbook}#network-ntp[NTP]を組み合わせる方法です。man:ntpd[8]が上位の NTP サーバと同期している場合には閏秒は適切に処理され、閏秒は日の最後の秒をもう一度繰り返すという方法を自動的に実施します。これ以外の調整は必要ありません。
+閏秒のもっとも簡単な取り扱い方法はFreeBSDがデフォルトで使っている POSIX のタイムルールとextref:{handbook}network-servers[NTP, network-ntp]を組み合わせる方法です。man:ntpd[8]が上位の NTP サーバと同期している場合には閏秒は適切に処理され、閏秒は日の最後の秒をもう一度繰り返すという方法を自動的に実施します。これ以外の調整は必要ありません。
アップストリーム NTP サーバが閏秒を適切に処理していない場合、man:ntpd[8]は時刻のずれに気づいたアップストリームサーバが時刻を修正したあとに時刻を合わせることになります。
diff --git a/documentation/content/ja/articles/problem-reports/_index.adoc b/documentation/content/ja/articles/problem-reports/_index.adoc
index caa1c9e39f..ad3c527467 100644
--- a/documentation/content/ja/articles/problem-reports/_index.adoc
+++ b/documentation/content/ja/articles/problem-reports/_index.adoc
@@ -3,7 +3,6 @@ title: FreeBSD 障害報告の書き方
authors:
- author: Smørgrav Dag-Erling [FAMILY Given]
- author: Linimon Mark [FAMILY Given]
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "intel", "sun", "general"]
---
@@ -16,27 +15,26 @@ trademarks: ["freebsd", "ibm", "intel", "sun", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目次
-:part-signifier: パート
-:chapter-signifier: 第
-:appendix-caption: 付録
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/urls.adoc[]
+:images-path: articles/problem-reports/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/ja/mailing-lists.adoc[]
-include::../../../../shared/ja/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/ja/mailing-lists.adoc[]
-include::../../../../shared/ja/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -75,7 +73,7 @@ ports または FreeBSD の一部ではない他のソフトウェアに関す
* あるアプリケーションの新しいバージョンが利用可能という情報を知らせるだけの障害報告は提出しないでください。 ports のメンテナは、新しいバージョンが利用になった際には、 自動的に portscout から連絡を受けています。 もちろん port を最新版へアップデートするためのパッチの提出は歓迎されます。
* メンテナンスされていない ports (`MAINTAINER` が `ports@FreeBSD.org` の ports) に対するパッチが添付されていない障害報告は、 コミッタからは取り上げられにくいものです。 メンテナンスされていない port のメンテナになるには、 リクエストの障害報告を提出してください (パッチがあることは好ましいですが、必須ではありません)。
-* いずれの場合も、link:{porters-handbook}#port-upgrading[Port 作成者のためのハンドブック] で説明されている手順がもっともよい結果をもたらします (link:{contributing}#ports-contributing[Contributing to the FreeBSD Ports Collection] という文書も読んでみたいと思われるかもしれませんね)。
+* extref:{porters-handbook}[Port 作成者のためのハンドブック, port-upgrading] で説明されている手順がもっともよい結果をもたらします (extref:{contributing}[Contributing to the FreeBSD Ports Collection, ports-contributing] という文書も読んでみたいと思われるかもしれませんね)。
再現することができないバグは、めったに直すことができません。 もし、バグが一度だけ発生してそれが再現できないもので、 なおかつ他の人のシステムでも起こらないようであれば、 開発者がそれを再現できる可能性も、 何が悪いのかわかる可能性もありません。 これはバグが起こらなかったことを意味するわけではありません。 しかし、このような状況では、 あなたの障害報告がバグの修正につながる見込みは非常に薄いものです。 おまけに、この手のバグは実際は故障したハードディスクや過熱した CPU が原因で起きていることが多いのです (障害報告を提出する前には必ず、可能なら、 こうした原因を排除するよう努めるべきです)。
@@ -87,7 +85,7 @@ ports または FreeBSD の一部ではない他のソフトウェアに関す
それから、問題が時宜を得たものかを確認してください。 既に修正したバグに関する障害報告を受けとることほど開発者を悩ませるものはまずありません。
-ベースシステムの問題で、FreeBSD のバージョンについてよく分かっていないなら、まず FAQ の link:{faq}#LATEST-VERSION[FreeBSD バージョン] に関する節を読んでください。 FreeBSD では、 ベースシステムのいくつかの最新ブランチ以外は修正できません。 そのため、古いバージョンについて障害報告を提出しても、 開発者からは、問題がまだ起きるかどうかを確認するために、 サポートされているバージョンにアップグレードするように勧められるだけかもしれません。 セキュリティオフィサチームが、 link:https://www.FreeBSD.org/security/[ サポートされているバージョンの一覧] を管理しています。
+ベースシステムの問題で、FreeBSD のバージョンについてよく分かっていないなら、まず FAQ の extref:{faq}[FreeBSD バージョン, LATEST-VERSION] に関する節を読んでください。 FreeBSD では、 ベースシステムのいくつかの最新ブランチ以外は修正できません。 そのため、古いバージョンについて障害報告を提出しても、 開発者からは、問題がまだ起きるかどうかを確認するために、 サポートされているバージョンにアップグレードするように勧められるだけかもしれません。 セキュリティオフィサチームが、 link:https://www.FreeBSD.org/security/[ サポートされているバージョンの一覧] を管理しています。
ある port に問題がある場合、 開発元にバグを報告することを考えて見てください。 すべてのソフトウェアのすべてのバグに対し、FreeBSD プロジェクトが修正することは不可能です。
@@ -96,8 +94,8 @@ ports または FreeBSD の一部ではない他のソフトウェアに関す
従うべき良い規則は、 障害報告を提出する前に常に問題の背景を調べることです。 あなたの問題はすでに報告されているかもしれません。 また、メーリングリストで議論されている最中か、 最近議論されていたかもしれません。 あなたが動かしているものより新しいバージョンで、 既に修正済みということすらありえます。 ですから、障害報告を提出する前に自明な場をすべて確認すべきです。 FreeBSD では、以下になります。
-* FreeBSD の link:{faq}[よくある質問とその答え] (FAQ) 一覧。FAQ は、link:{faq}#hardware[ハードウェア互換性]、link:{faq}#applications[ユーザアプリケーション] や link:{faq}#kernelconfig[カーネルコンフィグレーション] といったことに関する広い範囲の質問に対して答を示そうとしています。
-* link:{handbook}#eresources-mail[メーリングリスト]。 - メーリングリストを購読していなければ、 FreeBSD のウェブサイトにある https://www.FreeBSD.org/ja/search/search/#mailinglists[アーカイブ検索]を使ってください。 もし、メーリングリストで議論がされていなければ、 自分の問題についてのメッセージを送ってみて、 見落とした点を誰かが見つけてくれるかどうか、 数日間待ってみると良いでしょう。
+* FreeBSD の extref:{faq}[よくある質問とその答え] (FAQ) 一覧。FAQ は、extref:{faq}[ハードウェア互換性, hardware]、extref:{faq}[ユーザアプリケーション, applications] や extref:{faq}[カーネルコンフィグレーション, kernelconfig] といったことに関する広い範囲の質問に対して答を示そうとしています。
+* extref:{handbook}eresources[メーリングリスト, eresources-mail]。 - メーリングリストを購読していなければ、 FreeBSD のウェブサイトにある https://www.FreeBSD.org/ja/search/search/#mailinglists[アーカイブ検索]を使ってください。 もし、メーリングリストで議論がされていなければ、 自分の問題についてのメッセージを送ってみて、 見落とした点を誰かが見つけてくれるかどうか、 数日間待ってみると良いでしょう。
* ウェブ全体を検索する (任意)。- あなたの問題に関係する話題がないかどうかを、 お気に入りの検索エンジンを使って探してください。 あなたが知りもしなかったか、 検索しようと考えなかったメーリングリストやニュースグループのアーカイブにあたることもあるかもしれません。
* 次に、検索可能な https://bugs.freebsd.org/bugzilla/query.cgi[FreeBSD 障害報告データベース] (Bugzilla) があります。 あなたの問題が新しいものでも不明瞭でもなければ、 既に報告されている可能性がかなり高いです。
* 何よりもまず、 元となるソースコード内のドキュメントで、 あなたの問題が触れられていないどうかを調べてみてください。
@@ -239,9 +237,9 @@ https://bugs.freebsd.org/bugzilla/enter_bug.cgi[web ベースの障害報告提
これには、幾つかの方法がありますが、以下の順番が好ましいでしょう。 それぞれのコミュニケーションチャネルへのコンタクトには数日開けてください。
-* 提出した障害報告に関連する FreeBSD のメーリングリストを link:{handbook}#eresources-mail[ハンドブックのメーリングリスト] で探し、 そのメーリングリストに手助けやコメントをお願いするメールを送ってください。
+* 提出した障害報告に関連する FreeBSD のメーリングリストを extref:{handbook}eresources[ハンドブックのメーリングリスト, eresources-mail] で探し、 そのメーリングリストに手助けやコメントをお願いするメールを送ってください。
* 関連する IRC チャネルに参加してください。 不完全ですが一覧が https://wiki.freebsd.org/IrcChannels[] にあります。 チャネルにいるメンバーに提出した障害報告のことを伝えて、 助けを求めてください。 助けを求めた後は、 世界中の異なるタイムゾーンの人々がそれを取り上げることができるように、 我慢強くそのチャネルに留まってください。
-* 報告した障害報告に興味を持つコミッタを探してください。 問題が、特定のツール、バイナリ、port、 文書もしくはソースファイルに関するものであれば、link:http://svnweb.FreeBSD.org[SVN リポジトリ] を確認してください。 ファイルに最近変更を加えたコミッタを突き止め、 IRC もしくは電子メールで連絡をとってください。 コミッタとメールアドレスの一覧は、link:{contributors}[FreeBSD への貢献者] 文書にあります。
+* 報告した障害報告に興味を持つコミッタを探してください。 問題が、特定のツール、バイナリ、port、 文書もしくはソースファイルに関するものであれば、link:http://svnweb.FreeBSD.org[SVN リポジトリ] を確認してください。 ファイルに最近変更を加えたコミッタを突き止め、 IRC もしくは電子メールで連絡をとってください。 コミッタとメールアドレスの一覧は、extref:{contributors}[FreeBSD への貢献者] 文書にあります。
メンテナやユーザ同様、これらの人々もボランティアであるため、 すぐには障害報告に対応出来ないかもしれません。 フォローアップには、 我慢強くそして一貫性を持って対応することが推奨されます。 また、そのように対応すると協力を得やすいでしょう。 十分な配慮や努力をもってフォローアップに臨めば、 提出した障害報告に対応してくれるコミッタが見つかるのも時間の問題です。
@@ -256,4 +254,4 @@ https://bugs.freebsd.org/bugzilla/enter_bug.cgi[web ベースの障害報告提
完全なものとはいえませんが、 適切な障害報告の書き方と手順について関連する資料を示します。
* http://www.chiark.greenend.org.uk/~sgtatham/bugs.html[How to Report Bugs Effectively] (http://www.chiark.greenend.org.uk/~sgtatham/bugs-jp.html[日本語訳]) - Simon G. Tatham 氏による、(FreeBSD に限らない) 役に立つ障害報告の作成についてのすぐれたエッセイ。
-* link:{pr-guidelines}[Problem Report Handling Guidelines] - 障害報告が FreeBSD の開発者によってどのように扱われるかについて 有益な見識をまとめた記事。
+* extref:{pr-guidelines}[Problem Report Handling Guidelines] - 障害報告が FreeBSD の開発者によってどのように扱われるかについて 有益な見識をまとめた記事。
diff --git a/documentation/content/ja/books/design-44bsd/_index.adoc b/documentation/content/ja/books/design-44bsd/_index.adoc
index 327d89ab27..f5763443c9 100644
--- a/documentation/content/ja/books/design-44bsd/_index.adoc
+++ b/documentation/content/ja/books/design-44bsd/_index.adoc
@@ -6,8 +6,8 @@ authors:
- author: Michael J. Karels [FAMILY Given]
- author: John S. Quarterman [FAMILY Given]
copyright: 1996 Addison-Wesley Longman, Inc
-releaseinfo: "$FreeBSD$"
-trademarks: ["design-44bsd"]
+trademarks: ["design-44bsd"]
+isIndex: true
---
= 4.4BSD オペレーティングシステムの設計と実装
@@ -15,54 +15,35 @@ trademarks: ["design-44bsd"]
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
+:sectnumlevels: 6
:partnums:
+:sectnumoffset: 2
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:part-signifier: パート
-:chapter-signifier: 第
-:appendix-caption: 付録
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:sectnumoffset: 2
+:images-path: books/design-44bsd/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../images/{images-path}
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
-:imagesdir: ../../../images/books/design-44bsd/
-:chapters-path: content/ja/books/design-44bsd/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/design-44bsd/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ja/mailing-lists.adoc[]
-include::../../../../shared/ja/teams.adoc[]
-include::../../../../shared/ja/urls.adoc[]
-:imagesdir: ../../../../static/images/books/design-44bsd/
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ja/mailing-lists.adoc[]
-include::../../../../shared/ja/teams.adoc[]
-include::../../../../shared/ja/urls.adoc[]
-:imagesdir: ../../../../static/images/books/design-44bsd/
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
diff --git a/documentation/content/ja/books/faq/_index.adoc b/documentation/content/ja/books/faq/_index.adoc
index 3cdfc161e0..0a22c19770 100644
--- a/documentation/content/ja/books/faq/_index.adoc
+++ b/documentation/content/ja/books/faq/_index.adoc
@@ -3,8 +3,8 @@ title: FreeBSD 2.X、3.X、4.X についての FAQ (よくある質問とその
authors:
- author: FreeBSD ドキュメンテーションプロジェクト
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
+trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
+isIndex: true
---
= FreeBSD 2.X、3.X、4.X についての FAQ (よくある質問とその答え)
@@ -12,59 +12,46 @@ trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "
:toc: macro
:toclevels: 1
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
+:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:part-signifier: パート
-:chapter-signifier: 第
-:appendix-caption: 付録
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:rel-numbranch: 3
-:rel-head: 13-CURRENT
-:rel-head-relx: 13.X
+:images-path: books/faq/
+:rel-numbranch: 4
+:rel-head: 14-CURRENT
+:rel-head-relx: 14.X
:rel-head-releng: head/
-:rel-relx: 12.X
-:rel-stable: 12-STABLE
-:rel-releng: stable/12/
+:rel-relx: 13.X
+:rel-stable: 13-STABLE
+:rel-releng: stable/13/
:rel-relengdate: December 2018
-:rel2-relx: 11.X
-:rel2-stable: 11-STABLE
-:rel2-releng: stable/11/
-:rel2-relengdate: October 2016
-
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+:rel2-relx: 12.X
+:rel2-stable: 12-STABLE
+:rel2-releng: stable/12/
+:rel2-relengdate: December 2018
+:rel3-relx: 11.X
+:rel3-stable: 11-STABLE
+:rel3-releng: stable/11/
+:rel3-relengdate: October 2016
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ja/mailing-lists.adoc[]
-include::../../../../shared/ja/teams.adoc[]
-include::../../../../shared/ja/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ja/mailing-lists.adoc[]
-include::../../../../shared/ja/teams.adoc[]
-include::../../../../shared/ja/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -101,7 +88,7 @@ FreeBSD とは一言で言えば、カリフォルニア大学バークレイ校
FreeBSD は企業やインターネットサービスプロバイダ、研究者、 コンピュータ専門家、学生、家庭のユーザなどにより、業務や教育、 娯楽に用いられています。これらに関しては http://www.FreeBSD.org/gallery/gallery/[FreeBSD ギャラリー]をご覧ください。
-FreeBSD に関するより詳しい情報は link:{handbook}[FreeBSD ハンドブック]を参照してください。
+FreeBSD に関するより詳しい情報は extref:{handbook}[FreeBSD ハンドブック]を参照してください。
=== FreeBSD が目指しているもの
@@ -132,7 +119,7 @@ link:ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/4.3-RELEASE/[4.3] が最新
=== FreeBSD-CURRENTって何?
-link:{handbook}#CURRENT[FreeBSD-CURRENT] はオペレーティングシステムの開発バージョンで、 やがて 5.0-RELEASE となります。よってこれは、そこに携わっている開発者や、 どんな障害をも乗り越えていけるタフな愛好家たちにとってのみ興味の対象となるものです。 -CURRENT の使用に際しての詳細は link:{handbook}[FreeBSD ハンドブック] の link:{handbook}#CURRENT[関連するセクション] を参照してください。
+extref:{handbook}updating-upgrading[FreeBSD-CURRENT, current] はオペレーティングシステムの開発バージョンで、 やがて 5.0-RELEASE となります。よってこれは、そこに携わっている開発者や、 どんな障害をも乗り越えていけるタフな愛好家たちにとってのみ興味の対象となるものです。 -CURRENT の使用に際しての詳細は extref:{handbook}[FreeBSD ハンドブック] の extref:{handbook}updating-upgrading[関連するセクション, current] を参照してください。
オペレーティングシステムに馴染みがない場合や、 それが一時的に発生している問題なのか、 それとも本質的な問題かを見極める能力がない場合は、 FreeBSD-CURRENT を使うべきではありません。 このブランチは時々急激に拡張されたり、 システムが構築できない状態になることもしょっちゅうあります。 FreeBSD-CURRENT を使う人は問題を分析し、 「小さな欠陥」ではなく、 明らかに間違いであると思われるものだけを報告できるものと想定されています。 「make world したら group 関係でエラーがでました」のような質問は、 -CURRENT メーリングリストでは軽蔑の眼差しであしらわれることもあります。
@@ -151,7 +138,7 @@ link:{handbook}#CURRENT[FreeBSD-CURRENT] はオペレーティングシステム
=== FreeBSD-STABLE のコンセプトは何ですか?
-FreeBSD 2.0.5 がリリースされた後、私たちは FreeBSD の開発を 2 系統に分割することにしました。 一つは link:{handbook}stable[-STABLE] というブランチで、バグの修正はしっかりテストされ、 機能の強化は少しずつしか行われません (急な変更や実験的機能を望まない、 インターネットサービスプロバイダや営利企業向け)。 もう一方のブランチは link:{handbook}#CURRENT[-CURRENT] で、2.0 がリリースされて以来 5.0-RELEASE (そしてその後も) へ向けて脈々と続いているものです。 ASCII で描いた簡単な図がわかりやすいかは自信がありませんが、 こんな感じになります。
+FreeBSD 2.0.5 がリリースされた後、私たちは FreeBSD の開発を 2 系統に分割することにしました。 一つは extref:{handbook}cutting-edge[-STABLE, stable] というブランチで、バグの修正はしっかりテストされ、 機能の強化は少しずつしか行われません (急な変更や実験的機能を望まない、 インターネットサービスプロバイダや営利企業向け)。 もう一方のブランチは extref:{handbook}cutting-edge[-CURRENT, current] で、2.0 がリリースされて以来 5.0-RELEASE (そしてその後も) へ向けて脈々と続いているものです。 ASCII で描いた簡単な図がわかりやすいかは自信がありませんが、 こんな感じになります。
[.programlisting]
....
@@ -206,7 +193,7 @@ http://www.netbsd.org/[NetBSD] または http://www.openbsd.org/[OpenBSD]。
=== FreeBSD の責任者はいったい誰?
-プロジェクトの全体的な方向性や、 誰にソースツリーにコードの書き込み権限を与えるか、 などといった FreeBSD プロジェクトに関する重要な意思決定は、 9 名からなるlink:{handbook}#STAFF-CORE[コアチーム (core team)] によってなされます。 ソースツリーを直接変更できる人はもっと多く、 200 名以上のlink:{handbook}#committers[ソースツリー管理者 (committer)] がいます。
+プロジェクトの全体的な方向性や、 誰にソースツリーにコードの書き込み権限を与えるか、 などといった FreeBSD プロジェクトに関する重要な意思決定は、 9 名からなるextref:{handbook}[コアチーム (core team)] によってなされます。 ソースツリーを直接変更できる人はもっと多く、 200 名以上のextref:{handbook}[ソースツリー管理者 (committer)] がいます。
しかし、<<mailing,メーリングリスト>>で先行して議論される、 通常の変更ではないものの議論への参加には、一切制限はありません。
@@ -260,11 +247,11 @@ Fax: +44 1892 667-473
=== FreeBSD のメーリングリストについて知りたいのですが?
-完全な情報が link:{handbook}#eresources-mail[FreeBSD ハンドブックのメーリングリストの節] にあります。
+完全な情報が extref:{handbook}eresources[FreeBSD ハンドブックのメーリングリストの節, eresources-mail] にあります。
=== FreeBSD のニュースグループは何がありますか?
-完全な情報が link:{handbook}#eresources-news[FreeBSD ハンドブックのニュースグループの節]にあります。
+完全な情報が extref:{handbook}eresources[FreeBSD ハンドブックのニュースグループの節, eresources-news]にあります。
=== FreeBSD の IRC (Internet Relay Chat) について何か情報はありますか?
@@ -282,7 +269,7 @@ Fax: +44 1892 667-473
{freebsd-doc} にコンタクトしてみてください (さらに参加すればもっとよいでしょう)。 このメーリングリストは FreeBSD 関連の文書に関する議論のためのものです。 FreeBSD に関する質問に対しては、 {freebsd-questions} というメーリングリストがあります。
-link:{handbook}[FreeBSD ハンドブック]もあります。 これは現在作業中で、 不完全だったり最新情報でないものが含まれていることに注意してください。
+extref:{handbook}[FreeBSD ハンドブック]もあります。 これは現在作業中で、 不完全だったり最新情報でないものが含まれていることに注意してください。
FreeBSD のガイド本の決定版は、 Greg Lehey 氏による "The Complete FreeBSD" です。 これは BSDi (以前の Walnut Creek CDROM) Books から出版されています。 現在は第三版になっていて、 インストール、システム管理ガイド、プログラム設定のヘルプ、 マニュアルページまでの内容が 773 ページにわたって書かれています。 この本は (そして現在の FreeBSD リリースは) http://www.osd.bsdi.com/[BSDi]、 http://www.cheapbytes.com/[CheapBytes]、 または最寄りの書店で注文することができます。 ISBN コードは 1-57176-246-9 です (これ以外のコードの場合もあるかもしれません)。
@@ -475,7 +462,7 @@ Web 上のリソース:
* [[smp]] SMP (Symmetric MultiProcessing) に関する情報は、 http://people.FreeBSD.org/~fsmp/SMP/SMP.html[SMP サポートページ]をご覧ください。
* [[multimedia]] FreeBSD のマルチメディアアプリケーションに関する情報は、 http://people.FreeBSD.org/~faulkner/multimedia/mm.html[マルチメディア]のページをご覧ください。 特に http://people.FreeBSD.org/~ahasty/Bt848.html[Bt848] ビデオキャプチャチップに興味のある方は、 リンクをたどってみてください。
-FreeBSD ハンドブックには、 実に完成されたlink:{handbook}#bibliography[参考図書]の一覧があり、 買うべき本をさがしている方は読む価値があります。
+FreeBSD ハンドブックには、 実に完成されたextref:{handbook}bibliography[参考図書, bibliography]の一覧があり、 買うべき本をさがしている方は読む価値があります。
== インストール
@@ -491,7 +478,7 @@ FreeBSD 3.1-RELEASE 以前では、 インストールの際に必要なのは [
* [.filename]#doc/#
* [.filename]#src/ssys.*#
-この手順の完全な説明と、一般的なインストール時の問題については link:{handbook}#install[FreeBSD ハンドブックのインストールの節] を参照してください。
+この手順の完全な説明と、一般的なインストール時の問題については extref:{handbook}install[FreeBSD ハンドブックのインストールの節, install] を参照してください。
=== ブートフロッピーイメージが一枚のフロッピーディスクに納まらないみたい!
@@ -506,11 +493,11 @@ FTP クライアントの中には、 転送モードのデフォルトを__ア
これを回避するには、 サーバに接続してイメージのダウンロードを開始する前に FTP のコマンドプロンプトで `binary` とタイプします。
* ブートイメージを DOS の `copy` コマンド (または GUI の同等のツール) でフロッピーディスクへ転送した。
+
-`copy` のようなプログラムは、 直接起動するように作成されたブートイメージをうまく処理できません。 イメージにはフロッピーディスクの完全な中身がトラック単位で格納されており、 フロッピーディスク上に通常のファイルとして 格納されるように想定されているわけではありません。 link:{handbook}#install[FreeBSD のインストール]に記述されているように、 低レベルのツール (たとえば `fdimage` や `rawrite`) を使用して "そのままの (raw)" の状態でフロッピーディスクに 転送する必要があります。
+`copy` のようなプログラムは、 直接起動するように作成されたブートイメージをうまく処理できません。 イメージにはフロッピーディスクの完全な中身がトラック単位で格納されており、 フロッピーディスク上に通常のファイルとして 格納されるように想定されているわけではありません。 extref:{handbook}install[FreeBSD のインストール, install]に記述されているように、 低レベルのツール (たとえば `fdimage` や `rawrite`) を使用して "そのままの (raw)" の状態でフロッピーディスクに 転送する必要があります。
=== FreeBSD のインストールについての説明書はどこにありますか?
-インストールの説明書はlink:{handbook}#install[FreeBSD ハンドブックのインストールの章]にあります。
+インストールの説明書はextref:{handbook}install[FreeBSD ハンドブックのインストールの章, install]にあります。
=== FreeBSD を動作させるには何が必要ですか?
@@ -968,7 +955,7 @@ IDE Zip か Jaz ドライブが接続されていたら、 それを取り外し
この変更を恒久的なものにする (つまり、 再起動や電源を入れる度にこの操作をする必要がないようにする) には、 [.filename]#/boot/loader.conf.local# に `root_disk_unit="disk_number"` という行を追加してください。
. FreeBSD 3.2 以前を利用している場合は、 Boot: プロンプトで `1:wd(2,a)kernel` と入力してエンターキーを押します。 システムが起動したら、 `echo "1:wd(2,a)kernel" > /boot.config` というコマンドを実行してこれをデフォルトのブート文字列とします。
. FreeBSD のディスクをプライマリ IDE コントローラに接続して、 ハードディスクが連続したドライブ番号で認識されるようにします。
-. カーネルのコンフィグレーションファイルで wd の行を以下のように変更し、 link:{handbook}kernelconfig[カーネルの再構築]を行って、 新しいカーネルをインストールします。
+. カーネルのコンフィグレーションファイルで wd の行を以下のように変更し、 extref:{handbook}kernelconfig[カーネルの再構築, kernelconfig]を行って、 新しいカーネルをインストールします。
+
[.programlisting]
....
@@ -1071,7 +1058,7 @@ Filesystem 1024-blocks Used Avail Capacity Mounted on
アップグレードには、 バイナリスナップショットを使うことを__強く__おすすめします。 4-STABLE スナップショットは link:ftp://releng4.FreeBSD.org/[releng4.FreeBSD.org] から入手可能です。
-ソースを使ってアップグレードする場合は、詳細について link:{handbook}#cutting-edge[FreeBSD ハンドブック]を参照するようにしてください。
+ソースを使ってアップグレードする場合は、詳細について extref:{handbook}updating-upgrading[FreeBSD ハンドブック, cutting-edge]を参照するようにしてください。
[CAUTION]
====
@@ -1136,7 +1123,7 @@ Filesystem 1024-blocks Used Avail Capacity Mounted on
[WARNING]
====
-セキュリティプロファイルは魔法の薬ではありません。 High に設定したら、適当な link:{handbook}#eresources-mail[ メーリングリスト]を読んだり、良質なパスワードや パスフレーズを用いたり、セキュリティについてのよい習慣を 守ったりしなくていいわけではありません。求めるセキュリティと 便利さの比率を手軽に設定してくれるだけです。
+セキュリティプロファイルは魔法の薬ではありません。 High に設定したら、適当な extref:{handbook}eresources[ メーリングリスト, eresources-mail]を読んだり、良質なパスワードや パスフレーズを用いたり、セキュリティについてのよい習慣を 守ったりしなくていいわけではありません。求めるセキュリティと 便利さの比率を手軽に設定してくれるだけです。
====
[NOTE]
@@ -1153,7 +1140,7 @@ FreeBSD は、EIDE と SCSI ハードディスクドライブをサポートし
=== どの SCSI コントローラをサポートしているのですか?
-link:{handbook}#INSTALL-HW[FreeBSD ハンドブック]に記されている完全なリストを参照してください。
+extref:{handbook}[FreeBSD ハンドブック]に記されている完全なリストを参照してください。
=== どんな CD-ROM ドライブをサポートしているのですか?
@@ -1197,7 +1184,7 @@ FreeBSD では、IDE バージョンの EZ ドライブを除くすべての SCS
=== どのマルチポートシリアルカードをサポートしていますか?
-一覧は link:{handbook}#INSTALL-MISC[その他のデバイス]の節にあります。
+一覧は extref:{handbook}[その他のデバイス]の節にあります。
無名のカードにもうまく動くものがあり、 特に AST 互換といわれているものに多く見られます。
@@ -1329,7 +1316,7 @@ FreeBSD 4.0 とそれ以降のリリースでは次のとおりです。
device psm0 at atkbdc? irq 12
....
-カーネルの再構築についてよく知らないのであれば、 link:{handbook}kernelconfig[カーネルのコンフィグレーション]を参照してください。
+カーネルの再構築についてよく知らないのであれば、 extref:{handbook}kernelconfig[カーネルのコンフィグレーション, kernelconfig]を参照してください。
起動時にカーネルが [.filename]#psm0# を検出したら、 [.filename]#psm0# のエントリが [.filename]#/dev# の中にあることを確認してください。それには、以下のようにします。
@@ -1548,7 +1535,7 @@ FreeBSD は SoundBlaster、SoundBlaster Pro、SoundBlaster 16、 Pro Audio Spect
=== どんなネットワークカードをサポートしていますか?
-より完全な一覧についてはlink:{handbook}#INSTALL-NICS[イーサネットカード]の節を参照してください。
+より完全な一覧についてはextref:{handbook}[イーサネットカード]の節を参照してください。
=== 数値演算コプロセッサを持っていませんが、何かまずいでしょうか?
@@ -1566,7 +1553,7 @@ FreeBSD は SoundBlaster、SoundBlaster Pro、SoundBlaster 16、 Pro Audio Spect
=== FreeBSD がサポートするデバイスは他にもあるんでしょうか?
-link:{handbook}#INSTALL-MISC[FreeBSD ハンドブック]に記されている、 サポートされている他のデバイスの一覧を参照してください。
+extref:{handbook}[FreeBSD ハンドブック]に記されている、 サポートされている他のデバイスの一覧を参照してください。
=== パワーマネージメント機能付きのラップトップ PC を持っているのですが…。
@@ -1674,7 +1661,7 @@ FreeBSD 2.1 は ファームウェアリビジョン 2.21 以降のものをサ
基本的にこれは既知の問題です。HP Netserver マシンの EISA オンボード SCSI コントローラは EISA のスロット番号 11 を占有しますが、「本当の」EISA スロットはすべてそれよりも前のアドレスに配置されているのです。 残念ながら、 10 番以上の EISA スロットは PCI に割り当てられたアドレス空間と衝突し、FreeBSD の自動コンフィグレーションは、 現状ではうまくこの状況を処理できていないのです。
-ですから現時点での最良の方法は、カーネルオプションの `EISA_SLOTS` を 12 に変え、 アドレス空間の衝突がないかの ようなふりをさせることです :) link:{handbook}#kernelconfig[カーネルの再構築]に記述されているようにしてカーネルを再構築してください。
+ですから現時点での最良の方法は、カーネルオプションの `EISA_SLOTS` を 12 に変え、 アドレス空間の衝突がないかの ようなふりをさせることです :) extref:{handbook}kernelconfig[カーネルの再構築, kernelconfig]に記述されているようにしてカーネルを再構築してください。
もちろん、これはこのようなマシンにインストールする際に 「卵が先か、 鶏が先か」といった問題を生み出すことになります。 この問題を回避するために、 _ユーザコンフィグ (UserConfig)_ の中には特別な仕組みが組み込まれています。 このとき "visual" インタフェースは使用せず、 コマンドラインインタフェースを使用してください。単純に
@@ -2116,7 +2103,7 @@ man:sysinstall[8] を立ち上げて Configure (設定)、Fdisk の順に選択
ApplixWare は、豪華で機能満載の FreeBSD 向けの 商用オフィススイートで、ワードプロセッサ、表計算、 プレゼンテーションソフトウェア、ベクタ描画ソフトウェア、 その他のアプリケーションを揃えています。
+
FreeBSD 版の ApplixWare の購入は http://www.wccdrom.com/titles/freebsd/applix.phtml[ こちら]からどうぞ。
-* Linux 版の http://www.sun.com/staroffice[StarOffice] は FreeBSD で完璧に動作します。Linux 版の StarOffice をインストールするもっとも簡単な方法は、link:{handbook}#ports[FreeBSD Ports コレクション]を利用することです。 また、オープンソースの http://www.openoffice.org[OpenOffice] も将来のバージョンで動作するでしょう。
+* Linux 版の http://www.sun.com/staroffice[StarOffice] は FreeBSD で完璧に動作します。Linux 版の StarOffice をインストールするもっとも簡単な方法は、extref:{handbook}ports[FreeBSD Ports コレクション, ports]を利用することです。 また、オープンソースの http://www.openoffice.org[OpenOffice] も将来のバージョンで動作するでしょう。
=== FreeBSD 用の Motif はどうやったら手に入りますか
@@ -2337,7 +2324,7 @@ inn の package や port をインストールしたあとに http://www.cis.ohi
=== カーネルをカスタマイズしたいんですが、難しいですか?
-全然難しくありません。 link:{handbook}#kernelconfig[カーネルの再構築]を調べてください。
+全然難しくありません。 extref:{handbook}kernelconfig[カーネルの再構築, kernelconfig]を調べてください。
[NOTE]
====
@@ -2728,7 +2715,7 @@ swapfile="/usr/swap0" # Set to name of swapfile if aux swapfile desired.
=== プリンタのセットアップで問題があります
-ハンドブックのプリンタの部分を参照してください。 探している問題のほとんどが書かれているはずです。 link:{handbook}#printing[FreeBSD ハンドブックの「プリンタの利用」]をご覧ください。
+ハンドブックのプリンタの部分を参照してください。 探している問題のほとんどが書かれているはずです。 extref:{handbook}printing[FreeBSD ハンドブックの「プリンタの利用」, printing]をご覧ください。
プリンタによっては、印刷するのにホスト側にドライバが 必要です。これら "WinPrinters" と呼ばれるものは、 素の FreeBSD では使えません。DOS や Windows NT 4.0 で動作しない なら、そのプリンタはおそらく WinPrinter でしょう。 ただし、唯一の希望が残されています。 [.filename]#ports/print/pnm2ppa# の port が 対応しているかどうか確認してみてください。link:http://www.freebsd.org/cgi/url.cgi?ports/print/pnm2ppa/pkg-descr[ パッケージの説明]にはこう書いてあります。
@@ -3860,7 +3847,7 @@ Key F15 A A Menu Workplace Nop
=== ディスクレスブート (diskless boot) に関する情報はどこで得られますか?
-"ディスクレスブート (diskless boot)" というのは、FreeBSD がネットワーク上で起動し、 必要なファイルを自分のハードディスクではなくてサーバから読み込むものです。 詳細については link:{handbook}diskless[FreeBSD ハンドブックの「ディスクレスブート」]を読んでください。
+"ディスクレスブート (diskless boot)" というのは、FreeBSD がネットワーク上で起動し、 必要なファイルを自分のハードディスクではなくてサーバから読み込むものです。 詳細については extref:{handbook}boot[FreeBSD ハンドブックの「ディスクレスブート」, diskless]を読んでください。
=== FreeBSD をネットワークのルータ (router) として使用することはできますか?
@@ -3895,7 +3882,7 @@ BIND の配布物と FreeBSD とでは [.filename]#cdefs.h# というファイ
使えます。FreeBSD を用いて他のサイトに接続する場合には、 man:slattach[8]、man:sliplogin[8]、man:ppp[8] そして man:pppd[8] のマニュアルページをご覧ください。 man:ppp[8] と man:pppd[8] は、 PPP のサーバ、クライアント両方の機能を持っています。 その一方で、man:sliplogin[8] は SLIP のサーバ専用で、 man:slattach[8] は SLIP のクライアント専用です。
-これらを使うためのさらなる情報については、link:{handbook}ppp-and-slip[ハンドブックの PPP と SLIP の章]をご覧ください。
+これらを使うためのさらなる情報については、extref:{handbook}ppp-and-slip[ハンドブックの PPP と SLIP の章, ppp-and-slip]をご覧ください。
「シェルアカウント」を通じてのみインターネットへアクセス可能な場合、 slirp package みたいなものが欲しくなるかもしれませんね。 これを使えば、ローカルマシンから直接 ftp や http のようなサービスに (限定的ではありますが) アクセスすることができます。
@@ -3926,7 +3913,7 @@ man:ifconfig[8] のコマンドラインに `netmask 0xffffffff` を追加して
PC 用のネットワークカードによっては、 NFS のような、 ネットワークを酷使するアプリケーションにおいて問題を起こすものがあります。
-この点に関しては link:{handbook}#nfs[FreeBSD ハンドブックの「NFS」]を参照してください。
+この点に関しては extref:{handbook}[FreeBSD ハンドブックの「NFS」]を参照してください。
=== 何故 Linux のディスクを NFS マウントできないのでしょうか?
@@ -4060,7 +4047,7 @@ domain foo.bar.edu
[.filename]#/etc/rc.conf# に `firewall_type='open'` を追加してもよいでしょう。
-FreeBSD のファイアウォールの設定についての情報は link:{handbook}#firewalls[FreeBSD ハンドブックの「ファイアウォール」]にあります。
+FreeBSD のファイアウォールの設定についての情報は extref:{handbook}firewalls[FreeBSD ハンドブックの「ファイアウォール」, firewalls]にあります。
=== IPFW のオーバヘッドはどのくらいでしょうか?
@@ -4170,7 +4157,7 @@ pseudo-device bpfilter # Berkeley Packet Filter
# sh MAKEDEV bpf0
....
-デバイスノードの作成の詳細は、 link:{handbook}#kernelconfig-nodes[FreeBSD ハンドブックの「デバイスノード」]を参照してください。
+デバイスノードの作成の詳細は、 extref:{handbook}[FreeBSD ハンドブックの「デバイスノード」, kernelconfig-nodes]を参照してください。
=== Linux の smbmount のように、 ネットワーク上の Windows マシンのディスクをマウントするにはどうしたら良いのでしょう?
@@ -4203,7 +4190,7 @@ Ports Collection に含まれる sharity light パッケージを使ってくだ
=== ppp が動きません。どこを間違えているのでしょう?
-まず man:ppp[8] のマニュアルと、 link:{handbook}#USERPPP[FreeBSD ハンドブックの「PPP」]を読んでみましょう。 次に、
+まず man:ppp[8] のマニュアルと、 extref:{handbook}ppp-and-slip[FreeBSD ハンドブックの「PPP」, userppp]を読んでみましょう。 次に、
[.programlisting]
....
@@ -4270,7 +4257,7 @@ add 0 0 10.0.0.2
delete ALL
....
-の行をうっかり消してしまった可能性があります。 この場合は、 link:{handbook}#USERPPP-FINAL[FreeBSD ハンドブックの「システムの最終設定」]の項を読み直してください。
+の行をうっかり消してしまった可能性があります。 この場合は、 extref:{handbook}ppp-and-slip[FreeBSD ハンドブックの「システムの最終設定」, userppp-final]の項を読み直してください。
=== No route to host とはどういう意味ですか?
@@ -4291,7 +4278,7 @@ delete ALL
add 0 0 HISADDR
....
-詳しい情報については、 link:{handbook}#USERPPP-DYNAMICIP[FreeBSD ハンドブックの「PPP と動的 IP 設定」]の項を参照してください。
+詳しい情報については、 extref:{handbook}ppp-and-slip[FreeBSD ハンドブックの「PPP と動的 IP 設定」, userppp-dynamicip]の項を参照してください。
=== 3 分ほど経つと接続が切れてしまう
@@ -5174,7 +5161,7 @@ http://www.grex.org/[Grex] は、 掲示板システムと双方向チャット
http://www.FreeBSD.org/cgi/ports.cgi?^sup[SUP] とは、ソフトウェアアップデートプロトコル (Software Update Protocol) で カーネギーメロン大学 (CMU) で開発ツリーの同期のために開発されました。 私たちの中心開発ツリーをリモートサイトで同期させるために使っていました。
-SUP はバンド幅を浪費しますので、今は使っていません。 ソースコードのアップデートの現在のおすすめの方法は link:{handbook}#CVSUP[FreeBSD ハンドブックの「CVSup」]にあります。
+SUP はバンド幅を浪費しますので、今は使っていません。 ソースコードのアップデートの現在のおすすめの方法は extref:{handbook}mirrors[FreeBSD ハンドブックの「CVSup」, cvsup]にあります。
=== FreeBSD をクールに使うには?
@@ -5298,7 +5285,7 @@ HEAD は他の二つと違って、 実際のブランチタグではなく、 _
pseudo-device vn #Vnode driver (turns a file into a device)
....
-次に、CVS リポジトリ全体を手元においておく必要があります。 これを入手するには link:{handbook}#CVSUP[CVSUP] が使用できますが、supfile で release の名称を cvs にして 他のタグや date フィールドを削除する必要があります。
+次に、CVS リポジトリ全体を手元においておく必要があります。 これを入手するには extref:{handbook}mirrors[CVSUP, cvsup] が使用できますが、supfile で release の名称を cvs にして 他のタグや date フィールドを削除する必要があります。
[.programlisting]
....
@@ -5356,7 +5343,7 @@ Adaptec の 1542 SCSI ホストアダプタは、 ユーザがソフトウェア
=== インターネットアクセスに制限があっても current を追いかけられますか?
-はい、 link:{handbook}#CTM[CTM システム]を使って、 ソースツリー全体のダウンロードを__行なわず__に追いかけることができます。
+はい、 extref:{handbook}[CTM システム]を使って、 ソースツリー全体のダウンロードを__行なわず__に追いかけることができます。
=== どのようにして配布ファイルを 240KB に分割しているのですか?
@@ -5376,7 +5363,7 @@ bin-tarball:
=== 私はカーネルに拡張を行ないました。 誰に送ればいいですか?
-link:{handbook}#contrib[FreeBSD ハンドブックの「FreeBSD への貢献」]を参照してください。
+extref:{handbook}[FreeBSD ハンドブックの「FreeBSD への貢献」]を参照してください。
あなたのアイディアに感謝します!
diff --git a/documentation/content/ja/books/handbook/_index.adoc b/documentation/content/ja/books/handbook/_index.adoc
index 018812dfad..b7054b523d 100644
--- a/documentation/content/ja/books/handbook/_index.adoc
+++ b/documentation/content/ja/books/handbook/_index.adoc
@@ -3,9 +3,9 @@ title: FreeBSD ハンドブック
authors:
- author: FreeBSD ドキュメンテーションプロジェクト
copyright: 1995-2021 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
next: books/handbook/preface
+isIndex: true
---
= FreeBSD ハンドブック
@@ -15,18 +15,32 @@ next: books/handbook/preface
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:toc-title: 目次
-:part-signifier: パート
-:chapter-signifier: 第
-:appendix-caption: 付録
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
概要
@@ -42,10 +56,10 @@ FreeBSD ハンドブック日本語版の作成は FreeBSD 日本語ドキュメ
'''
-include::content/ja/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
-include::content/ja/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
-include::content/ja/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
-include::content/ja/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/ja/books/handbook/advanced-networking/_index.adoc b/documentation/content/ja/books/handbook/advanced-networking/_index.adoc
index e3f5e34e79..17912d9e5f 100644
--- a/documentation/content/ja/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/ja/books/handbook/advanced-networking/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[advanced-networking-synopsis]]
== この章では
@@ -1643,7 +1641,7 @@ TA を使用した場合の機能や接続の安定性は、使用している P
外部 TA を使う際の最大の問題点は、 モデムの場合と同じく良いシリアルカードが必要であるということです。
-シリアルデバイスの詳細と、 非同期シリアルポートと同期シリアルポートの差を理解するには、link:{serial-uart}[FreeBSD シリアルハードウェア]チュートリアルを参照してください。
+シリアルデバイスの詳細と、 非同期シリアルポートと同期シリアルポートの差を理解するには、extref:{serial-uart}[FreeBSD シリアルハードウェア]チュートリアルを参照してください。
標準の PC シリアルポート (非同期) に接続された TA は 128 Kbs の接続を行っていても、最大通信速度が 115.2 Kbs に制限されてしまいます。128 Kbs の ISDN の性能を最大限に生かすためには TA を同期シリアルカードに接続しなければなりません。
diff --git a/documentation/content/ja/books/handbook/basics/_index.adoc b/documentation/content/ja/books/handbook/basics/_index.adoc
index 016cb971a3..833bf589c5 100644
--- a/documentation/content/ja/books/handbook/basics/_index.adoc
+++ b/documentation/content/ja/books/handbook/basics/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ports
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[basics-synopsis]]
== この章では
diff --git a/documentation/content/ja/books/handbook/bibliography/_index.adoc b/documentation/content/ja/books/handbook/bibliography/_index.adoc
index a5ae7ef50e..6d90559f54 100644
--- a/documentation/content/ja/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/ja/books/handbook/bibliography/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/eresources
[[bibliography]]
= 参考図書
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
__訳: {nakai}, 1996 年 10 月 12 日。__
@@ -103,7 +117,7 @@ FreeBSD イタリア語ドキュメンテーションプロジェクトの一環
* Leffler, Samuel J., Marshall Kirk McKusick, _The Design and Implementation of the 4.3BSD UNIX Operating System: Answer Book_. Reading, Mass. : Addison-Wesley, 1991. ISBN 0-201-54629-9 (訳注: 邦訳は以下のものが出版されています。 相田 仁 / 計 宇生 / 小池 汎平 訳。 _UNIX 4.3BSDの設計と実装_。 アンサーブック, トッパン, 1991。 ISBN 4-8101-8039-5)
* McKusick, Marshall Kirk, Keith Bostic, Michael J Karels, and John Quarterman. _The Design and Implementation of the 4.4BSD Operating System_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-54979-4
+
-(この本の第二章が FreeBSD ドキュメンテーションプロジェクト の一部として link:{design-44bsd}[オンライン] で公開されています。)
+(この本の第二章が FreeBSD ドキュメンテーションプロジェクト の一部として extref:{design-44bsd}[オンライン] で公開されています。)
* Marshall Kirk McKusick, George V. Neville-Neil _The Design and Implementation of the FreeBSD Operating System_. Boston, Mass. : Addison-Wesley, 2004. ISBN 0-201-70245-2
* Marshall Kirk McKusick, George V. Neville-Neil, Robert N. M. Watson _The Design and Implementation of the FreeBSD Operating System, 2nd Ed._. Westford, Mass. : Pearson Education, Inc., 2014. ISBN 0-321-96897-2
* Stevens, W. Richard. _TCP/IP Illustrated, Volume 1: The Protocols_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-63346-9
diff --git a/documentation/content/ja/books/handbook/book.adoc b/documentation/content/ja/books/handbook/book.adoc
index 8bbbf30b9c..9e49e82d55 100644
--- a/documentation/content/ja/books/handbook/book.adoc
+++ b/documentation/content/ja/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: FreeBSD ハンドブック
authors:
- author: FreeBSD ドキュメンテーションプロジェクト
copyright: 1995-2021 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
---
@@ -12,53 +11,35 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:part-signifier: パート
-:appendix-caption: 付録
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
:book: true
:pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
-:chapters-path: content/ja/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ja/mailing-lists.adoc[]
-include::../../../../shared/ja/teams.adoc[]
-include::../../../../shared/ja/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ja/mailing-lists.adoc[]
-include::../../../../shared/ja/teams.adoc[]
-include::../../../../shared/ja/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -79,75 +60,75 @@ toc::[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
// Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
-include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1]
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
-include::{chapters-path}users/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}users/_index.adoc[leveloffset=+1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=7..19]
+include::{chapters-path}partiv.adoc[lines=15..27]
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
// Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
:sectnums!:
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/ja/books/handbook/boot/_index.adoc b/documentation/content/ja/books/handbook/boot/_index.adoc
index a3bbde3d6a..809e846c27 100644
--- a/documentation/content/ja/books/handbook/boot/_index.adoc
+++ b/documentation/content/ja/books/handbook/boot/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/users
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== この章では
diff --git a/documentation/content/ja/books/handbook/bsdinstall/_index.adoc b/documentation/content/ja/books/handbook/bsdinstall/_index.adoc
index a6342dfc9f..9eeb20672b 100644
--- a/documentation/content/ja/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/ja/books/handbook/bsdinstall/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/basics
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/bsdinstall/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
-endif::[]
+:images-path: books/handbook/bsdinstall/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[bsdinstall-synopsis]]
== この章では
diff --git a/documentation/content/ja/books/handbook/config/_index.adoc b/documentation/content/ja/books/handbook/config/_index.adoc
index 482ee6eb2d..ebfe2521a5 100644
--- a/documentation/content/ja/books/handbook/config/_index.adoc
+++ b/documentation/content/ja/books/handbook/config/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/boot
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/config/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
== この章では
diff --git a/documentation/content/ja/books/handbook/cutting-edge/_index.adoc b/documentation/content/ja/books/handbook/cutting-edge/_index.adoc
index 8d924451d4..862130f0e8 100644
--- a/documentation/content/ja/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/ja/books/handbook/cutting-edge/_index.adoc
@@ -15,37 +15,35 @@ tags: ["updating", "upgrading", "documentation", "FreeBSD-STABLE", "FreeBSD-CURR
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[updating-upgrading-synopsis]]
== この章では
@@ -481,13 +479,13 @@ FreeBSD ドキュメントの最新バージョンは、FreeBSD ウェブサイ
この章では、ソースまたは Ports Collection を使って、ローカルの FreeBSD ドキュメントを最新に保つ方法を説明します。
-ドキュメントを編集したり、ドキュメントの誤りを報告する方法については、新しい貢献者のための FreeBSD ドキュメンテーションプロジェクト入門 (link:{fdp-primer}[FreeBSD Documentation Project Primer]) をご覧ください。
+ドキュメントを編集したり、ドキュメントの誤りを報告する方法については、新しい貢献者のための FreeBSD ドキュメンテーションプロジェクト入門 (extref:{fdp-primer}[FreeBSD Documentation Project Primer]) をご覧ください。
[[updating-installed-documentation]]
=== ソースから FreeBSD ドキュメントをインストールする
ソースから FreeBSD ドキュメントを構築するのに必要なツールは、FreeBSD のベースシステムには含まれていません。
-必要なツールは、新しい貢献者のための FreeBSD ドキュメンテーションプロジェクト入門で link:{fdp-primer}#overview-quick-start[説明されているステップ] に従ってインストールしてください。
+必要なツールは、新しい貢献者のための FreeBSD ドキュメンテーションプロジェクト入門で extref:{fdp-primer}[説明されているステップ, overview-quick-start] に従ってインストールしてください。
インストールしたら、git を使って、ドキュメントのソースをダウンロードしてください。
diff --git a/documentation/content/ja/books/handbook/desktop/_index.adoc b/documentation/content/ja/books/handbook/desktop/_index.adoc
index 0761d65230..32b4750cd5 100644
--- a/documentation/content/ja/books/handbook/desktop/_index.adoc
+++ b/documentation/content/ja/books/handbook/desktop/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/multimedia
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[desktop-synopsis]]
== この章では
diff --git a/documentation/content/ja/books/handbook/disks/_index.adoc b/documentation/content/ja/books/handbook/disks/_index.adoc
index 16603c9bca..6ab003f7cc 100644
--- a/documentation/content/ja/books/handbook/disks/_index.adoc
+++ b/documentation/content/ja/books/handbook/disks/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/l10n
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[disks-synopsis]]
== この章では
diff --git a/documentation/content/ja/books/handbook/eresources/_index.adoc b/documentation/content/ja/books/handbook/eresources/_index.adoc
index 385ce15ee1..7280f2fce8 100644
--- a/documentation/content/ja/books/handbook/eresources/_index.adoc
+++ b/documentation/content/ja/books/handbook/eresources/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/pgpkeys
[[eresources]]
= インターネット上のリソース
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
FreeBSD の進歩は急速であり、 印刷したメディアは最新の開発をフォローするのに実用的ではありません。 それだけしかない、というわけではありませんが、 最新情報を入手する方法としては電子的なリソースがベストです。 FreeBSD はボランティアの努力によって、ユーザコミュニティ自体が、 一種の "テクニカルサポート部門" としての役割も通常果たしており、 電子メール、ウェブフォーラムおよび Usenet のニュースがこれらのコミュニティにたどり着く最も効果的な方法になっています。
@@ -53,9 +66,9 @@ FreeBSD の進歩は急速であり、 印刷したメディアは最新の開
_FreeBSD メーリングリストにメールを送信できるかどうかを確認するには、 {freebsd-test} にテストメッセージを送信してください。_ 他のメーリングリストには、 テストメッセージを送信しないでください。
====
-どのメーリングリストに質問を投稿すべきか迷った場合には、 link:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list] をご覧ください。
+どのメーリングリストに質問を投稿すべきか迷った場合には、 extref:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list] をご覧ください。
-どこのメーリングリストに投稿する場合でも、 メーリングリストを最大限に活用する方法を理解しておいてください。 たとえば、 link:{mailing-list-faq}[Mailing List Frequently Asked Questions] (FAQ) 文書を読んで、 繰り返し行われる議論を避ける方法を理解してください。
+どこのメーリングリストに投稿する場合でも、 メーリングリストを最大限に活用する方法を理解しておいてください。 たとえば、 extref:{mailing-list-faq}[Mailing List Frequently Asked Questions] (FAQ) 文書を読んで、 繰り返し行われる議論を避ける方法を理解してください。
メーリングリストはいずれもアーカイブされており、それらは link:https://www.FreeBSD.org/search/[FreeBSD World Wide Web server] で検索することができます。 キーワード検索可能なアーカイブの提供は、 良くある質問に対する回答を見つけるすぐれた方法ですから、 質問を投稿する前に調べてみるべきでしょう。 このことは、FreeBSD メーリングリストに送信されたメッセージは、 ずっとアーカイブされることを意味しています。 プライバシーの保護が問題になるような場合には、 使い捨てのメールアドレスを用い、公な情報のみを送ってください。
diff --git a/documentation/content/ja/books/handbook/introduction/_index.adoc b/documentation/content/ja/books/handbook/introduction/_index.adoc
index 8c72c2d01b..dcdeb355fc 100644
--- a/documentation/content/ja/books/handbook/introduction/_index.adoc
+++ b/documentation/content/ja/books/handbook/introduction/_index.adoc
@@ -15,37 +15,35 @@ tags: ["introduction", "synopsis", "about", "Who Uses FreeBSD", "goals", "histor
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/introduction/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/introduction/
-endif::[]
+:images-path: books/handbook/introduction/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/introduction/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-synopsis]]
== この章では
@@ -96,7 +94,7 @@ FreeBSD のソースコードは自由に提供されているので、 シス
* _教育:_ あなたは、計算機科学または関連分野の工学を専攻する学生さんですか? オペレーティングシステムやコンピュータアーキテクチャ、 ネットワークについて学習するなら、 実際に FreeBSD のソースコードを読んで、 それがどのように動作するのかを学ぶのが一番よい方法です。 また、無料で利用できる CAD や数学、 グラフィックデザインのパッケージがいくつもあるので、 コンピュータに関わる主要な目的が、 _他_のことをすることにある方にも、 大いに役立ちます。
* _研究:_ システム全体のソースコードが利用できるため、 FreeBSD はオペレーティングシステムの研究だけでなく、 計算機科学の他の部門においても優れたプラットフォームです。 自由に利用できる FreeBSD の特長は、オープンフォーラムで 議論される特別なライセンスの同意や制限について心配することなく、 離れたグループでもアイディアや開発の共有による共同研究を可能にします。
* _ネットワーキング:_ 新しいルータが必要? ネームサーバ (DNS) は? 内部のネットワークを人々から守るファイアウォールは? FreeBSD はすみに眠っている使われていない PC を簡単に 洗練されたパケットフィルタリング機能を持つ高級なルータに 変えることができます。
-* _組み込み:_ FreeBSD は、 組み込みシステムを構築する優れたプラットフォームとなります。 ARM(R), MIPS(R) および PowerPC(R) プラットフォームへのサポートとともに、 強固なネットワークスタック、最新の機能および 寛容なlink:{faq}#bsd-license-restrictions[BSD ライセンス] により、 FreeBSD は、組み込みルータ、 ファイアウォールおよび他のデバイスを構築する優れた基盤となります。
+* _組み込み:_ FreeBSD は、 組み込みシステムを構築する優れたプラットフォームとなります。 ARM(R), MIPS(R) および PowerPC(R) プラットフォームへのサポートとともに、 強固なネットワークスタック、最新の機能および 寛容なextref:{faq}[BSD ライセンス, bsd-license-restrictions] により、 FreeBSD は、組み込みルータ、 ファイアウォールおよび他のデバイスを構築する優れた基盤となります。
* _デスクトップ:_ FreeBSD は、自由に利用できる X11 サーバを使うことによって、 安価なデスクトップとなります。 FreeBSD では、標準的な GNOME および KDE グラフィカルユーザインタフェースを含む、 数多くのオープンソースのデスクトップ環境を選択できます。 FreeBSD は、 中央のサーバから"ディスクレス"でもブート可能であり、 個々のワークステーションを安価で、 容易に管理することさえ可能にします。
* _ソフトウェア開発:_ 基本的な FreeBSD システムには、完全な C/C++ コンパイラやデバッガスイートを含む完全な開発ツールがついてきます。 他の多くの言語へのサポートも ports および package コレクションから利用できます。
@@ -186,7 +184,7 @@ FreeBSD プロジェクトの目的は、いかなる用途にも使用でき、
[[development]]
=== FreeBSD の開発モデル
-FreeBSD の開発は非常に開かれた、柔軟性のあるプロセスです。 link:{contributors}[貢献者リスト] を見ていただければわかるとおり、 FreeBSD は文字通り世界中の何千という人々の努力によって開発されています。 FreeBSD の開発環境は、 この何千という開発者がインターネット経由で共同作業できるようになっているのです。 新しい開発者はいつでも大歓迎ですので、link:{freebsd-hackers} にメールを送ってください。 {freebsd-announce} もありますので、他の FreeBSD ユーザに自分のやっていることを宣伝したい時にはどうぞ使ってください。
+FreeBSD の開発は非常に開かれた、柔軟性のあるプロセスです。 extref:{contributors}[貢献者リスト] を見ていただければわかるとおり、 FreeBSD は文字通り世界中の何千という人々の努力によって開発されています。 FreeBSD の開発環境は、 この何千という開発者がインターネット経由で共同作業できるようになっているのです。 新しい開発者はいつでも大歓迎ですので、link:{freebsd-hackers} にメールを送ってください。 {freebsd-announce} もありますので、他の FreeBSD ユーザに自分のやっていることを宣伝したい時にはどうぞ使ってください。
あと、FreeBSD プロジェクトとその開発プロセスについて、 どなたにも知っていていただきたいのは以下のようなことです。
@@ -208,7 +206,7 @@ _FreeBSD コアチーム_ は FreeBSD プロジェクトが会社だとすると
その他のコントリビュータ::
最後になりますが、 もっとも重要で多数をしめる開発者はフィードバックやバグフィクスをどんどん送ってくれるユーザ自身です。 FreeBSD の開発に関わっていきたいという人は、 議論の場である {freebsd-hackers} に参加するとよいでしょう。 FreeBSD 関連メーリングリストに関する詳細は、 crossref:eresources[eresources,インターネット上のリソース] をご覧ください。
+
-link:{contributors}[FreeBSD への貢献者リスト] は日に日に長くなっています。 あなたも今日、何か送ることからはじめてみませんか?
+extref:{contributors}[FreeBSD への貢献者リスト] は日に日に長くなっています。 あなたも今日、何か送ることからはじめてみませんか?
+
もちろん FreeBSD に貢献するには、 コードを書くほかにもいろいろな方法があります。 助けが求められている分野については、link:https://www.FreeBSD.org/[FreeBSD プロジェクトのウェブサイト] をご覧ください。
diff --git a/documentation/content/ja/books/handbook/kernelconfig/_index.adoc b/documentation/content/ja/books/handbook/kernelconfig/_index.adoc
index 293c976e24..a1d53a6e1e 100644
--- a/documentation/content/ja/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/ja/books/handbook/kernelconfig/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/printing
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kernelconfig-synopsis]]
== この章では
diff --git a/documentation/content/ja/books/handbook/l10n/_index.adoc b/documentation/content/ja/books/handbook/l10n/_index.adoc
index a94dad2e14..63552f2839 100644
--- a/documentation/content/ja/books/handbook/l10n/_index.adoc
+++ b/documentation/content/ja/books/handbook/l10n/_index.adoc
@@ -15,37 +15,35 @@ tags: ["i18n", "L10n", "localization", "Locale", "LANG", "MM_CHARSET", "cap_mkdb
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-synopsis]]
== この章では
diff --git a/documentation/content/ja/books/handbook/linuxemu/_index.adoc b/documentation/content/ja/books/handbook/linuxemu/_index.adoc
index 5a089123ce..1e0417fc96 100644
--- a/documentation/content/ja/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/ja/books/handbook/linuxemu/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[linuxemu-synopsis]]
== この章では
diff --git a/documentation/content/ja/books/handbook/mail/_index.adoc b/documentation/content/ja/books/handbook/mail/_index.adoc
index e1bcd75847..c60eab4b89 100644
--- a/documentation/content/ja/books/handbook/mail/_index.adoc
+++ b/documentation/content/ja/books/handbook/mail/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/advanced-networking
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mail-synopsis]]
== この章では
diff --git a/documentation/content/ja/books/handbook/mirrors/_index.adoc b/documentation/content/ja/books/handbook/mirrors/_index.adoc
index 031f3fcb0e..3d872794f4 100644
--- a/documentation/content/ja/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/ja/books/handbook/mirrors/_index.adoc
@@ -11,27 +11,40 @@ tags: ["入手方法", "CD", "DVD", "FTP", "Git"]
[[mirrors]]
= FreeBSD の入手方法
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mirrors-cdrom]]
== CD および DVD セット
@@ -587,7 +600,7 @@ GeoDNS により、近くの利用可能なミラーがユーザに提供され
=== 開発者向けの説明
-link:{committers-guide}#git-mini-primer[Committer's Guide] をご覧ください。
+extref:{committers-guide}[Committer's Guide, git-mini-primer] をご覧ください。
[[external-mirrors]]
=== 外部ミラー
diff --git a/documentation/content/ja/books/handbook/multimedia/_index.adoc b/documentation/content/ja/books/handbook/multimedia/_index.adoc
index 0f1d17fc5d..bdda1c6dc6 100644
--- a/documentation/content/ja/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/ja/books/handbook/multimedia/_index.adoc
@@ -15,37 +15,35 @@ tags: ["multimedia", "sound card", "MP3", "MythTV", "scanner", "SANE"]
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[multimedia-synopsis]]
== この章では
diff --git a/documentation/content/ja/books/handbook/parti.adoc b/documentation/content/ja/books/handbook/parti.adoc
index 590f9b191d..680dbc9246 100644
--- a/documentation/content/ja/books/handbook/parti.adoc
+++ b/documentation/content/ja/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
next: books/handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[getting-started]]
= 導入
@@ -17,4 +25,4 @@ next: books/handbook/introduction
頻繁にページを飛すことなく各章を前から後へとスムーズに読み進めるように、 後方への参照を極力抑えるようにしています。
-include::content/ja/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/ja/books/handbook/partii.adoc b/documentation/content/ja/books/handbook/partii.adoc
index 216d71c251..9e7412ad3f 100644
--- a/documentation/content/ja/books/handbook/partii.adoc
+++ b/documentation/content/ja/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
next: books/handbook/desktop
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[common-tasks]]
= 日々の生活
@@ -17,4 +25,4 @@ next: books/handbook/desktop
これらの章では、読み飛ばしを推奨しているものもあります。 これについてはそれぞれの章の始めにある概要に書かれています。
-include::content/ja/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/ja/books/handbook/partiii.adoc b/documentation/content/ja/books/handbook/partiii.adoc
index 5e8eb3a0ea..9378a31588 100644
--- a/documentation/content/ja/books/handbook/partiii.adoc
+++ b/documentation/content/ja/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
next: books/handbook/config
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[system-administration]]
= システム管理
@@ -11,4 +19,4 @@ next: books/handbook/config
各章は、必要になった時に個別に参照できるように構成されています。 どの順番で読んでも構いませんし、FreeBSD を使うのに、 すべてを読み通す必要がある、というわけでもありません。
-include::content/ja/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/ja/books/handbook/partiv.adoc b/documentation/content/ja/books/handbook/partiv.adoc
index ade4a92426..1d4bdebfb9 100644
--- a/documentation/content/ja/books/handbook/partiv.adoc
+++ b/documentation/content/ja/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/cutting-edge
next: books/handbook/serialcomms
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[network-communication]]
= ネットワーク通信
@@ -18,4 +26,4 @@ FreeBSD は、 高性能なネットワークサーバとして最も広く使
各章は、必要になった時に個別に参照できるように構成されています。 どの順番で読んでも構いませんし、ネットワーク環境で FreeBSD を使うのに、 すべてを読み通す必要がある、というわけでもありません。
-include::content/ja/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/ja/books/handbook/partv.adoc b/documentation/content/ja/books/handbook/partv.adoc
index e185356174..d9b1b15a9b 100644
--- a/documentation/content/ja/books/handbook/partv.adoc
+++ b/documentation/content/ja/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
next: books/handbook/mirrors
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= 付録
-include::content/ja/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/ja/books/handbook/pgpkeys/_index.adoc b/documentation/content/ja/books/handbook/pgpkeys/_index.adoc
index 025a56812b..378f812497 100644
--- a/documentation/content/ja/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/ja/books/handbook/pgpkeys/_index.adoc
@@ -9,30 +9,46 @@ next: books/handbook/freebsd-glossary
[[pgpkeys]]
= PGP 公開鍵
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
-`FreeBSD.org` オフィサの PGP 公開鍵を以下に示します。 これらの公開鍵は、署名を検証したり、 オフィサに暗号メールを送る必要がある場合に使用できます。 すべての FreeBSD 公開鍵の一覧は、 link:{pgpkeys}[PGP Keys] にあります。 また、完全なキーリングは link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt] からダウンロードできます。
+`FreeBSD.org` オフィサの PGP 公開鍵を以下に示します。 これらの公開鍵は、署名を検証したり、 オフィサに暗号メールを送る必要がある場合に使用できます。 すべての FreeBSD 公開鍵の一覧は、 extref:{pgpkeys}[PGP Keys] にあります。 また、完全なキーリングは link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt] からダウンロードできます。
[[pgpkeys-officers]]
== オフィサ
diff --git a/documentation/content/ja/books/handbook/ports/_index.adoc b/documentation/content/ja/books/handbook/ports/_index.adoc
index 2975f73a33..efa3fa224b 100644
--- a/documentation/content/ja/books/handbook/ports/_index.adoc
+++ b/documentation/content/ja/books/handbook/ports/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/x11
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ports-synopsis]]
== この章では
@@ -598,7 +596,7 @@ Ports Collection は、ソフトウェアのカテゴリを表すディレクト
* [.filename]#pkg-plist#: これは、その port によってインストールされる全ファイルのリストです。これにはプログラムを削除する際に、どのファイルを削除すれば良いのかを ports システムに伝える役割もあります。
これらの他に [.filename]#pkg-message# や特殊な状況に対応するためのファイルを含む ports もあります。
-これらのファイルについての詳細および ports の一般的な説明については、link:{porters-handbook}[port 作成者のためのハンドブック] をご覧下さい。
+これらのファイルについての詳細および ports の一般的な説明については、extref:{porters-handbook}[port 作成者のためのハンドブック] をご覧下さい。
port は実際のソースコード ([.filename]#distfile# とも呼ばれます) を含んではいません。
port の構築の展開部で、ダウンロードされたソースは自動的に [.filename]#/usr/ports/distfiles# に保存されます。
@@ -651,7 +649,7 @@ FreeBSD のベースシステムには、Portsnap が含まれています。
*Procedure: Git を用いる方法*
ports ツリーの管理が必要な場合や、 ローカルで変更点をメンテナンスする必要がある場合、 および FreeBSD-CURRENT を使用している場合には、 Git を使って Ports Collection を取得する方法があります。
-Git のより詳細な説明については、 link:{committers-guide}#git-primer/[Git Primer] を参照してください。
+Git のより詳細な説明については、 extref:{committers-guide}[Git Primer, git-primer] を参照してください。
. Git を使って ports ツリーをチェックアウトする前に、Git をインストールしておく必要があります。
ports ツリーがすでにインストールされていれば、 以下のようにして Git をインストールできます。
@@ -1187,6 +1185,6 @@ port をうまくコンパイルできなかったりインストールできな
特に mailto:ports@FreeBSD.org[ports@FreeBSD.org] が保守している ports には、保守担当者がいません。 そのかわり、 そのメーリングリストを購読する人々からなるコミュニティが、 修正や対応をおこなっています。 もっとボランティアが必要です!
====
+
-メールに対して返信がなければ、 link:{problem-reports}[FreeBSD 障害報告の書き方] に書かれている手順にしたがい、 Bugzilla を使ってバグレポートを提出してください。
-. 自分で直しましょう! ports システムに関する詳細な情報は link:{porters-handbook}[port 作成者のためのハンドブック] にあります。 このセクションを読むと、壊れてしまった port を直したり、 自分で作った port を提出したりできるようになります!
+メールに対して返信がなければ、 extref:{problem-reports}[FreeBSD 障害報告の書き方] に書かれている手順にしたがい、 Bugzilla を使ってバグレポートを提出してください。
+. 自分で直しましょう! ports システムに関する詳細な情報は extref:{porters-handbook}[port 作成者のためのハンドブック] にあります。 このセクションを読むと、壊れてしまった port を直したり、 自分で作った port を提出したりできるようになります!
. <<pkgng-intro>> に書かれている手順にしたがって、 package をインストールしてください。
diff --git a/documentation/content/ja/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/ja/books/handbook/ppp-and-slip/_index.adoc
index d9fa2ab1a7..afe3c3a98c 100644
--- a/documentation/content/ja/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/ja/books/handbook/ppp-and-slip/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mail
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
== この章では
@@ -1176,7 +1174,7 @@ papchap:
set authkey YOURPASSWORD
....
-link:{faq}#PPPoEwithNAT[-nat オプションを付けてPPPoE ]を起動する際には注意するべきです.
+extref:{faq}[-nat オプションを付けてPPPoE, PPPoEwithNAT]を起動する際には注意するべきです.
=== PPP の起動
diff --git a/documentation/content/ja/books/handbook/preface/_index.adoc b/documentation/content/ja/books/handbook/preface/_index.adoc
index dbf30854ac..897f7c90d8 100644
--- a/documentation/content/ja/books/handbook/preface/_index.adoc
+++ b/documentation/content/ja/books/handbook/preface/_index.adoc
@@ -15,14 +15,31 @@ tags: ["preface", "audience", "organization", "conventions", "acknowledgments"]
:icons: font
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-audience]]
== 想定している読者
diff --git a/documentation/content/ja/books/handbook/printing/_index.adoc b/documentation/content/ja/books/handbook/printing/_index.adoc
index c1442b1d33..bd54ee8458 100644
--- a/documentation/content/ja/books/handbook/printing/_index.adoc
+++ b/documentation/content/ja/books/handbook/printing/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/linuxemu
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/printing/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[printing-synopsis]]
== この章では
diff --git a/documentation/content/ja/books/handbook/security/_index.adoc b/documentation/content/ja/books/handbook/security/_index.adoc
index 86238e3d72..114fadbd83 100644
--- a/documentation/content/ja/books/handbook/security/_index.adoc
+++ b/documentation/content/ja/books/handbook/security/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/disks
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-synopsis]]
== この章では
diff --git a/documentation/content/ja/books/handbook/serialcomms/_index.adoc b/documentation/content/ja/books/handbook/serialcomms/_index.adoc
index a925ec90bc..e924005641 100644
--- a/documentation/content/ja/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/ja/books/handbook/serialcomms/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ppp-and-slip
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:part-signifier: パート
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[serial-synopsis]]
== この章では
@@ -970,7 +968,7 @@ BIOS の設定でキーボードを "Not installed" にするということは
後述される `-h` オプション を無視して、(他に優先度の高いコンソールがない限り) このポートをコンソールとして指定します。 このフラグは FreeBSD バージョン 2._X_ の `COMCONSOLE` オプションに対応するものです。 フラグ `0x20` は必ず フラグ `0x10` と一緒に指定されなければなりません。
`0x40`:::
-(`0x10` と組み合わせることで) このポートを予約し、通常のアクセスができない ようにします。 このフラグは、シリアルコンソールとして使いたいポートに 指定すべきではありません。 唯一の使い道は、ユニットがカーネルのリモートデバッグ用 であることを指定することです。 リモートデバッグの詳細については link:{developers-handbook}[The Developer's Handbook] を参照してください。
+(`0x10` と組み合わせることで) このポートを予約し、通常のアクセスができない ようにします。 このフラグは、シリアルコンソールとして使いたいポートに 指定すべきではありません。 唯一の使い道は、ユニットがカーネルのリモートデバッグ用 であることを指定することです。 リモートデバッグの詳細については extref:{developers-handbook}[The Developer's Handbook] を参照してください。
+
[NOTE]
======
diff --git a/documentation/content/ja/books/handbook/users/_index.adoc b/documentation/content/ja/books/handbook/users/_index.adoc
index 7318cedba7..73d4867135 100644
--- a/documentation/content/ja/books/handbook/users/_index.adoc
+++ b/documentation/content/ja/books/handbook/users/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/security
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/users/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/users/
-endif::[]
+:images-path: books/handbook/users/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/users/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[users-synopsis]]
== この章では
diff --git a/documentation/content/ja/books/handbook/x11/_index.adoc b/documentation/content/ja/books/handbook/x11/_index.adoc
index 6babf21db2..5098a30db7 100644
--- a/documentation/content/ja/books/handbook/x11/_index.adoc
+++ b/documentation/content/ja/books/handbook/x11/_index.adoc
@@ -15,37 +15,35 @@ tags: ["X11", "Xorg", "TrueType", "DE", "KDE", "Plasma", "Xfce", "Gnome", "XDM",
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[x11-synopsis]]
== この章では
@@ -1080,7 +1078,7 @@ Compiz Fusion のインストールは簡単ですが、設定の際には、por
デスクトップ効果は、 グラフィックカードに極めて高い負荷をかけることがあります。 nVidia ベースのグラフィックカードにおいて、 良いパフォーマンスを出すには、 プロプリエタリなドライバが必要となります。 他のグラフィックカードを使っているユーザは、この節を飛ばし、 [.filename]#xorg.conf# の設定に進んでください。
-必要となる nVidia ドライバについては、 link:{faq}#idp59950544[この問題に関する FAQ ] を参照して決めてください。
+必要となる nVidia ドライバについては、 extref:{faq}[この問題に関する FAQ, idp59950544] を参照して決めてください。
使用しているカードに対する適切なドライバが決まれば、 インストール作業は他の package をインストールするのと同じように簡単です。
diff --git a/documentation/content/ja/books/porters-handbook/_index.adoc b/documentation/content/ja/books/porters-handbook/_index.adoc
index 98b520ab5a..280eb91b6c 100644
--- a/documentation/content/ja/books/porters-handbook/_index.adoc
+++ b/documentation/content/ja/books/porters-handbook/_index.adoc
@@ -3,8 +3,8 @@ title: FreeBSD port 作成者のためのハンドブック
authors:
- author: FreeBSD ドキュメンテーションプロジェクト
copyright: 2000-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "sun", "unix", "general"]
+isIndex: true
---
= FreeBSD port 作成者のためのハンドブック
@@ -12,51 +12,34 @@ trademarks: ["freebsd", "sun", "unix", "general"]
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目次
-:part-signifier: パート
-:chapter-signifier: 第
-:appendix-caption: 付録
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:book: true
+:pdf: false
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
-:chapters-path: content/ja/books/porters-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/porters-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ja/mailing-lists.adoc[]
-include::../../../../shared/ja/teams.adoc[]
-include::../../../../shared/ja/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ja/mailing-lists.adoc[]
-include::../../../../shared/ja/teams.adoc[]
-include::../../../../shared/ja/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -74,22 +57,22 @@ toc::[]
include::{chapters-path}toc-examples.adoc[]
-include::{chapters-path}why-port/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}own-port/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}slow/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}makefile/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}special/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}porting-masterdir/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}shared/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}porting-manpages/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}porting-motif/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}x11-fonts/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}porting-info/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}testing/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}port-upgrading/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}porting-autoplist/chapter.adoc[leveloffset=+1, lines=7..24;34..-1]
-include::{chapters-path}changes/chapter.adoc[leveloffset=+1, lines=6..23;33..-1]
+include::{chapters-path}why-port/chapter.adoc[leveloffset=+1]
+include::{chapters-path}own-port/chapter.adoc[leveloffset=+1]
+include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1]
+include::{chapters-path}slow/chapter.adoc[leveloffset=+1]
+include::{chapters-path}makefile/chapter.adoc[leveloffset=+1]
+include::{chapters-path}special/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-masterdir/chapter.adoc[leveloffset=+1]
+include::{chapters-path}shared/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-manpages/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-motif/chapter.adoc[leveloffset=+1]
+include::{chapters-path}x11-fonts/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-info/chapter.adoc[leveloffset=+1]
+include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1]
+include::{chapters-path}testing/chapter.adoc[leveloffset=+1]
+include::{chapters-path}port-upgrading/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-autoplist/chapter.adoc[leveloffset=+1]
+include::{chapters-path}changes/chapter.adoc[leveloffset=+1]
diff --git a/documentation/content/ja/books/porters-handbook/changes/chapter.adoc b/documentation/content/ja/books/porters-handbook/changes/chapter.adoc
index dcf104a7c5..73ef4976ef 100644
--- a/documentation/content/ja/books/porters-handbook/changes/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/changes/chapter.adoc
@@ -10,25 +10,36 @@ prev: books/porters-handbook/porting-autoplist
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
もしあなたが、たくさんの ports の保守をしているのであれば、 link:{freebsd-ports} の内容を読むことを考えてください。 ports のしくみについての重要な変更点はここに アナウンスされます。 最新の変更点については、いつでも、 http://www.FreeBSD.org/cgi/cvsweb.cgi/ports/Mk/bsd.port.mk[bsd.port.mk の CVS ログ]で詳細な情報を得ることができます。
diff --git a/documentation/content/ja/books/porters-handbook/makefile/chapter.adoc b/documentation/content/ja/books/porters-handbook/makefile/chapter.adoc
index 4ca6e91535..cf4c25d1e4 100644
--- a/documentation/content/ja/books/porters-handbook/makefile/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/makefile/chapter.adoc
@@ -11,25 +11,36 @@ next: books/porters-handbook/special
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.filename]#Makefile# の作成は非常に単純です。 繰り返しますが、始めるまえに既存の例を見ておくことを推奨します。 また、このハンドブックには <<porting-samplem,Makefile のサンプル>>があります。 それを見て、Makefile 内の変数の順番や 空行を入れるところなどの参考にしてください。 そうすると他の人々にも読みやすいものとなります。
@@ -1035,7 +1046,7 @@ PATCHFILES= patch1:test
`MAINTAINER` の値は、コメント部のない単一のアドレスしか受け付けられません。 `user@hostname.domain` という形式を利用してください。この項目には、 あなたの本名などの説明用のテキストは一切いれないでください。 (そうしても、ただ [.filename]#bsd.port.mk# が混乱するだけです)。そういう情報は [.filename]#pkg-descr# に書いてください。
-保守担当者 (maintainer) の責任に関する詳細説明は、 link:{developers-handbook}#POLICIES-MAINTAINER[ Makefile 中の MAINTAINER] の セクションを参照してください。
+保守担当者 (maintainer) の責任に関する詳細説明は、 extref:{developers-handbook}[Makefile 中の MAINTAINER, POLICIES-MAINTAINER] の セクションを参照してください。
Port のメンテナがユーザからの更新要求に (主な公休日を除いて) 2 週間返答しなかったら、 保守担当者の持ち時間が切れたとみなして、 保守担当者の明示的な了承なしに更新して構いません。 保守担当者が 3 ヶ月以内に返答しない場合は、 その保守担当者は無断で不在にしているとみなして、 問題となっている port の保守担当者を入れ替えても構いません。 例外となるは、{portmgr} または {security-officer} が保守しているものです。このグループが保守している port に対しては許可を得ずにコミットしてはいけません。
diff --git a/documentation/content/ja/books/porters-handbook/own-port/chapter.adoc b/documentation/content/ja/books/porters-handbook/own-port/chapter.adoc
index 8b7923dbea..3a18b9b46b 100644
--- a/documentation/content/ja/books/porters-handbook/own-port/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/own-port/chapter.adoc
@@ -11,25 +11,36 @@ next: books/porters-handbook/quick-porting
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
自分で port を作ることや、既存の port の 更新作業に興味があるのですか。それはすばらしい!
diff --git a/documentation/content/ja/books/porters-handbook/pkg-files/chapter.adoc b/documentation/content/ja/books/porters-handbook/pkg-files/chapter.adoc
index 991c285a11..d1f7c7498c 100644
--- a/documentation/content/ja/books/porters-handbook/pkg-files/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/pkg-files/chapter.adoc
@@ -11,25 +11,36 @@ next: books/porters-handbook/testing
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.filename]#pkg-*# ファイルには、 まだ取り上げていない何かと重宝なトリックがいくつかあります。
diff --git a/documentation/content/ja/books/porters-handbook/port-upgrading/chapter.adoc b/documentation/content/ja/books/porters-handbook/port-upgrading/chapter.adoc
index 348a93ddaf..4b0ed3c6ba 100644
--- a/documentation/content/ja/books/porters-handbook/port-upgrading/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/port-upgrading/chapter.adoc
@@ -11,27 +11,38 @@ next: books/porters-handbook/porting-dads
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
-port のバージョンが原作者からのものに比べて古いことに気がついたら、 まずはあなたの持っている port が私たちの最新のもの (最新の port は FreeBSD FTP ミラーサイトの [.filename]#ports/ports-current# というディレクトリにあります) であることを確認してください。 また、Ports Collection 全体を最新の状態に保つために CVSup を利用することもできます。 詳しくは link:{handbook}#CVSUP-CONFIG[FreeBSD ハンドブック]をご覧ください。
+port のバージョンが原作者からのものに比べて古いことに気がついたら、 まずはあなたの持っている port が私たちの最新のもの (最新の port は FreeBSD FTP ミラーサイトの [.filename]#ports/ports-current# というディレクトリにあります) であることを確認してください。 また、Ports Collection 全体を最新の状態に保つために CVSup を利用することもできます。 詳しくは extref:{handbook}[FreeBSD ハンドブック, CVSUP-CONFIG]をご覧ください。
次に port の [.filename]#Makefile# に `MAINTAINER` (保守担当者) のアドレスが書いてある場合には、その人にメールを出してみましょう。 保守担当者の人がすでにアップグレードの準備をしているかも知れませんし、 (新しいバージョンの安定度に問題があるなど) あえてアップグレードをしない理由があるのかも知れません。 その人たちと作業を重複させたくはないでしょう。 なお、保守されていない ports は、保守担当者が `ports@FreeBSD.org` になっています。その場合は、 そのアドレスにメールを送っても役に立たないでしょう。
@@ -39,7 +50,7 @@ port のバージョンが原作者からのものに比べて古いことに気
差分を送る一番良い方法は man:send-pr[1] (カテゴリは `ports`) に diff の出力結果を添えて、わたしたちに送ってもらうのが一番良いです。 commit する際に CVS に明確に記述しなければならないので、 あなたがその port のメンテナになるなら、概要 (synopsis) 行の先頭に `[maintainer update]` と記入し、PR の "Class" を `maintainer-update` にしてください。 付け加えたり削除したりしたファイルがあればそれについて書いておいてください。 もし diff の大きさが 20 KB 程度を超えるようであれば、 圧縮したものを uuencode してください。 そうでなければそのまま PR に入れるだけで構いません。
-最後に、役に立つ障害報告の書き方について詳しいことは、 障害報告についての記事の link:{problem-reports}#pr-writing/[ 障害報告の書き方]の節を読んでください。
+最後に、役に立つ障害報告の書き方について詳しいことは、 障害報告についての記事の extref:{problem-reports}[障害報告の書き方, pr-writing]の節を読んでください。
[IMPORTANT]
====
diff --git a/documentation/content/ja/books/porters-handbook/porting-autoplist/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-autoplist/chapter.adoc
index ef282da537..6c4af2a27f 100644
--- a/documentation/content/ja/books/porters-handbook/porting-autoplist/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/porting-autoplist/chapter.adoc
@@ -11,25 +11,36 @@ next: books/porters-handbook/changes
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
まず、あなたの port に [.filename]#pkg-plist# がないことを除けば完成していることを確認してください。
diff --git a/documentation/content/ja/books/porters-handbook/porting-dads/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-dads/chapter.adoc
index 90ff27fdd5..520fb3da22 100644
--- a/documentation/content/ja/books/porters-handbook/porting-dads/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/porting-dads/chapter.adoc
@@ -11,30 +11,41 @@ next: books/porters-handbook/porting-samplem
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dads-intro]]
== はじめに
-このセクションではソフトウェアを port する上で、 良くある落し穴などについて説明します。 このリストを使ってあなた自身が作成した port のチェックはもとより、 さらにlink:http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[障害報告データベース] にある他の人が提出した port のチェックもできます。 PR データベースにある、 他の人が作成した port のチェックもできます。 あなたがチェックした port についてのコメントをlink:{contributing}#CONTRIB-GENERAL[ バグ報告と一般的な論評]にしたがって送ってください。 PR データベースにある port をチェックすることは、 わたしたちがそれらを commit するのを早めるとともに、 何をしているかをあなたが理解していることも証明します。
+このセクションではソフトウェアを port する上で、 良くある落し穴などについて説明します。 このリストを使ってあなた自身が作成した port のチェックはもとより、 さらにlink:http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[障害報告データベース] にある他の人が提出した port のチェックもできます。 PR データベースにある、 他の人が作成した port のチェックもできます。 あなたがチェックした port についてのコメントをextref:{contributing}[ バグ報告と一般的な論評, CONTRIB-GENERAL]にしたがって送ってください。 PR データベースにある port をチェックすることは、 わたしたちがそれらを commit するのを早めるとともに、 何をしているかをあなたが理解していることも証明します。
[[dads-strip]]
== バイナリの strip
@@ -66,7 +77,7 @@ post-install:
[[porting-wrkdir]]
== `WRKDIR`
-`WRKDIR` の外に存在するファイルには何も書き込んではいけません。 port のビルド中に書き込み可能なことが保証されているのは `WRKDIR` の中だけです (書き込み不可のツリー上での port ビルドの例については、 link:{handbook}#PORTS-CD[CDROM からの ports のインストール] を参照のこと)。 [.filename]#pkg-*# ファイルを変更する必要があるときには、 ファイルを上書きするのではなく <<porting-pkgfiles,変数の再定義>>により 行なうようにしてください。
+`WRKDIR` の外に存在するファイルには何も書き込んではいけません。 port のビルド中に書き込み可能なことが保証されているのは `WRKDIR` の中だけです (書き込み不可のツリー上での port ビルドの例については、 extref:{handbook}ports[CDROM からの ports のインストール, PORTS-CD] を参照のこと)。 [.filename]#pkg-*# ファイルを変更する必要があるときには、 ファイルを上書きするのではなく <<porting-pkgfiles,変数の再定義>>により 行なうようにしてください。
[[porting-wrkdirprefix]]
== `WRKDIRPREFIX`
diff --git a/documentation/content/ja/books/porters-handbook/porting-info/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-info/chapter.adoc
index dff1ce6ecb..781d483c75 100644
--- a/documentation/content/ja/books/porters-handbook/porting-info/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/porting-info/chapter.adoc
@@ -11,24 +11,35 @@ next: books/porters-handbook/pkg-files
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
あなたが作成している package で GNU info ファイルをインストールする必要があれば、それを `INFO` 変数に (後ろの `.info` なしで) 書いてください。package 登録の前に一時的に生成された [.filename]#pkg-plist# に、 適切なインストールおよびアンインストールコードが自動的に追加されます。
diff --git a/documentation/content/ja/books/porters-handbook/porting-manpages/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-manpages/chapter.adoc
index 1a5525ddd2..2d72b212b6 100644
--- a/documentation/content/ja/books/porters-handbook/porting-manpages/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/porting-manpages/chapter.adoc
@@ -11,25 +11,36 @@ next: books/porters-handbook/porting-motif
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
`MAN[1-9LN]` 変数に指定したマニュアルは 自動的に [.filename]#pkg-plist# に追加されます (つまり、マニュアルを [.filename]#pkg-plist# に加えては__いけません__- <<porting-plist,pkg-plist の生成>>を参照してください)。 また、[.filename]#/etc/make.conf# 中の `NOMANCOMPRESS` の設定に従って、インストール時に マニュアルを自動的に圧縮したり復元したりします。
diff --git a/documentation/content/ja/books/porters-handbook/porting-masterdir/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-masterdir/chapter.adoc
index 27cdc0845a..d9a60f6325 100644
--- a/documentation/content/ja/books/porters-handbook/porting-masterdir/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/porting-masterdir/chapter.adoc
@@ -11,25 +11,36 @@ next: books/porters-handbook/shared
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
その port の変数 (たとえば解像度とか紙のサイズなど) を 変えたりした、少しだけ違うバージョンを作成する必要があるときには、 ユーザが分りやすいように package ごとに別々のサブディレクトリを作成し、 できるだけ port 間でファイルを共有するようにしてください。 ほとんどの場合、うまく変数を使えば、一つを除くすべてのディレクトリには とても短い [.filename]#Makefile# を置くだけで済みます。 その短い [.filename]#Makefile# では、 `MASTERDIR` を使って、 残りのファイルがあるディレクトリを指定できます。 また、<<porting-pkgname,`PKGNAMESUFFIX`>> の 一部に変数に使って、package が別々の名前を持つようにしてください。
diff --git a/documentation/content/ja/books/porters-handbook/porting-motif/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-motif/chapter.adoc
index e90b9ca864..0df2dd4ccc 100644
--- a/documentation/content/ja/books/porters-handbook/porting-motif/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/porting-motif/chapter.adoc
@@ -11,25 +11,36 @@ next: books/porters-handbook/x11-fonts
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
コンパイルに Motif ライブラリを必要とするアプリケーションがいくつかあります (Motif 自体は有料のものがいくつかの会社から手に入りますし、 package:x11-toolkits/lesstif[] には多くのアプリケーションを動作させることが可能な無料の互換ライブラリもあります)。 Motif は広く使われているツールキットですし、 有料のもののライセンスでもライブラリを静的にリンクした実行形式の再配布が認められている場合が多いので、 Motif を必要とするソフトウェアを簡単に (port からコンパイルする人々のために) 動的にでも、 (package を配布する人々のために) 静的にでもリンクできるような仕組みが用意されています。
diff --git a/documentation/content/ja/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/ja/books/porters-handbook/porting-samplem/chapter.adoc
index 205897a7c1..a661ac6fa1 100644
--- a/documentation/content/ja/books/porters-handbook/porting-samplem/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/porting-samplem/chapter.adoc
@@ -11,25 +11,36 @@ next: books/porters-handbook/porting-autoplist
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
これは port の [.filename]#Makefile# を作る際のお手本です。 かぎかっこ ([]) 内のコメントは忘れずに取ってください。
diff --git a/documentation/content/ja/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/ja/books/porters-handbook/quick-porting/chapter.adoc
index 7b3d2f3b45..94a47ae8a0 100644
--- a/documentation/content/ja/books/porters-handbook/quick-porting/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/quick-porting/chapter.adoc
@@ -11,25 +11,36 @@ next: books/porters-handbook/slow
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
このセクションでは、簡単な port の作り方について説明します。 多くの場合、これだけでは不十分なので、 この文書の続きを読まなければならないでしょう。
@@ -167,7 +178,7 @@ package 化も含め、その port が思った通りに 動くことを確認
まず、<<porting-dads, やって良いこと悪いこと>>の セクションを読んでください。
-さて、満足のいく port が完成したら、残るは それを FreeBSD のメインの ports ツリーに置いて、 他の人にも使ってもらうだけです。 [.filename]#work# ディレクトリや [.filename]#pkgname.tgz# といった package は 必要ありませんから、まずこれらを消去してください。 あとは `shar find port_dir` の出力を バグレポートに入れ、man:send-pr[1] プログラムを使用して 送ってください (man:send-pr[1] についての詳細はlink:{contributing}#CONTRIB-GENERAL[ バグ報告と一般的な論評]を参照してください)。 もし、圧縮していない状態で 20KB 以上あるような port であれば、 それを ひとつの tar ファイルにまとめて圧縮し、 バグレポートに入れる前に man:uuencode[1] を使用してください (20KB 以下のものを tar ファイルにして送っても良いのですが、 あまり歓迎されません)。 バクレポートの category は必ず `ports`, class は `change-request` としてください (レポートを `confidential` (機密) 指定には しないでください!)。 また、port 化したプログラムの短い説明文を バグレポートの "Description" フィールドに追加して、 "Fix" フィールドには shar したファイル、 もしくは uuencode した tar ファイルを追加するようにしてください。
+さて、満足のいく port が完成したら、残るは それを FreeBSD のメインの ports ツリーに置いて、 他の人にも使ってもらうだけです。 [.filename]#work# ディレクトリや [.filename]#pkgname.tgz# といった package は 必要ありませんから、まずこれらを消去してください。 あとは `shar find port_dir` の出力を バグレポートに入れ、man:send-pr[1] プログラムを使用して 送ってください (man:send-pr[1] についての詳細はextref:{contributing}[ バグ報告と一般的な論評, CONTRIB-GENERAL]を参照してください)。 もし、圧縮していない状態で 20KB 以上あるような port であれば、 それを ひとつの tar ファイルにまとめて圧縮し、 バグレポートに入れる前に man:uuencode[1] を使用してください (20KB 以下のものを tar ファイルにして送っても良いのですが、 あまり歓迎されません)。 バクレポートの category は必ず `ports`, class は `change-request` としてください (レポートを `confidential` (機密) 指定には しないでください!)。 また、port 化したプログラムの短い説明文を バグレポートの "Description" フィールドに追加して、 "Fix" フィールドには shar したファイル、 もしくは uuencode した tar ファイルを追加するようにしてください。
[NOTE]
====
@@ -178,4 +189,4 @@ package 化も含め、その port が思った通りに 動くことを確認
port を提出したら、辛抱強くお待ちください。時には、ある port が FreeBSD に取り込まれるまで、数日しかかかりそうもないの に、数ヶ月かかることもあります。link:http://www.FreeBSD.org/cgi/query-pr-summary.cgi?category=ports[FreeBSD へのコミット待ちの ports] の一覧が見られます。
-わたしたちがひとたびその port をチェックしたら、必要なら あなたに確認して、それをツリーへ置きます。 あなたの名前はlink:{contributors}#contrib-additional/[その他の FreeBSD への貢献者]の一覧やその他のファイルにも載るでしょう。 う~ん、素晴らしい。:-)
+わたしたちがひとたびその port をチェックしたら、必要なら あなたに確認して、それをツリーへ置きます。 あなたの名前はextref:{contributors}[その他の FreeBSD への貢献者, contrib-additional]の一覧やその他のファイルにも載るでしょう。 う~ん、素晴らしい。:-)
diff --git a/documentation/content/ja/books/porters-handbook/shared/chapter.adoc b/documentation/content/ja/books/porters-handbook/shared/chapter.adoc
index 51f505375d..5c7c4cba3e 100644
--- a/documentation/content/ja/books/porters-handbook/shared/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/shared/chapter.adoc
@@ -11,24 +11,35 @@ next: books/porters-handbook/porting-manpages
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
-まずlink:{developers-handbook}#policies-shlib/[ 共有ライブラリのバージョンについての指針]を読んで、 一般的に共有ライブラリのバージョンをどうすれば良いかを理解してください。 ソフトウェアの作者は自分がしていることを理解していると、 盲目的に信じていてはいけません。多くの場合は理解していないのです。 細部にわたって注意深く考慮することは大変重要です。なぜなら我々は、 互換性がないかもしれない大量のソフトウェアを共存させようとする特殊な状況にあるからです。 むかし、不注意な port の導入が共有ライブラリに関する重大な問題を引き起してしまったことがあります (なぜ [.filename]#jpeg-6b# の共有ライブラリのバージョン番号が 9 なのか、今まで不思議に思ったことはありませんか?)。 もし疑問があれば、link:{freebsd-ports} にメールを送ってください。 ほとんどの時間は正しい共有ライブラリのバージョンを決めることと、 それを実現するためのパッチを作成することに終始します。
+まずextref:{developers-handbook}[ 共有ライブラリのバージョンについての指針, policies-shlib]を読んで、 一般的に共有ライブラリのバージョンをどうすれば良いかを理解してください。 ソフトウェアの作者は自分がしていることを理解していると、 盲目的に信じていてはいけません。多くの場合は理解していないのです。 細部にわたって注意深く考慮することは大変重要です。なぜなら我々は、 互換性がないかもしれない大量のソフトウェアを共存させようとする特殊な状況にあるからです。 むかし、不注意な port の導入が共有ライブラリに関する重大な問題を引き起してしまったことがあります (なぜ [.filename]#jpeg-6b# の共有ライブラリのバージョン番号が 9 なのか、今まで不思議に思ったことはありませんか?)。 もし疑問があれば、link:{freebsd-ports} にメールを送ってください。 ほとんどの時間は正しい共有ライブラリのバージョンを決めることと、 それを実現するためのパッチを作成することに終始します。
diff --git a/documentation/content/ja/books/porters-handbook/slow/chapter.adoc b/documentation/content/ja/books/porters-handbook/slow/chapter.adoc
index 9ebc29c65c..a22f196cc5 100644
--- a/documentation/content/ja/books/porters-handbook/slow/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/slow/chapter.adoc
@@ -11,25 +11,36 @@ next: books/porters-handbook/makefile
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
残念ながら移植がそう簡単ではなく、それを動かすために 多少の変更が必要になる場合もあるでしょう。 このセクションでは、模範的な ports の作法に従い、 どのように変更を行なって動くようにするのかを 順を追って説明します。
diff --git a/documentation/content/ja/books/porters-handbook/special/chapter.adoc b/documentation/content/ja/books/porters-handbook/special/chapter.adoc
index 8c0b5107d0..35cd46b305 100644
--- a/documentation/content/ja/books/porters-handbook/special/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/special/chapter.adoc
@@ -11,25 +11,36 @@ next: books/porters-handbook/porting-masterdir
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
port を作成する場合、 考慮しなくてはいけないことが他にもいくつかあります。 このセクションでは、それらのうちでも特によくあることについて説明します。
diff --git a/documentation/content/ja/books/porters-handbook/testing/chapter.adoc b/documentation/content/ja/books/porters-handbook/testing/chapter.adoc
index 8ff58b7d3a..fec61ced9b 100644
--- a/documentation/content/ja/books/porters-handbook/testing/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/testing/chapter.adoc
@@ -11,25 +11,36 @@ next: books/porters-handbook/port-upgrading
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[testing-portlint]]
== portlint
diff --git a/documentation/content/ja/books/porters-handbook/why-port/chapter.adoc b/documentation/content/ja/books/porters-handbook/why-port/chapter.adoc
index 249e85008b..47e3eee580 100644
--- a/documentation/content/ja/books/porters-handbook/why-port/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/why-port/chapter.adoc
@@ -11,25 +11,36 @@ next: books/porters-handbook/own-port
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
FreeBSD Ports Collection は、ほとんどの人が FreeBSD でアプリケーション ("ports") をインストールする手段です。 FreeBSD に関する他のすべてと同じく、 これも基本的にボランティア活動によるものです。 この文書を読む際には必ずこのことを念頭においてください。
diff --git a/documentation/content/ja/books/porters-handbook/x11-fonts/chapter.adoc b/documentation/content/ja/books/porters-handbook/x11-fonts/chapter.adoc
index c9e5519015..03d7bfce8c 100644
--- a/documentation/content/ja/books/porters-handbook/x11-fonts/chapter.adoc
+++ b/documentation/content/ja/books/porters-handbook/x11-fonts/chapter.adoc
@@ -11,24 +11,35 @@ next: books/porters-handbook/porting-info
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-:toc-title: 目次
-:table-caption: 表
-:figure-caption: 図
-:example-caption: 例
+:images-path: books/porters-handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ja/mailing-lists.adoc[]
-include::shared/ja/teams.adoc[]
-include::shared/ja/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
もし、あなたの port が X Window System のフォントをインストールするのであれば、 それらを [.filename]#X11BASE/lib/X11/fonts/local# に置くようにしてください。このディレクトリは XFree86 3.3.3 で新設されたものです。 このディレクトリが存在しなければ作成して、ユーザに XFree86 を 3.3.3 かそれより新しいものに更新するか、 少なくともこのディレクトリを [.filename]#/etc/XF86Config# のフォントパスに加えるように促すメッセージを出力するようにしてください。
diff --git a/documentation/content/ko/articles/bsdl-gpl/_index.adoc b/documentation/content/ko/articles/bsdl-gpl/_index.adoc
index d5017fa481..22f21f229f 100644
--- a/documentation/content/ko/articles/bsdl-gpl/_index.adoc
+++ b/documentation/content/ko/articles/bsdl-gpl/_index.adoc
@@ -3,7 +3,6 @@ title: 오픈 소스 프로젝트에 BSD 형식의 라이선스를 사용해야
authors:
- author: Bruce Montague
email: brucem@alumni.cse.ucsc.edu
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "intel", "general"]
---
@@ -16,10 +15,27 @@ trademarks: ["freebsd", "intel", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 차례
-:table-caption: 표
-:figure-caption: 그림
-:example-caption: 예시
+:images-path: articles/bsdl-gpl/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
'''
diff --git a/documentation/content/ko/articles/contributing/_index.adoc b/documentation/content/ko/articles/contributing/_index.adoc
index 5802e87a60..4d37f66969 100644
--- a/documentation/content/ko/articles/contributing/_index.adoc
+++ b/documentation/content/ko/articles/contributing/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Jordan Hubbard
- author: Sam Lawrance
- author: Mark Linimon
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ieee", "general"]
---
@@ -17,21 +16,26 @@ trademarks: ["freebsd", "ieee", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 차례
-:table-caption: 표
-:figure-caption: 그림
-:example-caption: 예시
-
-ifeval::["{backend}" == "html5"]
-include::shared/ko/urls.adoc[]
+:images-path: articles/contributing/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/ko/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/ko/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -64,7 +68,7 @@ FreeBSD에 관련된 사업을 하고 있는 기업들도 우리에게 연락할
FreeBSD에 관여하는 사람들 중에는 프로그래머가 아닌 사람들도 많습니다. 프로젝트에는 문서 작성자, 웹 디자이너, 기타 도움을 주는 사람들도 포함되어 있습니다. 이들이 기여하는 데에는 시간 투자와 배우려는 의지만 있으면 됩니다.
. FAQ와 Handbook을 주기적으로 읽어 보세요. 만약 무언가가 어색하게 설명되어 있거나, 너무 오래 되었거나 심지어 완전히 잘못되어 있다면, 우리에게 알려 주세요. 직접 고친 내용을 보내 주신다면 더욱 좋습니다(DocBook은 배우기 어렵지 않습니다만, 그냥 ASCII 형식으로 보내 주셔도 괜찮습니다).
-. FreeBSD 문서를 여러분의 모국어로 번역하는 것을 도와 주세요. 만약 문서가 이미 여러분의 언어로 존재한다면, 다른 문서를 추가적으로 번역하거나 번역본이 최신 상태인지를 점검해 보는 것도 좋습니다. 먼저 FreeBSD Documentation Project Primer의 link:{fdp-primer}#translations[Translation FAQ]를 살펴 보세요. 여러분은 모든 FreeBSD 문서를 다 번역하는 데 헌신할 필요는 없습니다 -- 자원봉사자로서, 여러분은 원하는 만큼 많은 또는 적은 양을 번역할 수 있습니다. 한번 누군가가 번역을 시작하면, 다른 사람들은 거의 항상 그 노력에 동참합니다. 만약 여러분이 문서의 일부만을 번역할 시간 또는 노력밖에 없다면, 설치 과정 부분을 번역해 주세요.
+. FreeBSD 문서를 여러분의 모국어로 번역하는 것을 도와 주세요. 만약 문서가 이미 여러분의 언어로 존재한다면, 다른 문서를 추가적으로 번역하거나 번역본이 최신 상태인지를 점검해 보는 것도 좋습니다. 먼저 FreeBSD Documentation Project Primer의 extref:{fdp-primer}[Translation FAQ, translations]를 살펴 보세요. 여러분은 모든 FreeBSD 문서를 다 번역하는 데 헌신할 필요는 없습니다 -- 자원봉사자로서, 여러분은 원하는 만큼 많은 또는 적은 양을 번역할 수 있습니다. 한번 누군가가 번역을 시작하면, 다른 사람들은 거의 항상 그 노력에 동참합니다. 만약 여러분이 문서의 일부만을 번역할 시간 또는 노력밖에 없다면, 설치 과정 부분을 번역해 주세요.
. http://lists.FreeBSD.org/mailman/listinfo/freebsd-questions[FreeBSD general questions mailing list]를 종종 (또는 심지어 정기적으로) 읽어 주세요. 여러분의 전문 지식을 나누고 사람들이 문제를 해결하도록 도와 주는 일은 대단히 만족스러울 수 있습니다; 여러분은 심지어 종종 스스로 새로운 것을 배울 수도 있습니다! 이 포럼들은 할 일들의 아이디어의 원천이 되기도 합니다.
[[ongoing-programmer-tasks]]
@@ -97,7 +101,7 @@ https://bugs.FreeBSD.org/search/[FreeBSD PR list]는 FreeBSD 사용자에 의해
포트 트리를 최신 상태로 유지하고 잘 동작할 수 있도록 유지하기 위해 할 수 있는 여러 쉬운 방법들이 있습니다:
-* 멋지거나 유용한 소프트웨어를 찾아 link:{porters-handbook}[포트를 만들어] 주세요.
+* 멋지거나 유용한 소프트웨어를 찾아 extref:{porters-handbook}[포트를 만들어] 주세요.
* 관리자가 없는 포트들이 많이 있습니다. 관리자가 되어 <<adopt-port>>해 주세요.
* 만약 여러분이 포트를 만들었거나 관리하기로 마음먹었다면, <<maintain-port>>에 대해 알아 보세요.
* 좀더 빠르게 끝낼 수 있는 일을 찾고 있다면 <<fix-broken>> 주세요.
@@ -120,15 +124,15 @@ _일반적인_ 기술적 관심사에 대한 아이디어나 제안은 http://li
report를 제출한 이후에, 여러분은 tracking number가 있는 확인 메일을 받을 겁니다. 이 문제에 대한 상세한 사항을 업데이트할 수 있도록 tracking number를 보관해 두세요.
-좋은 problem report를 작성하기 위해서는 link:{problem-reports}[이 article]을 참고하세요.
+좋은 problem report를 작성하기 위해서는 extref:{problem-reports}[이 article]을 참고하세요.
=== 문서 수정하기
-문서의 편집은 http://lists.FreeBSD.org/mailman/listinfo/freebsd-doc[FreeBSD documentation project mailing list]에 의해 관리됩니다. 전체적인 방법에 대해서는 link:{fdp-primer}[FreeBSD Documentation Project Primer]를 참고해 주세요. 다른 버그 리포트와 같은 방법을 사용해서 제출 및 편집(사소한 것이라도 환영합니다!) 내용을 보내 주세요.
+문서의 편집은 http://lists.FreeBSD.org/mailman/listinfo/freebsd-doc[FreeBSD documentation project mailing list]에 의해 관리됩니다. 전체적인 방법에 대해서는 extref:{fdp-primer}[FreeBSD Documentation Project Primer]를 참고해 주세요. 다른 버그 리포트와 같은 방법을 사용해서 제출 및 편집(사소한 것이라도 환영합니다!) 내용을 보내 주세요.
=== 기존 소스 코드 수정하기
-기존의 소스 코드에 무언가를 추가하거나 수정하는 것은 까다로운 작업이며 여러분이 FreeBSD 개발의 최신 상태로부터 얼마나 멀리 떨어져 있느냐에 따라 크게 영향을 받습니다. 시스템에 대해 활동적으로 작업하는 개발자들의 여러 편의를 위해 만들어진 "FreeBSD-CURRENT"라는 특별한 on-going 릴리즈가 있습니다. FreeBSD-CURRENT를 설치하고 사용하는 방법에 대한 정보는 link:{handbook}#current-stable[The FreeBSD Handbook]에서 찾아볼 수 있습니다.
+기존의 소스 코드에 무언가를 추가하거나 수정하는 것은 까다로운 작업이며 여러분이 FreeBSD 개발의 최신 상태로부터 얼마나 멀리 떨어져 있느냐에 따라 크게 영향을 받습니다. 시스템에 대해 활동적으로 작업하는 개발자들의 여러 편의를 위해 만들어진 "FreeBSD-CURRENT"라는 특별한 on-going 릴리즈가 있습니다. FreeBSD-CURRENT를 설치하고 사용하는 방법에 대한 정보는 extref:{handbook}updating-upgrading[The FreeBSD Handbook, current-stable]에서 찾아볼 수 있습니다.
오래된 소스로 작업하는 것은 불행히도 여러분의 수정이 종종 이미 필요없게 되거나 FreeBSD에 적용되기에 어려울 수도 있다는 것을 의미합니다. 시스템의 최신 상태에 대한 논의가 이루어지는 http://lists.FreeBSD.org/mailman/listinfo/freebsd-announce[FreeBSD announcements mailing list]와 http://lists.FreeBSD.org/mailman/listinfo/freebsd-current[FreeBSD-CURRENT mailing list] 리스트를 구독하면, 이러한 가능성을 최소화할 수 있습니다.
@@ -212,7 +216,7 @@ FreeBSD 프로젝트는 유용하게 사용될 수 있는 하드웨어의 기부
==== 포트를 책임지는 방법
-우선 <<maintain-port>>에 대해 명확히 이해해야 합니다. 또 link:{porters-handbook}[Porter's Handbook]을 읽어 보세요. _여러분이 편안하게 다룰 수 있을 범위를 넘어서서 무리할 필요는 없습니다._
+우선 <<maintain-port>>에 대해 명확히 이해해야 합니다. 또 extref:{porters-handbook}[Porter's Handbook]을 읽어 보세요. _여러분이 편안하게 다룰 수 있을 범위를 넘어서서 무리할 필요는 없습니다._
여러분은 원한다면 관리되지 않는 포트의 관리 권한을 언제든지 요청할 수 있습니다. 그냥 `MAINTAINER` 을 여러분의 이메일 주소로 설정하고 해당 내용을 PR(Problem Report)로 보내 주세요. 포트에 빌드 에러가 있거나 업데이트가 필요하다면, 같은 PR에 그러한 수정 내용을 포함해도 좋습니다. 많은 커미터들은 FreeBSD에 남긴 흔적이 없는 누군가에게 관리 권한을 부여하고 싶어하지 않기 때문에, 이는 도움이 되는 행동일 것입니다. 빌드 오류를 고치거나 포트를 업데이트하는 PR을 제출하는 것은 이러한 흔적을 남기는 가장 좋은 방법입니다.
@@ -252,7 +256,7 @@ FreeBSD 프로젝트는 유용하게 사용될 수 있는 하드웨어의 기부
이 항목은 여러분의 포트를 최신 상태로 유지시키기 위한 과정을 설명하고 있습니다.
-이것은 개괄적인 내용입니다. 포트를 업그레이드하는 것에 대한 더 자세한 정보는 link:{porters-handbook}[Porter's Handbook]에서 찾아볼 수 있습니다.
+이것은 개괄적인 내용입니다. 포트를 업그레이드하는 것에 대한 더 자세한 정보는 extref:{porters-handbook}[Porter's Handbook]에서 찾아볼 수 있습니다.
[.procedure]
====
@@ -276,11 +280,11 @@ FreeBSD 프로젝트는 유용하게 사용될 수 있는 하드웨어의 기부
. 수정 내용 제출하기
+
-수정 사항에 대한 설명 및 원본과 수정본 사이의 변경 내역을 포함한 패치를 담은 PR을 통해 여러분의 업데이트를 보내 주세요. 좋은 PR을 작성하는 방법에 대한 내용은 link:{problem-reports}[Writing FreeBSD Problem Reports]를 참조해 주세요.
+수정 사항에 대한 설명 및 원본과 수정본 사이의 변경 내역을 포함한 패치를 담은 PR을 통해 여러분의 업데이트를 보내 주세요. 좋은 PR을 작성하는 방법에 대한 내용은 extref:{problem-reports}[Writing FreeBSD Problem Reports]를 참조해 주세요.
+
[NOTE]
======
-포트 전체에 대한 man:shar[1] 아카이브를 제출하지는 말아 주세요; 그 대신에, man:diff[1] `-ruN` 를 사용해 주세요. 이렇게 하면, 정확히 무엇이 수정되었는지 커미터들이 훨씬 쉽게 파악할 수 있습니다. Porter's Handbook에 있는 link:{porters-handbook}#port-upgrading[Upgrading] 항목에서 더 많은 정보를 찾아볼 수 있습니다.
+포트 전체에 대한 man:shar[1] 아카이브를 제출하지는 말아 주세요; 그 대신에, man:diff[1] `-ruN` 를 사용해 주세요. 이렇게 하면, 정확히 무엇이 수정되었는지 커미터들이 훨씬 쉽게 파악할 수 있습니다. Porter's Handbook에 있는 extref:{porters-handbook}[Upgrading, port-upgrading] 항목에서 더 많은 정보를 찾아볼 수 있습니다.
======
. 기다리기
+
@@ -412,9 +416,9 @@ FreeBSD에 특정한 버그는 일반적으로 FreeBSD에는 적용되지 않는
[[resources]]
=== 포트 관리자와 기여자를 위한 자료
-link:{porters-handbook}[Porter's Handbook]은 포트 시스템을 여행하는 히치하이커를 위한 안내서입니다. 곁에 두고 자주 살펴 보세요!
+extref:{porters-handbook}[Porter's Handbook]은 포트 시스템을 여행하는 히치하이커를 위한 안내서입니다. 곁에 두고 자주 살펴 보세요!
-link:{problem-reports}[Writing FreeBSD Problem Reports]은 훌륭한 PR을 작성하고 제출하는 방법에 대해서 설명합니다. 2005년에는 11000개 이상의 포트 PR이 제출되었습니다! 이 글을 따라하는 것은 여러분의 PR을 다루는 데 필요한 시간을 절약해 준다는 점에서 큰 도움이 됩니다.
+extref:{problem-reports}[Writing FreeBSD Problem Reports]은 훌륭한 PR을 작성하고 제출하는 방법에 대해서 설명합니다. 2005년에는 11000개 이상의 포트 PR이 제출되었습니다! 이 글을 따라하는 것은 여러분의 PR을 다루는 데 필요한 시간을 절약해 준다는 점에서 큰 도움이 됩니다.
http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[Problem Report database].
@@ -424,6 +428,6 @@ http://portscout.FreeBSD.org[FreeBSD Ports distfile scanner]는 distfiles를 다
package:ports-mgmt/poudriere[] 는 포트의 설치, 패키징, 그리고 제거까지의 전 과정을 전체적으로 테스트해볼 수 있는 방법입니다. 관련된 문서는 https://fossil.etoilebsd.net/poudriere/[poudriere home page]에서 찾아볼 수 있습니다.
-man:portlint[1]는 여러분의 포트가 많은 중요한 외형적 그리고 기능적 지침을 준수하고 있는지를 검증하는 데 사용되는 애플리케이션입니다. portlint 는 단순한 휴리스틱 애플리케이션이기 때문에, 여러분은 이를 _지침서의 역할로만_ 사용해야 합니다. 만약 portlint 가 합리적이지 않아 보이는 수정을 제안한다면, link:{porters-handbook}[Porter's Handbook]를 참고하거나 도움을 요청하세요.
+man:portlint[1]는 여러분의 포트가 많은 중요한 외형적 그리고 기능적 지침을 준수하고 있는지를 검증하는 데 사용되는 애플리케이션입니다. portlint 는 단순한 휴리스틱 애플리케이션이기 때문에, 여러분은 이를 _지침서의 역할로만_ 사용해야 합니다. 만약 portlint 가 합리적이지 않아 보이는 수정을 제안한다면, extref:{porters-handbook}[Porter's Handbook]를 참고하거나 도움을 요청하세요.
http://lists.FreeBSD.org/mailman/listinfo/freebsd-ports[FreeBSD ports mailing list]는 포트와 관련된 일반적인 논의가 이루어지는 곳입니다. 여기는 도움을 요청하기에 좋은 장소입니다. 여러분은 http://lists.freebsd.org/mailman/listinfo[구독하거나, 리스트 아카이브를 읽어보고 검색해볼 수 있습니다]. http://lists.FreeBSD.org/mailman/listinfo/freebsd-ports-bugs[FreeBSD ports bugs mailing list]와 http://lists.FreeBSD.org/mailman/listinfo/cvs-ports[FreeBSD CVS ports commit list]의 아카이브를 읽어보는 것도 흥미로울 수 있습니다.
diff --git a/documentation/content/ko/articles/explaining-bsd/_index.adoc b/documentation/content/ko/articles/explaining-bsd/_index.adoc
index 72215238ed..3d74f67cc2 100644
--- a/documentation/content/ko/articles/explaining-bsd/_index.adoc
+++ b/documentation/content/ko/articles/explaining-bsd/_index.adoc
@@ -3,7 +3,6 @@ title: BSD에 대한 설명
authors:
- author: Greg Lehey
email: grog@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sparc", "sun", "unix", "general"]
---
@@ -16,10 +15,27 @@ trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sparc",
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 차례
-:table-caption: 표
-:figure-caption: 그림
-:example-caption: 예시
+:images-path: articles/explaining-bsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
초록
diff --git a/documentation/content/mn/books/handbook/_index.adoc b/documentation/content/mn/books/handbook/_index.adoc
index 86f7fec025..a78e8617f1 100644
--- a/documentation/content/mn/books/handbook/_index.adoc
+++ b/documentation/content/mn/books/handbook/_index.adoc
@@ -3,9 +3,9 @@ title: FreeBSD гарын авлага
authors:
- author: FreeBSD-г Монголоор баримтжуулах төсөл
copyright: 1995-2020 FreeBSD-г Монголоор баримтжуулах төсөл
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
next: books/handbook/preface
+isIndex: true
---
= FreeBSD гарын авлага
@@ -15,18 +15,32 @@ next: books/handbook/preface
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:toc-title: Гарчиг
-:part-signifier: хэсэг
-:chapter-signifier: Бүлэг
-:appendix-caption: Хавсралт
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
+:images-path: books/handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Товч агуулга
@@ -35,10 +49,10 @@ FreeBSD-д тавтай морилно уу! Энэ гарын авлага нь
'''
-include::content/mn/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
-include::content/mn/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
-include::content/mn/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
-include::content/mn/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/mn/books/handbook/advanced-networking/_index.adoc b/documentation/content/mn/books/handbook/advanced-networking/_index.adoc
index 7d2d1ed37c..5a5b8c69c3 100644
--- a/documentation/content/mn/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/mn/books/handbook/advanced-networking/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 32
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 32
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[advanced-networking-synopsis]]
== Ерөнхий агуулга
@@ -2575,7 +2573,7 @@ TA-уудын боломжууд болон холболтын тогтворт
Гадаад TA-ийн жинхэнэ асуудал нь модемуудын адил таны компьютер дээр сайн цуваа карт хэрэгтэй явдал юм.
-Та цуваа төхөөрөмжүүдийн тухай дэлгэрэнгүй ойлголт болон асинхрон ба синхрон цуваа портуудын ялгаануудын талаар link:{serial-uart}[FreeBSD Цуваа Тоног Төхөөрөмж]ийн заавраас унших шаардлагатай.
+Та цуваа төхөөрөмжүүдийн тухай дэлгэрэнгүй ойлголт болон асинхрон ба синхрон цуваа портуудын ялгаануудын талаар extref:{serial-uart}[FreeBSD Цуваа Тоног Төхөөрөмж]ийн заавраас унших шаардлагатай.
Стандарт PC цуваа порт (асинхрон) дээр ажиллаж байгаа TA нь таныг 128 Kbs холболттой байсан ч гэсэн 115.2 Kbs хурдаар хязгаарладаг. ISDN-ий чаддаг 128 Kbs хурдыг бүрэн ашиглахын тулд та TA-г синхрон цуваа карт уруу шилжүүлэх шаардлагатай.
diff --git a/documentation/content/mn/books/handbook/audit/_index.adoc b/documentation/content/mn/books/handbook/audit/_index.adoc
index 90bfb30e2b..00b8d972bd 100644
--- a/documentation/content/mn/books/handbook/audit/_index.adoc
+++ b/documentation/content/mn/books/handbook/audit/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/disks
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[audit-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/basics/_index.adoc b/documentation/content/mn/books/handbook/basics/_index.adoc
index c47d9fcfba..c936cd376b 100644
--- a/documentation/content/mn/books/handbook/basics/_index.adoc
+++ b/documentation/content/mn/books/handbook/basics/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ports
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[basics-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/bibliography/_index.adoc b/documentation/content/mn/books/handbook/bibliography/_index.adoc
index c3de0156d1..15d7348fcd 100644
--- a/documentation/content/mn/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/mn/books/handbook/bibliography/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/eresources
[[bibliography]]
= Ном зүй
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Гарын авлагын хуудаснууд нь FreeBSD үйлдлийн системийн хувь хэсгүүдэд зориулсан эцсийн лавлагааг өгдөг боловч тэдгээр хэсгүүдийг хэрхэн нийлүүлж бүхэл бүтэн үйлдлийн системийг тэгш ажиллуулах талаар дүрслэн үзүүлдэггүйгээрээ зартай юм. Ийм учраас UNIX(R), системийн удирдлагын талаар бичсэн сайн ном болон хэрэглэгчдийн сайн гарын авлагыг орлохоор зүйлс байхгүй юм.
@@ -103,7 +117,7 @@ _Англи хэл дээрх ном & сэтгүүлүүд:_
* Leffler, Samuel J., Marshall Kirk McKusick, _The Design and Implementation of the 4.3BSD UNIX Operating System: Answer Book_. Reading, Mass. : Addison-Wesley, 1991. ISBN 0-201-54629-9
* McKusick, Marshall Kirk, Keith Bostic, Michael J Karels, and John Quarterman. _The Design and Implementation of the 4.4BSD Operating System_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-54979-4
+
-(Энэ номын 2-р бүлэг link:{design-44bsd}[онлайн]аар FreeBSD баримтжуулах төслийн хүрээнд байгаа.)
+(Энэ номын 2-р бүлэг extref:{design-44bsd}[онлайн]аар FreeBSD баримтжуулах төслийн хүрээнд байгаа.)
* Marshall Kirk McKusick, George V. Neville-Neil _The Design and Implementation of the FreeBSD Operating System_. Boston, Mass. : Addison-Wesley, 2004. ISBN 0-201-70245-2
* Stevens, W. Richard. _TCP/IP Illustrated, Volume 1: The Protocols_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-63346-9
* Schimmel, Curt. _Unix Systems for Modern Architectures_. Reading, Mass. : Addison-Wesley, 1994. ISBN 0-201-63338-8
diff --git a/documentation/content/mn/books/handbook/book.adoc b/documentation/content/mn/books/handbook/book.adoc
index 6832a8f410..c67bc76de1 100644
--- a/documentation/content/mn/books/handbook/book.adoc
+++ b/documentation/content/mn/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: FreeBSD гарын авлага
authors:
- author: FreeBSD-г Монголоор баримтжуулах төсөл
copyright: 1995-2020 FreeBSD-г Монголоор баримтжуулах төсөл
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
---
@@ -12,54 +11,35 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:part-signifier: хэсэг
-:chapter-signifier: Бүлэг
-:appendix-caption: Хавсралт
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
:book: true
:pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
-:chapters-path: content/mn/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/mn/mailing-lists.adoc[]
-include::../../../../shared/mn/teams.adoc[]
-include::../../../../shared/mn/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/mn/mailing-lists.adoc[]
-include::../../../../shared/mn/teams.adoc[]
-include::../../../../shared/mn/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -74,97 +54,97 @@ toc::[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
// Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
-include::{chapters-path}install/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}install/_index.adoc[leveloffset=+1]
-include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1]
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
-include::{chapters-path}users/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}users/_index.adoc[leveloffset=+1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}jails/_index.adoc[leveloffset=+1]
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
-include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}filesystems/_index.adoc[leveloffset=+1]
-include::{chapters-path}vinum/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}vinum/_index.adoc[leveloffset=+1]
-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
-include::{chapters-path}dtrace/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}dtrace/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=7..19]
+include::{chapters-path}partiv.adoc[lines=15..27]
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
// Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
:sectnums!:
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/mn/books/handbook/boot/_index.adoc b/documentation/content/mn/books/handbook/boot/_index.adoc
index 1d4f992b66..89b4d9c451 100644
--- a/documentation/content/mn/books/handbook/boot/_index.adoc
+++ b/documentation/content/mn/books/handbook/boot/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/users
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/bsdinstall/_index.adoc b/documentation/content/mn/books/handbook/bsdinstall/_index.adoc
index 59ec2705e8..5059c7bd2a 100644
--- a/documentation/content/mn/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/mn/books/handbook/bsdinstall/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/install
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/bsdinstall/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
-endif::[]
+:images-path: books/handbook/bsdinstall/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[
[[bsdinstall-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/config/_index.adoc b/documentation/content/mn/books/handbook/config/_index.adoc
index cacb1c63a1..524f81d0ef 100644
--- a/documentation/content/mn/books/handbook/config/_index.adoc
+++ b/documentation/content/mn/books/handbook/config/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/boot
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/config/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/config/
-endif::[]
+:images-path: books/handbook/config/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/config/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[config-synopsis]]
== Ерөнхий агуулга
@@ -270,7 +268,7 @@ HOME=/var/log
[IMPORTANT]
====
-Та энд тайлбарласан процедурыг ашиглан системийн crontab [.filename]#/etc/crontab#-ийг засаж болон суулгах хэрэггүй. Зүгээр л өөрийн дуртай засварлагчийг ашигла: `cron` хэрэгсэл файл өөрчлөгдсөнийг мэдээд тэр даруй шинэчлэгдсэн хувилбарыг ашиглаж эхэлнэ. Дэлгэрэнгүй мэдээллийг link:{faq}#ROOT-NOT-FOUND-CRON-ERRORS[Энэ БХА-ын оруулгаас] үзнэ үү.
+Та энд тайлбарласан процедурыг ашиглан системийн crontab [.filename]#/etc/crontab#-ийг засаж болон суулгах хэрэггүй. Зүгээр л өөрийн дуртай засварлагчийг ашигла: `cron` хэрэгсэл файл өөрчлөгдсөнийг мэдээд тэр даруй шинэчлэгдсэн хувилбарыг ашиглаж эхэлнэ. Дэлгэрэнгүй мэдээллийг extref:{faq}[Энэ БХА-ын оруулгаас, ROOT-NOT-FOUND-CRON-ERRORS] үзнэ үү.
====
Хэрэглэгчийн бичсэн шинэ [.filename]#crontab# файлыг суулгахын тулд эхлээд өөрийн дуртай засварлагчийг ашиглаад зөв хэлбэршилттэй файл үүсгээд дараа нь `crontab` хэрэгслийг ашигла. Хамгийн их ашиглагддаг тушаал бол:
@@ -360,7 +358,7 @@ Starting background file system checks in 60 seconds.
Эдгээр түлхүүр үгнүүдийг эхлүүлэх скрипт болгонд болгоомжтойгоор тохируулж өгснөөр бусад зарим UNIX(R) үйлдлийн системүүд шиг "ажиллах түвшингүүдтэй (runlevels)" зууралдалгүйгээр скриптүүдийн эхлэх дарааллыг маш сайн хянах боломжийг администраторт бий болгох юм.
-[.filename]#rc.d# системийн талаар нэмэлт мэдээллийг man:rc[8] болон man:rc.subr[8] гарын авлагын хуудаснуудаас олж болно. Хэрэв та өөрийн rc.d скриптүүд бичих эсвэл байгаагаа сайжруулахыг сонирхож байгаа бол танд бас link:{rc-scripting}[энэ нийтлэл] хэрэгтэй байж болох юм.
+[.filename]#rc.d# системийн талаар нэмэлт мэдээллийг man:rc[8] болон man:rc.subr[8] гарын авлагын хуудаснуудаас олж болно. Хэрэв та өөрийн rc.d скриптүүд бичих эсвэл байгаагаа сайжруулахыг сонирхож байгаа бол танд бас extref:{rc-scripting}[энэ нийтлэл] хэрэгтэй байж болох юм.
[[config-network-setup]]
== Сүлжээний интерфэйс картууд суулгах нь
diff --git a/documentation/content/mn/books/handbook/cutting-edge/_index.adoc b/documentation/content/mn/books/handbook/cutting-edge/_index.adoc
index 9b0537506f..107ca7630e 100644
--- a/documentation/content/mn/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/mn/books/handbook/cutting-edge/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/dtrace
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[updating-upgrading-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/desktop/_index.adoc b/documentation/content/mn/books/handbook/desktop/_index.adoc
index 40e8557315..f6d3e2cf38 100644
--- a/documentation/content/mn/books/handbook/desktop/_index.adoc
+++ b/documentation/content/mn/books/handbook/desktop/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/multimedia
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[desktop-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/disks/_index.adoc b/documentation/content/mn/books/handbook/disks/_index.adoc
index b2b182ac89..4971dc27f0 100644
--- a/documentation/content/mn/books/handbook/disks/_index.adoc
+++ b/documentation/content/mn/books/handbook/disks/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/geom
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[disks-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/dtrace/_index.adoc b/documentation/content/mn/books/handbook/dtrace/_index.adoc
index 519ddd2018..0d8eac6df1 100644
--- a/documentation/content/mn/books/handbook/dtrace/_index.adoc
+++ b/documentation/content/mn/books/handbook/dtrace/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/dtrace/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
-endif::[]
+:images-path: books/handbook/dtrace/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dtrace-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/eresources/_index.adoc b/documentation/content/mn/books/handbook/eresources/_index.adoc
index 8db29ae913..22f7aa57ed 100644
--- a/documentation/content/mn/books/handbook/eresources/_index.adoc
+++ b/documentation/content/mn/books/handbook/eresources/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/pgpkeys
[[eresources]]
= Интернэт дэх эх үүсвэрүүд
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
FreeBSD-ийн дэвшлийн хурдан алхаа нь хамгийн сүүлийн хөгжүүлэлтүүдийг дагахаас хамаараад хэвлэн гаргах хэрэгцээгүй болгоход хүргэдэг. Цахим эх үүсвэрүүд нь хамгийн шилдэг нь бөгөөд хамгийн сүүлийн үеийн дэвшилтүүдийн талаар мэдлэгтэй байх бараг цорын ганц арга юм. FreeBSD нь сайн дурын чармайлт болохоор хэрэглэгчийн хүрээнийхэн нь өөрсдөө цахим захидал, вэб хэлэлцүүлгүүд болон тэр хүрээнийхэнд хүрэх хамгийн үр ашигтай арга болох USENET мэдээнүүдийн тусламжтайгаар ерөнхийдөө нэгэн хэлбэрийн "техникийн дэмжлэгийн хэлтэс" маягаар үйлчилдэг.
@@ -47,9 +60,9 @@ FreeBSD-ийн хэрэглэгчийн хүрээнийхэнд хандах х
_Хэрэв та FreeBSD-ийн жагсаалтууд руу илгээж чадаж байгаа эсэхээ шалгаж тест хийхийг хүсвэл {freebsd-test} руу тест захидал илгээнэ үү._ Өөр бусад жагсаалт руу тест захидал битгий илгээгээрэй.
====
-Аль жагсаалт уруу асуултаа илгээхээ мэдэхгүй эргэлзэж байгаа бол link:{freebsd-questions-article}[FreeBSD-асуултууд захидлын жагсаалтаас хэрхэн хамгийн их ашгийг авч болох вэ] хэсгээс үзнэ үү.
+Аль жагсаалт уруу асуултаа илгээхээ мэдэхгүй эргэлзэж байгаа бол extref:{freebsd-questions-article}[FreeBSD-асуултууд захидлын жагсаалтаас хэрхэн хамгийн их ашгийг авч болох вэ] хэсгээс үзнэ үү.
-Аль нэг жагсаалт уруу илгээхээсээ өмнө байнга давтагддаг хэлэлцүүлгүүдийг үүсгэхгүй байхад хэрхэн туслах зэрэг захидлын жагсаалтыг хэрхэн хамгийн үр ашигтай ашиглах талаар сурах хэрэгтэй. Үүнийг тулд link:{mailing-list-faq}[ Захидлын жагсаалтын байнга асуудаг асуултууд] (FAQ) баримтыг унших нь зүйтэй.
+Аль нэг жагсаалт уруу илгээхээсээ өмнө байнга давтагддаг хэлэлцүүлгүүдийг үүсгэхгүй байхад хэрхэн туслах зэрэг захидлын жагсаалтыг хэрхэн хамгийн үр ашигтай ашиглах талаар сурах хэрэгтэй. Үүнийг тулд extref:{mailing-list-faq}[ Захидлын жагсаалтын байнга асуудаг асуултууд] (FAQ) баримтыг унших нь зүйтэй.
Бүх захидлын жагсаалтуудын хувьд архивууд хадгалагддаг бөгөөд link:https://www.FreeBSD.org/search/[FreeBSD Дэлхий Даяарх Вэб сервер] ашиглан хайлт хийж болно. Түлхүүр үгээр хайж болох архив нь байнга асуугддаг асуултуудад зориулсан хариултуудыг олох хамгийн шилдэг аргыг санал болгодог бөгөөд асуулт илгээхээсээ өмнө эдгээрээс лавлах хэрэгтэй юм. Энэ нь бас FreeBSD-ийн захидлын жагсаалт руу илгээсэн захиануудыг үргэлж хадгалж байдаг гэсэн үг юм. Хувийн нууцыг хамгаалах шаардлагатай бол устгах боломжтой хоёр дахь захианы хаяг ашиглаж зөвхөн нийтийн мэдээллийг явуулах хэрэгтэй.
diff --git a/documentation/content/mn/books/handbook/filesystems/_index.adoc b/documentation/content/mn/books/handbook/filesystems/_index.adoc
index 0b3dde7549..37dc9ab0c9 100644
--- a/documentation/content/mn/books/handbook/filesystems/_index.adoc
+++ b/documentation/content/mn/books/handbook/filesystems/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/vinum
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/filesystems/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
-endif::[]
+:images-path: books/handbook/filesystems/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[filesystems-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/firewalls/_index.adoc b/documentation/content/mn/books/handbook/firewalls/_index.adoc
index 4cb2a688a6..da2d70bd0f 100644
--- a/documentation/content/mn/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/mn/books/handbook/firewalls/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/advanced-networking
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 31
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 31
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[firewalls-intro]]
== Танилцуулга
diff --git a/documentation/content/mn/books/handbook/geom/_index.adoc b/documentation/content/mn/books/handbook/geom/_index.adoc
index deded3c75b..c31c6e3b55 100644
--- a/documentation/content/mn/books/handbook/geom/_index.adoc
+++ b/documentation/content/mn/books/handbook/geom/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/filesystems
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[GEOM-synopsis]]
== Ерөнхий агуулга
@@ -948,4 +946,4 @@ options GEOM_JOURNAL
Хурдан ажиллагаатай байхын тулд тэмдэглэлийг өөр диск дээр байлгаж болно. Энэ тохиолдолд тэмдэглэл хангагч эсвэл хадгалалтын төхөөрөмж нь тэмдэглэлийг идэвхжүүлэхийн тулд уг төхөөрөмжийнхөө дараа жагсаагдах ёстой. `tunefs` тушаал ашиглан тухайн байгаа файлын систем дээр тэмдэглэлийг идэвхжүүлж болдог. Гэхдээ файлын системийг өөрчлөхөөсөө өмнө нөөц _үргэлж_ хийж байх хэрэгтэй. Ихэнх тохиолдолд `gjournal` нь яг тэмдэглэлийг үүсгэж чадаагүй бол амжилтгүй болох бөгөөд гэхдээ энэ нь `tunefs`-ийг буруугаар ашигласнаас болоод үүссэн өгөгдлийн алдагдлаас хамгаалж чадахгүй юм.
-FreeBSD системийн эхлүүлэх дискийг тэмдэглэх бас боломжтой байдаг. Үүний талаарх дэлгэрэнгүй зааврыг link:{gjournal-desktop}[Ширээний PC дээр UFS тэмдэглэлийг хийх нь] гэсэн нийтлэлээс үзнэ үү.
+FreeBSD системийн эхлүүлэх дискийг тэмдэглэх бас боломжтой байдаг. Үүний талаарх дэлгэрэнгүй зааврыг extref:{gjournal-desktop}[Ширээний PC дээр UFS тэмдэглэлийг хийх нь] гэсэн нийтлэлээс үзнэ үү.
diff --git a/documentation/content/mn/books/handbook/install/_index.adoc b/documentation/content/mn/books/handbook/install/_index.adoc
index aaeab7d389..4cbdc653a0 100644
--- a/documentation/content/mn/books/handbook/install/_index.adoc
+++ b/documentation/content/mn/books/handbook/install/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/basics
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/install/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/install/
-endif::[]
+:images-path: books/handbook/install/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/install/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[install-synopsis]]
== Ерөнхий агуулга
@@ -2372,7 +2370,7 @@ FreeBSD төсөл нь хувилбар гаргах үедээ хамгийн
[NOTE]
====
-Хэрэв өөрийн гэсэн FreeBSD хувилбар бүтээнэ гэх юм бол link:{releng}[Хувилбарыг инженерчлэх мэдээллээс] хараарай.
+Хэрэв өөрийн гэсэн FreeBSD хувилбар бүтээнэ гэх юм бол extref:{releng}[Хувилбарыг инженерчлэх мэдээллээс] хараарай.
====
[[install-ftp]]
@@ -2486,7 +2484,7 @@ MS-DOS(R)-с суулгахыг хүссэн тархац болгоныг (хэ
Хэрэв та модем хэрэглэж байгаа бол PPP таны бараг цорын ганц сонголт байх болов уу. Суулгацаа бүр эхлүүлэхээсээ өмнө интернэт хөтлөгч байгууллага уруугаа холбогдох мэдээллээ сайн бэлтгэж авсан байх хэрэгтэй.
-Хэрэв та ISP руугаа PAP эсвэл CHAP хэрэглэж холбогддог бол (өөрөөр хэлбэл, ISP уруугаа ямар нэгэн скрипт буюу гүйцэтгэдэг бичлэг хэрэглэлгүйгээр Windows(R)-с холбогдож байвал), ppp-н тушаал оруулах мөрөнд `dial` гэж оруулахад болно. Өөр тохиолдолд, PPP хэрэглэж утасдах горим нь тун энгийн терминал үйлчилгээгээр хангагдсан байдаг болохоор, та ISP руугаа модемондоо тохирсон "AT тушаал" хэрэглэж холбогдох хэрэгтэй. Хэрэглэгчийн ppp бүртгэлийн crossref:ppp-and-slip[userppp,гарын авлага] эсвэл link:{faq}#ppp/[FAQ буюу байнга асуудаг асуулт хариулт] хэсгээс нэмэлт мэдээллийг харж болно. Хэрэв танд хүндрэл тулгарвал, `set log local ...` тушаал ашиглаж ерөнхий явцын бүртгэл бичлэгийг дэлгэцэн дээрээ зэрэг хянаж болно.
+Хэрэв та ISP руугаа PAP эсвэл CHAP хэрэглэж холбогддог бол (өөрөөр хэлбэл, ISP уруугаа ямар нэгэн скрипт буюу гүйцэтгэдэг бичлэг хэрэглэлгүйгээр Windows(R)-с холбогдож байвал), ppp-н тушаал оруулах мөрөнд `dial` гэж оруулахад болно. Өөр тохиолдолд, PPP хэрэглэж утасдах горим нь тун энгийн терминал үйлчилгээгээр хангагдсан байдаг болохоор, та ISP руугаа модемондоо тохирсон "AT тушаал" хэрэглэж холбогдох хэрэгтэй. Хэрэглэгчийн ppp бүртгэлийн crossref:ppp-and-slip[userppp,гарын авлага] эсвэл extref:{faq}[FAQ буюу байнга асуудаг асуулт хариулт, ppp] хэсгээс нэмэлт мэдээллийг харж болно. Хэрэв танд хүндрэл тулгарвал, `set log local ...` тушаал ашиглаж ерөнхий явцын бүртгэл бичлэгийг дэлгэцэн дээрээ зэрэг хянаж болно.
Хэрэв та өөр FreeBSD машин уруу шууд залгаж холбогдох боломжтой бол "laplink" зэрэгцээ кабелиар гүйцэтгэж болох юм. Зэрэгцээ холболтоор өгөгдөл нь цуваа холболтыг бодвол арай хурдан дамжигдах (50 кбайт/сек хүртэл) бөгөөд, ингэснээр илүү түргэн суулгацаа гүйцэтгэж болох юм.
diff --git a/documentation/content/mn/books/handbook/introduction/_index.adoc b/documentation/content/mn/books/handbook/introduction/_index.adoc
index a6b6f331a7..f7bad73d73 100644
--- a/documentation/content/mn/books/handbook/introduction/_index.adoc
+++ b/documentation/content/mn/books/handbook/introduction/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/bsdinstall
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/introduction/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/introduction/
-endif::[]
+:images-path: books/handbook/introduction/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/introduction/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-synopsis]]
== Ерөнхий агуулга
@@ -61,7 +59,7 @@ FreeBSD-г сонирхсон танд баярлалаа! Дараах бүлэ
[[nutshell]]
== FreeBSD-д тавтай морилно уу!
-FreeBSD нь Интел (x86 болон Itanium(R)), AMD64, Sun UltraSPARC(R) компьютеруудад зориулагдсан 4.4BSD-Lite дээр үндэслэсэн үйлдлийн систем юм. Мөн өөр бусад архитектур уруу порт хийгдэж байгаа болно. Та мөн <<history,FreeBSD-ийн түүх>> эсвэл <<relnotes,одоогийн хувилбар>> ыг унших боломжтой. Хэрэв та энэ төсөлд (код, тоног төхөөрөмж, сан) хувь нэмэр оруулахыг сонирхож байгаа бол link:{contributing}[FreeBSD-д хувь нэмэр оруулах нь] нийтлэлийг уншина уу.
+FreeBSD нь Интел (x86 болон Itanium(R)), AMD64, Sun UltraSPARC(R) компьютеруудад зориулагдсан 4.4BSD-Lite дээр үндэслэсэн үйлдлийн систем юм. Мөн өөр бусад архитектур уруу порт хийгдэж байгаа болно. Та мөн <<history,FreeBSD-ийн түүх>> эсвэл <<relnotes,одоогийн хувилбар>> ыг унших боломжтой. Хэрэв та энэ төсөлд (код, тоног төхөөрөмж, сан) хувь нэмэр оруулахыг сонирхож байгаа бол extref:{contributing}[FreeBSD-д хувь нэмэр оруулах нь] нийтлэлийг уншина уу.
[[os-overview]]
=== FreeBSD юу хийж чадах вэ?
@@ -190,7 +188,7 @@ FreeBSD Төслийн зорилгууд нь ямар нэг хязгаарл
[[development]]
=== FreeBSD Хөгжүүлэх Загвар
-FreeBSD-ийн хөгжүүлэлт нь бидний link:{contributors}[хувь нэмэр оруулагчдын жагсаалт]аас харахад дэлхий даяар хэдэн зуун хүмүүсийн оруулсан хувь нэмэр дээр бүтээгдсэн, их нээлттэй, уян хатан процесс юм. FreeBSD-ийн хөгжүүлэлтийн дэд бүтэц нь эдгээр хэдэн зуун хөгжүүлэгчдийг Интернэтээр хамтран ажиллах боломжийг нээж өгдөг. Бид шинэ хөгжүүлэгчид, болон санаануудыг тогтмол хайж байдаг бөгөөд төсөлтэй илүү ойртохыг сонирхсон хэн ч гэсэн {freebsd-hackers} хаягаар бидэнд хандаарай. Мөн бусад FreeBSD хэрэглэгчдэд гол гол ажлуудын талаар мэдээлэх {freebsd-announce} бас байгаа болно.
+FreeBSD-ийн хөгжүүлэлт нь бидний extref:{contributors}[хувь нэмэр оруулагчдын жагсаалт]аас харахад дэлхий даяар хэдэн зуун хүмүүсийн оруулсан хувь нэмэр дээр бүтээгдсэн, их нээлттэй, уян хатан процесс юм. FreeBSD-ийн хөгжүүлэлтийн дэд бүтэц нь эдгээр хэдэн зуун хөгжүүлэгчдийг Интернэтээр хамтран ажиллах боломжийг нээж өгдөг. Бид шинэ хөгжүүлэгчид, болон санаануудыг тогтмол хайж байдаг бөгөөд төсөлтэй илүү ойртохыг сонирхсон хэн ч гэсэн {freebsd-hackers} хаягаар бидэнд хандаарай. Мөн бусад FreeBSD хэрэглэгчдэд гол гол ажлуудын талаар мэдээлэх {freebsd-announce} бас байгаа болно.
Чөлөөтэй болон нягт хамтын ажиллагаан доор ажилладгаас үл хамааран FreeBSD төсөл болон түүний хөгжүүлэлтийн процессийн талаар ашигтай зүйлсийн талаар мэдэхийг хүсвэл:
@@ -203,7 +201,7 @@ _Итгэмжлэн оруулагчид_ нь Subversion мод уруу _би
FreeBSD-ийн гол баг[[development-core]]::
FreeBSD-г компани гэж бодох юм бол _FreeBSD-ийн гол баг_ нь захирлуудын зөвлөлтэй ижил утгатай юм. Гол багийн үндсэн үүрэг нь төсөл бүхэлдээ сайн байж, түүнийг зөв чиглэлээр явуулахыг хянаж байх явдал юм. Өөрийгөө бүрэн дайчилсан, хариуцлагатай хөгжүүлэгчдийг итгэмжлэн оруулагчдын бүлэгт урих нь гол багийн үүргүүдийн нэг бөгөөд зарим гишүүд шилжихэд гол багийн шинэ гишүүдийг шинээр авах нь бас нэг үүрэг нь юм. Одоогийн гол баг нь нэр дэвшигч итгэмжлэн оруулагчдаас 2012 оны 7 сард сонгогдсон. Сонгууль 2 жилд нэг удаа явагддаг.
+
-Гол багийн зарим гишүүд тусгай хариуцлагатай бөгөөд системийн ихээхэн хэсэг сурталчилсан хэмжээгээрээ ажиллаж байхыг хянаж бие сэтгэлээ зориулж байдаг. FreeBSD хөгжүүлэгчдийн жагсаалт болон тэдний аль хэсэгт хариуцлагатайг link:{contributors}[Хувь нэмэр оруулагчдын жагсаалт]аас үзнэ үү.
+Гол багийн зарим гишүүд тусгай хариуцлагатай бөгөөд системийн ихээхэн хэсэг сурталчилсан хэмжээгээрээ ажиллаж байхыг хянаж бие сэтгэлээ зориулж байдаг. FreeBSD хөгжүүлэгчдийн жагсаалт болон тэдний аль хэсэгт хариуцлагатайг extref:{contributors}[Хувь нэмэр оруулагчдын жагсаалт]аас үзнэ үү.
+
[NOTE]
====
@@ -213,7 +211,7 @@ FreeBSD-г компани гэж бодох юм бол _FreeBSD-ийн гол
Гаднын хувь нэмэр оруулагчид::
Эцэст нь, гэхдээ мэдээж хамгийн сүүлийнх биш, хамгийн том бүлэг хөгжүүлэгчид нь санал сэтгэгдэл болон алдааны засваруудыг бидэнд бараг л тогтмол илгээдэг хэрэглэгчид юм. FreeBSD-ийн илүү төвлөрсөн бус хөгжүүлэлттэй холбоотой байх үндсэн арга нь тийм зүйлсийн талаар хэлэлцдэг {freebsd-hackers}-д бүртгүүлэх явдал юм. FreeBSD-ийн төрөл бүрийн захидлын жагсаалтын талаар дэлгэрэнгүйг crossref:eresources[eresources,Интернэт дэх эх үүсвэрүүд]-ээс үзнэ үү.
+
-link:{contributors}[FreeBSD-ийн Хувь нэмэр оруулагчдын Жагсаалт] нь урт бөгөөд өсөн нэмэгдэж байгаагийн нэг, тийм болохоор яагаад өнөөдөр FreeBSD-д хувь нэмэр оруулж энэ жагсаалтад нэгдэж болохгүй гэж?
+extref:{contributors}[FreeBSD-ийн Хувь нэмэр оруулагчдын Жагсаалт] нь урт бөгөөд өсөн нэмэгдэж байгаагийн нэг, тийм болохоор яагаад өнөөдөр FreeBSD-д хувь нэмэр оруулж энэ жагсаалтад нэгдэж болохгүй гэж?
+
Код ирүүлэх нь төсөлд хувь нэмэр оруулах ганц арга биш юм; Хийх шаардлагатай байгаа зүйлсүүдийн бүрэн жагсаалтын талаар link:https://www.FreeBSD.org/[FreeBSD Төслийн вэб хуудсын хаяг]т хандаж үзнэ үү.
diff --git a/documentation/content/mn/books/handbook/jails/_index.adoc b/documentation/content/mn/books/handbook/jails/_index.adoc
index ca5d5081a2..eeb50cfbc6 100644
--- a/documentation/content/mn/books/handbook/jails/_index.adoc
+++ b/documentation/content/mn/books/handbook/jails/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mac
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/jails/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
-endif::[]
+:images-path: books/handbook/jails/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[jails-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/kernelconfig/_index.adoc b/documentation/content/mn/books/handbook/kernelconfig/_index.adoc
index fed4cbdf7a..970818a0aa 100644
--- a/documentation/content/mn/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/mn/books/handbook/kernelconfig/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/printing
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kernelconfig-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/l10n/_index.adoc b/documentation/content/mn/books/handbook/l10n/_index.adoc
index 37f94302b7..5d7905ec9d 100644
--- a/documentation/content/mn/books/handbook/l10n/_index.adoc
+++ b/documentation/content/mn/books/handbook/l10n/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/cutting-edge
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/linuxemu/_index.adoc b/documentation/content/mn/books/handbook/linuxemu/_index.adoc
index 209fdcfa8a..fde5c5d515 100644
--- a/documentation/content/mn/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/mn/books/handbook/linuxemu/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[linuxemu-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/mac/_index.adoc b/documentation/content/mn/books/handbook/mac/_index.adoc
index fe6d74284e..df583e2bc5 100644
--- a/documentation/content/mn/books/handbook/mac/_index.adoc
+++ b/documentation/content/mn/books/handbook/mac/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/audit
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/mail/_index.adoc b/documentation/content/mn/books/handbook/mail/_index.adoc
index 0d8673cc34..73578dfac8 100644
--- a/documentation/content/mn/books/handbook/mail/_index.adoc
+++ b/documentation/content/mn/books/handbook/mail/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/network-servers
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 29
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 29
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mail-synopsis]]
== Ерөнхий Агуулга
diff --git a/documentation/content/mn/books/handbook/mirrors/_index.adoc b/documentation/content/mn/books/handbook/mirrors/_index.adoc
index 0b9ffb90b4..f605fb16de 100644
--- a/documentation/content/mn/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/mn/books/handbook/mirrors/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/bibliography
[[mirrors]]
= Se procurer FreeBSD
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mirrors-cdrom]]
== CDROM болон DVD Нийтлэгчид
@@ -1171,7 +1184,7 @@ FreeBSD-2.2.X-д зориулсан хөгжүүлэлтийн шугам, ба
=== Хувилбарын хаягууд
-Эдгээр хаягууд нь FreeBSD-ийн тодорхой нэг хувилбар гарсан үеийн цагийн тодорхой цэгийг заадаг. Хувилбар инженерчлэлийн процессийн талаар link:https://www.FreeBSD.org/releng/[Хувилбар инженерчлэлийн мэдээлэл] болон link:{releng}#release-proc/[Хувилбарын процесс] баримтуудад илүү дэлгэрэнгүй баримтжуулагдсан байдаг. [.filename]#src# мод нь `RELENG_` гэж эхэлсэн хаягийн нэрсийг ашигладаг. [.filename]#ports# болон [.filename]#doc# моднууд нь `RELEASE` гэж эхэлсэн хаягийн нэрсийг ашигладаг. Төгсгөлд нь [.filename]#www# мод нь хувилбаруудад зориулсан ямар нэг тусгай нэрээр хаяглагддаггүй.
+Эдгээр хаягууд нь FreeBSD-ийн тодорхой нэг хувилбар гарсан үеийн цагийн тодорхой цэгийг заадаг. Хувилбар инженерчлэлийн процессийн талаар link:https://www.FreeBSD.org/releng/[Хувилбар инженерчлэлийн мэдээлэл] болон extref:{releng}[Хувилбарын процесс, release-proc] баримтуудад илүү дэлгэрэнгүй баримтжуулагдсан байдаг. [.filename]#src# мод нь `RELENG_` гэж эхэлсэн хаягийн нэрсийг ашигладаг. [.filename]#ports# болон [.filename]#doc# моднууд нь `RELEASE` гэж эхэлсэн хаягийн нэрсийг ашигладаг. Төгсгөлд нь [.filename]#www# мод нь хувилбаруудад зориулсан ямар нэг тусгай нэрээр хаяглагддаггүй.
RELENG_9_0_0_RELEASE::
FreeBSD 9.0
diff --git a/documentation/content/mn/books/handbook/multimedia/_index.adoc b/documentation/content/mn/books/handbook/multimedia/_index.adoc
index 9f50da02bd..e8a17f73b6 100644
--- a/documentation/content/mn/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/mn/books/handbook/multimedia/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/kernelconfig
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[multimedia-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/network-servers/_index.adoc b/documentation/content/mn/books/handbook/network-servers/_index.adoc
index 8d802ab186..f79d9ab2b3 100644
--- a/documentation/content/mn/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/mn/books/handbook/network-servers/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/firewalls
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 30
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 30
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[network-servers-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/parti.adoc b/documentation/content/mn/books/handbook/parti.adoc
index 9e243ac3d1..6bae2fc279 100644
--- a/documentation/content/mn/books/handbook/parti.adoc
+++ b/documentation/content/mn/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
next: books/handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[getting-started]]
= Эхлэл
@@ -17,4 +25,4 @@ FreeBSD гарын авлагын энэ хэсэг нь FreeBSD-тэй шинэ
Бид Гарын авлагынхаа энэ хэсгийг аль болох цөөхөн хуудас дамжихаар бодолцсон бөгөөд ингэснээр танд энэ гарын авлагыг эхнээс нь дуустал хуудаснаас хуудас уруу үсрэлгүйгээр уншиж дуусгахад зориулсан билээ.
-include::content/mn/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/mn/books/handbook/partii.adoc b/documentation/content/mn/books/handbook/partii.adoc
index 522e6f5014..81f81303be 100644
--- a/documentation/content/mn/books/handbook/partii.adoc
+++ b/documentation/content/mn/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
next: books/handbook/desktop
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[common-tasks]]
= Нийтлэг асуудлууд
@@ -17,4 +25,4 @@ next: books/handbook/desktop
Эдгээр бүлгүүдийн заримд таныг зарим нэг ойлголтуудын талаар урьдаар уншихыг зөвлөх бөгөөд энэ нь бүлэг бүрийн эхэнд ерөнхий агуулгад дурдсан байгаа болно.
-include::content/mn/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/mn/books/handbook/partiii.adoc b/documentation/content/mn/books/handbook/partiii.adoc
index 49218f6ff1..0e1df51371 100644
--- a/documentation/content/mn/books/handbook/partiii.adoc
+++ b/documentation/content/mn/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
next: books/handbook/config
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[system-administration]]
= Системийн Удирдлага
@@ -11,4 +19,4 @@ FreeBSD гарын авлагын үлдсэн бүлгүүд нь FreeBSD си
Эдгээр бүлгүүд нь танд мэдээлэл хэрэгтэй үед уншигдахаар зориулагдсан юм. Та ямар нэгэн тодорхой дарааллаар унших хэрэггүй бөгөөд FreeBSD ашиглаж эхлэхээсээ өмнө бүгдийг нь унших шаардлагагүй болно.
-include::content/mn/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/mn/books/handbook/partiv.adoc b/documentation/content/mn/books/handbook/partiv.adoc
index 4cf353186d..c78b63b165 100644
--- a/documentation/content/mn/books/handbook/partiv.adoc
+++ b/documentation/content/mn/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/usb-device-mode
next: books/handbook/serialcomms
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[network-communication]]
= Сүлжээний Холболт
@@ -18,4 +26,4 @@ FreeBSD нь өндөр ажиллагаатай сүлжээний сервер
Эдгээр бүлгүүд нь танд мэдээлэл хэрэгтэй үед уншигдахаар зориулагдсан юм. Та ямар нэгэн тодорхой дарааллаар унших хэрэггүй бөгөөд FreeBSD ашиглаж эхлэхээсээ өмнө бүгдийг нь унших шаардлагагүй болно.
-include::content/mn/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/mn/books/handbook/partv.adoc b/documentation/content/mn/books/handbook/partv.adoc
index 326d8e9361..85dc9f19b4 100644
--- a/documentation/content/mn/books/handbook/partv.adoc
+++ b/documentation/content/mn/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
next: books/handbook/mirrors
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
== Хавсралтууд
-include::content/mn/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/mn/books/handbook/pgpkeys/_index.adoc b/documentation/content/mn/books/handbook/pgpkeys/_index.adoc
index 1f862eb598..e2bde4c782 100644
--- a/documentation/content/mn/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/mn/books/handbook/pgpkeys/_index.adoc
@@ -9,30 +9,46 @@ next: books/handbook/freebsd-glossary
[[pgpkeys]]
= PGP түлхүүрүүд
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
-The OpenPGP keys of the `FreeBSD.org` officers are shown here. These keys can be used to verify a signature or send encrypted email to one of the officers. A full list of FreeBSD OpenPGP keys is available in the link:{pgpkeys}[PGP Keys] article. The complete keyring can be downloaded at link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
+The OpenPGP keys of the `FreeBSD.org` officers are shown here. These keys can be used to verify a signature or send encrypted email to one of the officers. A full list of FreeBSD OpenPGP keys is available in the extref:{pgpkeys}[PGP Keys] article. The complete keyring can be downloaded at link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
[[pgpkeys-officers]]
== Officers
diff --git a/documentation/content/mn/books/handbook/ports/_index.adoc b/documentation/content/mn/books/handbook/ports/_index.adoc
index efad68cba2..87eb038e86 100644
--- a/documentation/content/mn/books/handbook/ports/_index.adoc
+++ b/documentation/content/mn/books/handbook/ports/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/x11
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ports-synopsis]]
== Ерөнхий агуулга
@@ -675,7 +673,7 @@ Portsnap-г эхний удаа дээрх маягаар ашиглаж эхэ
====
*Procedure: Subversion арга*
-Хэрэв портын цуглуулгыг илүү хянах шаардлагатай бол (жишээ нь локал өөрчлөлтийг арчлах бол) Subversion-г портын цуглуулгыг татахдаа ашиглаж болно. Subversion-ий талаар дэлгэрэнгүйг link:{committers-guide}#subversion-primer/[the Subversion Primer] хуудаснаас үзнэ үү.
+Хэрэв портын цуглуулгыг илүү хянах шаардлагатай бол (жишээ нь локал өөрчлөлтийг арчлах бол) Subversion-г портын цуглуулгыг татахдаа ашиглаж болно. Subversion-ий талаар дэлгэрэнгүйг extref:{committers-guide}[the Subversion Primer, subversion-primer] хуудаснаас үзнэ үү.
. Subversion-г портын модыг татахаасаа өмнө суулгасан байх шаардлагатай. Хэрэв портын мод аль хэдийн байгаа бол Subversion-г иймэрхүү маягаар суулгаарай:
+
@@ -699,7 +697,7 @@ Portsnap-г эхний удаа дээрх маягаар ашиглаж эхэ
# pkg install subversion
....
+
-. Портын модыг татаж авна. Илүү ажиллагааг хурдан болгохын тулд доорх тушаалын _svn.FreeBSD.org_ гэдгийн оронд танд газар зүйн байрлалын хувьд ойр байрлалыг crossref:mirrors[mirrors-svn,Subversion толин тусгал] хэсгээс харан сонгоорой. Итгэмжлэн нийлүүлэгчид зөв протокол сонгож ажиллахын тулд эхлээд link:{committers-guide}#subversion-primer/[Subversion Primer] тусламжийг унших ёстой.
+. Портын модыг татаж авна. Илүү ажиллагааг хурдан болгохын тулд доорх тушаалын _svn.FreeBSD.org_ гэдгийн оронд танд газар зүйн байрлалын хувьд ойр байрлалыг crossref:mirrors[mirrors-svn,Subversion толин тусгал] хэсгээс харан сонгоорой. Итгэмжлэн нийлүүлэгчид зөв протокол сонгож ажиллахын тулд эхлээд extref:{committers-guide}[Subversion Primer, subversion-primer] тусламжийг унших ёстой.
+
[source,shell]
....
@@ -811,7 +809,7 @@ Portsnap ашиглан портын модыг шинэчлэх болон Port
* [.filename]#pkg-descr# файл. Энэ файл дотор тухайн програмын тухай нэлээн дэлгэрэнгүй тодорхойлолт агуулагдаж байдаг.
* [.filename]#pkg-plist# файл. Энэ файл дотор порт суугдах явцад хуулагдаж суугдах файлуудын жагсаалт байдаг. Энэ нь мөн портыг устгах үед портын системд мэдэгдэх файлуудын жагсаалт билээ.
-Зарим портууд [.filename]#pkg-message# гэх мэтийн өөр файлууд агуулж байдаг. Портын систем нь онцгой тохиолдолд уг файлуудтай хандаж тухайн портод харгалзах үйлдлүүдийг хийх болно. Хэрэв та ийм файлуудын тухай дэлгэрэнгүй мэдээлэл мөн портын тухай үндсэн ойлголт авахыг хүсвэл link:{porters-handbook}[FreeBSD порт бүтээгчийн гарын авлага] хуудаснаас харна уу.
+Зарим портууд [.filename]#pkg-message# гэх мэтийн өөр файлууд агуулж байдаг. Портын систем нь онцгой тохиолдолд уг файлуудтай хандаж тухайн портод харгалзах үйлдлүүдийг хийх болно. Хэрэв та ийм файлуудын тухай дэлгэрэнгүй мэдээлэл мөн портын тухай үндсэн ойлголт авахыг хүсвэл extref:{porters-handbook}[FreeBSD порт бүтээгчийн гарын авлага] хуудаснаас харна уу.
Порт дотор програмын эх бичлэгийг хэрхэн хөрвүүлж бүтээх тухай заавар байдаг болохоос уг програмын эх бичлэг нь байдаггүй. Та уг програмын эх бичлэгийг CD-ROM эсвэл интернэтээс уг зохиогчийнх нь гаргасан хэлбэрээр татаж авч болно. Голдуу эх бичлэгүүд нь tar болон gzip шахалтаар шахаж бэлдсэн байдаг боловч заримдаа өөр төрлийн хэрэгсэл ашиглан шахсан тохиолдол тулгарч магадгүй. Ямар ч хэлбэрээр програмын эх бичлэгийг авсан байг, түүнийг "distfile" гэж нэрийддэг. Доор FreeBSD порт суулгах хоёр аргыг танилцуулж байна.
@@ -1193,12 +1191,12 @@ Portmaster нь портуудыг дөрвөн төрөлд бүлэглэдэ
+
[NOTE]
====
-Зарим порт нь хувь хүнээр биш харин link:{mailing-list-faq}[захианы жагсаалтаар] арчлагдаж байдаг. Энэ жагсаалтад бүгд биш ч гэсэн ихэнх хүмүүс нь mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org] маягийн захианы хаягтай байдаг. Ийм хүмүүс рүү захиагаа явуулах хэрэгтэй.
+Зарим порт нь хувь хүнээр биш харин extref:{mailing-list-faq}[захианы жагсаалтаар] арчлагдаж байдаг. Энэ жагсаалтад бүгд биш ч гэсэн ихэнх хүмүүс нь mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org] маягийн захианы хаягтай байдаг. Ийм хүмүүс рүү захиагаа явуулах хэрэгтэй.
Голдуу mailto:ports@FreeBSD.org[ports@FreeBSD.org]-р арчлагдаж байгаа гэсэн портууд нэг тодорхой хүнээр арчлагдаагүй байдаг. Завсарлалт болон тусламж зэргүүд нь ихэнхдээ захианы жагсаалтад буй хүмүүсээс ирдэг. Туслан дэмжих хүмүүс бидэнд үргэлж хэрэгтэй байгаа!
====
+
-Хэрэв та ямар нэгэн хариулт аваагүй бол man:send-pr[1]-г ашиглан алдааны мэдэгдэл ( link:{problem-reports}[FreeBSD-н алдааг мэдээлэх] хэсгийг харна уу) хийж болно.
-. Өөрөө засаад үз! link:{porters-handbook}[Порт хийгчдийн гарын авлага] дотор "портын" ажиллах зарчим болон бүтэц заавар, засах дараалал, тэр байтугай өөрөө порт зохиох талаар дурдсан байгаа!
+Хэрэв та ямар нэгэн хариулт аваагүй бол man:send-pr[1]-г ашиглан алдааны мэдэгдэл ( extref:{problem-reports}[FreeBSD-н алдааг мэдээлэх] хэсгийг харна уу) хийж болно.
+. Өөрөө засаад үз! extref:{porters-handbook}[Порт хийгчдийн гарын авлага] дотор "портын" ажиллах зарчим болон бүтэц заавар, засах дараалал, тэр байтугай өөрөө порт зохиох талаар дурдсан байгаа!
. Ойрхон байгаа FTP хуудаснаас багцыг татаж авах хэрэгтэй. "Үндсэн" багцны цуглуулга `ftp.FreeBSD.org` хуудасны link:ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/[багцны санд] байдаг бөгөөд crossref:mirrors[mirrors-ftp,толин тусгал сайтууд]уудыг _эхлээд_ турш! Ингэсэн нь эх бичлэгийг хөрвүүлэхээс түргэн бэлэн болсон багцыг татаж аван цаг хэмнэж байдаг. man:pkg_add[1] програмыг ашиглан өөртөө хадгалсан багцаа систем дээрээ суулгана.
diff --git a/documentation/content/mn/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/mn/books/handbook/ppp-and-slip/_index.adoc
index cfa27749a1..eb30d928eb 100644
--- a/documentation/content/mn/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/mn/books/handbook/ppp-and-slip/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mail
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 28
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 28
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ppp-and-slip-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/preface/_index.adoc b/documentation/content/mn/books/handbook/preface/_index.adoc
index 39ee1575e5..5336e6ea8e 100644
--- a/documentation/content/mn/books/handbook/preface/_index.adoc
+++ b/documentation/content/mn/books/handbook/preface/_index.adoc
@@ -13,13 +13,31 @@ next: books/handbook/parti
:icons: font
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-audience]]
== Энэ номын зориулалт
diff --git a/documentation/content/mn/books/handbook/printing/_index.adoc b/documentation/content/mn/books/handbook/printing/_index.adoc
index 39cca239fc..3c6cf268f8 100644
--- a/documentation/content/mn/books/handbook/printing/_index.adoc
+++ b/documentation/content/mn/books/handbook/printing/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/linuxemu
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/priting/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[printing-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/security/_index.adoc b/documentation/content/mn/books/handbook/security/_index.adoc
index 29c0ed64c7..512a56a298 100644
--- a/documentation/content/mn/books/handbook/security/_index.adoc
+++ b/documentation/content/mn/books/handbook/security/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/jails
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/serialcomms/_index.adoc b/documentation/content/mn/books/handbook/serialcomms/_index.adoc
index bcfd186be1..da55f0903a 100644
--- a/documentation/content/mn/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/mn/books/handbook/serialcomms/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ppp-and-slip
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[serial-synopsis]]
== Ерөнхий агуулга
@@ -1111,7 +1109,7 @@ BIOS-ийн тохиргоон дээр гараа "Not installed" буюу су
Доор тайлбарласан `-h` тохируулга байгаа эсэхээс үл хамаарч энэ нэгжийг консол болгоно (өөр илүү эрхтэй консол байхгүй тохиолдолд). `0x20` туг нь `0x10` тугтай цуг ашиглагдах ёстой.
`0x40`:::
-Энэ нэгжийг (`0x10`-тай цуг) нөөцөлж хэвийн хандалтад энэ нэгжийг байхгүй болгоно. Та энэ тугийг цуваа консол маягаар ашиглахыг хүсэж байгаа цуваа портын нэгждээ тохируулах ёсгүй юм. Энэ тугны цорын ганц хэрэглээ нь алсаас цөмийг дибаг хийхэд нэгжийг зориулах явдал юм. Алсаас дибаг хийх талаар илүү мэдээллийг link:{developers-handbook}[Хөгжүүлэгчийн Гарын Авлага]ас үзнэ үү.
+Энэ нэгжийг (`0x10`-тай цуг) нөөцөлж хэвийн хандалтад энэ нэгжийг байхгүй болгоно. Та энэ тугийг цуваа консол маягаар ашиглахыг хүсэж байгаа цуваа портын нэгждээ тохируулах ёсгүй юм. Энэ тугны цорын ганц хэрэглээ нь алсаас цөмийг дибаг хийхэд нэгжийг зориулах явдал юм. Алсаас дибаг хийх талаар илүү мэдээллийг extref:{developers-handbook}[Хөгжүүлэгчийн Гарын Авлага]ас үзнэ үү.
+
Жишээ:
+
diff --git a/documentation/content/mn/books/handbook/users/_index.adoc b/documentation/content/mn/books/handbook/users/_index.adoc
index 687c8fd0c4..c9718d990f 100644
--- a/documentation/content/mn/books/handbook/users/_index.adoc
+++ b/documentation/content/mn/books/handbook/users/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/security
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/users/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/users/
-endif::[]
+:images-path: books/handbook/users/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/users/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[users-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/vinum/_index.adoc b/documentation/content/mn/books/handbook/vinum/_index.adoc
index f4573ed533..f35a410fea 100644
--- a/documentation/content/mn/books/handbook/vinum/_index.adoc
+++ b/documentation/content/mn/books/handbook/vinum/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/virtualization
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/vinum/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/vinum/
-endif::[]
+:images-path: books/handbook/vinum/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/vinum/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[vinum-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/virtualization/_index.adoc b/documentation/content/mn/books/handbook/virtualization/_index.adoc
index 20510c5d8b..54f765de2b 100644
--- a/documentation/content/mn/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/mn/books/handbook/virtualization/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/l10n
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/virtualization/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
-endif::[]
+:images-path: books/handbook/virtualization/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[virtualization-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/mn/books/handbook/x11/_index.adoc b/documentation/content/mn/books/handbook/x11/_index.adoc
index 88dbd1d430..89e79b75fc 100644
--- a/documentation/content/mn/books/handbook/x11/_index.adoc
+++ b/documentation/content/mn/books/handbook/x11/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Гарчиг
-:table-caption: Хүснэгт
-:figure-caption: Зураг
-:example-caption: Жишээ
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/mn/mailing-lists.adoc[]
-include::shared/mn/teams.adoc[]
-include::shared/mn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[x11-synopsis]]
== Ерөнхий агуулга
diff --git a/documentation/content/nl/articles/contributing/_index.adoc b/documentation/content/nl/articles/contributing/_index.adoc
index 25197f1e74..6d5224a2df 100644
--- a/documentation/content/nl/articles/contributing/_index.adoc
+++ b/documentation/content/nl/articles/contributing/_index.adoc
@@ -2,7 +2,6 @@
title: Bijdragen aan FreeBSD
authors:
- author: Jordan Hubbard
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ieee", "general"]
---
@@ -15,27 +14,26 @@ trademarks: ["freebsd", "ieee", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Inhoudsopgave
-:part-signifier: Deel
-:chapter-signifier: Hoofdstuk
-:appendix-caption: Bijlage
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-
-ifeval::["{backend}" == "html5"]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/urls.adoc[]
+:images-path: articles/contributing/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/nl/mailing-lists.adoc[]
-include::../../../../shared/nl/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/nl/mailing-lists.adoc[]
-include::../../../../shared/nl/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -68,7 +66,7 @@ De onderstaande lijst van taken en deelprojecten representeert een soort amalgaa
Veel mensen die betrokken zijn bij FreeBSD zijn geen programmeurs. Het Project omvat documentatieschrijvers, Webontwerpers, en mensen ter ondersteuning. Deze mensen hoeven alleen een tijdsinvestering en een wil om te leren bij te dragen.
. Lees regelmatig de FAQ en het Handboek door. Laat het ons weten als er iets slecht is uitgelegd, is verlopen of gewoon helemaal verkeerd is. Of stuur een reparatie in (Docbook is niet moeilijk te leren, maar er is geen bezwaar tegen inzendingen in ASCII).
-. Help bij het vertalen van FreeBSD-documentatie in uw eigen taal. Als er al documentatie in uw taal bestaat, kunt u helpen door aanvullende documenten te vertalen of te controleren dat de vertalingen up-to-date zijn. Kijk eerst op link:{fdp-primer}#translations[Translations FAQ] in de FreeBSD Documentation Project Primer. U bindt zich niet aan het vertalen van elk FreeBSD-document door dit te doen - als vrijwilliger kunt u zo veel of zo weinig vertalen als u wilt. Als iemand eenmaal begint te vertalen, sluiten andere mensen zich hier bijna altijd bij aan. Als u slechts de tijd of energie heeft om één document te vertalen, vertaal dan alstublieft de installatie-instructies.
+. Help bij het vertalen van FreeBSD-documentatie in uw eigen taal. Als er al documentatie in uw taal bestaat, kunt u helpen door aanvullende documenten te vertalen of te controleren dat de vertalingen up-to-date zijn. Kijk eerst op extref:{fdp-primer}[Translations FAQ, translations] in de FreeBSD Documentation Project Primer. U bindt zich niet aan het vertalen van elk FreeBSD-document door dit te doen - als vrijwilliger kunt u zo veel of zo weinig vertalen als u wilt. Als iemand eenmaal begint te vertalen, sluiten andere mensen zich hier bijna altijd bij aan. Als u slechts de tijd of energie heeft om één document te vertalen, vertaal dan alstublieft de installatie-instructies.
. Lees af en toe (of regelmatig) de {freebsd-questions} en news:comp.unix.bsd.freebsd.misc. Het kan veel voldoening geven om uw expertise te delen en mensen helpen met het oplossen van hun problemen; soms leert u zelf misschien iets nieuws! Deze fora kunnen ook een inspiratiebron zijn voor dingen om aan te werken.
[[ongoing-programmer-tasks]]
@@ -105,7 +103,7 @@ Bijdragen aan het systeem vallen over het algemeen in één of meer van de volge
[[contrib-general]]
=== Foutrapportages en algemeen commentaar
-Een idee of suggestie van _algemene_ technische aard dient naar {freebsd-hackers} gemaild te worden. Evenzo kunnen mensen die in dit soort dingen geïnteresseerd zijn (en een tolerantie voor _grote_ hoeveelheden mail hebben!) zich abonneren op de {freebsd-hackers}. Zie link:{handbook}#eresources-mail[Het FreeBSD Handboek] voor meer informatie over deze en andere mailinglijsten.
+Een idee of suggestie van _algemene_ technische aard dient naar {freebsd-hackers} gemaild te worden. Evenzo kunnen mensen die in dit soort dingen geïnteresseerd zijn (en een tolerantie voor _grote_ hoeveelheden mail hebben!) zich abonneren op de {freebsd-hackers}. Zie extref:{handbook}eresources[Het FreeBSD Handboek, eresources-mail] voor meer informatie over deze en andere mailinglijsten.
Als u een bug vindt of een specifieke verandering opstuurt, gebruik dan alstublieft het programma man:send-pr[1] of het link:https://www.FreeBSD.org/send-pr/[webgebaseerde equivalent] om het te rapporteren. Probeer om elk veld van het bugrapport in te vullen. Voeg patches direct bij het rapport tenzij ze 65kB overschrijden. Als de patch geschikt is om op de broncodeboom te worden toegepast, vermeld dan `[PATCH]` in het overzicht van het rapport. Wanneer u patches bijvoegt, gebruik dan _geen_ knippen-en-plakken omdat knippen-en-plakken tabs in spaties omzet en de patches onbruikbaar maakt. Overweeg wanneer patches veel groter zijn dan 20 kB om ze te comprimeren (bijvoorbeeld met man:gzip[1] of man:bzip2[1]) en man:uuencode[1] te gebruiken om hun gecomprimeerde vorm in uw probleemrapport op te nemen.
@@ -113,15 +111,15 @@ Na het opsturen van een rapport dient u een bevestiging met daarbij een volgnumm
Als u geen bevestiging ontvangt binnen een redelijke tijd (3 dagen tot een week, afhankelijk van uw emailverbinding) of als u, om enige reden, het commando man:send-pr[1] niet kunt gebruiken, dan kunt u iemand vragen om het voor u op te sturen door mail te sturen naar de {freebsd-bugs}.
-Zie ook link:{problem-reports}[dit artikel] over het schrijven van goede probleemrapporten.
+Zie ook extref:{problem-reports}[dit artikel] over het schrijven van goede probleemrapporten.
=== Veranderingen aan de documentatie
-Veranderingen aan de documentatie worden overzien door de {freebsd-doc}. Bekijk de link:{fdp-primer}[FreeBSD Documentation Primer] voor volledige instructies. Stuur bijdragen en veranderingen (zelfs kleine zijn welkom!) door man:send-pr[1] te gebruiken zoals beschreven is in <<contrib-general>>.
+Veranderingen aan de documentatie worden overzien door de {freebsd-doc}. Bekijk de extref:{fdp-primer}[FreeBSD Documentation Primer] voor volledige instructies. Stuur bijdragen en veranderingen (zelfs kleine zijn welkom!) door man:send-pr[1] te gebruiken zoals beschreven is in <<contrib-general>>.
=== Veranderingen aan bestaande broncode
-Een toevoeging of verandering aan de bestaande broncode is een iets lastigere zaak en hangt in grote mate af van hoe ver u achterloopt met de huidige toestand van FreeBSD-ontwikkelingen. Er is een speciale doorgaande uitgave van FreeBSD die bekend staat als "FreeBSD-CURRENT" die op verscheidene manieren beschikbaar wordt gesteld voor het gemak van ontwikkelaars die actief aan het systeem werken. Zie link:{handbook}#current-stable[Het FreeBSD Handboek] voor meer informatie over het verkrijgen en gebruiken van FreeBSD-CURRENT.
+Een toevoeging of verandering aan de bestaande broncode is een iets lastigere zaak en hangt in grote mate af van hoe ver u achterloopt met de huidige toestand van FreeBSD-ontwikkelingen. Er is een speciale doorgaande uitgave van FreeBSD die bekend staat als "FreeBSD-CURRENT" die op verscheidene manieren beschikbaar wordt gesteld voor het gemak van ontwikkelaars die actief aan het systeem werken. Zie extref:{handbook}updating-upgrading[Het FreeBSD Handboek, current-stable] voor meer informatie over het verkrijgen en gebruiken van FreeBSD-CURRENT.
Het werken met oudere broncode betekent helaas dat uw veranderingen soms te verouderd of te ver afgedwaald zijn om eenvoudig in FreeBSD gerëintegreerd te worden. De kansen hierop kunnen enigszins geminimaliseerd worden door een abonnement te nemen op de {freebsd-announce} en de {freebsd-current} lijsten, waar discussies over de huidige toestand van het systeem plaatsvinden.
diff --git a/documentation/content/nl/articles/explaining-bsd/_index.adoc b/documentation/content/nl/articles/explaining-bsd/_index.adoc
index 7c99079882..1bd4c66a7e 100644
--- a/documentation/content/nl/articles/explaining-bsd/_index.adoc
+++ b/documentation/content/nl/articles/explaining-bsd/_index.adoc
@@ -3,7 +3,6 @@ title: Uitleg over BSD
authors:
- author: Greg Lehey
email: grog@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sparc", "sun", "unix", "general"]
---
@@ -16,13 +15,27 @@ trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sparc",
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Inhoudsopgave
-:part-signifier: Deel
-:chapter-signifier: Hoofdstuk
-:appendix-caption: Bijlage
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
+:images-path: articles/explaining-bsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Samenvatting
diff --git a/documentation/content/nl/articles/leap-seconds/_index.adoc b/documentation/content/nl/articles/leap-seconds/_index.adoc
index 9f63db3c58..561d3a6ee6 100644
--- a/documentation/content/nl/articles/leap-seconds/_index.adoc
+++ b/documentation/content/nl/articles/leap-seconds/_index.adoc
@@ -1,6 +1,5 @@
---
title: Ondersteuning voor schrikkelseconden in FreeBSD
-releaseinfo: "$FreeBSD$"
---
= Ondersteuning voor schrikkelseconden in FreeBSD
@@ -12,24 +11,26 @@ releaseinfo: "$FreeBSD$"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Inhoudsopgave
-:part-signifier: Deel
-:chapter-signifier: Hoofdstuk
-:appendix-caption: Bijlage
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-
-ifeval::["{backend}" == "html5"]
-include::shared/nl/urls.adoc[]
+:images-path: articles/leap-seconds/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/nl/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/nl/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -50,7 +51,7 @@ Het standaardgedrag van schrikkelseconden is beschreven in https://tools.ietf.or
[[leapseconds-posix]]
== De standaardomgang met schrikkelseconden op FreeBSD
-De eenvoudigste manier om met schrikkelseconden om te gaan is met de tijdregels van POSIX die FreeBSD standaard gebruikt, gecombineerd met link:{handbook}#network-ntp[NTP]. Wanneer man:ntpd[8] draait en de tijd gesynchroniseerd is met de bovenliggende NTP-servers die schrikkelseconden correct afhandelen, zal de schrikkelseconde ervoor zorgen dat de systeemtijd automatisch de laatste seconde van de dag herhaalt. Er zijn geen andere aanpassingen nodig.
+De eenvoudigste manier om met schrikkelseconden om te gaan is met de tijdregels van POSIX die FreeBSD standaard gebruikt, gecombineerd met extref:{handbook}network-servers[NTP, network-ntp]. Wanneer man:ntpd[8] draait en de tijd gesynchroniseerd is met de bovenliggende NTP-servers die schrikkelseconden correct afhandelen, zal de schrikkelseconde ervoor zorgen dat de systeemtijd automatisch de laatste seconde van de dag herhaalt. Er zijn geen andere aanpassingen nodig.
Als de bovenliggende NTP-servers schrikkelseconden niet correct afhandelen, zal man:ntpd[8] de tijd met één seconde laten verspringen nadat de foutieve bovenliggende server dit opgemerkt heeft en zelf is versprongen.
diff --git a/documentation/content/nl/articles/problem-reports/_index.adoc b/documentation/content/nl/articles/problem-reports/_index.adoc
index c7863603b4..6e0cfed3a7 100644
--- a/documentation/content/nl/articles/problem-reports/_index.adoc
+++ b/documentation/content/nl/articles/problem-reports/_index.adoc
@@ -3,7 +3,6 @@ title: Probleemrapporten voor FreeBSD schrijven
authors:
- author: Dag-Erling Smørgrav
- author: Mark Linimon
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "intel", "sparc", "sun", "general"]
---
@@ -16,27 +15,26 @@ trademarks: ["freebsd", "ibm", "intel", "sparc", "sun", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Inhoudsopgave
-:part-signifier: Deel
-:chapter-signifier: Hoofdstuk
-:appendix-caption: Bijlage
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-
-ifeval::["{backend}" == "html5"]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/urls.adoc[]
+:images-path: articles/problem-reports/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/nl/mailing-lists.adoc[]
-include::../../../../shared/nl/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/nl/mailing-lists.adoc[]
-include::../../../../shared/nl/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -76,7 +74,7 @@ Voor onbeheerde ports (`MAINTAINER` bevat `ports@FreeBSD.org`) kan zo'n updateme
+
Als de port beheerd wordt, zijn PR's die nieuwe stroomopwaartse uitgaven aankondigen niet erg nuttig aangezien ze aanvullend werk voor de committers genereren, en waarschijnlijk weet de beheerder al dat er een nieuwe versie uit is, ze hebben er waarschijnlijk met de ontwikkelaars aan gewerkt, ze zijn waarschijnlijk regressietesten aan het uitvoeren, enzovoorts.
+
-In beide gevallen zal het volgen van het proces zoals beschreven in het link:{porters-handbook}#port-upgrading[Porters Handboek] tot de beste resultaten leiden. (U bent misschien ook geïnteresseerd in link:{contributing-ports}[Bijdragen aan de FreeBSD Portscollectie].)
+In beide gevallen zal het volgen van het proces zoals beschreven in het extref:{porters-handbook}[Porters Handboek, port-upgrading] tot de beste resultaten leiden. (U bent misschien ook geïnteresseerd in link:{contributing-ports}[Bijdragen aan de FreeBSD Portscollectie].)
Een bug die niet reproduceerbaar is kan zelden gerepareerd worden. Als een bug slechts eenmalig voorkwam en u deze niet kunt reproduceren, en het bij niemand anders lijkt voor te komen, dan bestaat de kans dat geen van de ontwikkelaars het kan reproduceren of kan uitzoeken wat er mis is. Dit betekent niet dat het niet gebeurde, maar wel dat de kans dat uw probleemrapport ooit tot een reparatie leidt erg klein is. Om het allemaal erger te maken, worden dit soort bugs vaak veroorzaakt door falende harde schijven of oververhitte processoren - u dient altijd te proberen om deze oorzaken, indien mogelijk, uit te sluiten voordat u een PR instuurt.
@@ -88,7 +86,7 @@ Vervolgens, om te besluiten aan wie u uw probleemrapport dient te sturen, moet u
Daarna dient u vast te stellen of het probleem actueel is. Er zijn maar weinig dingen die een ontwikkelaar meer irriteren dan het ontvangen van een probleemrapport over een bug die reeds gerepareerd is.
-Als het probleem in het basissysteem zit, dient u eerst het FAQ-gedeelte over link:{faq}#LATEST-VERSION[FreeBSD-versies] te lezen als u niet reeds bekend bent met het onderwerp. Het is niet mogelijk voor FreeBSD om problemen in iets anders dan bepaalde recente takken van het basissysteem op te lossen, dus leidt het insturen van een bug-rapport over een oudere versie waarschijnlijk alleen tot het advies van een ontwikkelaar om naar een ondersteunde versie bij te werken om te kijken of het probleem nog steeds voorkomt. Het Security Officer Team onderhoudt de link:https://www.FreeBSD.org/security/[lijst van ondersteunde versies].
+Als het probleem in het basissysteem zit, dient u eerst het FAQ-gedeelte over extref:{faq}[FreeBSD-versies, LATEST-VERSION] te lezen als u niet reeds bekend bent met het onderwerp. Het is niet mogelijk voor FreeBSD om problemen in iets anders dan bepaalde recente takken van het basissysteem op te lossen, dus leidt het insturen van een bug-rapport over een oudere versie waarschijnlijk alleen tot het advies van een ontwikkelaar om naar een ondersteunde versie bij te werken om te kijken of het probleem nog steeds voorkomt. Het Security Officer Team onderhoudt de link:https://www.FreeBSD.org/security/[lijst van ondersteunde versies].
Als het probleem in een port zit, moet u uw Portscollectie eerst naar de laatste versie bijwerken en kijken of het probleem nog steeds van toepassing is. Wegens de hoge snelheid waarmee deze applicaties veranderen, is het onhaalbaar voor FreeBSD om iets anders dan de allernieuwste versies te ondersteunen, problemen met oudere versies van applicaties kunnen simpelweg niet worden opgelost.
@@ -97,8 +95,8 @@ Als het probleem in een port zit, moet u uw Portscollectie eerst naar de laatste
Een goede regel is om altijd een vooronderzoek te doen voordat u een probleemrapport ingestuurd. Misschien is uw probleem reeds gerapporteerd; misschien wordt het besproken op de mailinglijsten, of gebeurde dat recentelijk; misschien is het al gerepareerd in een nieuwere versie dan die u draait. Om deze redenen dient u alle voor de hand liggende plaatsen te controleren voordat u uw probleemrapport instuurt. Voor FreeBSD betekent dit:
-* De FreeBSD-lijst van link:{faq}[Veelgestelde Vragen] (FAQ). De FAQ probeert antwoord te geven op een breed scala aan vragen, zoals vragen die betrekking hebben op link:{faq}#hardware[compatibiliteit van hardware], link:{faq}#applications[gebruikersapplicaties], en link:{faq}#kernelconfig[kernelconfiguratie].
-* De link:{handbook}#eresources-mail[mailinglijsten]-als u niet geabonneerd bent, gebruik dan http://www.FreeBSD.org/search/#mailinglists[de doorzoekbare archieven] op de FreeBSD-website. Als uw probleem niet op de lijsten bediscussieerd is, kunt u proberen om er een bericht over te posten en enkele dagen wachten om te zien of iemand iets kan zien wat u misschien over het hoofd heeft gezien.
+* De FreeBSD-lijst van extref:{faq}[Veelgestelde Vragen] (FAQ). De FAQ probeert antwoord te geven op een breed scala aan vragen, zoals vragen die betrekking hebben op extref:{faq}[compatibiliteit van hardware, hardware], extref:{faq}[gebruikersapplicaties, applications], en extref:{faq}[kernelconfiguratie, kernelconfig].
+* De extref:{handbook}eresources[mailinglijsten, eresources-mail]-als u niet geabonneerd bent, gebruik dan http://www.FreeBSD.org/search/#mailinglists[de doorzoekbare archieven] op de FreeBSD-website. Als uw probleem niet op de lijsten bediscussieerd is, kunt u proberen om er een bericht over te posten en enkele dagen wachten om te zien of iemand iets kan zien wat u misschien over het hoofd heeft gezien.
* Optioneel, het gehele web-gebruik uw favoriete zoekmachine om referenties naar uw probleem te vinden. U kunt zelfs hits krijgen van gearchiveerde mailinglijsten of nieuwsgroepen die u niet kende of waarvan u er niet aan had gedacht om die te doorzoeken.
* Vervolgens, de doorzoekbare http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[FreeBSD PR-database] (GNATS). Tenzij uw probleem recent of obscuur is, bestaat er een redelijke kans dat het reeds gerapporteerd is.
* Het belangrijkste is dat u probeert te controleren of bestaande documentatie in de bronnen uw probleem bespreekt.
@@ -148,7 +146,7 @@ Nu u besloten heeft dat uw probleem een probleemrapport verdiend, en het een pro
Als u het programma man:send-pr[1] gebruikt, zorg er dan voor dat uw omgevingsvariabele `VISUAL` (of `EDITOR` als `VISUAL` niet is ingesteld) op iets zinnigs is ingesteld.
-U dient er ook zeker van te zijn dat het afleveren van mail goed werkt. man:send-pr[1] gebruikt mailberichten voor het insturen en volgen van probleemrapporten. Als u geen mailberichten kunt posten op de machine waarop u man:send-pr[1] draait, zal uw probleemrapport de GNATS-database niet bereiken. Zie voor details over het opzetten van mail op FreeBSD het hoofdstuk "Elektronische post" van het FreeBSD Handboek op link:{handbook}#mail[Elektronische mail].
+U dient er ook zeker van te zijn dat het afleveren van mail goed werkt. man:send-pr[1] gebruikt mailberichten voor het insturen en volgen van probleemrapporten. Als u geen mailberichten kunt posten op de machine waarop u man:send-pr[1] draait, zal uw probleemrapport de GNATS-database niet bereiken. Zie voor details over het opzetten van mail op FreeBSD het hoofdstuk "Elektronische post" van het FreeBSD Handboek op extref:{handbook}mail[Elektronische mail, mail].
Verzeker u ervan dat uw mailprogramma het bericht onderweg naar GNATS niet vermangelt. In het bijzonder zal elke patch die u instuurt onbruikbaar worden, als uw mailer automatisch regels afbreekt, tabs in spaties verandert, of nieuwe-regel-tekens escapet. Voor de tekstgedeelten vragen wij u echter om handmatig regels rond de 70 tekens af te breken, zodat de webversie van het PR leesbaar is.
@@ -378,4 +376,4 @@ In zeldzame gevallen zult een bug in GNATS tegenkomen waarbij een PR geaccepteer
Er is een lijst met bronnen die relevant is voor het juist schrijven en verwerken van probleemrapporten. Het is in geen geval compleet.
* http://www.chiark.greenend.org.uk/~sgtatham/bugs-nl.html[Effectief softwarestoringen melden]-een uitstekend essay door Simon G. Tatham over het samenstellen van nuttige (niet-FreeBSD-specifieke) probleemrapporten.
-* link:{pr-guidelines}[Problem Report Handling Guidelines]-waardevolle inzichten in hoe probleemrapporten worden afgehandeld door de FreeBSD-ontwikkelaars.
+* extref:{pr-guidelines}[Problem Report Handling Guidelines]-waardevolle inzichten in hoe probleemrapporten worden afgehandeld door de FreeBSD-ontwikkelaars.
diff --git a/documentation/content/nl/articles/solid-state/_index.adoc b/documentation/content/nl/articles/solid-state/_index.adoc
index b07e1b71dd..7be6e0d42f 100644
--- a/documentation/content/nl/articles/solid-state/_index.adoc
+++ b/documentation/content/nl/articles/solid-state/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: John Kozubik
email: john@kozubik.com
copyright: 2001, 2009 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -17,13 +16,27 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Inhoudsopgave
-:part-signifier: Deel
-:chapter-signifier: Hoofdstuk
-:appendix-caption: Bijlage
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
+:images-path: articles/solid-state/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Samenvatting
diff --git a/documentation/content/nl/books/handbook/_index.adoc b/documentation/content/nl/books/handbook/_index.adoc
index 3a1b3d65e2..9a6be466be 100644
--- a/documentation/content/nl/books/handbook/_index.adoc
+++ b/documentation/content/nl/books/handbook/_index.adoc
@@ -3,9 +3,9 @@ title: FreeBSD handboek
authors:
- author: The FreeBSD Dutch Documentation Project
copyright: 1995-2020 The FreeBSD Dutch Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
next: books/handbook/preface
+isIndex: true
---
= FreeBSD handboek
@@ -15,18 +15,32 @@ next: books/handbook/preface
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:toc-title: Inhoudsopgave
-:part-signifier: Deel
-:chapter-signifier: Hoofdstuk
-:appendix-caption: Bijlage
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
+:images-path: books/handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Samenvatting
@@ -35,10 +49,10 @@ Welkom bij FreeBSD! Dit handboek behandelt de installatie en het dagelijks gebru
'''
-include::content/nl/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
-include::content/nl/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
-include::content/nl/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
-include::content/nl/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/nl/books/handbook/advanced-networking/_index.adoc b/documentation/content/nl/books/handbook/advanced-networking/_index.adoc
index b5422fb0ad..27fa850d09 100644
--- a/documentation/content/nl/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/nl/books/handbook/advanced-networking/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 31
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 31
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[advanced-networking-synopsis]]
== Samenvatting
@@ -2662,7 +2660,7 @@ De meeste andere TA's zullen waarschijnlijk ook werken, TA-verkopers proberen er
Het echte probleem met externe TA's is dat, net zoals bij modems, een goede seriële kaart in de computer nodig is.
-Voor een goed begrip van seriële apparaten dient de tutorial link:{serial-uart}[FreeBSD Serial Hardware] en de verschillen tussen asynchrone en synchrone seriële poorten gelezen te worden.
+Voor een goed begrip van seriële apparaten dient de tutorial extref:{serial-uart}[FreeBSD Serial Hardware] en de verschillen tussen asynchrone en synchrone seriële poorten gelezen te worden.
Een TA die op een standaard seriële poort (asynchroon) van een PC draait beperkt de snelheid tot 115.2 Kbps, zelfs als er een 128 Kbps-verbinding beschikbaar is. Om de volledige 128 Kbps waartoe ISDN in staat is te gebruiken, dient de TA op een synchrone seriële kaart overgeplaatst te worden.
diff --git a/documentation/content/nl/books/handbook/audit/_index.adoc b/documentation/content/nl/books/handbook/audit/_index.adoc
index 041467cf8f..b0651b7fd8 100644
--- a/documentation/content/nl/books/handbook/audit/_index.adoc
+++ b/documentation/content/nl/books/handbook/audit/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/disks
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[audit-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/basics/_index.adoc b/documentation/content/nl/books/handbook/basics/_index.adoc
index fd2750da6c..eafaad6a92 100644
--- a/documentation/content/nl/books/handbook/basics/_index.adoc
+++ b/documentation/content/nl/books/handbook/basics/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ports
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[basics-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/bibliography/_index.adoc b/documentation/content/nl/books/handbook/bibliography/_index.adoc
index 9e89a36e47..80d56ca30a 100644
--- a/documentation/content/nl/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/nl/books/handbook/bibliography/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/eresources
[[bibliography]]
= Bibliography
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Hoewel de handleiding de juiste referentie is voor individuele stukken van het FreeBSD besturingssysteem, staan ze erom bekend niet te illustreren hoe de stukken in elkaar vallen om het hele besturingssysteem soepel te laten draaien. Daarom wordt er gesteld dat er geen vervanger is voor een goed boek over UNIX(R) systeembeheer en een goede gebruikershandleiding.
@@ -104,7 +118,7 @@ Een Italiaanse https://www.FreeBSD.org/doc/it_IT.ISO8859-15/books/unix-introduct
* Leffler, Samuel J., Marshall Kirk McKusick, _The Design and Implementation of the 4.3BSD UNIX Operating System: Answer Book_. Reading, Mass. : Addison-Wesley, 1991. ISBN 0-201-54629-9
* McKusick, Marshall Kirk, Keith Bostic, Michael J Karels, and John Quarterman. _The Design and Implementation of the 4.4BSD Operating System_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-54979-4
+
-Hoofdstuk 2 is link:{design-44bsd}[online] beschikbaar als onderdeel van het FreeBSD Documentatie Project.
+Hoofdstuk 2 is extref:{design-44bsd}[online] beschikbaar als onderdeel van het FreeBSD Documentatie Project.
* Stevens, W. Richard. _TCP/IP Illustrated, Volume 1: The Protocols_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-63346-9
* Schimmel, Curt. _Unix Systems for Modern Architectures_. Reading, Mass. : Addison-Wesley, 1994. ISBN 0-201-63338-8
* Stevens, W. Richard. _TCP/IP Illustrated, Volume 3: TCP for Transactions, HTTP, NNTP and the UNIX Domain Protocols_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-63495-3
diff --git a/documentation/content/nl/books/handbook/book.adoc b/documentation/content/nl/books/handbook/book.adoc
index 31c173483e..eec7a8c1f8 100644
--- a/documentation/content/nl/books/handbook/book.adoc
+++ b/documentation/content/nl/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: FreeBSD handboek
authors:
- author: The FreeBSD Dutch Documentation Project
copyright: 1995-2020 The FreeBSD Dutch Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
---
@@ -12,54 +11,35 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:part-signifier: Deel
-:chapter-signifier: Hoofdstuk
-:appendix-caption: Bijlage
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
:book: true
:pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
-:chapters-path: content/nl/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/nl/mailing-lists.adoc[]
-include::../../../../shared/nl/teams.adoc[]
-include::../../../../shared/nl/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/nl/mailing-lists.adoc[]
-include::../../../../shared/nl/teams.adoc[]
-include::../../../../shared/nl/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -74,95 +54,95 @@ toc::[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
// Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..26;36..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
-include::{chapters-path}install/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}install/_index.adoc[leveloffset=+1]
-include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1]
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
-include::{chapters-path}users/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}users/_index.adoc[leveloffset=+1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}jails/_index.adoc[leveloffset=+1]
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
-include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}filesystems/_index.adoc[leveloffset=+1]
-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
-include::{chapters-path}dtrace/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}dtrace/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=7..19]
+include::{chapters-path}partiv.adoc[lines=15..27]
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
// Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
:sectnums!:
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/nl/books/handbook/boot/_index.adoc b/documentation/content/nl/books/handbook/boot/_index.adoc
index 8c8cb223e6..cf19c4b47b 100644
--- a/documentation/content/nl/books/handbook/boot/_index.adoc
+++ b/documentation/content/nl/books/handbook/boot/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/users
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/bsdinstall/_index.adoc b/documentation/content/nl/books/handbook/bsdinstall/_index.adoc
index 16997995fe..d46c5e234a 100644
--- a/documentation/content/nl/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/nl/books/handbook/bsdinstall/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/basics
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 33
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
+:images-path: books/handbook/bsdinstall/
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/bsdinstall/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
-endif::[]
-
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
-endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[bsdinstall-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/config/_index.adoc b/documentation/content/nl/books/handbook/config/_index.adoc
index cea1e763da..114fb1c0eb 100644
--- a/documentation/content/nl/books/handbook/config/_index.adoc
+++ b/documentation/content/nl/books/handbook/config/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/boot
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/config/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/config/
-endif::[]
+:images-path: books/handbook/config/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/config/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[config-synopsis]]
== Overzicht
@@ -271,7 +269,7 @@ Dit is de basisopzet voor elk [.filename]#crontab# bestand. De enige uitzonderin
[IMPORTANT]
====
-De onderstaande procedure moet niet gebruikt worden om de systeemcrontab [.filename]#/etc/crontab# te wijzigen of te installeren. Er kan een gewone editor gebruikt worden. `cron` ziet dat het bestand veranderd is en begint direct met het gebruiken van de nieuwe versie. link:{faq}#ROOT-NOT-FOUND-CRON-ERRORS[Deze FAQ vraag] geeft verdere uitleg.
+De onderstaande procedure moet niet gebruikt worden om de systeemcrontab [.filename]#/etc/crontab# te wijzigen of te installeren. Er kan een gewone editor gebruikt worden. `cron` ziet dat het bestand veranderd is en begint direct met het gebruiken van de nieuwe versie. extref:{faq}[Deze FAQ vraag, ROOT-NOT-FOUND-CRON-ERRORS] geeft verdere uitleg.
====
Om een nieuwe [.filename]#crontab# te installeren moet eerst een bestand in het juiste formaat gemaakt worden en daarna moet het geiuml;nstalleerd worden met commando `crontab`:
@@ -358,7 +356,7 @@ De volgende woorden moeten in alle opstartscripts staan (ze zijn benodigd door m
Met deze methode kan een systeembeheerder gemakkelijk systeemdiensten besturen, zonder gedoe met "runlevels" zoals bij sommige andere UNIX(R) systemen.
-Meer informatie over het [.filename]#rc.d#-systeem staat in man:rc[8] en man:rc.subr[8]. Als u geïnteresseerd bent in het schrijven van uw eigen [.filename]#rc.d#-script of om de huidige scripts te verbeteren is wellicht link:{rc-scripting}[dit artikel] interessant.
+Meer informatie over het [.filename]#rc.d#-systeem staat in man:rc[8] en man:rc.subr[8]. Als u geïnteresseerd bent in het schrijven van uw eigen [.filename]#rc.d#-script of om de huidige scripts te verbeteren is wellicht extref:{rc-scripting}[dit artikel] interessant.
[[config-network-setup]]
== Netwerkkaarten instellen
diff --git a/documentation/content/nl/books/handbook/cutting-edge/_index.adoc b/documentation/content/nl/books/handbook/cutting-edge/_index.adoc
index 55d48123f6..0b1d5628e9 100644
--- a/documentation/content/nl/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/nl/books/handbook/cutting-edge/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/dtrace
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[updating-upgrading-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/desktop/_index.adoc b/documentation/content/nl/books/handbook/desktop/_index.adoc
index 9b0bb34cba..7a27fd3123 100644
--- a/documentation/content/nl/books/handbook/desktop/_index.adoc
+++ b/documentation/content/nl/books/handbook/desktop/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/multimedia
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[desktop-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/disks/_index.adoc b/documentation/content/nl/books/handbook/disks/_index.adoc
index 2e901bc54d..42cd334704 100644
--- a/documentation/content/nl/books/handbook/disks/_index.adoc
+++ b/documentation/content/nl/books/handbook/disks/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/geom
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[disks-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/dtrace/_index.adoc b/documentation/content/nl/books/handbook/dtrace/_index.adoc
index 661159cec3..bca84ca074 100644
--- a/documentation/content/nl/books/handbook/dtrace/_index.adoc
+++ b/documentation/content/nl/books/handbook/dtrace/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/dtrace/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
-endif::[]
+:images-path: books/handbook/dtrace/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dtrace-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/eresources/_index.adoc b/documentation/content/nl/books/handbook/eresources/_index.adoc
index 2ea4039a47..b6d2f992de 100644
--- a/documentation/content/nl/books/handbook/eresources/_index.adoc
+++ b/documentation/content/nl/books/handbook/eresources/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/pgpkeys
[[eresources]]
= Bronnen op Internet
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Door de snelle ontwikkeling van FreeBSD zijn gedrukte media niet zo praktisch om de laatste ontwikkelingen te volgen. Elektronische bronnen zijn de beste, en vaak de enige, om op de hoogte te blijven van de laatste ontwikkelingen. Omdat FreeBSD draait op de inzet van vrijwilligers, is de gebruikersgemeenschap vaak een soort "technische ondersteuningsgroep", die heeft ontdekt dat email, webfora, en USENET de meeste effectieve manieren zijn om de gebruikersgemeenschap te bereiken.
@@ -47,9 +60,9 @@ De doelstellingen van de verschillende lijsten staan onderaan dit document. _Lee
_Als u wilt testen of u naar de FreeBSD lijsten email kunt versturen, stuur dan een bericht naar {freebsd-test}._ Stuur alstublieft geen testberichten naar andere lijsten.
====
-Bij twijfel over naar welke lijst te posten, kan de pagina link:{freebsd-questions-article}[Hoe de beste resultaten uit de FreeBSD-vragen mailinglijst te halen] wellicht helpen.
+Bij twijfel over naar welke lijst te posten, kan de pagina extref:{freebsd-questions-article}[Hoe de beste resultaten uit de FreeBSD-vragen mailinglijst te halen] wellicht helpen.
-Alvorens naar enige lijst te posten, is het verstandig te leren hoe de mailinglijsten het beste gebruikt kunnen worden. Hoe bijvoorbeeld zich vaak herhalende discussies voorkomen kunnen worden door het document link:{mailing-list-faq}[Veel Gestelde Mailinglijstvragen] (FAQ) te lezen.
+Alvorens naar enige lijst te posten, is het verstandig te leren hoe de mailinglijsten het beste gebruikt kunnen worden. Hoe bijvoorbeeld zich vaak herhalende discussies voorkomen kunnen worden door het document extref:{mailing-list-faq}[Veel Gestelde Mailinglijstvragen] (FAQ) te lezen.
Voor alle mailinglijsten worden archieven bijgehouden die doorzocht kunnen worden op de link:https://www.FreeBSD.org/search/[FreeBSD World Wide Web server]. De met sleutelwoorden te doorzoeken archieven bieden een voortreffelijke methode om antwoorden te vinden op vaak gestelde vragen en horen geraadpleegd te worden voordat er vragen op een lijst worden gesteld. Merk op dat dit ook betekent dat berichten die naar de mailinglijsten van FreeBSD worden verzonden tot in de oneindigheid worden gearchiveerd. Overweeg, wanneer het beschermen van privacy belangrijk is, om een tweede emailadres dat weggegooid kan worden te gebruiken en om alleen publieke informatie te posten.
diff --git a/documentation/content/nl/books/handbook/filesystems/_index.adoc b/documentation/content/nl/books/handbook/filesystems/_index.adoc
index c19bcceaa1..cf1cf7ece0 100644
--- a/documentation/content/nl/books/handbook/filesystems/_index.adoc
+++ b/documentation/content/nl/books/handbook/filesystems/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/virtualization
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/filesystems/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
-endif::[]
+:images-path: books/handbook/filesystems/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[filesystems-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/firewalls/_index.adoc b/documentation/content/nl/books/handbook/firewalls/_index.adoc
index 253c7453c3..6b0831c8d6 100644
--- a/documentation/content/nl/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/nl/books/handbook/firewalls/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/advanced-networking
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 30
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 30
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[firewalls-intro]]
== Inleiding
diff --git a/documentation/content/nl/books/handbook/geom/_index.adoc b/documentation/content/nl/books/handbook/geom/_index.adoc
index f10c3d2f4c..3bc06a9be2 100644
--- a/documentation/content/nl/books/handbook/geom/_index.adoc
+++ b/documentation/content/nl/books/handbook/geom/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/filesystems
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[geom-synopsis]]
== Overzicht
@@ -950,4 +948,4 @@ In het geval dat er meerdere slices zijn, zal er een logboek voor elke slice gec
Voor performance doeleinden is het gewenst om het logboek op een andere schijf te bewaren. Voor deze gevallen moet de logboekleverancier of het opslagapparaat gespecificeerd worden achter het apparaat waarop de logboek functionaliteit aangebracht moet worden. De logboekfunctionaliteit kan ook worden ingeschakeld op een reeds bestaand systeem met behulp van `tunefs`. Maak echter altijd een back-up voor dat dit soort dingen uitgeprobeerd worden. In de meeste gevallen zal `gjournal` falen als het geen actueel logboek kan maken, maar het voorkomt geen dataverlies als gevolg van verkeerd gebruik van `tunefs`.
-Het is ook mogelijk om een journal van de opstartschijf van een FreeBSD-systeem bij te houden. Voor gedetailleerde instructies over deze taak wordt naar het artikel link:{gjournal-desktop}[Implementing UFS Journaling on a Desktop PC] verwezen.
+Het is ook mogelijk om een journal van de opstartschijf van een FreeBSD-systeem bij te houden. Voor gedetailleerde instructies over deze taak wordt naar het artikel extref:{gjournal-desktop}[Implementing UFS Journaling on a Desktop PC] verwezen.
diff --git a/documentation/content/nl/books/handbook/install/_index.adoc b/documentation/content/nl/books/handbook/install/_index.adoc
index 56435744c2..e4f69887c3 100644
--- a/documentation/content/nl/books/handbook/install/_index.adoc
+++ b/documentation/content/nl/books/handbook/install/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/bsdinstall
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/install/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/install/
-endif::[]
+:images-path: books/handbook/install/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/install/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[install-synopsis]]
== Overzicht
@@ -2367,7 +2365,7 @@ Als de CD's op een ander platform worden gebrand, gebruik dan de op dat platform
[NOTE]
====
-Als er interesse is in het bouwen van een aangepaste versie van FreeBSD dan staat hierover informatie in het link:{releng}[Release Engineering artikel].
+Als er interesse is in het bouwen van een aangepaste versie van FreeBSD dan staat hierover informatie in het extref:{releng}[Release Engineering artikel].
====
[[install-ftp]]
@@ -2481,7 +2479,7 @@ Een toe te wijzen IP-adres op het netwerk, het netmask van de adresklasse en de
Als een modem wordt gebruikt is PPP hoogstwaarschijnlijk de enige mogelijkheid. Er dient informatie over de provider beschikbaar te zijn omdat die redelijk vroeg in het installatieproces nodig is.
-Als PAP of CHAP wordt gebruikt om een verbinding te maken met een ISP (met andere woorden als een verbinding gemaakt kan worden met een ISP onder Windows(R) zonder een script te gebruiken), dan is alles wat gedaan moet worden het ingeven van het `dial` commando op de ppp prompt. Anders moet bekend zijn hoe de ISP gebeld moet worden met "AT commando's" die specifiek zijn voor een modem, aangezien de PPP-dialer slechts een erg eenvoudige terminal emulator bevat. In het ppp-gebruikers crossref:ppp-and-slip[userppp,handboek] en de link:{faq}#ppp/[FAQ] staat meer informatie. Bij problemen kan de log naar het scherm worden gestuurd met het commando `set log local ...`.
+Als PAP of CHAP wordt gebruikt om een verbinding te maken met een ISP (met andere woorden als een verbinding gemaakt kan worden met een ISP onder Windows(R) zonder een script te gebruiken), dan is alles wat gedaan moet worden het ingeven van het `dial` commando op de ppp prompt. Anders moet bekend zijn hoe de ISP gebeld moet worden met "AT commando's" die specifiek zijn voor een modem, aangezien de PPP-dialer slechts een erg eenvoudige terminal emulator bevat. In het ppp-gebruikers crossref:ppp-and-slip[userppp,handboek] en de extref:{faq}[FAQ, ppp] staat meer informatie. Bij problemen kan de log naar het scherm worden gestuurd met het commando `set log local ...`.
Als een hard-wired verbinding naar een andere FreeBSD machine beschikbaar is kan ook overwogen worden te installeren via een "laplink" parallelle poort kabel. De snelheid van een parallelle poort is veel hoger dan wat normaal mogelijk is over een seriële kabel (tot 50 kbytes/sec), resulterend een veel snellere installatie.
diff --git a/documentation/content/nl/books/handbook/introduction/_index.adoc b/documentation/content/nl/books/handbook/introduction/_index.adoc
index 437b9dd509..e72448e998 100644
--- a/documentation/content/nl/books/handbook/introduction/_index.adoc
+++ b/documentation/content/nl/books/handbook/introduction/_index.adoc
@@ -13,25 +13,35 @@ next: books/handbook/install
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/handbook/introduction/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-synopsis]]
== Overzicht
@@ -49,7 +59,7 @@ Na het lezen van dit hoofdstuk weet de lezer:
[[nutshell]]
== Welkom bij FreeBSD!
-FreeBSD is een op 4.4BSD-Lite gebaseerd besturingssysteem voor Intel (x86 en Itanium(R)), AMD64 en Sun UltraSPARC(R) computers. Er zijn ook ports naar andere architecturen in voorbereiding. Er is nog meer informatie over de <<history,geschiedenis van FreeBSD>> of over de <<relnotes,huidige uitgave>>. Als de lezer wil bijdragen aan het project (code, hardware, geld) wordt aangeraden het artikel link:{contributing}/[Bijdragen aan FreeBSD] te lezen.
+FreeBSD is een op 4.4BSD-Lite gebaseerd besturingssysteem voor Intel (x86 en Itanium(R)), AMD64 en Sun UltraSPARC(R) computers. Er zijn ook ports naar andere architecturen in voorbereiding. Er is nog meer informatie over de <<history,geschiedenis van FreeBSD>> of over de <<relnotes,huidige uitgave>>. Als de lezer wil bijdragen aan het project (code, hardware, geld) wordt aangeraden het artikel extref:{contributing}[Bijdragen aan FreeBSD] te lezen.
[[os-overview]]
=== Wat kan FreeBSD?
@@ -179,7 +189,7 @@ Sommige code in FreeBSD valt onder de GNU General Public License (GPL) of Librar
[[development]]
=== Het FreeBSD ontwikkelmodel
-De ontwikkeling van FreeBSD is een erg open en flexibel proces en wordt gevormd door de bijdragen van letterlijk honderden mensen over de hele wereld, zoals te zien is in de link:{contributors}[lijst van medewerkers]. De infrastructuur die wordt gebruikt voor de ontwikkeling van FreeBSD zorgt ervoor dat deze honderden ontwikkelaars kunnen samenwerken over het Internet. Het FreeBSD Project is continu op zoek naar nieuwe ontwikkelaars en ideeën. Om bij te dragen aan de ontwikkeling van FreeBSD is een mail naar {freebsd-hackers} voldoende. De {freebsd-announce} is beschikbaar om mededelingen te doen aan andere FreeBSD-gebruikers over grote veranderingen.
+De ontwikkeling van FreeBSD is een erg open en flexibel proces en wordt gevormd door de bijdragen van letterlijk honderden mensen over de hele wereld, zoals te zien is in de extref:{contributors}[lijst van medewerkers]. De infrastructuur die wordt gebruikt voor de ontwikkeling van FreeBSD zorgt ervoor dat deze honderden ontwikkelaars kunnen samenwerken over het Internet. Het FreeBSD Project is continu op zoek naar nieuwe ontwikkelaars en ideeën. Om bij te dragen aan de ontwikkeling van FreeBSD is een mail naar {freebsd-hackers} voldoende. De {freebsd-announce} is beschikbaar om mededelingen te doen aan andere FreeBSD-gebruikers over grote veranderingen.
Een aantal dingen over het FreeBSD Project en haar ontwikkelingsproces zijn handig om te weten, of een bijdrage nu onafhankelijk of in samenwerking met anderen komt:
@@ -196,7 +206,7 @@ De zogenaamde _committers_ zijn alle mensen die _schrijf_-rechten hebben in het
Het FreeBSD Core Team[[development-core]]::
Het _FreeBSD core team_ zou het equivalent zijn van een raad van bestuur als het FreeBSD Project een bedrijf zou zijn. De primaire taak van het core team is ervoor zorg te dragen dat het project, in zijn geheel, in goede vorm verkeert en de goede richting opgaat. Toegewijde en verantwoordelijke ontwikkelaars uitnodigen om deel te worden van de committers is één van de taken van het core team, net als het rekruteren van nieuwe leden van het core team. Het huidige core team is gekozen door de committers uit een groep van kandidaten (ook allen committers) in juli 2012. Elke twee jaar worden verkiezingen gehouden.
+
-Sommige leden van het core team hebben een bijzondere verantwoordelijkheid, wat wil zeggen dat zij er speciaal op toezien dat een bepaald deel van het systeem werkt zoals het hoort. In de link:{contributors}[lijst van medewerkers] staat een complete lijst van ontwikkelaars en hun verantwoordelijkheden.
+Sommige leden van het core team hebben een bijzondere verantwoordelijkheid, wat wil zeggen dat zij er speciaal op toezien dat een bepaald deel van het systeem werkt zoals het hoort. In de extref:{contributors}[lijst van medewerkers] staat een complete lijst van ontwikkelaars en hun verantwoordelijkheden.
+
[NOTE]
====
@@ -206,7 +216,7 @@ De meeste leden van het core team zijn vrijwilligers. "Toewijding" betekent dus
Externe Bijdragen::
De grootste groep ontwikkelaars zijn de gebruikers zelf, die FreeBSD continu voorzien van constructief commentaar en oplossingen voor fouten. De handigste manier om contact te houden met het niet-gecentraliseerde deel van de ontwikkeling van FreeBSD is een abonnement nemen op de {freebsd-hackers}, waar allerlei bijdragen, patches en nieuwe ideeën worden bediscussieerd. In crossref:eresources[eresources,Bronnen op Internet] is meer informatie te vinden over de verschillende FreeBSD mailinglijsten.
+
-link:{contributors}[De lijst van medewerkers] is lang en groeit iedere dag, dus wat let de lezer om zelf een bijdrage te doen aan FreeBSD?
+extref:{contributors}[De lijst van medewerkers] is lang en groeit iedere dag, dus wat let de lezer om zelf een bijdrage te doen aan FreeBSD?
+
Programmeren is niet de enige manier om een bijdrage te leveren aan het project. Een meer volledige lijst van dingen die gedaan moeten worden staat op de link:https://www.FreeBSD.org/[FreeBSD website].
diff --git a/documentation/content/nl/books/handbook/jails/_index.adoc b/documentation/content/nl/books/handbook/jails/_index.adoc
index 9296e90a12..98c1c854cb 100644
--- a/documentation/content/nl/books/handbook/jails/_index.adoc
+++ b/documentation/content/nl/books/handbook/jails/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mac
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/jails/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
-endif::[]
+:images-path: books/handbook/jails/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[jails-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/kernelconfig/_index.adoc b/documentation/content/nl/books/handbook/kernelconfig/_index.adoc
index f08c78425c..73b7b6124c 100644
--- a/documentation/content/nl/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/nl/books/handbook/kernelconfig/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/printing
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kernelconfig-synopsis]]
== Samenvatting
diff --git a/documentation/content/nl/books/handbook/l10n/_index.adoc b/documentation/content/nl/books/handbook/l10n/_index.adoc
index 68530a8242..58c70bde87 100644
--- a/documentation/content/nl/books/handbook/l10n/_index.adoc
+++ b/documentation/content/nl/books/handbook/l10n/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/cutting-edge
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/linuxemu/_index.adoc b/documentation/content/nl/books/handbook/linuxemu/_index.adoc
index 652d907663..ac50fb503e 100644
--- a/documentation/content/nl/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/nl/books/handbook/linuxemu/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[linuxemu-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/mac/_index.adoc b/documentation/content/nl/books/handbook/mac/_index.adoc
index a3e1d47342..833378d6be 100644
--- a/documentation/content/nl/books/handbook/mac/_index.adoc
+++ b/documentation/content/nl/books/handbook/mac/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/audit
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/mail/_index.adoc b/documentation/content/nl/books/handbook/mail/_index.adoc
index dfee3806f7..acb1e30fa3 100644
--- a/documentation/content/nl/books/handbook/mail/_index.adoc
+++ b/documentation/content/nl/books/handbook/mail/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/network-servers
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 28
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 28
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mail-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/mirrors/_index.adoc b/documentation/content/nl/books/handbook/mirrors/_index.adoc
index a2a72cedfa..5583c759ec 100644
--- a/documentation/content/nl/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/nl/books/handbook/mirrors/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/bibliography
[[mirrors]]
= FreeBSD verkrijgen
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mirrors-cdrom]]
== CD-ROM en DVD uitgevers
@@ -1032,7 +1045,7 @@ Als `ports-all` (het complete portssysteem) niet bijgewerkt hoeft te worden, maa
+
[IMPORTANT]
====
-Bij het zelf bouwen van een lokale kopie van [.filename]#ports/INDEX#_moet_`ports-all` geaccepteerd worden (de hele port structuur). Het bouwen van [.filename]#ports/INDEX# met een gedeeltelijke structuur wordt niet ondersteund. Zie ook de link:{faq}#MAKE-INDEX[FAQ].
+Bij het zelf bouwen van een lokale kopie van [.filename]#ports/INDEX#_moet_`ports-all` geaccepteerd worden (de hele port structuur). Het bouwen van [.filename]#ports/INDEX# met een gedeeltelijke structuur wordt niet ondersteund. Zie ook de extref:{faq}[FAQ, MAKE-INDEX].
====
`ports-accessibility release=cvs`::::
@@ -1466,7 +1479,7 @@ De ontwikkellijn voor FreeBSD-2.2.X, ook bekend als 2.2-STABLE. Deze tak is ster
=== Releaselabels
-Deze labels refereren aan een specifiek moment in de tijd waarop een versie van FreeBSD is uitgegeven. Het proces om tot een release te komen is gedetailleerder beschreven in de link:https://www.FreeBSD.org/releng/[Release Engineering Informatie] en link:{releng}#release-proc/[Release Proces] documenten. De [.filename]#src# structuur gebruikt labelnamen die beginnen met `RELENG_` labels. De [.filename]#ports# en [.filename]#doc# structuren gebruiken labels waarvan de naam begint met het label `RELEASE`. De [.filename]#www# tenslotte, is niet gemarkeerd met een bijzondere naam bij uitgaven.
+Deze labels refereren aan een specifiek moment in de tijd waarop een versie van FreeBSD is uitgegeven. Het proces om tot een release te komen is gedetailleerder beschreven in de link:https://www.FreeBSD.org/releng/[Release Engineering Informatie] en extref:{releng}[Release Proces, release-proc/] documenten. De [.filename]#src# structuur gebruikt labelnamen die beginnen met `RELENG_` labels. De [.filename]#ports# en [.filename]#doc# structuren gebruiken labels waarvan de naam begint met het label `RELEASE`. De [.filename]#www# tenslotte, is niet gemarkeerd met een bijzondere naam bij uitgaven.
RELENG_9_0_0_RELEASE::
FreeBSD 9.0
diff --git a/documentation/content/nl/books/handbook/multimedia/_index.adoc b/documentation/content/nl/books/handbook/multimedia/_index.adoc
index cb2b9c7494..867a8ba19f 100644
--- a/documentation/content/nl/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/nl/books/handbook/multimedia/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/kernelconfig
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[multimedia-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/network-servers/_index.adoc b/documentation/content/nl/books/handbook/network-servers/_index.adoc
index c818cf03f3..a1fa60c432 100644
--- a/documentation/content/nl/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/nl/books/handbook/network-servers/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/firewalls
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 29
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 29
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[network-servers-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/parti.adoc b/documentation/content/nl/books/handbook/parti.adoc
index c81d287b38..6bc5f85771 100644
--- a/documentation/content/nl/books/handbook/parti.adoc
+++ b/documentation/content/nl/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
next: books/handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[getting-started]]
= Beginnen
@@ -17,4 +25,4 @@ Dit deel van het FreeBSD handboek is voor gebruikers en beheerders die net begin
Er is geprobeerd het aantal vooruitwijzingen tot een minimum te beperken zodat het handboek van begin tot einde gelezen kan worden zonder bladeren.
-include::content/nl/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/nl/books/handbook/partii.adoc b/documentation/content/nl/books/handbook/partii.adoc
index 2bf3d4d348..78f9aebb1d 100644
--- a/documentation/content/nl/books/handbook/partii.adoc
+++ b/documentation/content/nl/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
next: books/handbook/desktop
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[common-tasks]]
= Algemene taken
@@ -17,4 +25,4 @@ Na de inleiding gaat dit deel van het FreeBSD handboek over een aantal vaak gebr
In een aantal van de hoofdstukken wordt voorkennis aangeraden. Dit staat vermeld in de inleiding van ieder hoofdstuk.
-include::content/nl/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/nl/books/handbook/partiii.adoc b/documentation/content/nl/books/handbook/partiii.adoc
index 21b1f66011..f669ca4836 100644
--- a/documentation/content/nl/books/handbook/partiii.adoc
+++ b/documentation/content/nl/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
next: books/handbook/config
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[system-administration]]
= Systeembeheer
@@ -11,4 +19,4 @@ De verdere hoofdstukken van het FreeBSD handboek beslaan alle aspecten van het F
De hoofdstukken zijn ook ontworpen om gelezen te worden als de specifieke informatie nodig is. Ze hoeven niet in een bepaalde volgorde gelezen te worden en ze hoeven ook niet gelezen te zijn voordat een gebruiker met FreeBSD aan de slag kan.
-include::content/nl/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/nl/books/handbook/partiv.adoc b/documentation/content/nl/books/handbook/partiv.adoc
index ae929bbc7c..19dac111a9 100644
--- a/documentation/content/nl/books/handbook/partiv.adoc
+++ b/documentation/content/nl/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/usb-device-mode
next: books/handbook/serialcomms
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[network-communication]]
= Netwerkcommunicatie
@@ -18,4 +26,4 @@ Als het om servers gaat die hoge prestaties moeten leveren, wordt wereldwijd vaa
Deze hoofdstukken zijn geschreven om gelezen te worden als de informatie nodig is. Ze hoeven niet allemaal in een bepaalde volgorde gelezen te worden. Ze hoeven ook niet allemaal gelezen te worden om FreeBSD in een netwerkomgeving in te zetten.
-include::content/nl/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/nl/books/handbook/partv.adoc b/documentation/content/nl/books/handbook/partv.adoc
index 0268b78a99..3aa7e172a5 100644
--- a/documentation/content/nl/books/handbook/partv.adoc
+++ b/documentation/content/nl/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
next: books/handbook/mirrors
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= Appendix
-include::content/nl/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/nl/books/handbook/pgpkeys/_index.adoc b/documentation/content/nl/books/handbook/pgpkeys/_index.adoc
index 35f8740cff..03722efccc 100644
--- a/documentation/content/nl/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/nl/books/handbook/pgpkeys/_index.adoc
@@ -9,28 +9,44 @@ next: books/handbook/freebsd-glossary
[[pgpkeys]]
= PGP sleutels
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
In het geval een handtekening van een van de beambten of ontwikkelaars gecontroleerd moet worden of er een versleutelde e-mail aan ze gezonden moet worden, worden hier voor het gemak een aantal sleutels weergegeven. Een complete sleutelring van `FreeBSD.org` gebruikers kan op de volgende link gedownload worden: link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
diff --git a/documentation/content/nl/books/handbook/ports/_index.adoc b/documentation/content/nl/books/handbook/ports/_index.adoc
index 3f1d655d88..1e1af854d1 100644
--- a/documentation/content/nl/books/handbook/ports/_index.adoc
+++ b/documentation/content/nl/books/handbook/ports/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/x11
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ports-synopsis]]
== Overzicht
@@ -347,7 +345,7 @@ Nadat het eerste gebruik van Portsnap is voltooid zoals hierboven is aangegeven,
====
*Procedure: Met Subversion*
-Als meer controle over de ports-boom nodig is (om bijvoorbeeld lokale veranderingen te beheren) kan Subversion worden gebruikt om de Portscollectie te verkrijgen. Zie de link:{committers-guide}#subversion-primer/[Subversion Primer] voor een gedetailleerde beschrijving van Subversion.
+Als meer controle over de ports-boom nodig is (om bijvoorbeeld lokale veranderingen te beheren) kan Subversion worden gebruikt om de Portscollectie te verkrijgen. Zie de extref:{committers-guide}[Subversion Primer, subversion-primer] voor een gedetailleerde beschrijving van Subversion.
. Subversion moet geïnstalleerd zijn voordat het gebruikt kan worden om de ports-boom uit te checken. Als er reeds een kopie van de ports-boom aanwezig is, installeer dan Subversion als volgt:
+
@@ -371,7 +369,7 @@ Als pkgng wordt gebruikt om pakketten te beheren, kan Subversion in plaats daarv
# pkg install subversion
....
+
-. Check een kopie van de ports-boom uit. Gebruik voor een betere prestatie een specifieke link:{handbook}#mirrors-svn/[Subversion mirror] dichtbij u in plaats van _svn.FreeBSD.org_ in onderstaand commando. Committers dienen eerst de link:{committers-guide}#subversion-primer/[Subversion Primer] te lezen om er zeker van te zijn dat het juiste protocol is gekozen.
+. Check een kopie van de ports-boom uit. Gebruik voor een betere prestatie een specifieke extref:{handbook}mirrors[Subversion mirror, svn-mirrors] dichtbij u in plaats van _svn.FreeBSD.org_ in onderstaand commando. Committers dienen eerst de extref:{committers-guide}[Subversion Primer, subversion-primer] te lezen om er zeker van te zijn dat het juiste protocol is gekozen.
+
[source,shell]
....
@@ -533,7 +531,7 @@ Deze map kan ook andere bestanden bevatten die gebruikt worden om de port te bou
* Een bestand [.filename]#pkg-descr#. Dit is een meer gedetailleerde beschrijving van het programma, vaak in één regel;
* Een bestand [.filename]#pkg-plist#. Dit is een lijst met alle bestanden die door de port geïnstalleerd worden. Het geeft het portssysteem ook aan welke bestanden bij het verwijderen van de port weer verwijderd kunnen worden.
-Sommige ports bevatten nog andere bestanden, zoals [.filename]#pkg-message#. Het portssysteem gebruikt die bestanden voor het afhandelen van bijzondere situaties. Meer details over die bestanden en over ports in het algemeen zijn na te lezen in het link:{porters-handbook}[FreeBSD Handboek voor Porters].
+Sommige ports bevatten nog andere bestanden, zoals [.filename]#pkg-message#. Het portssysteem gebruikt die bestanden voor het afhandelen van bijzondere situaties. Meer details over die bestanden en over ports in het algemeen zijn na te lezen in het extref:{porters-handbook}[FreeBSD Handboek voor Porters].
De port bevat instructies over hoe de broncode gebouwd moet worden, maar de broncode zelf is er geen onderdeel van. De broncode staat op een CD-ROM of op Internet. De broncode wordt verspreid op de wijze waarop de auteur dat wenst. Vaak is dat als een tar of gzip bestand, maar het kan ook ingepakt zijn met een ander programma of helemaal niet ingepakt zijn. De broncode van een programma, in welke vorm dan ook, heet een "distributiebestand". De twee methoden om een FreeBSD port te installeren worden hieronder beschreven.
@@ -913,11 +911,11 @@ Als een port niet werkt, zijn er een aantal mogelijke manieren om verder te kome
+
[NOTE]
====
-Sommige ports worden niet beheerd door een individu maar in plaats daarvan door een link:{mailing-list-faq}[mailinglijst]. Veel, maar niet alle, van deze adressen zien eruit als mailto:freebsd-lijstnaam@FreeBSD.org[freebsd-lijstnaam@FreeBSD.org]. Houd hier alstublieft rekening mee bij het formuleren van vragen.
+Sommige ports worden niet beheerd door een individu maar in plaats daarvan door een extref:{mailing-list-faq}[mailinglijst]. Veel, maar niet alle, van deze adressen zien eruit als mailto:freebsd-lijstnaam@FreeBSD.org[freebsd-lijstnaam@FreeBSD.org]. Houd hier alstublieft rekening mee bij het formuleren van vragen.
In het bijzonder worden ports die geregistreerd staan als onderhouden door mailto:ports@FreeBSD.org[ports@FreeBSD.org] helemaal niet onderhouden. Reparaties en ondersteuning, als dat al beschikbaar is, komt vanuit de gemeenschap die is geabonneerd op die mailinglijst. Meer vrijwilligers zijn altijd nodig!
====
+
-Als er geen antwoord komt, stuur dan met man:send-pr[1] een foutrapport in. Zie link:{problem-reports}[Writing FreeBSD Problem Reports]).
-. Repareren! In het link:{porters-handbook}[Handboek voor de Porter] is gedetailleerde informatie te vinden over de infrastructuur van de "Ports", zodat een kapotte port gemaakt kan worden of er zelfs een nieuwe port ingestuurd kan worden.
+Als er geen antwoord komt, stuur dan met man:send-pr[1] een foutrapport in. Zie extref:{problem-reports}[Writing FreeBSD Problem Reports]).
+. Repareren! In het extref:{porters-handbook}[Handboek voor de Porter] is gedetailleerde informatie te vinden over de infrastructuur van de "Ports", zodat een kapotte port gemaakt kan worden of er zelfs een nieuwe port ingestuurd kan worden.
. Zoek een pakket van een FTP site in de buurt. De "master" pakketcollectie staat op `ftp.FreeBSD.org` in de link:ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/[map pakketten], maar het is van belang dat er _eerst_ crossref:mirrors[mirrors-ftp,in de buurt] wordt gekeken! Dat het pakket werkt is waarschijnlijker dan wanneer uit de broncode wordt gecompileerd en het is nog sneller ook. Een pakket kan met man:pkg_add[1] geïnstalleerd worden.
diff --git a/documentation/content/nl/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/nl/books/handbook/ppp-and-slip/_index.adoc
index 42593337c2..c26c59b25e 100644
--- a/documentation/content/nl/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/nl/books/handbook/ppp-and-slip/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mail
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ppp-and-slip-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/preface/_index.adoc b/documentation/content/nl/books/handbook/preface/_index.adoc
index fa95d2f14e..65ee57be49 100644
--- a/documentation/content/nl/books/handbook/preface/_index.adoc
+++ b/documentation/content/nl/books/handbook/preface/_index.adoc
@@ -13,14 +13,31 @@ next: books/handbook/parti
:icons: font
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-audience]]
== Bedoeld publiek
diff --git a/documentation/content/nl/books/handbook/printing/_index.adoc b/documentation/content/nl/books/handbook/printing/_index.adoc
index 152579f180..909b6ecad8 100644
--- a/documentation/content/nl/books/handbook/printing/_index.adoc
+++ b/documentation/content/nl/books/handbook/printing/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/linuxemu
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/printing/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[printing-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/security/_index.adoc b/documentation/content/nl/books/handbook/security/_index.adoc
index e0f5249cea..d24ba2cc70 100644
--- a/documentation/content/nl/books/handbook/security/_index.adoc
+++ b/documentation/content/nl/books/handbook/security/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/jails
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/serialcomms/_index.adoc b/documentation/content/nl/books/handbook/serialcomms/_index.adoc
index 4d6e05b25e..7cbb36c397 100644
--- a/documentation/content/nl/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/nl/books/handbook/serialcomms/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ppp-and-slip
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[serial-synopsis]]
== Overzicht
@@ -1157,7 +1155,7 @@ Zet console-ondersteuning voor deze eenheid aan. De andere consolevlaggen worden
Dwingt deze eenheid om de console te zijn (tenzij er een andere console met hogere prioriteit is), ongeacht de onderstaande optie `-h`. De vlag `0x20` dient samen met de vlag `0x10` gebruikt te worden.
+
`0x40`:::
-Reserveert deze eenheid (in samenwerking met `0x10`) en maakt de eenheid ontoegankelijk voor normale toegang. Deze vlag dient niet aangezet te worden op de seriële poort van de eenheid die als seriële console gebruikt gaat worden. De enige functie van deze vlag is de eenheid voor het debuggen van de kernel op afstand aan te merken. Zie het link:{developers-handbook}[Ontwikkelaarshandboek] voor meer informatie over debuggen op afstand.
+Reserveert deze eenheid (in samenwerking met `0x10`) en maakt de eenheid ontoegankelijk voor normale toegang. Deze vlag dient niet aangezet te worden op de seriële poort van de eenheid die als seriële console gebruikt gaat worden. De enige functie van deze vlag is de eenheid voor het debuggen van de kernel op afstand aan te merken. Zie het extref:{developers-handbook}[Ontwikkelaarshandboek] voor meer informatie over debuggen op afstand.
+
Voorbeeld:
+
diff --git a/documentation/content/nl/books/handbook/users/_index.adoc b/documentation/content/nl/books/handbook/users/_index.adoc
index ab9e925997..e885f2e838 100644
--- a/documentation/content/nl/books/handbook/users/_index.adoc
+++ b/documentation/content/nl/books/handbook/users/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/security
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/users/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/users/
-endif::[]
+:images-path: books/handbook/users/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/users/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[users-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/virtualization/_index.adoc b/documentation/content/nl/books/handbook/virtualization/_index.adoc
index b3263fbca0..f59ad41fbb 100644
--- a/documentation/content/nl/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/nl/books/handbook/virtualization/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/l10n
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/virtualization/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
-endif::[]
+:images-path: books/handbook/virtualization/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[virtualization-synopsis]]
== Overzicht
diff --git a/documentation/content/nl/books/handbook/x11/_index.adoc b/documentation/content/nl/books/handbook/x11/_index.adoc
index 7c15b91c66..13c29ccc73 100644
--- a/documentation/content/nl/books/handbook/x11/_index.adoc
+++ b/documentation/content/nl/books/handbook/x11/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Inhoudsopgave
-:table-caption: Tabel
-:figure-caption: Afbeelding
-:example-caption: Voorbeeld
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/nl/mailing-lists.adoc[]
-include::shared/nl/teams.adoc[]
-include::shared/nl/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[x11-synopsis]]
== Overzicht
diff --git a/documentation/content/pl/articles/filtering-bridges/_index.adoc b/documentation/content/pl/articles/filtering-bridges/_index.adoc
index 018e7cb6ae..7b804e1aad 100644
--- a/documentation/content/pl/articles/filtering-bridges/_index.adoc
+++ b/documentation/content/pl/articles/filtering-bridges/_index.adoc
@@ -3,7 +3,6 @@ title: Mosty filtrujące
authors:
- author: Alex Dupre
email: sysadmin@alexdupre.com
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "3com", "intel", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "3com", "intel", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Spis treści
-:part-signifier: Część
-:chapter-signifier: Rozdział
-:appendix-caption: Dodatek
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-
-ifeval::["{backend}" == "html5"]
-include::shared/pl/urls.adoc[]
+:images-path: articles/filtering-bridges/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pl/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pl/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -80,7 +81,7 @@ options IPFIREWALL_VERBOSE
Pierwszy wiersz włącza do jądra obsługę mostu, drugi obsługę firewalla, a trzeci funkcje rejestrujące firewalla.
-Teraz trzeba skompilować i zainstalować nowe jądro. Szczegółowy opis tych czynności znaleźć można w Podręczniku FreeBSD, w części "link:{handbook}#kernelconfig-building[Building and Installing a Custom Kernel]".
+Teraz trzeba skompilować i zainstalować nowe jądro. Szczegółowy opis tych czynności znaleźć można w Podręczniku FreeBSD, w części "extref:{handbook}kernelconfig/[Building and Installing a Custom Kernel, kernelconfig-building]".
[[filtering-bridges-modules]]
=== Ładowanie modułów
diff --git a/documentation/content/pl/articles/new-users/_index.adoc b/documentation/content/pl/articles/new-users/_index.adoc
index ad503c44b5..1356125d14 100644
--- a/documentation/content/pl/articles/new-users/_index.adoc
+++ b/documentation/content/pl/articles/new-users/_index.adoc
@@ -3,7 +3,6 @@ title: Wprowadzenie do FreeBSD i Uniksa
authors:
- author: Annelise Anderson
email: andrsn@andrsn.stanford.edu
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"]
---
@@ -16,13 +15,27 @@ trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Spis treści
-:part-signifier: Część
-:chapter-signifier: Rozdział
-:appendix-caption: Dodatek
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
+:images-path: articles/new-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Abstrakt
diff --git a/documentation/content/pl/books/handbook/_index.adoc b/documentation/content/pl/books/handbook/_index.adoc
index 24f0900371..77ea2bebc0 100644
--- a/documentation/content/pl/books/handbook/_index.adoc
+++ b/documentation/content/pl/books/handbook/_index.adoc
@@ -3,9 +3,9 @@ title: Podręcznik FreeBSD
authors:
- author: Projekt Dokumentacji FreeBSD
copyright: 1995-2020 Projekt Dokumentacji FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
next: books/handbook/preface
+isIndex: true
---
= Podręcznik FreeBSD
@@ -15,18 +15,32 @@ next: books/handbook/preface
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:toc-title: Spis treści
-:part-signifier: Część
-:chapter-signifier: Rozdział
-:appendix-caption: Dodatek
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
+:images-path: books/handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Abstrakt
@@ -35,10 +49,10 @@ Witamy w świecie FreeBSD! Zadaniem niniejszego podręcznika jest opisanie proce
'''
-include::content/pl/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
-include::content/pl/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
-include::content/pl/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
-include::content/pl/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/pl/books/handbook/advanced-networking/_index.adoc b/documentation/content/pl/books/handbook/advanced-networking/_index.adoc
index a92baaca6e..26eed7913d 100644
--- a/documentation/content/pl/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/pl/books/handbook/advanced-networking/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 32
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 32
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[advanced-networking-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/audit/_index.adoc b/documentation/content/pl/books/handbook/audit/_index.adoc
index db79cfe531..0c52d9d465 100644
--- a/documentation/content/pl/books/handbook/audit/_index.adoc
+++ b/documentation/content/pl/books/handbook/audit/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/disks
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[audit-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/basics/_index.adoc b/documentation/content/pl/books/handbook/basics/_index.adoc
index 2660b2f1c9..11f8c05b4f 100644
--- a/documentation/content/pl/books/handbook/basics/_index.adoc
+++ b/documentation/content/pl/books/handbook/basics/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ports
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[basics-synopsis]]
== Streszczenie
diff --git a/documentation/content/pl/books/handbook/bibliography/_index.adoc b/documentation/content/pl/books/handbook/bibliography/_index.adoc
index 899a129d76..9e6e52bee2 100644
--- a/documentation/content/pl/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/pl/books/handbook/bibliography/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/eresources
[[bibliography]]
= Bibliografia
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Podczas gdy strony podręcznika systemowego dostarczają szczegółowych informacji odnośnie każdego z elementów systemu operacyjnego FreeBSD, bardzo często nie przedstawiają one jak złożyć wszystkie te elementy razem tak, by usprawnić pracę całego systemu. Z tego właśnie powodu nie istnieje żaden substytut dobrej książki o administracji systemami UNIX(R) i dobrego podręcznika ich użytkowania.
diff --git a/documentation/content/pl/books/handbook/book.adoc b/documentation/content/pl/books/handbook/book.adoc
index 0f77022886..78aec6b5ab 100644
--- a/documentation/content/pl/books/handbook/book.adoc
+++ b/documentation/content/pl/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: Podręcznik FreeBSD
authors:
- author: Projekt Dokumentacji FreeBSD
copyright: 1995-2020 Projekt Dokumentacji FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
---
@@ -12,54 +11,35 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:part-signifier: Część
-:chapter-signifier: Rozdział
-:appendix-caption: Dodatek
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
:book: true
:pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
-:chapters-path: content/pl/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/pl/mailing-lists.adoc[]
-include::../../../../shared/pl/urls.adoc[]
-include::../../../../shared/pl/teams.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/pl/mailing-lists.adoc[]
-include::../../../../shared/pl/urls.adoc[]
-include::../../../../shared/pl/teams.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -74,95 +54,95 @@ toc::[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
// Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..26;36..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
-include::{chapters-path}install/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}install/_index.adoc[leveloffset=+1]
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}jails/_index.adoc[leveloffset=+1]
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
-include::{chapters-path}zfs/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}zfs/_index.adoc[leveloffset=+1]
-include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}filesystems/_index.adoc[leveloffset=+1]
-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
-include::{chapters-path}dtrace/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}dtrace/_index.adoc[leveloffset=+1]
-include::{chapters-path}usb-device-mode/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}usb-device-mode/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=7..19]
+include::{chapters-path}partiv.adoc[lines=15..27]
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
// Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
:sectnums!:
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/pl/books/handbook/boot/_index.adoc b/documentation/content/pl/books/handbook/boot/_index.adoc
index e38549d6ba..35d92cb420 100644
--- a/documentation/content/pl/books/handbook/boot/_index.adoc
+++ b/documentation/content/pl/books/handbook/boot/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/users
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/config/_index.adoc b/documentation/content/pl/books/handbook/config/_index.adoc
index 1f84c5e4e6..b01a02353e 100644
--- a/documentation/content/pl/books/handbook/config/_index.adoc
+++ b/documentation/content/pl/books/handbook/config/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/boot
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/config/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[config-synopsis]]
== Synopsis
@@ -286,7 +284,7 @@ The following key words may be included at the top of each startup script. They
By carefully setting these keywords for each startup script, an administrator has a fine-grained level of control of the startup order of the scripts, without the need for "runlevels" used by some UNIX(R) operating systems.
-Additional information can be found in man:rc[8] and man:rc.subr[8]. Refer to link:{rc-scripting}[this article] for instructions on how to create custom man:rc[8] scripts.
+Additional information can be found in man:rc[8] and man:rc.subr[8]. Refer to extref:{rc-scripting}[this article] for instructions on how to create custom man:rc[8] scripts.
[[configtuning-core-configuration]]
=== Managing System-Specific Configuration
diff --git a/documentation/content/pl/books/handbook/cutting-edge/_index.adoc b/documentation/content/pl/books/handbook/cutting-edge/_index.adoc
index efe2af8a14..8b97458ba0 100644
--- a/documentation/content/pl/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/pl/books/handbook/cutting-edge/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/dtrace
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[updating-upgrading-synopsis]]
== Synopsis
@@ -393,7 +391,7 @@ Documentation is an integral part of the FreeBSD operating system. While an up-t
This section describes how to use either source or the FreeBSD Ports Collection to keep a local copy of the FreeBSD documentation up-to-date.
-For information on editing and submitting corrections to the documentation, refer to the FreeBSD Documentation Project Primer for New Contributors (link:{fdp-primer}[FreeBSD Documentation Project Primer for New Contributors]).
+For information on editing and submitting corrections to the documentation, refer to the FreeBSD Documentation Project Primer for New Contributors (extref:{fdp-primer}[FreeBSD Documentation Project Primer for New Contributors]).
[[updating-installed-documentation]]
=== Updating Documentation from Source
diff --git a/documentation/content/pl/books/handbook/desktop/_index.adoc b/documentation/content/pl/books/handbook/desktop/_index.adoc
index 73fd8daf8e..a87f33a2d9 100644
--- a/documentation/content/pl/books/handbook/desktop/_index.adoc
+++ b/documentation/content/pl/books/handbook/desktop/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/multimedia
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[desktop-synopsis]]
== Streszczenie
diff --git a/documentation/content/pl/books/handbook/disks/_index.adoc b/documentation/content/pl/books/handbook/disks/_index.adoc
index 21aace20ab..beb9ca81a7 100644
--- a/documentation/content/pl/books/handbook/disks/_index.adoc
+++ b/documentation/content/pl/books/handbook/disks/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/geom
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[disks-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/dtrace/_index.adoc b/documentation/content/pl/books/handbook/dtrace/_index.adoc
index e78b0404d7..3d2c339583 100644
--- a/documentation/content/pl/books/handbook/dtrace/_index.adoc
+++ b/documentation/content/pl/books/handbook/dtrace/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/usb-device-mode
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/dtrace/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
-endif::[]
+:images-path: books/handbook/dtrace/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dtrace-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/eresources/_index.adoc b/documentation/content/pl/books/handbook/eresources/_index.adoc
index 5876a2c896..b07dfc639b 100644
--- a/documentation/content/pl/books/handbook/eresources/_index.adoc
+++ b/documentation/content/pl/books/handbook/eresources/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/pgpkeys
[[eresources]]
= Resources on the Internet
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
The rapid pace of FreeBSD progress makes print media impractical as a means of following the latest developments. Electronic resources are the best, if not often the only, way to stay informed of the latest advances. Since FreeBSD is a volunteer effort, the user community itself also generally serves as a "technical support department" of sorts, with electronic mail, web forums, and USENET news being the most effective way of reaching that community.
@@ -53,9 +66,9 @@ The charters for the various lists are given at the bottom of this document. _Pl
_To test the ability to send email to FreeBSD lists, send a test message to {freebsd-test}._ Please do not send test messages to any other list.
====
-When in doubt about what list to post a question to, see link:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list].
+When in doubt about what list to post a question to, see extref:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list].
-Before posting to any list, please learn about how to best use the mailing lists, such as how to help avoid frequently-repeated discussions, by reading the link:{mailing-list-faq}[Mailing List Frequently Asked Questions] (FAQ) document.
+Before posting to any list, please learn about how to best use the mailing lists, such as how to help avoid frequently-repeated discussions, by reading the extref:{mailing-list-faq}[Mailing List Frequently Asked Questions] (FAQ) document.
Archives are kept for all of the mailing lists and can be searched using the https://www.FreeBSD.org/search/[FreeBSD World Wide Web server]. The keyword searchable archive offers an excellent way of finding answers to frequently asked questions and should be consulted before posting a question. Note that this also means that messages sent to FreeBSD mailing lists are archived in perpetuity. When protecting privacy is a concern, consider using a disposable secondary email address and posting only public information.
diff --git a/documentation/content/pl/books/handbook/filesystems/_index.adoc b/documentation/content/pl/books/handbook/filesystems/_index.adoc
index 0a281add46..e07526584c 100644
--- a/documentation/content/pl/books/handbook/filesystems/_index.adoc
+++ b/documentation/content/pl/books/handbook/filesystems/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/virtualization
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/filesystems/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
-endif::[]
+:images-path: books/handbook/filesystems/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[filesystems-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/firewalls/_index.adoc b/documentation/content/pl/books/handbook/firewalls/_index.adoc
index 2510418056..6da6781f6e 100644
--- a/documentation/content/pl/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/pl/books/handbook/firewalls/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/advanced-networking
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 31
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 31
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[firewalls-intro]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/geom/_index.adoc b/documentation/content/pl/books/handbook/geom/_index.adoc
index a5d8d42441..42ff7bf7a3 100644
--- a/documentation/content/pl/books/handbook/geom/_index.adoc
+++ b/documentation/content/pl/books/handbook/geom/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/zfs
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[geom-synopsis]]
== Synopsis
@@ -1130,4 +1128,4 @@ In the case of several slices, a journal will be created for each individual sli
Journaling may also be enabled on current file systems by using `tunefs`. However, _always_ make a backup before attempting to alter an existing file system. In most cases, `gjournal` will fail if it is unable to create the journal, but this does not protect against data loss incurred as a result of misusing `tunefs`. Refer to man:gjournal[8] and man:tunefs[8] for more information about these commands.
-It is possible to journal the boot disk of a FreeBSD system. Refer to the article link:{gjournal-desktop}[Implementing UFS Journaling on a Desktop PC] for detailed instructions.
+It is possible to journal the boot disk of a FreeBSD system. Refer to the article extref:{gjournal-desktop}[Implementing UFS Journaling on a Desktop PC] for detailed instructions.
diff --git a/documentation/content/pl/books/handbook/install/_index.adoc b/documentation/content/pl/books/handbook/install/_index.adoc
index c1857c13cc..d8f0bb7d69 100644
--- a/documentation/content/pl/books/handbook/install/_index.adoc
+++ b/documentation/content/pl/books/handbook/install/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/basics
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/install/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/install/
-endif::[]
+:images-path: books/handbook/install/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/install/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[install-synopsis]]
== Streszczenie
@@ -2806,7 +2804,7 @@ Jeżeli płyty nagrywać będziemy w innym systemie, do tego celu możemy posłu
[NOTE]
====
-Zainteresowanych przygotowaniem własnych wydań FreeBSD odsyłamy do artykułu link:{releng}[Release Engineering](ang.).
+Zainteresowanych przygotowaniem własnych wydań FreeBSD odsyłamy do artykułu extref:{releng}[Release Engineering](ang.).
====
[[install-ftp]]
@@ -2917,7 +2915,7 @@ Obsługa protokołu SLIP jest dosyć prymitywna i ogranicza się do bezpośredni
Jeżeli korzystamy z modemu, to PPP jest najprawdopodobniej jedyną możliwością. Zawczasu przygotujmy sobie informacje od dostawcy usług sieciowych, ponieważ będą nam one potrzebne na wczesnym etapie instalacji.
-Jeśli łącząc się z dostawcą usług sieciowych używamy PAP lub CHAP (innymi słowy, jeśli w Windows(R) możemy uzyskać połączenie bez korzystania ze skryptu), wówczas wystarczy, że w linii poleceń ppp wpiszemy `dial`. W przeciwnym razie będziemy musieli połączyć się z dostawcą usług sieciowych za pomocą "poleceń AT", zależnych od typu modemu, gdyż do dyspozycji będziemy mieć jedynie uproszczony emulator terminala. Więcej informacji znajdziemy w poświęconych user-ppp częściach crossref:ppp-and-slip[userppp,Podręcznika] i link:{faq}#ppp/[FAQ]. Jeśli wystąpią problemy, możemy posłużyć się poleceniem `set log local ...`, by komunikaty były pokazywane na ekranie.
+Jeśli łącząc się z dostawcą usług sieciowych używamy PAP lub CHAP (innymi słowy, jeśli w Windows(R) możemy uzyskać połączenie bez korzystania ze skryptu), wówczas wystarczy, że w linii poleceń ppp wpiszemy `dial`. W przeciwnym razie będziemy musieli połączyć się z dostawcą usług sieciowych za pomocą "poleceń AT", zależnych od typu modemu, gdyż do dyspozycji będziemy mieć jedynie uproszczony emulator terminala. Więcej informacji znajdziemy w poświęconych user-ppp częściach crossref:ppp-and-slip[userppp,Podręcznika] i extref:{faq}[FAQ, ppp]. Jeśli wystąpią problemy, możemy posłużyć się poleceniem `set log local ...`, by komunikaty były pokazywane na ekranie.
Jeżeli dysponujemy bezpośrednim połączeniem z innym komputerem z FreeBSD (w wersji 2.0-R lub późniejszej), wówczas mamy również możliwość instalacji przez port równoległy. Prędkość transmisji danych portem równoległym jest zwykle znacznie wyższa niż prędkość przesyłania portem szeregowym (do 50 kilobajtów/sekundę), dzięki czemu instalacja przebiega szybciej.
diff --git a/documentation/content/pl/books/handbook/introduction/_index.adoc b/documentation/content/pl/books/handbook/introduction/_index.adoc
index c6a743aef1..26810ad826 100644
--- a/documentation/content/pl/books/handbook/introduction/_index.adoc
+++ b/documentation/content/pl/books/handbook/introduction/_index.adoc
@@ -13,25 +13,35 @@ next: books/handbook/install
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/handbook/introduction/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-synopsis]]
== Streszczenie
@@ -49,7 +59,7 @@ Czytając ten rozdział poznamy:
[[nutshell]]
== Witamy w świecie FreeBSD!
-FreeBSD jest systemem operacyjnym bazującym na 4.4BSD-Lite, a przeznaczonym dla komputerów pracujących na platformach Intela (x86 i Itanium(R)), AMD64, Alpha(TM) oraz Sun UltraSPARC(R). Przygotowywane są również wersje dla innych platform. Więcej informacji dostępnych jest w <<history,historii FreeBSD>> bądź w nocie o <<relnotes,aktualnym wydaniu>>. Jeśli chciałbyś wspomóc rozwój Projektu (np. kod źródłowy, sprzęt, nieoznakowane banknoty) przeczytaj artykuł o link:{contributing}[współpracy z Projektem FreeBSD] (ang.).
+FreeBSD jest systemem operacyjnym bazującym na 4.4BSD-Lite, a przeznaczonym dla komputerów pracujących na platformach Intela (x86 i Itanium(R)), AMD64, Alpha(TM) oraz Sun UltraSPARC(R). Przygotowywane są również wersje dla innych platform. Więcej informacji dostępnych jest w <<history,historii FreeBSD>> bądź w nocie o <<relnotes,aktualnym wydaniu>>. Jeśli chciałbyś wspomóc rozwój Projektu (np. kod źródłowy, sprzęt, nieoznakowane banknoty) przeczytaj artykuł o extref:{contributing}[współpracy z Projektem FreeBSD] (ang.).
[[os-overview]]
=== Co potrafi FreeBSD?
@@ -162,7 +172,7 @@ Te części kodu w naszym drzewie źródłowym, które udostępniane są na lice
[[development]]
=== Model rozwoju FreeBSD
-Rozwój FreeBSD jest otwartym i elastycznym procesem realizowanym przez setki ludzi na całym świecie (patrz link:{contributors}[Lista współpracowników]). Infrastruktura systemu rozwoju FreeBSD pozwala tymże setkom projektantów współpracować przez Internet. Tym nie mniej nieustannie poszukujemy nowych projektantów, a także nowych pomysłów. Osoby zainteresowane nawiązaniem bliższej współpracy z projektem mogą kontaktować się z nami bezpośrednio poprzez {freebsd-hackers}. Natomiast {freebsd-announce} jest również dostępna dla osób chcących poinformować innych użytkowników FreeBSD o głównych obszarach prowadzonych prac.
+Rozwój FreeBSD jest otwartym i elastycznym procesem realizowanym przez setki ludzi na całym świecie (patrz extref:{contributors}[Lista współpracowników]). Infrastruktura systemu rozwoju FreeBSD pozwala tymże setkom projektantów współpracować przez Internet. Tym nie mniej nieustannie poszukujemy nowych projektantów, a także nowych pomysłów. Osoby zainteresowane nawiązaniem bliższej współpracy z projektem mogą kontaktować się z nami bezpośrednio poprzez {freebsd-hackers}. Natomiast {freebsd-announce} jest również dostępna dla osób chcących poinformować innych użytkowników FreeBSD o głównych obszarach prowadzonych prac.
Oto garść informacji o projekcie FreeBSD i jego procesie rozwoju, przydatnych zarówno niezależnym projektantom jak i bliskim współpracownikom:
@@ -175,7 +185,7 @@ _Twórcy_ są ludźmi, którzy posiadają prawa zapisu do drzewa CVS i posiadaj
Główni projektanci FreeBSD[[development-core]]::
Porównując Projekt FreeBSD z przedsiębiorstwem, _zespół główny_ należałoby porównać z zarządem firmy. Podstawowym zadaniem tejże grupy jest czuwanie nad prawidłowym rozwojem projektu jako całości. Jedną z funkcji grupy jest zapraszanie oddanych i odpowiedzialnych projektantów w szeregi twórców systemu, podobnie jak przyjmowanie w szeregi samej grupy. Obecna grupa została wybrana spośród wszystkich twórców w czerwcu 2004 r. Wybory mają miejsce co dwa lata.
+
-Niektórzy z członków grupy posiadają również dodatkowy zakres obowiązków, tj. czuwają nad zapewnieniem poprawnego funkcjonowania wybranych części systemu. Pełna lista projektantów FreeBSD i ich obowiązków dostępna jest w artykule link:{contributors}[Lista współpracowników].
+Niektórzy z członków grupy posiadają również dodatkowy zakres obowiązków, tj. czuwają nad zapewnieniem poprawnego funkcjonowania wybranych części systemu. Pełna lista projektantów FreeBSD i ich obowiązków dostępna jest w artykule extref:{contributors}[Lista współpracowników].
+
[NOTE]
@@ -186,7 +196,7 @@ Większość członków grupy jest ochotnikami, jeśli chodzi o rozwój FreeBSD,
Zewnętrzni współpracownicy::
Co prawda jako ostatnia, ale zdecydowanie nie jako najmniej istotna, omówiona zostanie grupa współpracowników zewnętrznych, czyli samych użytkowników, którzy dostarczają na bieżąco informacji o funkcjonowaniu systemu oraz poprawek wykrytych błędów. Najlepszym sposobem na udział w rozwoju FreeBSD jest subskrypcja {freebsd-hackers}. crossref:eresources[eresources,Resources on the Internet] zawiera więcej informacji o różnorodnych listach dyskusyjnych FreeBSD.
+
-link:{contributors}[Lista współpracowników FreeBSD] cały czas rośnie. Czemu by nie dołączyć do listy pomagając w pracy nad FreeBSD już dzisiaj?
+extref:{contributors}[Lista współpracowników FreeBSD] cały czas rośnie. Czemu by nie dołączyć do listy pomagając w pracy nad FreeBSD już dzisiaj?
+
Pisanie kodu nie jest jedyną formą współpracy z projektem: kompletna lista rzeczy, które trzeba zrobić dostępna jest na link:https://www.FreeBSD.org/[stronie Projektu FreeBSD].
diff --git a/documentation/content/pl/books/handbook/jails/_index.adoc b/documentation/content/pl/books/handbook/jails/_index.adoc
index d1ac72b52b..bc455d05aa 100644
--- a/documentation/content/pl/books/handbook/jails/_index.adoc
+++ b/documentation/content/pl/books/handbook/jails/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mac
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/jails/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
-endif::[]
+:images-path: books/handbook/jails/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[jails-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/kernelconfig/_index.adoc b/documentation/content/pl/books/handbook/kernelconfig/_index.adoc
index 4694290747..1e5f077f5e 100644
--- a/documentation/content/pl/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/pl/books/handbook/kernelconfig/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/printing
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kernelconfig-synopsis]]
== Streszczenie
diff --git a/documentation/content/pl/books/handbook/l10n/_index.adoc b/documentation/content/pl/books/handbook/l10n/_index.adoc
index 35c2914198..9323fb4217 100644
--- a/documentation/content/pl/books/handbook/l10n/_index.adoc
+++ b/documentation/content/pl/books/handbook/l10n/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/cutting-edge
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/linuxemu/_index.adoc b/documentation/content/pl/books/handbook/linuxemu/_index.adoc
index 8473966e93..198a3b6404 100644
--- a/documentation/content/pl/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/pl/books/handbook/linuxemu/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[linuxemu-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/mac/_index.adoc b/documentation/content/pl/books/handbook/mac/_index.adoc
index 6cb47f314e..2101befb8a 100644
--- a/documentation/content/pl/books/handbook/mac/_index.adoc
+++ b/documentation/content/pl/books/handbook/mac/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/audit
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/mail/_index.adoc b/documentation/content/pl/books/handbook/mail/_index.adoc
index 71786cfaac..e9af260405 100644
--- a/documentation/content/pl/books/handbook/mail/_index.adoc
+++ b/documentation/content/pl/books/handbook/mail/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/network-servers
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 29
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 29
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mail-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/mirrors/_index.adoc b/documentation/content/pl/books/handbook/mirrors/_index.adoc
index 9af84454ca..7b5d8a6e81 100644
--- a/documentation/content/pl/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/pl/books/handbook/mirrors/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/bibliography
[[mirrors]]
= Obtaining FreeBSD
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mirrors-cdrom]]
== CD and DVD Sets
diff --git a/documentation/content/pl/books/handbook/multimedia/_index.adoc b/documentation/content/pl/books/handbook/multimedia/_index.adoc
index 95081cc266..bbf5be461d 100644
--- a/documentation/content/pl/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/pl/books/handbook/multimedia/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/kernelconfig
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[multimedia-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/network-servers/_index.adoc b/documentation/content/pl/books/handbook/network-servers/_index.adoc
index ecdb187e6a..282a037e60 100644
--- a/documentation/content/pl/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/pl/books/handbook/network-servers/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/firewalls
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 30
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 30
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[network-servers-synopsis]]
== Synopsis
@@ -1118,7 +1116,7 @@ FreeBSD does not provide a built-in LDAP server. Begin the configuration by inst
# pkg install openldap-server
....
-There is a large set of default options enabled in the link:{linux-users}#software[package]. Review them by running `pkg info openldap-server`. If they are not sufficient (for example if SQL support is needed), please consider recompiling the port using the appropriate crossref:ports[ports-using,framework].
+There is a large set of default options enabled in the extref:{linux-users}[package, software]. Review them by running `pkg info openldap-server`. If they are not sufficient (for example if SQL support is needed), please consider recompiling the port using the appropriate crossref:ports[ports-using,framework].
The installation creates the directory [.filename]#/var/db/openldap-data# to hold the data. The directory to store the certificates must be created:
diff --git a/documentation/content/pl/books/handbook/parti.adoc b/documentation/content/pl/books/handbook/parti.adoc
index ca1946d398..3bd83850fb 100644
--- a/documentation/content/pl/books/handbook/parti.adoc
+++ b/documentation/content/pl/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
next: books/handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[getting-started]]
= Pierwsze kroki
@@ -17,4 +25,4 @@ Ta część Podręcznika FreeBSD adresowana jest do użytkowników i administrat
Staraliśmy się sprowadzić liczbę odnośników wewnątrz tekstu do możliwie najmniejszej, tak by zminimalizować ilość "przeskoków" i ułatwić czytanie Podręcznika od deski do deski.
-include::content/pl/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/pl/books/handbook/partii.adoc b/documentation/content/pl/books/handbook/partii.adoc
index 2db3bfe11f..e35dc8376a 100644
--- a/documentation/content/pl/books/handbook/partii.adoc
+++ b/documentation/content/pl/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
next: books/handbook/desktop
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[common-tasks]]
= Codzienne czynności
@@ -17,4 +25,4 @@ Skoro podstawy zostały już omówione, ta część Podręcznika zajmie się kil
Niektóre z poniższych rozdziałów zalecają lekturę dodatkowych materiałów, co zostanie wskazane w streszczeniu na początku każdego rozdziału.
-include::content/pl/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/pl/books/handbook/partiii.adoc b/documentation/content/pl/books/handbook/partiii.adoc
index 27a6d3ca0a..93ccc3d3f0 100644
--- a/documentation/content/pl/books/handbook/partiii.adoc
+++ b/documentation/content/pl/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
next: books/handbook/config
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[system-administration]]
= Administracja systemem
@@ -11,4 +19,4 @@ Pozostałe rozdziały Podręcznika omawiają wszystkie aspekty administracji sys
Rozdziały zostały tak napisane, by móc sięgnąć po nie gdy potrzebujemy danych informacji. Nie ma przymusu czytania ich w żadnej określonej kolejności, ani też przeczytania wszystkich przed rozpoczęciem pracy z FreeBSD.
-include::content/pl/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/pl/books/handbook/partiv.adoc b/documentation/content/pl/books/handbook/partiv.adoc
index 496091cd0e..63e4df14af 100644
--- a/documentation/content/pl/books/handbook/partiv.adoc
+++ b/documentation/content/pl/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/usb-device-mode
next: books/handbook/serialcomms
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[network-communication]]
= Komunikacja sieciowa
@@ -18,4 +26,4 @@ FreeBSD jest jednym z najszerzej rozpowszechnionych systemów operacyjnych wykor
Poniższe rozdziały zostały tak napisane, by móc sięgnąć po nie gdy potrzebujemy danych informacji. Nie ma przymusu czytania ich w żadnej określonej kolejności, ani też przeczytania wszystkich przed rozpoczęciem pracy z FreeBSD w środowisku sieciowym.
-include::content/pl/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/pl/books/handbook/partv.adoc b/documentation/content/pl/books/handbook/partv.adoc
index 492cb5cec7..0c0282205a 100644
--- a/documentation/content/pl/books/handbook/partv.adoc
+++ b/documentation/content/pl/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
next: books/handbook/mirrors
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= Dodatki
-include::content/pl/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/pl/books/handbook/pgpkeys/_index.adoc b/documentation/content/pl/books/handbook/pgpkeys/_index.adoc
index 71891b0a9c..da3b7f5fa6 100644
--- a/documentation/content/pl/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/pl/books/handbook/pgpkeys/_index.adoc
@@ -9,28 +9,44 @@ next: books/handbook/freebsd-glossary
[[pgpkeys]]
= Klucze PGP
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
W tym rozdziale zostało zebranych, dla naszej wygody, wiele kluczy oficerów czy twórców FreeBSD, gdybyśmy musieli zweryfikować podpis bądź wysłać do jednego z nich zaszyfrowaną wiadomość. Kompletna baza kluczy użytkowników `FreeBSD.org` dostępna jest pod adresem link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
diff --git a/documentation/content/pl/books/handbook/ports/_index.adoc b/documentation/content/pl/books/handbook/ports/_index.adoc
index ade854717e..05908b94a9 100644
--- a/documentation/content/pl/books/handbook/ports/_index.adoc
+++ b/documentation/content/pl/books/handbook/ports/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/x11
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ports-synopsis]]
== Streszczenie
@@ -407,7 +405,7 @@ Ten katalog może zawierać także inne pliki używane do kompilacji portu.
* Plik opisu [.filename]#pkg-descr#. Jest to bardziej szczegółowy, nierzadko wieloliniowy opis programu.
* Plik listy [.filename]#pkg-plist#. Jest to lista wszystkich plików, które zostaną zainstalowane przez port. Jest to także lista plików, które należy usunąć w przypadku odinstalowywania.
-Niekiedy porty zawierają również inne pliki, jak na przykład [.filename]#pkg-message# (message-wiadomość). System portów używa tych plików w specjalnych sytuacjach. Jeśli potrzebujesz więcej informacji na temat tych plików i portów w ogóle, zajrzyj do podręcznika link:{porters-handbook}[FreeBSD Porter's Handbook].
+Niekiedy porty zawierają również inne pliki, jak na przykład [.filename]#pkg-message# (message-wiadomość). System portów używa tych plików w specjalnych sytuacjach. Jeśli potrzebujesz więcej informacji na temat tych plików i portów w ogóle, zajrzyj do podręcznika extref:{porters-handbook}[FreeBSD Porter's Handbook].
Jak już raz powiedziano, porty zawierają instrukcje odnośnie kompilacji programów z kodu źródłowego. Jednakże nie zawierają one samego kodu. Kod pobrać można z płyty CD bądź z Internetu. Rozprowadzany może być w dowolnej postaci jaką wybierze sobie jego producent, przy czym najczęściej jest to spakowany plik tar skompresowany dodatkowo gzipem. Kod źródłowy programu nazywany jest "distfile". Poniżej przedstawione zostały dwie metody instalacji portów we FreeBSD.
@@ -735,11 +733,11 @@ Jeśli natknęliśmy się na port, który z jakichś powodów nie działa na nas
+
[NOTE]
====
-Niektóre porty nie są przygotowywane przez pojedyncze osoby, ale raczej przez link:{mailing-list-faq}[grupy dyskusyjne]. Wiele adresów takich grup, choć nie wszystkie, ma postać mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org]. Należy mieć również to na uwadze formułując swoje pytania.
+Niektóre porty nie są przygotowywane przez pojedyncze osoby, ale raczej przez extref:{mailing-list-faq}[grupy dyskusyjne]. Wiele adresów takich grup, choć nie wszystkie, ma postać mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org]. Należy mieć również to na uwadze formułując swoje pytania.
Porty przygotowywane przez mailto:freebsd-ports@FreeBSD.org[freebsd-ports@FreeBSD.org] w rzeczywistości nie posiadają żadnego konkretnego opiekuna, ani grupy opiekunów. Poprawki i pomoc dla takich portów przygotowują osoby zapisane na tę listę dyskusyjną. Nowi ochotnicy są zawsze mile widziani!
====
+
-W przypadku braku odpowiedzi można również przesłać zgłoszenie błędu poprzez man:send-pr[1] (szczegóły w artykule link:{problem-reports}[Writing FreeBSD Problem Reports]).
-. Naprawić błąd samemu! Podręcznik link:{porters-handbook}[Porter's Handbook] (ang.) zawiera szczegółowe informacje o strukturze "Portów", dzięki czemu można samemu naprawić błąd lub przygotować własny port!
+W przypadku braku odpowiedzi można również przesłać zgłoszenie błędu poprzez man:send-pr[1] (szczegóły w artykule extref:{problem-reports}[Writing FreeBSD Problem Reports]).
+. Naprawić błąd samemu! Podręcznik extref:{porters-handbook}[Porter's Handbook] (ang.) zawiera szczegółowe informacje o strukturze "Portów", dzięki czemu można samemu naprawić błąd lub przygotować własny port!
. Pobrać pakiet z najbliższego serwera FTP. "Główne" repozytorium pakietów znajduje się na serwerze `ftp.FreeBSD.org` w katalogu link:ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/[packages]. Tym nie mniej warto jest najpierw odszukać http://mirrorlist.FreeBSD.org/[lokalny serwer lustrzany]. Szanse na to, że gotowe pakiety będą działać poprawnie są większe niż w przypadku kompilowania programów. Pakiety można zainstalować za pomocą programu man:pkg_add[1].
diff --git a/documentation/content/pl/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/pl/books/handbook/ppp-and-slip/_index.adoc
index 2fa0dd563e..eedce9a50d 100644
--- a/documentation/content/pl/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/pl/books/handbook/ppp-and-slip/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mail
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 28
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 28
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ppp-and-slip-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/preface/_index.adoc b/documentation/content/pl/books/handbook/preface/_index.adoc
index c231c7021f..0126bacf58 100644
--- a/documentation/content/pl/books/handbook/preface/_index.adoc
+++ b/documentation/content/pl/books/handbook/preface/_index.adoc
@@ -13,14 +13,31 @@ next: books/handbook/parti
:icons: font
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-audience]]
== Docelowy czytelnik
diff --git a/documentation/content/pl/books/handbook/printing/_index.adoc b/documentation/content/pl/books/handbook/printing/_index.adoc
index fb6216a61a..50ef1ab5a6 100644
--- a/documentation/content/pl/books/handbook/printing/_index.adoc
+++ b/documentation/content/pl/books/handbook/printing/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/linuxemu
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/printing/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Putting information on paper is a vital function, despite many attempts to eliminate it. Printing has two basic components. The data must be delivered to the printer, and must be in a form that the printer can understand.
@@ -759,7 +757,7 @@ Several other printing systems are available in addition to the built-in man:lpd
[[printing-other-cups]]
=== CUPS (Common UNIX(R) Printing System)
-CUPS is a popular printing system available on many operating systems. Using CUPS on FreeBSD is documented in a separate article: link:{cups}[CUPS]
+CUPS is a popular printing system available on many operating systems. Using CUPS on FreeBSD is documented in a separate article: extref:{cups}[CUPS]
[[printing-other-hplip]]
=== HPLIP
diff --git a/documentation/content/pl/books/handbook/security/_index.adoc b/documentation/content/pl/books/handbook/security/_index.adoc
index 94ad359e4a..5ff0cd672e 100644
--- a/documentation/content/pl/books/handbook/security/_index.adoc
+++ b/documentation/content/pl/books/handbook/security/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/jails
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/serialcomms/_index.adoc b/documentation/content/pl/books/handbook/serialcomms/_index.adoc
index fbfcc3e10b..159218cd22 100644
--- a/documentation/content/pl/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/pl/books/handbook/serialcomms/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ppp-and-slip
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[serial-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/usb-device-mode/_index.adoc b/documentation/content/pl/books/handbook/usb-device-mode/_index.adoc
index 664247dc68..f87607079b 100644
--- a/documentation/content/pl/books/handbook/usb-device-mode/_index.adoc
+++ b/documentation/content/pl/books/handbook/usb-device-mode/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/usb-device-mode/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/usb-device-mode/
-endif::[]
+:images-path: books/handbook/usb-device-mode/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/usb-device-mode/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[usb-device-mode-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/users/_index.adoc b/documentation/content/pl/books/handbook/users/_index.adoc
index d0fb53fc88..3428a4ff08 100644
--- a/documentation/content/pl/books/handbook/users/_index.adoc
+++ b/documentation/content/pl/books/handbook/users/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/security
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/users/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/users/
-endif::[]
+:images-path: books/handbook/users/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/users/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[users-synopsis]]
== Streszczenie
diff --git a/documentation/content/pl/books/handbook/virtualization/_index.adoc b/documentation/content/pl/books/handbook/virtualization/_index.adoc
index b2359102ca..772842b19e 100644
--- a/documentation/content/pl/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/pl/books/handbook/virtualization/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/l10n
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/virtualization/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
-endif::[]
+:images-path: books/handbook/virtualization/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[virtualization-synopsis]]
== Synopsis
diff --git a/documentation/content/pl/books/handbook/x11/_index.adoc b/documentation/content/pl/books/handbook/x11/_index.adoc
index 2c0f7d634a..81ffdd31ea 100644
--- a/documentation/content/pl/books/handbook/x11/_index.adoc
+++ b/documentation/content/pl/books/handbook/x11/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[x11-synopsis]]
== Streszczenie
diff --git a/documentation/content/pl/books/handbook/zfs/_index.adoc b/documentation/content/pl/books/handbook/zfs/_index.adoc
index dd2d2a139d..f69c82e6bd 100644
--- a/documentation/content/pl/books/handbook/zfs/_index.adoc
+++ b/documentation/content/pl/books/handbook/zfs/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/filesystems
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Spis treści
-:table-caption: Tabela
-:figure-caption: Rysunek
-:example-caption: Przykład
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/zfs/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/zfs/
-endif::[]
+:images-path: books/handbook/zfs/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/zfs/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pl/mailing-lists.adoc[]
-include::shared/pl/urls.adoc[]
-include::shared/pl/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
The _Z File System_, or ZFS, is an advanced file system designed to overcome many of the major problems found in previous designs.
diff --git a/documentation/content/pt-br/articles/bsdl-gpl/_index.adoc b/documentation/content/pt-br/articles/bsdl-gpl/_index.adoc
index 36c1d436ab..2adc91c72d 100644
--- a/documentation/content/pt-br/articles/bsdl-gpl/_index.adoc
+++ b/documentation/content/pt-br/articles/bsdl-gpl/_index.adoc
@@ -18,6 +18,27 @@ trademarks: ["freebsd", "intel", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/bsdl-gpl/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
'''
diff --git a/documentation/content/pt-br/articles/building-products/_index.adoc b/documentation/content/pt-br/articles/building-products/_index.adoc
index 4a57bf414a..54b4609885 100644
--- a/documentation/content/pt-br/articles/building-products/_index.adoc
+++ b/documentation/content/pt-br/articles/building-products/_index.adoc
@@ -5,7 +5,6 @@ authors:
email: jkoshy@FreeBSD.org
organizations:
- organization: The FreeBSD Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -18,27 +17,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
-:imagesdir: ../../../images/articles/building-products/
+:images-path: articles/building-products/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/building-products/
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/building-products/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -158,7 +156,7 @@ image::freebsd-organization.png[]
A resolução de conflitos é realizada por um "Core Team" de 9 pessoas, o qual é eleito a partir do grupo de committers.
-O FreeBSD não tem committers "corporativo". Os committers são obrigados a assumir de forma individual a responsabilidade pelas mudanças que introduzem no código. O link:{committers-guide}[FreeBSD Committer's guide]<<ComGuide>> documenta as regras e responsabilidades que se aplicam aos committers.
+O FreeBSD não tem committers "corporativo". Os committers são obrigados a assumir de forma individual a responsabilidade pelas mudanças que introduzem no código. O extref:{committers-guide}[FreeBSD Committer's guide]<<ComGuide>> documenta as regras e responsabilidades que se aplicam aos committers.
O modelo do projeto FreeBSD é examinado em detalhes no <<Nik2005>>.
@@ -176,7 +174,7 @@ image::freebsd-branches.png[]
As linhas de código são mantidas vivas enquanto houver interesse dos usuários e dos desenvolvedores nelas.
-As arquiteturas de máquina estão agrupadas em "tiers"; As arquiteturas _Tier 1_ são totalmente suportadas pelas equipes de engenharia de lançamento e de segurança, as arquiteturas _Tier 2_ são suportadas em regime de melhores esforços, e as arquiteturas experimentais compreendem o _Tier 3_. A lista das link:{committers-guide}#archs/[arquiteturas suportadas] é parte da coleção de documentos do FreeBSD.
+As arquiteturas de máquina estão agrupadas em "tiers"; As arquiteturas _Tier 1_ são totalmente suportadas pelas equipes de engenharia de lançamento e de segurança, as arquiteturas _Tier 2_ são suportadas em regime de melhores esforços, e as arquiteturas experimentais compreendem o _Tier 3_. A lista das extref:{committers-guide}[arquiteturas suportadas, archs] é parte da coleção de documentos do FreeBSD.
A equipe de engenharia de lançamentos publica um link:https://www.FreeBSD.org/releng/[road map] para as versões futuras do FreeBSD no web site do projeto. As datas indicadas no road map não são prazos; As novas versões do FreeBSD são liberadas apenas quando o seu código e documentação estão prontos.
@@ -247,7 +245,7 @@ Agora iremos examinar algumas das melhores práticas para se fazer um melhor uso
Se planeje para o longo prazo::
Implante processos que o ajudem a monitorar o desenvolvimento do FreeBSD. Por exemplo:
+
-*Acompanhe o código fonte do FreeBSD.* O projeto facilita o espelhamento do seu repositório SVN usando link:{committers-guide}#svn-advanced-use-setting-up-svnsync[svnsync]. Ter o histórico completo do código fonte é útil quando se está debugando problemas complexos e oferece informações valiosas sobre as intenções dos desenvolvedores originais. Utilize um sistema de controle de código que lhe permita mesclar facilmente as alterações entre o código original do FreeBSD e o seu próprio código.
+*Acompanhe o código fonte do FreeBSD.* O projeto facilita o espelhamento do seu repositório SVN usando extref:{committers-guide}[svnsync, svn-advanced-use-setting-up-svnsync]. Ter o histórico completo do código fonte é útil quando se está debugando problemas complexos e oferece informações valiosas sobre as intenções dos desenvolvedores originais. Utilize um sistema de controle de código que lhe permita mesclar facilmente as alterações entre o código original do FreeBSD e o seu próprio código.
+
A <<fig-svn-blame, Código fonte exibindo a listagem de anotações gerada utilizando o `svn blame`>> mostra as anotações em uma parte do arquivo referenciado pelo log de alterações da <<fig-change-log, Um exemplo de entrada no log de alteração>>. A ascendência de cada linha de código é claramente visível. Listagens com as anotações mostrando a história de cada arquivo que faz parte do FreeBSD estão https://svnweb.freebsd.org/[disponíveis na web].
+
@@ -292,7 +290,7 @@ Dar visibilidade para a comunidade FreeBSD de que a sua empresa utiliza o sistem
Suporte os desenvolvedores do FreeBSD::
Às vezes, o caminho mais direto para ver uma funcionalidade que você deseja implementada no FreeBSD é suportar um desenvolvedor que já esteja olhando um problema relacionado. A ajuda pode variar de uma doação de hardware até uma assistência financeira direta. Em alguns países, as doações para o projeto FreeBSD usufruem de benefícios fiscais. O projeto possui umlink:https://www.FreeBSD.org/donations/[canal de comunicação dedicado] para assuntos relacionados a doações e para ajudar os doadores. O projeto também mantém uma página web na qual os desenvolvedores podem link:https://www.FreeBSD.org/donations/wantlist/[listar suas necessidades].
+
-Por uma política do projeto, o FreeBSD link:{contributors}[reconhece] todas as contribuições recebidas em seu site web.
+Por uma política do projeto, o FreeBSD extref:{contributors}[reconhece] todas as contribuições recebidas em seu site web.
[[conclusion]]
== Conclusão
@@ -310,21 +308,21 @@ Foram examinadas as características do FreeBSD que o tornam uma excelente opç
[[Com2004]] [Com2004] http://csdl.computer.org/comp/mags/so/2004/01/s1028.pdf[How is Open-Source Affecting Software Development?] Diomidis Spinellis. Clemens Szyperski.IEEE Computer Copyright(R)Jan/Feb 2004. IEEE Computer Society.
-[[ComGuide]] [ComGuide] link:{committers-guide}[Committer's Guide]The FreeBSD Project. Copyright(R)2005.
+[[ComGuide]] [ComGuide] extref:{committers-guide}[Committer's Guide]The FreeBSD Project. Copyright(R)2005.
[[Cov2005]] [Cov2005] http://www.coverity.com/news/nf_news_06_27_05_story_9.html[Coverity study on kernel security holes in Linux and FreeBSD]Coverity Inc.. Copyright(R)2005.
[[GoldGab2005]] [GoldGab2005] http://dreamsongs.com/IHE/IHE.html[Innovation Happens Elsewhere: Open Source as Business Strategy] Ron Goldman. Richard Gabriel. Copyright(R)2005. Morgan-Kaufmann.
-[[Hub1994]] [Hub1994] link:{contributing}[Contributing to the FreeBSD Project] Jordan Hubbard. Copyright(R)1994—2005. The FreeBSD Project.
+[[Hub1994]] [Hub1994] extref:{contributing}[Contributing to the FreeBSD Project] Jordan Hubbard. Copyright(R)1994—2005. The FreeBSD Project.
[[McKu1999]] [McKu1999] http://www.usenix.org/publications/library/proceedings/usenix99/mckusick.html[Soft Updates: A Technique for Eliminating Most Synchronous Writes in the Fast Filesystem] Kirk McKusick. Gregory Ganger. Copyright(R)1999.
[[McKu1999-1]] [McKu1999-1] http://www.oreilly.com/catalog/opensources/book/kirkmck.html[Twenty Years of Berkeley Unix: From AT&T-Owned to Freely Redistributable] Marshall Kirk McKusick. http://www.oreilly.com/catalog/opensources/book/toc.html[Open Sources: Voices from the Open Source Revolution] O'Reilly Inc.. Copyright(R)1993.
-[[Mon2005]] [Mon2005] link:{bsdl-gpl}[Why you should use a BSD style license for your Open Source Project] Bruce Montague. The FreeBSD Project. Copyright(R)2005.
+[[Mon2005]] [Mon2005] extref:{bsdl-gpl}[Why you should use a BSD style license for your Open Source Project] Bruce Montague. The FreeBSD Project. Copyright(R)2005.
-[[Nik2005]] [Nik2005] link:{dev-model}[A project model for the FreeBSD Project] Niklas Saers. Copyright(R)2005. The FreeBSD Project.
+[[Nik2005]] [Nik2005] extref:{dev-model}[A project model for the FreeBSD Project] Niklas Saers. Copyright(R)2005. The FreeBSD Project.
[[Nor1993]] [Nor1993] http://www.norvig.com/luv-slides.ps[Tutorial on Good Lisp Programming Style] Peter Norvig. Kent Pitman. Copyright(R)1993.
@@ -332,4 +330,4 @@ Foram examinadas as características do FreeBSD que o tornam uma excelente opç
[[Ray2004]] [Ray2004] http://www.catb.org/~esr/faqs/smart-questions.html[How to ask questions the smart way] Eric Steven Raymond. Copyright(R)2004.
-[[RelEngDoc]] [RelEngDoc] link:{releng}[FreeBSD Release Engineering] Murray Stokely. Copyright(R)2001. The FreeBSD Project.
+[[RelEngDoc]] [RelEngDoc] extref:{releng}[FreeBSD Release Engineering] Murray Stokely. Copyright(R)2001. The FreeBSD Project.
diff --git a/documentation/content/pt-br/articles/committers-guide/_index.adoc b/documentation/content/pt-br/articles/committers-guide/_index.adoc
index aec05310f4..6bdd53847e 100644
--- a/documentation/content/pt-br/articles/committers-guide/_index.adoc
+++ b/documentation/content/pt-br/articles/committers-guide/_index.adoc
@@ -3,7 +3,6 @@ title: Guia dos Committers
authors:
- author: Projeto de Documentação do FreeBSD
copyright: 1999-2020 Projeto de Documentação do FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "coverity", "ibm", "intel", "sparc", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "coverity", "ibm", "intel", "sparc", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/committers-guide/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -433,7 +434,7 @@ Atualizar a árvore com `svn update` irá apenas atualizar o que foi pedido ante
% svn co https://svn.FreeBSD.org/base/head /usr/src
....
-Mais detalhes sobre o uso do Subversion podem ser encontrados em link:{handbook}#svn[Usando o Subversion].
+Mais detalhes sobre o uso do Subversion podem ser encontrados em extref:{handbook}mirrors[Usando o Subversion, svn].
[[svn-daily-use-updating-the-tree]]
==== Atualizando a Árvore
@@ -1244,7 +1245,7 @@ Aqueles que receberam direitos de commit para os repositórios do FreeBSD devem
[.filename]#doc/head/shared/xml/authors.ent# - Adicione uma entidade de autor. Etapas posteriores dependem dessa entidade, e a falta dessa etapa fará com que a compilação do [.filename]#doc/# falhe. Essa é uma tarefa relativamente fácil, mas continua sendo um bom primeiro teste de habilidades no controle de versão.
. Atualize a lista de desenvolvedores e colaboradores
+
-[.filename]#doc/head/en_US.ISO8859-1/articles/contributors/contrib.committers.xml# - Adicione uma entrada à seção "Desenvolvedores" da link:{contributors}#staff-committers[Lista de Contribuidores]. As entradas são classificadas pelo sobrenome.
+[.filename]#doc/head/en_US.ISO8859-1/articles/contributors/contrib.committers.xml# - Adicione uma entrada à seção "Desenvolvedores" da extref:{contributors}[Lista de Contribuidores, staff-committers]. As entradas são classificadas pelo sobrenome.
+
[.filename]#doc/head/en_US.ISO8859-1/articles/contributors/contrib.additional.xml# - _Remova_ a entrada da seção "Contribuidores Adicionais". As entradas são classificadas pelo primeiro nome.
. Adicione um item de notícias
@@ -1750,7 +1751,7 @@ As contas do Phabricator não podem ser mescladas, por favor, não abra uma nova
Além dos repositórios meisters, existem outros membros e equipes do projeto FreeBSD que você provavelmente conhecerá no exercício da sua função como committer. Resumidamente, e de forma alguma inclusivamente, estes são:
Equipe de Engenharia de Documentação mailto:doceng@FreeBSD.org[doceng@FreeBSD.org]::
-O doceng é o grupo responsável pela infraestrutura de criação de documentação, aprovando de novos committers de documentação e garantindo que o website do FreeBSD e a documentação no site FTP estão atualizados em relação à árvore subversion. Não é um corpo de resolução de conflitos. A grande maioria das discussões relacionadas à documentação ocorre na http://lists.FreeBSD.org/mailman/listinfo/freebsd-doc[lista de discussão do projeto de documentação do FreeBSD]. Mais detalhes sobre a equipe doceng podem ser encontrados em seu https://www.FreeBSD.org/internal/doceng/[charter]. Os committers interessados em contribuir com a documentação devem se familiarizar com o link:{fdp-primer}[Primer do Projeto de Documentação].
+O doceng é o grupo responsável pela infraestrutura de criação de documentação, aprovando de novos committers de documentação e garantindo que o website do FreeBSD e a documentação no site FTP estão atualizados em relação à árvore subversion. Não é um corpo de resolução de conflitos. A grande maioria das discussões relacionadas à documentação ocorre na http://lists.FreeBSD.org/mailman/listinfo/freebsd-doc[lista de discussão do projeto de documentação do FreeBSD]. Mais detalhes sobre a equipe doceng podem ser encontrados em seu https://www.FreeBSD.org/internal/doceng/[charter]. Os committers interessados em contribuir com a documentação devem se familiarizar com o extref:{fdp-primer}[Primer do Projeto de Documentação].
Glen Barber mailto:gjb@FreeBSD.org[gjb@FreeBSD.org], Konstantin Belousov mailto:kib@FreeBSD.org[kib@FreeBSD.org], Bryan Drewery mailto:[bdrewery@FreeBSD.org], Marc Fonvieille mailto:blackend@FreeBSD.org[blackend@FreeBSD.org], Xin Li mailto:delphij@FreeBSD.org[delphij@FreeBSD.org], Colin Percival mailto:cperciva@FreeBSD.org[cperciva@FreeBSD.org] Hiroki Sato mailto:hrs@FreeBSD.org[hrs@FreeBSD.org], Gleb Smirnoff mailto:glebius@FreeBSD.org[glebius@FreeBSD.org]::
Estes são os membros da Equipe de Engenharia de Release mailto:re@FreeBSD.org[re@FreeBSD.org]. Essa equipe é responsável por definir os prazos de lançamento e por controlar o processo de release. Durante o congelamento de código, os engenheiros de release têm autoridade final sobre todas as alterações no sistema para qualquer branch que esteja com status de release pendente. Se há algo que você deseja mesclar do FreeBSD-CURRENT para o FreeBSD-STABLE (quaisquer valores que eles possam ter em um dado momento), estas são as pessoas com quem conversar sobre isso.
@@ -1845,7 +1846,7 @@ O repositório não é onde as alterações são inicialmente submetidas para co
Em caso de dúvida, peça por uma revisão!
. Respeite os mantenedores existentes, se listados.
+
-Muitas partes do FreeBSD não são "possuídas" no sentido de que qualquer indivíduo específico irá pular e gritar se você enviar uma alteração para a "sua" área, mas ainda vale a pena verificar primeiro. Uma convenção que usamos é colocar uma linha de mantenedor no [.filename]#Makefile# para qualquer pacote ou subárvore que esteja sendo mantido ativamente por uma ou mais pessoas; veja link:{developers-handbook}#policies[Source Tree Guidelines and Policies] para documentação sobre isso. Nas seções de código para quais existirem vários mantenedores, os commits nas áreas afetadas por um mantenedor precisarão ser revisados por pelo menos um outro mantenedor. Nos casos em que o "maintainer-ship" de algo não está claro, consulte os logs do repositório para os arquivos em questão e veja se alguém está trabalhando recentemente ou predominantemente naquela área.
+Muitas partes do FreeBSD não são "possuídas" no sentido de que qualquer indivíduo específico irá pular e gritar se você enviar uma alteração para a "sua" área, mas ainda vale a pena verificar primeiro. Uma convenção que usamos é colocar uma linha de mantenedor no [.filename]#Makefile# para qualquer pacote ou subárvore que esteja sendo mantido ativamente por uma ou mais pessoas; veja extref:{developers-handbook}[Source Tree Guidelines and Policies, policies] para documentação sobre isso. Nas seções de código para quais existirem vários mantenedores, os commits nas áreas afetadas por um mantenedor precisarão ser revisados por pelo menos um outro mantenedor. Nos casos em que o "maintainer-ship" de algo não está claro, consulte os logs do repositório para os arquivos em questão e veja se alguém está trabalhando recentemente ou predominantemente naquela área.
. Deve ser feito o rollback de qualquer alteração contestada enquanto estiver pendente a resolução da disputa, se solicitado por um mantenedor. Alterações relacionadas à segurança podem anular os desejos de um mantenedor, a critério do Oficial de Segurança.
+
Isso pode ser difícil de engolir em momentos de conflito (quando cada lado está convencido de que eles estão certos, é claro), mas um sistema de controle de versão torna desnecessário ter uma disputa em andamento quando é muito mais fácil simplesmente reverter a mudança que gerou a disputa, faça com que todos se acalmem novamente e tente descobrir qual é a melhor maneira de proceder. Se a mudança acaba por ser a melhor coisa depois de tudo, ela pode ser facilmente trazida de volta. Se ela não for, os usuários não terão que viver com a mudança falsa na árvore enquanto todos estavam ocupados debatendo seus méritos. Pessoas _muito_ raramente pedem rollbacks no repositório, uma vez que a discussão geralmente expõe mudanças ruins ou controversas antes que o commit aconteça, mas em raras ocasiões o rollback deve ser feito sem discussão para que possamos entrar imediatamente da discussão do tópico para descobrirmos se ele era adequado ou não.
@@ -2058,11 +2059,11 @@ Verifique o port, de preferência para garantir que ele seja compilado e empacot
# make package
....
-O link:{porters-handbook}[Manual de Porters] contém instruções mais detalhadas.
+O extref:{porters-handbook}[Manual de Porters] contém instruções mais detalhadas.
Use o man:portlint[1] para verificar a sintaxe do port. Você não precisa necessariamente eliminar todos os avisos, mas certifique-se de ter corrigido os mais simples.
-Se o port veio de um remetente que não contribuiu para o projeto antes, adicione o nome dessa pessoa a seção link:{contributors}#contrib-additional[Colaboradores Adicionais] da Lista de Colaboradores do FreeBSD.
+Se o port veio de um remetente que não contribuiu para o projeto antes, adicione o nome dessa pessoa a seção extref:{contributors}[Colaboradores Adicionais, contrib-additional] da Lista de Colaboradores do FreeBSD.
Feche o PR se o port entrou como um PR. Para fechar um PR, mude o estado para `Issue Resolved` e a resolução como `Fixed`.
diff --git a/documentation/content/pt-br/articles/contributing/_index.adoc b/documentation/content/pt-br/articles/contributing/_index.adoc
index 17e116a34d..7844a32dce 100644
--- a/documentation/content/pt-br/articles/contributing/_index.adoc
+++ b/documentation/content/pt-br/articles/contributing/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Jordan Hubbard
- author: Sam Lawrance
- author: Mark Linimon
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ieee", "general"]
---
@@ -17,24 +16,26 @@ trademarks: ["freebsd", "ieee", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/contributing/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -67,7 +68,7 @@ A lista de tarefas e sub-projetos a seguir representa algo como uma amálgama de
Muitas pessoas que estão envolvidas com o FreeBSD não são programadores. O Projeto inclui escritores de documentação, Web designers, e pessoas de suporte. Todas estas pessoas contribuem investindo tempo e sua vontade de aprender.
. Leia o FAQ e Handbook periodicamente. Se algo estiver explicado de forma pobre, ambígua, desatualizada ou incorreta, nos comunique. Melhor ainda, envie-nos uma versão ajustada (O formato Docbook não é difícil de aprender, mas não existem objeções em relação ao envio de material no formato ASCII).
-. Ajude a traduzir a documentação do FreeBSD para a sua linguagem nativa. Se a documentação já existe na sua língua, você pode ajudar a traduzir documentos adicionais ou verificar se as traduções estão atualizadas e corretas. Primeiro dê uma olhada no link:{fdp-primer}#translations/[FAQ de Traduções] contido no Manual de Documentação do Projeto FreeBSD. Você não estará se comprometendo a traduzir toda a documentação do FreeBSD fazendo isto - como um voluntário, você pode fazer tantas quantas traduções desejar. Uma vez que alguém começa a traduzir, outros se unem ao esforço. Se você tem tempo ou energia para traduzir apenas uma parte da documentação, por favor traduza as instruções de instalação.
+. Ajude a traduzir a documentação do FreeBSD para a sua linguagem nativa. Se a documentação já existe na sua língua, você pode ajudar a traduzir documentos adicionais ou verificar se as traduções estão atualizadas e corretas. Primeiro dê uma olhada no extref:{fdp-primer}[FAQ de Traduções, translations] contido no Manual de Documentação do Projeto FreeBSD. Você não estará se comprometendo a traduzir toda a documentação do FreeBSD fazendo isto - como um voluntário, você pode fazer tantas quantas traduções desejar. Uma vez que alguém começa a traduzir, outros se unem ao esforço. Se você tem tempo ou energia para traduzir apenas uma parte da documentação, por favor traduza as instruções de instalação.
. Leia a http://lists.FreeBSD.org/mailman/listinfo/freebsd-questions[lista de discussão para perguntas gerais sobre o FreeBSD] ocasionalmente (ou regularmente se possível). Pode ser muito recompensador compartilhar a sua experiência e ajudar outras pessoas a resolverem seus problemas; Às vezes você poderá até aprender algo novo! Estes fóruns também podem ser uma fonte de ideias de coisas a serem melhoradas.
[[ongoing-programmer-tasks]]
@@ -100,7 +101,7 @@ Qualquer um pode se envolver e existem muitas maneiras diferentes de fazer isso.
Existem várias maneiras fáceis de contribuir para manter a árvore de ports atualizada e em boas condições de funcionamento:
-* Encontre algum software legal ou útil e link:{porters-handbook}[crie um port] para ele.
+* Encontre algum software legal ou útil e extref:{porters-handbook}[crie um port] para ele.
* Existe um grande número de ports que não possuem nenhum mantenedor. Torne-se um mantenedor e <<adopt-port>>.
* Se você criou ou adotou um port, esteja ciente <<maintain-port>>.
* Quando estiver procurando um desafio você poderá <<fix-broken>>.
@@ -117,21 +118,21 @@ Contribuições para o sistema geralmente se enquadram em uma das 5 categorias s
[[contrib-general]]
=== Relatórios de Bugs e Comentários Gerais
-Uma ideia ou sugestão técnica de interesse _geral_ deverá ser enviada para a http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[Lista de discussão de assuntos técnicos do FreeBSD]. Da mesma forma, pessoas com este tipo de interesse (e tolerância para um _alto_ volume de mensagens!) poderão assinar a http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[Lista de discussão de assuntos técnicos do FreeBSD]. Veja o link:{handbook}#eresources-mail[Handbook do FreeBSD] para mais informações sobre esta e outras listas.
+Uma ideia ou sugestão técnica de interesse _geral_ deverá ser enviada para a http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[Lista de discussão de assuntos técnicos do FreeBSD]. Da mesma forma, pessoas com este tipo de interesse (e tolerância para um _alto_ volume de mensagens!) poderão assinar a http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[Lista de discussão de assuntos técnicos do FreeBSD]. Veja o extref:{handbook}eresources[Handbook do FreeBSD, eresources-mail] para mais informações sobre esta e outras listas.
Se você encontrar um bug ou estiver enviando uma mudança específica, por favor relate-o usando o https://bugs.FreeBSD.org/submit/[relatório de envio de bug]. Tente preencher cada campo com do relato de bug. A não ser que exceda 65KB, inclua qualquer correção diretamente no relatório. Se o patch é apropriado para ser aplicado na árvore do código fonte coloque `[PATCH]` no resumo do relatório. Ao incluir patches, _não_ use copiar-e-colar, pois o copiar-e-colar transforma tabs em espaços e os torna inúteis. Quando os patches são muito maiores que 20KB, considere comprimi-los (por exemplo, com man:gzip[1] ou man:bzip2[1]) antes de fazer o envio.
Após preencher o relatório, você receberá a confirmação com o número de rastreamento. Guarde este número para que você possa nos atualizar com detalhes sobre do problema.
-Veja também link:{problem-reports}[este artigo] sobre como escrever bons relatórios de problemas.
+Veja também extref:{problem-reports}[este artigo] sobre como escrever bons relatórios de problemas.
=== Mudanças na Documentação
-Mudanças na documentação são supervisionadas pela http://lists.FreeBSD.org/mailman/listinfo/freebsd-doc[lista de documentação do projeto FreeBSD]. Por favor veja o link:{fdp-primer}[Manual do Projeto de Documentação do FreeBSD] para instruções completas. Envie contribuições e mudanças (mesmo as pequenas são bem vindas!) utilizando o mesmo método de qualquer outro relatório de bug.
+Mudanças na documentação são supervisionadas pela http://lists.FreeBSD.org/mailman/listinfo/freebsd-doc[lista de documentação do projeto FreeBSD]. Por favor veja o extref:{fdp-primer}[Manual do Projeto de Documentação do FreeBSD] para instruções completas. Envie contribuições e mudanças (mesmo as pequenas são bem vindas!) utilizando o mesmo método de qualquer outro relatório de bug.
=== Mudanças no Código Fonte Existente
-Um acréscimo ou mudança em um código fonte existe é um tema um pouco complicado e depende muito de como você está desatualizado com o estado atual do desenvolvimento do FreeBSD. Existe uma release especial do FreeBSD em andamento conhecida como "FreeBSD-CURRENT" que é disponibilizada de várias maneiras para conveniência dos desenvolvedores que trabalham ativamente no sistema. Veja o link:{handbook}#current-stable[Handbook do FreeBSD] para mais informação sobre como obter e usar o FreeBSD-CURRENT.
+Um acréscimo ou mudança em um código fonte existe é um tema um pouco complicado e depende muito de como você está desatualizado com o estado atual do desenvolvimento do FreeBSD. Existe uma release especial do FreeBSD em andamento conhecida como "FreeBSD-CURRENT" que é disponibilizada de várias maneiras para conveniência dos desenvolvedores que trabalham ativamente no sistema. Veja o extref:{handbook}updating-upgrading[Handbook do FreeBSD, current-stable] para mais informação sobre como obter e usar o FreeBSD-CURRENT.
Trabalhar com versões antigas do código, infelizmente, muitas vezes significa que as suas alterações serão demasiadamente obsoletas ou muito divergentes para possibilitar uma fácil re-integração ao FreeBSD. As possibilidades de que isso ocorra podem ser minimizadas um pouco através da sua inscrição na http://lists.FreeBSD.org/mailman/listinfo/freebsd-announce[lista de distribuição de comunicados oficiais do projeto FreeBSD] e na http://lists.FreeBSD.org/mailman/listinfo/freebsd-current[lista de discussão do FreeBSD-CURRENT], nas quais as discussões sobre o estado atual do sistema ocorrem.
@@ -215,7 +216,7 @@ Você pode verificar se um port tem ou não dependências ou se outros ports dep
==== Como adotar o port
-Primeiro, certifique-se de entender quais serão as suas <<maintain-port>>. Leia também o link:{porters-handbook}[Porter's Handbook]. _Por favor, não se comprometa com mais do que você acha que pode lidar sem se sobrecarregar._
+Primeiro, certifique-se de entender quais serão as suas <<maintain-port>>. Leia também o extref:{porters-handbook}[Porter's Handbook]. _Por favor, não se comprometa com mais do que você acha que pode lidar sem se sobrecarregar._
Você pode solicitar para se tornar o responsável pela manutenção de qualquer port que não esteja sendo mantido por outra pessoa assim que desejar. Basta definir o parâmetro `MAINTAINER` para o seu próprio endereço de e-mail e enviar um PR (Relatório de Problemas) com a alteração. Se o port tiver erros de compilação ou precisar de atualização, você pode aproveitar para incluir quaisquer outras alterações que sejam necessárias neste mesmo PR. Isso irá acelerar o processo pois muitos committers não estão dispostos a atribuir a responsabilidade de manutenção de um port para alguém que não tenha um histórico conhecido com o FreeBSD. O envio de PRs (relatórios de problema) para corrigir erros de compilação ou para atualizar um port é a melhor maneira de estabelecer este histórico.
@@ -255,7 +256,7 @@ Como mantenedor, você precisará gerenciar os seguintes desafios:
Esta seção descreve o processo a ser seguido para manter seus ports atualizados.
-Esta é uma visão geral. Mais informações sobre a atualização de um port está disponível no link:{porters-handbook}[Porter's Handbook].
+Esta é uma visão geral. Mais informações sobre a atualização de um port está disponível no extref:{porters-handbook}[Porter's Handbook].
[.procedure]
. Preste atenção às atualizações
@@ -278,11 +279,11 @@ Examine cuidadosamente e teste as suas mudanças
. Envie as alterações
+
-Submeta sua atualização enviando um relatório de problema (PR) com uma explicação das alterações e um patch contendo as diferenças entre o port original e a versão atualizada. Por favor, consulte o artigo link:{problem-reports}[Escrevendo um Relatório de Problema para o FreeBSD] para mais informações sobre como escrever um PR realmente bom.
+Submeta sua atualização enviando um relatório de problema (PR) com uma explicação das alterações e um patch contendo as diferenças entre o port original e a versão atualizada. Por favor, consulte o artigo extref:{problem-reports}[Escrevendo um Relatório de Problema para o FreeBSD] para mais informações sobre como escrever um PR realmente bom.
+
[NOTE]
====
-Por favor não submeta um arquivo man:shar[1] do port inteiro, ao invés disso, utilize o comando man:diff[1] `-ruN`. Desta forma, os committers podem ver com mais facilidade exatamente quais alterações estão sendo feitas. Consulte a seção link:{porters-handbook}#port-upgrading[Upgrading] do Porter's Handbook para maiores informações.
+Por favor não submeta um arquivo man:shar[1] do port inteiro, ao invés disso, utilize o comando man:diff[1] `-ruN`. Desta forma, os committers podem ver com mais facilidade exatamente quais alterações estão sendo feitas. Consulte a seção extref:{porters-handbook}[Upgrading, port-upgrading] do Porter's Handbook para maiores informações.
====
. Aguarde
+
@@ -409,9 +410,9 @@ De qualquer forma, a Equipe de Gerenciamento da Coleção de Ports (`portmgr`) r
[[resources]]
=== Recursos para mantenedores de ports e contribuidores
-O link:{porters-handbook}[Porter's Handbook] é o seu Guia de Mochileiro para o sistema de ports. Mantenha-o à mão!
+O extref:{porters-handbook}[Porter's Handbook] é o seu Guia de Mochileiro para o sistema de ports. Mantenha-o à mão!
-O artigo link:{problem-reports}[Escrevendo um relatório de problemas para o FreeBSD] descreve como melhor formular e enviar um PR. Em 2005, foram submetidos mais de onze mil relatórios de problemas relacionados aos ports! Ao seguir as boas práticas descritas neste artigo você nos ajudará a reduzir em muito o tempo necessário para lidar com seus PRs.
+O artigo extref:{problem-reports}[Escrevendo um relatório de problemas para o FreeBSD] descreve como melhor formular e enviar um PR. Em 2005, foram submetidos mais de onze mil relatórios de problemas relacionados aos ports! Ao seguir as boas práticas descritas neste artigo você nos ajudará a reduzir em muito o tempo necessário para lidar com seus PRs.
O https://bugs.freebsd.org/bugzilla/query.cgi[Banco de dados de problemas reportados].
@@ -421,7 +422,7 @@ O http://portscout.FreeBSD.org[scanner de arquivos distfile] da coleção de por
O uso do package:ports-mgmt/poudriere[] é a maneira mais completa de testar um port durante todo o ciclo de instalação, empacotamento e desinstalação. A documentação está localizada no https://github.com/freebsd/poudriere[Repositório do poudriere no github]
-O man:portlint[1] é uma aplicação que pode ser utilizada para verificar se o seu port está em conformidade com muitas diretrizes importantes de estilo e função. O portlint é um aplicativo heurístico simples, portanto você deve usá-lo __apenas como um guia__. Se o portlint sugerir alterações que não sejam razoáveis, consulte o link:{porters-handbook}[Porter's Handbook] ou peça conselhos.
+O man:portlint[1] é uma aplicação que pode ser utilizada para verificar se o seu port está em conformidade com muitas diretrizes importantes de estilo e função. O portlint é um aplicativo heurístico simples, portanto você deve usá-lo __apenas como um guia__. Se o portlint sugerir alterações que não sejam razoáveis, consulte o extref:{porters-handbook}[Porter's Handbook] ou peça conselhos.
A http://lists.FreeBSD.org/mailman/listinfo/freebsd-ports[Lista de discussão de ports do FreeBSD ] é destinada para discussões gerais relacionadas aos ports. É um bom lugar para pedir ajuda. Você pode se https://lists.freebsd.org/mailman/listinfo[inscrever, ler e pesquisar os arquivos da lista]. Ler os arquivos da http://lists.FreeBSD.org/mailman/listinfo/freebsd-ports-bugs[Lista de discussão sobre bugs dos ports do FreeBSD] e as http://lists.FreeBSD.org/mailman/listinfo/svn-ports-head[mensagens de commit no SVN da árvore de ports para head/] também pode ser interessante.
diff --git a/documentation/content/pt-br/articles/contributors/_index.adoc b/documentation/content/pt-br/articles/contributors/_index.adoc
index 40236277af..d33d444ab5 100644
--- a/documentation/content/pt-br/articles/contributors/_index.adoc
+++ b/documentation/content/pt-br/articles/contributors/_index.adoc
@@ -11,32 +11,31 @@ trademarks: ["freebsd", "sun", "general"]
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:sectnumlevels: 6
+:images-path: articles/contributors/
-ifeval::["{backend}" == "html5"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/pt-br/urls.adoc[]
-:include-path: content/pt-br/articles/contributors/
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+:include-path: content/{{% lang %}}/articles/contributors/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/pt-br/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
:include-path:
endif::[]
+endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
:include-path:
endif::[]
@@ -113,7 +112,7 @@ As seguintes pessoas e empresas generosamente contribuíram com hardware para te
* _Contribuidores Especiais:_
-** http://www.osd.bsdi.com/[BSDi] (antigo Walnut Creek CDROM) doou mais do que podemos dizer (veja a seção 'Sobre o Projeto FreeBSD' no link:{handbook}[FreeBSD Handbook] para mais detalhes). Em particular, nós gostaríamos de agradecê-los pelo hardware original utilizado na `freefall.FreeBSD.org`, nossa máquina de desenvolvimento primária, e pela `thud.FreeBSD.org`, uma máquina para compilações e testes. Nós também estamos em débito com eles pelo financiamento de vários contribuidores ao longo dos anos e por prover acesso irrestrito a nós em sua conexão com a Internet T1.
+** http://www.osd.bsdi.com/[BSDi] (antigo Walnut Creek CDROM) doou mais do que podemos dizer (veja a seção 'Sobre o Projeto FreeBSD' no extref:{handbook}[FreeBSD Handbook] para mais detalhes). Em particular, nós gostaríamos de agradecê-los pelo hardware original utilizado na `freefall.FreeBSD.org`, nossa máquina de desenvolvimento primária, e pela `thud.FreeBSD.org`, uma máquina para compilações e testes. Nós também estamos em débito com eles pelo financiamento de vários contribuidores ao longo dos anos e por prover acesso irrestrito a nós em sua conexão com a Internet T1.
** A http://www.interface-business.de/[interface business GmbH, Dresden] tem apoiado pacientemente {joerg} que muitas vezes preferiu o trabalho no FreeBSD ao invés de um trabalho remunerado, e costuma usar sua conexão de Internet da EUnet (bem caro) sempre que sua conexão privada se torna lenta demais para trabalhar com ela…
** http://www.bsdi.com/[Berkeley Software Design, Inc.] contribuiu com seu código de emulação do DOS para o mundo BSD, o qual é utilizado no comando _doscmd_.
@@ -124,7 +123,7 @@ Estas são as pessoas que possuem privilégios de commit e fazem o trabalho de e
(em ordem alfabética pelo sobrenome):
-include::content/en/articles/contributors/contrib-committers.adoc[]
+include::{include-path}contrib-committers.adoc[]
[[contrib-corealumni]]
== Ex Membros do Core Team
@@ -133,7 +132,7 @@ As seguintes pessoas eram membros do Core Team do FreeBSD durante os períodos i
_Em ordem cronológica reversa:_
-include::content/en/articles/contributors/contrib-corealumni.adoc[]
+include::{include-path}contrib-corealumni.adoc[]
[[contrib-develalumni]]
== Ex Membros do Time de Desenvolvimento
@@ -142,7 +141,7 @@ As seguintes pessoas eram membros do time de desenvolvimento do FreeBSD durante
_Em ordem cronológica reversa:_
-include::content/en/articles/contributors/contrib-develalumni.adoc[]
+include::{include-path}contrib-develalumni.adoc[]
[[contrib-portmgralumni]]
== Ex Membros do Ports Management
@@ -151,7 +150,7 @@ As seguintes pessoas eram membros do time portmgr do FreeBSD durante os período
_Em ordem cronológica reversa:_
-include::content/en/articles/contributors/contrib-portmgralumni.adoc[]
+include::{include-path}contrib-portmgralumni.adoc[]
[[contrib-develinmemoriam]]
== Time de Desenvolvimento: Em memória
@@ -174,11 +173,11 @@ Há partes do NetBSD e do OpenBSD que foram integradas no FreeBSD também, e gos
(em ordem alfabética pelo primeiro nome):
-include::content/en/articles/contributors/contrib-additional.adoc[]
+include::{include-path}contrib-additional.adoc[]
[[contrib-386bsd]]
== Contribuidores do Kit Patch 386BSD
(em ordem alfabética pelo primeiro nome):
-include::content/en/articles/contributors/contrib-386bsd.adoc[]
+include::{include-path}contrib-386bsd.adoc[]
diff --git a/documentation/content/pt-br/articles/contributors/_index.po b/documentation/content/pt-br/articles/contributors/_index.po
index 7836b6fda2..078c50eff6 100644
--- a/documentation/content/pt-br/articles/contributors/_index.po
+++ b/documentation/content/pt-br/articles/contributors/_index.po
@@ -438,7 +438,7 @@ msgstr "_Contribuidores Especiais:_"
msgid ""
"http://www.osd.bsdi.com/[BSDi] (formerly Walnut Creek CDROM) has donated "
"almost more than we can say (see the 'About the FreeBSD Project' section of "
-"the link:{handbook}[FreeBSD Handbook] for more details). In particular, we "
+"the extref:{handbook}[FreeBSD Handbook] for more details). In particular, we "
"would like to thank them for the original hardware used for `freefall."
"FreeBSD.org`, our primary development machine, and for `thud.FreeBSD.org`, a "
"testing and build box. We are also indebted to them for funding various "
@@ -446,7 +446,7 @@ msgid ""
"T1 connection to the Internet."
msgstr ""
"http://www.osd.bsdi.com/[BSDi] (antigo Walnut Creek CDROM) doou mais do que "
-"podemos dizer (veja a seção 'Sobre o Projeto FreeBSD' no link:{handbook}["
+"podemos dizer (veja a seção 'Sobre o Projeto FreeBSD' no extref:{handbook}["
"FreeBSD Handbook] para mais detalhes). Em particular, nós gostaríamos de "
"agradecê-los pelo hardware original utilizado na `freefall.FreeBSD.org`, "
"nossa máquina de desenvolvimento primária, e pela `thud.FreeBSD.org`, uma "
diff --git a/documentation/content/pt-br/articles/contributors/contrib-386bsd.adoc b/documentation/content/pt-br/articles/contributors/contrib-386bsd.adoc
new file mode 100644
index 0000000000..0aa8ef1036
--- /dev/null
+++ b/documentation/content/pt-br/articles/contributors/contrib-386bsd.adoc
@@ -0,0 +1,95 @@
+* Adam Glass mailto:glass@postgres.berkeley.edu[glass@postgres.berkeley.edu]
+* Adrian Hall mailto:ahall@mirapoint.com[ahall@mirapoint.com]
+* Andrey A. Chernov mailto:ache@astral.msk.su[ache@astral.msk.su]
+* Andrew Gerweck mailto:andy@gerweck.dynup.net[andy@gerweck.dynup.net]
+* Andrew Herbert mailto:andrew@werple.apana.org.au[andrew@werple.apana.org.au]
+* Andrew Moore mailto:alm@netcom.com[alm@netcom.com]
+* Andy Valencia mailto:ajv@csd.mot.com[ajv@csd.mot.com]mailto:jtk@netcom.com[jtk@netcom.com]
+* Arne Henrik Juul mailto:arnej@Lise.Unit.NO[arnej@Lise.Unit.NO]
+* Bakul Shah mailto:bvs@bitblocks.com[bvs@bitblocks.com]
+* Barry Irwin mailto:bvi@moria.org[bvi@moria.org]
+* Barry Lustig mailto:barry@ictv.com[barry@ictv.com]
+* Bob Wilcox mailto:bob@obiwan.uucp[bob@obiwan.uucp]
+* Branko Lankester
+* Brett Lymn mailto:blymn@mulga.awadi.com.AU[blymn@mulga.awadi.com.AU]
+* Charles Hannum mailto:mycroft@ai.mit.edu[mycroft@ai.mit.edu]
+* Chris G. Demetriou mailto:cgd@postgres.berkeley.edu[cgd@postgres.berkeley.edu]
+* Chris Torek mailto:torek@ee.lbl.gov[torek@ee.lbl.gov]
+* Christoph Robitschko mailto:chmr@edvz.tu-graz.ac.at[chmr@edvz.tu-graz.ac.at]
+* Daniel Poirot mailto:poirot@aio.jsc.nasa.gov[poirot@aio.jsc.nasa.gov]
+* Dave Burgess mailto:burgess@hrd769.brooks.af.mil[burgess@hrd769.brooks.af.mil]
+* Dave Rivers mailto:rivers@ponds.uucp[rivers@ponds.uucp]
+* David Dawes mailto:dawes@physics.su.OZ.AU[dawes@physics.su.OZ.AU]
+* David Greenman mailto:dg@Root.COM[dg@Root.COM]
+* Eric J. Haug mailto:ejh@slustl.slu.edu[ejh@slustl.slu.edu]
+* Felix Gaehtgens mailto:felix@escape.vsse.in-berlin.de[felix@escape.vsse.in-berlin.de]
+* Frank Maclachlan mailto:fpm@crash.cts.com[fpm@crash.cts.com]
+* Gary A. Browning mailto:gab10@griffcd.amdahl.com[gab10@griffcd.amdahl.com]
+* Gary Howland mailto:gary@hotlava.com[gary@hotlava.com]
+* Geoff Rehmet mailto:csgr@alpha.ru.ac.za[csgr@alpha.ru.ac.za]
+* Goran Hammarback mailto:goran@astro.uu.se[goran@astro.uu.se]
+* Guido van Rooij mailto:guido@gvr.org[guido@gvr.org]
+* Guy Antony Halse mailto:guy@rucus.ru.ac.za[guy@rucus.ru.ac.za]
+* Guy Harris mailto:guy@auspex.com[guy@auspex.com]
+* Havard Eidnes mailto:Havard.Eidnes@runit.sintef.no[Havard.Eidnes@runit.sintef.no]
+* Herb Peyerl mailto:hpeyerl@novatel.cuc.ab.ca[hpeyerl@novatel.cuc.ab.ca]
+* Holger Veit mailto:Holger.Veit@gmd.de[Holger.Veit@gmd.de]
+* Ishii Masahiro, R. Kym Horsell
+* J.T. Conklin mailto:jtc@cygnus.com[jtc@cygnus.com]
+* Jagane D Sundar mailto:jagane@netcom.com[jagane@netcom.com]
+* James Clark mailto:jjc@jclark.com[jjc@jclark.com]
+* James Jegers mailto:jimj@miller.cs.uwm.edu[jimj@miller.cs.uwm.edu]
+* James W. Dolter
+* James da Silva mailto:jds@cs.umd.edu[jds@cs.umd.edu] et al
+* Jay Fenlason mailto:hack@datacube.com[hack@datacube.com]
+* Jim Wilson mailto:wilson@moria.cygnus.com[wilson@moria.cygnus.com]
+* Jörg Lohse mailto:lohse@tech7.informatik.uni-hamburg.de[lohse@tech7.informatik.uni-hamburg.de]
+* Jörg Wunsch mailto:joerg_wunsch@uriah.heep.sax.de[joerg_wunsch@uriah.heep.sax.de]
+* John Dyson
+* John Woods mailto:jfw@eddie.mit.edu[jfw@eddie.mit.edu]
+* Jordan K. Hubbard mailto:jkh@whisker.hubbard.ie[jkh@whisker.hubbard.ie]
+* Julian Elischer mailto:julian@dialix.oz.au[julian@dialix.oz.au]
+* Karl Dietz mailto:Karl.Dietz@triplan.com[Karl.Dietz@triplan.com]
+* Karl Lehenbauer mailto:karl@NeoSoft.com[karl@NeoSoft.com]mailto:karl@one.neosoft.com[karl@one.neosoft.com]
+* Keith Bostic mailto:bostic@toe.CS.Berkeley.EDU[bostic@toe.CS.Berkeley.EDU]
+* Ken Hughes
+* Kent Talarico mailto:kent@shipwreck.tsoft.net[kent@shipwreck.tsoft.net]
+* Kevin Lahey mailto:kml%rokkaku.UUCP@mathcs.emory.edu[kml%rokkaku.UUCP@mathcs.emory.edu]mailto:kml@mosquito.cis.ufl.edu[kml@mosquito.cis.ufl.edu]
+* Konstantinos Konstantinidis mailto:kkonstan@duth.gr[kkonstan@duth.gr]
+* Marc Frajola mailto:marc@dev.com[marc@dev.com]
+* Mark Tinguely mailto:tinguely@plains.nodak.edu[tinguely@plains.nodak.edu]mailto:tinguely@hookie.cs.ndsu.NoDak.edu[tinguely@hookie.cs.ndsu.NoDak.edu]
+* Martin Renters mailto:martin@tdc.on.ca[martin@tdc.on.ca]
+* Michael Clay mailto:mclay@weareb.org[mclay@weareb.org]
+* Michael Galassi mailto:nerd@percival.rain.com[nerd@percival.rain.com]
+* Mike Durkin mailto:mdurkin@tsoft.sf-bay.org[mdurkin@tsoft.sf-bay.org]
+* Naoki Hamada mailto:nao@tom-yam.or.jp[nao@tom-yam.or.jp]
+* Nate Williams mailto:nate@bsd.coe.montana.edu[nate@bsd.coe.montana.edu]
+* Nick Handel mailto:nhandel@NeoSoft.com[nhandel@NeoSoft.com]mailto:nick@madhouse.neosoft.com[nick@madhouse.neosoft.com]
+* Pace Willisson mailto:pace@blitz.com[pace@blitz.com]
+* Paul Kranenburg mailto:pk@cs.few.eur.nl[pk@cs.few.eur.nl]
+* Paul Mackerras mailto:paulus@cs.anu.edu.au[paulus@cs.anu.edu.au]
+* Paul Popelka mailto:paulp@uts.amdahl.com[paulp@uts.amdahl.com]
+* Peter da Silva mailto:peter@NeoSoft.com[peter@NeoSoft.com]
+* Phil Sutherland mailto:philsuth@mycroft.dialix.oz.au[philsuth@mycroft.dialix.oz.au]
+* Poul-Henning Kamp mailto:phk@FreeBSD.org[phk@FreeBSD.org]
+* Ralf Friedl mailto:friedl@informatik.uni-kl.de[friedl@informatik.uni-kl.de]
+* Rick Macklem mailto:root@snowhite.cis.uoguelph.ca[root@snowhite.cis.uoguelph.ca]
+* Robert D. Thrush mailto:rd@phoenix.aii.com[rd@phoenix.aii.com]
+* Rodney W. Grimes mailto:rgrimes@cdrom.com[rgrimes@cdrom.com]
+* Sascha Wildner mailto:swildner@channelz.GUN.de[swildner@channelz.GUN.de]
+* Scott Burris mailto:scott@pita.cns.ucla.edu[scott@pita.cns.ucla.edu]
+* Scott Reynolds mailto:scott@clmqt.marquette.mi.us[scott@clmqt.marquette.mi.us]
+* Seamus Venasse mailto:svenasse@polaris.ca[svenasse@polaris.ca]
+* Sean Eric Fagan mailto:sef@kithrup.com[sef@kithrup.com]
+* Sean McGovern mailto:sean@sfarc.net[sean@sfarc.net]
+* Simon J Gerraty mailto:sjg@melb.bull.oz.au[sjg@melb.bull.oz.au]mailto:sjg@zen.void.oz.au[sjg@zen.void.oz.au]
+* Stephen McKay mailto:syssgm@devetir.qld.gov.au[syssgm@devetir.qld.gov.au]
+* Terry Lambert mailto:terry@icarus.weber.edu[terry@icarus.weber.edu]
+* Terry Lee mailto:terry@uivlsi.csl.uiuc.edu[terry@uivlsi.csl.uiuc.edu]
+* Tor Egge mailto:Tor.Egge@idi.ntnu.no[Tor.Egge@idi.ntnu.no]
+* Warren Toomey mailto:wkt@csadfa.cs.adfa.oz.au[wkt@csadfa.cs.adfa.oz.au]
+* Wiljo Heinen mailto:wiljo@freeside.ki.open.de[wiljo@freeside.ki.open.de]
+* William Jolitz mailto:withheld[withheld]
+* Wolfgang Solfrank mailto:ws@tools.de[ws@tools.de]
+* Wolfgang Stanglmeier mailto:wolf@dentaro.GUN.de[wolf@dentaro.GUN.de]
+* Yuval Yarom mailto:yval@cs.huji.ac.il[yval@cs.huji.ac.il]
diff --git a/documentation/content/pt-br/articles/contributors/contrib-additional.adoc b/documentation/content/pt-br/articles/contributors/contrib-additional.adoc
new file mode 100644
index 0000000000..0871236204
--- /dev/null
+++ b/documentation/content/pt-br/articles/contributors/contrib-additional.adoc
@@ -0,0 +1,2387 @@
+* ABURAYA Ryushirou mailto:rewsirow@ff.iij4u.or.jp[rewsirow@ff.iij4u.or.jp]
+* AIDA Shinra mailto:aida-s@jcom.home.ne.jp[aida-s@jcom.home.ne.jp]
+* AMAGAI Yoshiji mailto:amagai@nue.org[amagai@nue.org]
+* Aaron Bornstein mailto:aaronb@j51.com[aaronb@j51.com]
+* Aaron Myles Landwehr mailto:aaron@snaphat.com[aaron@snaphat.com]
+* Aaron Smith mailto:aaron@mutex.org[aaron@mutex.org]
+* Aaron Straup Cope mailto:ascope@cpan.org[ascope@cpan.org]
+* Aaron Voisine mailto:voisine@gmail.com[voisine@gmail.com]
+* Aaron Zauner mailto:az_mail@gmx.at[az_mail@gmx.at]
+* Aasmund Eikli mailto:inter@o12a.com[inter@o12a.com]
+* Achim Patzner mailto:ap@noses.com[ap@noses.com]
+* Ada T Lim mailto:ada@bsd.org[ada@bsd.org]
+* Adam Baran mailto:badam@mw.mil.pl[badam@mw.mil.pl]
+* Adam C. Migus mailto:adam@migus.org[adam@migus.org]
+* Adam Glass mailto:glass@postgres.berkeley.edu[glass@postgres.berkeley.edu]
+* Adam Herzog mailto:adam@herzogdesigns.com[adam@herzogdesigns.com]
+* Adam Jette mailto:jettea46@yahoo.com[jettea46@yahoo.com]
+* Adam Kranzel mailto:adam@alameda.edu[adam@alameda.edu]
+* Adam McDougall mailto:mcdouga9@egr.msu.edu[mcdouga9@egr.msu.edu]
+* Adam McLaurin mailto:adam.freebsd@fastmail.fm[adam.freebsd@fastmail.fm]
+* Adam Strohl mailto:troll@digitalspark.net[troll@digitalspark.net]
+* Adam Wight mailto:adamw@tulum.brsys.com[adamw@tulum.brsys.com]
+* Adoal Xu mailto:adoal@iname.com[adoal@iname.com]
+* Adrian Colley mailto:aecolley@ois.ie[aecolley@ois.ie]
+* Adrian Filipi-Martin mailto:adrian@ubergeeks.com[adrian@ubergeeks.com]
+* Adrian Hall mailto:ahall@mirapoint.com[ahall@mirapoint.com]
+* Adrian Mariano mailto:adrian@cam.cornell.edu[adrian@cam.cornell.edu]
+* Adrian Pircalabu mailto:apircalabu@bitdefender.com[apircalabu@bitdefender.com]
+* Adrian Steinmann mailto:ast@marabu.ch[ast@marabu.ch]
+* Adrian T. Filipi-Martin mailto:atf3r@agate.cs.virginia.edu[atf3r@agate.cs.virginia.edu]
+* Aftab Jahan Subedar mailto:jahan@bol-online.com[jahan@bol-online.com]
+* Ajit Thyagarajan
+* Akinori YAMADA mailto:yamada-a@nextcom.co.jp[yamada-a@nextcom.co.jp]
+* Akira Ikeuchi mailto:a_ikeuchi@mic.mitsumi.co.jp[a_ikeuchi@mic.mitsumi.co.jp]
+* Akira SAWADA
+* Akira Watanabe mailto:akira@myaw.ei.meisei-u.ac.jp[akira@myaw.ei.meisei-u.ac.jp]
+* Akito Fujita mailto:fujita@zoo.ncl.omron.co.jp[fujita@zoo.ncl.omron.co.jp]
+* Akos Somfai mailto:akos.somfai@gmail.com[akos.somfai@gmail.com]
+* Al Hoang mailto:hoanga@mac.com[hoanga@mac.com]
+* Alain Kalker mailto:A.C.P.M.Kalker@student.utwente.nl[A.C.P.M.Kalker@student.utwente.nl]
+* Alan Amesbury mailto:amesbury@indefi.net[amesbury@indefi.net]
+* Alan Bawden mailto:alan@curry.epilogue.com[alan@curry.epilogue.com]
+* Alan Snelson mailto:Alan@Wave2.co.uk[Alan@Wave2.co.uk]
+* Alban Maire mailto:a.maire@s2mi.fr[a.maire@s2mi.fr]
+* Albert Graef mailto:Dr.Graef@t-online.de[Dr.Graef@t-online.de]
+* Aldert Nooitgedagt mailto:aldert@nooitgedagt.net[aldert@nooitgedagt.net]
+* Aldis Berjoza mailto:killasmurf86@gmail.com[killasmurf86@gmail.com]
+* Alec Wolman mailto:wolman@cs.washington.edu[wolman@cs.washington.edu]
+* Aled Morris mailto:aledm@routers.co.uk[aledm@routers.co.uk]
+* Aleksander Fafula mailto:alex@fafula.com[alex@fafula.com]
+* Aleksandr A Babaylov mailto:.@babolo.ru[.@babolo.ru]
+* Aleksandr S. Goncharov mailto:mraleks@bk.ru[mraleks@bk.ru]
+* Alessandro Sagratini mailto:ale_sagra@hotmail.com[ale_sagra@hotmail.com]
+* Alex D. Chen mailto:dhchen@elearning.nsysu.edu.tw[dhchen@elearning.nsysu.edu.tw]
+* Alex Deiter mailto:tiamat@komi.mts.ru[tiamat@komi.mts.ru]
+* Alex G. Bulushev mailto:bag@demos.su[bag@demos.su]
+* Alex Kapranoff mailto:alex@kapranoff.ru[alex@kapranoff.ru]
+* Alex Keda mailto:admin@lissyara.su[admin@lissyara.su]
+* Alex Kiesel mailto:kiesel@schlund.de[kiesel@schlund.de]
+* Alex Le Heux mailto:alexlh@funk.org[alexlh@funk.org]
+* Alex M mailto:alex@myzona.net[alex@myzona.net]
+* Alex Miller mailto:asm@asm.kiev.ua[asm@asm.kiev.ua]
+* Alex Nunes Soares mailto:alexnunessoares@gmail.com[alexnunessoares@gmail.com]
+* Alex Perel mailto:veers@disturbed.net[veers@disturbed.net]
+* Alex Pesternikov mailto:ap@page2rss.com[ap@page2rss.com]
+* Alex Rodioukov mailto:simuran@shaw.ca[simuran@shaw.ca]
+* Alex Rousskov mailto:rousskov@measurement-factory.com[rousskov@measurement-factory.com]
+* Alex Semenyaka mailto:alex@rinet.ru[alex@rinet.ru]
+* Alex Steiner mailto:ast@treibsand.com[ast@treibsand.com]
+* Alex Trull mailto:alexander@trull.com[alexander@trull.com]
+* Alex Varju mailto:freebsd-ports@varju.ca[freebsd-ports@varju.ca]
+* Alex Vasylenko mailto:lxv@omut.org[lxv@omut.org]
+* Alex Wilkinson mailto:alex.wilkinson@dsto.defence.gov.au[alex.wilkinson@dsto.defence.gov.au]
+* Alex Zepeda mailto:garbanzo@hooked.net[garbanzo@hooked.net]
+* Alexander Bechikov mailto:goo@t72.ru[goo@t72.ru]
+* {arundel}
+* Alexander Churanov mailto:alexanderchuranov@gmail.com[alexanderchuranov@gmail.com]
+* Alexander B. Povolotsky mailto:tarkhil@mgt.msk.ru[tarkhil@mgt.msk.ru]
+* Alexander Gelfenbain mailto:mail@gelf.com[mail@gelf.com]
+* Alexander Pereira Girald mailto:girald@etcom.ufrgs.br[girald@etcom.ufrgs.br]
+* Alexander Grigoryev mailto:alexander.4mail@gmail.com[alexander.4mail@gmail.com]
+* Alexander Gromnizki mailto:gromnizki@unixdev.net[gromnizki@unixdev.net]
+* Alexander Haderer mailto:alexander.haderer@charite.de[alexander.haderer@charite.de]
+* Alexander Koch mailto:fbsd@meersau.de[fbsd@meersau.de]
+* Alexander Kojevnikov mailto:alexander@kojevnikov.com[alexander@kojevnikov.com]
+* Alexander Kovalenko mailto:never@nevermind.kiev.ua[never@nevermind.kiev.ua]
+* Alexander Moisseev mailto:moiseev@mezonplus.ru[moiseev@mezonplus.ru]
+* Alexander Novitsky mailto:alecn2002@yandex.ru[alecn2002@yandex.ru]
+* Alexander Nusov mailto:alexander.nusov@nfvexpress.com[alexander.nusov@nfvexpress.com]
+* Alexander Peresunko mailto:alex@freeman.org.ua[alex@freeman.org.ua]
+* Alexander Pohoyda mailto:alexander.pohoyda@gmx.net[alexander.pohoyda@gmx.net]
+* Alexander Pyhalov mailto:alp@sfedu.ru[alp@sfedu.ru]
+* alexander smishlajev mailto:alex@ank-sia.com[alex@ank-sia.com]
+* Alexander V. Ribchansky mailto:triosoft@triosoft.com.ua[triosoft@triosoft.com.ua]
+* Alexander Yerenkow mailto:yerenkow@gmail.com[yerenkow@gmail.com]
+* Alexander Sieg mailto:alex@xanderio.de[alex@xanderio.de]
+* Alexander Zagrebin mailto:alexz@visp.ru[alexz@visp.ru]
+* Alexander Zhuravlev mailto:zaa@zaa.pp.ru[zaa@zaa.pp.ru]
+* Alexandre Liberato mailto:alexandre@feiler.co[alexandre@feiler.co]
+* Alexandre Peixoto mailto:alexandref@tcoip.com.br[alexandref@tcoip.com.br]
+* Alexandre Snarskii mailto:snar@paranoia.ru[snar@paranoia.ru]
+* Alexandre Vasconcelos mailto:alex.vasconcelos@gmail.com[alex.vasconcelos@gmail.com]
+* Alexandros Kosiaris mailto:akosiaris+ports@gmail.com[akosiaris+ports@gmail.com]
+* Alexandru Ciobanu mailto:iscandr@gmail.com[iscandr@gmail.com]
+* Alexey Bobkov mailto:mr.deadlystorm@gmail.com[mr.deadlystorm@gmail.com]
+* Alexey Illarionov mailto:littlesavage@rambler.ru[littlesavage@rambler.ru]
+* Alexey V. Antipovsky mailto:kemm@in-line.ru[kemm@in-line.ru]
+* Alexey V. Degtyarev mailto:alexey@renatasystems.org[alexey@renatasystems.org]
+* Alexey V. Neyman mailto:alex.neyman@auriga.ru[alex.neyman@auriga.ru]
+* Alexey Y. Mikhailov mailto:karma@ez.pereslavl.ru[karma@ez.pereslavl.ru]
+* Alexey Shuvaev mailto:shuvaev@physik.uni-wuerzburg.de[shuvaev@physik.uni-wuerzburg.de]
+* Alexey Zaytsev mailto:mangoost@inetcomm.ru[mangoost@inetcomm.ru]
+* Alexis Yushin mailto:alexis@forest.NLnetLabs.nl[alexis@forest.NLnetLabs.nl]
+* Alfonso S. Siciliano mailto:alfix86@gmail.com[alfix86@gmail.com]
+* Ali Mashtizadeh mailto:mashtizadeh@gmail.com[mashtizadeh@gmail.com]
+* Alistair G. Crooks mailto:agc@uts.amdahl.com[agc@uts.amdahl.com]
+* Allan Bowhill mailto:bowhill@bowhill.vservers.com[bowhill@bowhill.vservers.com]
+* Allan Saddi mailto:asaddi@philosophysw.com[asaddi@philosophysw.com]
+* Allen Campbell mailto:allenc@verinet.com[allenc@verinet.com]
+* Alphons "Fonz" van Werven mailto:freebsd@skysmurf.nl[freebsd@skysmurf.nl]
+* Amakawa Shuhei mailto:amakawa@hoh.t.u-tokyo.ac.jp[amakawa@hoh.t.u-tokyo.ac.jp]
+* Amar Takhar mailto:verm@drunkmonk.net[verm@drunkmonk.net]
+* Amaziles José Antonio Martins de Carvalho mailto:amazilesjose@gmail.com[amazilesjose@gmail.com]
+* Amir Farah mailto:amir@comtrol.com[amir@comtrol.com]
+* Amir Shalem mailto:amir@boom.org.il[amir@boom.org.il]
+* Amarendra Godbole mailto:amarendra.godbole@gmail.com[amarendra.godbole@gmail.com]
+* Amy Baron mailto:amee@beer.org[amee@beer.org]
+* Anthony Garcia mailto:agarcia@experts-exchange.com[agarcia@experts-exchange.com]
+* Anatoliy Dmytriyev mailto:tolid@plab.ku.dk[tolid@plab.ku.dk]
+* Anatoly A. Orehovsky mailto:tolik@mpeks.tomsk.su[tolik@mpeks.tomsk.su]
+* Anatoly Borodin mailto:anatoly.borodin@gmail.com[anatoly.borodin@gmail.com]
+* Anatoly Vorobey mailto:mellon@pobox.com[mellon@pobox.com]
+* Anatoly Zherdev mailto:tolyar@mx.ru[tolyar@mx.ru]
+* Anders Andersson mailto:anders@codefactory.se[anders@codefactory.se]
+* Anders Nor Berle mailto:debolaz@debolaz.com[debolaz@debolaz.com]
+* Anders Thulin mailto:Anders.X.Thulin@telia.se[Anders.X.Thulin@telia.se]
+* Anders Troback mailto:freebsd@troback.com[freebsd@troback.com]
+* Anderson Aguiar mailto:anderson.n.aguair@gmail.com[anderson.n.aguair@gmail.com]
+* Anderson S. Ferreira mailto:anderson@cnpm.embrapa.br[anderson@cnpm.embrapa.br]
+* Andi Payn mailto:andi_payn@speedymail.org[andi_payn@speedymail.org]
+* Andre Albsmeier mailto:Andre.Albsmeier@mchp.siemens.de[Andre.Albsmeier@mchp.siemens.de]
+* André Franciosi mailto:andre@franciosi.org[andre@franciosi.org]
+* Andre Goeree mailto:abgoeree@uwnet.nl[abgoeree@uwnet.nl]
+* Andre Yelistratov mailto:andre@andre.net.ru[andre@andre.net.ru]
+* Andrea Venturoli mailto:a.ventu@flashnet.it[a.ventu@flashnet.it]
+* Andreas Andersson mailto:a.andersson.thn@gmail.com[a.andersson.thn@gmail.com]
+* Andreas Berg mailto:aberg@doomnet.de[aberg@doomnet.de]
+* Andreas Bilke mailto:andreas@bilke.org[andreas@bilke.org]
+* Andreas Fehlner mailto:fehlner@gmx.de[fehlner@gmx.de]
+* Andreas Fuchs mailto:asf@boinkor.net[asf@boinkor.net]
+* Andreas Gustafsson mailto:gson@araneus.fi[gson@araneus.fi]
+* Andreas Haakh mailto:ah@alman.robin.de[ah@alman.robin.de]
+* Andreas Heil mailto:ah@linux-hq.de[ah@linux-hq.de]
+* Andreas K Foerster mailto:akf3@akfoerster.de[akf3@akfoerster.de]
+* Andreas Karlsson mailto:norrland@nullbyte.se[norrland@nullbyte.se]
+* Andreas Kasparz mailto:andy@interface-business.de[andy@interface-business.de]
+* Andreas Kohn mailto:andreas@syndrom23.de[andreas@syndrom23.de]
+* Andreas Kohout mailto:shanee@rabbit.augusta.de[shanee@rabbit.augusta.de]
+* Andreas Lohr mailto:andreas@marvin.RoBIN.de[andreas@marvin.RoBIN.de]
+* Andreas Möller mailto:segfault@gmx.net[segfault@gmx.net]
+* Andreas Riedel mailto:rian@hrz.tu-chemnitz.de[rian@hrz.tu-chemnitz.de]
+* Andreas Sommer mailto:andreas.sommer87@googlemail.com[andreas.sommer87@googlemail.com]
+* Andreas Wetzel mailto:mickey@deadline.snafu.de[mickey@deadline.snafu.de]
+* Andreas Wrede mailto:andreas@planix.com[andreas@planix.com]
+* Andrei V. Shetuhin mailto:shetuhin@corp.mail.ru[shetuhin@corp.mail.ru]
+* Andrej Ebert mailto:andrej@ebert.su[andrej@ebert.su]
+* Andres Vega Garcia
+* Andrew Arensburger mailto:arensb@ooblick.com[arensb@ooblick.com]
+* Andrew Atrens mailto:atreand@statcan.ca[atreand@statcan.ca]
+* Andrew Boothman mailto:andrew@cream.org[andrew@cream.org]
+* Andrew Gillham mailto:gillham@andrews.edu[gillham@andrews.edu]
+* Andrew Gordon mailto:andrew.gordon@net-tel.co.uk[andrew.gordon@net-tel.co.uk]
+* Andrew Greenwood mailto:greenwood.andy@gmail.com[greenwood.andy@gmail.com]
+* Andrew Herbert mailto:andrew@werple.apana.org.au[andrew@werple.apana.org.au]
+* Andrew J. Caines mailto:A.J.Caines@halplant.com[A.J.Caines@halplant.com]
+* Andrew J. Korty mailto:ajk@iu.edu[ajk@iu.edu]
+* Andrew Khlebutin mailto:andrey@hm.perm.ru[andrey@hm.perm.ru]
+* Andrew Kochetkov mailto:kochetkov.andrew@gmail.com[kochetkov.andrew@gmail.com]
+* Andrew Kolchoogin mailto:andrew@rinet.ru[andrew@rinet.ru]
+* Andrew L. Kilpatrick mailto:tiger@whitetigersd.com[tiger@whitetigersd.com]
+* Andrew L. Neporada mailto:andrew@chg.ru[andrew@chg.ru]
+* Andrew Marks mailto:andrew@amrx.net[andrew@amrx.net]
+* Andrew McKay mailto:andy@openirc.co.uk[andy@openirc.co.uk]
+* Andrew McNaughton mailto:andrew@scoop.co.nz[andrew@scoop.co.nz]
+* Andrew McRae mailto:amcrae@cisco.com[amcrae@cisco.com]
+* Andrew Morton mailto:drewish@katherinehouse.com[drewish@katherinehouse.com]
+* Andrew P. Lentvorski mailto:bsder@allcaps.org[bsder@allcaps.org]
+* Andrew Predoehl mailto:predoehl@mail.kg[predoehl@mail.kg]
+* Andrew Reilly mailto:a.reilly@lake.com[a.reilly@lake.com]
+* Andrew Romanenko mailto:melanhit@gmail.com[melanhit@gmail.com]
+* Andrew S. Midthune mailto:amidthune@cableone.net[amidthune@cableone.net]
+* Andrew Shevtsov mailto:nyxo@dnuc.polyn.kiae.su[nyxo@dnuc.polyn.kiae.su]
+* Andrew Stevenson mailto:andrew@ugh.net.au[andrew@ugh.net.au]
+* Andrew Timonin mailto:tim@pool1.convey.ru[tim@pool1.convey.ru]
+* Andrew V. Stesin mailto:stesin@elvisti.kiev.ua[stesin@elvisti.kiev.ua]
+* Andrew V. Stikheev mailto:sand@links.ru[sand@links.ru]
+* Andrew Webster mailto:awebster@dataradio.com[awebster@dataradio.com]
+* Andrey Cherkashin mailto:andoriyu@gmail.com[andoriyu@gmail.com]
+* Andrey Fesenko mailto:andrey@bsdnir.info[andrey@bsdnir.info]
+* Andrey Novikov mailto:andrey@novikov.com[andrey@novikov.com]
+* Andrey Simonenko mailto:simon@comsys.ntu-kpi.kiev.ua[simon@comsys.ntu-kpi.kiev.ua]
+* Andrey Surkov mailto:nsand@sura.ru[nsand@sura.ru]
+* Andrey Sverdlichenko mailto:rblaze@users.sourceforge.net[rblaze@users.sourceforge.net]
+* Andrey Tchoritch mailto:andy@venus.sympad.net[andy@venus.sympad.net]
+* Andris Raugulis mailto:moo@arthepsy.eu[moo@arthepsy.eu]
+* Andy Farkas mailto:andyf@speednet.com.au[andyf@speednet.com.au]
+* Andy Fawcett mailto:andy@athame.co.uk[andy@athame.co.uk]
+* Andy Gilligan mailto:andy@evo6.org[andy@evo6.org]
+* Andy Kosela mailto:andy.kosela@gmail.com[andy.kosela@gmail.com]
+* Andy Miller mailto:andy@trit.org[andy@trit.org]
+* Andy Newman mailto:atrn@zeta.org.au[atrn@zeta.org.au]
+* Andy Pavlo mailto:amp0928@rit.edu[amp0928@rit.edu]
+* Andy Sparrow mailto:spadger@best.com[spadger@best.com]
+* Andy Valencia mailto:ajv@csd.mot.com[ajv@csd.mot.com]
+* Andy Whitcroft mailto:andy@sarc.city.ac.uk[andy@sarc.city.ac.uk]
+* Anes Muhametov mailto:anes@anes.su[anes@anes.su]
+* Angel Todorov mailto:todorov_bg@gmx.net[todorov_bg@gmx.net]
+* Angelo Turetta mailto:aturetta@commit.it[aturetta@commit.it]
+* Anish Mistry mailto:amistry@am-productions.biz[amistry@am-productions.biz]
+* Anthony C. Chavez mailto:acc@anthonychavez.org[acc@anthonychavez.org]
+* Anthony Ginepro mailto:anthony.ginepro@laposte.net[anthony.ginepro@laposte.net]
+* Anthony Mawer mailto:gnats@mawer.org[gnats@mawer.org]
+* Anthony Yee-Hang Chan mailto:yeehang@netcom.com[yeehang@netcom.com]
+* Antoine Beaupre mailto:anarcat@anarcat.ath.cx[anarcat@anarcat.ath.cx]
+* Antoine Pelisse mailto:apelisse@gmail.com[apelisse@gmail.com]
+* Anton Hryciuk mailto:gnixua@gmail.com[gnixua@gmail.com]
+* Anton N. Bruesov mailto:antonz@library.ntu-kpi.kiev.ua[antonz@library.ntu-kpi.kiev.ua]
+* Anton Shterenlikht mailto:mexas@bris.ac.uk[mexas@bris.ac.uk]
+* Anton Tornqvist mailto:antont@inbox.lv[antont@inbox.lv]
+* Anton Voronin mailto:anton@urc.ac.ru[anton@urc.ac.ru]
+* Anton Yuzhaninov mailto:citrin@citrin.ru[citrin@citrin.ru]
+* Antonio Bonifati mailto:ant@monitor.deis.unical.it[ant@monitor.deis.unical.it]
+* Antonio Carlos Venancio Junior mailto:antonio@php.net[antonio@php.net]
+* Antti Kaipila mailto:anttik@iki.fi[anttik@iki.fi]
+* Aragon Gouveia mailto:aragon@phat.za.net[aragon@phat.za.net]
+* Are Bryne mailto:are.bryne@communique.no[are.bryne@communique.no]
+* Ari Suutari mailto:ari@suutari.iki.fi[ari@suutari.iki.fi]
+* Arindum Mukerji mailto:raja@moselle.com[raja@moselle.com]
+* Arjan de Vet mailto:devet@devet.nl[devet@devet.nl]
+* Arnaud Berthomier mailto:oz@cyprio.net[oz@cyprio.net]
+* Arnaud Launay mailto:asl@launay.org[asl@launay.org]
+* Arne Henrik Juul mailto:arnej@Lise.Unit.NO[arnej@Lise.Unit.NO]
+* Aron Schlesinger mailto:as@bsdgroup.de[as@bsdgroup.de]
+* Aron Stansvik mailto:elvstone@gmail.com[elvstone@gmail.com]
+* Artem Kazakov mailto:kazakov@gmail.com[kazakov@gmail.com]
+* Artem Naluzhnyy mailto:tut@nhamon.com.ua[tut@nhamon.com.ua]
+* Artem Nosov mailto:chip-set@mail.ru[chip-set@mail.ru]
+* Ashley Penney mailto:ashp@unloved.org[ashp@unloved.org]
+* Ask Bjoern Hansen mailto:ask@valueclick.com[ask@valueclick.com]
+* Athanasios Douitsis mailto:aduitsis@cpan.org[aduitsis@cpan.org]
+* Atsushi Furuta mailto:furuta@sra.co.jp[furuta@sra.co.jp]
+* Atsushi Murai mailto:amurai@spec.co.jp[amurai@spec.co.jp]
+* Attila Nagy mailto:bra@fsn.hu[bra@fsn.hu]
+* Atushi Sakauchi mailto:sakauchi@yamame.to[sakauchi@yamame.to]
+* Autrijus Tang mailto:autrijus@autrijus.org[autrijus@autrijus.org]
+* Axel Gonzalez mailto:loox@e-shell.net[loox@e-shell.net]
+* Balázs Nagy mailto:js@iksz.hu[js@iksz.hu]
+* Barry Bierbauch mailto:pivrnec@vszbr.cz[pivrnec@vszbr.cz]
+* Barry Lustig mailto:barry@ictv.com[barry@ictv.com]
+* Bartosz Fabianowski mailto:freebsd@chillt.de[freebsd@chillt.de]
+* Bayanzul Lodoysamba mailto:baynaa@yahoo.com[baynaa@yahoo.com]
+* Ben Hutchinson mailto:benhutch@xfiles.org.uk[benhutch@xfiles.org.uk]
+* Ben Jackson
+* Ben Walter mailto:bwalter@itachi.swcp.com[bwalter@itachi.swcp.com]
+* Ben Woolley mailto:ports@tautology.org[ports@tautology.org]
+* Benedikt Köhler mailto:benedikt@furukama.de[benedikt@furukama.de]
+* Beni Keller mailto:navigium@grindcore.ch[navigium@grindcore.ch]
+* Benjamin Lewis mailto:bhlewis@gte.net[bhlewis@gte.net]
+* Benjamin Lutz mailto:benlutz@datacomm.ch[benlutz@datacomm.ch]
+* Benny Kjrgaard mailto:benny@catpipe.net[benny@catpipe.net]
+* Benoit Calvez mailto:benoit@litchis.org[benoit@litchis.org]
+* Berend de Boer mailto:berend@pobox.com[berend@pobox.com]
+* Bernd Luevelsmeyer mailto:bdluevel@heitec.net[bdluevel@heitec.net]
+* Bernd Rosauer mailto:br@schiele-ct.de[br@schiele-ct.de]
+* Bill Cadwallader mailto:hurbold@yahoo.com[hurbold@yahoo.com]
+* Bill Kish mailto:kish@osf.org[kish@osf.org]
+* Bill Lloyd mailto:wlloyd@mpd.ca[wlloyd@mpd.ca]
+* Bill Moran mailto:wmoran@collaborativefusion.com[wmoran@collaborativefusion.com]
+* Bill Trost mailto:trost@cloud.rain.com[trost@cloud.rain.com]
+* Björn König mailto:bkoenig@cs.tu-berlin.de[bkoenig@cs.tu-berlin.de]
+* Björn Lindström mailto:bkhl@elektrubadur.se[bkhl@elektrubadur.se]
+* Blaz Zupan mailto:blaz@amis.net[blaz@amis.net]
+* BluePex Security Solutions mailto:freebsd-ports@bluepex.com[freebsd-ports@bluepex.com]
+* Bob Eager mailto:bob@eager.cx[bob@eager.cx]
+* Bob Frazier mailto:bobf@mrp3.com[bobf@mrp3.com]
+* Bob Van Valzah mailto:Bob@whitebarn.com[Bob@whitebarn.com]
+* Bob Willcox mailto:bob@luke.pmr.com[bob@luke.pmr.com]
+* Boris Kovalenko mailto:boris@tagnet.ru[boris@tagnet.ru]
+* Boris Lytochkin mailto:lytboris@gmail.com[lytboris@gmail.com]
+* Boris Staeblow mailto:balu@dva.in-berlin.de[balu@dva.in-berlin.de]
+* Boyd R. Faulkner mailto:faulkner@asgard.bga.com[faulkner@asgard.bga.com]
+* Brad Chapman mailto:chapmanb@arches.uga.edu[chapmanb@arches.uga.edu]
+* Brad Hendrickse mailto:bradh@uunet.co.za[bradh@uunet.co.za]
+* Brad Jones mailto:brad@kazrak.com[brad@kazrak.com]
+* Brad Karp mailto:karp@eecs.harvard.edu[karp@eecs.harvard.edu]
+* Brad Lanam mailto:bll@gentoo.com[bll@gentoo.com]
+* Bradley Dunn mailto:bradley@dunn.org[bradley@dunn.org]
+* Bram Moolenaar mailto:bram@moolenaar.net[bram@moolenaar.net]
+* Brandon Fosdick mailto:bfoz@glue.umd.edu[bfoz@glue.umd.edu]
+* Brandon Gillespie mailto:brandon@roguetrader.com[brandon@roguetrader.com]
+* Brent B. Powers mailto:bbp2006@columbia.edu[bbp2006@columbia.edu]
+* Brent J. Nordquist mailto:bjn@visi.com[bjn@visi.com]
+* Brett Lymn mailto:blymn@mulga.awadi.com.AU[blymn@mulga.awadi.com.AU]
+* Brett Taylor mailto:brett@peloton.runet.edu[brett@peloton.runet.edu]
+* Brian Campbell mailto:brianc@pobox.com[brianc@pobox.com]
+* Brian Cully mailto:shmit@kublai.com[shmit@kublai.com]
+* Brian Gardner mailto:brian@getsnappy.com[brian@getsnappy.com]
+* Brian Handy mailto:handy@lambic.space.lockheed.com[handy@lambic.space.lockheed.com]
+* Brian Litzinger mailto:brian@MediaCity.com[brian@MediaCity.com]
+* Brian M. Clapper mailto:bmc@clapper.com[bmc@clapper.com]
+* Brian McGovern mailto:bmcgover@cisco.com[bmcgover@cisco.com]
+* Brian Moore mailto:ziff@houdini.eecs.umich.edu[ziff@houdini.eecs.umich.edu]
+* Brian R. Gaeke mailto:brg@dgate.org[brg@dgate.org]
+* Brian R. Haug mailto:haug@conterra.com[haug@conterra.com]
+* Brian Skrab mailto:brian@quynh-and-brian.org[brian@quynh-and-brian.org]
+* Brian Tao mailto:taob@risc.org[taob@risc.org]
+* Brion Moss mailto:brion@queeg.com[brion@queeg.com]
+* Bruce Albrecht mailto:bruce@zuhause.mn.org[bruce@zuhause.mn.org]
+* Bruce Gingery mailto:bgingery@gtcs.com[bgingery@gtcs.com]
+* Bruce J. Keeler mailto:loodvrij@gridpoint.com[loodvrij@gridpoint.com]
+* Bruce Murphy mailto:packrat@iinet.net.au[packrat@iinet.net.au]
+* Bruce Walter mailto:walter@fortean.com[walter@fortean.com]
+* Bruno Schwander mailto:bruno@tinkerbox.org[bruno@tinkerbox.org]
+* Byung-Hee HWANG mailto:bh@izb.knu.ac.kr[bh@izb.knu.ac.kr]
+* Camson Huynh mailto:chuynh@biolateral.com.au[chuynh@biolateral.com.au]
+* Carey Jones mailto:mcj@acquiesce.org[mcj@acquiesce.org]
+* Carl Fongheiser mailto:kf0yn@mchsi.com[kf0yn@mchsi.com]
+* Carl Makin mailto:carl@stagecraft.cx[carl@stagecraft.cx]
+* Carl Mascott mailto:cmascott@world.std.com[cmascott@world.std.com]
+* Carl Schmidt mailto:carl@perlpimp.codersluts.net[carl@perlpimp.codersluts.net]
+* Carlos A. M. dos Santos mailto:unixmania@gmail.com[unixmania@gmail.com]
+* Carlos Eduardo G. Carvalho mailto:cartola@openit.com.br[cartola@openit.com.br]
+* Carsten Larsen mailto:cs@innolan.dk[cs@innolan.dk]
+* Casper mailto:casper@acc.am[casper@acc.am]
+* Castor Fu mailto:castor@geocast.com[castor@geocast.com]
+* Cédric Lamalle mailto:cedric@cedric.trix.net[cedric@cedric.trix.net]
+* Cezary Morga mailto:cm@therek.net[cm@therek.net]
+* Chad Castleberry mailto:crcastle@ius.edu[crcastle@ius.edu]
+* Chad Jacob Milios mailto:milios@ccsys.com[milios@ccsys.com]
+* Chain Lee mailto:chain@110.net[chain@110.net]
+* Charles Hannum mailto:mycroft@ai.mit.edu[mycroft@ai.mit.edu]
+* Charles Henrich mailto:henrich@msu.edu[henrich@msu.edu]
+* Charles Mott mailto:cmott@scientech.com[cmott@scientech.com]
+* Charles Owens mailto:owensc@enc.edu[owensc@enc.edu]
+* Charles Swiger mailto:chuck@pkix.net[chuck@pkix.net]
+* Cheng-Tao Lin mailto:b89605222@ntu.edu.tw[b89605222@ntu.edu.tw]
+* ChenGuang LI mailto:horus.li@gmail.com[horus.li@gmail.com]
+* Chess Griffin mailto:chess@chessgriffin.com[chess@chessgriffin.com]
+* Chet Ramey mailto:chet@odin.INS.CWRU.Edu[chet@odin.INS.CWRU.Edu]
+* Chi-Feng QU mailto:chifeng@gmail.com[chifeng@gmail.com]
+* Chia-Hsing Yu mailto:davidyu@ucsd.edu[davidyu@ucsd.edu]
+* Chia-liang Kao mailto:clkao@CirX.ORG[clkao@CirX.ORG]
+* Chiang Cheng-Hsiung mailto:elvis@sslab.cs.ccu.edu.tw[elvis@sslab.cs.ccu.edu.tw]
+* Chie Taguchi mailto:taguchi.ch@gmail.com[taguchi.ch@gmail.com]
+* Chiharu Shibata mailto:chi@bd.mbn.or.jp[chi@bd.mbn.or.jp]
+* Chip Norkus
+* Choe, Cheng-Dae mailto:whitekid@netian.com[whitekid@netian.com]
+* Chris Burkert mailto:chris@chrisburkert.de[chris@chrisburkert.de]
+* Chris Csanady mailto:cc@tarsier.ca.sandia.gov[cc@tarsier.ca.sandia.gov]
+* Chris Dabrowski mailto:chris@vader.org[chris@vader.org]
+* Chris Dillon mailto:cdillon@wolves.k12.mo.us[cdillon@wolves.k12.mo.us]
+* Chris Hutchinson mailto:portmaster@BSDforge.com[portmaster@BSDforge.com]
+* Chris Howells mailto:howells@kde.org[howells@kde.org]
+* Chris Jones mailto:chris.jones@ualberta.ca[chris.jones@ualberta.ca]
+* Chris Knight mailto:chris@e-easy.com.au[chris@e-easy.com.au]
+* Chris Larsen mailto:darth@vader.dk[darth@vader.dk]
+* Chris Laverdure mailto:dashevil@gmail.com[dashevil@gmail.com]
+* Chris Pepper mailto:pepper@mail.rockefeller.edu[pepper@mail.rockefeller.edu]
+* Chris Pressey mailto:chris_pressey@yahoo.ca[chris_pressey@yahoo.ca]
+* Chris Shenton mailto:cshenton@angst.it.hq.nasa.gov[cshenton@angst.it.hq.nasa.gov]
+* Chris Stenton mailto:jacs@gnome.co.uk[jacs@gnome.co.uk]
+* Chris Torek mailto:torek@ee.lbl.gov[torek@ee.lbl.gov]
+* Christian Geier mailto:geier@lostpackets.de[geier@lostpackets.de]
+* Christian Gusenbauer mailto:c47g@gmx.at[c47g@gmx.at]
+* Christian Haury mailto:Christian.Haury@sagem.fr[Christian.Haury@sagem.fr]
+* Christian Heckendorf mailto:heckend@bu.edu[heckend@bu.edu]
+* Christian Lackas mailto:delta@lackas.net[delta@lackas.net]
+* Christian Laursen mailto:xi@borderworlds.dk[xi@borderworlds.dk]
+* Christian Schade mailto:christian.schade@interface-projects.de[christian.schade@interface-projects.de]
+* Christian Ullrich mailto:chris@chrullrich.net[chris@chrullrich.net]
+* Christian Zander mailto:zander@minion.de[zander@minion.de]
+* {kuku}
+* Christoph Robitschko mailto:chmr@edvz.tu-graz.ac.at[chmr@edvz.tu-graz.ac.at]
+* Christoph Weber-Fahr mailto:wefa@callcenter.systemhaus.net[wefa@callcenter.systemhaus.net]
+* Christophe Juniet mailto:cjuniet@entreview.com[cjuniet@entreview.com]
+* Christopher Boumenot mailto:boumenot@gmail.com[boumenot@gmail.com]
+* Christopher G. Demetriou mailto:cgd@postgres.berkeley.edu[cgd@postgres.berkeley.edu]
+* Christopher Hall mailto:hsw@bitmark.com[hsw@bitmark.com]
+* Christopher Illies mailto:christopher.illies@ki.se[christopher.illies@ki.se]
+* Christopher J. Ruwe mailto:cjr@cruwe.de[cjr@cruwe.de]
+* Christopher K. Davis mailto:ckd-freebsd@ckdhr.com[ckd-freebsd@ckdhr.com]
+* Christopher Key mailto:cjk32@cam.ac.uk[cjk32@cam.ac.uk]
+* Christopher Knaust mailto:jigboe@gmx.de[jigboe@gmx.de]
+* Christopher N. Harrell mailto:cnh@ivmg.net[cnh@ivmg.net]
+* Christopher Nehren mailto:apeiron@comcast.net[apeiron@comcast.net]
+* Christopher Preston mailto:rbg@gayteenresource.org[rbg@gayteenresource.org]
+* Christopher T. Johnson mailto:cjohnson@neunacht.netgsi.com[cjohnson@neunacht.netgsi.com]
+* Christopher Vance mailto:vance@aurema.com[vance@aurema.com]
+* Chrisy Luke mailto:chrisy@flix.net[chrisy@flix.net]
+* Chuck Hein mailto:chein@cisco.com[chein@cisco.com]
+* Clayton Eduardo dos Santos mailto:claytones@gmail.com[claytones@gmail.com]
+* Clayton Rollins mailto:crollins666@hotmail.com[crollins666@hotmail.com]
+* Clement MOULIN mailto:moeti-freebsd@ouestil.com[moeti-freebsd@ouestil.com]
+* Cliff Rowley mailto:dozprompt@onsea.com[dozprompt@onsea.com]
+* clutton mailto:clutton@zoho.com[clutton@zoho.com]
+* Clive Crous mailto:clive@darkarts.co.za[clive@darkarts.co.za]
+* Colin Booth mailto:colin@heliocat.net[colin@heliocat.net]
+* Colman Reilly mailto:careilly@tcd.ie[careilly@tcd.ie]
+* Conor McDermottroe mailto:ports@mcdermottroe.com[ports@mcdermottroe.com]
+* Conrad Sabatier mailto:conrads@cox.net[conrads@cox.net]
+* Constantin S. Svintsoff mailto:kostik@iclub.nsu.ru[kostik@iclub.nsu.ru]
+* Coranth Gryphon mailto:gryphon@healer.com[gryphon@healer.com]
+* Corey Smith mailto:corsmith@gmail.com[corsmith@gmail.com]
+* Cornelis van der Laan mailto:nils@guru.ims.uni-stuttgart.de[nils@guru.ims.uni-stuttgart.de]
+* Cosmin Stroe mailto:cstroe1@uic.edu[cstroe1@uic.edu]
+* Cove Schneider mailto:cove@brazil.nbn.com[cove@brazil.nbn.com]
+* Craig Boston mailto:craig@yekse.gank.org[craig@yekse.gank.org]
+* Craig Butler mailto:craig001@lerwick.hopto.org[craig001@lerwick.hopto.org]
+* Craig Loomis
+* Craig Metz mailto:cmetz@inner.net[cmetz@inner.net]
+* Craig Spannring mailto:cts@internetcds.com[cts@internetcds.com]
+* Craig Struble mailto:cstruble@vt.edu[cstruble@vt.edu]
+* Cristian Ferretti mailto:cfs@riemann.mat.puc.cl[cfs@riemann.mat.puc.cl]
+* Cristiano Rolim Pereira mailto:cristianorolim@hotmail.com[cristianorolim@hotmail.com]
+* Curt Mayer mailto:curt@toad.com[curt@toad.com]
+* Cyril Guibourg mailto:aragorn+ports@teaser.fr[aragorn+ports@teaser.fr]
+* Cyrille Lefevre mailto:clefevre@citeweb.net[clefevre@citeweb.net]
+* Cyrus Rahman mailto:cr@jcmax.com[cr@jcmax.com]
+* Daan Vreeken mailto:Danovitsch@Vitsch.net[Danovitsch@Vitsch.net]
+* Dai Ishijima mailto:ishijima@tri.pref.osaka.jp[ishijima@tri.pref.osaka.jp]
+* Daisuke Aoyama mailto:aoyama@peach.ne.jp[aoyama@peach.ne.jp]
+* Daisuke Watanabe mailto:NU7D-WTNB@asahi-net.or.jp[NU7D-WTNB@asahi-net.or.jp]
+* Damian Gerow mailto:dgerow@afflictions.org[dgerow@afflictions.org]
+* Damian Hamill mailto:damian@cablenet.net[damian@cablenet.net]
+* Damien Tougas mailto:damien@tougas.net[damien@tougas.net]
+* Dan Angelescu mailto:mrhsaacdoh@yahoo.com[mrhsaacdoh@yahoo.com]
+* Dan Caescu mailto:daniel@freebsd.ro[daniel@freebsd.ro]
+* Dan Cross mailto:tenser@spitfire.ecsel.psu.edu[tenser@spitfire.ecsel.psu.edu]
+* Dan Lukes mailto:dan@obluda.cz[dan@obluda.cz]
+* Dan Nelson mailto:dnelson@allantgroup.com[dnelson@allantgroup.com]
+* Dan Papasian mailto:bugg@bugg.strangled.net[bugg@bugg.strangled.net]
+* Dan Pelleg mailto:dpelleg+unison@cs.cmu.edu[dpelleg+unison@cs.cmu.edu]
+* Dan Piponi mailto:wmtop@tanelorn.demon.co.uk[wmtop@tanelorn.demon.co.uk]
+* Dan Rench mailto:citric@cubicone.tmetic.com[citric@cubicone.tmetic.com]
+* Dan Smith mailto:dan@algenta.com[dan@algenta.com]
+* Dan Walters mailto:hannibal@cyberstation.net[hannibal@cyberstation.net]
+* Daniel Austin mailto:freebsd-ports@dan.me.uk[freebsd-ports@dan.me.uk]
+* Daniel B. Hemmerich mailto:dan@spot.org[dan@spot.org]
+* Daniel Blankensteiner mailto:db@TruNet.dk[db@TruNet.dk]
+* Daniel Bretoi mailto:daniel@netwalk.org[daniel@netwalk.org]
+* Daniel Bryan mailto:sisko@bsdmail.com[sisko@bsdmail.com]
+* Daniel Hagan mailto:dhagan@acm.vt.edu[dhagan@acm.vt.edu]
+* Daniel Levai mailto:leva@ecentrum.hu[leva@ecentrum.hu]
+* Daniel J. O'Connor mailto:darius@dons.net.au[darius@dons.net.au]
+* Daniel O'Connor mailto:doconnor@gsoft.com.au[doconnor@gsoft.com.au]
+* Daniel Poirot mailto:poirot@aio.jsc.nasa.gov[poirot@aio.jsc.nasa.gov]
+* Daniel Rock mailto:rock@cs.uni-sb.de[rock@cs.uni-sb.de]
+* Daniel Roethlisberger mailto:daniel@roe.ch[daniel@roe.ch]
+* Daniel Tihanyi mailto:daniel.tihanyi@tetragir.com[daniel.tihanyi@tetragir.com]
+* Daniel W. McRobb mailto:dwm@caimis.com[dwm@caimis.com]
+* Daniel W. Steinbrook mailto:dsteinbr@fas.harvard.edu[dsteinbr@fas.harvard.edu]
+* Daniel Wijnands mailto:daniel@itxl.nl[daniel@itxl.nl]
+* Daniel Ylitalo mailto:daniel@blodan.se[daniel@blodan.se]
+* Danny Braniss mailto:danny@cs.huji.ac.il[danny@cs.huji.ac.il]
+* Danny Egen
+* Danny Howard mailto:dannyman@toldme.com[dannyman@toldme.com]
+* Danny J. Zerkel mailto:dzerkel@phofarm.com[dzerkel@phofarm.com]
+* Danny Pansters mailto:danny@ricin.com[danny@ricin.com]
+* Dario Freni mailto:saturnero@gufi.org[saturnero@gufi.org]
+* Darren Pilgrim mailto:ports.maintainer@evilphi.com[ports.maintainer@evilphi.com]
+* Dave Adkins mailto:adkin003@tc.umn.edu[adkin003@tc.umn.edu]
+* Dave Andersen mailto:angio@aros.net[angio@aros.net]
+* Dave Blizzard mailto:dblizzar@sprynet.com[dblizzar@sprynet.com]
+* Dave Bodenstab mailto:imdave@synet.net[imdave@synet.net]
+* Dave Burgess mailto:burgess@hrd769.brooks.af.mil[burgess@hrd769.brooks.af.mil]
+* Dave Chapeskie mailto:dchapes@ddm.on.ca[dchapes@ddm.on.ca]
+* Dave Cornejo mailto:dave@dogwood.com[dave@dogwood.com]
+* Dave Edmondson mailto:davided@sco.com[davided@sco.com]
+* Dave Glowacki mailto:dglo@ssec.wisc.edu[dglo@ssec.wisc.edu]
+* Dave Green mailto:dg@fastmail.co.uk[dg@fastmail.co.uk]
+* Dave Marquardt mailto:marquard@austin.ibm.com[marquard@austin.ibm.com]
+* {tweten}
+* David A. Adkins mailto:adkin003@tc.umn.edu[adkin003@tc.umn.edu]
+* David A. Bader mailto:dbader@eece.unm.edu[dbader@eece.unm.edu]
+* David Borman mailto:dab@bsdi.com[dab@bsdi.com]
+* David Bremner mailto:bremner@unb.ca[bremner@unb.ca]
+* David Bushong mailto:david+ports@bushong.net[david+ports@bushong.net]
+* David Chaplin-Loebell mailto:direct@klatha.com[direct@klatha.com]
+* Davide D'Amico mailto:dave@gufi.org[dave@gufi.org]
+* David Dawes mailto:dawes@XFree86.org[dawes@XFree86.org]
+* David Demelier mailto:markand@malikania.fr[markand@malikania.fr]
+* David Filo
+* David G. Holm mailto:harbour@netfang.net[harbour@netfang.net]
+* David Gardner mailto:david@pinko.net[david@pinko.net]
+* David Gilbert mailto:dave@daveg.ca[dave@daveg.ca]
+* David H. Munro mailto:munro1@llnl.gov[munro1@llnl.gov]
+* David Holland mailto:dholland@eecs.harvard.edu[dholland@eecs.harvard.edu]
+* David Holloway mailto:daveh@gwythaint.tamis.com[daveh@gwythaint.tamis.com]
+* David Horwitt mailto:dhorwitt@ucsd.edu[dhorwitt@ucsd.edu]
+* David Hovemeyer mailto:daveho@infocom.com[daveho@infocom.com]
+* David Johnson mailto:david@usermode.org[david@usermode.org]
+* David Jones mailto:dej@qpoint.torfree.net[dej@qpoint.torfree.net]
+* David Julien mailto:david.julien@gmail.com[david.julien@gmail.com]
+* David K. Gerry mailto:David.K.Gerry@GMail.com[David.K.Gerry@GMail.com]
+* David Kalliecharan mailto:dave@dal.ca[dave@dal.ca]
+* David Kelly mailto:dkelly@tomcat1.tbe.com[dkelly@tomcat1.tbe.com]
+* David Kirchner mailto:dpk@dpk.net[dpk@dpk.net]
+* David Kulp mailto:dkulp@neomorphic.com[dkulp@neomorphic.com]
+* David L. Nugent mailto:davidn@blaze.net.au[davidn@blaze.net.au]
+* David Landgren mailto:david@landgren.net[david@landgren.net]
+* David Lay mailto:dsl@webize.com.au[dsl@webize.com.au]
+* David Le Brun mailto:david@trucs.org[david@trucs.org]
+* David Leonard mailto:d@scry.dstc.edu.au[d@scry.dstc.edu.au]
+* David Magda mailto:dmagda@magda.ca[dmagda@magda.ca]
+* David Muir Sharnoff mailto:muir@idiom.com[muir@idiom.com]
+* David O'Rourke mailto:dor.bsd@xm0.uk[dor.bsd@xm0.uk]
+* David Otto mailto:ottodavid@gmx.net[ottodavid@gmx.net]
+* David Quattlebaum mailto:drq@drqware.com[drq@drqware.com]
+* David Romano mailto:unobe@cpan.org[unobe@cpan.org]
+* David S. Miller mailto:davem@jenolan.rutgers.edu[davem@jenolan.rutgers.edu]
+* David Shane Holden mailto:dpejesh@yahoo.com[dpejesh@yahoo.com]
+* David Siebörger mailto:drs@rucus.ru.ac.za[drs@rucus.ru.ac.za]
+* David Sugar mailto:dyfet@gnu.org[dyfet@gnu.org]
+* David Syphers mailto:dsyphers@u.washington.edu[dsyphers@u.washington.edu]
+* David Sze mailto:dsze@alumni.uwaterloo.ca[dsze@alumni.uwaterloo.ca]
+* David Terry mailto:dterry@digifonica.com[dterry@digifonica.com]
+* David Vachulka mailto:arch_dvx@users.sourceforge.net[arch_dvx@users.sourceforge.net]
+* David Wolfskill mailto:david@catwhisker.org[david@catwhisker.org]
+* David Yeske mailto:dyeske@yahoo.com[dyeske@yahoo.com]
+* Dax Labrador mailto:semprix@bsdmail.org[semprix@bsdmail.org]
+* Dean Gaudet mailto:dgaudet@arctic.org[dgaudet@arctic.org]
+* Dean Hollister mailto:dean@odyssey.apana.org.au[dean@odyssey.apana.org.au]
+* Dean Huxley mailto:dean@fsa.ca[dean@fsa.ca]
+* Demetris Procopiou mailto:dem.procopiou@gmail.com[dem.procopiou@gmail.com]
+* Denis Barov mailto:dindin@dindin.ru[dindin@dindin.ru]
+* Denis Fortin
+* Denis Generalov mailto:gd@rambler-co.ru[gd@rambler-co.ru]
+* Denis Philippov mailto:for_spam@mezon.ru[for_spam@mezon.ru]
+* Denis E. Podolskiy mailto:bytestore@yandex.ru[bytestore@yandex.ru]
+* Denis Pokataev mailto:catone@cpan.org[catone@cpan.org]
+* Denis Shaposhnikov mailto:dsh@vlink.ru[dsh@vlink.ru]
+* Dennis Cabooter mailto:dennis@rootxs.org[dennis@rootxs.org]
+* Dennis Glatting mailto:dennis.glatting@software-munitions.com[dennis.glatting@software-munitions.com]
+* Dennis S. Davidoff mailto:null@cvs.1system.ru[null@cvs.1system.ru]
+* Denton Gentry mailto:denny1@home.com[denny1@home.com]
+* Derek E. Schrock mailto:dereks@lifeofadishwasher.com[dereks@lifeofadishwasher.com]
+* Derek Inksetter mailto:derek@saidev.com[derek@saidev.com]
+* Derik van Zuetphen mailto:dz@426.ch[dz@426.ch]
+* Dermot Tynan mailto:dtynan@kalopa.com[dtynan@kalopa.com]
+* Dhananjay Balan mailto:mail@dbalan.in[mail@dbalan.in]
+* Diego Depaoli mailto:trebestie@gmail.com[trebestie@gmail.com]
+* Dikshie mailto:dikshie@lapi.itb.ac.id[dikshie@lapi.itb.ac.id]
+* Dikshie mailto:dikshie@sfc.wide.ad.jp[dikshie@sfc.wide.ad.jp]
+* Dierk Sacher mailto:dierk@blaxxtarz.de[dierk@blaxxtarz.de]
+* Dirk Engling mailto:erdgeist@erdgeist.org[erdgeist@erdgeist.org]
+* Dirk Gouders mailto:gouders@et.bocholt.fh-gelsenkirchen.de[gouders@et.bocholt.fh-gelsenkirchen.de]
+* Dirk Jagdmann mailto:doj@cubic.org[doj@cubic.org]
+* Dirk Keunecke mailto:dk@panda.rhein-main.de[dk@panda.rhein-main.de]
+* Dirk Nehrling mailto:nerle@pdv.de[nerle@pdv.de]
+* Dirk-Willem van Gulik mailto:dirkx@webweaving.org[dirkx@webweaving.org]
+* Ditesh Shashikant Gathani mailto:ditesh@gathani.org[ditesh@gathani.org]
+* Dmitri Nikulin mailto:setagllib@optusnet.com.au[setagllib@optusnet.com.au]
+* Dmitriy Limonov mailto:earl1k@mail.ru[earl1k@mail.ru]
+* Dmitry A. Yanko mailto:fm@astral.ntu-kpi.kiev.ua[fm@astral.ntu-kpi.kiev.ua]
+* Dmitry Afanasiev mailto:KOT@MATPOCKuH.Ru[KOT@MATPOCKuH.Ru]
+* Dmitry Dyomin mailto:old@old.com.ua[old@old.com.ua]
+* Dmitry Karasik mailto:dmitry@karasik.eu.org[dmitry@karasik.eu.org]
+* Dmitry Kazarov mailto:d.y.kazarov@mail.ru[d.y.kazarov@mail.ru]
+* Dmitry Khrustalev mailto:dima@xyzzy.machaon.ru[dima@xyzzy.machaon.ru]
+* Dmitry Kohmanyuk mailto:dk@farm.org[dk@farm.org]
+* Dmitry Pryadko mailto:d.pryadko@rambler-co.ru[d.pryadko@rambler-co.ru]
+* Dmitry Semkin mailto:ds@tic-tac.ru[ds@tic-tac.ru]
+* Dmitry V. Sukhodoyev mailto:raven428@gmail.com[raven428@gmail.com]
+* Dmitry Wagin mailto:dmitry.wagin@ya.ru[dmitry.wagin@ya.ru]
+* Dmytro Rud mailto:unixoid@yahoo.com[unixoid@yahoo.com]
+* Dom Mitchell mailto:dom@myrddin.demon.co.uk[dom@myrddin.demon.co.uk]
+* Domas Mituzas mailto:midom@dammit.lt[midom@dammit.lt]
+* Dominic Marks mailto:dominic_marks@btinternet.com[dominic_marks@btinternet.com]
+* Dominic Mitchell mailto:dom@happygiraffe.net[dom@happygiraffe.net]
+* Dominik Brettnacher mailto:domi@saargate.de[domi@saargate.de]
+* Dominik Rothert mailto:dr@domix.de[dr@domix.de]
+* Dominique Goncalves mailto:dominique.goncalves@gmail.com[dominique.goncalves@gmail.com]
+* Don Croyle mailto:croyle@gelemna.org[croyle@gelemna.org]
+* Don Morrison mailto:dmorrisn@u.washington.edu[dmorrisn@u.washington.edu]
+* Don Owens mailto:don@regexguy.com[don@regexguy.com]
+* {whiteside}
+* Don Yuniskis mailto:dgy@rtd.com[dgy@rtd.com]
+* Donald Maddox mailto:dmaddox099@yahoo.com[dmaddox099@yahoo.com]
+* Donn Miller mailto:dmmiller@cvzoom.net[dmmiller@cvzoom.net]
+* Doug Harple mailto:dharple@nycap.rr.com[dharple@nycap.rr.com]
+* Doug Penner mailto:darwinsurvivor@gmail.com[darwinsurvivor@gmail.com]
+* Douglas A. Maske mailto:maske@rungepaper.com[maske@rungepaper.com]
+* Douglas Carmichael mailto:dcarmich@mcs.com[dcarmich@mcs.com]
+* Douglas Crosher mailto:dtc@scrooge.ee.swin.oz.au[dtc@scrooge.ee.swin.oz.au]
+* Douglas K. Rand mailto:rand@meridian-enviro.com[rand@meridian-enviro.com]
+* Douglas W. Thrift mailto:douglas@douglasthrift.net[douglas@douglasthrift.net]
+* Drew Derbyshire mailto:ahd@kew.com[ahd@kew.com]
+* Dries Michiels mailto:driesm.michiels@gmail.com[driesm.michiels@gmail.com]
+* Dustin Sallings mailto:dustin@spy.net[dustin@spy.net]
+* Dylan Carlson mailto:absinthe@retrovertigo.com[absinthe@retrovertigo.com]
+* Dylan Simon mailto:dylan@dylex.net[dylan@dylex.net]
+* ELISA Font Project
+* Eckart "Isegrim" Hofmann mailto:Isegrim@Wunder-Nett.org[Isegrim@Wunder-Nett.org]
+* Ed Gold mailto:vegold01@starbase.spd.louisville.edu[vegold01@starbase.spd.louisville.edu]
+* Ed Hudson mailto:elh@p5.spnet.com[elh@p5.spnet.com]
+* Ederson de Moura mailto:ederbs@ederbs.org[ederbs@ederbs.org]
+* Edgardo Garcia Hoeffler mailto:edybsd@yahoo.com.ar[edybsd@yahoo.com.ar]
+* Edmondas Girkantas mailto:eg@fbsd.lt[eg@fbsd.lt]
+* Eduard Martinescu mailto:martines@rochester.rr.com[martines@rochester.rr.com]
+* Edward Chuang mailto:edwardc@firebird.org.tw[edwardc@firebird.org.tw]
+* Edward Wang mailto:edward@edcom.com[edward@edcom.com]
+* Edwin Mons mailto:e@ik.nu[e@ik.nu]
+* Eero Hänninen mailto:fax@nohik.ee[fax@nohik.ee]
+* Ege Rekk mailto:aagero@aage.priv.no[aagero@aage.priv.no]
+* Eiji-usagi-MATSUmoto mailto:usagi@clave.gr.jp[usagi@clave.gr.jp]
+* Eijiro Shibusawa mailto:ej-sib@ice.uec.ac.jp[ej-sib@ice.uec.ac.jp]
+* Eike Bernhardt mailto:eike.bernhardt@gmx.de[eike.bernhardt@gmx.de]
+* Eintisy Chuang mailto:eintisy@gmail.com[eintisy@gmail.com]
+* Eliane Vidal mailto:macevidal@gmail.com[macevidal@gmail.com]
+* Elias Mandouvalos mailto:ocean@mail.gr[ocean@mail.gr]
+* Elisey Savateev mailto:b3k@mail.ru[b3k@mail.ru]
+* Elmar Bartel mailto:bartel@informatik.tu-muenchen.de[bartel@informatik.tu-muenchen.de]
+* Emily Boyd mailto:emily@emilyboyd.com[emily@emilyboyd.com]
+* Eoin Lawless mailto:eoin@maths.tcd.ie[eoin@maths.tcd.ie]
+* Eric A. Griff mailto:eric@talesfromthereal.com[eric@talesfromthereal.com]
+* Eric Anderson mailto:anderson@centtech.com[anderson@centtech.com]
+* Eric Blood mailto:eblood@cs.unr.edu[eblood@cs.unr.edu]
+* Eric Camachat mailto:eric@camachat.org[eric@camachat.org]
+* Eric Cronin mailto:ecronin@eecs.umich.edu[ecronin@eecs.umich.edu]
+* Eric D. Futch mailto:efutch@nyct.net[efutch@nyct.net]
+* Eric F. Crist mailto:ecrist@secure-computing.net[ecrist@secure-computing.net]
+* Eric Freeman mailto:freebsdports@chillibear.com[freebsdports@chillibear.com]
+* Eric J. Haug mailto:ejh@slustl.slu.edu[ejh@slustl.slu.edu]
+* Eric J. Schwertfeger mailto:eric@cybernut.com[eric@cybernut.com]
+* Eric Kjeldergaard mailto:kjelderg@gmail.com[kjelderg@gmail.com]
+* Eric L. Hernes mailto:erich@lodgenet.com[erich@lodgenet.com]
+* Eric Masson mailto:e-masson@kisoft-services.com[e-masson@kisoft-services.com]
+* Eric Ogren mailto:eogren@stanford.edu[eogren@stanford.edu]
+* Eric P. Scott mailto:eps@sirius.com[eps@sirius.com]
+* Eric Schnoebelen mailto:eric@cirr.com[eric@cirr.com]
+* Eric Shao-yu Cheng mailto:eric@fractal.csie.org[eric@fractal.csie.org]
+* Eric Sprinkle mailto:eric@ennovatenetworks.com[eric@ennovatenetworks.com]
+* Eric W. Bates mailto:ericx@vineyard.net[ericx@vineyard.net]
+* Eric Yu mailto:ericyu@mail2000.com.tw[ericyu@mail2000.com.tw]
+* Erich Stefan Boleyn mailto:erich@uruk.org[erich@uruk.org]
+* Erich Zigler mailto:erich@tacni.net[erich@tacni.net]
+* Erik E. Rantapaa mailto:rantapaa@math.umn.edu[rantapaa@math.umn.edu]
+* Erik Greenwald mailto:erik@smluc.org[erik@smluc.org]
+* Erik H. Bakke mailto:erikhb@bgnett.no[erikhb@bgnett.no]
+* Erik H. Moe mailto:ehm@cris.com[ehm@cris.com]
+* Erik L. Chen mailto:d9364104@mail.nchu.edu.tw[d9364104@mail.nchu.edu.tw]
+* Ernie Smallis mailto:esmallis@stbernard.com[esmallis@stbernard.com]
+* Ernst Winter (http://berklix.org/ewinter/[Deceased])
+* Espen Skoglund mailto:esk@ira.uka.de[esk@ira.uka.de]
+* Espen Tagestad mailto:espen@tagestad.no[espen@tagestad.no]
+* Eugene M. Kim mailto:astralblue@usa.net[astralblue@usa.net]
+* Eugene Ossintsev mailto:eugos@gmx.net[eugos@gmx.net]
+* Eugene Radchenko mailto:genie@qsar.chem.msu.su[genie@qsar.chem.msu.su]
+* Eugene Ray mailto:pal@paladin7.net[pal@paladin7.net]
+* Eugene Zheganin mailto:eugene@zhegan.in[eugene@zhegan.in]
+* Eugeney Ryzhyk mailto:rzheka@users.sourceforge.net[rzheka@users.sourceforge.net]
+* Eugeny Kuzakov mailto:CoreDumped@coredumped.null.ru[CoreDumped@coredumped.null.ru]
+* Evan Champion mailto:evanc@synapse.net[evanc@synapse.net]
+* Evan Sarmiento mailto:esarmiento@wayfair.com[esarmiento@wayfair.com]
+* Evgueni V. Gavrilov mailto:aquatique@rusunix.org[aquatique@rusunix.org]
+* Ewgenij Gawrilow mailto:gawrilow@math.tu-berlin.de[gawrilow@math.tu-berlin.de]
+* FUJIMOTO Kensaku mailto:fujimoto@oscar.elec.waseda.ac.jp[fujimoto@oscar.elec.waseda.ac.jp]
+* FURUSAWA Kazuhisa mailto:furusawa@com.cs.osakafu-u.ac.jp[furusawa@com.cs.osakafu-u.ac.jp]
+* Fabian Freyer mailto:fabian.freyer@physik.tu-berlin.de[fabian.freyer@physik.tu-berlin.de]
+* Fabian Keil mailto:fk@fabiankeil.de[fk@fabiankeil.de]
+* Fabian M. Borschel mailto:fmb@onibox.net[fmb@onibox.net]
+* Fabiano Sidler mailto:fabianosidler@swissonline.ch[fabianosidler@swissonline.ch]
+* Fabien Devaux mailto:fab@gcu.info[fab@gcu.info]
+* Fabio Tosques mailto:fabio.tosques@rz.hu-berlin.de[fabio.tosques@rz.hu-berlin.de]
+* Fabrice Aneche mailto:akh@nobugware.com[akh@nobugware.com]
+* Fangrui Song mailto:i@maskray.me[i@maskray.me]
+* Fanying Jen mailto:fanying@fynet.com[fanying@fynet.com]
+* Faried Nawaz mailto:fn@Hungry.COM[fn@Hungry.COM]
+* Felix Palmen mailto:felix@palmen-it.de[felix@palmen-it.de]
+* Fernan Aguero mailto:fernan@iib.unsam.edu.ar[fernan@iib.unsam.edu.ar]
+* Ferruccio Vitale mailto:vitale@cs.tin.it[vitale@cs.tin.it]
+* Filipe Rocha mailto:filiperocha@gmail.com[filiperocha@gmail.com]
+* Filippo Natali mailto:filippo@widestore.net[filippo@widestore.net]
+* Flemming Jacobsen mailto:fj@batmule.dk[fj@batmule.dk]
+* Florian Unglaub mailto:usenet04@rootofallevil.net[usenet04@rootofallevil.net]
+* Fong-Ching Liaw mailto:fong@juniper.net[fong@juniper.net]
+* Francis M J Hsieh mailto:mjshieh@life.nthu.edu.tw[mjshieh@life.nthu.edu.tw]
+* Francisco Cabrita mailto:include@npf.pt.freebsd.org[include@npf.pt.freebsd.org]
+* Francisco Gomez mailto:francisco@gomezmarin.com[francisco@gomezmarin.com]
+* Francisco Reyes mailto:fjrm@yahoo.com[fjrm@yahoo.com]
+* François Tamone mailto:tamone@eig.unige.ch[tamone@eig.unige.ch]
+* Frank Bartels mailto:knarf@camelot.de[knarf@camelot.de]
+* Frank Behrens mailto:frank@pinky.sax.de[frank@pinky.sax.de]
+* Frank Börner mailto:frank-freebsd@online.de[frank-freebsd@online.de]
+* Frank Chen Hsiung Chan mailto:frankch@waru.life.nthu.edu.tw[frankch@waru.life.nthu.edu.tw]
+* Frank Denis mailto:j@pureftpd.org[j@pureftpd.org]
+* Frank Gründer mailto:elwood@mc5sys.in-berlin.de[elwood@mc5sys.in-berlin.de]
+* Frank MacLachlan mailto:fpm@n2.net[fpm@n2.net]
+* Frank Mayhar mailto:frank@exit.com[frank@exit.com]
+* Frank Nobis mailto:fn@Radio-do.de[fn@Radio-do.de]
+* Frank Ruell mailto:stoerte@dreamwarrior.net[stoerte@dreamwarrior.net]
+* Frank Steinborn mailto:steinex@nognu.de[steinex@nognu.de]
+* Frank Volf mailto:volf@oasis.IAEhv.nl[volf@oasis.IAEhv.nl]
+* Frank Wall mailto:fw@moov.de[fw@moov.de]
+* Frank W. Josellis mailto:frank@dynamical-systems.org[frank@dynamical-systems.org]
+* Frank ten Wolde mailto:franky@pinewood.nl[franky@pinewood.nl]
+* Frank van der Linden mailto:frank@fwi.uva.nl[frank@fwi.uva.nl]
+* Franz Klammer mailto:klammer@webonaut.com[klammer@webonaut.com]
+* Fraser Tweedale mailto:frase@frase.id.au[frase@frase.id.au]
+* Fred Cawthorne mailto:fcawth@jjarray.umn.edu[fcawth@jjarray.umn.edu]
+* Fred Gilham mailto:gilham@csl.sri.com[gilham@csl.sri.com]
+* Fred Templin mailto:templin@erg.sri.com[templin@erg.sri.com]
+* Freddie Cash mailto:fcash@bigfoot.com[fcash@bigfoot.com]
+* Frederic Dubuy mailto:fdubuy@free.fr[fdubuy@free.fr]
+* Frédéric Praca mailto:frederic.praca@freebsd-fr.org[frederic.praca@freebsd-fr.org]
+* Frederick Earl Gray mailto:fgray@rice.edu[fgray@rice.edu]
+* Fredrik Lennmark mailto:fredrik@min-hemsida.net[fredrik@min-hemsida.net]
+* Fredrik Lindberg mailto:fli@shapeshifter.se[fli@shapeshifter.se]
+* Frerich Raabe mailto:frerich.raabe@gmx.de[frerich.raabe@gmx.de]
+* Fumihiko Kimura mailto:jfkimura@yahoo.co.jp[jfkimura@yahoo.co.jp]
+* Fuyuhiko Maruyama mailto:fuyuhik8@is.titech.ac.jp[fuyuhik8@is.titech.ac.jp]
+* {stanislav}
+* Gábor Kincses mailto:gabor@acm.org[gabor@acm.org]
+* Gábor Zahemszky mailto:zgabor@CoDe.hu[zgabor@CoDe.hu]
+* Gasol Wu mailto:gasol.wu@gmail.com[gasol.wu@gmail.com]
+* Gabriel Dutra mailto:0xdutra@gmail.com[0xdutra@gmail.com]
+* Gabriel Rizzo mailto:gabriel96.gsr@gmail.com[gabriel96.gsr@gmail.com]
+* Gareth McCaughan mailto:gjm11@dpmms.cam.ac.uk[gjm11@dpmms.cam.ac.uk]
+* Garrett Rooney mailto:rooneg@electricjellyfish.net[rooneg@electricjellyfish.net]
+* Gary A. Browning mailto:gab10@griffcd.amdahl.com[gab10@griffcd.amdahl.com]
+* Gary Hayers mailto:gary@hayers.org[gary@hayers.org]
+* Gary Howland mailto:gary@hotlava.com[gary@hotlava.com]
+* Gary J. mailto:garyj@rks32.pcs.dec.com[garyj@rks32.pcs.dec.com]
+* Gary Kline mailto:kline@thought.org[kline@thought.org]
+* Gaspar Chilingarov mailto:nightmar@lemming.acc.am[nightmar@lemming.acc.am]
+* Gautam Mani mailto:execve@gmail.com[execve@gmail.com]
+* Gavin McDonald mailto:gavin@16degrees.com.au[gavin@16degrees.com.au]
+* Gavin Mu mailto:gavin@FreeBSDChina.org[gavin@FreeBSDChina.org]
+* Gea-Suan Lin mailto:gslin@gslin.org[gslin@gslin.org]
+* Geoff Glasson mailto:g_glasson@jimali.dyndns.org[g_glasson@jimali.dyndns.org]
+* Geoff Rehmet mailto:csgr@alpha.ru.ac.za[csgr@alpha.ru.ac.za]
+* Geoffrey Mainland mailto:mainland@apeiron.net[mainland@apeiron.net]
+* Geoffroy Rivat mailto:grivat@sicfa.net[grivat@sicfa.net]
+* Georg Graf mailto:georg@graf.priv.at[georg@graf.priv.at]
+* Georg Wagner mailto:georg.wagner@ubs.com[georg.wagner@ubs.com]
+* George Hartzell mailto:hartzell@kestrel.alerce.com[hartzell@kestrel.alerce.com]
+* George Liaskos mailto:geo.liaskos@gmail.com[geo.liaskos@gmail.com]
+* Gerasimos Dimitriadis mailto:gedimitr@auth.gr[gedimitr@auth.gr]
+* Geraud Continsouzas mailto:geraud@gcu.info[geraud@gcu.info]
+* Gerhard Gonter mailto:g.gonter@ieee.org[g.gonter@ieee.org]
+* Gerrit Beine mailto:tux@pinguru.net[tux@pinguru.net]
+* Giacomo Mariani mailto:giacomomariani@yahoo.it[giacomomariani@yahoo.it]
+* Gianlorenzo Masini mailto:masini@uniroma3.it[masini@uniroma3.it]
+* Gianmarco Giovannelli mailto:gmarco@giovannelli.it[gmarco@giovannelli.it]
+* Gil Kloepfer Jr. mailto:gil@limbic.ssdl.com[gil@limbic.ssdl.com]
+* Gilad Rom mailto:rom_glsa@ein-hashofet.co.il[rom_glsa@ein-hashofet.co.il]
+* Gilbert Morgan mailto:gmm@tutanota.com[gmm@tutanota.com]
+* Giles Lean mailto:giles@nemeton.com.au[giles@nemeton.com.au]
+* Ginga Kawaguti mailto:ginga@amalthea.phys.s.u-tokyo.ac.jp[ginga@amalthea.phys.s.u-tokyo.ac.jp]
+* Gleb Sushko mailto:neuroworker@gmail.com[neuroworker@gmail.com]
+* Glen Foster mailto:gfoster@gfoster.com[gfoster@gfoster.com]
+* Giel van Schijndel mailto:me@mortis.eu[me@mortis.eu]
+* Glenn Johnson mailto:gljohns@bellsouth.net[gljohns@bellsouth.net]
+* Godmar Back mailto:gback@facility.cs.utah.edu[gback@facility.cs.utah.edu]
+* Goran Hammarback mailto:goran@astro.uu.se[goran@astro.uu.se]
+* Goran Mekić mailto:meka@tilda.center[meka@tilda.center]
+* Gord Matzigkeit mailto:gord@enci.ucalgary.ca[gord@enci.ucalgary.ca]
+* Gordon Greeff mailto:gvg@uunet.co.za[gvg@uunet.co.za]
+* Graham Wheeler mailto:gram@cdsec.com[gram@cdsec.com]
+* Greg A. Woods mailto:woods@zeus.leitch.com[woods@zeus.leitch.com]
+* Greg Albrecht mailto:gregoryba@gmail.com[gregoryba@gmail.com]
+* Greg Ansley mailto:gja@ansley.com[gja@ansley.com]
+* Greg Becker mailto:greg@codeconcepts.com[greg@codeconcepts.com]
+* Greg Fitzgerald mailto:gregf@hugops.pw[gregf@hugops.pw]
+* Greg J. mailto:xcas@cox.net[xcas@cox.net]
+* Greg Kennedy mailto:kennedy.greg@gmail.com[kennedy.greg@gmail.com]
+* Greg Robinson mailto:greg@rosevale.com.au[greg@rosevale.com.au]
+* Greg Troxel mailto:gdt@ir.bbn.com[gdt@ir.bbn.com]
+* Greg Ungerer mailto:gerg@stallion.oz.au[gerg@stallion.oz.au]
+* Gregory Bond mailto:gnb@itga.com.au[gnb@itga.com.au]
+* Gregory D. Moncreaff mailto:moncrg@bt340707.res.ray.com[moncrg@bt340707.res.ray.com]
+* Grün Christian-Rolf mailto:kiki@bsdro.org[kiki@bsdro.org]
+* Guillaume Paquet mailto:amyfoub@videotron.ca[amyfoub@videotron.ca]
+* Gurkan Sengun mailto:grknsngn@gmail.com[grknsngn@gmail.com]
+* Gustau Pérez mailto:gustau.perez@gmail.com[gustau.perez@gmail.com]
+* Gustavo Fukao mailto:gustavofukao@gmail.com[gustavofukao@gmail.com]
+* Guy Brand mailto:gb@isis.u-strasbg.fr[gb@isis.u-strasbg.fr]
+* Guy Coleman mailto:gtchask@mm.st[gtchask@mm.st]
+* Guy Harris mailto:guy@netapp.com[guy@netapp.com]
+* Guy Poizat mailto:guy@device.dyndns.org[guy@device.dyndns.org]
+* Guy Tabrar mailto:guy.tabrar@me.com[guy.tabrar@me.com]
+* H. Wade Minter mailto:minter@lunenburg.org[minter@lunenburg.org]
+* HAMADA Naoki mailto:hamada@astec.co.jp[hamada@astec.co.jp]
+* HATANOU Tomomi mailto:hatanou@infolab.ne.jp[hatanou@infolab.ne.jp]
+* HIYAMA Takeshi mailto:gibbon@cocoa.freemail.ne.jp[gibbon@cocoa.freemail.ne.jp]
+* HONDA Yasuhiro mailto:honda@kashio.info.mie-u.ac.jp[honda@kashio.info.mie-u.ac.jp]
+* HOSOBUCHI Noriyuki mailto:hoso@buchi.tama.or.jp[hoso@buchi.tama.or.jp]
+* HOTARU-YA mailto:hotaru@tail.net[hotaru@tail.net]
+* Haesu Jeon mailto:haesu@towardex.com[haesu@towardex.com]
+* Hakisho Nukama mailto:nukama@gmail.com[nukama@gmail.com]
+* Hammurabi Mendes mailto:hmendes_br@yahoo.com[hmendes_br@yahoo.com]
+* Hannes Frederic Sowa mailto:hannes@stressinduktion.org[hannes@stressinduktion.org]
+* Hannu Savolainen mailto:hannu@voxware.pp.fi[hannu@voxware.pp.fi]
+* Hans Huebner mailto:hans@artcom.de[hans@artcom.de]
+* Hans Petter Bieker mailto:zerium@webindex.no[zerium@webindex.no]
+* Hans Petter Selasky mailto:hselasky@c2i.net[hselasky@c2i.net]
+* Hans Zuidam mailto:hans@brandinnovators.com[hans@brandinnovators.com]
+* Hans-Christian Ebke mailto:hans-christian_ebke@gmx.de[hans-christian_ebke@gmx.de]
+* Hansjoerg Pehofer mailto:hansjoerg.pehofer@uibk.ac.at[hansjoerg.pehofer@uibk.ac.at]
+* Harald Schmalzbauer mailto:h.schmalzbauer@omnisec.de[h.schmalzbauer@omnisec.de]
+* Harald Wille mailto:harald.wille@students.jku.at[harald.wille@students.jku.at]
+* Hardy Schumacher mailto:hardy.schumacher@gmx.de[hardy.schumacher@gmx.de]
+* Harlan Stenn mailto:Harlan.Stenn@pfcs.com[Harlan.Stenn@pfcs.com]
+* Harold Barker mailto:hbarker@dsms.com[hbarker@dsms.com]
+* Harry Coin mailto:harrycoin@qconline.com[harrycoin@qconline.com]
+* Harry Newton mailto:harry_newton@telinco.co.uk[harry_newton@telinco.co.uk]
+* Havard Eidnes mailto:Havard.Eidnes@runit.sintef.no[Havard.Eidnes@runit.sintef.no]
+* Heath Nielson mailto:heath@cs.byu.edu[heath@cs.byu.edu]
+* Heikki Suonsivu mailto:hsu@cs.hut.fi[hsu@cs.hut.fi]
+* Heiko W. Rupp
+* Heiner Eichmann mailto:h.eichmann@gmx.de[h.eichmann@gmx.de]
+* Heiner Strauss mailto:heiner@bilch.com[heiner@bilch.com]
+* Helko Glathe mailto:glathe.helko@googlemail.com[glathe.helko@googlemail.com]
+* Helmut F. Wirth mailto:hfwirth@ping.at[hfwirth@ping.at]
+* Hendrik Scholz mailto:hendrik@scholz.net[hendrik@scholz.net]
+* Henning Matyschok mailto:henning.matyschok@outlook.com[henning.matyschok@outlook.com]
+* Henri Michelon mailto:michelon@e-cml.org[michelon@e-cml.org]
+* Henrik Brautaset Aronsen mailto:freebsd-ports@henrik.synth.no[freebsd-ports@henrik.synth.no]
+* Henrik Friedrichsen mailto:hrkfrd@googlemail.com[hrkfrd@googlemail.com]
+* Henrik Holst mailto:henrik.holst@millistream.com[henrik.holst@millistream.com]
+* Henrik Motakef mailto:henrik.motakef@web.de[henrik.motakef@web.de]
+* Henrik Nymann Jensen mailto:henriknj@0xmilk.org[henriknj@0xmilk.org]
+* Henrik Vestergaard Draboel mailto:hvd@terry.ping.dk[hvd@terry.ping.dk]
+* Henry Hu mailto:henry.hu.sh@gmail.com[henry.hu.sh@gmail.com]
+* Henry Whincup mailto:henry@techiebod.com[henry@techiebod.com]
+* Herb Peyerl mailto:hpeyerl@NetBSD.org[hpeyerl@NetBSD.org]
+* Herbert J. Skuhra mailto:herbert.skuhra@gmx.at[herbert.skuhra@gmx.at]
+* Hernan Di Pietro mailto:hernan.di.pietro@gmail.com[hernan.di.pietro@gmail.com]
+* Hideaki Machida mailto:hido@coreblack.com[hido@coreblack.com]
+* Hideaki Ohmon mailto:ohmon@tom.sfc.keio.ac.jp[ohmon@tom.sfc.keio.ac.jp]
+* Hidekazu Kuroki mailto:hidekazu@cs.titech.ac.jp[hidekazu@cs.titech.ac.jp]
+* Hideki Yamamoto mailto:hyama@acm.org[hyama@acm.org]
+* Hideyuki Suzuki mailto:hideyuki@sat.t.u-tokyo.ac.jp[hideyuki@sat.t.u-tokyo.ac.jp]
+* Hirayama Issei mailto:iss@mail.wbs.ne.jp[iss@mail.wbs.ne.jp]
+* Hiroaki Sakai mailto:sakai@miya.ee.kagu.sut.ac.jp[sakai@miya.ee.kagu.sut.ac.jp]
+* Hiroharu Tamaru mailto:tamaru@ap.t.u-tokyo.ac.jp[tamaru@ap.t.u-tokyo.ac.jp]
+* Hirohisa Yamaguchi mailto:umq@ueo.co.jp[umq@ueo.co.jp]
+* Hironori Ikura mailto:hikura@kaisei.org[hikura@kaisei.org]
+* Hiroshi Nishikawa mailto:nis@pluto.dti.ne.jp[nis@pluto.dti.ne.jp]
+* Hiroto Kagotani mailto:hiroto.kagotani@gmail.com[hiroto.kagotani@gmail.com]
+* Hiroya Tsubakimoto
+* Holger Lamm mailto:holger@eit.uni-kl.de[holger@eit.uni-kl.de]
+* Holger Veit mailto:Holger.Veit@gmd.de[Holger.Veit@gmd.de]
+* Holm Tiffe mailto:holm@geophysik.tu-freiberg.de[holm@geophysik.tu-freiberg.de]
+* Horance Chou mailto:horance@freedom.ie.cycu.edu.tw[horance@freedom.ie.cycu.edu.tw]
+* Horia Racoviceanu mailto:horia@racoviceanu.com[horia@racoviceanu.com]
+* Horihiro Kumagai mailto:kuma@jp.FreeBSD.org[kuma@jp.FreeBSD.org]
+* Hr.Ladavac mailto:lada@ws2301.gud.siemens.co.at[lada@ws2301.gud.siemens.co.at]
+* Hsin-Hsiung Chang mailto:sexbear@tmu.edu.tw[sexbear@tmu.edu.tw]
+* Hubert Feyrer mailto:hubertf@NetBSD.ORG[hubertf@NetBSD.ORG]
+* Hubert Tournier mailto:hubert@frbsd.org[hubert@frbsd.org]
+* Hugh Mahon mailto:h_mahon@fc.hp.com[h_mahon@fc.hp.com]
+* Hugo Leisink mailto:hugo@leisink.net[hugo@leisink.net]
+* Hung-Chi Chu mailto:hcchu@r350.ee.ntu.edu.tw[hcchu@r350.ee.ntu.edu.tw]
+* Hung-Yi Chen mailto:gaod.chen@gmail.com[gaod.chen@gmail.com]
+* Hyogeol Lee mailto:hyogeollee@gmail.com[hyogeollee@gmail.com]
+* IMAI Takeshi mailto:take-i@ceres.dti.ne.jp[take-i@ceres.dti.ne.jp]
+* IMAMURA Tomoaki mailto:tomoak-i@is.aist-nara.ac.jp[tomoak-i@is.aist-nara.ac.jp]
+* IWASHITA Yoji mailto:shuna@pop16.odn.ne.jp[shuna@pop16.odn.ne.jp]
+* IWATSUKI Hiroyuki mailto:don@na.rim.or.jp[don@na.rim.or.jp]
+* Ian Holland mailto:ianh@tortuga.com.au[ianh@tortuga.com.au]
+* Ian Struble mailto:ian@broken.net[ian@broken.net]
+* Ian Vaudrey mailto:i.vaudrey@bigfoot.com[i.vaudrey@bigfoot.com]
+* Iblis Lin mailto:iblis@hs.ntnu.edu.tw[iblis@hs.ntnu.edu.tw]
+* Igor Artemiev mailto:ai@kliksys.ru[ai@kliksys.ru]
+* Igor Khasilev mailto:igor@jabber.paco.odessa.ua[igor@jabber.paco.odessa.ua]
+* Igor Leonenko mailto:bananaz@bk.ru[bananaz@bk.ru]
+* Igor Ostapenko mailto:igor.ostapenko@gmail.com[igor.ostapenko@gmail.com]
+* Igor Pokrovsky mailto:ip@doom.homeunix.org[ip@doom.homeunix.org]
+* Igor Roshchin mailto:str@giganda.komkon.org[str@giganda.komkon.org]
+* Igor Serikov mailto:bt@turtle.pangeatech.com[bt@turtle.pangeatech.com]
+* Igor Sviridov mailto:siac@ua.net[siac@ua.net]
+* Igor Vinokurov mailto:igor@zynaps.ru[igor@zynaps.ru]
+* Ikuo Nakagawa mailto:ikuo@isl.intec.co.jp[ikuo@isl.intec.co.jp]
+* Ildar Hizbulin mailto:hizel@vyborg.ru[hizel@vyborg.ru]
+* Ilia Chipitsine mailto:ilia@rediska.ru[ilia@rediska.ru]
+* Ilya Khamushkin mailto:ilya@space.rootshell.ru[ilya@space.rootshell.ru]
+* Ilya V. Komarov mailto:mur@lynx.ru[mur@lynx.ru]
+* Ismail Yenigul mailto:ismail@enderunix.org[ismail@enderunix.org]
+* Itsuro Saito mailto:saito@miv.t.u-tokyo.ac.jp[saito@miv.t.u-tokyo.ac.jp]
+* Ivan Klymenko mailto:fidaj@ukr.net[fidaj@ukr.net]
+* Ivan Rozhuk mailto:rozhuk.im@gmail.com[rozhuk.im@gmail.com]
+* Ivan Sharov mailto:ivan.sharov@iname.com[ivan.sharov@iname.com]
+* Ivan Sviridov mailto:sin@vimcom.net[sin@vimcom.net]
+* J Shoemaker mailto:shoemaker@softhome.net[shoemaker@softhome.net]
+* J. Bryant mailto:jbryant@argus.flash.net[jbryant@argus.flash.net]
+* J. David Lowe mailto:lowe@saturn5.com[lowe@saturn5.com]
+* J. Han mailto:hjh@photino.com[hjh@photino.com]
+* J. Hawk mailto:jhawk@MIT.EDU[jhawk@MIT.EDU]
+* J. Randolph mailto:snortsms@servangle.net[snortsms@servangle.net]
+* J.R. Oldroyd mailto:fbsd@opal.com[fbsd@opal.com]
+* J.T. Conklin mailto:jtc@cygnus.com[jtc@cygnus.com]
+* Jacek Pelka mailto:jacek@combit.com.pl[jacek@combit.com.pl]
+* Jack mailto:jack@zeus.xtalwind.net[jack@zeus.xtalwind.net]
+* Jackson Low mailto:xxjack12xx@gmail.com[xxjack12xx@gmail.com]
+* Jacob Atzen mailto:jatzen@gmail.com[jatzen@gmail.com]
+* Jacob Bohn Lorensen mailto:jacob@jblhome.ping.mk[jacob@jblhome.ping.mk]
+* Jacques Marneweck mailto:jacques@php.net[jacques@php.net]
+* Jagane D Sundar mailto:jagane@netcom.com[jagane@netcom.com]
+* Jake Hamby mailto:jehamby@anobject.com[jehamby@anobject.com]
+* Jake Smith mailto:jake@xz.cx[jake@xz.cx]
+* Jakub Klausa mailto:jacke@bofh.pl[jacke@bofh.pl]
+* James Bailie mailto:jimmy@mammothcheese.ca[jimmy@mammothcheese.ca]
+* James Buren mailto:ryu0@ymail.com[ryu0@ymail.com]
+* James Clark mailto:jjc@jclark.com[jjc@jclark.com]
+* James D. Stewart mailto:jds@c4systm.com[jds@c4systm.com]
+* James E Keenan mailto:jkeenan@cpan.org[jkeenan@cpan.org]
+* James Jegers mailto:jimj@miller.cs.uwm.edu[jimj@miller.cs.uwm.edu]
+* James McNaughton mailto:bitbucket63-it@yahoo.com[bitbucket63-it@yahoo.com]
+* James O'Gorman mailto:james@netinertia.co.uk[james@netinertia.co.uk]
+* James P. Howard, II mailto:jh@jameshoward.us[jh@jameshoward.us]
+* James Raftery mailto:james@now.ie[james@now.ie]
+* James Raynard mailto:fhackers@jraynard.demon.co.uk[fhackers@jraynard.demon.co.uk]
+* James T. Liu mailto:jtliu@phlebas.rockefeller.edu[jtliu@phlebas.rockefeller.edu]
+* James da Silva mailto:jds@cs.umd.edu[jds@cs.umd.edu]
+* James Wright mailto:james.wright@digital-chaos.com[james.wright@digital-chaos.com]
+* Jamie Heckford mailto:jamie@jamiesdomain.co.uk[jamie@jamiesdomain.co.uk]
+* Jamie Jones mailto:jamie@bishopston.net[jamie@bishopston.net]
+* Jan Conard mailto:charly@fachschaften.tu-muenchen.de[charly@fachschaften.tu-muenchen.de]
+* Jan Henrik Sylvester mailto:me@janh.de[me@janh.de]
+* Jan Jungnickel mailto:Jan@Jungnickel.com[Jan@Jungnickel.com]
+* {jkb}
+* Jan L. Peterson mailto:jlp@flipdog.com[jlp@flipdog.com]
+* Jan Rochel mailto:jan.rochel@epost.de[jan.rochel@epost.de]
+* Jan Siml mailto:jsi@jules.de[jsi@jules.de]
+* Jan Srzednicki mailto:w@wrzask.pl[w@wrzask.pl]
+* Jan Stocker mailto:jan.stocker@t-online.de[jan.stocker@t-online.de]
+* Jan-Peter Koopmann mailto:j.koopmann@seceidos.de[j.koopmann@seceidos.de]
+* Janaka Wickramasinghe mailto:janaka@opensource.lk[janaka@opensource.lk]
+* Janick Taillandier mailto:Janick.Taillandier@ratp.fr[Janick.Taillandier@ratp.fr]
+* Janky Jay mailto:ek@purplehat.org[ek@purplehat.org]
+* János Mohácsi mailto:janos.mohacsi@bsd.hu[janos.mohacsi@bsd.hu]
+* Janusz Kokot mailto:janek@gaja.ipan.lublin.pl[janek@gaja.ipan.lublin.pl]
+* Jarle Greipsland mailto:jarle@idt.unit.no[jarle@idt.unit.no]
+* Jason Burgess mailto:dev@fenux.net[dev@fenux.net]
+* Jason DiCioccio mailto:geniusj@ods.org[geniusj@ods.org]
+* Jason Garman mailto:init@risen.org[init@risen.org]
+* Jason Harris mailto:jharris@widomaker.com[jharris@widomaker.com]
+* Jason R. Mastaler mailto:jason-freebsd@mastaler.com[jason-freebsd@mastaler.com]
+* Jason Stone mailto:jason-fbsd-ports@shalott.net[jason-fbsd-ports@shalott.net]
+* Jason Thorpe mailto:thorpej@NetBSD.org[thorpej@NetBSD.org]
+* Jason Wright mailto:jason@OpenBSD.org[jason@OpenBSD.org]
+* Jason Young mailto:doogie@forbidden-donut.anet-stl.com[doogie@forbidden-donut.anet-stl.com]
+* Javad Kouhi mailto:javad.kouhi@gmail.com[javad.kouhi@gmail.com]
+* Javier Martin Rueda mailto:jmrueda@diatel.upm.es[jmrueda@diatel.upm.es]
+* Jay Fenlason mailto:hack@datacube.com[hack@datacube.com]
+* Jay Krell mailto:jay.krell@cornell.edu[jay.krell@cornell.edu]
+* Jaye Mathisen mailto:mrcpu@cdsnet.net[mrcpu@cdsnet.net]
+* Jaap Akkerhuis mailto:jaap@NLnetLabs.nl[jaap@NLnetLabs.nl]
+* Jean-Baptiste Quenot mailto:jb.quenot@caraldi.com[jb.quenot@caraldi.com]
+* Jean Benoit mailto:jean@unistra.fr[jean@unistra.fr]
+* Jean-Sebastien Roy mailto:js@jeannot.org[js@jeannot.org]
+* Jeff Bartig mailto:jeffb@doit.wisc.edu[jeffb@doit.wisc.edu]
+* Jeff Brown mailto:jabrown@caida.org[jabrown@caida.org]
+* Jeff Burchell mailto:toxic@doobie.com[toxic@doobie.com]
+* Jeff Forys mailto:jeff@forys.cranbury.nj.us[jeff@forys.cranbury.nj.us]
+* Jeff Kletsky mailto:Jeff@Wagsky.com[Jeff@Wagsky.com]
+* Jeff Palmer mailto:scorpio@drkshdw.org[scorpio@drkshdw.org]
+* Jeffrey Baitis mailto:jeff@baitis.net[jeff@baitis.net]
+* Jeffrey Evans mailto:evans@scnc.k12.mi.us[evans@scnc.k12.mi.us]
+* Jeffrey H. Johnson mailto:CPE1704TKS@bellsouth.net[CPE1704TKS@bellsouth.net]
+* Jeffrey Leung mailto:zenoss@experts-exchange.com[zenoss@experts-exchange.com]
+* Jeff Molofee mailto:nehe@cruzinternet.com[nehe@cruzinternet.com]
+* Jeffrey Wheat mailto:jeff@cetlink.net[jeff@cetlink.net]
+* Jens Grassel mailto:freebsd-ports@jan0sch.de[freebsd-ports@jan0sch.de]
+* Jens Holmqvist mailto:zparta@hispan.se[zparta@hispan.se]
+* Jens K. Loewe mailto:bsd@tuxproject.de[bsd@tuxproject.de]
+* Jens Rehsack mailto:rehsack@liwing.de[rehsack@liwing.de]
+* Jeremy Allison mailto:jallison@whistle.com[jallison@whistle.com]
+* Jeremy Baggs mailto:jbaggs2016@gmail.com[jbaggs2016@gmail.com]
+* Jeremy C. Reed mailto:reed@pugetsoundtechnology.com[reed@pugetsoundtechnology.com]
+* Jeremy Chatfield mailto:jdc@xinside.com[jdc@xinside.com]
+* Jeremy Karlson mailto:karlj000@unbc.ca[karlj000@unbc.ca]
+* Jeremy Prior
+* Jeremy Shaffner mailto:jeremy@external.org[jeremy@external.org]
+* Jeroen Schot mailto:schot@a-askwadraat.nl[schot@a-askwadraat.nl]
+* Jerry Eriksson mailto:jerry@freebsd.se[jerry@freebsd.se]
+* Jesper Dalberg mailto:jesper@jdn.dk[jesper@jdn.dk]
+* Jesper Noehr mailto:jesper@noehr.org[jesper@noehr.org]
+* Jesse Kempf mailto:jessekempf@gmail.com[jessekempf@gmail.com]
+* Jesse McConnell mailto:jesse@cylant.com[jesse@cylant.com]
+* Jesse Rosenstock mailto:jmr@ugcs.caltech.edu[jmr@ugcs.caltech.edu]
+* Jesse Smith mailto:jsmith@resonatingmedia.com[jsmith@resonatingmedia.com]
+* Jesse van den Kieboom mailto:troplosti@orcaweb.cjb.net[troplosti@orcaweb.cjb.net]
+* Jia-Wei Ye mailto:leafy7382@gmail.com[leafy7382@gmail.com]
+* Jian-Da Li mailto:jdli@csie.nctu.edu.tw[jdli@csie.nctu.edu.tw]
+* Jie Gao mailto:gaoj@cpsc.ucalgary.ca[gaoj@cpsc.ucalgary.ca]
+* {babb}
+* Jim Binkley mailto:jrb@cs.pdx.edu[jrb@cs.pdx.edu]
+* Jim Bloom mailto:bloom@acm.org[bloom@acm.org]
+* Jim Carroll mailto:jim@carroll.com[jim@carroll.com]
+* Jim Flowers mailto:jflowers@ezo.net[jflowers@ezo.net]
+* Jim Geovedi mailto:jim@corebsd.or.id[jim@corebsd.or.id]
+* Jim Leppek mailto:jleppek@harris.com[jleppek@harris.com]
+* Jim Lowe mailto:james@cs.uwm.edu[james@cs.uwm.edu]
+* Jim Mattson mailto:jmattson@sonic.net[jmattson@sonic.net]
+* Jim Mercer mailto:jim@komodo.reptiles.org[jim@komodo.reptiles.org]
+* Jim Ohlstein mailto:jim@ohlste.in[jim@ohlste.in]
+* Jim Pirzyk mailto:pirzyk@uiuc.edu[pirzyk@uiuc.edu]
+* Jim Riggs mailto:ports@christianserving.org[ports@christianserving.org]
+* Jim Shewmaker mailto:jim@bluenotch.com[jim@bluenotch.com]
+* Jim Sloan mailto:odinn@atlantabiker.net[odinn@atlantabiker.net]
+* Jim Stapleton mailto:sjss@var-dev.net[sjss@var-dev.net]
+* Jim Wilson mailto:wilson@moria.cygnus.com[wilson@moria.cygnus.com]
+* Jimbo Bahooli mailto:griffin@blackhole.iceworld.org[griffin@blackhole.iceworld.org]
+* Jin Guojun mailto:jin@george.lbl.gov[jin@george.lbl.gov]
+* Jin-Shan Tseng mailto:tjs@cdpa.nsysu.edu.tw[tjs@cdpa.nsysu.edu.tw]
+* Jin-Sih Lin mailto:linpct@gmail.com[linpct@gmail.com]
+* Jo Rhett mailto:jrhett@netconsonance.com[jrhett@netconsonance.com]
+* Joachim Kuebart mailto:kuebart@mathematik.uni-ulm.de[kuebart@mathematik.uni-ulm.de]
+* Joachim Strombergson mailto:Watchman@ludd.luth.se[Watchman@ludd.luth.se]
+* Joao Carlos Mendes Luis mailto:jonny@jonny.eng.br[jonny@jonny.eng.br]
+* Jochen Pohl mailto:jpo.drs@sni.de[jpo.drs@sni.de]
+* Joe Abley mailto:jabley@automagic.org[jabley@automagic.org]
+* Joe Barbish mailto:barbish@a1poweruser.com[barbish@a1poweruser.com]
+* Joe Halpin mailto:joe.halpin@attbi.com[joe.halpin@attbi.com]
+* Joe Holden mailto:joe@joeholden.co.uk[joe@joeholden.co.uk]
+* Joe Horn mailto:joehorn@gmail.com[joehorn@gmail.com]
+* Joe Jih-Shian Lu mailto:jslu@dns.ntu.edu.tw[jslu@dns.ntu.edu.tw]
+* Joe Kelsey mailto:joek@flyingcroc.net[joek@flyingcroc.net]
+* Joe Orthoefer mailto:j_orthoefer@tia.net[j_orthoefer@tia.net]
+* Joe Smith mailto:inwap@best.com[inwap@best.com]
+* Joe Traister mailto:traister@mojozone.org[traister@mojozone.org]
+* Joel Diaz mailto:joeldiaz@bellsouth.net[joeldiaz@bellsouth.net]
+* Joel Faedi mailto:Joel.Faedi@esial.u-nancy.fr[Joel.Faedi@esial.u-nancy.fr]
+* Joel Ray Holveck mailto:joelh@gnu.org[joelh@gnu.org]
+* Joel Sutton mailto:jsutton@bbcon.com.au[jsutton@bbcon.com.au]
+* Joerg Pulz mailto:Joerg.Pulz@frm2.tum.de[Joerg.Pulz@frm2.tum.de]
+* Joerg Schilling mailto:schilling@fokus.gmd.de[schilling@fokus.gmd.de]
+* Johan Granlund mailto:johan@granlund.nu[johan@granlund.nu]
+* Johan Larsson mailto:johan@moon.campus.luth.se[johan@moon.campus.luth.se]
+* Johan Strom mailto:johan@stromnet.org[johan@stromnet.org]
+* Johann Tonsing mailto:jtonsing@mikom.csir.co.za[jtonsing@mikom.csir.co.za]
+* Johannes 5 Joemann mailto:joemann@beefree.free.de[joemann@beefree.free.de]
+* Johannes Grødem mailto:johs@copyleft.no[johs@copyleft.no]
+* Johannes Helander
+* Johannes Stille
+* John Beckett mailto:jbeckett@southern.edu[jbeckett@southern.edu]
+* John Beukema mailto:jbeukema@hk.super.net[jbeukema@hk.super.net]
+* John Brezak
+* John Capo mailto:jc@irbs.com[jc@irbs.com]
+* John F. Woods mailto:jfw@jfwhome.funhouse.com[jfw@jfwhome.funhouse.com]
+* John Ferrel mailto:jdferrell3@yahoo.com[jdferrell3@yahoo.com]
+* John Goerzen mailto:jgoerzen@alexanderwohl.complete.org[jgoerzen@alexanderwohl.complete.org]
+* John Heidemann mailto:johnh@isi.edu[johnh@isi.edu]
+* John Hood mailto:cgull@owl.org[cgull@owl.org]
+* John Kohl
+* John Lind mailto:john@starfire.mn.org[john@starfire.mn.org]
+* John Mackin mailto:john@physiol.su.oz.au[john@physiol.su.oz.au]
+* John McAree mailto:john@mcaree.org[john@mcaree.org]
+* John MacFarlane mailto:jgm@berkeley.edu[jgm@berkeley.edu]
+* John Mehr mailto:jcm@visi.com[jcm@visi.com]
+* John Merryweather Cooper mailto:jmcoopr@webmail.bmi.net[jmcoopr@webmail.bmi.net]
+* John Nielsen mailto:john@jnielsen.net[john@jnielsen.net]
+* John Oxley mailto:john@yoafrica.com[john@yoafrica.com]
+* John P mailto:johnp@lodgenet.com[johnp@lodgenet.com]
+* John Perry mailto:perry@vishnu.alias.net[perry@vishnu.alias.net]
+* John Prather mailto:john.c.prather@gmail.com[john.c.prather@gmail.com]
+* John Preisler mailto:john@vapornet.com[john@vapornet.com]
+* John Reynolds mailto:johnjen@reynoldsnet.org[johnjen@reynoldsnet.org]
+* John Rochester mailto:jr@cs.mun.ca[jr@cs.mun.ca]
+* John Sadler mailto:john_sadler@alum.mit.edu[john_sadler@alum.mit.edu]
+* John Saunders mailto:john@pacer.nlc.net.au[john@pacer.nlc.net.au]
+* John Von Essen mailto:john@essenz.com[john@essenz.com]
+* John W. O'Brien mailto:john@saltant.com[john@saltant.com]
+* John Wehle mailto:john@feith.com[john@feith.com]
+* John Woods mailto:jfw@eddie.mit.edu[jfw@eddie.mit.edu]
+* Johny Mattsson mailto:lonewolf@flame.org[lonewolf@flame.org]
+* Jon Amundsen mailto:online@jamundsen.dyndns.org[online@jamundsen.dyndns.org]
+* Jon Morgan mailto:morgan@terminus.trailblazer.com[morgan@terminus.trailblazer.com]
+* Jon Nistor mailto:nistor@snickers.org[nistor@snickers.org]
+* Jon Passki mailto:cykyc@yahoo.com[cykyc@yahoo.com]
+* Jon Wilson mailto:jon@phuq.co.uk[jon@phuq.co.uk]
+* Jona Joachim mailto:walkingshadow@grummel.net[walkingshadow@grummel.net]
+* Jonas Ferreira mailto:jonas.h.ferreira@me.com[jonas.h.ferreira@me.com]
+* Jonathan Belson mailto:jon@witchspace.com[jon@witchspace.com]
+* Jonathan Bokovza mailto:Jonathan@afarsec.com[Jonathan@afarsec.com]
+* Jonathan Chen mailto:jonc@chen.org.nz[jonc@chen.org.nz]
+* Jonathan Drews mailto:j.e.drews@att.net[j.e.drews@att.net]
+* Jonathan H N Chin mailto:jc254@newton.cam.ac.uk[jc254@newton.cam.ac.uk]
+* Jonathan Hanna mailto:jhanna@shaw.ca[jhanna@shaw.ca]
+* Jonathan Lennox mailto:lennox@cs.columbia.edu[lennox@cs.columbia.edu]
+* Jonathan Liu mailto:Net147@hotmail.com[Net147@hotmail.com]
+* Jonathan McDowell mailto:noodles@earth.li[noodles@earth.li]
+* Jonathan Pennington mailto:john@coastalgeology.org[john@coastalgeology.org]
+* Jonathan Price mailto:freebsd@jonathanprice.org[freebsd@jonathanprice.org]
+* Jordan DeLong mailto:fracture@allusion.net[fracture@allusion.net]
+* Jordi Haarman mailto:jhaarman-keyword-tinyerpPort.fd583c@projects.synantics.net[jhaarman-keyword-tinyerpPort.fd583c@projects.synantics.net]
+* Jorge Goncalves mailto:j@bug.fe.up.pt[j@bug.fe.up.pt]
+* Jorge M. Goncalves mailto:ee96199@tom.fe.up.pt[ee96199@tom.fe.up.pt]
+* Joris Vandalon mailto:joris@vandalon.nl[joris@vandalon.nl]
+* Jos Backus mailto:jos@catnook.com[jos@catnook.com]
+* Jose Abelardo Martinez mailto:jamartinez@altern.org[jamartinez@altern.org]
+* Jose Liang mailto:jose@jose.idv.tw[jose@jose.idv.tw]
+* Jose Marques mailto:jose@nobody.org[jose@nobody.org]
+* Jose Rodriguez mailto:king@v2project.com[king@v2project.com]
+* José García Juanino mailto:jjuanino@gmail.com[jjuanino@gmail.com]
+* Josef Grosch mailto:jgrosch@superior.mooseriver.com[jgrosch@superior.mooseriver.com]
+* Joseph Haga mailto:tuximus@tcsn.net[tuximus@tcsn.net]
+* Joseph Scott mailto:joseph@randomnetworks.com[joseph@randomnetworks.com]
+* Joseph Stein mailto:joes@wstein.com[joes@wstein.com]
+* Josh Carroll mailto:josh.carroll@gmail.com[josh.carroll@gmail.com]
+* Josh Elsasser mailto:jre@vineyard.net[jre@vineyard.net]
+* Josh Gilliam mailto:josh@quick.net[josh@quick.net]
+* Josh Tiefenbach mailto:josh@ican.net[josh@ican.net]
+* Josh Tolbert mailto:hemi@puresimplicity.net[hemi@puresimplicity.net]
+* Joshua D. Abraham mailto:jabra@ccs.neu.edu[jabra@ccs.neu.edu]
+* Joshua Goodall mailto:joshua@roughtrade.net[joshua@roughtrade.net]
+* Jostein Trondal mailto:jostein.trondal@sikkerhet.no[jostein.trondal@sikkerhet.no]
+* Juan Salaverria mailto:rael@vectorstar.net[rael@vectorstar.net]
+* Juha Inkari mailto:inkari@cc.hut.fi[inkari@cc.hut.fi]
+* Juha Nygard mailto:juha.nygard1@netikka.fi[juha.nygard1@netikka.fi]
+* Juha Ylitalo mailto:juha.ylitalo@iki.fi[juha.ylitalo@iki.fi]
+* Jui-Nan Lin mailto:jnlin@csie.nctu.edu.tw[jnlin@csie.nctu.edu.tw]
+* Jukka A. Ukkonen mailto:jau@iki.fi[jau@iki.fi]
+* Julian Assange mailto:proff@suburbia.net[proff@suburbia.net]
+* Julian C. Dunn mailto:jdunn@aquezada.com[jdunn@aquezada.com]
+* Julian Coleman mailto:j.d.coleman@ncl.ac.uk[j.d.coleman@ncl.ac.uk]
+* {jhs}
+* Julian Jenkins mailto:kaveman@magna.com.au[kaveman@magna.com.au]
+* Julian Stecklina mailto:der_julian@web.de[der_julian@web.de]
+* Jun Mukai mailto:mukai@jmuk.org[mukai@jmuk.org]
+* Junichi Satoh mailto:junichi@jp.FreeBSD.org[junichi@jp.FreeBSD.org]
+* Junji NAKANISHI mailto:jun-g@daemonfreaks.com[jun-g@daemonfreaks.com]
+* Junji SAKAI mailto:sakai@jp.FreeBSD.org[sakai@jp.FreeBSD.org]
+* Junya WATANABE mailto:junya-w@remus.dti.ne.jp[junya-w@remus.dti.ne.jp]
+* Justas mailto:justas@mbank.lv[justas@mbank.lv]
+* Justin Stanford mailto:jus@security.za.net[jus@security.za.net]
+* Jyun-Yan You mailto:jyyou@cs.nctu.edu.tw[jyyou@cs.nctu.edu.tw]
+* Gergely CZUCZY mailto:gergely.czuczy@harmless.hu[gergely.czuczy@harmless.hu]
+* K.Higashino mailto:a00303@cc.hc.keio.ac.jp[a00303@cc.hc.keio.ac.jp]
+* KANOU Hiroki mailto:kanou@khdd.net[kanou@khdd.net]
+* KATO Tsuguru mailto:tkato@prontomail.ne.jp[tkato@prontomail.ne.jp]
+* KIMURA Shigekazu mailto:zau50357@lion.zero.ad.jp[zau50357@lion.zero.ad.jp]
+* KIMURA Yasuhiro mailto:yasu@utahime.org[yasu@utahime.org]
+* KUNISHIMA Takeo mailto:kunishi@c.oka-pu.ac.jp[kunishi@c.oka-pu.ac.jp]
+* Kai Vorma mailto:vode@snakemail.hut.fi[vode@snakemail.hut.fi]
+* Kai Wang mailto:kaiwang27@gmail.com[kaiwang27@gmail.com]
+* Kaleb S. Keithley mailto:kaleb@ics.com[kaleb@ics.com]
+* Kalle R. Møller mailto:freebsb_contrib@k-moeller.dk[freebsb_contrib@k-moeller.dk]
+* Kan Sasaki mailto:sasaki@fcc.ad.jp[sasaki@fcc.ad.jp]
+* Kaneda Hiloshi mailto:vanitas@ma3.seikyou.ne.jp[vanitas@ma3.seikyou.ne.jp]
+* Kang Liu mailto:liukang@bjut.edu.cn[liukang@bjut.edu.cn]
+* Kang-ming Liu mailto:gugod@gugod.org[gugod@gugod.org]
+* Kapil Chowksey mailto:kchowksey@hss.hns.com[kchowksey@hss.hns.com]
+* Karel Miklav mailto:karel@lovetemple.net[karel@lovetemple.net]
+* Karl Denninger mailto:karl@mcs.com[karl@mcs.com]
+* Karl Dietz mailto:Karl.Dietz@triplan.com[Karl.Dietz@triplan.com]
+* Karl Lehenbauer mailto:karl@NeoSoft.com[karl@NeoSoft.com]
+* Karsten W. Rohrbach mailto:karsten@rohrbach.de[karsten@rohrbach.de]
+* Katalin Konkoly mailto:katalin.konkoly@gmail.com[katalin.konkoly@gmail.com]
+* Katsura Matsumoto mailto:katsura@cc.osaka-kyoiku.ac.jp[katsura@cc.osaka-kyoiku.ac.jp]
+* Kawanobe Koh mailto:kawanobe@st.rim.or.jp[kawanobe@st.rim.or.jp]
+* Kay Abendroth mailto:kay.abendroth@raxion.net[kay.abendroth@raxion.net]
+* Kay Lehmann mailto:kay_lehmann@web.de[kay_lehmann@web.de]
+* Kazami mailto:kazami@angels.vg[kazami@angels.vg]
+* Kazuhito HONDA mailto:kazuhito@ph.noda.tus.ac.jp[kazuhito@ph.noda.tus.ac.jp]
+* Kees Jan Koster mailto:kjkoster@kjkoster.org[kjkoster@kjkoster.org]
+* Keith Bostic mailto:bostic@bostic.com[bostic@bostic.com]
+* Keith E. Walker mailto:kew@icehouse.net[kew@icehouse.net]
+* Keith Moore
+* Keith Sklower
+* Kelley Reynolds mailto:kelley@insidesystems.net[kelley@insidesystems.net]
+* Ken Hornstein
+* Ken Key mailto:key@cs.utk.edu[key@cs.utk.edu]
+* Ken Mayer mailto:kmayer@freegate.com[kmayer@freegate.com]
+* Ken McGlothlen mailto:mcglk@artlogix.com[mcglk@artlogix.com]
+* Ken Menzel mailto:kenm@icarz.com[kenm@icarz.com]
+* Ken Tom mailto:subd@mui.net[subd@mui.net]
+* Kenji Rikitake mailto:kenji@k2r.org[kenji@k2r.org]
+* Kenji Saito mailto:marukun@mx2.nisiq.net[marukun@mx2.nisiq.net]
+* Kenji Takefu mailto:takefu@airport.fm[takefu@airport.fm]
+* Kenji Tomita mailto:tommyk@da2.so-net.or.jp[tommyk@da2.so-net.or.jp]
+* Kenneth Furge mailto:kenneth.furge@us.endress.com[kenneth.furge@us.endress.com]
+* Kenneth Monville mailto:desmo@bandwidth.org[desmo@bandwidth.org]
+* Kenneth R. Westerback mailto:krw@tcn.net[krw@tcn.net]
+* Kenneth Stailey mailto:kstailey@yahoo.com[kstailey@yahoo.com]
+* Kenneth Vestergaard Schmidt mailto:kvs@pil.dk[kvs@pil.dk]
+* Kent Talarico mailto:kent@shipwreck.tsoft.net[kent@shipwreck.tsoft.net]
+* Kent Vander Velden mailto:graphix@iastate.edu[graphix@iastate.edu]
+* Kentaro Inagaki mailto:JBD01226@niftyserve.ne.jp[JBD01226@niftyserve.ne.jp]
+* Kevin Bracey mailto:kbracey@art.acorn.co.uk[kbracey@art.acorn.co.uk]
+* Kevin Brunelle mailto:kruptos@mlinux.org[kruptos@mlinux.org]
+* Kevin Day mailto:toasty@dragondata.com[toasty@dragondata.com]
+* Kevin Golding mailto:kevin@caomhin.demon.co.uk[kevin@caomhin.demon.co.uk]
+* Kevin Lahey mailto:kml@nas.nasa.gov[kml@nas.nasa.gov]
+* Kevin Meltzer mailto:perlguy@perlguy.com[perlguy@perlguy.com]
+* Kevin Oberman mailto:oberman@es.net[oberman@es.net]
+* Kevin Street mailto:street@iname.com[street@iname.com]
+* Kevin Van Maren mailto:vanmaren@fast.cs.utah.edu[vanmaren@fast.cs.utah.edu]
+* Kevin Zheng mailto:kevinz5000@gmail.com[kevinz5000@gmail.com]
+* Key-Teck SIN mailto:ktsin@acm.org[ktsin@acm.org]
+* Khairil Yusof mailto:kaeru@inigo-tech.com[kaeru@inigo-tech.com]
+* Killer mailto:killer@prosalg.no[killer@prosalg.no]
+* Kim Scarborough mailto:sluggo@unknown.nu[sluggo@unknown.nu]
+* Kimura Fuyuki mailto:fuyuki@hadaly.org[fuyuki@hadaly.org]
+* Kiril Mitev mailto:kiril@ideaglobal.com[kiril@ideaglobal.com]
+* Kirill Bezzubets mailto:kirill@solaris.ru[kirill@solaris.ru]
+* Kirill A. Korinskiy mailto:catap@catap.ru[catap@catap.ru]
+* Kirk Strauser mailto:kirk@strauser.com[kirk@strauser.com]
+* Kiroh HARADA mailto:kiroh@kh.rim.or.jp[kiroh@kh.rim.or.jp]
+* Klaus Aehlig mailto:aehlig@linta.de[aehlig@linta.de]
+* Klaus Goger mailto:klaus.goger@reflex.at[klaus.goger@reflex.at]
+* Klaus Herrmann mailto:klaus.herrmann@gmx.net[klaus.herrmann@gmx.net]
+* Klaus Klein mailto:kleink@layla.inka.de[kleink@layla.inka.de]
+* Klaus Michael Indlekofer mailto:M.Indlekofer@gmx.de[M.Indlekofer@gmx.de]
+* Klaus-J. Wolf mailto:Yanestra@t-online.de[Yanestra@t-online.de]
+* Koichi Sato mailto:copan@ppp.fastnet.or.jp[copan@ppp.fastnet.or.jp]
+* Konrad Heuer mailto:kheuer@gwdu60.gwdg.de[kheuer@gwdu60.gwdg.de]
+* Konrad Lapsz mailto:konrad.lapsz@gmail.com[konrad.lapsz@gmail.com]
+* Konstantin Chuguev mailto:Konstantin.Chuguev@dante.org.uk[Konstantin.Chuguev@dante.org.uk]
+* Konstantin Reznichenko mailto:kot@premierbank.dp.ua[kot@premierbank.dp.ua]
+* Konstantin Stroikovsky mailto:bonkor@gmail.com[bonkor@gmail.com]
+* Konstantinos Mplekos mailto:mplekos@physics.upatras.gr[mplekos@physics.upatras.gr]
+* Kostya Lukin mailto:lukin@okbmei.msk.su[lukin@okbmei.msk.su]
+* Kouichi Hirabayashi mailto:kh@mogami-wire.co.jp[kh@mogami-wire.co.jp]
+* Kris Dow mailto:kris@vilnya.demon.co.uk[kris@vilnya.demon.co.uk]
+* Krzysztof Kowalewski mailto:pyzmen@kam.pl[pyzmen@kam.pl]
+* Krzysztof Pawlowski mailto:msciciel@darkzone.ma.cx[msciciel@darkzone.ma.cx]
+* Kuan-Chung Chiu mailto:buganini@gmail.com[buganini@gmail.com]
+* Kuang-che Wu mailto:kcwu@csie.org[kcwu@csie.org]
+* Kuo-Feng Tseng mailto:kftseng@iyard.org[kftseng@iyard.org]
+* Kurt D. Zeilenga mailto:Kurt@Boolean.NET[Kurt@Boolean.NET]
+* Kurt Kanzenbach mailto:kurt@kmk-computers.de[kurt@kmk-computers.de]
+* Kurt Olsen mailto:kurto@tiny.mcs.usu.edu[kurto@tiny.mcs.usu.edu]
+* Kyle Martin mailto:mkm@ieee.org[mkm@ieee.org]
+* L. Jonas Olsson mailto:ljo@ljo-slip.DIALIN.CWRU.Edu[ljo@ljo-slip.DIALIN.CWRU.Edu]
+* Lacey Powers mailto:lacey.leanne@gmail.com[lacey.leanne@gmail.com]
+* Lapo Luchini mailto:lapo@lapo.it[lapo@lapo.it]
+* Larry Altneu mailto:larry@ALR.COM[larry@ALR.COM]
+* Larry P. Maloney mailto:larry@kiputers.com[larry@kiputers.com]
+* Lars Bernhardsson mailto:lab@fnurt.net[lab@fnurt.net]
+* Lars Eggert mailto:lars.eggert@gmx.net[lars.eggert@gmx.net]
+* Lars Erik Gullerud mailto:lerik@nolink.net[lerik@nolink.net]
+* Lasse L. Johnsen mailto:lasse@freebsdcluster.org[lasse@freebsdcluster.org]
+* Laurence Lopez mailto:lopez@mv.mv.com[lopez@mv.mv.com]
+* Laurent Courty mailto:lrntct@gmail.com[lrntct@gmail.com]
+* Laurent Levier mailto:llevier@argosnet.com[llevier@argosnet.com]
+* Lauri Watts mailto:lauri@kde.org[lauri@kde.org]
+* Laust S. Jespersen mailto:L@ust.dk[L@ust.dk]
+* Leandro Luiz Pereira mailto:leandro@fullonmorning.com[leandro@fullonmorning.com]
+* Lee Cremeans mailto:lcremean@tidalwave.net[lcremean@tidalwave.net]
+* Lefteris Chatzibarbas mailto:lefcha@hellug.gr[lefcha@hellug.gr]
+* Leif Pedersen mailto:pedersen@meridian-enviro.com[pedersen@meridian-enviro.com]
+* Len Sassaman mailto:rabbi@abditum.com[rabbi@abditum.com]
+* Leo Kim mailto:leo@florida.sarang.net[leo@florida.sarang.net]
+* Leo Vandewoestijne mailto:freebsd@dns.company[freebsd@dns.company]
+* Leonardo Silveira de A. Martins mailto:lmartins@nepe.eee.ufg.br[lmartins@nepe.eee.ufg.br]
+* Leonhard Wimmer mailto:leo@mediatomb.cc[leo@mediatomb.cc]
+* Leonid Zolotarev mailto:leoz.2005@gmail.com[leoz.2005@gmail.com]
+* Lev Walkin mailto:vlm@lionet.info[vlm@lionet.info]
+* Levent Kayan mailto:levent@corehack.org[levent@corehack.org]
+* Lewis Thompson mailto:purple@lewiz.net[purple@lewiz.net]
+* Li-lun Wang mailto:llwang@infor.org[llwang@infor.org]
+* Liam Foy mailto:liamfoy@sepulcrum.org[liamfoy@sepulcrum.org]
+* Linh Pham mailto:question+freebsdpr@closedsrc.org[question+freebsdpr@closedsrc.org]
+* Loganaden Velvindron mailto:logan@cyberstorm.mu[logan@cyberstorm.mu]
+* Lon Willett mailto:lon%softt.uucp@math.utah.edu[lon%softt.uucp@math.utah.edu]
+* Loren J. Rittle mailto:ljrittle@acm.org[ljrittle@acm.org]
+* Loren M. Lang mailto:lorenl@alzatex.com[lorenl@alzatex.com]
+* Louis A. Mamakos mailto:loiue@TransSys.com[loiue@TransSys.com]
+* Lowell Gilbert mailto:lowell@world.std.com[lowell@world.std.com]
+* Lubomir Metodiev Marinov mailto:lubomir.marinov@gmail.com[lubomir.marinov@gmail.com]
+* Lucas Andrade mailto:slucasandrade@protonmail.ch[slucasandrade@protonmail.ch]
+* Lucas James mailto:Lucas.James@ldjpc.apana.org.au[Lucas.James@ldjpc.apana.org.au]
+* Lucio Costa mailto:lucio@zetasolucoes.com.br[lucio@zetasolucoes.com.br]
+* Luiz Eduardo Roncato Cordeiro mailto:cordeiro@nic.br[cordeiro@nic.br]
+* Lukasz Komsta mailto:luqqe@users.sourceforge.net[luqqe@users.sourceforge.net]
+* Lukasz Stelmach mailto:lukasz.stelmach@iem.pw.edu.pl[lukasz.stelmach@iem.pw.edu.pl]
+* Lukasz Wasikowski mailto:lukasz@wasikowski.net[lukasz@wasikowski.net]
+* Lupe Christoph mailto:lupe@lupe-christoph.de[lupe@lupe-christoph.de]
+* Lutz Boehne mailto:lboehne@damogran.de[lboehne@damogran.de]
+* Lyndon Nerenberg mailto:lyndon@orthanc.ab.ca[lyndon@orthanc.ab.ca]
+* M Rothwell mailto:freebsd-ports@coreland.ath.cx[freebsd-ports@coreland.ath.cx]
+* M. L. Dodson mailto:bdodson@scms.utmb.EDU[bdodson@scms.utmb.EDU]
+* M.C. Wong
+* MOROHOSHI Akihiko mailto:moro@remus.dti.ne.jp[moro@remus.dti.ne.jp]
+* Machiel Mastenbroek mailto:machiel_mastenbroek@hotmail.com[machiel_mastenbroek@hotmail.com]
+* Magnus Enbom mailto:dot@tinto.campus.luth.se[dot@tinto.campus.luth.se]
+* Mahesh Neelakanta mailto:mahesh@gcomm.com[mahesh@gcomm.com]
+* Mahlon E. Smith mailto:mahlon@martini.nu[mahlon@martini.nu]
+* Makoto WATANABE mailto:watanabe@zlab.phys.nagoya-u.ac.jp[watanabe@zlab.phys.nagoya-u.ac.jp]
+* Makoto YAMAKURA mailto:makoto@pinpott.spnet.ne.jp[makoto@pinpott.spnet.ne.jp]
+* Malte Lance mailto:malte.lance@gmx.net[malte.lance@gmx.net]
+* Manish Jain mailto:bourne.identity@hotmail.com[bourne.identity@hotmail.com]
+* Mantas Kaulakys mailto:stone@tainet.lt[stone@tainet.lt]
+* Manu Iyengar mailto:iyengar@grunthos.pscwa.psca.com[iyengar@grunthos.pscwa.psca.com]
+* Manuel Creach mailto:manuel.creach@me.com[manuel.creach@me.com]
+* Manuel Rabade Garcia mailto:mig@mig-29.net[mig@mig-29.net]
+* Marc Blanchet mailto:marc.blanchet@viagenie.qc.ca[marc.blanchet@viagenie.qc.ca]
+* Marc Frajola mailto:marc@dev.com[marc@dev.com]
+* Marc Olzheim mailto:marcolz@stack.nl[marcolz@stack.nl]
+* Marc Ramirez mailto:mrami@mramirez.sy.yale.edu[mrami@mramirez.sy.yale.edu]
+* Marc Recht mailto:marc@informatik.uni-bremen.de[marc@informatik.uni-bremen.de]
+* Marc Silver mailto:marcs@draenor.org[marcs@draenor.org]
+* Marc Slemko mailto:marcs@znep.com[marcs@znep.com]
+* Marc van Kempen mailto:wmbfmk@urc.tue.nl[wmbfmk@urc.tue.nl]
+* Marc van Woerkom mailto:marc.vanwoerkom@fernuni-hagen.de[marc.vanwoerkom@fernuni-hagen.de]
+* Marcel Bischoff mailto:marcel@herrbischoff.com[marcel@herrbischoff.com]
+* Marcel Kaiser mailto:mk@nic-nac-project.org[mk@nic-nac-project.org]
+* Marcello Silva Coutinho mailto:marcellocoutinho@gmail.com[marcellocoutinho@gmail.com]
+* Marcelo/Porks Rossi mailto:marcelorossi@gmail.com[marcelorossi@gmail.com]
+* Marcin Cieslak mailto:saper@system.pl[saper@system.pl]
+* Marcin Gondek mailto:drixter@e-utp.net[drixter@e-utp.net]
+* Marcin Jessa mailto:yazzy@yazzy.org[yazzy@yazzy.org]
+* Marcin Wisnicki mailto:mwisnicki@gmail.com[mwisnicki@gmail.com]
+* Marco Molteni mailto:molter@tin.it[molter@tin.it]
+* Marco Steinbach mailto:coco@executive-computing.de[coco@executive-computing.de]
+* Marco van de Voort mailto:marcov@stack.nl[marcov@stack.nl]
+* Marcos Andre Hermann mailto:udialup@gmail.com[udialup@gmail.com]
+* Marcus Vinicius Bastos Leandro mailto:mvleandro@gmail.com[mvleandro@gmail.com]
+* Marin Atanasov mailto:dnaeon@gmail.com[dnaeon@gmail.com]
+* Mario Lobo mailto:lobo@bsd.com.br[lobo@bsd.com.br]
+* Marius Nünnerich mailto:marius@nuenneri.ch[marius@nuenneri.ch]
+* Mark A. Wicks mailto:mwicks@kettering.edu[mwicks@kettering.edu]
+* Mark Andrews
+* Mark Blackman mailto:freebsd-ports@blackmans.org[freebsd-ports@blackmans.org]
+* Mark Cammidge mailto:mark@gmtunx.ee.uct.ac.za[mark@gmtunx.ee.uct.ac.za]
+* Mark Daniel Reidel mailto:ports@mark.reidel.info[ports@mark.reidel.info]
+* Mark Diekhans mailto:markd@grizzly.com[markd@grizzly.com]
+* Mark Foster mailto:mark@foster.cc[mark@foster.cc]
+* Mark Hannon mailto:markhannon@optusnet.com.au[markhannon@optusnet.com.au]
+* Mark Huizer mailto:xaa+freebsd@timewasters.nl[xaa+freebsd@timewasters.nl]
+* Mark J. Miller mailto:joup@bigfoot.com[joup@bigfoot.com]
+* Mark J. Taylor mailto:mtaylor@cybernet.com[mtaylor@cybernet.com]
+* Mark Johnston mailto:mjohnston@skyweb.ca[mjohnston@skyweb.ca]
+* Mark Kane mailto:mark@mkproductions.org[mark@mkproductions.org]
+* Mark Knight mailto:markk@knigma.org[markk@knigma.org]
+* Mark Krentel mailto:krentel@rice.edu[krentel@rice.edu]
+* Mark Mayo mailto:markm@vmunix.com[markm@vmunix.com]
+* Mark Starovoytov mailto:mark_sf@kikg.ifmo.ru[mark_sf@kikg.ifmo.ru]
+* Mark Stosberg mailto:mark@summersault.com[mark@summersault.com]
+* Mark Thompson mailto:thompson@tgsoft.com[thompson@tgsoft.com]
+* Mark Tinguely mailto:tinguely@plains.nodak.edu[tinguely@plains.nodak.edu]
+* Mark Treacy
+* Mark Valentine mailto:mark@thuvia.org[mark@thuvia.org]
+* Mark Walker mailto:ziggimon@raindogs.dk[ziggimon@raindogs.dk]
+* Markus Holmberg mailto:saska@acc.umu.se[saska@acc.umu.se]
+* Markus Niemistö mailto:markus.niemisto@gmx.net[markus.niemisto@gmx.net]
+* Martijn Lina mailto:martijn@pacno.net[martijn@pacno.net]
+* Martin Dieringer mailto:martin.dieringer@gmx.de[martin.dieringer@gmx.de]
+* Martin Filla mailto:freebsd@sysctl.cz[freebsd@sysctl.cz]
+* Martin Hinner mailto:mhi@linux.gyarab.cz[mhi@linux.gyarab.cz]
+* Martin Ibert mailto:mib@ppe.bb-data.de[mib@ppe.bb-data.de]
+* Martin Jackson mailto:mhjacks@swbell.net[mhjacks@swbell.net]
+* Martin Kammerhofer mailto:mkamm@gmx.net[mkamm@gmx.net]
+* Martin Karlsson mailto:martin.karlsson@visit.se[martin.karlsson@visit.se]
+* Martin Klaffenboeck mailto:martin.klaffenboeck@gmx.at[martin.klaffenboeck@gmx.at]
+* Martin Kraft mailto:martin.kraft@fal.de[martin.kraft@fal.de]
+* Martin Kropfinger mailto:freebsd@rakor-net.de>[freebsd@rakor-net.de>]
+* Martin Mersberger mailto:gremlin@portal-to-web.de[gremlin@portal-to-web.de]
+* Martin Minkus mailto:diskiller@cnbinc.com[diskiller@cnbinc.com]
+* Martin Neubauer mailto:m.ne@gmx.net[m.ne@gmx.net]
+* Martin Otto mailto:gamato@users.sf.net[gamato@users.sf.net]
+* Martin Pala mailto:martinp@tildeslash.com[martinp@tildeslash.com]
+* Martin Preuss mailto:martin@libchipcard.de[martin@libchipcard.de]
+* Martin Sugioarto mailto:martin.sugioarto@udo.edu[martin.sugioarto@udo.edu]
+* Martin Tournoij mailto:carpetsmoker@gmail.com[carpetsmoker@gmail.com]
+* Martin Waschbüsch mailto:martin@waschbuesch.de[martin@waschbuesch.de]
+* Martti Kuparinen mailto:martti.kuparinen@ericsson.com[martti.kuparinen@ericsson.com]
+* Marwan Burelle mailto:marwan.burelle@lri.fr[marwan.burelle@lri.fr]
+* Masachika ISHIZUKA mailto:ishizuka@isis.min.ntt.jp[ishizuka@isis.min.ntt.jp]
+* Masafumi Otsune mailto:info@otsune.com[info@otsune.com]
+* Masahiro Sekiguchi mailto:seki@sysrap.cs.fujitsu.co.jp[seki@sysrap.cs.fujitsu.co.jp]
+* Masahiro TAKEMURA mailto:mastake@msel.t.u-tokyo.ac.jp[mastake@msel.t.u-tokyo.ac.jp]
+* Masahiro Teramoto mailto:markun@onohara.to[markun@onohara.to]
+* Masakazu HIGAKI mailto:higamasa@dream.com[higamasa@dream.com]
+* Masaki TAGAWA mailto:masaki@club.kyutech.ac.jp[masaki@club.kyutech.ac.jp]
+* Masanobu Saitoh mailto:msaitoh@spa.is.uec.ac.jp[msaitoh@spa.is.uec.ac.jp]
+* Masanori Kanaoka mailto:kana@saijo.mke.mei.co.jp[kana@saijo.mke.mei.co.jp]
+* Masanori Kiriake mailto:seiken@ARGV.AC[seiken@ARGV.AC]
+* Masanori OZAWA mailto:ozawa@ongs.co.jp[ozawa@ongs.co.jp]
+* Masashi CHIBA mailto:chiba.masashi@gmail.com[chiba.masashi@gmail.com]
+* Masatoshi TAMURA mailto:tamrin@shinzan.kuee.kyoto-u.ac.jp[tamrin@shinzan.kuee.kyoto-u.ac.jp]
+* Matheus Estrela mailto:matheus@arroway.org[matheus@arroway.org]
+* Mathias Monnerville mailto:mathias@monnerville.com[mathias@monnerville.com]
+* Mathieu Simon mailto:freebsd@simweb.ch[freebsd@simweb.ch]
+* Mats Lofkvist mailto:mal@algonet.se[mal@algonet.se]
+* Matt Bartley mailto:mbartley@lear35.cytex.com[mbartley@lear35.cytex.com]
+* Matt Dawson mailto:matt@mattsnetwork.co.uk[matt@mattsnetwork.co.uk]
+* Matt Douhan mailto:matt@athame.co.uk[matt@athame.co.uk]
+* Matt Emmerton mailto:matt@gsicomp.on.ca[matt@gsicomp.on.ca]
+* Matt Heckaman mailto:matt@LUCIDA.QC.CA[matt@LUCIDA.QC.CA]
+* Matt Jibson mailto:dolmant@dolmant.net[dolmant@dolmant.net]
+* Matt Lancereau mailto:matt@bsdfly.org[matt@bsdfly.org]
+* Matt Loschert mailto:loschert@servint.com[loschert@servint.com]
+* Matt Mills mailto:matt_mills@btopenworld.com[matt_mills@btopenworld.com]
+* Matt Peterson mailto:matt@peterson.org[matt@peterson.org]
+* Matt Smith mailto:matt@xtaz.net[matt@xtaz.net]
+* Matt Stofko mailto:matt@mjslabs.com[matt@mjslabs.com]
+* Matt Thomas mailto:matt@3am-software.com[matt@3am-software.com]
+* Matt Tosto mailto:datahead4@gmail.com[datahead4@gmail.com]
+* Matt White mailto:mwhite+@CMU.EDU[mwhite+@CMU.EDU]
+* Matteo Cypriani mailto:mcy@lm7.fr[mcy@lm7.fr]
+* Matthew Braithwaite mailto:mab@red-bean.com[mab@red-bean.com]
+* Matthew C. Mead mailto:mmead@Glock.COM[mmead@Glock.COM]
+* Matthew Cashdollar mailto:mattc@rfcnet.com[mattc@rfcnet.com]
+* Matthew Donovan mailto:kitchetech@gmail.com[kitchetech@gmail.com]
+* Matthew Emmerton mailto:root@gabby.gsicomp.on.ca[root@gabby.gsicomp.on.ca]
+* Matthew Flatt mailto:mflatt@cs.rice.edu[mflatt@cs.rice.edu]
+* Matthew Fuller mailto:fullermd@over-yonder.net[fullermd@over-yonder.net]
+* Matthew George mailto:mdg@secureworks.net[mdg@secureworks.net]
+* Matthew Gibson mailto:mdg583@hotmail.com[mdg583@hotmail.com]
+* Matthew Grooms mailto:mgrooms@shrew.net[mgrooms@shrew.net]
+* Matthew Holder mailto:sixxgate@hotmail.com[sixxgate@hotmail.com]
+* Matthew Luckie mailto:mjl@luckie.org.nz[mjl@luckie.org.nz]
+* Matthew Stein mailto:matt@bdd.net[matt@bdd.net]
+* Matthew West mailto:mwest@uct.ac.za[mwest@uct.ac.za]
+* Matthew Will mailto:mwill@spingen.com[mwill@spingen.com]
+* Matthew X. Economou mailto:xenophon+fbsdports@irtnog.org[xenophon+fbsdports@irtnog.org]
+* Matthias Petermann mailto:matthias@d2ux.net[matthias@d2ux.net]
+* Matthias Pfaller mailto:leo@dachau.marco.de[leo@dachau.marco.de]
+* Matthias Scheler mailto:tron@netbsd.org[tron@netbsd.org]
+* Matthias Schmidt mailto:schmidtm@mathematik.uni-marburg.de[schmidtm@mathematik.uni-marburg.de]
+* Matthias Sund mailto:m.sund@arcor.de[m.sund@arcor.de]
+* Matthias Schündehütte mailto:msch@snafu.de[msch@snafu.de]
+* Matthias Teege mailto:mteege.de[mteege.de]
+* Matthieu Guegan mailto:matt.guegan@free.fr[matt.guegan@free.fr]
+* Matthieu Volat mailto:mazhe@alkumuna.eu[mazhe@alkumuna.eu]
+* Mattias Gronlund mailto:Mattias.Gronlund@sa.erisoft.se[Mattias.Gronlund@sa.erisoft.se]
+* Mattias Pantzare mailto:pantzer@ludd.luth.se[pantzer@ludd.luth.se]
+* Matus Uhlar mailto:uhlar@fantomas.sk[uhlar@fantomas.sk]
+* Maurice Castro mailto:maurice@planet.serc.rmit.edu.au[maurice@planet.serc.rmit.edu.au]
+* Mauricio Herrera Cuadra mailto:mauricio@arareko.net[mauricio@arareko.net]
+* Mauro Risonho de Paula Assumpção mailto:mauro.risonho@gmail.com[mauro.risonho@gmail.com]
+* Max Campos mailto:mcampos@bpsw.biz[mcampos@bpsw.biz]
+* Max E. Kuznecov mailto:mek@mek.uz.ua[mek@mek.uz.ua]
+* Max Euston mailto:meuston@jmrodgers.com[meuston@jmrodgers.com]
+* Max N. Boyarov mailto:m.boyarov@bsd.by[m.boyarov@bsd.by]
+* Max V. Kostikov mailto:max@kostikov.co[max@kostikov.co]
+* Maxim Bolotin mailto:max@rsu.ru[max@rsu.ru]
+* Maxim Dounin mailto:mdounin@mdounin.ru[mdounin@mdounin.ru]
+* Maxim Filimonov mailto:che@bein.link[che@bein.link]
+* Maxim Ignatenko mailto:gelraen.ua@gmail.com[gelraen.ua@gmail.com]
+* Maxim Loginov mailto:zeliboba@mail.ru[zeliboba@mail.ru]
+* Maxim Samsonov mailto:xors@sendmail.ru[xors@sendmail.ru]
+* Maxim Tuliuk mailto:mt@primats.org.ua[mt@primats.org.ua]
+* Maxime Romano mailto:verbophobe@hotmail.com[verbophobe@hotmail.com]
+* Meikel Brandmeyer mailto:Brandels_Mikesh@web.de[Brandels_Mikesh@web.de]
+* Mel Flynn mailto:rflynn@acsalaska.net[rflynn@acsalaska.net]
+* Meno Abels mailto:meno.abels@adviser.com[meno.abels@adviser.com]
+* Meyer Wolfsheim mailto:wolf@priori.net[wolf@priori.net]
+* Micha Class mailto:michael_class@hpbbse.bbn.hp.com[michael_class@hpbbse.bbn.hp.com]
+* Michael A. Kohn mailto:naken@naken.cc[naken@naken.cc]
+* Michael Alyn Miller mailto:malyn@strangeGizmo.com[malyn@strangeGizmo.com]
+* Michael Butler mailto:imb@scgt.oz.au[imb@scgt.oz.au]
+* Michael Butschky mailto:butsch@computi.erols.com[butsch@computi.erols.com]
+* Michael C. Shultz mailto:ringworm@inbox.lv[ringworm@inbox.lv]
+* Michael Clay mailto:mclay@weareb.org[mclay@weareb.org]
+* Michael Collette mailto:metrol@metrol.net[metrol@metrol.net]
+* Michael Ebert mailto:ebert@informatik.unibw-muenchen.de[ebert@informatik.unibw-muenchen.de]
+* Michael Edenfield mailto:kutulu@kutulu.org[kutulu@kutulu.org]
+* Michael Galassi mailto:nerd@percival.rain.com[nerd@percival.rain.com]
+* Michael Hancock mailto:michaelh@cet.co.jp[michaelh@cet.co.jp]
+* Michael Handler mailto:handler@grendel.net[handler@grendel.net]
+* Michael Hohmuth mailto:hohmuth@inf.tu-dresden.de[hohmuth@inf.tu-dresden.de]
+* Michael Iatrou mailto:m_iatrou@freemail.gr[m_iatrou@freemail.gr]
+* Michael Lyngbøl mailto:michael@lyngbol.dk[michael@lyngbol.dk]
+* Michael Muenz mailto:m.muenz@gmail.com[m.muenz@gmail.com]
+* Michael Neumann mailto:mneumann@ntecs.de[mneumann@ntecs.de]
+* Michael O. Boev mailto:mike@tric.tomsk.gov.ru[mike@tric.tomsk.gov.ru]
+* Michael Perlman mailto:canuck@caam.rice.edu[canuck@caam.rice.edu]
+* Michael Petry mailto:petry@netwolf.NetMasters.com[petry@netwolf.NetMasters.com]
+* Michael Ranner mailto:mranner@inode.at[mranner@inode.at]
+* Michael Sanders mailto:mike@topcat.hypermart.net[mike@topcat.hypermart.net]
+* Michael Sardo mailto:jaeger16@yahoo.com[jaeger16@yahoo.com]
+* Michael Schout mailto:mschout@gkg.net[mschout@gkg.net]
+* Michael Searle mailto:searle@longacre.demon.co.uk[searle@longacre.demon.co.uk]
+* Michael Seyfert mailto:michaels@sdf.lonestar.org[michaels@sdf.lonestar.org]
+* Michael Urban mailto:murban@tznet.com[murban@tznet.com]
+* Michael Vasilenko mailto:acid@stu.cn.ua[acid@stu.cn.ua]
+* Michal Hanula mailto:michal@hanu.la[michal@hanu.la]
+* Michal Listos mailto:mcl@Amnesiac.123.org[mcl@Amnesiac.123.org]
+* Michal Pasternak mailto:dotz@irc.pl[dotz@irc.pl]
+* Michel Lavondés mailto:fox@vader.aacc.cc.md.us[fox@vader.aacc.cc.md.us]
+* Michele Possamai mailto:possamai@xs4all.nl[possamai@xs4all.nl]
+* Michelle Sullivan mailto:michelle@sorbs.net[michelle@sorbs.net]
+* Michio Karl Jinbo mailto:karl@marcer.nagaokaut.ac.jp[karl@marcer.nagaokaut.ac.jp]
+* Micho Durdevich mailto:micho@math.unam.mx[micho@math.unam.mx]
+* Mickael Maillot mailto:mickael.maillot@gmail.com[mickael.maillot@gmail.com]
+* Miguel Angel Sagreras mailto:msagre@cactus.fi.uba.ar[msagre@cactus.fi.uba.ar]
+* Miguel Mendez mailto:flynn@energyhq.es.eu.org[flynn@energyhq.es.eu.org]
+* Mihoko Tanaka mailto:m_tonaka@pa.yokogawa.co.jp[m_tonaka@pa.yokogawa.co.jp]
+* Mij mailto:mij@bitchx.it[mij@bitchx.it]
+* Mika Nystrom mailto:mika@cs.caltech.edu[mika@cs.caltech.edu]
+* Mikael Hybsch mailto:micke@dynas.se[micke@dynas.se]
+* Mikael Karpberg mailto:karpen@ocean.campus.luth.se[karpen@ocean.campus.luth.se]
+* Mike Andrews mailto:mandrews@bit0.com[mandrews@bit0.com]
+* Mike Bowie mailto:mbowie@buzmo.com[mbowie@buzmo.com]
+* Mike Bristow mailto:mike@urgle.com[mike@urgle.com]
+* Mike Del mailto:repenting@hotmail.com[repenting@hotmail.com]
+* Mike Durian mailto:durian@boogie.com[durian@boogie.com]
+* Mike Durkin mailto:mdurkin@tsoft.sf-bay.org[mdurkin@tsoft.sf-bay.org]
+* Mike E. Matsnev mailto:mike@azog.cs.msu.su[mike@azog.cs.msu.su]
+* Mike Edenfield mailto:kutulu@kutulu.org[kutulu@kutulu.org]
+* Mike Erickson mailto:mee@quidquam.com[mee@quidquam.com]
+* Mike Evans mailto:mevans@candle.com[mevans@candle.com]
+* Mike Futerko mailto:mike@LITech.lviv.ua[mike@LITech.lviv.ua]
+* Mike Grupenhoff mailto:kashmir@umiacs.umd.edu[kashmir@umiacs.umd.edu]
+* Mike Harding mailto:mvh@ix.netcom.com[mvh@ix.netcom.com]
+* Mike Hibler mailto:mike@marker.cs.utah.edu[mike@marker.cs.utah.edu]
+* Mike Karels
+* Mike Krutov mailto:neko@takino.org[neko@takino.org]
+* Mike Lockwood mailto:mike@mikelockwood.com[mike@mikelockwood.com]
+* Mike McGaughey mailto:mmcg@cs.monash.edu.au[mmcg@cs.monash.edu.au]
+* Mike Meyer mailto:mwm@mired.org[mwm@mired.org]
+* Mike Mitchell mailto:mitchell@ref.tfs.com[mitchell@ref.tfs.com]
+* Mike Murphy mailto:mrm@alpharel.com[mrm@alpharel.com]
+* Mike Patterson mailto:mike.patterson@unb.ca[mike.patterson@unb.ca]
+* Mike Peck mailto:mike@binghamton.edu[mike@binghamton.edu]
+* Mike Sherwood mailto:mike@fate.com[mike@fate.com]
+* Mike Spengler mailto:mks@msc.edu[mks@msc.edu]
+* Mike Tancsa mailto:mike@sentex.net[mike@sentex.net]
+* Mikhail A. Sokolov mailto:mishania@demos.su[mishania@demos.su]
+* Mikhail T. mailto:michael@fun-box.ru[michael@fun-box.ru]
+* Mikhail Zakharov mailto:zmey20000@yahoo.com[zmey20000@yahoo.com]
+* Mikolaj Rydzewski mailto:miki@ceti.pl[miki@ceti.pl]
+* Mikolaj Golub mailto:to.my.trociny@gmail.com[to.my.trociny@gmail.com]
+* Miks Mikelsons mailto:miks@cubesystems.lv[miks@cubesystems.lv]
+* Milan Obuch mailto:bsd@dino.sk[bsd@dino.sk]
+* Milosz Galazka mailto:milosz.galazka@gmail.com[milosz.galazka@gmail.com]
+* Ming-I Hseh mailto:PA@FreeBSD.ee.Ntu.edu.TW[PA@FreeBSD.ee.Ntu.edu.TW]
+* Mitsuru Yoshida mailto:mitsuru@riken.go.jp[mitsuru@riken.go.jp]
+* Mohammad S. Babaei mailto:info@babaei.net[info@babaei.net]
+* Monte Mitzelfelt mailto:monte@gonefishing.org[monte@gonefishing.org]
+* Mooneer Salem mailto:mooneer@translator.cx[mooneer@translator.cx]
+* Morgan Davis mailto:root@io.cts.com[root@io.cts.com]
+* Morten Slot Kristensen mailto:ontherenth@gmail.com[ontherenth@gmail.com]
+* Mostyn Lewis mailto:mostyn@mrl.com[mostyn@mrl.com]
+* Motomichi Matsuzaki mailto:mzaki@e-mail.ne.jp[mzaki@e-mail.ne.jp]
+* Motoyuki Kasahara mailto:m-kasahr@sra.co.jp[m-kasahr@sra.co.jp]
+* Munish Chopra mailto:munish@engmail.uwaterloo.ca[munish@engmail.uwaterloo.ca]
+* Murilo Opsfelder mailto:mopsfelder@gmail.com[mopsfelder@gmail.com]
+* Mustafa Arif mailto:ma499@doc.ic.ac.uk[ma499@doc.ic.ac.uk]
+* Mykola Dzham mailto:i@levsha.me[i@levsha.me]
+* Mykola Khotyaintsev mailto:ko@irfu.se[ko@irfu.se]
+* Mykola Marzhan mailto:delgod@portaone.com[delgod@portaone.com]
+* N.G.Smith mailto:ngs@sesame.hensa.ac.uk[ngs@sesame.hensa.ac.uk]
+* Nadilson Ferreira mailto:nadilson@gmail.com[nadilson@gmail.com]
+* NAGAO Tadaaki mailto:nagao@cs.titech.ac.jp[nagao@cs.titech.ac.jp]
+* NAKAJI Hiroyuki mailto:nakaji@jp.freebsd.org[nakaji@jp.freebsd.org]
+* NAKAMURA Kazushi mailto:kaz@kobe1995.net[kaz@kobe1995.net]
+* NAKAMURA Motonori mailto:motonori@econ.kyoto-u.ac.jp[motonori@econ.kyoto-u.ac.jp]
+* NIIMI Satoshi mailto:sa2c@and.or.jp[sa2c@and.or.jp]
+* NOKUBI Hirotaka mailto:h-nokubi@yyy.or.jp[h-nokubi@yyy.or.jp]
+* Nadav Eiron mailto:nadav@barcode.co.il[nadav@barcode.co.il]
+* Nanbor Wang mailto:nw1@cs.wustl.edu[nw1@cs.wustl.edu]
+* Naofumi Honda mailto:honda@Kururu.math.sci.hokudai.ac.jp[honda@Kururu.math.sci.hokudai.ac.jp]
+* Naoki Hamada mailto:nao@tom-yam.or.jp[nao@tom-yam.or.jp]
+* Naram Qashat mailto:cyberbotx@cyberbotx.com[cyberbotx@cyberbotx.com]
+* Narayan Namdev Newton mailto:narayannewton@gmail.com[narayannewton@gmail.com]
+* Narvi mailto:narvi@haldjas.folklore.ee[narvi@haldjas.folklore.ee]
+* Nate Eldredge mailto:neldredge@math.ucsd.edu[neldredge@math.ucsd.edu]
+* Nathan Dorfman mailto:nathan@rtfm.net[nathan@rtfm.net]
+* Nathaniel Roark mailto:robb_force@holybuffalo.net[robb_force@holybuffalo.net]
+* Natsagdorj Shagdar mailto:natsag2000@yahoo.com[natsag2000@yahoo.com]
+* Neal Fachan mailto:kneel@ishiboo.com[kneel@ishiboo.com]
+* Neal Nelson mailto:ports@nicandneal.net[ports@nicandneal.net]
+* Necati Ersen Siseci mailto:siseci@enderunix.org[siseci@enderunix.org]
+* Ned Wolpert mailto:wolpert@codeheadsystems.com[wolpert@codeheadsystems.com]
+* Neil Booth mailto:kyuupichan@gmail.com[kyuupichan@gmail.com]
+* Nguyen Tam Chinh mailto:chinhngt@sectorb.msk.ru[chinhngt@sectorb.msk.ru]
+* Niall Smart mailto:rotel@indigo.ie[rotel@indigo.ie]
+* Nicholas Esborn mailto:nick@netdot.net[nick@netdot.net]
+* Nick Barnes mailto:Nick.Barnes@pobox.com[Nick.Barnes@pobox.com]
+* Nick Black mailto:nickblack@linux.com[nickblack@linux.com]
+* Nick Dewing mailto:nickdewing@gmail.com[nickdewing@gmail.com]
+* Nick Handel mailto:nhandel@NeoSoft.com[nhandel@NeoSoft.com]
+* Nick Hilliard mailto:nick@foobar.org[nick@foobar.org]
+* Nick Johnson mailto:freebsd@spatula.net[freebsd@spatula.net]
+* Nicole Reid mailto:root@cooltrainer.org[root@cooltrainer.org]
+* Nikos Kokkalis mailto:nickkokkalis@gmail.com[nickkokkalis@gmail.com]
+* Nick Leuta mailto:skynick@mail.sc.ru[skynick@mail.sc.ru]
+* Nick Rogness mailto:nick@rogness.net[nick@rogness.net]
+* Nick Williams mailto:njw@cs.city.ac.uk[njw@cs.city.ac.uk]
+* Nick Withers mailto:nick@nickwithers.com[nick@nickwithers.com]
+* Nicko Dehaine mailto:nicko@stbernard.com[nicko@stbernard.com]
+* Nickolay N. Dudorov mailto:nnd@itfs.nsk.su[nnd@itfs.nsk.su]
+* Nicolas Embriz mailto:nbari@tequila.io[nbari@tequila.io]
+* Nicolas Jombart mailto:ecu@ipv42.net[ecu@ipv42.net]
+* Niklas Hallqvist mailto:niklas@filippa.appli.se[niklas@filippa.appli.se]
+* Nikola Lecic mailto:nikola.lecic@anthesphoria.net[nikola.lecic@anthesphoria.net]
+* Nikola Kolev mailto:koue@chaosophia.net[koue@chaosophia.net]
+* Nikos Ntarmos mailto:ntarmos@ceid.upatras.gr[ntarmos@ceid.upatras.gr]
+* Nils M. Holm mailto:nmh@t3x.org[nmh@t3x.org]
+* Nilton Jose Rizzo mailto:rizzo@rizzo.eng.br[rizzo@rizzo.eng.br]
+* Nisha Talagala mailto:nisha@cs.berkeley.edu[nisha@cs.berkeley.edu]
+* No Name mailto:ZW6T-KND@j.asahi-net.or.jp[ZW6T-KND@j.asahi-net.or.jp]
+* No Name mailto:adrian@virginia.edu[adrian@virginia.edu]
+* No Name mailto:alex@elvisti.kiev.ua[alex@elvisti.kiev.ua]
+* No Name mailto:anto@netscape.net[anto@netscape.net]
+* No Name mailto:bobson@egg.ics.nitch.ac.jp[bobson@egg.ics.nitch.ac.jp]
+* No Name mailto:bovynf@awe.be[bovynf@awe.be]
+* No Name mailto:burg@is.ge.com[burg@is.ge.com]
+* No Name mailto:chris@gnome.co.uk[chris@gnome.co.uk]
+* No Name mailto:colsen@usa.net[colsen@usa.net]
+* No Name mailto:coredump@nervosa.com[coredump@nervosa.com]
+* No Name mailto:dannyman@arh0300.urh.uiuc.edu[dannyman@arh0300.urh.uiuc.edu]
+* No Name mailto:davids@SECNET.COM[davids@SECNET.COM]
+* No Name mailto:derek@free.org[derek@free.org]
+* No Name mailto:dvv@sprint.net[dvv@sprint.net]
+* No Name mailto:enami@ba2.so-net.or.jp[enami@ba2.so-net.or.jp]
+* No Name mailto:flash@eru.tubank.msk.su[flash@eru.tubank.msk.su]
+* No Name mailto:flash@hway.ru[flash@hway.ru]
+* No Name mailto:fn@pain.csrv.uidaho.edu[fn@pain.csrv.uidaho.edu]
+* No Name mailto:frf@xocolatl.com[frf@xocolatl.com]
+* No Name mailto:gclarkii@netport.neosoft.com[gclarkii@netport.neosoft.com]
+* No Name mailto:gordon@sheaky.lonestar.org[gordon@sheaky.lonestar.org]
+* No Name mailto:graaf@iae.nl[graaf@iae.nl]
+* No Name mailto:greg@greg.rim.or.jp[greg@greg.rim.or.jp]
+* No Name mailto:grossman@cygnus.com[grossman@cygnus.com]
+* No Name mailto:gusw@fub46.zedat.fu-berlin.de[gusw@fub46.zedat.fu-berlin.de]
+* No Name mailto:hfir@math.rochester.edu[hfir@math.rochester.edu]
+* No Name mailto:hnokubi@yyy.or.jp[hnokubi@yyy.or.jp]
+* No Name mailto:iaint@css.tuu.utas.edu.au[iaint@css.tuu.utas.edu.au]
+* No Name mailto:invis@visi.com[invis@visi.com]
+* No Name mailto:ishisone@sra.co.jp[ishisone@sra.co.jp]
+* No Name mailto:iverson@lionheart.com[iverson@lionheart.com]
+* No Name mailto:jpt@magic.net[jpt@magic.net]
+* No Name mailto:junker@jazz.snu.ac.kr[junker@jazz.snu.ac.kr]
+* No Name mailto:k-sugyou@ccs.mt.nec.co.jp[k-sugyou@ccs.mt.nec.co.jp]
+* No Name mailto:kenji@reseau.toyonaka.osaka.jp[kenji@reseau.toyonaka.osaka.jp]
+* No Name mailto:kfurge@worldnet.att.net[kfurge@worldnet.att.net]
+* No Name mailto:lh@aus.org[lh@aus.org]
+* No Name mailto:lhecking@nmrc.ucc.ie[lhecking@nmrc.ucc.ie]
+* No Name mailto:mrgreen@mame.mu.oz.au[mrgreen@mame.mu.oz.au]
+* No Name mailto:nakagawa@jp.FreeBSD.org[nakagawa@jp.FreeBSD.org]
+* No Name mailto:ohki@gssm.otsuka.tsukuba.ac.jp[ohki@gssm.otsuka.tsukuba.ac.jp]
+* No Name mailto:owaki@st.rim.or.jp[owaki@st.rim.or.jp]
+* No Name mailto:pechter@shell.monmouth.com[pechter@shell.monmouth.com]
+* No Name mailto:pete@pelican.pelican.com[pete@pelican.pelican.com]
+* No Name mailto:pritc003@maroon.tc.umn.edu[pritc003@maroon.tc.umn.edu]
+* No Name mailto:risner@stdio.com[risner@stdio.com]
+* No Name mailto:root@ns2.redline.ru[root@ns2.redline.ru]
+* No Name mailto:root@uglabgw.ug.cs.sunysb.edu[root@uglabgw.ug.cs.sunysb.edu]
+* No Name mailto:stephen.ma@jtec.com.au[stephen.ma@jtec.com.au]
+* No Name mailto:sumii@is.s.u-tokyo.ac.jp[sumii@is.s.u-tokyo.ac.jp]
+* No Name mailto:takas-su@is.aist-nara.ac.jp[takas-su@is.aist-nara.ac.jp]
+* No Name mailto:tjevans@raleigh.ibm.com[tjevans@raleigh.ibm.com]
+* No Name mailto:torii@tcd.hitachi.co.jp[torii@tcd.hitachi.co.jp]
+* No Name mailto:uenami@imasy.or.jp[uenami@imasy.or.jp]
+* No Name mailto:vode@hut.fi[vode@hut.fi]
+* No Name mailto:wlloyd@mpd.ca[wlloyd@mpd.ca]
+* No Name mailto:wlr@furball.wellsfargo.com[wlr@furball.wellsfargo.com]
+* No Name mailto:wmbfmk@urc.tue.nl[wmbfmk@urc.tue.nl]
+* No Name mailto:yamagata@nwgpc.kek.jp[yamagata@nwgpc.kek.jp]
+* No Name mailto:ziggy@ryan.org[ziggy@ryan.org]
+* No Name mailto:salexanov@gmail.com[salexanov@gmail.com]
+* Nobuhiro Yasutomi mailto:nobu@psrc.isac.co.jp[nobu@psrc.isac.co.jp]
+* Nobuyuki Koganemaru mailto:kogane@koganemaru.co.jp[kogane@koganemaru.co.jp]
+* Norberto Lopes mailto:nlopes.ml@gmail.com[nlopes.ml@gmail.com]
+* Norio Suzuki mailto:nosuzuki@e-mail.ne.jp[nosuzuki@e-mail.ne.jp]
+* Noritaka Ishizumi mailto:graphite@jp.FreeBSD.org[graphite@jp.FreeBSD.org]
+* Noritoshi Demizu mailto:demizu@dd.iij4u.or.jp[demizu@dd.iij4u.or.jp]
+* Noriyuki Soda mailto:soda@sra.co.jp[soda@sra.co.jp]
+* Oddbjorn Steffensen mailto:oddbjorn@tricknology.org[oddbjorn@tricknology.org]
+* Oh Junseon mailto:hollywar@mail.holywar.net[hollywar@mail.holywar.net]
+* Olaf Wagner mailto:wagner@luthien.in-berlin.de[wagner@luthien.in-berlin.de]
+* Olafur Osvaldsson mailto:oli@isnic.is[oli@isnic.is]
+* Oleg Alexeenkov mailto:proler@gmail.com[proler@gmail.com]
+* Oleg Ginzburg mailto:olevole@olevole.ru[olevole@olevole.ru]
+* Oleg Kiselyov mailto:oleg@pobox.com[oleg@pobox.com]
+* Oleg A. Mamontov mailto:oleg@mamontov.net[oleg@mamontov.net]
+* Oleg M. Golovanov mailto:olmi@rentech.ru[olmi@rentech.ru]
+* Oleg Moskalenko mailto:mom040267@gmail.com[mom040267@gmail.com]
+* Oleg R. Muhutdinov mailto:mor@whiteluna.com[mor@whiteluna.com]
+* Oleg Semyonov mailto:os@altavista.net[os@altavista.net]
+* Oleg Sharoiko mailto:os@rsu.ru[os@rsu.ru]
+* Oleg Ukraincev mailto:oleg@ht-systems.ru[oleg@ht-systems.ru]
+* Oleg V. Volkov mailto:rover@lglobus.ru[rover@lglobus.ru]
+* Oleh Hushchenkov mailto:gor@clogic.com.ua[gor@clogic.com.ua]
+* Oleksandr Lystopad mailto:laa@laa.zp.ua[laa@laa.zp.ua]
+* Olexander Kunytsa mailto:kunia@wolf.istc.kiev.ua[kunia@wolf.istc.kiev.ua]
+* Oliver Breuninger mailto:ob@seicom.NET[ob@seicom.NET]
+* Oliver Dunkl mailto:odunkl@gmx.net[odunkl@gmx.net]
+* Oliver Fischer mailto:plexus@snafu.de[plexus@snafu.de]
+* Oliver Friedrichs mailto:oliver@secnet.com[oliver@secnet.com]
+* Oliver Hartmann mailto:ohartman@zedat.fu-berlin.de[ohartman@zedat.fu-berlin.de]
+* Oliver Heesakkers mailto:dev2@heesakkers.info[dev2@heesakkers.info]
+* Oliver Helmling mailto:oliver.helmling@stud.uni-bayreuth.de[oliver.helmling@stud.uni-bayreuth.de]
+* Oliver Laumann mailto:net@informatik.uni-bremen.de[net@informatik.uni-bremen.de]
+* Oliver Oberdorf mailto:oly@world.std.com[oly@world.std.com]
+* Oliver Peter mailto:hoschi@mouhaha.de[hoschi@mouhaha.de]
+* Olivier Beyssac mailto:obld@r14.freenix.org[obld@r14.freenix.org]
+* Olivier Tharan mailto:olive@oban.frmug.org[olive@oban.frmug.org]
+* Olof Johansson mailto:offe@ludd.luth.se[offe@ludd.luth.se]
+* Omer Faruk Sen mailto:ofsen@enderunix.org[ofsen@enderunix.org]
+* Oscar Bonilla mailto:obonilla@galileo.edu[obonilla@galileo.edu]
+* Otacílio de Araújo Ramos Neto mailto:otacilio.neto@ee.ufcg.edu.br[otacilio.neto@ee.ufcg.edu.br]
+* Otávio Fernandes mailto:otaviof@gmail.com[otaviof@gmail.com]
+* Ozkan KIRIK mailto:ozkan@enderunix.org[ozkan@enderunix.org]
+* Pace Willisson mailto:pace@blitz.com[pace@blitz.com]
+* Paco Rosich mailto:rosich@modico.eleinf.uv.es[rosich@modico.eleinf.uv.es]
+* Pakhom Golynga mailto:pg@pakhom.spb.ru[pg@pakhom.spb.ru]
+* Panagiotis Astithas mailto:past@noc.ntua.gr[past@noc.ntua.gr]
+* Panagiotis Kritikakos mailto:panoskrt@googlemail.com[panoskrt@googlemail.com]
+* Parag Patel mailto:parag@cgt.com[parag@cgt.com]
+* Pascal Pederiva mailto:pascal@zuo.dec.com[pascal@zuo.dec.com]
+* Pascal Vizeli mailto:pvizeli@yahoo.de[pvizeli@yahoo.de]
+* Pasi Hirvonen mailto:psh@iki.fi[psh@iki.fi]
+* Pasvorn Boonmark mailto:boonmark@juniper.net[boonmark@juniper.net]
+* Patrick Alken mailto:cosine@ellipse.mcs.drexel.edu[cosine@ellipse.mcs.drexel.edu]
+* Patrick Atamaniuk mailto:atamaniuk-ports@frobs.net[atamaniuk-ports@frobs.net]
+* Patrick Bihan-Faou mailto:patrick@mindstep.com[patrick@mindstep.com]
+* Patrick Dung mailto:patrick_dkt@yahoo.com.hk[patrick_dkt@yahoo.com.hk]
+* Patrick Hausen
+* Patrick MARIE mailto:mycroft@virgaria.org[mycroft@virgaria.org]
+* Patrick Powell mailto:papowell@astart.com[papowell@astart.com]
+* Patrick Rinke mailto:patrick@rinke-bochum.de[patrick@rinke-bochum.de]
+* Patrick Seal mailto:patseal@hyperhost.net[patseal@hyperhost.net]
+* Patrick Tracanelli mailto:eksffa@freebsdbrasil.com.br[eksffa@freebsdbrasil.com.br]
+* Paul mailto:onemda@gmail.com[onemda@gmail.com]
+* Paul A. Hoadley mailto:paulh@logicsquad.net[paulh@logicsquad.net]
+* Paul Antonov mailto:apg@demos.su[apg@demos.su]
+* Paul Chvostek mailto:paul@it.ca[paul@it.ca]
+* Paul Dlug mailto:paul@aps.org[paul@aps.org]
+* Paul F. Werkowski
+* Paul Fox mailto:pgf@foxharp.boston.ma.us[pgf@foxharp.boston.ma.us]
+* Paul Koch mailto:koch@thehub.com.au[koch@thehub.com.au]
+* Paul Kranenburg mailto:pk@NetBSD.org[pk@NetBSD.org]
+* Paul M. Lambert mailto:plambert@plambert.net[plambert@plambert.net]
+* Paul Mackerras mailto:paulus@cs.anu.edu.au[paulus@cs.anu.edu.au]
+* Paul Popelka mailto:paulp@uts.amdahl.com[paulp@uts.amdahl.com]
+* Paul S. LaFollette, Jr.
+* Paul Sandys mailto:myj@nyct.net[myj@nyct.net]
+* Paul Schmehl mailto:pauls@utdallas.edu[pauls@utdallas.edu]
+* Paul T. Root mailto:proot@horton.iaces.com[proot@horton.iaces.com]
+* Paul Vixie mailto:paul@vix.com[paul@vix.com]
+* Paulo Fragoso mailto:paulo@nlink.com.br[paulo@nlink.com.br]
+* Paulo Menezes mailto:paulo@isr.uc.pt[paulo@isr.uc.pt]
+* Paulo Menezes mailto:pm@dee.uc.pt[pm@dee.uc.pt]
+* Pavel Janik mailto:Pavel@Janik.cz[Pavel@Janik.cz]
+* Pavel Novikov mailto:pavel@ext.by[pavel@ext.by]
+* Pavel Pankov mailto:pankov_p@mail.ru[pankov_p@mail.ru]
+* Pavel Timofeev mailto:timp87@gmail.com[timp87@gmail.com]
+* Pavel Veretennikov mailto:vermut@kid.lv[vermut@kid.lv]
+* Pavel I Volkov mailto:pavelivolkov@googlemail.com[pavelivolkov@googlemail.com]
+* Pawel Worach mailto:pawel.worach@gmail.com[pawel.worach@gmail.com]
+* Pedro A M Vazquez mailto:vazquez@IQM.Unicamp.BR[vazquez@IQM.Unicamp.BR]
+* Pengfei JU mailto:jupengfei@gmail.com[jupengfei@gmail.com]
+* Per Wigren mailto:wigren@home.se[wigren@home.se]
+* Pete Bentley mailto:pete@demon.net[pete@demon.net]
+* Peter Ankerstål mailto:peter@pean.org[peter@pean.org]
+* Peter Avalos mailto:pavalos@theshell.com[pavalos@theshell.com]
+* Peter Childs mailto:pjchilds@imforei.apana.org.au[pjchilds@imforei.apana.org.au]
+* Peter Cornelius mailto:pc@inr.fzk.de[pc@inr.fzk.de]
+* Pete French mailto:pete@twisted.org.uk[pete@twisted.org.uk]
+* Peter Haight mailto:peterh@prognet.com[peterh@prognet.com]
+* Peter Holub mailto:hopet@ics.muni.cz[hopet@ics.muni.cz]
+* Peter Klatt mailto:glocke@bsdstammtisch.at[glocke@bsdstammtisch.at]
+* Peter Kolmisoppi mailto:growspd@brokep.com[growspd@brokep.com]
+* Peter M. Chen mailto:pmchen@eecs.umich.edu[pmchen@eecs.umich.edu]
+* Peter Much mailto:peter@citylink.dinoex.sub.org[peter@citylink.dinoex.sub.org]
+* Peter Olsson
+* Peter Philipp mailto:pjp@bsd-daemon.net[pjp@bsd-daemon.net]
+* Peter S. Housel mailto:housel@acm.org[housel@acm.org]
+* Peter Schuller mailto:peter.schuller@infidyne.com[peter.schuller@infidyne.com]
+* Peter Stubbs mailto:PETERS@staidan.qld.edu.au[PETERS@staidan.qld.edu.au]
+* Péter Terbe mailto:sncdev@gmail.com[sncdev@gmail.com]
+* Peter Thoenen mailto:peter.thoenen@yahoo.com[peter.thoenen@yahoo.com]
+* Peter Vereshagin mailto:peter@vereshagin.org[peter@vereshagin.org]
+* Peter W. Schmiedeskamp mailto:pschmied@qwest.net[pschmied@qwest.net]
+* Peter van Dijk mailto:peter@dataloss.nl[peter@dataloss.nl]
+* Peter van Heusden mailto:pvh@wfeet.za.net[pvh@wfeet.za.net]
+* Petr Macek mailto:pm@kostax.cz[pm@kostax.cz]
+* Petr Rehor mailto:prehor@gmail.com[prehor@gmail.com]
+* Phil Budne mailto:phil@ultimate.com[phil@ultimate.com]
+* Phil Maker mailto:pjm@gnu.org[pjm@gnu.org]
+* Phil Oleson mailto:oz@nixil.net[oz@nixil.net]
+* Phil Phillips mailto:pphillips@experts-exchange.com[pphillips@experts-exchange.com]
+* Phil Sutherland mailto:philsuth@mycroft.dialix.oz.au[philsuth@mycroft.dialix.oz.au]
+* Phil Taylor mailto:phil@zipmail.co.uk[phil@zipmail.co.uk]
+* Philip Musumeci mailto:p.musumeci@ieee.org[p.musumeci@ieee.org]
+* Philip Reynolds mailto:philip.reynolds@rfc-networks.ie[philip.reynolds@rfc-networks.ie]
+* Philip Schulz mailto:phs@deadc0.de[phs@deadc0.de]
+* Philip Stoev mailto:philip.stoev@galeracluster.com[philip.stoev@galeracluster.com]
+* Philippe Lefebvre mailto:nemesis@balistik.net[nemesis@balistik.net]
+* Philippe Maechler mailto:plcmaechler@gmail.com[plcmaechler@gmail.com]
+* Philippe Pepiot mailto:phil@philpep.org[phil@philpep.org]
+* Philippe Rocques mailto:phil@teaser.fr[phil@teaser.fr]
+* Pierre David mailto:pdagog@gmail.com[pdagog@gmail.com]
+* Pierre Y. Dampure mailto:pierre.dampure@k2c.co.uk[pierre.dampure@k2c.co.uk]
+* Pierre-Paul Lavoie mailto:ppl@nbnet.nb.ca[ppl@nbnet.nb.ca]
+* Pieter Danhieux mailto:opr@bsdaemon.be[opr@bsdaemon.be]
+* Piotr Florczyk mailto:p.florczyk@adminworkshop.pl[p.florczyk@adminworkshop.pl]
+* Piotr Rybicki mailto:meritus@innervision.pl[meritus@innervision.pl]
+* Piotr Smyrak mailto:piotr.smyrak@heron.pl[piotr.smyrak@heron.pl]
+* Pius Fischer mailto:pius@ienet.com[pius@ienet.com]
+* Pomegranate mailto:daver@flag.blackened.net[daver@flag.blackened.net]
+* Pontus Stenetorp mailto:ninjin@kth.se[ninjin@kth.se]
+* Powerdog Industries mailto:kevin.ruddy@powerdog.com[kevin.ruddy@powerdog.com]
+* Priit Järv mailto:priit@cc.ttu.ee[priit@cc.ttu.ee]
+* Prudhvi Krishna mailto:prudhvikrishna@gmail.com[prudhvikrishna@gmail.com]
+* Qiang Guo mailto:guoqiang_cn@126.com[guoqiang_cn@126.com]
+* Qing Feng mailto:qingfeng@me.com[qingfeng@me.com]
+* Quentin Baker mailto:bsd@quentb.com[bsd@quentb.com]
+* Quentin Stievenart mailto:acieroid@awesom.eu[acieroid@awesom.eu]
+* Quinton Dolan mailto:q@onthenet.com.au[q@onthenet.com.au]
+* R Joseph Wright mailto:rjoseph@mammalia.org[rjoseph@mammalia.org]
+* R. Kym Horsell
+* R Skinner mailto:port_maintainer@herveybayaustralia.com.au[port_maintainer@herveybayaustralia.com.au]
+* Radek Kozlowski mailto:radek@raadradd.com[radek@raadradd.com]
+* Radim Kolar mailto:hsn@netmag.cz[hsn@netmag.cz]
+* Radoslav Vasilev mailto:rvasilev@uni-svishtov.bg[rvasilev@uni-svishtov.bg]
+* Rafael Mentz Aquino mailto:rafael@lk6.com.br[rafael@lk6.com.br]
+* Rafal Lesniak mailto:fbsd@grid.einherjar.de[fbsd@grid.einherjar.de]
+* Raffaele De Lorenzo mailto:raffaele.delorenzo@libero.it[raffaele.delorenzo@libero.it]
+* Rainer Duffer mailto:rainer@ultra-secure.de[rainer@ultra-secure.de]
+* Ralf Friedl mailto:friedl@informatik.uni-kl.de[friedl@informatik.uni-kl.de]
+* Ralf Gebhart mailto:gebhart@secnetix.de[gebhart@secnetix.de]
+* Ralf van der Enden mailto:tremere@cainites.net[tremere@cainites.net]
+* Ralf van Dooren mailto:r.vdooren@snow.nl[r.vdooren@snow.nl]
+* Randal S. Masutani mailto:randal@comtest.com[randal@comtest.com]
+* Randall Hopper mailto:rhh@ct.picker.com[rhh@ct.picker.com]
+* Randall W. Dean mailto:rwd@osf.org[rwd@osf.org]
+* Randy Bush mailto:rbush@bainbridge.verio.net[rbush@bainbridge.verio.net]
+* Rashid N. Achilov mailto:shelton@sentry.granch.ru[shelton@sentry.granch.ru]
+* Rasmus Kaj mailto:rasmus@kaj.se[rasmus@kaj.se]
+* Raul Pollicino mailto:email-ports@def-defying.com[email-ports@def-defying.com]
+* Razi Khaja mailto:razi@genet.sickkids.on.ca[razi@genet.sickkids.on.ca]
+* Reed A. Cartwright mailto:cartwright@asu.edu[cartwright@asu.edu]
+* Reinier Bezuidenhout mailto:rbezuide@mikom.csir.co.za[rbezuide@mikom.csir.co.za]
+* Remington Lang mailto:MrL0L@charter.net[MrL0L@charter.net]
+* Remy Card mailto:Remy.Card@masi.ibp.fr[Remy.Card@masi.ibp.fr]
+* Renato P. S. Saoud mailto:renatofreerider@hotmail.com[renatofreerider@hotmail.com]
+* Revis Zinkov mailto:rzinkov@gmail.com[rzinkov@gmail.com]
+* Ricardas Cepas mailto:rch@richard.eu.org[rch@richard.eu.org]
+* Ricardo A. Reis mailto:ricardo.areis@gmail.com[ricardo.areis@gmail.com]
+* Riccardo Veraldi mailto:veraldi@cs.unibo.it[veraldi@cs.unibo.it]
+* Rich Morin mailto:rdm@cfcl.com[rdm@cfcl.com]
+* Rich Wood mailto:rich@FreeBSD.org.uk[rich@FreeBSD.org.uk]
+* Richard Arends mailto:richard@unixguru.nl[richard@unixguru.nl]
+* Richard Henderson mailto:richard@atheist.tamu.edu[richard@atheist.tamu.edu]
+* Richard Hwang mailto:rhwang@bigpanda.com[rhwang@bigpanda.com]
+* Richard J Kuhns mailto:rjk@watson.grauel.com[rjk@watson.grauel.com]
+* Richard Kiss mailto:richard@homemail.com[richard@homemail.com]
+* Richard M. Neswold mailto:rneswold@enteract.com[rneswold@enteract.com]
+* Richard Stallman mailto:rms@gnu.ai.mit.edu[rms@gnu.ai.mit.edu]
+* Richard Straka mailto:straka@user1.inficad.com[straka@user1.inficad.com]
+* Richard Tobin mailto:richard@cogsci.ed.ac.uk[richard@cogsci.ed.ac.uk]
+* Richard Wackerbarth mailto:rkw@Dataplex.NET[rkw@Dataplex.NET]
+* Richard Winkel mailto:rich@math.missouri.edu[rich@math.missouri.edu]
+* Richard Wiwatowski mailto:rjwiwat@adelaide.on.net[rjwiwat@adelaide.on.net]
+* Rick Fournier mailto:rick@help-desk.ca[rick@help-desk.ca]
+* Rick Macklin
+* Rick van der Zwet mailto:rick@wzoeterwoude.net[rick@wzoeterwoude.net]
+* Rihaz Jerrin mailto:rihaz.jerrin@gmail.com[rihaz.jerrin@gmail.com]
+* Roar Pettersen mailto:roar.pettersen@it.uib.no[roar.pettersen@it.uib.no]
+* Rob Austein mailto:sra@epilogue.com[sra@epilogue.com]
+* Rob Evers mailto:rob@debank.tv[rob@debank.tv]
+* Rob Mallory mailto:rmallory@qualcomm.com[rmallory@qualcomm.com]
+* Rob Snow mailto:rsnow@txdirect.net[rsnow@txdirect.net]
+* Robert Crossfield mailto:robcrossfield@gmail.com[robcrossfield@gmail.com]
+* Robert Crowe mailto:bob@speakez.com[bob@speakez.com]
+* Robert D. Thrush mailto:rd@phoenix.aii.com[rd@phoenix.aii.com]
+* Robert Eckardt mailto:roberte@MEP.Ruhr-Uni-Bochum.de[roberte@MEP.Ruhr-Uni-Bochum.de]
+* Robert Felber mailto:robtone@ek-muc.de[robtone@ek-muc.de]
+* Robert Kruus mailto:rob.kruus@gmail.com[rob.kruus@gmail.com]
+* Robert P Ricci mailto:ricci@cs.utah.edu[ricci@cs.utah.edu]
+* Robert Sanders mailto:rsanders@mindspring.com[rsanders@mindspring.com]
+* Robert Schlotterbeck mailto:robert@rs.tarrant.tx.us[robert@rs.tarrant.tx.us]
+* Robert Sexton mailto:robert@kudra.com[robert@kudra.com]
+* Robert Shady mailto:rls@id.net[rls@id.net]
+* Robert Simmons mailto:rsimmons0@gmail.com[rsimmons0@gmail.com]
+* Robert Swindells mailto:swindellsr@genrad.co.uk[swindellsr@genrad.co.uk]
+* Robert Withrow mailto:witr@rwwa.com[witr@rwwa.com]
+* Robert Yoder
+* Robert Zelaya mailto:rob@theseusnetworking.com[rob@theseusnetworking.com]
+* Roberto Fernandez Cueto mailto:roberfern@gmail.com[roberfern@gmail.com]
+* Robin Carey mailto:robin@mailgate.dtc.rankxerox.co.uk[robin@mailgate.dtc.rankxerox.co.uk]
+* Robin Elfrink mailto:elfrink@introweb.nl[elfrink@introweb.nl]
+* Robin Schilham mailto:co9@xs4all.nl[co9@xs4all.nl]
+* Robin Schoonover mailto:robin.schoonover@gmail.google.com[robin.schoonover@gmail.google.com]
+* Robson Mantovani mailto:robsonmantovani@gmail.com[robsonmantovani@gmail.com]
+* Rod Taylor mailto:ports@rbt.ca[ports@rbt.ca]
+* Rodrigo Graeff mailto:delphus@gmail.com[delphus@gmail.com]
+* Roger Hardiman mailto:roger@cs.strath.ac.uk[roger@cs.strath.ac.uk]
+* Roger Leigh mailto:rleigh@codelibre.net[rleigh@codelibre.net]
+* Roland Jesse mailto:jesse@cs.uni-magdeburg.de[jesse@cs.uni-magdeburg.de]
+* Roland Smith mailto:rsmith@xs4all.nl[rsmith@xs4all.nl]
+* Dr. Rolf Jansen mailto:cyclaero@gmail.com[cyclaero@gmail.com]
+* Roman Neuhauser mailto:neuhauser@chello.cz[neuhauser@chello.cz]
+* Roman Shterenzon mailto:roman@xpert.com[roman@xpert.com]
+* Roman Synyuk mailto:roman@univ.kiev.ua[roman@univ.kiev.ua]
+* Roman V. Palagin mailto:romanp@unshadow.net[romanp@unshadow.net]
+* Roman Y. Bogdanov mailto:sam@brj.pp.ru[sam@brj.pp.ru]
+* Ron Bickers mailto:rbickers@intercenter.net[rbickers@intercenter.net]
+* Ron Lenk mailto:rlenk@widget.xmission.com[rlenk@widget.xmission.com]
+* Ron van Daal mailto:ronvdaal@n1x.nl[ronvdaal@n1x.nl]
+* Ronald F. Guilmette mailto:rfg@monkeys.com[rfg@monkeys.com]
+* Ronald Klop mailto:ronald@echteman.nl[ronald@echteman.nl]
+* Ronald Kuehn mailto:kuehn@rz.tu-clausthal.de[kuehn@rz.tu-clausthal.de]
+* Roselyn Lee mailto:rosel@verniernetworks.com[rosel@verniernetworks.com]
+* Ross West mailto:freebsd@linepoint.com[freebsd@linepoint.com]
+* Rostislav Krasny mailto:rosti.bsd@gmail.com[rosti.bsd@gmail.com]
+* Roy Maples mailto:roy@marples.name[roy@marples.name]
+* Ruben mailto:chromium@hybridsource.org[chromium@hybridsource.org]
+* Rudolf Cejka mailto:cejkar@fit.vutbr.cz[cejkar@fit.vutbr.cz]
+* Rui Lopes mailto:rui@ruilopes.com[rui@ruilopes.com]
+* Ruslan Belkin mailto:rus@home2.UA.net[rus@home2.UA.net]
+* Ruslan Shevchenko mailto:rssh@cam.grad.kiev.ua[rssh@cam.grad.kiev.ua]
+* Russell Jackson mailto:rjackson@cserv62.csub.edu[rjackson@cserv62.csub.edu]
+* Russell L. Carter mailto:rcarter@pinyon.org[rcarter@pinyon.org]
+* Russell Vincent mailto:rv@groa.uct.ac.za[rv@groa.uct.ac.za]
+* Rusty Nejdl mailto:rnejdl@ringofsaturn.com[rnejdl@ringofsaturn.com]
+* Ryan Frederick mailto:ryanrfrederick@gmail.com[ryanrfrederick@gmail.com]
+* Ryan Grove mailto:ryan@wonko.com[ryan@wonko.com]
+* Ryan Moe mailto:ryan@transaeris.com[ryan@transaeris.com]
+* Ryan T. Dean mailto:rtdean@cytherianage.net[rtdean@cytherianage.net]
+* Ryan Thompson mailto:ryan@sasknow.com[ryan@sasknow.com]
+* Ryan Younce mailto:ryany@pobox.com[ryany@pobox.com]
+* Ryo MIYAMOTO mailto:rmiya@cc.hirosaki-u.ac.jp[rmiya@cc.hirosaki-u.ac.jp]
+* Ryo Okamoto mailto:ryo@aquahill.net[ryo@aquahill.net]
+* RyoTa SimaMoto mailto:liangtai.s4@gmail.com[liangtai.s4@gmail.com]
+* Ryuichiro IMURA mailto:imura@af.airnet.ne.jp[imura@af.airnet.ne.jp]
+* SANETO Takanori mailto:sanewo@strg.sony.co.jp[sanewo@strg.sony.co.jp]
+* SASAKI Shunsuke mailto:ele@pop17.odn.ne.jp[ele@pop17.odn.ne.jp]
+* SAWADA Mizuki mailto:miz@qb3.so-net.ne.jp[miz@qb3.so-net.ne.jp]
+* SPF mailto:spf@xslt.cs.nccu.edu.tw[spf@xslt.cs.nccu.edu.tw]
+* SUGIMURA Takashi mailto:sugimura@jp.FreeBSD.org[sugimura@jp.FreeBSD.org]
+* SURANYI Peter mailto:suranyip@jks.is.tsukuba.ac.jp[suranyip@jks.is.tsukuba.ac.jp]
+* Sakai Hiroaki mailto:sakai@miya.ee.kagu.sut.ac.jp[sakai@miya.ee.kagu.sut.ac.jp]
+* Sakari Jalovaara mailto:sja@tekla.fi[sja@tekla.fi]
+* Sam Hartman mailto:hartmans@mit.edu[hartmans@mit.edu]
+* Samee Shahzada mailto:onestsam@gmail.com[onestsam@gmail.com]
+* Samuel Lam mailto:skl@ScalableNetwork.com[skl@ScalableNetwork.com]
+* Samuel Tardieu mailto:sam@rfc1149.net[sam@rfc1149.net]
+* Samuele Zannoli mailto:zannoli@cs.unibo.it[zannoli@cs.unibo.it]
+* Samy Al Bahra mailto:samy@kerneled.com[samy@kerneled.com]
+* Sander Janssen mailto:janssen@rendo.dekooi.nl[janssen@rendo.dekooi.nl]
+* Sander Vesik mailto:sander@haldjas.folklore.ee[sander@haldjas.folklore.ee]
+* Sandro Sigala mailto:ssigala@globalnet.it[ssigala@globalnet.it]
+* Sarod Yatawatta mailto:sarod@users.sf.net[sarod@users.sf.net]
+* Sascha Biberhofer mailto:ports@skyforge.at[ports@skyforge.at]
+* Sascha Blank mailto:blank@fox.uni-trier.de[blank@fox.uni-trier.de]
+* Sascha Holzleiter mailto:sascha@root-login.org[sascha@root-login.org]
+* Sascha Klauder mailto:sklauder@trimind.de[sklauder@trimind.de]
+* Sascha Wildner mailto:swildner@channelz.GUN.de[swildner@channelz.GUN.de]
+* Satoh Junichi mailto:junichi@astec.co.jp[junichi@astec.co.jp]
+* Saulius Menkevicius mailto:bob@nulis.lt[bob@nulis.lt]
+* Scot Elliott mailto:scot@poptart.org[scot@poptart.org]
+* Scot W. Hetzel mailto:hetzels@westbend.net[hetzels@westbend.net]
+* Scott A. Kenney mailto:saken@rmta.ml.org[saken@rmta.ml.org]
+* Scott A. Moberly mailto:smoberly@xavier.dyndns.org[smoberly@xavier.dyndns.org]
+* Scott Blachowicz mailto:scott.blachowicz@seaslug.org[scott.blachowicz@seaslug.org]
+* Scott Burris mailto:scott@pita.cns.ucla.edu[scott@pita.cns.ucla.edu]
+* Scott Flatman mailto:sf@slappy.org[sf@slappy.org]
+* Scott Hazen Mueller mailto:scott@zorch.sf-bay.org[scott@zorch.sf-bay.org]
+* Scott Kleihege mailto:scott-ports@tummy.com[scott-ports@tummy.com]
+* Scott Lambert mailto:lambert@lambertfam.org[lambert@lambertfam.org]
+* Scott Michel mailto:scottm@cs.ucla.edu[scottm@cs.ucla.edu]
+* Scott Reynolds mailto:scott@clmqt.marquette.mi.us[scott@clmqt.marquette.mi.us]
+* Scott Ullrich mailto:sullrich@gmail.com[sullrich@gmail.com]
+* SeaD mailto:sead@mail.ru[sead@mail.ru]
+* Sean McLaughlin mailto:sigma.zx@gmail.com[sigma.zx@gmail.com]
+* Seamus Venasse mailto:svenasse@polaris.ca[svenasse@polaris.ca]
+* Sébastian Santoro mailto:dereckson@gmail.com[dereckson@gmail.com]
+* Sebastian Schwarz mailto:seschwar@gmail.com[seschwar@gmail.com]
+* Sebastian Strollo mailto:seb@erix.ericsson.se[seb@erix.ericsson.se]
+* Sebastian Yepes mailto:esn@x123.info[esn@x123.info]
+* Seiya Yanagita mailto:s_yanagita@ybb.ne.jp[s_yanagita@ybb.ne.jp]
+* Serge Gagnon mailto:gagnon_s@sympatico.ca[gagnon_s@sympatico.ca]
+* Serge Negodyuck mailto:petr@petrovich.kiev.ua[petr@petrovich.kiev.ua]
+* Serge V. Vakulenko mailto:vak@zebub.msk.su[vak@zebub.msk.su]
+* Sergei Chechetkin mailto:csl@whale.sunbay.crimea.ua[csl@whale.sunbay.crimea.ua]
+* Sergei S. Laskavy mailto:laskavy@pc759.cs.msu.su[laskavy@pc759.cs.msu.su]
+* Sergei Vyshenski mailto:svysh.fbsd@gmail.com[svysh.fbsd@gmail.com]
+* Sergey Akhmatov mailto:sergey@akhmatov.ru[sergey@akhmatov.ru]
+* Sergey Akifyev mailto:asa@gascom.ru[asa@gascom.ru]
+* Sergey Anohin mailto:admin@5034.ru[admin@5034.ru]
+* Sergey V. Dyatko mailto:sergey.dyatko@gmail.com[sergey.dyatko@gmail.com]
+* Sergey Gershtein mailto:sg@mplik.ru[sg@mplik.ru]
+* Sergey Glushchenko mailto:deen@smz.com.ua[deen@smz.com.ua]
+* Sergey Kosyakov mailto:ks@itp.ac.ru[ks@itp.ac.ru]
+* Sergey Lyubka mailto:valenok@gmail.com[valenok@gmail.com]
+* Sergey Matveev mailto:stargrave@stargrave.org[stargrave@stargrave.org]
+* Sergey N. Vorokov mailto:serg@tmn.ru[serg@tmn.ru]
+* Sergey Potapov mailto:sp@alkor.ru[sp@alkor.ru]
+* Sergey Samoyloff mailto:gonza@techline.ru[gonza@techline.ru]
+* Sergey Shkonda mailto:serg@bcs.zp.ua[serg@bcs.zp.ua]
+* Sergey V. Dorokhov mailto:svd@kbtelecom.nalnet.ru[svd@kbtelecom.nalnet.ru]
+* Sergey Velichkevych mailto:serg@cad.kiev.ua[serg@cad.kiev.ua]
+* Sergio Lenzi mailto:lenzi@bsi.com.br[lenzi@bsi.com.br]
+* Serguei Okladnikov mailto:oklaspec@gmail.com[oklaspec@gmail.com]
+* Shane Ambler mailto:freebsd@shaneware.biz[freebsd@shaneware.biz]
+* Shane Kinney mailto:mod6@freebsdhackers.net[mod6@freebsdhackers.net]
+* Shaun Courtney mailto:shaun@emma.eng.uct.ac.za[shaun@emma.eng.uct.ac.za]
+* Shawn M. Carey mailto:smcarey@mailbox.syr.edu[smcarey@mailbox.syr.edu]
+* Shell Hung mailto:shell@shellhung.org[shell@shellhung.org]
+* Shen Chuan-Hsing mailto:statue@freebsd.sinica.edu.tw[statue@freebsd.sinica.edu.tw]
+* Shigeru Yamamoto mailto:shigeru@iij.ad.jp[shigeru@iij.ad.jp]
+* Shigio Yamaguchi mailto:shigio@tamacom.com[shigio@tamacom.com]
+* Shin'ya Murakami mailto:murakami@ahs.scitec.kobe-u.ac.jp[murakami@ahs.scitec.kobe-u.ac.jp]
+* Shinichiro Komatsu mailto:koma2@ms.u-tokyo.ac.jp[koma2@ms.u-tokyo.ac.jp]
+* Shinsuke Matsui mailto:smatsui@karashi.org[smatsui@karashi.org]
+* Shinya Esu mailto:esu@yk.rim.or.jp[esu@yk.rim.or.jp]
+* Shinya FUJIE mailto:fujie@tk.elec.waseda.ac.jp[fujie@tk.elec.waseda.ac.jp]
+* Shuichi Tanaka mailto:stanaka@bb.mbn.or.jp[stanaka@bb.mbn.or.jp]
+* Siebrand Mazeland mailto:s.mazeland@xs4all.nl[s.mazeland@xs4all.nl]
+* Sijmen J. Mulder mailto:ik@sjmulder.nl[ik@sjmulder.nl]
+* Silvio Ap Silva mailto:alvolivre@live.com[alvolivre@live.com]
+* Simeon Simeonov mailto:sgs@pichove.org[sgs@pichove.org]
+* Simon mailto:simon@masi.ibp.fr[simon@masi.ibp.fr]
+* Simon Burge mailto:simonb@telstra.com.au[simonb@telstra.com.au]
+* Simon Cornelius P. Umacob mailto:simoncpu@infoweapons.com[simoncpu@infoweapons.com]
+* Simon Dick mailto:simond@irrelevant.org[simond@irrelevant.org]
+* Simon Lang mailto:simon@lang-clan.de[simon@lang-clan.de]
+* Simon Marlow mailto:simonmar@microsoft.com[simonmar@microsoft.com]
+* Simon Olofsson mailto:simon@olofsson.de[simon@olofsson.de]
+* Simon Peter mailto:probono@puredarwin.org[probono@puredarwin.org]
+* Simon Schubert mailto:corecode@corecode.ath.cx[corecode@corecode.ath.cx]
+* Simon Shapiro mailto:shimon@simon-shapiro.org[shimon@simon-shapiro.org]
+* Simun Mikecin mailto:numisemis@yahoo.com[numisemis@yahoo.com]
+* Sin'ichiro MIYATANI mailto:siu@phaseone.co.jp[siu@phaseone.co.jp]
+* Slaven Rezic mailto:slaven@rezic.de[slaven@rezic.de]
+* Snow Chyld mailto:snowchyld+freebsdports@gmail.com[snowchyld+freebsdports@gmail.com]
+* Soochon Radee mailto:slr@mitre.org[slr@mitre.org]
+* Soren Dayton mailto:csdayton@midway.uchicago.edu[csdayton@midway.uchicago.edu]
+* Soren Debois mailto:debois@diku.dk[debois@diku.dk]
+* Soren Dossing mailto:sauber@netcom.com[sauber@netcom.com]
+* Soren S. Jorvang mailto:soren@wheel.dk[soren@wheel.dk]
+* Stan Barber mailto:sob@academ.com[sob@academ.com]
+* Stanislav A. Svirid mailto:count@riss-telecom.ru[count@riss-telecom.ru]
+* Stanislav Grozev mailto:tacho@daemonz.org[tacho@daemonz.org]
+* Stanislaw Halik mailto:sthalik@tehran.lain.pl[sthalik@tehran.lain.pl]
+* Stanislav Shalunov mailto:shalunov@internet2.edu[shalunov@internet2.edu]
+* Stas Timokhin mailto:devel@stasyan.com[devel@stasyan.com]
+* Stefan A. Deutscher mailto:sad@mailaps.org[sad@mailaps.org]
+* Stefan Eggers mailto:seggers@semyam.dinoco.de[seggers@semyam.dinoco.de]
+* Stefan Ehmann mailto:shoesoft@gmx.net[shoesoft@gmx.net]
+* Stefan Grundmann mailto:sg-sendpr@waset.de[sg-sendpr@waset.de]
+* Stefan Jahn mailto:stefan.jahn@nemesis-sektor.de[stefan.jahn@nemesis-sektor.de]
+* Stefan Lambrev mailto:cheffo@freebsd-bg.org[cheffo@freebsd-bg.org]
+* Stefan Moeding mailto:s.moeding@ndh.net[s.moeding@ndh.net]
+* Stefan Petri
+* Stefan Rumetshofer mailto:sterum@overrider.at[sterum@overrider.at]
+* Stefan Schmidt mailto:stefan.schmidt@twest.de[stefan.schmidt@twest.de]
+* Stefan Schwarzer mailto:sschwarzer@sschwarzer.net[sschwarzer@sschwarzer.net]
+* Stefan Tell mailto:stefan.tell@crashmail.de[stefan.tell@crashmail.de]
+* Stefan `Sec` Zehl mailto:sec@42.org[sec@42.org]
+* Steffen Fritz mailto:steffen@fritz.wtf[steffen@fritz.wtf]
+* Steffen Mazanek mailto:steffen.mazanek@unibw-muenchen.de[steffen.mazanek@unibw-muenchen.de]
+* Steffen Vogelreuter mailto:Steffen@Vogelreuter.De[Steffen@Vogelreuter.De]
+* Steinar Haug mailto:sthaug@nethelp.no[sthaug@nethelp.no]
+* Sten Poldma mailto:exile@chamber.ee[exile@chamber.ee]
+* Sten Spans mailto:sten@blinkenlights.nl[sten@blinkenlights.nl]
+* Stepan Zastupov mailto:redchrom@gmail.com[redchrom@gmail.com]
+* Stephane Lapie mailto:stephane.lapie@darkbsd.org[stephane.lapie@darkbsd.org]
+* Stephen Clawson mailto:sclawson@marker.cs.utah.edu[sclawson@marker.cs.utah.edu]
+* Stephen F. Combs mailto:combssf@salem.ge.com[combssf@salem.ge.com]
+* Stephen Farrell mailto:stephen@farrell.org[stephen@farrell.org]
+* Stephen Fisher mailto:stephentfisher@yahoo.com[stephentfisher@yahoo.com]
+* Stephen Gunn mailto:csg@fedex.com[csg@fedex.com]
+* Stephen Hocking mailto:sysseh@devetir.qld.gov.au[sysseh@devetir.qld.gov.au]
+* Stephen J. Roznowski mailto:sjr@home.net[sjr@home.net]
+* Stephen McKay mailto:syssgm@devetir.qld.gov.au[syssgm@devetir.qld.gov.au]
+* Stephen Melvin mailto:melvin@zytek.com[melvin@zytek.com]
+* Stephen Weeks mailto:sweeks@sweeks.com[sweeks@sweeks.com]
+* Stephon Chen mailto:stephon@gmail.com[stephon@gmail.com]
+* Steve Ames mailto:steve@energistic.com[steve@energistic.com]
+* Steve Bauer mailto:sbauer@rock.sdsmt.edu[sbauer@rock.sdsmt.edu]
+* Steve Coltrin mailto:spcoltri@unm.edu[spcoltri@unm.edu]
+* Steve Deering
+* Steve Franks mailto:bahamasfranks@gmail.com[bahamasfranks@gmail.com]
+* Steve Gerakines mailto:steve2@genesis.tiac.net[steve2@genesis.tiac.net]
+* Steve Gericke mailto:steveg@comtrol.com[steveg@comtrol.com]
+* Steve O'Hara-Smith mailto:steve@sohara.org[steve@sohara.org]
+* Steve Piette mailto:steve@simon.chi.il.US[steve@simon.chi.il.US]
+* Steve Roome mailto:steve@pepcross.com[steve@pepcross.com]
+* Steve Schwarz mailto:schwarz@alpharel.com[schwarz@alpharel.com]
+* Steven Enderle mailto:panic@subphase.de[panic@subphase.de]
+* Steven H. Samorodin mailto:samorodi@NUXI.com[samorodi@NUXI.com]
+* Steven Hartland mailto:steven.hartland@multiplay.co.uk[steven.hartland@multiplay.co.uk]
+* Steven Honson mailto:steven@honson.org[steven@honson.org]
+* Steven McCanne mailto:mccanne@cs.berkeley.edu[mccanne@cs.berkeley.edu]
+* Steven Plite mailto:splite@purdue.edu[splite@purdue.edu]
+* Steven Wallace
+* Stig Inge Lea Bjørnsen mailto:stiginge@pvv.org[stiginge@pvv.org]
+* Stijn Hoop mailto:stijn@win.tue.nl[stijn@win.tue.nl]
+* Stuart Henderson mailto:stuart@internationalschool.co.uk[stuart@internationalschool.co.uk]
+* Stylianos Sideridis mailto:siderste@yahoo.gr[siderste@yahoo.gr]
+* Sue Blake mailto:sue@welearn.com.au[sue@welearn.com.au]
+* Sugimoto Sadahiro mailto:ixtl@komaba.utmc.or.jp[ixtl@komaba.utmc.or.jp]
+* Sugiura Shiro mailto:ssugiura@duo.co.jp[ssugiura@duo.co.jp]
+* Sujal Patel mailto:smpatel@wam.umd.edu[smpatel@wam.umd.edu]
+* Sulev-Madis Silber mailto:madis555@hot.ee[madis555@hot.ee]
+* Sune Stjerneby mailto:sst@vmunix.dk[sst@vmunix.dk]
+* Sungman Cho mailto:smcho@tsp.korea.ac.kr[smcho@tsp.korea.ac.kr]
+* Sutra Zhou mailto:zhoushuqun@gmail.com[zhoushuqun@gmail.com]
+* Suzuki Yoshiaki mailto:zensyo@ann.tama.kawasaki.jp[zensyo@ann.tama.kawasaki.jp]
+* Svein Skogen mailto:tds@dmnstech.net[tds@dmnstech.net]
+* Sven Klose mailto:pixel@hugbox.org[pixel@hugbox.org]
+* Sven Mohr mailto:svmohr@rm6.net[svmohr@rm6.net]
+* Svyatoslav Lempert mailto:svyatoslav.lempert@gmail.com[svyatoslav.lempert@gmail.com]
+* Sybolt de Boer mailto:bolt@xs4all.nl[bolt@xs4all.nl]
+* TAKAHASHI Kaoru mailto:kaoru@kaisei.org[kaoru@kaisei.org]
+* TERAMOTO Masahiro mailto:markun@onohara.to[markun@onohara.to]
+* Tadashi Kumano mailto:kumano@strl.nhk.or.jp[kumano@strl.nhk.or.jp]
+* Taguchi Takeshi mailto:taguchi@tohoku.iij.ad.jp[taguchi@tohoku.iij.ad.jp]
+* Takahiro Yugawa mailto:yugawa@orleans.rim.or.jp[yugawa@orleans.rim.or.jp]
+* Takashi Mega mailto:mega@minz.org[mega@minz.org]
+* Takashi Uozu mailto:j1594016@ed.kagu.sut.ac.jp[j1594016@ed.kagu.sut.ac.jp]
+* Takayuki Ariga mailto:a00821@cc.hc.keio.ac.jp[a00821@cc.hc.keio.ac.jp]
+* Takayuki Nakao mailto:t@nakao.org[t@nakao.org]
+* Takeru NAIKI mailto:naiki@bfd.es.hokudai.ac.jp[naiki@bfd.es.hokudai.ac.jp]
+* Takeshi Amaike mailto:amaike@iri.co.jp[amaike@iri.co.jp]
+* Takeshi MUTOH mailto:mutoh@info.nara-k.ac.jp[mutoh@info.nara-k.ac.jp]
+* Takeshi Ohashi mailto:ohashi@mickey.ai.kyutech.ac.jp[ohashi@mickey.ai.kyutech.ac.jp]
+* Takeshi WATANABE mailto:watanabe@crayon.earth.s.kobe-u.ac.jp[watanabe@crayon.earth.s.kobe-u.ac.jp]
+* Takuya SHIOZAKI mailto:tshiozak@makino.ise.chuo-u.ac.jp[tshiozak@makino.ise.chuo-u.ac.jp]
+* Talal Al Dik mailto:tad@vif.com[tad@vif.com]
+* Tanja Wittke mailto:tawi@gruft.de[tawi@gruft.de]
+* Tarasov Alexey mailto:master@preved.cn[master@preved.cn]
+* Tassilo Philipp mailto:tphilipp@potion-studios.com[tphilipp@potion-studios.com]
+* Tatoku Ogaito mailto:tacha@tera.fukui-med.ac.jp[tacha@tera.fukui-med.ac.jp]
+* Tatsuki Makino mailto:tatsuki_makino@hotmail.com[tatsuki_makino@hotmail.com]
+* Tatsuya Kudoh mailto:cdr@cosmonet.org[cdr@cosmonet.org]
+* Tatsuya Ueda mailto:ml+freebsd@tatsuya.info[ml+freebsd@tatsuya.info]
+* Taylor Dondich mailto:tdondich@majiknetworks.com[tdondich@majiknetworks.com]
+* Ted Buswell mailto:tbuswell@mediaone.net[tbuswell@mediaone.net]
+* Ted Faber mailto:faber@isi.edu[faber@isi.edu]
+* Ted Lemon mailto:mellon@isc.org[mellon@isc.org]
+* Ted Stodgell mailto:trs137@psu.edu[trs137@psu.edu]
+* Teodor Sigaev mailto:teodor@sigaev.ru[teodor@sigaev.ru]
+* Terry Lambert mailto:terry@lambert.org[terry@lambert.org]
+* Terry Lee mailto:terry@uivlsi.csl.uiuc.edu[terry@uivlsi.csl.uiuc.edu]
+* Terry Sposato mailto:terry@sucked-in.com[terry@sucked-in.com]
+* Teruaki Ata mailto:PFA03027@nifty.ne.jp[PFA03027@nifty.ne.jp]
+* Tetsuro Yabu mailto:yabu@uopmu.ees.osakafu-u.ac.jp[yabu@uopmu.ees.osakafu-u.ac.jp]
+* Tetsuya Furukawa mailto:tetsuya@secom-sis.co.jp[tetsuya@secom-sis.co.jp]
+* Thaddeus Covert mailto:tcovert+ports@sahuagin.net[tcovert+ports@sahuagin.net]
+* Theo de Raadt mailto:deraadt@OpenBSD.org[deraadt@OpenBSD.org]
+* Thierry Dussuet mailto:thierry@dussuet.lugs.ch[thierry@dussuet.lugs.ch]
+* Thomas mailto:thomas@mathematik.uni-Bremen.de[thomas@mathematik.uni-Bremen.de]
+* Thomas A. Stephens mailto:tas@stephens.org[tas@stephens.org]
+* Thomas Bartelmess mailto:thomas@bartelmess.io[thomas@bartelmess.io]
+* Thomas BRETON mailto:tom@h-inventory.com[tom@h-inventory.com]
+* Thomas Cort mailto:linuxgeek@gmail.com[linuxgeek@gmail.com]
+* Thomas D. Dean mailto:tomdean@ix.netcom.com[tomdean@ix.netcom.com]
+* Thomas David Rivers mailto:rivers@dignus.com[rivers@dignus.com]
+* Thomas Dreibholz mailto:dreibh@iem.uni-due.de[dreibh@iem.uni-due.de]
+* Thomas G. McWilliams mailto:tgm@netcom.com[tgm@netcom.com]
+* Thomas Hurst mailto:tom@hur.st[tom@hur.st]
+* Thomas Kempka mailto:t.kempka@web.de[t.kempka@web.de]
+* Thomas König mailto:Thomas.Koenig@ciw.uni-karlsruhe.de[Thomas.Koenig@ciw.uni-karlsruhe.de]
+* Thomas M. Hermann mailto:Thomas.Hermann@cox.net[Thomas.Hermann@cox.net]
+* Thomas Melzer mailto:tmelzer@tomesoft.de[tmelzer@tomesoft.de]
+* Thomas Ptacek
+* Thomas Spreng mailto:spreng@socket.ch[spreng@socket.ch]
+* Thomas Stromberg mailto:tstrombe@rtci.com[tstrombe@rtci.com]
+* Thomas Valentino Crimi mailto:tcrimi+@andrew.cmu.edu[tcrimi+@andrew.cmu.edu]
+* Thomas Vogt mailto:thomas.vogt@bsdunix.ch[thomas.vogt@bsdunix.ch]
+* Thorsten Greiner mailto:thorsten@tgreiner.net[thorsten@tgreiner.net]
+* Þórður Ívarsson mailto:totii@est.is[totii@est.is]
+* Tillman Hodgson mailto:tillman@seekingfire.com[tillman@seekingfire.com]
+* Tim Daneliuk mailto:tundra@tundraware.com[tundra@tundraware.com]
+* Tim Hemel mailto:tim@n2it.net[tim@n2it.net]
+* Tim Little mailto:tim@wallago.co.uk[tim@wallago.co.uk]
+* Tim Niemueller mailto:tim@niemueller.de[tim@niemueller.de]
+* Tim Pozar mailto:pozar@lns.com[pozar@lns.com]
+* Tim Singletary mailto:tsingle@sunland.gsfc.nasa.gov[tsingle@sunland.gsfc.nasa.gov]
+* Tim Welch mailto:ports@thepentagon.org[ports@thepentagon.org]
+* Tim Wilkinson mailto:tim@sarc.city.ac.uk[tim@sarc.city.ac.uk]
+* Timo J. Rinne mailto:tri@iki.fi[tri@iki.fi]
+* Timofeev Vladimir mailto:vovkasm@gmail.com[vovkasm@gmail.com]
+* Timothy Beyer mailto:beyert@cs.ucr.edu[beyert@cs.ucr.edu]
+* Timothy Bourke mailto:timbob@bigpond.com[timbob@bigpond.com]
+* Timothy Jensen mailto:toast@blackened.com[toast@blackened.com]
+* Timothy Redaelli mailto:drizzt@drizzt.ath.cx[drizzt@drizzt.ath.cx]
+* Ting-Wei Lan mailto:lantw44@gmail.com[lantw44@gmail.com]
+* Tobias Begalke mailto:tobega@spyz.org[tobega@spyz.org]
+* Tobias Reifenberger mailto:treif@mayn.de[treif@mayn.de]
+* Tobias Roth mailto:ports@fsck.ch[ports@fsck.ch]
+* Toby Allsopp mailto:toby@mi6.gen.nz[toby@mi6.gen.nz]
+* Todd Miller mailto:millert@openbsd.org[millert@openbsd.org]
+* Todd Mortensen mailto:todd@thisisa.com[todd@thisisa.com]
+* Tofig Suleymanov mailto:tofig@freebsd.az[tofig@freebsd.az]
+* Tom mailto:root@majestix.cmr.no[root@majestix.cmr.no]
+* Tom Carrick mailto:knyghtmare@knyghtmare.com[knyghtmare@knyghtmare.com]
+* Tom Gray - DCA mailto:dcasba@rain.org[dcasba@rain.org]
+* Tom Jobbins mailto:tom@tom.tj[tom@tom.tj]
+* Tom Mortensen mailto:tom@tavrasm.org[tom@tavrasm.org]
+* Tom Mueller-Kortkamp mailto:tmueko@kommunity.net[tmueko@kommunity.net]
+* Tom Pusateri mailto:pusateri@juniper.net[pusateri@juniper.net]
+* Tom Rush mailto:tarush@mindspring.com[tarush@mindspring.com]
+* Tom Samplonius mailto:tom@misery.sdf.com[tom@misery.sdf.com]
+* Tomas Verbaitis mailto:tomasv@megalogika.lt[tomasv@megalogika.lt]
+* Tomasz Walaszek mailto:tmwalaszek@gmail.com[tmwalaszek@gmail.com]
+* Tomaž Muraus mailto:kami@k5-storitve.net[kami@k5-storitve.net]
+* Tomek Cedro mailto:tomek.cedro@gmail.com[tomek.cedro@gmail.com]
+* Tomohiko Kurahashi mailto:kura@melchior.q.t.u-tokyo.ac.jp[kura@melchior.q.t.u-tokyo.ac.jp]
+* Tomoyuki Sakurai mailto:cherry@trombik.org[cherry@trombik.org]
+* Toni Andjelkovic mailto:toni@soth.at[toni@soth.at]
+* Toni Gundogdu mailto:legatvs@gmail.com[legatvs@gmail.com]
+* Toni Viemero mailto:toni.viemero@iki.fi[toni.viemero@iki.fi]
+* Tony Kimball mailto:alk@Think.COM[alk@Think.COM]
+* Tony Li mailto:tli@jnx.com[tli@jnx.com]
+* Tony Lynn mailto:wing@cc.nsysu.edu.tw[wing@cc.nsysu.edu.tw]
+* Tony Maher mailto:tonym@biolateral.com.au[tonym@biolateral.com.au]
+* Tony Shadwick mailto:numbski@hksilver.net[numbski@hksilver.net]
+* Tor Halvard "Squat" Furulund mailto:squat@squat.no[squat@squat.no]
+* Torbjorn Granlund mailto:tege@matematik.su.se[tege@matematik.su.se]
+* Toshiharu Ohno mailto:tony-o@iij.ad.jp[tony-o@iij.ad.jp]
+* Toshihiko SHIMOKAWA mailto:toshi@tea.forus.or.jp[toshi@tea.forus.or.jp]
+* Toshihiro Kanda mailto:candy@kgc.co.jp[candy@kgc.co.jp]
+* Toshiomi Moriki mailto:Toshiomi.Moriki@ma1.seikyou.ne.jp[Toshiomi.Moriki@ma1.seikyou.ne.jp]
+* Toshiya SAITOH mailto:toshiya@saitoh.nu[toshiya@saitoh.nu]
+* Travis Campbell mailto:hcoyote@ghostar.org[hcoyote@ghostar.org]
+* Travis Poppe mailto:tlp@liquidx.org[tlp@liquidx.org]
+* Trefor S. mailto:trefor@flevel.co.uk[trefor@flevel.co.uk]
+* Trenton Schulz mailto:twschulz@cord.edu[twschulz@cord.edu]
+* Trevor Blackwell mailto:tlb@viaweb.com[tlb@viaweb.com]
+* Trevor Cornpropst mailto:tcornpropst@cox.net[tcornpropst@cox.net]
+* Trober mailto:trober@trober.com[trober@trober.com]
+* Troels Kofoed Jacobsen mailto:tkjacobsen@gmail.com[tkjacobsen@gmail.com]
+* Tsung-Han Yeh mailto:snowfly@yuntech.edu.tw[snowfly@yuntech.edu.tw]
+* Tz-Huan Huang mailto:tzhuan@gmail.com[tzhuan@gmail.com]
+* Tzanetos Balitsaris mailto:tzabal@it.teithe.gr[tzabal@it.teithe.gr]
+* UMENO Takashi mailto:umeno@rr.iij4u.or.jp[umeno@rr.iij4u.or.jp]
+* URATA Shuichiro mailto:s-urata@nmit.tmg.nec.co.jp[s-urata@nmit.tmg.nec.co.jp]
+* Udo Schweigert mailto:udo.schweigert@siemens.com[udo.schweigert@siemens.com]
+* Uffe Jakobsen mailto:uffe@uffe.org[uffe@uffe.org]
+* Ugo Paternostro mailto:paterno@dsi.unifi.it[paterno@dsi.unifi.it]
+* Ulf Kieber mailto:kieber@sax.de[kieber@sax.de]
+* Ulli Linzen mailto:ulli@perceval.camelot.de[ulli@perceval.camelot.de]
+* Ullrich Franke mailto:trash.esiac@googlemail.com[trash.esiac@googlemail.com]
+* Uwe Arndt mailto:arndt@mailhost.uni-koblenz.de[arndt@mailhost.uni-koblenz.de]
+* Uwe Pierau mailto:uwe.pierau@tu-clausthal.de[uwe.pierau@tu-clausthal.de]
+* Vaggelis Typaldos mailto:frances@mylannet.gr[frances@mylannet.gr]
+* Vadim Belman mailto:voland@catpipe.net[voland@catpipe.net]
+* Vadim Chekan mailto:vadim@gc.lviv.ua[vadim@gc.lviv.ua]
+* Vadim Goncharov mailto:vadim_nuclight@mail.ru[vadim_nuclight@mail.ru]
+* Vadim Kolontsov mailto:vadim@tversu.ac.ru[vadim@tversu.ac.ru]
+* Vadim Kurland mailto:vadim@fwbuilder.org[vadim@fwbuilder.org]
+* Vadim Mikhailov mailto:mvp@braz.ru[mvp@braz.ru]
+* Vaida Bogdan mailto:vaida.bogdan@gmail.com[vaida.bogdan@gmail.com]
+* Vaidas Zlotkus mailto:r2@music.lt[r2@music.lt]
+* Valentin Nechayev mailto:netch@lucky.net[netch@lucky.net]
+* Valentin Zahariev mailto:curly@e-card.bg[curly@e-card.bg]
+* Valery Komarov mailto:komarov@valerka.net[komarov@valerka.net]
+* Van Jacobson mailto:van@ee.lbl.gov[van@ee.lbl.gov]
+* Vany Serezhkin mailto:ivan@serezhkin.com[ivan@serezhkin.com]
+* Vaclav Haisman mailto:v.haisman@sh.cvut.cz[v.haisman@sh.cvut.cz]
+* Vasek Balcar mailto:vasek@ti.cz[vasek@ti.cz]
+* Vasily V. Grechishnikov mailto:bazilio@ns1.ied-vorstu.ac.ru[bazilio@ns1.ied-vorstu.ac.ru]
+* Vasim Valejev mailto:vasim@uddias.diaspro.com[vasim@uddias.diaspro.com]
+* Vassili Tchersky mailto:vt@bsd-fr.org[vt@bsd-fr.org]
+* Vernon J. Schryver mailto:vjs@mica.denver.sgi.com[vjs@mica.denver.sgi.com]
+* Veselin Slavov mailto:vess@btc.net[vess@btc.net]
+* Viacheslav Mikerov mailto:SlavaMikerov@gmail.com[SlavaMikerov@gmail.com]
+* Vic Abell mailto:abe@cc.purdue.edu[abe@cc.purdue.edu]
+* Victor Cruceru mailto:victor.cruceru@gmail.com[victor.cruceru@gmail.com]
+* Victor Popov mailto:v.a.popov@gmail.com[v.a.popov@gmail.com]
+* Victor Semionov mailto:semionov@mail.bg[semionov@mail.bg]
+* Vidar Karlsen mailto:vidar@karlsen.tech[vidar@karlsen.tech]
+* Viktor Fomichev mailto:vfom@narod.ru[vfom@narod.ru]
+* Ville Eerola mailto:ve@sci.fi[ve@sci.fi]
+* Vince Valenti mailto:vince@blue-box.net[vince@blue-box.net]
+* Vincent DEFERT mailto:20.100@defert.com[20.100@defert.com]
+* Vincent Poy mailto:vince@DNALOGIC.NET[vince@DNALOGIC.NET]
+* Vincent Tantardini mailto:vinc@freebsd-fr.org[vinc@freebsd-fr.org]
+* Vincenzo Capuano mailto:VCAPUANO@vmprofs.esoc.esa.de[VCAPUANO@vmprofs.esoc.esa.de]
+* Virgil Champlin mailto:champlin@pa.dec.com[champlin@pa.dec.com]
+* Vitaly Magerya mailto:vmagerya@gmail.com[vmagerya@gmail.com]
+* Vivek Khera mailto:vivek@khera.org[vivek@khera.org]
+* Vlad GALU mailto:dudu@dudu.ro[dudu@dudu.ro]
+* Vlad V. Teterya mailto:vlad@vlad.uz.ua[vlad@vlad.uz.ua]
+* Vladimir A. Jakovenko mailto:vovik@ntu-kpi.kiev.ua[vovik@ntu-kpi.kiev.ua]
+* Vladimir Chukharev mailto:vladimir.chukharev@gmail.com[vladimir.chukharev@gmail.com]
+* Vladimir Gorelov mailto:virtual.lark@gmail.com[virtual.lark@gmail.com]
+* Vladimir Kurtikov mailto:vk@vk.pp.ru[vk@vk.pp.ru]
+* Vladimir Kushnir mailto:kushn@mail.kar.net[kushn@mail.kar.net]
+* Vladimir Osintsev mailto:oc@nm.ru[oc@nm.ru]
+* Vladimir Savichev mailto:vlad@ariel.phys.wesleyan.edu[vlad@ariel.phys.wesleyan.edu]
+* Volker Theile mailto:votdev@gmx.de[votdev@gmx.de]
+* Volker Quetschke mailto:quetschke@scytek.de[quetschke@scytek.de]
+* Volodymyr Kostyrko mailto:c.kworr@gmail.com[c.kworr@gmail.com]
+* Vsevolod Lobko mailto:seva@ip.net.ua[seva@ip.net.ua]
+* Vyacheslav Anikin mailto:ghos@mail.ru[ghos@mail.ru]
+* Vyacheslav Ivanchenko mailto:ivi@dhs.net.ru[ivi@dhs.net.ru]
+* W. Gerald Hicks mailto:wghicks@bellsouth.net[wghicks@bellsouth.net]
+* W. Richard Stevens mailto:rstevens@noao.edu[rstevens@noao.edu]
+* Waitman Gobble mailto:waitman@waitman.net[waitman@waitman.net]
+* Walt Howard mailto:howard@ee.utah.edu[howard@ee.utah.edu]
+* Walt M. Shandruk mailto:walt@erudition.net[walt@erudition.net]
+* Walter Hop mailto:walter@binity.com[walter@binity.com]
+* Walter Venable mailto:weaseal@hotmail.com[weaseal@hotmail.com]
+* Warren Toomey mailto:wkt@csadfa.cs.adfa.oz.au[wkt@csadfa.cs.adfa.oz.au]
+* Watanabe Kazuhiro mailto:CQG00620@nifty.ne.jp[CQG00620@nifty.ne.jp]
+* Wayne Scott mailto:wscott@ichips.intel.com[wscott@ichips.intel.com]
+* Wei-Hao Syu mailto:whsyu@arbor.ee.ntu.edu.tw[whsyu@arbor.ee.ntu.edu.tw]
+* Wei-Yu Chen mailto:weiyu.csie@gmail.com[weiyu.csie@gmail.com]
+* Wendell Borges mailto:perlporter@gmail.com[perlporter@gmail.com]
+* Wei Guo mailto:darcsis@gmail.com[darcsis@gmail.com]
+* Wei Zhao mailto:amutu@amutu.com[amutu@amutu.com]
+* Werner Griessl mailto:werner@btp1da.phy.uni-bayreuth.de[werner@btp1da.phy.uni-bayreuth.de]
+* Wes Santee mailto:wsantee@wsantee.oz.net[wsantee@wsantee.oz.net]
+* Wietse Venema mailto:wietse@wzv.win.tue.nl[wietse@wzv.win.tue.nl]
+* Wiljo Heinen mailto:wiljo@freeside.ki.open.de[wiljo@freeside.ki.open.de]
+* Willem Jan Withagen mailto:wjw@withagen.nl[wjw@withagen.nl]
+* Willem van Engen mailto:wvengen@stack.nl[wvengen@stack.nl]
+* William Jolitz mailto:withheld[withheld]
+* William Josephson mailto:wkj-freebsd@honk.eecs.harvard.edu[wkj-freebsd@honk.eecs.harvard.edu]
+* William Liao mailto:william@tale.net[william@tale.net]
+* Wojtek Pilorz mailto:wpilorz@celebris.bdk.lublin.pl[wpilorz@celebris.bdk.lublin.pl]
+* Wolfgang Helbig mailto:helbig@ba-stuttgart.de[helbig@ba-stuttgart.de]
+* Wolfgang Solfrank mailto:ws@tools.de[ws@tools.de]
+* {wolf}
+* Woodchuck Dave mailto:djv@bedford.net[djv@bedford.net]
+* Woody Carey mailto:woodycarey@hotmail.com[woodycarey@hotmail.com]
+* Wouter Van Hemel mailto:wouter@pair.com[wouter@pair.com]
+* Wu Ching-hong mailto:woju@FreeBSD.ee.Ntu.edu.TW[woju@FreeBSD.ee.Ntu.edu.TW]
+* {wylie}
+* Xavier Beaudouin mailto:kiwi@oav.net[kiwi@oav.net]
+* Xiaoding Liu mailto:xiaoding+freebsd@xiaoding.org[xiaoding+freebsd@xiaoding.org]
+* Yamagi Burmeister mailto:yamagi@yamagi.org[yamagi@yamagi.org]
+* Yanhui Shen mailto:shen.elf@gmail.com[shen.elf@gmail.com]
+* Yann Berthier mailto:yb@bachibouzouk.org[yb@bachibouzouk.org]
+* Yannis Kotsinos mailto:zookie@med.auth.gr[zookie@med.auth.gr]
+* Yarema mailto:yds@ingress.com[yds@ingress.com]
+* Yaroslav Terletsky mailto:ts@polynet.lviv.ua[ts@polynet.lviv.ua]
+* Yasuhiro Fukama mailto:yasuf@big.or.jp[yasuf@big.or.jp]
+* Yasuhito FUTATSUKI mailto:futatuki@fureai.or.jp[futatuki@fureai.or.jp]
+* Yen-Shuo Su mailto:yssu@CCCA.NCTU.edu.tw[yssu@CCCA.NCTU.edu.tw]
+* Yi-Feng Tzeng mailto:yftzeng@gmail.com[yftzeng@gmail.com]
+* Yi-Hsuan Hsin mailto:mhsin@mhsin.org[mhsin@mhsin.org]
+* Ying-Chieh Chen mailto:yinjieh@csie.nctu.edu.tw[yinjieh@csie.nctu.edu.tw]
+* Yinghong Liu mailto:relaxbsd@gmail.com[relaxbsd@gmail.com]
+* Yixin Jin mailto:yjin@rain.cs.ucla.edu[yjin@rain.cs.ucla.edu]
+* Yoichi Asai mailto:yatt@msc.biglobe.ne.jp[yatt@msc.biglobe.ne.jp]
+* Yoshiaki Uchikawa mailto:yoshiaki@kt.rim.or.jp[yoshiaki@kt.rim.or.jp]
+* Yoshihiko SARUMRU mailto:mistral@imasy.or.jp[mistral@imasy.or.jp]
+* Yoshihisa NAKAGAWA mailto:y-nakaga@ccs.mt.nec.co.jp[y-nakaga@ccs.mt.nec.co.jp]
+* Yoshikazu Goto mailto:gotoh@ae.anritsu.co.jp[gotoh@ae.anritsu.co.jp]
+* Yoshimasa Ohnishi mailto:ohnishi@isc.kyutech.ac.jp[ohnishi@isc.kyutech.ac.jp]
+* Yoshishige Arai mailto:ryo2@on.rim.or.jp[ryo2@on.rim.or.jp]
+* Yu-Shun Wang mailto:yushunwa@isi.edu[yushunwa@isi.edu]
+* Yuan-Chung Hsiao mailto:ychsiao@ychsiao.idv.tw[ychsiao@ychsiao.idv.tw]
+* Yuan Jue mailto:yuanjue@yuanjue.net[yuanjue@yuanjue.net]
+* Yuichi MATSUTAKA mailto:matutaka@osa.att.ne.jp[matutaka@osa.att.ne.jp]
+* Yuichiro AIZAWA mailto:yaizawa@mdbl.sfc.keio.ac.jp[yaizawa@mdbl.sfc.keio.ac.jp]
+* Yuichiro NAITO mailto:naito.yuichiro@gmail.com[naito.yuichiro@gmail.com]
+* Yujiro MIYATA mailto:miyata@bioele.nuee.nagoya-u.ac.jp[miyata@bioele.nuee.nagoya-u.ac.jp]
+* Yuki SHIMAZU mailto:y.shimazu@nifty.com[y.shimazu@nifty.com]
+* Yuri Kurenkov mailto:y.kurenkov@init.ru[y.kurenkov@init.ru]
+* Yuriy N. Shkandybin mailto:jura@netams.com[jura@netams.com]
+* Yuriy Tsibizov mailto:Yuriy.Tsibizov@gfk.ru[Yuriy.Tsibizov@gfk.ru]
+* Yusuke Nawano mailto:azuki@azkey.org[azuki@azkey.org]
+* Yu-Xi Lim mailto:yuxi@gmx.net[yuxi@gmx.net]
+* Yuu Yashiki mailto:s974123@cc.matsuyama-u.ac.jp[s974123@cc.matsuyama-u.ac.jp]
+* Yuuichi Narahara mailto:aconitum@po.teleway.ne.jp[aconitum@po.teleway.ne.jp]
+* Yuuki SAWADA mailto:mami@whale.cc.muroran-it.ac.jp[mami@whale.cc.muroran-it.ac.jp]
+* Yuukis mailto:Ys@PixyGarden.net[Ys@PixyGarden.net]
+* Yuval Yarom mailto:yval@cs.huji.ac.il[yval@cs.huji.ac.il]
+* Yves Fonk mailto:yves@cpcoup5.tn.tudelft.nl[yves@cpcoup5.tn.tudelft.nl]
+* Yves Fonk mailto:yves@dutncp8.tn.tudelft.nl[yves@dutncp8.tn.tudelft.nl]
+* Zach Garner mailto:zach@neurosoft.org[zach@neurosoft.org]
+* Zach Heilig mailto:zach@gaffaneys.com[zach@gaffaneys.com]
+* Zach Thompson mailto:hideo@lastamericanempire.com[hideo@lastamericanempire.com]
+* Zach Zurflu mailto:zach@pabst.bendnet.com[zach@pabst.bendnet.com]
+* Zachariah Thompson mailto:lin-chi@lastamericanempire.com[lin-chi@lastamericanempire.com]
+* Zak Johnson mailto:zakj@nox.cx[zakj@nox.cx]
+* Zane C. Bowers mailto:vvelox@vvelox.net[vvelox@vvelox.net]
+* Zhen REN mailto:bg1tpt@gmail.com[bg1tpt@gmail.com]
+* Zhihao Yuan mailto:lichray@gmail.com[lichray@gmail.com]
+* Zhixiang JIANG mailto:luckrill@yahoo.com.cn[luckrill@yahoo.com.cn]
+* Zhong Ming-Xun mailto:zmx@mail.CDPA.nsysu.edu.tw[zmx@mail.CDPA.nsysu.edu.tw]
+* Zsolt Udvari mailto:udvzsolt@gmail.com[udvzsolt@gmail.com]
+* appleboy mailto:appleboy.tw@gmail.com[appleboy.tw@gmail.com]
+* arci mailto:vega@sophia.inria.fr[vega@sophia.inria.fr]
+* ayunyan mailto:ayunyan@gmail.com[ayunyan@gmail.com]
+* der Mouse mailto:mouse@Collatz.McRCIM.McGill.EDU[mouse@Collatz.McRCIM.McGill.EDU]
+* geoffroy desvernay mailto:dgeo@centrale-marseille.fr[dgeo@centrale-marseille.fr]
+* gspu mailto:gspurki@gmail.com[gspurki@gmail.com]
+* lightside mailto:lightside@gmx.com[lightside@gmx.com]
+* Piotr Szerman mailto:pmsz@tlen.pl[pmsz@tlen.pl]
+* rossiya mailto:rossiya@gmail.com[rossiya@gmail.com]
diff --git a/documentation/content/pt-br/articles/contributors/contrib-committers.adoc b/documentation/content/pt-br/articles/contributors/contrib-committers.adoc
new file mode 100644
index 0000000000..5b1dc6105d
--- /dev/null
+++ b/documentation/content/pt-br/articles/contributors/contrib-committers.adoc
@@ -0,0 +1,399 @@
+
+* {eadler}
+* {ambrisko}
+* {shaun}
+* {jonathan}
+* {mandree}
+* {will}
+* {dim}
+* {fernape}
+* {mat}
+* {gavin}
+* {jwb}
+* {badger}
+* {dbaio}
+* {timur}
+* {jhb}
+* {gjb}
+* {lbartoletti}
+* {jbeich}
+* {kib}
+* {kibab}
+* {gbe}
+* {bdragon}
+* {tcberner}
+* {kaktus}
+* {tdb}
+* {wblock}
+* {zbb}
+* {novel}
+* {garga}
+* {kbowling}
+* {sbz}
+* {ebrandi}
+* {harti}
+* {makc}
+* {dab}
+* {antoine}
+* {db}
+* {sbruno}
+* {brueffer}
+* {br}
+* {oleg}
+* {jchandra}
+* {acm}
+* {carlavilla}
+* {gahr}
+* {adrian}
+* {dchagin}
+* {jch}
+* {nc}
+* {loader}
+* {melifaro}
+* {theraven}
+* {davidcs}
+* {marcus}
+* {lcook}
+* {ngie}
+* {tijl}
+* {rakuco}
+* {dch}
+* {alc}
+* {olivier}
+* {cracauer}
+* {jeb}
+* {bcran}
+* {joel}
+* {alfredo}
+* {bapt}
+* {ceri}
+* {brd}
+* {brooks}
+* {pjd}
+* {jwd}
+* {jmd}
+* {vd}
+* {danfe}
+* {donner}
+* {bdrewery}
+* {gad}
+* {ale}
+* {deischen}
+* {julian}
+* {ae}
+* {diizzy}
+* {lme}
+* {se}
+* {jasone}
+* {kevans}
+* {madpilot}
+* {kami}
+* {scf}
+* {farrokhi}
+* {mfechner}
+* {afedorov}
+* {feld}
+* {landonf}
+* {fanf}
+* {mdf}
+* {blackend}
+* {decke}
+* {sgalabov}
+* {ultima}
+* {gallatin}
+* {avg}
+* {beat}
+* {danger}
+* {sjg}
+* {gibbs}
+* {pfg}
+* {girgen}
+* {grembo}
+* {trociny}
+* {danilo}
+* {dmgk}
+* {sg}
+* {grehan}
+* {rgrimes}
+* {jamie}
+* {adridg}
+* {eugen}
+* {wg}
+* {bar}
+* {rigoletto}
+* {anish}
+* {jmg}
+* {mjg}
+* {jhale}
+* {jah}
+* {smh}
+* {ehaupt}
+* {bhd}
+* {jgh}
+* {wen}
+* {jhibbits}
+* {nhibma}
+* {jhixson}
+* {pho}
+* {oh}
+* {mhorne}
+* {cognet}
+* {sunpoet}
+* {lwhsu}
+* {whu}
+* {jkh}
+* {bhughes}
+* {shurd}
+* {rhurlin}
+* {davide}
+* {meta}
+* {pi}
+* {sevan}
+* {debdrup}
+* {peterj}
+* {markj}
+* {thj}
+* {mjoras}
+* {erj}
+* {allanjude}
+* {kan}
+* {bjk}
+* {phk}
+* {pluknet}
+* {karels}
+* {pkelsey}
+* {pkubaj}
+* {keramida}
+* {arved}
+* {fjoe}
+* {kientzle}
+* {stevek}
+* {jkim}
+* {jceel}
+* {kai}
+* {wulf}
+* {koobs}
+* {jkois}
+* {maxim}
+* {tobik}
+* {ak}
+* {skozlov}
+* {skra}
+* {skreuzer}
+* {gabor}
+* {rajeshasp}
+* {kuriyama}
+* {rene}
+* {mich}
+* {dvl}
+* {erwin}
+* {martymac}
+* {dru}
+* {jlh}
+* {oliver}
+* {grog}
+* {netchild}
+* {leitao}
+* {ian}
+* {achim}
+* {truckman}
+* {glewis}
+* {vishwin}
+* {qingli}
+* {delphij}
+* {avatar}
+* {rlibby}
+* {linimon}
+* {issyl0}
+* {scottl}
+* {jtl}
+* {imp}
+* {johalun}
+* {luporl}
+* {otis}
+* {eri}
+* {wma}
+* {rmacklem}
+* {vmaffione}
+* {bmah}
+* {rm}
+* {jmallett}
+* {dwmalone}
+* {nobutaka}
+* {amdmi3}
+* {kwm}
+* {emaste}
+* {mm}
+* {slavash}
+* {slm}
+* {mckusick}
+* {jmcneill}
+* {mmel}
+* {jmmv}
+* {kadesai}
+* {ken}
+* {cem}
+* {dinoex}
+* {jrm}
+* {freqlabs}
+* {cmt}
+* {stephen}
+* {marcel}
+* {dougm}
+* {marck}
+* {mav}
+* {jsm}
+* {tmunro}
+* {markm}
+* {trasz}
+* {neel}
+* {bland}
+* {joneum}
+* {gnn}
+* {khng}
+* {tychon}
+* {obrien}
+* {nick}
+* {ohauer}
+* {olgeni}
+* {osa}
+* {rodrigo}
+* {philip}
+* {hiren}
+* {yuripv}
+* {fluffy}
+* {np}
+* {royger}
+* {rpaulo}
+* {misha}
+* {dumbbell}
+* {mp}
+* {cperciva}
+* {alfred}
+* {csjp}
+* {gerald}
+* {scottph}
+* {0mp}
+* {pizzamig}
+* {rpokala}
+* {arrowd}
+* {kp}
+* {thomas}
+* {dfr}
+* {bofh}
+* {fox}
+* {attilio}
+* {crees}
+* {mr}
+* {bcr}
+* {trhodes}
+* {benno}
+* {arichardson}
+* {luigi}
+* {jeff}
+* {roberto}
+* {rodrigc}
+* {ler}
+* {leres}
+* {robak}
+* {ray}
+* {arybchik}
+* {bsam}
+* {samm}
+* {hrs}
+* {rscheff}
+* {wosch}
+* {cy}
+* {schweikh}
+* {matthew}
+* {tmseck}
+* {stas}
+* {hselasky}
+* {lev}
+* {phil}
+* {gshapiro}
+* {syrinx}
+* {vanilla}
+* {ashish}
+* {silby}
+* {chs}
+* {bms}
+* {demon}
+* {flo}
+* {glebius}
+* {kensmith}
+* {des}
+* {sobomax}
+* {asomers}
+* {tsoome}
+* {loos}
+* {brnrd}
+* {uqs}
+* {vsevolod}
+* {pstef}
+* {zi}
+* {lstewart}
+* {rrs}
+* {rstone}
+* {xride}
+* {marius}
+* {cs}
+* {ryusuke}
+* {nyan}
+* {tagattie}
+* {tota}
+* {romain}
+* {eduardo}
+* {dteske}
+* {mi}
+* {gordon}
+* {lx}
+* {fabient}
+* {thierry}
+* {thompsa}
+* {jilles}
+* {andreast}
+* {ganbold}
+* {tuexen}
+* {chuck}
+* {ericbsd}
+* {andrew}
+* {gonzo}
+* {ume}
+* {fsu}
+* {mikael}
+* {ivadasz}
+* {manu}
+* {vangyzen}
+* {ram}
+* {bryanv}
+* {yuri}
+* {nivit}
+* {avos}
+* {kaiw}
+* {takawata}
+* {rwatson}
+* {adamw}
+* {naddy}
+* {peter}
+* {nwhitehorn}
+* {bwidawsk}
+* {swills}
+* {rew}
+* {def}
+* {mw}
+* {wollman}
+* {woodsb02}
+* {joerg}
+* {ygy}
+* {emax}
+* {yongari}
+* {rcyu}
+* {oshogbo}
+* {riggs}
+* {egypcio}
+* {zec}
+* {bz}
+* {zeising}
+* {mizhka}
+* {tz}
diff --git a/documentation/content/pt-br/articles/contributors/contrib-corealumni.adoc b/documentation/content/pt-br/articles/contributors/contrib-corealumni.adoc
new file mode 100644
index 0000000000..6210ade1cc
--- /dev/null
+++ b/documentation/content/pt-br/articles/contributors/contrib-corealumni.adoc
@@ -0,0 +1,56 @@
+
+* {kmoore} (2016 - 2020)
+* {jhb} (2002 - 2006, 2010 - 2014, 2016 - 2020)
+* {jeff} (2018 - 2020)
+* {brooks} (2006 - 2012, 2018 - 2020)
+* {bcr} (2016 - 2020)
+* {allanjude} (2016 - 2020)
+* {bapt} (2016 - 2018)
+* {emaste} (2016 - 2018)
+* {gnn} (2006 - 2010, 2016 - 2018)
+* {benno} (2016 - 2018)
+* {tabthorpe} (2012 - 2014)
+* {kib} (2010 - 2014)
+* {miwi} (2012 - 2014)
+* {attilio} (2012)
+* {wilko} (2006 - 2012)
+* {imp} (2000 - 2008, 2010 - 2012)
+* {pav} (2010 - 2012)
+* {cperciva} (2010 - 2012)
+* {rwatson} (2000 - 2012)
+* {keramida} (2006 - 2010)
+* {kris} (2008 - 2010)
+* {murray} (2002 - 2010)
+* {peter} (1995 - 2006, 2008 - 2010)
+* {wes} (2002 - 2008)
+* {markm} (2002 - 2006)
+* {kuriyama} (2002 - 2006)
+* {scottl} (2004 - 2005)
+* {grog} (2000 - 2004)
+* {dg} (1992 - 2002)
+* {dfr} (1999 - 2002)
+* {msmith} (2000 - 2002)
+* {jkh} (1992 - 2002)
+* {asami} (1993 - 2001)
+* {ache} (1993 - 2000)
+* {jmb} (1993 - 2000)
+* {bde} (1992 - 2000)
+* {gibbs} (1993 - 2000)
+* {rich} (1994 - 2000)
+* {phk} (1992 - 2000)
+* {gpalmer} (1993 - 2000)
+* {sos} (1993 - 2000)
+* {wollman} (1993 - 2000)
+* {joerg} (1995 - 2000)
+* {jdp} (1997 - 2000)
+* {guido} (1995 - 1999)
+* {dyson} (1993 - 1998)
+* {nate} (1992 - 1996)
+* {rgrimes} (1992 - 1995)
+* {ats} (1992 - 1995)
+* {csgr} (1993 - 1995)
+* {paul} (1992 - 1995)
+* {smace} (1993 - 1994)
+* {alm} (1993 - 1994)
+* {chmr} (1993 - 1994)
+* {jtc} (1992 - 1993)
diff --git a/documentation/content/pt-br/articles/contributors/contrib-develalumni.adoc b/documentation/content/pt-br/articles/contributors/contrib-develalumni.adoc
new file mode 100644
index 0000000000..8b190ce76f
--- /dev/null
+++ b/documentation/content/pt-br/articles/contributors/contrib-develalumni.adoc
@@ -0,0 +1,499 @@
+
+* {culot} (2010 - 2021)
+* {jlaffaye} (2011 - 2021)
+* {kmoore} (2009 - 2021)
+* {lifanov} (2016 - 2021)
+* {miwi} (2006 - 2021)
+* {jpaetzel} (2008 - 2021)
+* {araujo} (2007 - 2021)
+* {ed} (2008 - 2020)
+* {mmokhi} (2017 - 2020)
+* {knu} (2000 - 2020)
+* {cpm} (2015 - 2020)
+* {jadawin} (2008 - 2020)
+* {mahrens} (2016 - 2020)
+* {gblach} (2012 - 2020)
+* {salvadore} (2020)
+* {seanc} (2002 - 2020)
+* {zleslie} (2017 - 2020)
+* {dbn} (2013 - 2020)
+* {wollman} (1993 - 2020)
+* {johans} (2006 - 2019)
+* {remko} (2004 - 2019)
+* {az} (2005 - 2019)
+* {bde} (1994 - 2019)
+* {murray} (2000 - 2019)
+* {taras} ( - 2019)
+* {simon} (2003 - 2019)
+* {manolis} ( - 2019)
+* {pgj} (2009 - 2019)
+* {dexter} (2018 - 2019)
+* {tobez} (2001 - 2019)
+* {badger} (2016 - 2019)
+* {zbb} (2013 - 2019)
+* {jwd} (2000 - 2019)
+* {deischen} (1999 - 2019)
+* {fanf} (2002 - 2019)
+* {gibbs} (1994 - 2019)
+* {eri} (2008 - 2019)
+* {jmmv} (2013 - 2019)
+* {lidl} (2015 - 2019)
+* {neel} (2009 - 2019)
+* {alfred} (1999 - 2019)
+* {thomas} (2002 - 2019)
+* {rezny} (2017 - 2019)
+* {luigi} (1998 - 2019)
+* {rodrigc} (2005 - 2019)
+* {stas} (2006 - 2019)
+* {thompsa} (2005 - 2019)
+* {ivadasz} (2016 - 2019)
+* {kaiw} (2014 - 2019)
+* {yongari} (2004 - 2019)
+* {benno} (2000 - 2018)
+* {def} (2016 - 2018)
+* {jeb} (2018 - 2018)
+* {jimharris} (2011 - 2018)
+* {tj} (2012 - 2018)
+* {dryice} (2006 - 2018)
+* {lth} (2004 - 2018)
+* {avilla} (2010 - 2018)
+* {nemysis}(2013 - 2018)
+* {rea} (2010 - 2018)
+* {bryanv} (2012 - 2018)
+* {daichi} (2002 - 2018)
+* {wxs} (2008 - 2018)
+* {maho} (2002 - 2018)
+* {pawel} (2011 - 2018)
+* {tabthorpe} (2007 - 2018)
+* {vg} (2013 - 2018)
+* {silby} (2001 - 2018)
+* {skra} (2015 - 2018)
+* {jonathan} (2010 - 2017)
+* {kevlo} (1999 - 2017)
+* {junovitch} (2015 - 2017)
+* {olivierd} (2012 - 2017)
+* {marino} (2013 - 2017)
+* {akiyama} (2000 - 2017)
+* {andre} (2003 - 2017)
+* {charnier} (1997 - 2017)
+* {cherry} (2012 - 2017)
+* {das} (2003 - 2017)
+* {davidch} (2006 - 2017)
+* {edavis} (2013 - 2017)
+* {iwasaki} (1999 - 2017)
+* {monthadar} (2012 - 2017)
+* {ps} (2000 - 2017)
+* {rnoland} (2008 - 2017)
+* {ru} (1999 - 2017)
+* {sanpei} (2000 - 2017)
+* {sephe} (2007 - 2017)
+* {stefanf} (2004 - 2017)
+* {syuu} (2012 - 2017)
+* {benl} (2011 - 2017)
+* {jhay} (1996 - 2017)
+* {raj} (2007 - 2017)
+* {theraven} (2011 - 2017)
+* {ups} (2004 - 2017)
+* {wkoszek} (2006 - 2017)
+* {mckay} (1996 - 2017)
+* {bschmidt} (2010 - 2017)
+* {dmarion} (2012 - 2017)
+* {ghelmer} (1998 - 2017)
+* {jfv} (2006 - 2017)
+* {jh} (2009 - 2017)
+* {jmcneill} (2016 - 2017)
+* {rmh} (2011 - 2017)
+* {slm} (2014 - 2017)
+* {versus} (2008 - 2017)
+* {brian} (1996 - 2017)
+* {gber} (2011 - 2017)
+* {gleb} (2011 - 2017)
+* {ivoras} (2008 - 2017)
+* {rdivacky} (2008 - 2017)
+* {vanhu} (2008 - 2017)
+* {zont} (2012 - 2017)
+* {mva} (2009 - 2017)
+* {alonso} (2014 - 2016)
+* {edwin} (2002 - 2016)
+* {erwin} (2003 - 2016)
+* {leeym} (2002 - 2016)
+* {mmoll} (2015 - 2016)
+* {sem} (2004 - 2016)
+* {bf} (2010 - 2015)
+* {pgollucci} (2008 - 2015)
+* {itetcu} (2006 - 2015)
+* {achim} (2013 - 2015)
+* {ade} (2000 - 2015)
+* {alexey} (2013 - 2015)
+* {brix} (2007 - 2015)
+* {clsung} (2004 - 2015)
+* {dhn} (2009 - 2015)
+* {jase} (2012 - 2015)
+* {kargl} (2011 - 2015)
+* {rafan} (2006 - 2015)
+* {sahil} (2010 - 2015)
+* {stefan} (2006 - 2015)
+* {xmj} (2014 - 2015)
+* {anders} (2001 - 2014)
+* {beech} (2007 - 2014)
+* {davidxu} (2002 - 2014)
+* {glarkin} (2008 - 2014)
+* {hq} (2004 - 2014)
+* {lioux} (2000 - 2014)
+* {lippe} ( - 2014)
+* {max} ( - 2014)
+* {milki} (2013 - 2014)
+* {sperber} (2012 - 2014)
+* {sumikawa} (2003 - 2014)
+* {tmseck} (2013 - 2014)
+* {ru} (1999 - 2014)
+* {carl} (2013 - 2014)
+* {ahze} (2004 - 2013)
+* {avl} (2009 - 2013)
+* {chinsan} (2007 - 2013)
+* {clement} (2003 - 2013)
+* {jsa} (2010 - 2013)
+* {jmelo} (2006 - 2013)
+* {lbr} (2006 - 2013)
+* {matusita} (2001 - 2013)
+* {mezz} (2004 - 2013)
+* {mjacob} (1997 - 2013)
+* {motoyuki} (1998 - 2013)
+* {pav} (2003 - 2013)
+* {pclin} (2013)
+* {qingli} (2005 - 2013)
+* {roam} (2000 - 2013)
+* {scheidell} (2011 - 2013)
+* {skv} (2001 - 2013)
+* {sylvio} (2009 - 2013)
+* {yzlin} (2009 - 2013)
+* {flz} (2005 - 2013)
+* {scf} (2007 - 2012)
+* {gj} (2003 - 2012)
+* {kmacy} (2005 - 2012)
+* {zml} (2009 - 2012)
+* {jkoshy} (1998 - 2012)
+* {brucec} (2010 - 2012)
+* {bgray} (2012)
+* {randi} (2010 - 2012)
+* {zack} (2010 - 2012)
+* {erik} (2008 - 2012)
+* {carvay} (2008 - 2012)
+* {lulf} (2007 - 2012)
+* {mnag} (2005 - 2012)
+* Doug Barton (2000 - 2012)
+* {wilko} (2000 - 2012)
+* {murray} (2000 - 2012)
+* {steve} (1996 - 2012)
+* {weongyo} (2007 - 2011)
+* {ticso} (2002 - 2011)
+* {rse} (1997 - 2011)
+* {mlaier} (2004 - 2011)
+* {art} (2011)
+* {jacula} (2010 - 2011)
+* {nemoliu} (2007 - 2011)
+* {alexbl} (2006 - 2011)
+* {alepulver} (2006 - 2011)
+* {tmclaugh} (2005 - 2011)
+* {anray} (2005 - 2011)
+* {niels} (2004 - 2011)
+* {sergei} (2003 - 2011)
+* {mux} (2002 - 2011)
+* {hm} (1998 - 2011)
+* {ijliao} (2001 - 2011)
+* {scrappy} (1996 - 2011)
+* {wes} (1998 - 2010)
+* {simokawa} (1999 - 2010)
+* {sepotvin} (2007 - 2010)
+* {sam} (2002 - 2010)
+* {nork} (2002 - 2010)
+* {mbr} (2001 - 2010)
+* {dd} (2001 - 2010)
+* {anchie} (2010)
+* {olli} (2008 - 2010)
+* {kato} (1996 - 2010)
+* {bruno} (2005 - 2010)
+* {snb} (2009 - 2010)
+* {cbzimmer} (2009 - 2010)
+* {bushman} (2007 - 2010)
+* {benjsc} (2007 - 2010)
+* {rink} (2006 - 2010)
+* {piso} (2006 - 2010)
+* {laszlof} (2006 - 2010)
+* {bvs} (2005 - 2010)
+* {barner} (2005 - 2010)
+* {vs} (2004 - 2010)
+* {dds} (2003 - 2010)
+* {perky} (2002 - 2010)
+* {yoichi} (2001 - 2010)
+* {okazaki} (2000 - 2010)
+* {cjh} (2000 - 2010)
+* {jesusr} (1998 - 2010)
+* {ssouhlal} (2004 - 2009)
+* {sson} (2008 - 2009)
+* {markus} (2006 - 2009)
+* {green} (1999 - 2009)
+* {darrenr} (1997 - 2009)
+* {ariff} (2005 - 2009)
+* {sos} (1993 - 2009)
+* {mtm} (2003 - 2009)
+* {matteo} (2006 - 2009)
+* {jon} (2000 - 2009)
+* {guido} (1993 - 2009)
+* {dwhite} (1998 - 2009)
+* {cokane} (2000 - 2009)
+* {sat} (2006 - 2009)
+* {jcamou} (2005 - 2009)
+* {rushani} (2003 - 2009)
+* {nik} (1998 - 2009)
+* {lofi} (2003 - 2009)
+* {den} (2003 - 2009)
+* {obraun} (2002 - 2009)
+* {anholt} (2002 - 2009)
+* {mwlucas} (2001 - 2009)
+* {chern} (2001 - 2009)
+* {mita} (2000 - 2009)
+* {horikawa} (2000 - 2009)
+* {clive} (2000 - 2009)
+* {gioria} (1999 - 2009)
+* {rik} (2003 - 2008)
+* {pb} (2003 - 2008)
+* {mpp} (1995 - 2008)
+* {luoqi} (1998 - 2008)
+* {iedowse} (2000 - 2008)
+* {tg} (1995 - 2009)
+* {kris} (1999 - 2008)
+* {sephe} (2007 - 2008)
+* {davidc} (2001 - 2008)
+* {kishore} (2007 - 2008)
+* {twinterg} (2006 - 2008)
+* {koitsu} (2006 - 2008)
+* {bakul} (2006 - 2008)
+* {jylefort} (2005 - 2008)
+* {garys} (2005 - 2008)
+* {damien} (2005 - 2008)
+* {aaron} (2005 - 2008)
+* {tackerman} (2004 - 2008)
+* {metal} (2004 - 2008)
+* {marks} (2004 - 2008)
+* {lesi} (2004 - 2008)
+* {josef} (2004 - 2008)
+* {dhartmei} (2004 - 2008)
+* {sah} (2004 - 2008)
+* {rsm} (2003 - 2008)
+* {hoek} (2003 - 2008)
+* {eik} (2003 - 2008)
+* {matk} (2003 - 2008)
+* {njl} (2002 - 2008)
+* {ikob} (2002 - 2008)
+* {pdeuskar} (2001 - 2008)
+* {mikeh} (2001 - 2008)
+* {shiba} (2000 - 2008)
+* {pat} (2000 - 2008)
+* {onoe} (2000 - 2008)
+* {lkoeller} (2000 - 2008)
+* {jayanth} (2000 - 2008)
+* {jake} (2000 - 2008)
+* {dmlb} (2000 - 2008)
+* {bmilekic} (2000 - 2008)
+* {babkin} (2000 - 2008)
+* {joe} (1999 - 2008)
+* {imura} (1999 - 2008)
+* {andy} (1999 - 2008)
+* {shige} (1999 - 2008)
+* {hosokawa} (1998 - 2008)
+* {foxfair} (1998 - 2008)
+* {billf} (1998 - 2008)
+* {tegge} (1997 - 2008)
+* {jlemon} (1997 - 2008)
+* {fenner} (1996 - 2008)
+* {andreas} (1996 - 2008)
+* {jdp} ( - 2008)
+* {hsu} ( - 2008)
+* {wpaul} (1995 - 2007)
+* {suz} (2002 - 2007)
+* {le} (2004 - 2007)
+* {jls} (2006 - 2007)
+* {jinmei} (2007)
+* {hmp} (2004 - 2007)
+* {phantom} (1999 - 2007)
+* {mohans} (2006 - 2007)
+* {cel} (2006 - 2007)
+* {lawrance} (2005 - 2007)
+* {rees} (2004 - 2007)
+* {tjr} (2002 - 2007)
+* {johan} (2002 - 2007)
+* {markp} (2001 - 2007)
+* {jesper} (2001 - 2007)
+* {eric} (2001 - 2007)
+* {trevor} (2000 - 2007)
+* {non} (2000 - 2007)
+* {kbyanc} (2000 - 2007)
+* {jeh} (2000 - 2007)
+* {gsutter} (2000 - 2007)
+* {bsd} (2000 - 2007)
+* {tom} (1999 - 2007)
+* {mharo} (1999 - 2007)
+* {chris} (1999 - 2007)
+* {bp} (1999 - 2007)
+* {archie} (1998 - 2007)
+* {yar} ( - 2007)
+* {tanimura} (1999 - 2006)
+* {peadar} (2004 - 2006)
+* {wsalamon} (2005 - 2006)
+* {mdodd} (1999 - 2006)
+* {vkashyap} (2004 - 2006)
+* {niklas} (2004 - 2006)
+* {smkelly} (2003 - 2006)
+* {arun} (2003 - 2006)
+* {am} (2003 - 2006)
+* {scop} (2002 - 2006)
+* {mheinen} (2002 - 2006)
+* {jennifer} (2002 - 2006)
+* {znerd} (2001 - 2006)
+* {keichii} (2001 - 2006)
+* {ue} (2001 - 2006)
+* {tmm} (2001 - 2006)
+* {robert} (2001 - 2006)
+* {petef} (2001 - 2006)
+* {mike} (2001 - 2006)
+* {greid} (2001 - 2006)
+* {cjc} (2001 - 2006)
+* {bbraun} (2001 - 2006)
+* {sf} (2000 - 2006)
+* {kiri} (2000 - 2006)
+* {dannyboy} (2000 - 2006)
+* {ben} (2000 - 2006)
+* {sheldonh} (1999 - 2006)
+* {roger} (1999 - 2006)
+* {nsayer} (1999 - 2006)
+* {nbm} (1999 - 2006)
+* {jedgar} (1999 - 2006)
+* {nsouch} (1998 - 2006)
+* {nectar} (1998 - 2006)
+* {mph} (1998 - 2006)
+* {kjc} (1997 - 2006)
+* {hanai} (1997 - 2006)
+* {eivind} (1997 - 2005)
+* {viny} (2004 - 2005)
+* {stephane} (2002 - 2005)
+* {arr} (2001 - 2005)
+* {sada} (1998 - 2005)
+* {flathill} (1998 - 2005)
+* {paul} (1993 - 2005)
+* {mini} (2002 - 2004)
+* {emoore} (2002 - 2004)
+* {wjv} (2001 - 2004)
+* {rpratt} (2001 - 2004)
+* {orion} (2001 - 2004)
+* {logo} (2001 - 2004)
+* {tomsoft} (2000 - 2004)
+* {patrick} (2000 - 2004)
+* {chm} (2000 - 2004)
+* {taoka} (1999 - 2004)
+* {jmas} (1999 - 2004)
+* {dcs} (1999 - 2004)
+* {dan} (1999 - 2004)
+* {smace} (1993 - 2004)
+* {alex} ( - 2004)
+* {dg} (1993 - 2003)
+* {dwcjr} (2002 - 2003)
+* {zarzycki} (2001 - 2003)
+* {tshiozak} (2001 - 2003)
+* {pirzyk} (2001 - 2003)
+* {wsanchez} (2000 - 2003)
+* {toshi} (2000 - 2003)
+* {mb} (2000 - 2003)
+* {marko} (2000 - 2003)
+* {furuta} (2000 - 2003)
+* {bean} (2000 - 2003)
+* {shin} (1999 - 2003)
+* {pho} (1999 - 2003)
+* {newton} (1999 - 2003)
+* {mtaylor} (1999 - 2003)
+* {lile} (1999 - 2003)
+* {jim} (1999 - 2003)
+* {ejc} (1999 - 2003)
+* {dick} (1999 - 2003)
+* {dbaker} (1999 - 2003)
+* {cpiazza} (1999 - 2003)
+* {cp} (1999 - 2003)
+* {thepish} (1998 - 2003)
+* {semenu} (1998 - 2003)
+* {rvb} (1998 - 2003)
+* {rnordier} (1998 - 2003)
+* {dt} (1998 - 2003)
+* {dirk} (1998 - 2003)
+* {dillon} (1998 - 2003)
+* {stark} (1997 - 2003)
+* {pds} (1997 - 2003)
+* {jseger} (1997 - 2003)
+* {helbig} (1997 - 2003)
+* {fsmp} (1997 - 2003)
+* {cwt} (1997 - 2003)
+* {brandon} (1997 - 2003)
+* {smpatel} (1996 - 2003)
+* {msmith} (1996 - 2003)
+* {mbarkah} (1996 - 2003)
+* {jfitz} (1996 - 2003)
+* {davidn} (1996 - 2003)
+* {lars} (1995 - 2003)
+* {jfieber} (1995 - 2003)
+* {dufault} (1995 - 2003)
+* {amurai} (1995 - 2003)
+* {ugen} (1994 - 2003)
+* {swallace} (1994 - 2003)
+* {stb} (1994 - 2003)
+* {rich} (1994 - 2003)
+* {pst} (1994 - 2003)
+* {mks} (1994 - 2003)
+* {ljo} (1994 - 2003)
+* {csgr} (1994 - 2003)
+* {adam} (1994 - 2003)
+* {nate} (1993 - 2003)
+* {gpalmer} (1993 - 2003)
+* {amorita} (2001 - 2002)
+* {uch} (2000 - 2002)
+* {shafeeq} (2000 - 2002)
+* {reg} (2000 - 2002)
+* {keith} (2000 - 2002)
+* {issei} (2000 - 2002)
+* {cshumway} (2000 - 2002)
+* {assar} (2000 - 2002)
+* {nakai} (1999 - 2002)
+* {asmodai} (1999 - 2002)
+* {dburr} (1998 - 2002)
+* {abial} (1998 - 2002)
+* {jmb} (1997 - 2002)
+* {danny} (1997 - 2002)
+* {graichen} (1996 - 2002)
+* {torstenb} (1995 - 2002)
+* {jmacd} (1995 - 2002)
+* {erich} (1995 - 2002)
+* {martin} (1994 - 2002)
+* {unfurl} (2000 - 2001)
+* {rv} (2000 - 2001)
+* {dec} (2000 - 2001)
+* {groudier} (1999 - 2001)
+* {yokota} (1997 - 2001)
+* {dima} (1995 - 2001)
+* {sef} (1993 - 2001)
+* {asami} (1993 - 2001)
+* {gehenna} (1999 - 2000)
+* {tedm} (1997 - 2000)
+* {nsj} (1996 - 2000)
+* {jraynard} (1996 - 2000)
+* {chuckr} (1996 - 2000)
+* {karl} (1995 - 2000)
+* {gclarkii} (1993 - 2000)
+* {jgreco} (1997 - 1999)
+* {jamil} (1997 - 1999)
+* {ats} (1992 - 1999)
+* {meganm} (1997 - 1998)
+* {ahd} (1997 - 1998)
+* {ahasty} (1997 - 1998)
+* {dyson} (1993 - 1998)
+* {olah} (1995 - 1996)
+* {jhs} (1995 - 1995)
+* gjp (1995 - 1995)
+* {alm} (1993 - 1995)
diff --git a/documentation/content/pt-br/articles/contributors/contrib-develinmemoriam.adoc b/documentation/content/pt-br/articles/contributors/contrib-develinmemoriam.adoc
index ad0f5cc2fb..49ef06842f 100644
--- a/documentation/content/pt-br/articles/contributors/contrib-develinmemoriam.adoc
+++ b/documentation/content/pt-br/articles/contributors/contrib-develinmemoriam.adoc
@@ -43,18 +43,18 @@ Jürgen fez uma série de contribuições para o FreeBSD, incluindo o trabalho n
* {alexbl} (2006 - 2011; RIP 2012)
+
http://www.legacy.com/obituaries/sfgate/obituary.aspx?pid=159801494[Alexander] foi mais conhecido como um dos principais contribuintes para os ports Python do FreeBSD e um membro fundador da lista de discussão do FreeBSD Python e também pelo seu trabalho no XMMS2.
-* {jb} (1997 - 2009; RIP 2009)
+* John Birrell (1997 - 2009; RIP 2009)
+
http://hub.opensolaris.org/bin/view/Community+Group+ogb/In+Memoriam[John] fez grandes contribuições para o FreeBSD, o mais conhecido foi a importação do código man:dtrace[1]. O senso de humor e a fala simples de John ou irritava alguns ou criava amigos rapidamente. No final de sua vida, ele se mudou para uma área rural e estava tentando viver com o mínimo de impacto possível para o planeta, enquanto ao mesmo tempo ainda trabalhava na área de alta tecnologia.
-* {jmz} (1994 - 2009; RIP 2009)
+* Jean-Marc Zuccon (1994 - 2009; RIP 2009)
+
http://www.obs-besancon.fr/article.php3?id_article=323[Jean-Marc] foi um astrofísico que fez importantes contribuições para a modelagem das atmosferas de planetas e cometas no http://www.obs-besancon.fr/[l'Observatoire de Besançon] em Besançon, França. Enquanto esteve lá, participou da concepção e construção do espectrômetro Vega tricanal que estudou o Cometa Halley. Ele também foi um colaborador de longa data do FreeBSD.
-* {itojun} (1997 - 2001; RIP 2008)
+* Jun-ichiro Itoh (1997 - 2001; RIP 2008)
+
Conhecido por todos como http://astralblue.livejournal.com/350702.html[itojun], Jun-ichiro Hagino foi um pesquisador principal no http://www.kame.net/[KAME Project], que visava fornecer tecnologia IPv6 e IPsec de forma livremente redistribuível. Muito deste código foi incorporado ao FreeBSD. Sem seus esforços, o estado do IPv6 na Internet seria muito diferente.
-* {cg} (1999 - 2005; RIP 2005)
+* Cameron Grant (1999 - 2005; RIP 2005)
+
http://www.dbsi.org/cam/[Cameron] foi um indivíduo único que contribuiu para o projeto apesar de graves deficiências físicas. Ele foi responsável por uma reescrita completa do nosso sistema de som durante o final dos anos 90. Muitos daqueles que se correspondiam com ele não tinham idéia de sua mobilidade limitada, devido ao seu espírito alegre e disposição para ajudar os outros.
-* {alane} (2002 - 2003; RIP 2003)
+* Alan Eldridge (2002 - 2003; RIP 2003)
+
http://freebsd.kde.org/memoriam/alane.php[Alan] foi um grande contribuinte para o KDE no FreeBSD. Além disso, ele manteve muitas outros ports difíceis e que consumiam muito tempo, como o autoconf, CUPS, e python. O caminho de Alan não foi fácil, mas sua paixão pelo FreeBSD e a dedicação à excelência de programação lhe renderam muitos amigos.
diff --git a/documentation/content/pt-br/articles/contributors/contrib-portmgralumni.adoc b/documentation/content/pt-br/articles/contributors/contrib-portmgralumni.adoc
new file mode 100644
index 0000000000..aeb02070b2
--- /dev/null
+++ b/documentation/content/pt-br/articles/contributors/contrib-portmgralumni.adoc
@@ -0,0 +1,23 @@
+
+* {feld} (2016 - 2019)
+* {miwi} (2009 - 2016)
+* {erwin} (2004 - 2016)
+* {decke} (2012 - 2015)
+* {tabthorpe} (2011 - 2014)
+* {itetcu} (2009 - 2014)
+* {marcus} (2004 - 2014)
+* {beat} (2011 - 2013)
+* {linimon} (2004 - 2013)
+* {pav} (2006 - 2012)
+* {flz} (2008 - 2012)
+* {kris} (2001 - 2010)
+* {krion} (2004 - 2009)
+* {clement} (2005 - 2007)
+* {eik} (2004 - 2005)
+* {will} (2001 - 2004)
+* {knu} (2001 - 2004)
+* {lioux} (2001 - 2004)
+* {sobomax} (2001 - 2004)
+* {steve} (2001 - 2004)
+* {ade} (2001 - 2002)
+* {asami} ( - 2001)
diff --git a/documentation/content/pt-br/articles/cups/_index.adoc b/documentation/content/pt-br/articles/cups/_index.adoc
index 29accc4936..4c77bc22d6 100644
--- a/documentation/content/pt-br/articles/cups/_index.adoc
+++ b/documentation/content/pt-br/articles/cups/_index.adoc
@@ -3,7 +3,6 @@ title: CUPS no FreeBSD
authors:
- author: Chess Griffin
email: chess@chessgriffin.com
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -16,13 +15,27 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: articles/cups/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumo
diff --git a/documentation/content/pt-br/articles/explaining-bsd/_index.adoc b/documentation/content/pt-br/articles/explaining-bsd/_index.adoc
index f8fbebfb0e..d7b0b26a62 100644
--- a/documentation/content/pt-br/articles/explaining-bsd/_index.adoc
+++ b/documentation/content/pt-br/articles/explaining-bsd/_index.adoc
@@ -18,13 +18,27 @@ trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sun", "u
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: articles/explaining-bsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumo
diff --git a/documentation/content/pt-br/articles/filtering-bridges/_index.adoc b/documentation/content/pt-br/articles/filtering-bridges/_index.adoc
index 895bac5c38..4b1b4755c1 100644
--- a/documentation/content/pt-br/articles/filtering-bridges/_index.adoc
+++ b/documentation/content/pt-br/articles/filtering-bridges/_index.adoc
@@ -3,7 +3,6 @@ title: Pontes de Filtragem (Filtering Bridges)
authors:
- author: Alex Dupre
email: ale@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "3com", "intel", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "3com", "intel", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/filtering-bridges/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -80,7 +81,7 @@ options IPFIREWALL_VERBOSE
A primeira linha adiciona o suporte para o serviço de ponte (bridge), a segunda adiciona o suporte ao firewall e a terceira é referente as funções de registro do firewall.
-Agora é necessário compilar e instalar o novo kernel. Você pode encontrar instruções detalhadas na seção link:{handbook}#kernelconfig-building[Compilando e Instalando um Kernel Personalizado] do Handbook do FreeBSD.
+Agora é necessário compilar e instalar o novo kernel. Você pode encontrar instruções detalhadas na seção extref:{handbook}kernelconfig/[Compilando e Instalando um Kernel Personalizado, kernelconfig-building] do Handbook do FreeBSD.
[[filtering-bridges-modules]]
=== Carregamento de módulos
diff --git a/documentation/content/pt-br/articles/fonts/_index.adoc b/documentation/content/pt-br/articles/fonts/_index.adoc
index 64095c3bbe..b7ad32c1c0 100644
--- a/documentation/content/pt-br/articles/fonts/_index.adoc
+++ b/documentation/content/pt-br/articles/fonts/_index.adoc
@@ -4,7 +4,6 @@ subtitle: Um Tutorial
authors:
- author: Dave Bodenstab
email: imdave@synet.net
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "adobe", "apple", "linux", "microsoft", "opengroup", "general"]
---
@@ -17,13 +16,27 @@ trademarks: ["freebsd", "adobe", "apple", "linux", "microsoft", "opengroup", "ge
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: articles/fonts/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumo
diff --git a/documentation/content/pt-br/articles/freebsd-questions/_index.adoc b/documentation/content/pt-br/articles/freebsd-questions/_index.adoc
index 15162879bf..0fc959b5c2 100644
--- a/documentation/content/pt-br/articles/freebsd-questions/_index.adoc
+++ b/documentation/content/pt-br/articles/freebsd-questions/_index.adoc
@@ -3,7 +3,6 @@ title: Como obter os melhores resultados da lista de email FreeBSD-questions
authors:
- author: Greg Lehey
email: grog@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "microsoft", "opengroup", "qualcomm", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "microsoft", "opengroup", "qualcomm", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/freebsd-questions/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -130,14 +131,14 @@ Duas listas de discussão abordam questões gerais sobre o FreeBSD, `FreeBSD-que
. Se você acredita que a pergunta está relacionada com um bug, e você tem _certeza_ que é um bug (por exemplo, você pode apontar o lugar do código onde isso acontece, e você poder ter uma correção para o problema), então envie a mensagem para a lista `FreeBSD-hackers`.
. Se a questão envolve melhoramentos no FreeBSD, e você pode sugerir em como isto pode ser implementado, então mande a menssagem para a lista `FreeBSD-hackers`.
-Há também uma boa quantidade de link:{handbook}#eresources-mail[listas de email especializadas], que atendem interesses mais específicos. O critério acima ainda se aplica, e é interessante que você o siga, pois há mais chance de você obter melhores resultados desta forma.
+Há também uma boa quantidade de extref:{handbook}eresources[listas de email especializadas, eresources-mail], que atendem interesses mais específicos. O critério acima ainda se aplica, e é interessante que você o siga, pois há mais chance de você obter melhores resultados desta forma.
== Antes de Enviar uma Pergunta
Você pode (e deve) fazer algumas coisas você mesmo antes de fazer uma pergunta em uma das listas de discussão:
* Tente resolver o problema sozinho. Se você enviar uma pergunta que demonstre que você tentou resolver o problema, sua mensagem vai normalmente atrair mais atenção de uma forma positiva das pessoas que a leram. Tentar resolver o problema sozinho também vai aumentar seu entendimento do FreeBSD, e eventualmente vai proporcionar conhecimento para você poder responder perguntas de outros usuários das listas e também ajudar.
-* Leia as páginas dos manuais, e a documentação do FreeBSD (tanto a instalada em [.filename]#/usr/doc# ou a versão acessível via Web em http://www.FreeBSD.org[http://www.FreeBSD.org]), especialmente o link:{handbook}[handbook] e o link:{faq}[FAQ].
+* Leia as páginas dos manuais, e a documentação do FreeBSD (tanto a instalada em [.filename]#/usr/doc# ou a versão acessível via Web em http://www.FreeBSD.org[http://www.FreeBSD.org]), especialmente o extref:{handbook}[handbook] e o extref:{faq}[FAQ].
* Procure e/ou pesquise nos arquivos da lista de discussão, para verificar se a sua pergunta ou uma pergunta semelhante já foi feita (e possivelmente respondida) antes na lista. Você pode navegar e/ou pesquisar os arquivos da lista de discussão em https://www.FreeBSD.org/mail[https://www.FreeBSD.org/mail] e https://www.FreeBSD.org/search/#mailinglists[https://www.FreeBSD.org/search/#mailinglists], respectivamente. Isso pode ser feito em outros sites da Web, como por exemplo, em http://marc.theaimsgroup.com[http://marc.theaimsgroup.com].
* Use um mecanismo de pesquisa como o http://www.google.com[Google] ou http://www.yahoo.com[Yahoo] para encontrar respostas para a sua pergunta.
diff --git a/documentation/content/pt-br/articles/freebsd-releng/_index.adoc b/documentation/content/pt-br/articles/freebsd-releng/_index.adoc
index 93337b1677..fd921f44ff 100644
--- a/documentation/content/pt-br/articles/freebsd-releng/_index.adoc
+++ b/documentation/content/pt-br/articles/freebsd-releng/_index.adoc
@@ -20,13 +20,27 @@ trademarks: ["freebsd", "intel", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: articles/freebsd-releng/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumo
diff --git a/documentation/content/pt-br/articles/freebsd-update-server/_index.adoc b/documentation/content/pt-br/articles/freebsd-update-server/_index.adoc
index 4125342c97..026c8eb734 100644
--- a/documentation/content/pt-br/articles/freebsd-update-server/_index.adoc
+++ b/documentation/content/pt-br/articles/freebsd-update-server/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Jason Helfman
email: jgh@FreeBSD.org
copyright: 2009-2011, 2013 Jason Helfman
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "amd", "intel", "general"]
---
@@ -17,24 +16,26 @@ trademarks: ["freebsd", "amd", "intel", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/freebsd-update-server/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -69,7 +70,7 @@ No mínimo, as atualizações requerem a criação de uma versão do FreeBSD mai
====
* Uma conta de usuário com pelo menos 4 GB de espaço disponível. Isso permitirá a criação de atualizações para 7.1 e 7.2, mas os requisitos de espaço exatos podem mudar de versão para versão.
* Uma conta com acesso ao man:ssh[1] em uma máquina remota para carregar atualizações distribuídas.
-* Um servidor web, como o link:{handbook}#network-apache[Apache], com mais da metade do espaço necessário para a construção. Por exemplo, as compilações de teste para 7.1 e 7.2 consomem uma quantidade total de 4 GB e o espaço do servidor da web necessário para distribuir essas atualizações é de 2.6 GB.
+* Um servidor web, como o extref:{handbook}network-servers[Apache, network-apache], com mais da metade do espaço necessário para a construção. Por exemplo, as compilações de teste para 7.1 e 7.2 consomem uma quantidade total de 4 GB e o espaço do servidor da web necessário para distribuir essas atualizações é de 2.6 GB.
* Conhecimento básico de shell script com o Bourne shell, man:sh[1].
[[Configuration]]
@@ -370,9 +371,9 @@ No caso de o código de atualização precisar ser reenviado, isso pode ser feit
====
-Os arquivos enviados precisarão estar no diretório de documentos raiz do servidor web para que as atualizações sejam distribuídas. A configuração exata irá variar dependendo do servidor web usado. Para o servidor web Apache, consulte a sessão link:{handbook}#network-apache[Configuração de servidores Apache] no Handbook.
+Os arquivos enviados precisarão estar no diretório de documentos raiz do servidor web para que as atualizações sejam distribuídas. A configuração exata irá variar dependendo do servidor web usado. Para o servidor web Apache, consulte a sessão extref:{handbook}network-servers[Configuração de servidores Apache, network-apache] no Handbook.
-Atualize o `KeyPrint` e `ServerName` do cliente no arquivo [.filename]#/etc/freebsd-update.conf#, e execute as atualizações conforme instruído na link:{handbook}#updating-upgrading-freebsdupdate[Seção de Atualização do FreeBSD] no Handbook.
+Atualize o `KeyPrint` e `ServerName` do cliente no arquivo [.filename]#/etc/freebsd-update.conf#, e execute as atualizações conforme instruído na extref:{handbook}updating-upgrading[Seção de Atualização do FreeBSD, updating-upgrading-freebsdupdate] no Handbook.
[IMPORTANT]
====
@@ -401,7 +402,7 @@ Crie o diretório de correção do respectivo release no diretório [.filename]#
% cd /usr/local/freebsd-update-server/patches/7.1-RELEASE
....
-Como exemplo, pegue o patch para man:named[8]. Leia o comunicado, e pegue o arquivo necessário de https://www.FreeBSD.org/security/advisories/[Avisos de Segurança do FreeBSD]. Mais informações sobre a interpretação do comunicado podem ser encontradas no link:{handbook}#security-advisories[Handbook do FreeBSD].
+Como exemplo, pegue o patch para man:named[8]. Leia o comunicado, e pegue o arquivo necessário de https://www.FreeBSD.org/security/advisories/[Avisos de Segurança do FreeBSD]. Mais informações sobre a interpretação do comunicado podem ser encontradas no extref:{handbook}security[Handbook do FreeBSD, security-advisories].
No https://security.freebsd.org/advisories/FreeBSD-SA-09:12.bind.asc[resumo de segurança], este comunicado é chamado `SA-09:12.bind`. Depois de baixar o arquivo, é necessário renomear o arquivo para um nível de correção apropriado. Sugere-se manter isso consistente com os níveis oficiais de correção do FreeBSD, mas seu nome pode ser escolhido livremente. Para esta compilação, vamos seguir a prática atualmente estabelecida do FreeBSD e chamar isso de `p7`. Renomeie o arquivo:
@@ -561,7 +562,7 @@ Para referência, toda a execução do link:../../../source/articles/freebsd-upd
[[tips]]
== Dicas
-* Se uma versão personalizada for criada usando o procedimento `make release` link:{releng}#release-build[nativo], o `freebsd-update-server` funcionará a partir do seu release. Como exemplo, uma versão sem ports ou documentação pode ser construída limpando funcionalidades de limpeza pertinentes às sub-rotinas de documentação `findextradocs()`, `addextradocs()` e alterando o local de download em `fetchiso()`, respectivamente, em [.filename]#scripts/build.subr#. Como último passo, altere o hash man:sha256[1] no arquivo [.filename]#build.conf# sob sua respectiva versão e arquitetura e você estará pronto para criar sua versão personalizada.
+* Se uma versão personalizada for criada usando o procedimento `make release` extref:{releng}[nativo, release-build], o `freebsd-update-server` funcionará a partir do seu release. Como exemplo, uma versão sem ports ou documentação pode ser construída limpando funcionalidades de limpeza pertinentes às sub-rotinas de documentação `findextradocs()`, `addextradocs()` e alterando o local de download em `fetchiso()`, respectivamente, em [.filename]#scripts/build.subr#. Como último passo, altere o hash man:sha256[1] no arquivo [.filename]#build.conf# sob sua respectiva versão e arquitetura e você estará pronto para criar sua versão personalizada.
+
[.programlisting]
....
@@ -590,7 +591,7 @@ addextradocs () {
make ${COMPATFLAGS} release.1 release.2 2>&1
....
-* Crie um registro link:{handbook}#network-dns[DNS] apropriado para o servidor de atualizações e coloque outros por trás dele com variáveis de pesos diferentes. O uso desse recurso fornecerá espelhos de atualização, no entanto, essa dica não é necessária, a menos que você deseje fornecer um serviço redundante.
+* Crie um registro extref:{handbook}network-servers[DNS, network-dns] apropriado para o servidor de atualizações e coloque outros por trás dele com variáveis de pesos diferentes. O uso desse recurso fornecerá espelhos de atualização, no entanto, essa dica não é necessária, a menos que você deseje fornecer um serviço redundante.
+
[.programlisting]
....
diff --git a/documentation/content/pt-br/articles/geom-class/_index.adoc b/documentation/content/pt-br/articles/geom-class/_index.adoc
index ab9559ae01..e108fc373c 100644
--- a/documentation/content/pt-br/articles/geom-class/_index.adoc
+++ b/documentation/content/pt-br/articles/geom-class/_index.adoc
@@ -3,7 +3,6 @@ title: Escrevendo uma classe GEOM
authors:
- author: Ivan Voras
email: ivoras@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "intel", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "intel", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/geom-class/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -53,8 +54,8 @@ toc::[]
A documentação sobre programação do kernel é escassa - é uma das poucas áreas na qual não há quase nada de tutoriais amigáveis, e a frase "usa a fonte!" realmente é verdadeira. No entanto, existem alguns pedaços (alguns deles seriamente desatualizados) flutuando por ai e que devem ser estudados antes de começar a codificar:
-* O link:{developers-handbook}[Manual do Desenvolvedor do FreeBSD] - parte do projeto de documentação, ele não contém nenhum informação específica para a programação do kernel, mas possui algumas informações gerais úteis.
-* O link:{arch-handbook}[Manual de Arquitetura do FreeBSD] - também do projeto de documentação, contém descrições de várias instalações e procedimentos de baixo nível. O capítulo mais importante é o 13, link:{arch-handbook}#driverbasics[Escrevendo drivers de dispositivo FreeBSD].
+* O extref:{developers-handbook}[Manual do Desenvolvedor do FreeBSD] - parte do projeto de documentação, ele não contém nenhum informação específica para a programação do kernel, mas possui algumas informações gerais úteis.
+* O extref:{arch-handbook}[Manual de Arquitetura do FreeBSD] - também do projeto de documentação, contém descrições de várias instalações e procedimentos de baixo nível. O capítulo mais importante é o 13, extref:{arch-handbook}[Escrevendo drivers de dispositivo FreeBSD, driverbasics].
* A seção Blueprints do site do http://www.freebsddiary.org[FreeBSD Diary] contém vários artigos interessantes sobre os recursos do kernel.
* As páginas de manual na seção 9 - para documentação importante sobre as funções do kernel.
* A página man man:geom[4] e os http://phk.freebsd.dk/pubs/[Slides sobre o GEOM de PHK] - para uma introdução geral do subsistema GEOM.
diff --git a/documentation/content/pt-br/articles/gjournal-desktop/_index.adoc b/documentation/content/pt-br/articles/gjournal-desktop/_index.adoc
index 7e33b843ea..d25822402a 100644
--- a/documentation/content/pt-br/articles/gjournal-desktop/_index.adoc
+++ b/documentation/content/pt-br/articles/gjournal-desktop/_index.adoc
@@ -3,7 +3,6 @@ title: Implementando o UFS Journaling em um Desktop PC
authors:
- author: Manolis Kiagias
email: manolis@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -16,36 +15,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/gjournal-desktop/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
-endif::[]
-
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/articles/gjournal-desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
endif::[]
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -317,7 +306,7 @@ options UFS_GJOURNAL # Note: This is already in GENERIC
options GEOM_JOURNAL # You will have to add this one
....
-Recompile e reinstale seu kernel seguindo as instruções link:{handbook}#kernelconfig[relevantes no Handbook do FreeBSD].
+Recompile e reinstale seu kernel seguindo as instruções extref:{handbook}kernelconfig[relevantes no Handbook do FreeBSD, kernelconfig].
Não se esqueça de remover a entrada relevante "load" do [.filename]#/boot/loader.conf# se você a usou anteriormente.
@@ -437,7 +426,7 @@ Finalmente, edite o [.filename]#/boot/loader.conf#, remova a entrada que carrega
Journaling é um recurso relativamente novo do FreeBSD e, como tal, ainda não está muito bem documentado. Você pode, no entanto, encontrar as seguintes referências adicionais úteis:
-* Uma link:{handbook}geom-gjournal[nova seção sobre journaling] agora faz parte do Handbook do FreeBSD.
+* Uma extref:{handbook}geom[nova seção sobre journaling, geom-gjournal] agora faz parte do Handbook do FreeBSD.
* https://lists.freebsd.org/pipermail/freebsd-current/2006-June/064043.html[Este post] em http://lists.FreeBSD.org/mailman/listinfo/freebsd-current[freebsd-current] pelo desenvolvedor do man:gjournal[8], Paweł Jakub Dawidek mailto:pjd@FreeBSD.org[pjd@FreeBSD.org].
* https://lists.freebsd.org/pipermail/freebsd-questions/2008-April/173501.html[Este post] em http://lists.FreeBSD.org/mailman/listinfo/freebsd-questions[freebsd-questions] por Ivan Voras mailto:ivoras@FreeBSD.org[ivoras@FreeBSD.org].
* As páginas de manual do man:gjournal[8] e man:geom[8].
diff --git a/documentation/content/pt-br/articles/hubs/_index.adoc b/documentation/content/pt-br/articles/hubs/_index.adoc
index 8658d9f111..5394751238 100644
--- a/documentation/content/pt-br/articles/hubs/_index.adoc
+++ b/documentation/content/pt-br/articles/hubs/_index.adoc
@@ -9,7 +9,6 @@ authors:
email: dl@leo.org
- author: Ken Smith
email: kensmith@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -22,24 +21,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/hubs/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -280,7 +281,7 @@ Os sites espelhos Tier-1 precisam:
* permitir acesso a outros sites espelho
* fornecer acesso por FTP e rsync
-Além disso, os administradores devem estar inscritos nas http://lists.FreeBSD.org/mailman/listinfo/freebsd-hubs[listas de discussão de sites espelho do FreeBSD]. Consulte link:{handbook}#eresources-mail[este link] para obter detalhes em como se inscrever.
+Além disso, os administradores devem estar inscritos nas http://lists.FreeBSD.org/mailman/listinfo/freebsd-hubs[listas de discussão de sites espelho do FreeBSD]. Consulte extref:{handbook}eresources[este link, eresources-mail] para obter detalhes em como se inscrever.
[IMPORTANT]
====
diff --git a/documentation/content/pt-br/articles/ipsec-must/_index.adoc b/documentation/content/pt-br/articles/ipsec-must/_index.adoc
index 5297be98e7..e753e4f3af 100644
--- a/documentation/content/pt-br/articles/ipsec-must/_index.adoc
+++ b/documentation/content/pt-br/articles/ipsec-must/_index.adoc
@@ -3,7 +3,6 @@ title: Verificação Independente da Funcionalidade IPsec no FreeBSD
authors:
- author: David Honig
email: honig@sprynet.com
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "opengroup", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "opengroup", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/ipsec-must/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -123,7 +124,7 @@ Extensões de segurança do protocolo Internet para o IPv4; obrigatório para o
A maioria das versões modernas do FreeBSD tem suporte a IPsec em sua fonte base. Portanto, você precisará incluir a opção `IPSEC` em sua configuração de kernel e, após a reconstrução e reinstalação do kernel, configurar as conexões IPsec usando o comando man:setkey[8].
-Um guia completo sobre como executar o IPsec no FreeBSD é fornecido no link:{handbook}#ipsec[Handbook do FreeBSD].
+Um guia completo sobre como executar o IPsec no FreeBSD é fornecido no extref:{handbook}security[Handbook do FreeBSD, ipsec].
[[kernel]]
== src/sys/i386/conf/KERNELNAME
diff --git a/documentation/content/pt-br/articles/ldap-auth/_index.adoc b/documentation/content/pt-br/articles/ldap-auth/_index.adoc
index a449193e4c..3faef208d1 100644
--- a/documentation/content/pt-br/articles/ldap-auth/_index.adoc
+++ b/documentation/content/pt-br/articles/ldap-auth/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Toby Burress
email: kurin@causa-sui.net
copyright: 2007-2008 Projeto de Documentação do FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -17,13 +16,27 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: articles/ldap-auth/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumo
diff --git a/documentation/content/pt-br/articles/leap-seconds/_index.adoc b/documentation/content/pt-br/articles/leap-seconds/_index.adoc
index fce3b3255d..3e7ab2df60 100644
--- a/documentation/content/pt-br/articles/leap-seconds/_index.adoc
+++ b/documentation/content/pt-br/articles/leap-seconds/_index.adoc
@@ -13,24 +13,26 @@ title: Suporte do FreeBSD a Leap Seconds
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/leap-seconds/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -51,7 +53,7 @@ O comportamento padrão do leap Seconds é descrito na https://tools.ietf.org/ht
[[leapseconds-posix]]
== Manipulação padrão do leap seconds no FreeBSD
-A maneira mais fácil de manipular o leap seconds é com a regra de tempo POSIX que é utilizada por padrão pelo FreeBSD, combinada com o link:{handbook}#network-ntp[NTP]. Quando o man:ntpd[8] está sendo executado e o tempo é sincronizado com os servidores NTP de upstream que gerenciam o leap seconds corretamente, o leap second causará a repetição do último segundo do dia de forma automática. Nenhum outro ajuste será necessário.
+A maneira mais fácil de manipular o leap seconds é com a regra de tempo POSIX que é utilizada por padrão pelo FreeBSD, combinada com o extref:{handbook}network-servers[NTP, network-ntp]. Quando o man:ntpd[8] está sendo executado e o tempo é sincronizado com os servidores NTP de upstream que gerenciam o leap seconds corretamente, o leap second causará a repetição do último segundo do dia de forma automática. Nenhum outro ajuste será necessário.
Se os servidores de NTP upstream não gerenciarem o leap seconds corretamente, o man:ntpd[8] irá avançar em um segundo após o servidor se corrigir.
diff --git a/documentation/content/pt-br/articles/leap-seconds/_index.po b/documentation/content/pt-br/articles/leap-seconds/_index.po
index 6bb1993f9b..92d146e548 100644
--- a/documentation/content/pt-br/articles/leap-seconds/_index.po
+++ b/documentation/content/pt-br/articles/leap-seconds/_index.po
@@ -93,7 +93,7 @@ msgstr "Manipulação padrão do leap seconds no FreeBSD"
#: documentation/content/en/articles/leap-seconds/_index.adoc:53
msgid ""
"The easiest way to handle leap seconds is with the POSIX time rules FreeBSD "
-"uses by default, combined with link:{handbook}#network-ntp[NTP]. When man:"
+"uses by default, combined with extref:{handbook}network-servers[NTP]. When man:"
"ntpd[8] is running and the time is synchronized with upstream NTP servers "
"that handle leap seconds correctly, the leap second will cause the system "
"time to automatically repeat the last second of the day. No other "
diff --git a/documentation/content/pt-br/articles/linux-emulation/_index.adoc b/documentation/content/pt-br/articles/linux-emulation/_index.adoc
index a6a23e6d83..ae077d52cf 100644
--- a/documentation/content/pt-br/articles/linux-emulation/_index.adoc
+++ b/documentation/content/pt-br/articles/linux-emulation/_index.adoc
@@ -3,7 +3,6 @@ title: Emulação de Linux no FreeBSD
authors:
- author: Roman Divacky
email: rdivacky@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "adobe", "netbsd", "realnetworks", "oracle", "linux", "sun", "general"]
---
@@ -16,13 +15,27 @@ trademarks: ["freebsd", "ibm", "adobe", "netbsd", "realnetworks", "oracle", "lin
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: articles/linux-emulation/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumo
diff --git a/documentation/content/pt-br/articles/linux-users/_index.adoc b/documentation/content/pt-br/articles/linux-users/_index.adoc
index e086fdf26a..be03dd4fd4 100644
--- a/documentation/content/pt-br/articles/linux-users/_index.adoc
+++ b/documentation/content/pt-br/articles/linux-users/_index.adoc
@@ -3,7 +3,6 @@ title: Guia rápido de FreeBSD para usuários de Linux
authors:
- author: John Ferrell
copyright: 2008 Projeto de Documentação do FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/linux-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -50,14 +51,14 @@ toc::[]
Esse documento destaca algumas diferenças técnicas entre o FreeBSD e o Linux(R) para que os usuários intermediários ou avançados do Linux(R) possam se familiarizar rapidamente com o básico do FreeBSD.
-Este documento assume que o FreeBSD já está instalado. Acesse o link do capítulo link:{handbook}#bsdinstall[Instalando o FreeBSD] no Handbook do FreeBSD para obter ajuda no processo de instalação.
+Este documento assume que o FreeBSD já está instalado. Acesse o link do capítulo extref:{handbook}bsdinstall[Instalando o FreeBSD, bsdinstall] no Handbook do FreeBSD para obter ajuda no processo de instalação.
[[shells]]
== Shell Padrão
Os usuários do Linux(R) são geralmente surpreendidos quando descobrem que o Bash não é o shell padrão do FreeBSD. De fato, o Bash não é incluído na instalação padrão. Ao invés disto, o FreeBSD usa o man:tcsh[1] como shell padrão para o usuário root, e o man:sh[1], um shell compatível com o Bourne shell, como shell padrão para os demais usuários. O man:sh[1] é muito similar ao Bash mas com um conjunto de funcionalidades muito menor. Geralmente os scripts shell escritos para o man:sh[1] irão ser executados no Bash, mas o contrário não.
-Entretanto, o Bash e outros shells estão disponíveis para a instalação usando a link:{handbook}#ports[Coleção de Pacotes e a Árvore de Ports].
+Entretanto, o Bash e outros shells estão disponíveis para a instalação usando a extref:{handbook}ports[Coleção de Pacotes e a Árvore de Ports, ports].
Depois de instalar um novo shell, use o comando man:chsh[1] para trocar o shell padrão do usuário. É recomendado que o shell padrão do usuário `root` se mantenha inalterado uma vez que os shells que não fazem parte da base do sistema são instalados em [.filename]#/usr/local/bin#. No caso de ocorrer algum problema com o sistema de arquivos onde o diretório [.filename]#/usr/local/bin# está localizado e este não puder ser utilizado, o usuário `root` poderá não ter acesso ao shell padrão, evitando que o usuário `root` entre no sistema para corrigir o problema.
@@ -89,14 +90,14 @@ Pacotes são aplicações pré-compiladas, os equivalentes no FreeBSD aos arquiv
# pkg install apache24
....
-Para mais informações sobre pacotes, veja a seção 5.4 do Handbook do FreeBSD: link:{handbook}#pkgng-intro[Usando pkgng para gerenciar pacotes binários].
+Para mais informações sobre pacotes, veja a seção 5.4 do Handbook do FreeBSD: extref:{handbook}ports[Usando pkgng para gerenciar pacotes binários, pkgng-intro].
[[ports]]
=== Árvore de Ports
A árvore de ports do FreeBSD é um framework de [.filename]##Makefiles##s e patches customizados especificamente para a instalação através do código fonte no FreeBSD. Quando um port é instalado, o sistema irá buscar o código fonte, aplicar qualquer patch que seja necessário, compilar o código, instalar a aplicação e qualquer outra dependência da qual ela necessite.
-A Coleção de Ports, algumas vezes referenciada como a árvore de ports, pode ser instalada em [.filename]#/usr/ports# usando o comando man:portsnap[8] (se estiver rodando FreeBSD 11.4 ou 12.1) ou Subversion (se estiver rodando FreeBSD-CURRENT). Instruções detalhadas para instalação da Coleção de Ports podem ser encontradas na link:{handbook}#ports-using[seção 5.5] do Handbook do FreeBSD.
+A Coleção de Ports, algumas vezes referenciada como a árvore de ports, pode ser instalada em [.filename]#/usr/ports# usando o comando man:portsnap[8] (se estiver rodando FreeBSD 11.4 ou 12.1) ou Subversion (se estiver rodando FreeBSD-CURRENT). Instruções detalhadas para instalação da Coleção de Ports podem ser encontradas na extref:{handbook}ports[seção 5.5, ports-using] do Handbook do FreeBSD.
Para compilar um port, mude para o diretório do port e inicie o processo de compilação. O exemplo abaixo instala o Apache 2.4 através da Coleção de Ports:
@@ -114,7 +115,7 @@ Um dos benefícios de usar a árvore de ports para realizar a instalação de um
# make WITH_LDAP="YES" install clean
....
-Veja link:{handbook}#ports-using[Usando a Coleção de Ports] para mais informações.
+Veja extref:{handbook}ports[Usando a Coleção de Ports, ports-using] para mais informações.
[[startup]]
== Inicialização do Sistema
@@ -123,7 +124,7 @@ Muitas distribuições Linux(R) usam o sistema init do SysV, enquanto o FreeBSD
Os scripts encontrados no diretório [.filename]#/etc/rc.d/# fazem parte das aplicações da "base" do sistema, tais como man:cron[8], man:sshd[8], e man:syslog[3]. Os scripts encontrados no diterório [.filename]#/usr/local/etc/rc.d/# correspondem aos aplicativos instalados pelo usuário, como por exemplo: Apache e Squid.
-Uma vez que o FreeBSD é desenvolvido como um sistema completo, aplicações instaladas pelos usuários não são consideradas parte do sistema "base". As aplicações dos usuários são geralmente instaladas por meio link:{handbook}#ports-using[dos Pacotes Binários ou da Coleção de Ports]. Para mantê-los separados da base do sistema, eles são instalados sob o diretório [.filename]#/usr/local/#. Portanto, os aplicativos binários instalados pelos usuários localizam-se em [.filename]#/usr/local/bin/#, e os arquivos de configuração em [.filename]#/usr/local/etc/#.
+Uma vez que o FreeBSD é desenvolvido como um sistema completo, aplicações instaladas pelos usuários não são consideradas parte do sistema "base". As aplicações dos usuários são geralmente instaladas por meio extref:{handbook}ports[dos Pacotes Binários ou da Coleção de Ports, ports-using]. Para mantê-los separados da base do sistema, eles são instalados sob o diretório [.filename]#/usr/local/#. Portanto, os aplicativos binários instalados pelos usuários localizam-se em [.filename]#/usr/local/bin/#, e os arquivos de configuração em [.filename]#/usr/local/etc/#.
Os serviços são habilitados pela adição de uma entrada no arquivo [.filename]#/etc/rc.conf# . As configurações padrões são encontradas no arquivo [.filename]#/etc/defaults/rc.conf# e essas configurações padrões são sobre postas pelas configurações realizadas no arquivo [.filename]#/etc/rc.conf#. Veja o manual do man:rc.conf[5] para maiores informações sobre as entradas disponíveis. Quando você instalar aplicações adicionais, leia as mensagens de instalação da aplicação para determinar como habilitar os serviços associados a essa aplicação.
@@ -199,9 +200,9 @@ ifconfig_em0="DHCP"
O sistema FreeBSD não utiliza o Linux(R) IPTABLES como seu firewall, o FreeBSD oferece três tipos de firewall a nível de kernel:
-* link:{handbook}#firewalls-pf[PF]
-* link:{handbook}#firewalls-ipf[IPFILTER]
-* link:{handbook}#firewalls-ipfw[IPFW]
+* extref:{handbook}firewalls[PF, firewalls-pf]
+* extref:{handbook}firewalls[IPFILTER, firewalls-ipf]
+* extref:{handbook}firewalls[IPFW, firewalls-ipfw]
O PF é desenvolvido pelo projeto OpenBSD e portado para o FreeBSD. O PF foi criado para substituir o IPFILTER e sua sintaxe é similar ao IPFILTER. O PF pode ser utilizado em conjunto com man:altq[4] para prover funcionalidade de QoS.
@@ -250,7 +251,7 @@ Quando utilizar o man:cron[8] para agendar as atualizações, use o comando `fre
====
-Para maiores informações sobre a atualização por meio do código fonte ou dos updates binários, acesse o link:{handbook}#updating-upgrading[capítulo sobre atualização] do Handbook do FreeBSD.
+Para maiores informações sobre a atualização por meio do código fonte ou dos updates binários, acesse o extref:{handbook}updating-upgrading[capítulo sobre atualização, updating-upgrading] do Handbook do FreeBSD.
[[procfs]]
== procfs: É passado, mas foi não esquecido
@@ -333,4 +334,4 @@ Alguns comandos comuns e equivalentes são os seguintes:
[[conclusion]]
== Conclusão
-EEste documento forneceu uma visão geral do FreeBSD. Veja o link:{handbook}[Handbook do FreeBSD] para uma cobertura mais profunda desses tópicos, assim como outros não cobertos por este documento.
+EEste documento forneceu uma visão geral do FreeBSD. Veja o extref:{handbook}[Handbook do FreeBSD] para uma cobertura mais profunda desses tópicos, assim como outros não cobertos por este documento.
diff --git a/documentation/content/pt-br/articles/mailing-list-faq/_index.adoc b/documentation/content/pt-br/articles/mailing-list-faq/_index.adoc
index 9403082d08..c96b9311ef 100644
--- a/documentation/content/pt-br/articles/mailing-list-faq/_index.adoc
+++ b/documentation/content/pt-br/articles/mailing-list-faq/_index.adoc
@@ -3,7 +3,6 @@ title: Perguntas Frequentes Sobre as Listas de Discussão do FreeBSD
authors:
- author: Projeto de Documentação do FreeBSD
copyright: 2004-2005 Projeto de Documentação do FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: []
---
@@ -16,24 +15,26 @@ trademarks: []
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/mailing-list-faq/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -93,7 +94,7 @@ A participação em listas de discussão, assim como a participação em qualque
=== O que devo fazer antes de postar?
-Você já deu o passo mais importante ao ler este documento. Entretanto, se você é novo no FreeBSD, você primeiro precisa se familiarizar com o software, e a história social que o envolve lendo os numerosos https://www.FreeBSD.org/docs/books/[livros e artigos] que estão disponíveis. Itens de interesse particular incluem o documento link:{faq}[Perguntas Frequentes do FreeBSD (FAQ)], o link:{handbook}[Handbook do FreeBSD], e os artigos link:{freebsd-questions-article}[Como obter melhores resultados na lista de discussão FreeBSD-questions], link:{explaining-bsd}[Explicando o BSD], e link:{new-users}[Primeiros passos no FreeBSD].
+Você já deu o passo mais importante ao ler este documento. Entretanto, se você é novo no FreeBSD, você primeiro precisa se familiarizar com o software, e a história social que o envolve lendo os numerosos https://www.FreeBSD.org/docs/books/[livros e artigos] que estão disponíveis. Itens de interesse particular incluem o documento extref:{faq}[Perguntas Frequentes do FreeBSD (FAQ)], o extref:{handbook}[Handbook do FreeBSD], e os artigos extref:{freebsd-questions-article}[Como obter melhores resultados na lista de discussão FreeBSD-questions], extref:{explaining-bsd}[Explicando o BSD], e extref:{new-users}[Primeiros passos no FreeBSD].
É sempre considerado errado fazer uma pergunta que já foi respondida nos documentos acima. Isto não é porque os voluntários que trabalham neste projeto são pessoas particularmente más, mas depois de um certo número de vezes respondendo às mesmas perguntas repetidas vezes, a frustração começa a surgir. Isto é particularmente verdadeiro se houver uma resposta existente para uma pergunta que já está disponível. Tenha sempre em mente que quase todo o trabalho feito no FreeBSD é feito por voluntários, e que somos apenas humanos.
@@ -158,7 +159,7 @@ Não há dúvida de que os arquivos são bastante extensos e algumas questões r
[[bikeshed]]
== O que é um "Bikeshed" (Garagem de bicicletas)?
-Literalmente, uma `Bikeshed` é um pequeno abrigo ao ar livre no qual se pode armazenar o meio de transporte de duas rodas. No entanto, no jargão do FreeBSD, o termo refere-se a tópicos que são simples o suficiente para que (quase) qualquer um possa opinar sobre ele, e geralmente (quase) todos o fazem. A gênese desse termo é explicada com mais detalhes link:{faq}#bikeshed-painting[neste documento]. Você simplesmente deve ter um conhecimento prático deste conceito antes de postar em qualquer lista de discussão do FreeBSD.
+Literalmente, uma `Bikeshed` é um pequeno abrigo ao ar livre no qual se pode armazenar o meio de transporte de duas rodas. No entanto, no jargão do FreeBSD, o termo refere-se a tópicos que são simples o suficiente para que (quase) qualquer um possa opinar sobre ele, e geralmente (quase) todos o fazem. A gênese desse termo é explicada com mais detalhes extref:{faq}[neste documento, bikeshed-painting]. Você simplesmente deve ter um conhecimento prático deste conceito antes de postar em qualquer lista de discussão do FreeBSD.
Mais genericamente, um Bikeshed é um tópico que tenderá a gerar Meta-discussões imediatas e interações hostis com usuários você ainda nem conhece.
@@ -168,7 +169,7 @@ Por favor, ajude-nos a manter as listas de discussão úteis para o maior numero
== Agradecimentos
Greg Lehey mailto:grog@FreeBSD.org[grog@FreeBSD.org]::
-Autor original da maior parte do material sobre etiqueta nas listas de discussão, retirada do artigo sobre link:{freebsd-questions-article}[Como para obter os melhores resultados da lista de discussão FreeBSD-questions].
+Autor original da maior parte do material sobre etiqueta nas listas de discussão, retirada do artigo sobre extref:{freebsd-questions-article}[Como para obter os melhores resultados da lista de discussão FreeBSD-questions].
Mark Linimon mailto:linimon@FreeBSD.org[linimon@FreeBSD.org]::
Pela criação do rascunho deste FAQ.
diff --git a/documentation/content/pt-br/articles/nanobsd/_index.adoc b/documentation/content/pt-br/articles/nanobsd/_index.adoc
index fc5ca09adc..a36ac3f521 100644
--- a/documentation/content/pt-br/articles/nanobsd/_index.adoc
+++ b/documentation/content/pt-br/articles/nanobsd/_index.adoc
@@ -3,7 +3,6 @@ title: Introdução ao NanoBSD
authors:
- author: Daniel Gerzo
copyright: 2006 Projeto de Documentação do FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -16,13 +15,27 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: articles/nanobsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumo
diff --git a/documentation/content/pt-br/articles/new-users/_index.adoc b/documentation/content/pt-br/articles/new-users/_index.adoc
index faf0391c84..86c790143d 100644
--- a/documentation/content/pt-br/articles/new-users/_index.adoc
+++ b/documentation/content/pt-br/articles/new-users/_index.adoc
@@ -3,7 +3,6 @@ title: Aos iniciantes em FreeBSD e UNIX
authors:
- author: Annelise Anderson
email: andrsn@andrsn.stanford.edu
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"]
---
@@ -16,13 +15,27 @@ trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: articles/new-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumo
diff --git a/documentation/content/pt-br/articles/pam/_index.adoc b/documentation/content/pt-br/articles/pam/_index.adoc
index 6f7ccba9ba..59f4a3a459 100644
--- a/documentation/content/pt-br/articles/pam/_index.adoc
+++ b/documentation/content/pt-br/articles/pam/_index.adoc
@@ -3,44 +3,9 @@ title: Módulos de Autenticação Plugáveis
authors:
- author: Dag-Erling Smørgrav
copyright: 2001-2003 Networks Associates Technology, Inc.
-releaseinfo: "$FreeBSD$"
trademarks: ["pam", "freebsd", "linux", "opengroup", "sun", "general"]
---
-////
-Copyright (c) 2001-2003 Networks Associates Technology, Inc.
-All rights reserved.
-
-This software was developed for the FreeBSD Project by ThinkSec AS and
-Network Associates Laboratories, the Security Research Division of
-Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035
-("CBOSS"), as part of the DARPA CHATS research program.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions
-are met:
-1. Redistributions of source code must retain the above copyright
- notice, this list of conditions and the following disclaimer.
-2. Redistributions in binary form must reproduce the above copyright
- notice, this list of conditions and the following disclaimer in the
- documentation and/or other materials provided with the distribution.
-3. The name of the author may not be used to endorse or promote
- products derived from this software without specific prior written
- permission.
-
-THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
-ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
-OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-SUCH DAMAGE.
-////
-
= Módulos de Autenticação Plugáveis
:doctype: article
:toc: macro
@@ -50,13 +15,30 @@ SUCH DAMAGE.
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: articles/pam/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+:include-path: static/source/articles/pam/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:include-path: ../../../../static/source/articles/pam/
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:include-path: ../../../../static/source/articles/pam/
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumo
diff --git a/documentation/content/pt-br/articles/pgpkeys/_index.adoc b/documentation/content/pt-br/articles/pgpkeys/_index.adoc
index 091ddb2130..880a4ceb72 100644
--- a/documentation/content/pt-br/articles/pgpkeys/_index.adoc
+++ b/documentation/content/pt-br/articles/pgpkeys/_index.adoc
@@ -1,6 +1,5 @@
---
title: Chaves OpenPGP
-releaseinfo: "$FreeBSD$"
---
= Chaves OpenPGP
@@ -12,16 +11,33 @@ releaseinfo: "$FreeBSD$"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: articles/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/pt-br/teams.adoc[lines=21..-1]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+:include-path: static/pgpkeys/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+// PGP keys are not included during the build
+// See 29e47423be969b7fcc7125977c1b22ddd33fc671 revision
+// (a wrong path is used as a workaround)
+:include-path: ../../../static/pgpkeys/
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+:include-path: ../../../static/pgpkeys/
+endif::[]
'''
diff --git a/documentation/content/pt-br/articles/port-mentor-guidelines/_index.adoc b/documentation/content/pt-br/articles/port-mentor-guidelines/_index.adoc
index b8856b1460..2bfa30a22e 100644
--- a/documentation/content/pt-br/articles/port-mentor-guidelines/_index.adoc
+++ b/documentation/content/pt-br/articles/port-mentor-guidelines/_index.adoc
@@ -3,7 +3,6 @@ title: Instruções para Mentores do Ports
organizations:
- organization: A Equipe de Gerenciamento do Ports do FreeBSD
copyright: 2011 Thomas Abthorpe, Chris Rees
-releaseinfo: "$FreeBSD$"
---
= Instruções para Mentores do Ports
@@ -15,24 +14,26 @@ releaseinfo: "$FreeBSD$"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/port-mentor-guidelines/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -75,7 +76,7 @@ Esperamos que os mentores revisem e testem todos os patches propostos, pelo meno
Esperamos que os mentores assumam a responsabilidade pelas ações de seus mentees. Um mentor deve acompanhar todos os commits que o mentee faz, tanto os aprovados quanto os implícitos.
-Esperamos que os mentores se certifiquem de que seus mentees leiam o link:{porters-handbook}[Porter's Handbook], o link:{pr-guidelines}[Diretrizes para manuseio de relatórios de problemas], e o link:{committers-guide}[Guia do Committer].Embora não seja necessário memorizar todos os detalhes, todo committer precisa ter uma visão geral dessas coisas para ser uma parte efetiva da comunidade (e evitar o maior número possível de erros de novato).
+Esperamos que os mentores se certifiquem de que seus mentees leiam o extref:{porters-handbook}[Porter's Handbook], o extref:{pr-guidelines}[Diretrizes para manuseio de relatórios de problemas], e o extref:{committers-guide}[Guia do Committer].Embora não seja necessário memorizar todos os detalhes, todo committer precisa ter uma visão geral dessas coisas para ser uma parte efetiva da comunidade (e evitar o maior número possível de erros de novato).
[[mentees]]
=== Selecionando um Mentee
diff --git a/documentation/content/pt-br/articles/pr-guidelines/_index.adoc b/documentation/content/pt-br/articles/pr-guidelines/_index.adoc
index d257423ad3..39f631b78a 100644
--- a/documentation/content/pt-br/articles/pr-guidelines/_index.adoc
+++ b/documentation/content/pt-br/articles/pr-guidelines/_index.adoc
@@ -3,7 +3,6 @@ title: Diretrizes para manuseio de relatórios de problemas
authors:
- author: Dag-Erling Smørgrav
- author: Hiten Pandya
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/pr-guidelines/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -485,4 +486,4 @@ Definir a categoria como `junk` torna óbvio que não há conteúdo útil dentro
Esta é uma lista de recursos relevantes para a escrita e processamento adequado de um relatório de problema. De forma alguma deve ser considerada completa.
-* link:{problem-reports}[Como escrever relatórios de problemas para o FreeBSD] - diretrizes para usuários que enviam um PR.
+* extref:{problem-reports}[Como escrever relatórios de problemas para o FreeBSD] - diretrizes para usuários que enviam um PR.
diff --git a/documentation/content/pt-br/articles/problem-reports/_index.adoc b/documentation/content/pt-br/articles/problem-reports/_index.adoc
index ff9aa2bd04..97bbf2b603 100644
--- a/documentation/content/pt-br/articles/problem-reports/_index.adoc
+++ b/documentation/content/pt-br/articles/problem-reports/_index.adoc
@@ -3,7 +3,6 @@ title: Escrevendo Relatórios de Problemas para o FreeBSD
authors:
- author: Dag-Erling Smørgrav
- author: Mark Linimon
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "intel", "sun", "general"]
---
@@ -16,13 +15,27 @@ trademarks: ["freebsd", "ibm", "intel", "sun", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: articles/problem-reports/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumo
diff --git a/documentation/content/pt-br/articles/rc-scripting/_index.adoc b/documentation/content/pt-br/articles/rc-scripting/_index.adoc
index 0a3149a4fc..2f4e667517 100644
--- a/documentation/content/pt-br/articles/rc-scripting/_index.adoc
+++ b/documentation/content/pt-br/articles/rc-scripting/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Yar Tikhiy
email: yar@FreeBSD.org
copyright: 2005-2006, 2012 The FreeBSD Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "netbsd", "general"]
---
@@ -17,24 +16,26 @@ trademarks: ["freebsd", "netbsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/rc-scripting/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -431,7 +432,7 @@ No entanto, o man:rc.subr[8] pode ser instruído a partir da linha de comando pa
[[rcng-hookup]]
== Conectando um script ao framework rc.d
-Depois que um script foi escrito, ele precisa ser integrado em [.filename]#rc.d>#. O passo crucial é instalar o script em [.filename]#/etc/rc.d# (para o sistema base) ou [.filename]#/usr/local/etc/rc.d# (para ports). Ambos [.filename]#bsd.prog.mk# e [.filename]#bsd.port.mk# fornecer ganchos convenientes para isso, e geralmente você não precisa se preocupar com a propriedade e o modo adequado. Os scripts do sistema devem ser instalados a partir do [.filename]#src /etc/rc.d# através do [.filename]#Makefile# encontrado lá. Os scripts de porta podem ser instalados usando `USE_RC_SUBR` conforme descrito em link:{porters-handbook}#rc-scripts[no Manual do Porter].
+Depois que um script foi escrito, ele precisa ser integrado em [.filename]#rc.d>#. O passo crucial é instalar o script em [.filename]#/etc/rc.d# (para o sistema base) ou [.filename]#/usr/local/etc/rc.d# (para ports). Ambos [.filename]#bsd.prog.mk# e [.filename]#bsd.port.mk# fornecer ganchos convenientes para isso, e geralmente você não precisa se preocupar com a propriedade e o modo adequado. Os scripts do sistema devem ser instalados a partir do [.filename]#src /etc/rc.d# através do [.filename]#Makefile# encontrado lá. Os scripts de porta podem ser instalados usando `USE_RC_SUBR` conforme descrito em extref:{porters-handbook}[no Manual do Porter, rc-scripts].
No entanto, devemos considerar antecipadamente o local do nosso script na sequência de inicialização do sistema. O serviço manipulado pelo nosso script provavelmente depende de outros serviços. Por exemplo, um daemon de rede não pode funcionar sem as interfaces de rede e o roteamento em funcionamento. Mesmo que um serviço pareça não exigir nada, dificilmente pode ser iniciado antes que os sistemas de arquivos básicos tenham sido verificados e montados.
diff --git a/documentation/content/pt-br/articles/releng/_index.adoc b/documentation/content/pt-br/articles/releng/_index.adoc
index cbc26986a4..ea2bd0c515 100644
--- a/documentation/content/pt-br/articles/releng/_index.adoc
+++ b/documentation/content/pt-br/articles/releng/_index.adoc
@@ -16,28 +16,26 @@ trademarks: ["freebsd", "intel", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:xrefstyle: full
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
-:imagesdir: ../../../images/articles/releng/
+:images-path: articles/releng/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/releng/
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/releng/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -45,7 +43,7 @@ Resumo
[NOTE]
====
-Este documento está desatualizado e não descreve com precisão os procedimentos atuais de lançamentos da equipe de Engenharia de Release (Versão) do FreeBSD. É retido para fins históricos. Os procedimentos atuais usados pela equipe de Engenharia de Release do FreeBSD estão disponíveis no artigo link:{freebsd-releng}[Engenharia de Release do FreeBSD].
+Este documento está desatualizado e não descreve com precisão os procedimentos atuais de lançamentos da equipe de Engenharia de Release (Versão) do FreeBSD. É retido para fins históricos. Os procedimentos atuais usados pela equipe de Engenharia de Release do FreeBSD estão disponíveis no artigo extref:{freebsd-releng}[Engenharia de Release do FreeBSD].
====
Este artigo descreve a abordagem usada pela equipe de engenharia de release do FreeBSD para produzir versões do Sistema Operacional FreeBSD com qualidade de produção. Ele detalha a metodologia utilizada para as versões oficiais do FreeBSD e descreve as ferramentas disponíveis para aqueles interessados em produzir versões customizadas do FreeBSD para uso corporativo ou para uso em produtos comerciais.
@@ -57,7 +55,7 @@ toc::[]
[[introduction]]
== Introdução
-O desenvolvimento do FreeBSD é um processo muito aberto. O FreeBSD é composto por contribuições de milhares de pessoas em todo o mundo. O Projeto FreeBSD fornece acesso ao Subversion footnote:[Subversion, http://subversion.apache.org] para o público em geral para que outros possam ter acesso a mensagens de log, diffs (patches) entre branches (ramificações) de desenvolvimento e outros aprimoramentos de produtividade que o gerenciamento formal de código-fonte proporciona. Isso tem sido uma grande ajuda na atração de desenvolvedores talentosos para o FreeBSD. No entanto, acho que todos concordariam que o caos logo se manifestaria se o acesso para modificar o repositório principal fosse aberto a todos na Internet. Dessa forma, apenas um grupo "seleto" de quase 300 pessoas recebe acesso de escrita ao repositório do Subversion. Estes link:{contributors}#staff-committers[committers] footnote:[link:{contributors}#staff-committers[committers]] são normalmente as pessoas que fazem a maior parte do desenvolvimento do FreeBSD. Um https://www.FreeBSD.org/administration/#t-core[Core team]footnote:[https://www.FreeBSD.org/administration/#t-core[Core Team do FreeBSD]] eleito fornece algum nível de orientação sobre o projeto.
+O desenvolvimento do FreeBSD é um processo muito aberto. O FreeBSD é composto por contribuições de milhares de pessoas em todo o mundo. O Projeto FreeBSD fornece acesso ao Subversion footnote:[Subversion, http://subversion.apache.org] para o público em geral para que outros possam ter acesso a mensagens de log, diffs (patches) entre branches (ramificações) de desenvolvimento e outros aprimoramentos de produtividade que o gerenciamento formal de código-fonte proporciona. Isso tem sido uma grande ajuda na atração de desenvolvedores talentosos para o FreeBSD. No entanto, acho que todos concordariam que o caos logo se manifestaria se o acesso para modificar o repositório principal fosse aberto a todos na Internet. Dessa forma, apenas um grupo "seleto" de quase 300 pessoas recebe acesso de escrita ao repositório do Subversion. Estes extref:{contributors}[committers, staff-committers] footnote:[extref:{contributors}[committers, staff-committers]] são normalmente as pessoas que fazem a maior parte do desenvolvimento do FreeBSD. Um https://www.FreeBSD.org/administration/#t-core[Core team]footnote:[https://www.FreeBSD.org/administration/#t-core[Core Team do FreeBSD]] eleito fornece algum nível de orientação sobre o projeto.
O ritmo acelerado de desenvolvimento do `FreeBSD` torna a principal branch de desenvolvimento inadequada para o uso diário pelo público em geral. Em particular, são necessários esforços de estabilização para polir o sistema de desenvolvimento em uma release de qualidade apropriada para uso em ambiente produtivo. Para resolver este conflito, o desenvolvimento continua em várias trilhas paralelas. A principal branch de desenvolvimento é a _HEAD_ ou _trunk_ da nossa árvore do Subversion, conhecida como "FreeBSD-CURRENT" ou "-CURRENT" quando abreviado.
@@ -65,7 +63,7 @@ Um conjunto de branches mais estáveis é mantido, e é conhecido como "FreeBSD-
O termo _stable_ no nome da branch refere-se à estabilidade presumida da Interface Binária da Aplicação (ABI), que é prometida pelo projeto. Isso significa que um aplicativo de usuário compilado em uma versão mais antiga do sistema da mesma branch funciona em um sistema mais novo da mesma branch. A estabilidade do ABI melhorou muito em relação às versões anteriores. Na maioria dos casos, os binários dos sistemas _STABLE_ mais antigos são executados sem modificações em sistemas mais recentes, incluindo o __HEAD__, assumindo que as interfaces de gerenciamento do sistema não são usadas.
-No período intermediário entre as versões, snapshots semanais são construídos automaticamente pelas máquinas de build do Projeto FreeBSD e disponibilizados para download em `ftp://ftp.FreeBSD.org/pub/FreeBSD/snapshots/`. A ampla disponibilidade de snapshots binários e a tendência da nossa comunidade de usuários para acompanhar o desenvolvimento do -STABLE com o Subversion e `"make buildworld"` footnote:[link:{handbook}#makeworld[Re-construindo o 'mundo']] ajuda a manter o FreeBSD-STABLE em uma condição muito confiável, mesmo antes que as atividades de garantia de qualidade aumentem na proximidade de um grande lançamento.
+No período intermediário entre as versões, snapshots semanais são construídos automaticamente pelas máquinas de build do Projeto FreeBSD e disponibilizados para download em `ftp://ftp.FreeBSD.org/pub/FreeBSD/snapshots/`. A ampla disponibilidade de snapshots binários e a tendência da nossa comunidade de usuários para acompanhar o desenvolvimento do -STABLE com o Subversion e `"make buildworld"` footnote:[extref:{handbook}updating-upgrading[Re-construindo o 'mundo', makeworld]] ajuda a manter o FreeBSD-STABLE em uma condição muito confiável, mesmo antes que as atividades de garantia de qualidade aumentem na proximidade de um grande lançamento.
Além dos snapshots de instalação no formato ISO, imagens semanais de máquinas virtuais também são fornecidas para uso com o VirtualBox, o qemu ou outros softwares populares de emulação. As imagens de máquinas virtuais podem ser baixadas em `ftp://ftp.FreeBSD.org/pub/FreeBSD/snapshots/VM-IMAGES/`.
@@ -128,7 +126,7 @@ Quando várias imagens BETA já tiverem sido disponibilizadas para testes genera
Em todos os exemplos abaixo, `$FSVN` refere-se ao local do repositório Subversion do FreeBSD, `svn+ssh://svn.FreeBSD.org/base/`.
====
-O layout das branchs do FreeBSD no Subversion é descrito no link:{committers-guide}#subversion-primer-base-layout[Guia do Commiter]. O primeiro passo na criação de uma branch é identificar a revisão do código fonte do `stable/_X_`, a partir do qual você deseja criar a nova _branch_.
+O layout das branchs do FreeBSD no Subversion é descrito no extref:{committers-guide}[Guia do Commiter, subversion-primer-base-layout]. O primeiro passo na criação de uma branch é identificar a revisão do código fonte do `stable/_X_`, a partir do qual você deseja criar a nova _branch_.
[source,shell]
....
@@ -227,7 +225,7 @@ Quando o comando `svn cp` do Subversion é usado para criar uma __tag de versão
[[release-build]]
== Construção da Release (Versão)
-As "releases" do FreeBSD podem ser construídas por qualquer pessoa com uma máquina rápida e acesso a um repositório de código-fonte. (Isso deveria ser todo mundo, já que oferecemos acesso ao Subversion! Veja a seção sobre link:{handbook}#svn[Subversion] no Handbook para detalhes.) O _único_ requisito especial é que o dispositivo man:md[4] esteja disponível. Se o dispositivo não estiver carregado em seu kernel, então o módulo do kernel deve ser carregado automaticamente quando o man:mdconfig[8] for executado durante a fase de criação da mídia de boot. Todas as ferramentas necessárias para construir uma release estão disponíveis no repositório Subversion em [.filename]#src/release#. Essas ferramentas visam fornecer uma maneira consistente de construir versões do FreeBSD. Uma release completa pode ser construída com apenas um único comando, incluindo a criação de imagens ISO adequadas para gravação em CD-ROM ou DVD e um diretório para instalação por FTP. A pagina de manual man:release[7] documenta completamente o script `src/release/generate-release.sh` que é usado para construir uma release. O `generate-release.sh` é um invólucro em torno do target do Makefile: `make release`.
+As "releases" do FreeBSD podem ser construídas por qualquer pessoa com uma máquina rápida e acesso a um repositório de código-fonte. (Isso deveria ser todo mundo, já que oferecemos acesso ao Subversion! Veja a seção sobre extref:{handbook}mirrors[Subversion, svn] no Handbook para detalhes.) O _único_ requisito especial é que o dispositivo man:md[4] esteja disponível. Se o dispositivo não estiver carregado em seu kernel, então o módulo do kernel deve ser carregado automaticamente quando o man:mdconfig[8] for executado durante a fase de criação da mídia de boot. Todas as ferramentas necessárias para construir uma release estão disponíveis no repositório Subversion em [.filename]#src/release#. Essas ferramentas visam fornecer uma maneira consistente de construir versões do FreeBSD. Uma release completa pode ser construída com apenas um único comando, incluindo a criação de imagens ISO adequadas para gravação em CD-ROM ou DVD e um diretório para instalação por FTP. A pagina de manual man:release[7] documenta completamente o script `src/release/generate-release.sh` que é usado para construir uma release. O `generate-release.sh` é um invólucro em torno do target do Makefile: `make release`.
=== Construindo uma Release (Versão)
@@ -316,7 +314,7 @@ Um link simbólico para [.filename]#../../../ports/arch/packages-X.Y-release#.
[.filename]#/pub/FreeBSD/releases/arch/ISO-IMAGES/X.Y/X.Y-RELEASE-arch-*.iso#::
As imagens ISO. O "*" é o [.filename]#disc1#, [.filename]#disc2#, etc. Somente se houver um [.filename]#disc1# e houver um CD alternativo para o primeiro disco de instalação (por exemplo, uma instalação simplificada sem sistema de janelas) também pode haver um [.filename]#mini#.
-Para mais informações sobre a arquitetura do sistema de espelhamento dos sites de FTP para distribuição do FreeBSD, por favor veja o artigo link:{hubs}[Espelhando o FreeBSD].
+Para mais informações sobre a arquitetura do sistema de espelhamento dos sites de FTP para distribuição do FreeBSD, por favor veja o artigo extref:{hubs}[Espelhando o FreeBSD].
Pode levar de muitas horas a dois dias após a atualização do `ftp-master` antes que a maioria dos sites de FTP da camada 1 tenham o novo software, dependendo se um conjunto de pacotes foi ou não carregado ao mesmo tempo. É imperativo que os engenheiros de release coordenem com os http://lists.FreeBSD.org/mailman/listinfo/mirror-announce[administradores dos sites espelho do FreeBSD] antes de anunciar a disponibilidade geral de novo software nos sites FTP. Idealmente, o pacote da release deve ser carregado pelo menos quatro dias antes do dia de lançamento. Os bits da release devem ser carregados entre 24 e 48 horas antes do horário de lançamento planejado com as permissões de arquivo "other" desativadas. Isso permitirá que os sites espelho façam o download, mas o público em geral não poderá baixá-los dos sites espelho. Um e-mail deve ser enviado para a lista dos http://lists.FreeBSD.org/mailman/listinfo/mirror-announce[administradores do site espelho do FreeBSD] no momento em que os bits da release forem publicados, informando que a release foi preparada e informando o horário em que os sites espelho devem começar a permitir o acesso. Certifique-se de incluir um fuso horário com a hora, por exemplo, torná-lo relativo ao GMT.
@@ -332,7 +330,7 @@ Embora o FreeBSD forme um sistema operacional completo, não há nada que force
=== Usando o script `bsdinstall`
-A ferramenta de instalação e configuração do sistema FreeBSD, man:bsdinstall[8], pode ser programada para fornecer instalações automatizadas para sites grandes. Essa funcionalidade pode ser usada em conjunto com Intel(R) PXE footnote:[link:{handbook}#network-pxe-nfs[Network PXE NFS]] para inicializar sistemas da rede.
+A ferramenta de instalação e configuração do sistema FreeBSD, man:bsdinstall[8], pode ser programada para fornecer instalações automatizadas para sites grandes. Essa funcionalidade pode ser usada em conjunto com Intel(R) PXE footnote:[extref:{handbook}advanced-networking[Network PXE NFS, network-pxe-nfs]] para inicializar sistemas da rede.
[[lessons-learned]]
== Lições Aprendidas do FreeBSD 4.4
diff --git a/documentation/content/pt-br/articles/remote-install/_index.adoc b/documentation/content/pt-br/articles/remote-install/_index.adoc
index d0695b03b9..b6d711f019 100644
--- a/documentation/content/pt-br/articles/remote-install/_index.adoc
+++ b/documentation/content/pt-br/articles/remote-install/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Daniel Gerzo
email: danger@FreeBSD.org
copyright: 2008 Projeto de Documentação do FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -17,24 +16,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/remote-install/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -199,7 +200,7 @@ No início, marque todos os discos do sistema como vazios. Repita o seguinte com
# dd if=/dev/zero of=/dev/ad0 count=2
....
-Em seguida, crie as slices e atribua um label usando sua ferramenta preferida. Embora seja considerado mais fácil usar o Sysinstall, um método poderoso e provavelmente com menos bugs será usar as ferramentas padrões de console UNIX(R), como o man:fdisk[8] e o man:bsdlabel[8], o qual também será abordado nesta seção. A primeira opção está bem documentada no capítulo link:{handbook}#install-steps[Instalando o FreeBSD] do Handbook do FreeBSD. Como foi mencionado na introdução, este artigo apresentará como configurar um sistema com recursos RAID-1 e ZFS. Nossa configuração consistirá de uma pequena partição [.filename]#/# (root) , de um dataset composto por um [.filename]#/usr# e um [.filename]#/var# , todos espelhados com o man:gmirror[8], e o restante do espaço em disco alocado para um sistema de arquivos man:zpool[8] espelhado do ZFS. Por favor, observe que o sistema de arquivos ZFS será configurado depois que o sistema operacional FreeBSD for instalado e inicializado com sucesso.
+Em seguida, crie as slices e atribua um label usando sua ferramenta preferida. Embora seja considerado mais fácil usar o Sysinstall, um método poderoso e provavelmente com menos bugs será usar as ferramentas padrões de console UNIX(R), como o man:fdisk[8] e o man:bsdlabel[8], o qual também será abordado nesta seção. A primeira opção está bem documentada no capítulo extref:{handbook}install-steps[Instalando o FreeBSD, install] do Handbook do FreeBSD. Como foi mencionado na introdução, este artigo apresentará como configurar um sistema com recursos RAID-1 e ZFS. Nossa configuração consistirá de uma pequena partição [.filename]#/# (root) , de um dataset composto por um [.filename]#/usr# e um [.filename]#/var# , todos espelhados com o man:gmirror[8], e o restante do espaço em disco alocado para um sistema de arquivos man:zpool[8] espelhado do ZFS. Por favor, observe que o sistema de arquivos ZFS será configurado depois que o sistema operacional FreeBSD for instalado e inicializado com sucesso.
O exemplo a seguir descreverá como criar slices e labels, inicializar o man:gmirror[8] em cada partição e como criar um sistema de arquivos UFS2 em cada partição espelhada:
diff --git a/documentation/content/pt-br/articles/serial-uart/_index.adoc b/documentation/content/pt-br/articles/serial-uart/_index.adoc
index 7f06b2880a..eb5e569bef 100644
--- a/documentation/content/pt-br/articles/serial-uart/_index.adoc
+++ b/documentation/content/pt-br/articles/serial-uart/_index.adoc
@@ -3,7 +3,6 @@ title: Tutorial sobre Comunicações Seriais e UART
authors:
- author: Frank Durda
email: uhclem@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "microsoft", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "microsoft", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
+:images-path: articles/serial-uart/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -758,7 +759,7 @@ Os procedimentos para fazer uma placa multiporta Boca 16 funcionar com o FreeBSD
Uma nota importante - os chips UART reais para a Boca 16 estão nos conectores, não na própria placa interna. Então, se você os tiver desconectado, os probes destas portas falharão. Eu nunca testei a inicialização com a caixa desconectada e conectando-a novamente, e sugiro que você também não o faça.
-Se você ainda não tiver um arquivo de configuração de kernel personalizado, consulte o capitulo link:{handbook}kernelconfig/[Configuração do Kernel] no Handbook do FreeBSD para os procedimentos gerais. A seguir estão as especificações para a placa Boca 16 e supõe-se que você esteja usando o nome do kernel MYKERNEL e editando com o vi.
+Se você ainda não tiver um arquivo de configuração de kernel personalizado, consulte o capitulo extref:{handbook}/[Configuração do Kernel, kernelconfig] no Handbook do FreeBSD para os procedimentos gerais. A seguir estão as especificações para a placa Boca 16 e supõe-se que você esteja usando o nome do kernel MYKERNEL e editando com o vi.
[.procedure]
. Adicione a linha
diff --git a/documentation/content/pt-br/articles/solid-state/_index.adoc b/documentation/content/pt-br/articles/solid-state/_index.adoc
index 3ed1debea0..5a341e5b9d 100644
--- a/documentation/content/pt-br/articles/solid-state/_index.adoc
+++ b/documentation/content/pt-br/articles/solid-state/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: John Kozubik
email: john@kozubik.com
copyright: 2001, 2009 Projeto de Documentação do FreeBSD
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -17,13 +16,27 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: articles/solid-state/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumo
diff --git a/documentation/content/pt-br/articles/vinum/_index.adoc b/documentation/content/pt-br/articles/vinum/_index.adoc
index 5d0589c670..cdd219191c 100644
--- a/documentation/content/pt-br/articles/vinum/_index.adoc
+++ b/documentation/content/pt-br/articles/vinum/_index.adoc
@@ -4,16 +4,6 @@ authors:
- author: Greg Lehey
---
-////
-The Vinum Volume Manager
-By Greg Lehey (grog at lemis dot com)
-
-Added to the Handbook by Hiten Pandya <hmp@FreeBSD.org>
-and Tom Rhodes <trhodes@FreeBSD.org>
-
-For the FreeBSD Documentation Project
-////
-
= O Gerenciador de Volume vinum
:doctype: article
:toc: macro
@@ -23,27 +13,26 @@ For the FreeBSD Documentation Project
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/pt-br/urls.adoc[]
-:imagesdir: ../../../images/articles/vinum/
+:images-path: articles/vinum/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/pt-br/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/vinum/
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/pt-br/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/vinum/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -61,7 +50,7 @@ Este capítulo fornece uma visão geral dos possíveis problemas com o armazenam
[NOTE]
====
-Começando com o FreeBSD 5, o [.filename]#vinum# foi reescrito para se encaixar na link:{handbook}#geom[Arquitetura GEOM], mantendo as idéias originais, a terminologia e os metadados no disco. Esta reescrita é chamada _gvinum_ (para _GEOM vinum_). Enquanto este capítulo usa o termo [.filename]#vinum#, qualquer invocação de comandos deve ser executada com o `gvinum`. O nome do módulo do kernel mudou do original [.filename]#vinum.ko# para [.filename]#geom_vinum.ko#, e todos os device nodes residem em [.filename]#/dev/gvinum# em vez de [.filename]#/dev/vinum#. A partir do FreeBSD 6, a implementação original do [.filename]#vinum# não está mais disponível no código base.
+Começando com o FreeBSD 5, o [.filename]#vinum# foi reescrito para se encaixar na extref:{handbook}geom[Arquitetura GEOM, geom], mantendo as idéias originais, a terminologia e os metadados no disco. Esta reescrita é chamada _gvinum_ (para _GEOM vinum_). Enquanto este capítulo usa o termo [.filename]#vinum#, qualquer invocação de comandos deve ser executada com o `gvinum`. O nome do módulo do kernel mudou do original [.filename]#vinum.ko# para [.filename]#geom_vinum.ko#, e todos os device nodes residem em [.filename]#/dev/gvinum# em vez de [.filename]#/dev/vinum#. A partir do FreeBSD 6, a implementação original do [.filename]#vinum# não está mais disponível no código base.
====
[[vinum-access-bottlenecks]]
@@ -579,11 +568,11 @@ No prompt solicitando que um sistema de arquivos raiz seja montado, qualquer dis
==== Apenas o bootstrap primário carrega
-Se o [.filename]#/boot/loader# falhar ao carregar, mas o bootstrap primário ainda carregar (visível por um único traço na coluna esquerda da tela logo após o processo de boot ser iniciado), uma tentativa pode ser feita para interromper o bootstrap primário pressionando kbd:[espaço]. Isso fará com que o bootstrap pare no link:{handbook}#boot-boot1[estágio dois]. Uma tentativa pode ser feita aqui para inicializar uma partição alternativa, como a partição que contém o sistema de arquivos raiz anterior que foi movido de `a`.
+Se o [.filename]#/boot/loader# falhar ao carregar, mas o bootstrap primário ainda carregar (visível por um único traço na coluna esquerda da tela logo após o processo de boot ser iniciado), uma tentativa pode ser feita para interromper o bootstrap primário pressionando kbd:[espaço]. Isso fará com que o bootstrap pare no extref:{handbook}boot[estágio dois, boot-boot1]. Uma tentativa pode ser feita aqui para inicializar uma partição alternativa, como a partição que contém o sistema de arquivos raiz anterior que foi movido de `a`.
[[vinum-root-panic]]
==== Nada carrega e o Bootstrap entra em panic
Esta situação acontecerá se o bootstrap tiver sido destruído pela instalação do [.filename]#vinum#. Infelizmente, o [.filename]#vinum# acidentalmente deixa apenas 4 KB no início de sua partição livre antes de começar a escrever suas informações de cabeçalho [.filename]#vinum#. No entanto, o estágio um e dois bootstraps mais o bsdlabel exigem 8 KB. Portanto, se uma partição [.filename]#vinum# tiver sido iniciada no offset 0 dentro de uma slice ou disco que deveria ser inicializável, a configuração do [.filename]#vinum# irá estragar o bootstrap.
-Da mesma forma, se a situação acima foi recuperada, inicializando de uma mídia "Fixit", e o bootstrap foi reinstalado usando `bsdlabel -B` como descrito em link:{handbook}#boot-boot1[Estágio Um e Estágio Dois], o bootstrap irá estragar o cabeçalho [.filename]#vinum# e o [.filename]#vinum# não encontrará mais seu(s) disco(s). Entretando nenhum dado de configuração real do [.filename]#vinum# e nenhum volume [.filename]#vinum# de dados foi descartado, sendo possível recuperá-los digitando de novo exatamente as mesmas configurações do [.filename]#vinum#, a situação é difícil de corrigir de forma definitiva. Pois será necessário mover toda a partição [.filename]#vinum# em pelo menos 4 KB, para que o cabeçalho [.filename]#vinum# e o bootstrap do sistema não colidam mais.
+Da mesma forma, se a situação acima foi recuperada, inicializando de uma mídia "Fixit", e o bootstrap foi reinstalado usando `bsdlabel -B` como descrito em extref:{handbook}boot[Estágio Um e Estágio Dois, boot-boot1], o bootstrap irá estragar o cabeçalho [.filename]#vinum# e o [.filename]#vinum# não encontrará mais seu(s) disco(s). Entretando nenhum dado de configuração real do [.filename]#vinum# e nenhum volume [.filename]#vinum# de dados foi descartado, sendo possível recuperá-los digitando de novo exatamente as mesmas configurações do [.filename]#vinum#, a situação é difícil de corrigir de forma definitiva. Pois será necessário mover toda a partição [.filename]#vinum# em pelo menos 4 KB, para que o cabeçalho [.filename]#vinum# e o bootstrap do sistema não colidam mais.
diff --git a/documentation/content/pt-br/articles/vm-design/_index.adoc b/documentation/content/pt-br/articles/vm-design/_index.adoc
index 5187c09688..a5be48d465 100644
--- a/documentation/content/pt-br/articles/vm-design/_index.adoc
+++ b/documentation/content/pt-br/articles/vm-design/_index.adoc
@@ -3,7 +3,6 @@ title: Elementos de design do sistema de VM do FreeBSD
authors:
- author: Matthew Dillon
email: dillon@apollo.backplane.com
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "linux", "microsoft", "opengroup", "daemon-news", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "linux", "microsoft", "opengroup", "daemon-news", "gener
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/articles/vm-design/
+:images-path: articles/vm-design/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/articles/vm-design/
endif::[]
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/articles/vm-design/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
diff --git a/documentation/content/pt-br/books/dev-model/_index.adoc b/documentation/content/pt-br/books/dev-model/_index.adoc
index ef16300d55..48a07591b8 100644
--- a/documentation/content/pt-br/books/dev-model/_index.adoc
+++ b/documentation/content/pt-br/books/dev-model/_index.adoc
@@ -3,7 +3,8 @@ title: Um modelo de projeto para o projeto FreeBSD
authors:
- author: Niklas Saers
copyright: Copyright © 2002-2005 Niklas Saers
-trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
+trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
+isIndex: true
---
////
@@ -37,54 +38,34 @@ SUCH DAMAGE.
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+:images-path: books/dev-model/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../images/{images-path}
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
-:imagesdir: ../../../images/books/dev-model/
-:chapters-path: content/pt-br/books/dev-model/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/dev-model/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/pt-br/mailing-lists.adoc[]
-include::../../../../shared/pt-br/teams.adoc[]
-include::../../../../shared/pt-br/urls.adoc[]
-:imagesdir: ../../../../static/images/books/dev-model/
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/pt-br/mailing-lists.adoc[]
-include::../../../../shared/pt-br/teams.adoc[]
-include::../../../../shared/pt-br/urls.adoc[]
-:imagesdir: ../../../../static/images/books/dev-model/
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -746,28 +727,28 @@ O projeto de Documentação possui uma cartilha. Isso é usado para apresentar n
[FreeBSD, 2000A] Copyright © 2002 O projeto FreeBSD. Estatuto do Core. https://www.freebsd.org/internal/bylaws/.
[[freebsd-developer-handbook]]
-[FreeBSD, 2002A] Copyright © 2002 O Projeto de Documentação do FreeBSD. Manual do desenvolvedor do FreeBSD. link:{developers-handbook}.
+[FreeBSD, 2002A] Copyright © 2002 O Projeto de Documentação do FreeBSD. Manual do desenvolvedor do FreeBSD. extref:{developers-handbook}[Manual do desenvolvedor do FreeBSD].
[[bsd-election2002]]
[FreeBSD, 2002B] Copyright © 2002 O projeto FreeBSD. Eleição da equipe do Core em 2002. http://election.uk.freebsd.org/candidates.html.
[[freebsd-handle-pr]]
-[FreeBSD, 2002C] Dag-Erling Smørgrav e Hiten Pandya. Copyright © 2002 O Projeto de Documentação do FreeBSD. O projeto de documentação do FreeBSD. Diretrizes para manuseio de Relatórios de Problemas. link:{pr-guidelines}.
+[FreeBSD, 2002C] Dag-Erling Smørgrav e Hiten Pandya. Copyright © 2002 O Projeto de Documentação do FreeBSD. O projeto de documentação do FreeBSD. Diretrizes para manuseio de Relatórios de Problemas. extref:{pr-guidelines}[Diretrizes para manuseio de Relatórios de Problemas].
[[freebsd-send-pr]]
-[FreeBSD, 2002D] Dag-Erling Smørgrav. Copyright © 2002 O Projeto de Documentação do FreeBSD. O projeto de documentação do FreeBSD. Escrevendo Relatórios de Problemas do FreeBSD. link:{problem-reports}.
+[FreeBSD, 2002D] Dag-Erling Smørgrav. Copyright © 2002 O Projeto de Documentação do FreeBSD. O projeto de documentação do FreeBSD. Escrevendo Relatórios de Problemas do FreeBSD. extref:{problem-reports}[Escrevendo Relatórios de Problemas do FreeBSD].
[[freebsd-committer]]
-[FreeBSD, 2001] Copyright © 2001 O Projeto de Documentação do FreeBSD. O projeto de documentação do FreeBSD. Guia para Commiters. link:{committers-guide}.
+[FreeBSD, 2001] Copyright © 2001 O Projeto de Documentação do FreeBSD. O projeto de documentação do FreeBSD. Guia para Commiters. extref:{committers-guide}[Guia para Commiters].
[[freebsd-releng]]
-[FreeBSD, 2002E] Murray Stokely. Copyright © 2002 O Projeto de Documentação do FreeBSD. O projeto de documentação do FreeBSD. Engenharia de Release do FreeBSD. link:{releng}.
+[FreeBSD, 2002E] Murray Stokely. Copyright © 2002 O Projeto de Documentação do FreeBSD. O projeto de documentação do FreeBSD. Engenharia de Release do FreeBSD. extref:{releng}[Engenharia de Release do FreeBSD].
[[ref-bsd-handbook]]
-[FreeBSD, 2003A] Projeto de Documentação do FreeBSD. Manual do FreeBSD. link:{handbook}.
+[FreeBSD, 2003A] Projeto de Documentação do FreeBSD. Manual do FreeBSD. extref:{handbook}[Manual do FreeBSD].
[[freebsd-contributors]]
-[FreeBSD, 2002F] Copyright © 2002 O Projeto de Documentação do FreeBSD. O projeto de documentação do FreeBSD. Colaboradores para o FreeBSD. link:{contributors}.
+[FreeBSD, 2002F] Copyright © 2002 O Projeto de Documentação do FreeBSD. O projeto de documentação do FreeBSD. Colaboradores para o FreeBSD. extref:{contributors}[Colaboradores para o FreeBSD].
[[freebsd-election]]
[FreeBSD, 2002G] Copyright © 2002 O projeto FreeBSD. O projeto FreeBSD. Eleições da equipe do Core em 2002. http://election.uk.freebsd.org.
diff --git a/documentation/content/pt-br/books/faq/_index.adoc b/documentation/content/pt-br/books/faq/_index.adoc
index 4f1fd80b49..53200e6813 100644
--- a/documentation/content/pt-br/books/faq/_index.adoc
+++ b/documentation/content/pt-br/books/faq/_index.adoc
@@ -1,8 +1,8 @@
---
title: Perguntas freqüentes para o FreeBSD 11.X e 12.X
authors:
-releaseinfo: "$FreeBSD$"
-trademarks: []
+trademarks: []
+isIndex: true
---
= Perguntas freqüentes para o FreeBSD {rel2-relx} e {rel-relx}
@@ -10,60 +10,46 @@ trademarks: []
:toc: macro
:toclevels: 1
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:rel-numbranch: 3
-:rel-head: 13-CURRENT
-:rel-head-relx: 13.X
+:images-path: books/faq/
+:rel-numbranch: 4
+:rel-head: 14-CURRENT
+:rel-head-relx: 14.X
:rel-head-releng: head/
-:rel-relx: 12.X
-:rel-stable: 12-STABLE
-:rel-releng: stable/12/
+:rel-relx: 13.X
+:rel-stable: 13-STABLE
+:rel-releng: stable/13/
:rel-relengdate: December 2018
-:rel2-relx: 11.X
-:rel2-stable: 11-STABLE
-:rel2-releng: stable/11/
-:rel2-relengdate: October 2016
-
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+:rel2-relx: 12.X
+:rel2-stable: 12-STABLE
+:rel2-releng: stable/12/
+:rel2-relengdate: December 2018
+:rel3-relx: 11.X
+:rel3-stable: 11-STABLE
+:rel3-releng: stable/11/
+:rel3-relengdate: October 2016
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/pt-br/mailing-lists.adoc[]
-include::../../../../shared/pt-br/teams.adoc[]
-include::../../../../shared/pt-br/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/pt-br/mailing-lists.adoc[]
-include::../../../../shared/pt-br/teams.adoc[]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -71,7 +57,7 @@ Resumo
Estas são as Perguntas Mais Frequentes (FAQ) para as versões do FreeBSD {rel-relx} e {rel2-relx}. Todos os esforços foram feitos para tornar este FAQ o mais informativo possível; Se você tiver alguma sugestão de como ele pode ser melhorado, envie-a para a http://lists.FreeBSD.org/mailman/listinfo/freebsd-doc[lista de discussão do projeto de documentação do FreeBSD].
-A versão mais recente deste documento está sempre disponível no link:{faq}[website do FreeBSD]. Ela também pode ser baixada como um grande arquivo link:.[HTML] por HTTP ou em uma grande variedade de outros formatos a partir do https://download.freebsd.org/ftp/doc/[servidor de FTP do projeto FreeBSD].
+A versão mais recente deste documento está sempre disponível no extref:{faq}[website do FreeBSD]. Ela também pode ser baixada como um grande arquivo link:.[HTML] por HTTP ou em uma grande variedade de outros formatos a partir do https://download.freebsd.org/ftp/doc/[servidor de FTP do projeto FreeBSD].
'''
@@ -87,7 +73,7 @@ Ele é baseado no sistema "4.4BSD-Lite" da U.C. de Berkeley, com algumas melhori
O FreeBSD é usado por empresas, provedores de serviços de Internet, pesquisadores, profissionais da computação, estudantes e usuários domésticos em todo o mundo em seu trabalho, educação e recreação.
-Para informações mais detalhadas sobre o FreeBSD, consulte o link:{handbook}[Manual do FreeBSD].
+Para informações mais detalhadas sobre o FreeBSD, consulte o extref:{handbook}[Manual do FreeBSD].
[[FreeBSD-goals]]
=== Qual é o objetivo do projeto FreeBSD?
@@ -114,7 +100,7 @@ A maioria das pessoas não usa um sistema operacional. Elas usam aplicativos. S
Se um aplicativo estiver disponível apenas para um determinado sistema operacional, esse sistema operacional não poderá ser substituído. No entanto é provável que exista um aplicativo muito semelhante no FreeBSD. Seja como um sólido servidor corporativo, um servidor de Internet ou ainda uma confiável estação de trabalho, o FreeBSD quase certamente fará tudo o que você precisa. Muitos usuários de computador ao redor do mundo, incluindo novatos e experientes administradores UNIX(TM), usam o FreeBSD como seu único sistema operacional de desktop.
-Os usuários que migrarem para o FreeBSD vindos de outro ambiente UNIX(TM)-like irão achar o FreeBSD bastante similar. Os usuários de Windows(TM) e do Mac OS(TM) podem se interessar em usar o https://www.furybsd.org/[FuryBSD], https://ghostbsd.org/[GhostBSD] ou https://www.midnightbsd.org/[MidnightBSD], três distribuições desktop baseadas no FreeBSD. Os usuários que não estão habituados ao uso de sistemas UNIX(TM) devem investir algum tempo adicional aprendendo a maneira de fazer as coisas no UNIX(TM). Este FAQ e o link:{handbook}[Manual do FreeBSD ] são excelentes lugares para iniciar.
+Os usuários que migrarem para o FreeBSD vindos de outro ambiente UNIX(TM)-like irão achar o FreeBSD bastante similar. Os usuários de Windows(TM) e do Mac OS(TM) podem se interessar em usar o https://www.furybsd.org/[FuryBSD], https://ghostbsd.org/[GhostBSD] ou https://www.midnightbsd.org/[MidnightBSD], três distribuições desktop baseadas no FreeBSD. Os usuários que não estão habituados ao uso de sistemas UNIX(TM) devem investir algum tempo adicional aprendendo a maneira de fazer as coisas no UNIX(TM). Este FAQ e o extref:{handbook}[Manual do FreeBSD ] são excelentes lugares para iniciar.
=== Por que ele é chamado de FreeBSD?
@@ -148,7 +134,7 @@ Mais informações sobre as releases do FreeBSD podem ser encontradas na https:/
=== O que é o FreeBSD-CURRENT?
-O link:{handbook}#current[FreeBSD-CURRENT] é a versão de desenvolvimento do sistema operacional, que no devido tempo se tornará o novo branch FreeBSD-STABLE. Como tal, ele é recomendado apenas para os desenvolvedores que trabalham no sistema e usuários amadores obstinados. Consulte a link:{handbook}#current[seção relevante] no link:{handbook}[Handbook] para detalhes sobre como executar o _-CURRENT_.
+O extref:{handbook}updating-upgrading[FreeBSD-CURRENT, current] é a versão de desenvolvimento do sistema operacional, que no devido tempo se tornará o novo branch FreeBSD-STABLE. Como tal, ele é recomendado apenas para os desenvolvedores que trabalham no sistema e usuários amadores obstinados. Consulte a extref:{handbook}updating-upgrading[seção relevante, current] no extref:{handbook}[Handbook] para detalhes sobre como executar o _-CURRENT_.
Usuários não familiarizados com o FreeBSD não devem usar o FreeBSD-CURRENT. Este branch às vezes evolui muito rapidamente e, devido a um erro, pode ser difícil de compilá-lo às vezes. Espera-se que as pessoas que usam o FreeBSD-CURRENT possam analisar, depurar e reportar problemas.
@@ -156,7 +142,7 @@ Usuários não familiarizados com o FreeBSD não devem usar o FreeBSD-CURRENT. E
O _FreeBSD-STABLE_ é o branch de desenvolvimento a partir do qual os releases principais são feitos. Mudanças entram nesta branch em um ritmo mais lento e com a suposição geral de que eles foram testados primeiro no FreeBSD-CURRENT. No entanto, a qualquer momento, o código fonte para o FreeBSD-STABLE pode ou não ser adequado para uso geral, devido a descoberta de bugs e/ou outros casos específicos que ainda não foram encontrados no FreeBSD-CURRENT. Usuários que não possuem recursos para realizar testes devem, ao invés dessa, executar a release mais recente do FreeBSD. O _FreeBSD-CURRENT_, por outro lado, tem sido uma linha ininterrupta desde que o 2.0 foi lançado.
-Para obter informações mais detalhadas sobre as branches, consulte "link:{releng}#rel-branch[Engenharia de Releases do FreeBSD: Criando uma Release Branch]", o status dos branches e o cronograma para releases futuros podem ser encontrados na página https://www.FreeBSD.org/releng[Release Engineering Information].
+Para obter informações mais detalhadas sobre as branches, consulte "extref:{releng}[Engenharia de Releases do FreeBSD: Criando uma Release Branch, rel-branch]", o status dos branches e o cronograma para releases futuros podem ser encontrados na página https://www.FreeBSD.org/releng[Release Engineering Information].
A versão https://download.FreeBSD.org/ftp/releases/amd64/amd64/12.1-RELEASE/[12.1] é a última release da branch _12-STABLE_; ela foi lançada em Novembro de 2019. A versão https://download.FreeBSD.org/ftp/releases/amd64/amd64/11.3-RELEASE/[11.3] é a release mais recente da branch _11-STABLE_; e foi lançada em Julho de 2019.
@@ -185,7 +171,7 @@ Os snapshots oficiais são gerados regularmente para todas as branchs ativamente
=== Quem é responsável pelo FreeBSD?
-As principais decisões relativas ao projeto FreeBSD, tais como a direção geral do projeto e quem tem permissão para adicionar código ao repositório de código fonte, são feitas por meio de um https://www.FreeBSD.org/administration/#t-core[core team] de 9 pessoas. Existe uma equipe muito maior, com mais de 350 link:{contributors}#staff-committers[committers] que estão autorizados a fazer alterações diretamente na árvore de fontes do FreeBSD.
+As principais decisões relativas ao projeto FreeBSD, tais como a direção geral do projeto e quem tem permissão para adicionar código ao repositório de código fonte, são feitas por meio de um https://www.FreeBSD.org/administration/#t-core[core team] de 9 pessoas. Existe uma equipe muito maior, com mais de 350 extref:{contributors}[committers, staff-committers] que estão autorizados a fazer alterações diretamente na árvore de fontes do FreeBSD.
No entanto, a maioria das alterações não-triviais é discutida com antecedência nas <<mailing,listas de discussão>>, e não há restrições sobre quem pode participar da discussão.
@@ -197,7 +183,7 @@ Todas releases importantes do FreeBSD estão disponíveis via FTP anônimo no ht
* Mensalmente são produzidos https://www.FreeBSD.org/snapshots/[snapshot] releases para as branchs <<current,-CURRENT>> e <<stable,-STABLE>>, as quais destinam-se primariamente ao uso por parte dos desenvolvedores e testadores.
* O último release da série _11-STABLE_, o 11.3-RELEASE, pode ser encontrado no https://download.FreeBSD.org/ftp/releases/amd64/amd64/11.3-RELEASE/[diretório 11.3-RELEASE].
-Informações sobre como obter o FreeBSD em CD, DVD e outras mídias podem ser encontradas no link:{handbook}#mirrors[Handbook].
+Informações sobre como obter o FreeBSD em CD, DVD e outras mídias podem ser encontradas no extref:{handbook}mirrors[Handbook, mirrors].
=== Como acesso o banco de dados dos Relatórios de Problemas?
@@ -205,13 +191,13 @@ O banco de dados com os Relatórios de Problemas contendo todas as solicitaçõe
A https://www.FreeBSD.org/support/bugreports/[interface web de envio de relatórios de problemas] pode ser usada para enviar relatórios de problemas através de um navegador.
-Antes de enviar um relatório de problema, leia link:{problem-reports}[Escrevendo Relatórios de Problemas do FreeBSD], um artigo sobre como escrever bons relatórios de problemas.
+Antes de enviar um relatório de problema, leia extref:{problem-reports}[Escrevendo Relatórios de Problemas do FreeBSD], um artigo sobre como escrever bons relatórios de problemas.
== Documentação e Suporte
=== Quais os livros existentes sobre o FreeBSD?
-O projeto produz uma ampla gama de documentação, disponível on-line a partir deste link: https://www.FreeBSD.org/docs/[https://www.FreeBSD.org/docs].
+O projeto produz uma ampla gama de documentação, disponível on-line a partir deste link:https://www.FreeBSD.org/docs/[https://www.FreeBSD.org/docs].
=== A documentação está disponível em outros formatos, tais como texto simples (ASCII) ou PDF?
@@ -334,7 +320,7 @@ Se o arquivo estiver compactado, o tar detectará automaticamente o formato apro
=== Onde encontro informações sobre as listas de discussão do FreeBSD? Quais grupos de notícias do FreeBSD estão disponíveis?
-Consulte as seções do Handbook sobre as link:{handbook}#eresources-mail[listas de discussão] e sobre os link:{handbook}#eresources-news[grupos de notícias].
+Consulte as seções do Handbook sobre as extref:{handbook}eresources[listas de discussão, eresources-mail] e sobre os extref:{handbook}eresources[grupos de notícias, eresources-news].
=== Existem canais de IRC (Internet Relay Chat) sobre o FreeBSD?
@@ -394,7 +380,7 @@ Qualquer um dos itens a seguir pode ser usado:
|Uma imagem mínima e que requer acesso à rede durante a instalação para que possa instalar completamente o FreeBSD.
|===
-Instruções completas sobre este procedimento e um pouco mais sobre problemas de instalação em geral podem ser encontradas na seção do Handbook link:{handbook}#bsdinstall[sobre instalação do FreeBSD].
+Instruções completas sobre este procedimento e um pouco mais sobre problemas de instalação em geral podem ser encontradas na seção do Handbook extref:{handbook}bsdinstall[sobre instalação do FreeBSD, bsdinstall].
=== O que eu faço se a imagem de instalação não inicializar?
@@ -406,11 +392,11 @@ Ao usar um cliente FTP de linha de comando, digite _binary_ no prompt de comando
=== Onde estão as instruções para instalar o FreeBSD?
-As instruções para instalação podem ser encontradas na seção do Handbook link:{handbook}#bsdinstall[sobre instalação do FreeBSD].
+As instruções para instalação podem ser encontradas na seção do Handbook extref:{handbook}bsdinstall[sobre instalação do FreeBSD, bsdinstall].
=== Como posso criar minha própria versão personalizada ou disco de instalação?
-Uma mídia customizada de instalação do FreeBSD pode ser criada através da construção de uma release personalizada. Siga as instruções do artigo link:{releng}[Release Engineering].
+Uma mídia customizada de instalação do FreeBSD pode ser criada através da construção de uma release personalizada. Siga as instruções do artigo extref:{releng}[Release Engineering].
=== O Windows pode coexistir com o FreeBSD? (específico de x86)
@@ -499,7 +485,7 @@ O PAE não é muito usado atualmente porque a maioria dos novos hardwares x86 ta
==== O FreeBSD suporta arquiteturas diferentes do x86?
-Sim. O FreeBSD divide o suporte em vários níveis. Arquiteturas de Tier 1, como i386 ou amd64; são totalmente suportados. Tiers 2 e 3 são suportados com base no melhor esforço. Uma explicação completa do sistema de tiers está disponível no link:{committers-guide}#archs[Guia dos Committers.]
+Sim. O FreeBSD divide o suporte em vários níveis. Arquiteturas de Tier 1, como i386 ou amd64; são totalmente suportados. Tiers 2 e 3 são suportados com base no melhor esforço. Uma explicação completa do sistema de tiers está disponível no extref:{committers-guide}[Guia dos Committers., archs]
Uma lista completa de arquiteturas suportadas pode ser encontrada na https://www.FreeBSD.org/platforms/[páginas de plataformas.]
@@ -648,7 +634,7 @@ Os desenvolvedores do FreeBSD estão interessados ​​nesses erros, mas precis
O kernel do FreeBSD permitirá que apenas um certo número de processos exista ao mesmo tempo. O número é baseado na variável `kern.maxusers` do man:sysctl[8]. O valor da variável `kern.maxusers` também afeta vários outros limites dentro do kernel, como por exemplo os buffers de rede. Se a máquina estiver muito carregada, aumente o `kern.maxusers`. Isso aumentará esses outros limites do sistema além do número máximo de processos.
-Para ajustar o valor da variável `kern.maxusers`, consulte a seção link:{handbook}#kern-maxfiles[Limites de Arquivos / Processos] do Handbook. Apesar desta seção se referir a arquivos abertos, os mesmos limites se aplicam aos processos.
+Para ajustar o valor da variável `kern.maxusers`, consulte a seção extref:{handbook}config-tuning[Limites de Arquivos / Processos, kern-maxfiles] do Handbook. Apesar desta seção se referir a arquivos abertos, os mesmos limites se aplicam aos processos.
Se a máquina estiver levemente carregada, mas executando um número muito grande de processos, ajuste o valor do `kern.maxproc` definindo-o no arquivo [.filename]#/boot/loader.conf#. O ajuste não terá efeito até que o sistema seja reinicializado. Para mais informações sobre o tuning de variáveis, consulte o manual do man:loader.conf[5]. Se esses processos estiverem sendo executados por um único usuário, ajuste o `kern.maxprocperuid` para que fique menor em 1 unidade do novo valor do `kern.maxproc`. Ele deve ser pelo menos uma unidade menor porque o programa do sistema, man:init[8], deve estar sempre em execução.
@@ -678,7 +664,7 @@ Após uma nova instalação do FreeBSD, também é possível que as informaçõe
=== Por que a mensagem file: table is full aparece repetidamente no dmesg8?
-Essa mensagem de erro indica que o número de file descriptors disponíveis no sistema esgotaram. Consulte a informação sobre a variável link:{handbook}#kern-maxfiles[kern.maxfiles] na seção link:{handbook}#configtuning-kernel-limits[ Ajustando os Limites do Kernel ] do Handbook para uma discussão e solução.
+Essa mensagem de erro indica que o número de file descriptors disponíveis no sistema esgotaram. Consulte a informação sobre a variável extref:{handbook}config-tuning[kern.maxfiles, kern-maxfiles] na seção extref:{handbook}config-tuning[Ajustando os Limites do Kernel, configtuning-kernel-limits] do Handbook para uma discussão e solução.
=== Por que o relógio do meu computador mantém-se com o horário incorreto?
@@ -776,12 +762,12 @@ O FreeBSD suporta pacotes binários compactados para facilitar a instalação e
Qualquer um dos métodos listados aqui funciona:
-* Use o portsnap para a maioria dos casos de uso. Consulte a seção link:{handbook}#ports-using[Usando a coleção de ports] para obter instruções sobre como usar essa ferramenta .
-* Use o Subversion se for necessário a aplicação de patches customizados na árvore de ports ou se estiver rodando FreeBSD-CURRENT. Consulte a seção link:{handbook}#svn[Usando o Subversion] para obter detalhes.
+* Use o portsnap para a maioria dos casos de uso. Consulte a seção extref:{handbook}ports[Usando a coleção de ports, ports-using] para obter instruções sobre como usar essa ferramenta .
+* Use o Subversion se for necessário a aplicação de patches customizados na árvore de ports ou se estiver rodando FreeBSD-CURRENT. Consulte a seção extref:{handbook}mirrors[Usando o Subversion, svn] para obter detalhes.
=== Por que não posso compilar esse port na minha máquina 11.X - ou 12.X -STABLE?
-Se a versão do FreeBSD instalada estiver significativamente atrás do _-CURRENT_ ou do _-STABLE_, atualize a coleção de ports usando as instruções disponíveis na seção link:{handbook}#ports-using[Usando a coleção de ports]. Se o sistema estiver atualizado, alguém pode ter feito uma alteração no port que funciona para _-CURRENT_ mas que quebrou o port para o _-STABLE_. https://bugs.FreeBSD.org/submit/[Envie] um relatório de bug, já que a Coleção de Ports deve funcionar tanto para o branch _-CURRENT_ e quanto o _-STABLE_.
+Se a versão do FreeBSD instalada estiver significativamente atrás do _-CURRENT_ ou do _-STABLE_, atualize a coleção de ports usando as instruções disponíveis na seção extref:{handbook}ports[Usando a coleção de ports, ports-using]. Se o sistema estiver atualizado, alguém pode ter feito uma alteração no port que funciona para _-CURRENT_ mas que quebrou o port para o _-STABLE_. https://bugs.FreeBSD.org/submit/[Envie] um relatório de bug, já que a Coleção de Ports deve funcionar tanto para o branch _-CURRENT_ e quanto o _-STABLE_.
=== Acabei de tentar compilar o INDEX usando o comando make index, e ele falhou. Por quê?
@@ -791,7 +777,7 @@ Existem casos raros em que o [.filename]#INDEX# não será compilado devido a ca
=== Eu atualizei os fontes, agora como faço para atualizar meus ports instalados?
-O FreeBSD não inclui uma ferramenta de atualização de ports, mas possui algumas ferramentas para facilitar o processo de atualização. Ferramentas adicionais estão disponíveis para simplificar o manuseio dos ports e são descritas na seção link:{handbook}#ports-using[Atualizando Ports] no Handbook do FreeBSD .
+O FreeBSD não inclui uma ferramenta de atualização de ports, mas possui algumas ferramentas para facilitar o processo de atualização. Ferramentas adicionais estão disponíveis para simplificar o manuseio dos ports e são descritas na seção extref:{handbook}ports[Atualizando Ports, ports-using] no Handbook do FreeBSD .
=== Preciso recompilar todos os ports sempre que realizo uma atualização de versão principal?
@@ -799,7 +785,7 @@ Sim! Apesar de um sistema recente ser capaz de executar os softwares compilados
Quando o sistema é atualizado, várias bibliotecas compartilhadas, módulos carregáveis ​​e outras partes do sistema serão substituídas por versões mais recentes. Os aplicativos vinculados às versões mais antigas podem não iniciar ou, em outros casos, não funcionar corretamente.
-Para obter maiores informações, consulte a link:{handbook}#freebsdupdate-upgrade[seção sobre atualizações] no Handbook do FreeBSD.
+Para obter maiores informações, consulte a extref:{handbook}updating-upgrading[seção sobre atualizações, freebsdupdate-upgrade] no Handbook do FreeBSD.
=== Preciso recompilar cada port toda vez que faço uma atualização de versão secundária?
@@ -816,7 +802,7 @@ A implementação existente é resultado do nosso melhor esforço para atender s
[[make-kernel]]
=== Eu gostaria de customizar meu kernel. É difícil?
-De modo nenhum! Confira a seção link:{handbook}#kernelconfig[configuração do kernel do Handbook].
+De modo nenhum! Confira a seção extref:{handbook}kernelconfig[configuração do kernel do Handbook, kernelconfig].
[NOTE]
====
@@ -862,7 +848,7 @@ Substitua _accf_httpd ipfw_ com a lista dos módulos que precisa. Apenas os mód
Dispositivos desnecessários podem ser removidos do kernel para reduzir ainda mais o tamanho. Veja <<make-kernel>> para mais informações.
-Para colocar qualquer uma dessas opções em vigor, siga as instruções para link:{handbook}#kernelconfig-building[compilar e instalar] um novo kernel.
+Para colocar qualquer uma dessas opções em vigor, siga as instruções para extref:{handbook}kernelconfig/[compilar e instalar, kernelconfig-building] um novo kernel.
Para referência, o kernel amd64 do FreeBSD 11 ([.filename]#/boot/kernel/kernel#) é de aproximadamente 25 MB.
@@ -892,7 +878,7 @@ A variável `kern.sched.quantum` define o número máximo de pulsos que um proce
=== Como posso adicionar o meu novo disco rígido ao meu sistema FreeBSD?
-Veja a seção link:{handbook}#disks-adding[Adicionando Discos] no Handbook do FreeBSD.
+Veja a seção extref:{handbook}disks[Adicionando Discos, disks-adding] no Handbook do FreeBSD.
=== Como faço para mover meu sistema para o meu novo disco enorme?
@@ -999,7 +985,7 @@ As partições secundárias do DOS são encontradas depois de _todas_ as partiç
=== Existe um sistema de arquivos criptográficos para o FreeBSD?
-Sim, o man:gbde[8] e o man:geli[8]. Consulte a seção link:{handbook}#disks-encrypting[Partições de Disco com Criptografia] do Handbook do FreeBSD.
+Sim, o man:gbde[8] e o man:geli[8]. Consulte a seção extref:{handbook}disks[Partições de Disco com Criptografia, disks-encrypting] do Handbook do FreeBSD.
=== Como inicializo o FreeBSD e o Linux utilizando o GRUB?
@@ -1065,23 +1051,23 @@ e monte-o:
=== Por que recebo o erro Incorrect super block ao montar um CD?
-O tipo de dispositivo a ser montado deve ser especificado. Isso está descrito no Handbook na seção link:{handbook}#mounting-cd[ Usando CDs de Dados].
+O tipo de dispositivo a ser montado deve ser especificado. Isso está descrito no Handbook na seção extref:{handbook}disks[ Usando CDs de Dados, mounting-cd].
=== Por que recebo o erro Device not configured ao montar um CD?
-Isso geralmente significa que não há CD na unidade ou a unidade não está visível no barramento. Consulte a seção link:{handbook}#mounting-cd[ Usando CDs de Dados] do Handbook para uma discussão detalhada desta questão.
+Isso geralmente significa que não há CD na unidade ou a unidade não está visível no barramento. Consulte a seção extref:{handbook}disks[Usando CDs de Dados, mounting-cd] do Handbook para uma discussão detalhada desta questão.
=== Por que todos os caracteres não-ingleses em nomes de arquivos aparecem como ? em meus CDs quando montados no FreeBSD?
-O CD provavelmente usa a extensão "Joliet" para armazenar informações sobre arquivos e diretórios. Isso é discutido na seção link:{handbook}#mounting-cd[Usando CD-ROMs de Dados] do Handbook.
+O CD provavelmente usa a extensão "Joliet" para armazenar informações sobre arquivos e diretórios. Isso é discutido na seção extref:{handbook}disks[Usando CD-ROMs de Dados, mounting-cd] do Handbook.
=== Um CD gravado no FreeBSD não pode ser lido sob nenhum outro sistema operacional. Por quê?
-Isso significa que um raw file foi gravado no CD, em vez de criar um sistema de arquivos ISO 9660. Dê uma olhada na seção link:{handbook}#mounting-cd[Usando CDs de Dados].
+Isso significa que um raw file foi gravado no CD, em vez de criar um sistema de arquivos ISO 9660. Dê uma olhada na seção extref:{handbook}disks[Usando CDs de Dados, mounting-cd].
=== Como posso criar uma imagem de um CD de dados?
-Isso é discutido na seção Handbook sobre link:{handbook}#mkisofs[como gravar dados em um sistema de arquivos ISO ]. Para mais informações sobre como trabalhar com CD-ROMs, consulte a link:{handbook}#creating-cds[ Seção Criando CDs ] no capítulo sobre Armazenamento do Handbook.
+Isso é discutido na seção Handbook sobre extref:{handbook}disks[como gravar dados em um sistema de arquivos ISO, mkisofs]. Para mais informações sobre como trabalhar com CD-ROMs, consulte a extref:{handbook}disks[Seção Criando CDs, creating-cds] no capítulo sobre Armazenamento do Handbook.
=== Por que não consigo usar o comando mount com um CD de áudio?
@@ -1147,7 +1133,7 @@ Observe que o Soft Updates pode atrasar a liberação de espaço em disco e pode
=== Como posso adicionar mais espaço de swap?
-Esta seção link:{handbook}#adding-swap-space[do Handbook] descreve como fazer isso.
+Esta seção extref:{handbook}config-tuning[do Handbook, adding-swap-space] descreve como fazer isso.
=== Por que o FreeBSD vê meu disco como sendo menor do que o fabricante diz que ele é?
@@ -1276,11 +1262,11 @@ Depois de executar estas etapas, edite o arquivo [.filename]#/etc/rc.conf# para
=== Por que estou tendo problemas para configurar minha impressora?
-Consulte a seção sobre link:{handbook}#printing[impressão] no Handbook do FreeBSD para dicas de soluções de problemas.
+Consulte a seção sobre extref:{handbook}printing[impressão, printing] no Handbook do FreeBSD para dicas de soluções de problemas.
=== Como posso corrigir os mapeamentos de teclado para o meu sistema?
-Consulte a seção link:{handbook}#using-localization[usando localização] do Handbook, mais especificamente a seção sobre a link:{handbook}#setting-console[ configuração do console ].
+Consulte a seção extref:{handbook}l10n[usando localização, using-localization] do Handbook, mais especificamente a seção sobre a extref:{handbook}l10n[configuração do console, setting-console].
=== Por que não consigo colocar as quotas de usuários para funcionar corretamente?
@@ -1292,7 +1278,7 @@ options QUOTA
....
+
-Consulte a link:{handbook}#quotas[ seção do Handbook sobre quotas] para obter detalhes completos.
+Consulte aextref:{handbook}disks[ seção do Handbook sobre quotas, quotas] para obter detalhes completos.
. Não ative o uso de quotas na partição [.filename]#/#.
. Coloque o arquivo de quotas no sistema de arquivos para o qual quotas precisam ser aplicadas:
+
@@ -1340,7 +1326,7 @@ Se você ainda for solicitado a entrar com a senha do usuário `root` ao entrar
[NOTE]
====
-Se a partição raiz não puder ser montada a partir do modo de usuário único, é possível que as partições estejam criptografadas e será impossível montá-las sem as chaves de acesso. Para obter mais informações, consulte a seção sobre discos criptografados no link:{handbook}#disks-encrypting[Handbook] do FreeBSD.
+Se a partição raiz não puder ser montada a partir do modo de usuário único, é possível que as partições estejam criptografadas e será impossível montá-las sem as chaves de acesso. Para obter mais informações, consulte a seção sobre discos criptografados no extref:{handbook}disks[Handbook, disks-encrypting] do FreeBSD.
====
=== Como evito que a combinação de teclas ControlAltDelete reinicialize o sistema?
@@ -1393,7 +1379,7 @@ Resposta longa: o FreeBSD deriva suas releases de um de dois lugares. Releases p
Quando um release está prestes a ser feito, o branch do qual ele será derivado tem que passar por um determinado processo. Parte desse processo é um congelamento de código. Quando um congelamento de código é iniciado, o nome da branch é alterado para refletir que está prestes a se tornar uma release. Por exemplo, se a ramificação costumava ser chamada de 6.2-STABLE, seu nome será alterado para 6.3-PRERELEASE para indicar o congelamento de código e indicar que testes extras de pré-release devem estar acontecendo. Correções de bugs ainda podem ser adicionadas ao repositório de código fonte para fazer parte da release. Quando o código-fonte estiver estabilizado para a release, o nome será alterado para 6.3-RC para indicar que uma release está prestes a ser feita a partir dele. Uma vez no estágio RC, somente os bugs mais críticos que forem encontrados podem ser corrigidos. Uma vez que o release (6.3-RELEASE neste exemplo) e o branch de release foram feitos, o branch será renomeado para 6.3-STABLE.
-Para mais informações sobre números de versão e as várias branches do Subversion, consulte o artigo link:{releng}[Release Engineering].
+Para mais informações sobre números de versão e as várias branches do Subversion, consulte o artigo extref:{releng}[Release Engineering].
=== Tentei instalar um novo kernel, e o chflags1 falhou. Como faço para contornar isso?
@@ -1491,7 +1477,7 @@ Instale o Xorg a partir de pacotes do FreeBSD:
# pkg install xorg
....
-Após a instalação do Xorg, siga as instruções da seção link:{handbook}#x-config[Configuração X11] do Handbook do FreeBSD.
+Após a instalação do Xorg, siga as instruções da seção extref:{handbook}x11[Configuração X11, x-config] do Handbook do FreeBSD.
=== Eu tentei executar o X, mas eu recebo um erro No devices detected. quando eu digito startx. O que eu faço agora?
@@ -1700,7 +1686,7 @@ Digite `xmodmap -e "pointer = 3 2 1"`. Adicione este comando ao [.filename]#~/.x
=== Como faço para instalar uma splash screen e onde posso encontrá-las?
-A resposta detalhada para essa pergunta pode ser encontrada na seção link:{handbook}#boot-splash[Telas de inicialização do tempo de inicialização] do FreeBSD Handbook.
+A resposta detalhada para essa pergunta pode ser encontrada na seção extref:{handbook}boot[Telas de inicialização do tempo de inicialização, boot-splash] do FreeBSD Handbook.
=== Posso usar as teclas do Windows do meu teclado no X?
@@ -1766,15 +1752,15 @@ Para a ATI Rage 128 e Radeon, consulte man:ati[4], man:r128[4] and man:radeon[4]
=== Onde posso obter informações sobre a inicialização sem disco?
-"Inicialização sem disco" significa que o sistema FreeBSD é inicializado através de uma rede e lê os arquivos necessários de um servidor ao invés de seu disco rígido. Para maiores detalhes, consulte a entrada do Handbook link:{handbook}#network-diskless[Inicialização sem disco].
+"Inicialização sem disco" significa que o sistema FreeBSD é inicializado através de uma rede e lê os arquivos necessários de um servidor ao invés de seu disco rígido. Para maiores detalhes, consulte a entrada do Handbook extref:{handbook}advanced-networking[Inicialização sem disco, network-diskless].
=== Uma maquina FreeBSD pode ser usada como um roteador de rede dedicado?
-Sim. Consulte a entrada do Manual em link:{handbook}#advanced-networking[rede avançada], especificamente a seção sobre link:{handbook}#network-routing[roteamento e gateways].
+Sim. Consulte a entrada do Manual em extref:{handbook}advanced-networking[rede avançada, advanced-networking], especificamente a seção sobre extref:{handbook}advanced-networking[roteamento e gateways, network-routing].
=== O FreeBSD suporta NAT ou Mascaramento de IPs?
-Sim. Para obter instruções sobre como usar o NAT em uma conexão PPP, consulte a seção do link:{handbook}#userppp[PPP] no manual. Para usar o NAT em algum outro tipo de conexão de rede, consulte a seção link:{handbook}#network-natd[natd] do manual.
+Sim. Para obter instruções sobre como usar o NAT em uma conexão PPP, consulte a seção do extref:{handbook}ppp-and-slip[PPP, userppp] no manual. Para usar o NAT em algum outro tipo de conexão de rede, consulte a seção extref:{handbook}[natd, network-natd] do manual.
=== Como posso configurar aliases de Ethernet?
@@ -1792,7 +1778,7 @@ Caso contrário, especifique o endereço de rede e a máscara de rede como de co
# ifconfig ed0 alias 172.16.141.5 netmask 0xffffff00
....
-Mais informações podem ser encontradas link:{handbook}#configtuning-virtual-hosts[Handbook] do FreeBSD.
+Mais informações podem ser encontradas extref:{handbook}config-tuning[Handbook, configtuning-virtual-hosts] do FreeBSD.
=== Por que não posso montar o NFS de uma máquina Linux?
@@ -1805,7 +1791,7 @@ Algumas versões do código NFS do Linux(TM) aceitam somente solicitações de m
=== Por que o comando mountd continua me dizendo que ele can't change attributes (não pode alterar os atributos) e que eu tenho uma bad exports list (lista de exports ruins) no meu servidor NFS do FreeBSD?
-O problema mais freqüente é não entender o formato correto de [.filename]#/etc/exports#. Revise man:exports[5] e o link:{handbook}#network-nfs[NFS] no manual, especialmente na seção link:{handbook}#configuring-nfs[configurando o NFS].
+O problema mais freqüente é não entender o formato correto de [.filename]#/etc/exports#. Revise man:exports[5] e o extref:{handbook}network-servers[NFS, network-nfs] no manual, especialmente na seção extref:{handbook}[configurando o NFS, configuring-nfs].
=== Como faço para ativar o suporte a multicast IP?
@@ -1813,7 +1799,7 @@ Instale o pacote ou port package:net/mrouted[] e adicione `mrouted_enable="YES"`
=== Por que preciso usar o FQDN para hosts na minha rede?
-Veja a resposta no link:{handbook}#mail-trouble[Handbook] do FreeBSD.
+Veja a resposta no extref:{handbook}mail[Handbook, mail-trouble] do FreeBSD.
=== Por que recebo oerro, Permission denied, para todas as operações de rede?
@@ -1828,7 +1814,7 @@ Se o firewall foi inadvertidamente configurado de forma errada, restaure a opera
Considere configurar a opção `firewall_type="open"` no [.filename]#/etc/rc.conf#.
-Para obter mais informações sobre como configurar seu firewall, consulte o link:{handbook}#firewalls-ipfw[Handbook].
+Para obter mais informações sobre como configurar seu firewall, consulte o extref:{handbook}firewalls[Handbook, firewalls-ipfw].
=== Por que minha regra ipfw fwd para redirecionar um serviço para outra máquina que não está funcionando?
@@ -1986,7 +1972,7 @@ Esta seção responde a perguntas comuns sobre comunicação serial com o FreeBS
=== Como obtenho o prompt de boot: em um console serial?
-Veja link:{handbook}#serialconsole-setup[ esta seção do Handbook].
+Veja extref:{handbook}serialcomms[ esta seção do Handbook, serialconsole-setup].
=== Como sei se o FreeBSD encontrou minhas portas seriais ou placas de modem?
@@ -2043,7 +2029,7 @@ Os flags indicam que a porta principal possui um número menor `7` (`0x700`) e t
=== Posso definir os parâmetros seriais padrões para uma porta?
-Veja a seção link:{handbook}#serial-hw-config[ Comunicações Seriais ] no Handbook do FreeBSD .
+Veja a seção extref:{handbook}serialcomms[Comunicações Seriais, serial-hw-config] no Handbook do FreeBSD .
=== Por que não consigo executar o comando tip ou o cu?
@@ -2105,7 +2091,7 @@ A coleção de ports também tem o package:emulators/dosbox[]. O foco principal
=== O que eu preciso fazer para traduzir um documento do FreeBSD para minha língua nativa?
-Veja a link:{fdp-primer}#translations[ FAQ de traduções ] na Documentação do Primer Project do FreeBSD.
+Veja a extref:{fdp-primer}[FAQ de traduções, translations] na Documentação do Primer Project do FreeBSD.
=== Por que os meus emails destinados a qualquer endereço no dominio FreeBSD.org são sempre rejeitados?
@@ -2145,7 +2131,7 @@ Desenhos Xfig e eps estão disponíveis em [.filename]#/usr/shared/examples/BSD_
=== Eu vi um acrônimo ou outro termo nas listas de discussão e não entendo o que isso significa. Onde devo procurar?
-Consulte o link:{handbook}#freebsd-glossary[Glossário do FreeBSD].
+Consulte o extref:{handbook}glossary[Glossário do FreeBSD, freebsd-glossary].
=== Por que eu deveria me importar com a cor da bikeshed?
@@ -2276,13 +2262,13 @@ Instale o package:games/sl[] e espere ela digitar `sl` para `ls`.
=== Como posso aprender mais sobre os componentes internos do FreeBSD?
-Veja o link:{arch-handbook}[ Handbook de Arquitetura do FreeBSD ].
+Veja o extref:{arch-handbook}[ Handbook de Arquitetura do FreeBSD ].
Além disso, muito do conhecimento geral sobre o UNIX(TM) é diretamente aplicável ao FreeBSD.
=== Como posso contribuir para o FreeBSD? O que posso fazer para ajudar?
-Nós aceitamos todos os tipos de contribuições: documentação, código e até mesmo arte. Veja o artigo link:{contributing}[Contribuindo com o FreeBSD] para obter maiores informações sobre como fazer isso.
+Nós aceitamos todos os tipos de contribuições: documentação, código e até mesmo arte. Veja o artigo extref:{contributing}[Contribuindo com o FreeBSD] para obter maiores informações sobre como fazer isso.
E obrigado por considerar nos ajudar!
@@ -2439,4 +2425,4 @@ Para encontrar o valor correto de _N_, divida o tamanho do espaço de endereço
Este inocente documento de Perguntas Frequentes foi escrito, reescrito, editado, dobrado, fustigado, mutilado, eviscerado, contemplado, desconcertado, cogitado, regurgitado, reconstruído, castigado e revigorado na última década, por um elenco de centenas, se não milhares de voluntários. Repetidamente.
-Gostaríamos de agradecer a cada uma das pessoas responsáveis, e nós o encorajamos a link:{contributing}[se juntar a eles] para tornar este FAQ ainda melhor.
+Gostaríamos de agradecer a cada uma das pessoas responsáveis, e nós o encorajamos a extref:{contributing}[se juntar a eles] para tornar este FAQ ainda melhor.
diff --git a/documentation/content/pt-br/books/fdp-primer/_index.adoc b/documentation/content/pt-br/books/fdp-primer/_index.adoc
index d667b08124..943da49fcc 100644
--- a/documentation/content/pt-br/books/fdp-primer/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/_index.adoc
@@ -10,6 +10,7 @@ tags: ["FDP", "documentation", "FreeBSD", "Index"]
title: 'Primer do Projeto de Documentação do FreeBSD para Novos Colaboradores'
trademarks: ["general"]
weight: 10
+isIndex: true
---
= Primer do Projeto de Documentação do FreeBSD para Novos Colaboradores
@@ -19,14 +20,32 @@ weight: 10
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
+:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/fdp-primer/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumo
@@ -39,4 +58,4 @@ Este documento é um trabalho em andamento. Correções e adições são sempre
'''
-include::content/pt-br/books/fdp-primer/toc.adoc[]
+include::{chapters-path}toc.adoc[]
diff --git a/documentation/content/pt-br/books/fdp-primer/asciidoctor-primer/_index.adoc b/documentation/content/pt-br/books/fdp-primer/asciidoctor-primer/_index.adoc
index a8675ef9b1..8b71063259 100644
--- a/documentation/content/pt-br/books/fdp-primer/asciidoctor-primer/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/asciidoctor-primer/_index.adoc
@@ -14,18 +14,35 @@ title: 'Capítulo 6. Primer AsciiDoctor'
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-:toc-title: Índice
-
-include::shared/pt-br/urls.adoc[]
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
A maioria das documentações do FDP é escrita em AsciiDoc. Este capítulo explica o que isso significa, como ler e entender o código da documentação e as técnicas usadas. Para obter uma referência completa dos recursos do AsciiDoctor, consulte a link:https://docs.asciidoctor.org/home/[documentação do Asciidoctor]. Alguns exemplos usados neste capítulo foram retirados da link:https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference[Referência rápida de sintaxe AsciiDoc].
@@ -192,12 +209,12 @@ Para apontar para outro livro ou artigo, as variáveis AsciiDoctor devem ser usa
. Em seguida, crie um link usando a variável AsciiDoctor para o artigo `ipsec-must`.
+
....
-link:{ipsec-must}[Artigo IPSec-Must]
+extref:{ipsec-must}[Artigo IPSec-Must]
....
+
E isso seria processado como.
+
-link:{ipsec-must}[Artigo IPSec-Must]
+extref:{ipsec-must}[Artigo IPSec-Must]
[[asciidoctor-conclusion]]
== Conclusão
diff --git a/documentation/content/pt-br/books/fdp-primer/book.adoc b/documentation/content/pt-br/books/fdp-primer/book.adoc
index 3f6dd452b5..578ec8539e 100644
--- a/documentation/content/pt-br/books/fdp-primer/book.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/book.adoc
@@ -15,53 +15,35 @@ trademarks: ["general"]
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
:book: true
:pdf: false
+:images-path: books/fdp-primer/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
-:chapters-path: content/pt-br/books/fdp-primer/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/fdp-primer/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/pt-br/mailing-lists.adoc[]
-include::../../../../shared/pt-br/teams.adoc[]
-include::../../../../shared/pt-br/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/pt-br/mailing-lists.adoc[]
-include::../../../../shared/pt-br/teams.adoc[]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -85,38 +67,38 @@ include::{chapters-path}toc-examples.adoc[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=9..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
-include::{chapters-path}overview/_index.adoc[leveloffset=+1, lines=9..23; 30..-1]
+include::{chapters-path}overview/_index.adoc[leveloffset=+1]
-include::{chapters-path}tools/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
+include::{chapters-path}tools/_index.adoc[leveloffset=+1]
-include::{chapters-path}working-copy/_index.adoc[leveloffset=+1, lines=9..23; 27..-1]
+include::{chapters-path}working-copy/_index.adoc[leveloffset=+1]
-include::{chapters-path}structure/_index.adoc[leveloffset=+1, lines=9..24; 28..-1]
+include::{chapters-path}structure/_index.adoc[leveloffset=+1]
-include::{chapters-path}doc-build/_index.adoc[leveloffset=+1, lines=9..24; 28..-1]
+include::{chapters-path}doc-build/_index.adoc[leveloffset=+1]
-include::{chapters-path}asciidoctor-primer/_index.adoc[leveloffset=+1, lines=9..24; 30..-1]
+include::{chapters-path}asciidoctor-primer/_index.adoc[leveloffset=+1]
-include::{chapters-path}rosetta/_index.adoc[leveloffset=+1, lines=9..25; 29..-1]
+include::{chapters-path}rosetta/_index.adoc[leveloffset=+1]
-include::{chapters-path}translations/_index.adoc[leveloffset=+1, lines=9..24; 31..-1]
+include::{chapters-path}translations/_index.adoc[leveloffset=+1]
-include::{chapters-path}po-translations/_index.adoc[leveloffset=+1, lines=9..26; 32..-1]
+include::{chapters-path}po-translations/_index.adoc[leveloffset=+1]
-include::{chapters-path}manual-pages/_index.adoc[leveloffset=+1, lines=9..24; 28..-1]
+include::{chapters-path}manual-pages/_index.adoc[leveloffset=+1]
-include::{chapters-path}writing-style/_index.adoc[leveloffset=+1, lines=9..24; 30..-1]
+include::{chapters-path}writing-style/_index.adoc[leveloffset=+1]
-include::{chapters-path}editor-config/_index.adoc[leveloffset=+1, lines=9..24; 28..-1]
+include::{chapters-path}editor-config/_index.adoc[leveloffset=+1]
-include::{chapters-path}see-also/_index.adoc[leveloffset=+1, lines=9..24; 30..-1]
+include::{chapters-path}see-also/_index.adoc[leveloffset=+1]
:sectnums!:
-include::{chapters-path}examples/_index.adoc[leveloffset=+1, lines=8..25; 29..-1]
+include::{chapters-path}examples/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/pt-br/books/fdp-primer/doc-build/_index.adoc b/documentation/content/pt-br/books/fdp-primer/doc-build/_index.adoc
index 219d4f61f0..f01d2927ab 100644
--- a/documentation/content/pt-br/books/fdp-primer/doc-build/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/doc-build/_index.adoc
@@ -14,16 +14,35 @@ title: 'Capítulo 5. Processo de Compilação da Documentação do FreeBSD'
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-:toc-title: Índice
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Este capítulo cobre a organização do processo de compilação da documentação e como o man:make[1] é usado para controlá-lo.
diff --git a/documentation/content/pt-br/books/fdp-primer/editor-config/_index.adoc b/documentation/content/pt-br/books/fdp-primer/editor-config/_index.adoc
index 9481b94a49..fbc3f8c6e7 100644
--- a/documentation/content/pt-br/books/fdp-primer/editor-config/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/editor-config/_index.adoc
@@ -14,16 +14,35 @@ title: 'Capítulo 12. Configuração do Editor'
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-:toc-title: Índice
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Ajustar a configuração do editor de texto pode tornar o trabalho nos arquivos da documentação mais rápido e fácil, além de ajudar os documentos a ficarem em conformidade com as diretrizes do projeto.
diff --git a/documentation/content/pt-br/books/fdp-primer/examples/_index.adoc b/documentation/content/pt-br/books/fdp-primer/examples/_index.adoc
index a59004d91a..e7ea26838d 100644
--- a/documentation/content/pt-br/books/fdp-primer/examples/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/examples/_index.adoc
@@ -14,17 +14,35 @@ title: 'Apêndice A. Exemplos'
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
-:toc-title: Índice
-:example-caption: Exemplo
+:images-path: books/fdp-primer/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Estes exemplos não são extensos - eles não contêm todos os elementos que podem ser desejáveis de usar, particularmente em relação ao início dos documentos (Front Matter).
Para mais exemplos de marcação AsciiDoctor, examine o código fonte em AsciiDoctor deste e de outros documentos disponíveis no repositório Git `doc` ou no link link:https://cgit.freebsd.org/doc/[https://cgit.freebsd.org/doc/].
diff --git a/documentation/content/pt-br/books/fdp-primer/manual-pages/_index.adoc b/documentation/content/pt-br/books/fdp-primer/manual-pages/_index.adoc
index 2804b37f58..033669dec0 100644
--- a/documentation/content/pt-br/books/fdp-primer/manual-pages/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/manual-pages/_index.adoc
@@ -14,16 +14,35 @@ title: 'Capítulo 10. Páginas de Manual'
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-:toc-title: Índice
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[manual-pages-introduction]]
== Introdução
@@ -220,7 +239,7 @@ Apresentando exemplos::
Apresente exemplos ao leitor sempre que possível. Mesmo exemplos triviais são valiosos, porque o que é trivial para o escritor não é necessariamente trivial para o leitor. Três exemplos são um bom objetivo. Um exemplo trivial mostra os requisitos mínimos, um exemplo afundo mostra o uso real e um exemplo detalhado demonstra uma funcionalidade incomum ou não óbvia.
Inclua a licença BSD::
-Inclua a licença BSD em novas páginas de manual. A licença preferencial está disponível no link:{committers-guide}[Guia dos Committer's].
+Inclua a licença BSD em novas páginas de manual. A licença preferencial está disponível no extref:{committers-guide}[Guia dos Committer's].
[[manual-pages-markup-tricks]]
=== Truques de Marcação
diff --git a/documentation/content/pt-br/books/fdp-primer/overview/_index.adoc b/documentation/content/pt-br/books/fdp-primer/overview/_index.adoc
index 3fcbb18ffc..ad5f0955d9 100644
--- a/documentation/content/pt-br/books/fdp-primer/overview/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/overview/_index.adoc
@@ -14,18 +14,35 @@ title: 'Capítulo 1. Visão Geral'
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
-
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Seja bem vindo ao Projeto de Documentação do FreeBSD.(FDP). Documentação de boa qualidade é muito importante para o sucesso do FreeBSD, e nós valorizamos muito suas contribuições.
diff --git a/documentation/content/pt-br/books/fdp-primer/po-translations/_index.adoc b/documentation/content/pt-br/books/fdp-primer/po-translations/_index.adoc
index cfa2717ac2..e1ba82d60e 100644
--- a/documentation/content/pt-br/books/fdp-primer/po-translations/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/po-translations/_index.adoc
@@ -14,20 +14,35 @@ title: 'Capítulo 9. Traduções PO'
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-:toc-title: Índice
-:table-caption: Tabela
-:example-caption: Exemplo
-
-include::shared/pt-br/urls.adoc[]
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[po-translations-introduction]]
== Introdução
@@ -242,7 +257,7 @@ Um novo diretório de idioma deve ser criado ao traduzir um documento para um no
.Criando uma Tradução em Espanhol do Porter's Handbook
[example]
====
-Crie uma nova tradução em Espanhol do link:{porters-handbook}[Porter's Handbook]. O original é um livro em [.filename]#~/doc/documentation/content/en/books/porters-handbook/#.
+Crie uma nova tradução em Espanhol do extref:{porters-handbook}[Porter's Handbook]. O original é um livro em [.filename]#~/doc/documentation/content/en/books/porters-handbook/#.
[.procedure]
======
@@ -330,7 +345,7 @@ Inglês original:
....
msgid ""
"This example shows the creation of a Spanish translation of the short "
-"link:{leap-seconds}[Leap Seconds] article."
+"extref:{leap-seconds}[Leap Seconds] article."
....
Tradução para o Espanhol:
@@ -339,7 +354,7 @@ Tradução para o Espanhol:
....
msgid ""
"Este ejemplo muestra la creación de un artículo con poco contenido como el artículo "
-"link:{leap-seconds}[Leap Seconds]."
+"extref:{leap-seconds}[Leap Seconds]."
....
====
diff --git a/documentation/content/pt-br/books/fdp-primer/preface/_index.adoc b/documentation/content/pt-br/books/fdp-primer/preface/_index.adoc
index 5dcc1b5e22..0f00389594 100644
--- a/documentation/content/pt-br/books/fdp-primer/preface/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/preface/_index.adoc
@@ -15,10 +15,31 @@ title: Prefácio
:icons: font
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-prompts]]
== Prompts do Shell
diff --git a/documentation/content/pt-br/books/fdp-primer/rosetta/_index.adoc b/documentation/content/pt-br/books/fdp-primer/rosetta/_index.adoc
index 2ea81b0e3f..d05e96f9cd 100644
--- a/documentation/content/pt-br/books/fdp-primer/rosetta/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/rosetta/_index.adoc
@@ -14,17 +14,35 @@ title: 'Capítulo 7. Rosetta Stone'
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-:toc-title: Índice
-:table-caption: Tabela
+:images-path: books/fdp-primer/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[docbook-vs-asciidoc]]
== Comparação entre Docbook e AsciiDoc
diff --git a/documentation/content/pt-br/books/fdp-primer/see-also/_index.adoc b/documentation/content/pt-br/books/fdp-primer/see-also/_index.adoc
index b4f17ebb7b..8774c14935 100644
--- a/documentation/content/pt-br/books/fdp-primer/see-also/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/see-also/_index.adoc
@@ -14,18 +14,35 @@ title: 'Capítulo 13. Veja também'
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-:toc-title: Índice
+:images-path: books/fdp-primer/
-include::shared/pt-br/urls.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Este documento não é deliberadamente uma discussão exaustiva de AsciiDoc e o Projeto de Documentação do FreeBSD. Para mais informações sobre estes, você é encorajado a consultar os seguintes sites.
@@ -33,7 +50,7 @@ Este documento não é deliberadamente uma discussão exaustiva de AsciiDoc e o
== O projeto de documentação do FreeBSD
* link:https://www.FreeBSD.org/docproj/[As Páginas Web do Projeto de Documentação do FreeBSD]
-* link:{handbook}[O Handbook do FreeBSD]
+* extref:{handbook}[O Handbook do FreeBSD]
[[see-also-asciidoc]]
== AsciiDoctor
diff --git a/documentation/content/pt-br/books/fdp-primer/see-also/_index.po b/documentation/content/pt-br/books/fdp-primer/see-also/_index.po
index b0833e3693..f21089517d 100644
--- a/documentation/content/pt-br/books/fdp-primer/see-also/_index.po
+++ b/documentation/content/pt-br/books/fdp-primer/see-also/_index.po
@@ -63,8 +63,8 @@ msgstr ""
#. type: Plain text
#: documentation/content/en/books/fdp-primer/see-also/_index.adoc:37
-msgid "link:{handbook}[The FreeBSD Handbook]"
-msgstr "link:{handbook}[O Handbook do FreeBSD]"
+msgid "extref:{handbook}[The FreeBSD Handbook]"
+msgstr "extref:{handbook}[O Handbook do FreeBSD]"
#. type: Title ==
#: documentation/content/en/books/fdp-primer/see-also/_index.adoc:39
diff --git a/documentation/content/pt-br/books/fdp-primer/structure/_index.adoc b/documentation/content/pt-br/books/fdp-primer/structure/_index.adoc
index 1bdee9b79b..84e59c9d25 100644
--- a/documentation/content/pt-br/books/fdp-primer/structure/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/structure/_index.adoc
@@ -14,16 +14,35 @@ title: 'Capítulo 4. Estrutura de Diretórios da Documentação'
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-:toc-title: Índice
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Arquivos e diretórios no repositório [.filename]#doc/# seguem uma estrutura destinada a:
@@ -211,7 +230,6 @@ title: Why you should use a BSD style license for your Open Source Project
authors:
- author: Bruce Montague
email: brucem@alumni.cse.ucsc.edu
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "intel", "general"]
---
diff --git a/documentation/content/pt-br/books/fdp-primer/tools/_index.adoc b/documentation/content/pt-br/books/fdp-primer/tools/_index.adoc
index c1498da0be..cdc5bb44c6 100644
--- a/documentation/content/pt-br/books/fdp-primer/tools/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/tools/_index.adoc
@@ -14,15 +14,35 @@ title: 'Capítulo 2. Ferramentas'
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Várias ferramentas são utilizadas para gerenciar a documentação do FreeBSD e renderizá-la para diferentes formatos. Algumas dessas ferramentas são necessárias e devem ser instaladas antes de trabalhar com os exemplos nos capítulos a seguir. Algumas são opcionais, adicionando recursos ou tornando a tarefa de criar documentação mais simples.
diff --git a/documentation/content/pt-br/books/fdp-primer/translations/_index.adoc b/documentation/content/pt-br/books/fdp-primer/translations/_index.adoc
index 4475090578..d53102274f 100644
--- a/documentation/content/pt-br/books/fdp-primer/translations/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/translations/_index.adoc
@@ -14,19 +14,35 @@ title: 'Capítulo 8. Traduções'
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-:toc-title: Índice
-
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Este é o FAQ para pessoas que estão traduzindo a documentação do FreeBSD (FAQ, Handbook, tutoriais, páginas de manual e outros) para diferentes idiomas.
@@ -79,7 +95,7 @@ Por exemplo, para ver as diferenças entre as revisões `abff932fe8` e `2191c444
% git diff abff932fe8 2191c44469 documentation/content/en/articles/committers-guide/_index.adoc
....
-Por favor, veja a explicação completa de como usar o Git no FreeBSD no link:{handbook}mirrors/#git[FreeBSD Handbook].
+Por favor, veja a explicação completa de como usar o Git no FreeBSD no extref:{handbook}mirrors/[FreeBSD Handbook, git].
== Como eu faço para descobrir se já existem outras pessoas traduzindo documentos para o meu idioma?
diff --git a/documentation/content/pt-br/books/fdp-primer/working-copy/_index.adoc b/documentation/content/pt-br/books/fdp-primer/working-copy/_index.adoc
index 1f7675983b..d0ea0fa3e1 100644
--- a/documentation/content/pt-br/books/fdp-primer/working-copy/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/working-copy/_index.adoc
@@ -14,15 +14,35 @@ title: 'Capítulo 3. A Área de Trabalho'
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
A _área de trabalho_ é uma cópia da árvore de documentação do repositório do FreeBSD baixada no computador local. As alterações são feitas na cópia de trabalho local, testadas e enviadas como patches para serem submetidas no repositório principal.
diff --git a/documentation/content/pt-br/books/fdp-primer/writing-style/_index.adoc b/documentation/content/pt-br/books/fdp-primer/writing-style/_index.adoc
index 0d1bc8016a..06eef8e6f0 100644
--- a/documentation/content/pt-br/books/fdp-primer/writing-style/_index.adoc
+++ b/documentation/content/pt-br/books/fdp-primer/writing-style/_index.adoc
@@ -14,18 +14,35 @@ title: 'Capítulo 11. Estilo de Escrita'
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-:toc-title: Índice
-
-include::shared/pt-br/mailing-lists.adoc[]
+:images-path: books/fdp-primer/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[writing-style-tips]]
== Dicas
diff --git a/documentation/content/pt-br/books/handbook/_index.adoc b/documentation/content/pt-br/books/handbook/_index.adoc
index 7c46ee7548..2c7340ce9d 100644
--- a/documentation/content/pt-br/books/handbook/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/_index.adoc
@@ -3,9 +3,9 @@ title: FreeBSD Handbook
authors:
- author: Projeto de Documentação do FreeBSD
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
next: books/handbook/preface
+isIndex: true
---
= FreeBSD Handbook
@@ -15,18 +15,32 @@ next: books/handbook/preface
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Resumo
@@ -37,10 +51,10 @@ A última versão deste livro está disponível no https://www.FreeBSD.org/[site
'''
-include::content/pt-br/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
-include::content/pt-br/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
-include::content/pt-br/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
-include::content/pt-br/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/pt-br/books/handbook/advanced-networking/_index.adoc b/documentation/content/pt-br/books/handbook/advanced-networking/_index.adoc
index 0a97a16b23..5199d3051f 100644
--- a/documentation/content/pt-br/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/advanced-networking/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 31
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 31
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[advanced-networking-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/audit/_index.adoc b/documentation/content/pt-br/books/handbook/audit/_index.adoc
index b78fbacd19..73c72c326c 100644
--- a/documentation/content/pt-br/books/handbook/audit/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/audit/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/disks
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[audit-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/basics/_index.adoc b/documentation/content/pt-br/books/handbook/basics/_index.adoc
index aeb78470e2..d39fdd0f00 100644
--- a/documentation/content/pt-br/books/handbook/basics/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/basics/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ports
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[basics-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/bibliography/_index.adoc b/documentation/content/pt-br/books/handbook/bibliography/_index.adoc
index 5efbcaf100..0c574fd1c5 100644
--- a/documentation/content/pt-br/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/bibliography/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/eresources
[[bibliography]]
= Bibliografia
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Enquanto páginas manuais fornecem uma referência definitiva para partes individuais do sistema operacional FreeBSD, elas raramente ilustram como juntar as peças para fazer todo o sistema operacional rodar sem problemas. Para isso, não há substituto para um bom livro ou manual do usuário na administração do sistema UNIX(TM).
diff --git a/documentation/content/pt-br/books/handbook/book.adoc b/documentation/content/pt-br/books/handbook/book.adoc
index 8727c38315..848e8929c9 100644
--- a/documentation/content/pt-br/books/handbook/book.adoc
+++ b/documentation/content/pt-br/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: FreeBSD Handbook
authors:
- author: Projeto de Documentação do FreeBSD
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
---
@@ -12,54 +11,35 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:part-signifier: Parte
-:chapter-signifier: Capítulo
-:appendix-caption: Apêndice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
:book: true
:pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
-:chapters-path: content/pt-br/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/pt-br/mailing-lists.adoc[]
-include::../../../../shared/pt-br/teams.adoc[]
-include::../../../../shared/pt-br/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/pt-br/mailing-lists.adoc[]
-include::../../../../shared/pt-br/teams.adoc[]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -76,95 +56,95 @@ toc::[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
// Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
-include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1]
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}jails/_index.adoc[leveloffset=+1]
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
-include::{chapters-path}zfs/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}zfs/_index.adoc[leveloffset=+1]
-include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}filesystems/_index.adoc[leveloffset=+1]
-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
-include::{chapters-path}dtrace/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}dtrace/_index.adoc[leveloffset=+1]
-include::{chapters-path}usb-device-mode/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}usb-device-mode/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=7..19]
+include::{chapters-path}partiv.adoc[lines=15..27]
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
// Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
:sectnums!:
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/pt-br/books/handbook/boot/_index.adoc b/documentation/content/pt-br/books/handbook/boot/_index.adoc
index 04ee029ebd..1997f2a2ee 100644
--- a/documentation/content/pt-br/books/handbook/boot/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/boot/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/security
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/bsdinstall/_index.adoc b/documentation/content/pt-br/books/handbook/bsdinstall/_index.adoc
index 6ef781c0fb..fbaeffcc58 100644
--- a/documentation/content/pt-br/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/bsdinstall/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/basics
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/bsdinstall/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
-endif::[]
+:images-path: books/handbook/bsdinstall/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[bsdinstall-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/config/_index.adoc b/documentation/content/pt-br/books/handbook/config/_index.adoc
index 9d82dc488e..4ef3813ace 100644
--- a/documentation/content/pt-br/books/handbook/config/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/config/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/boot
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/config/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[config-synopsis]]
== Sinopse
@@ -286,7 +284,7 @@ As seguintes palavras-chave podem ser incluídas na parte superior de cada scrip
Ao definir cuidadosamente essas palavras-chave para cada script de inicialização, um administrador passa a ter um nível refinado de controle da ordem de inicialização dos scripts, sem a necessidade dos "runlevels" usados por alguns sistemas operacionais UNIX(TM).
-Informações adicionais podem ser encontradas em man:rc[8] e man:rc.subr[8]. Consulte link:{rc-scripting}[este artigo] para obter instruções sobre como criar um script man:rc[8] personalizado.
+Informações adicionais podem ser encontradas em man:rc[8] e man:rc.subr[8]. Consulte extref:{rc-scripting}[este artigo] para obter instruções sobre como criar um script man:rc[8] personalizado.
[[configtuning-core-configuration]]
=== Gerenciando a configuração específica do sistema
diff --git a/documentation/content/pt-br/books/handbook/cutting-edge/_index.adoc b/documentation/content/pt-br/books/handbook/cutting-edge/_index.adoc
index c4ca1444f4..fdf637fd5c 100644
--- a/documentation/content/pt-br/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/cutting-edge/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/dtrace
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[updating-upgrading-synopsis]]
== Sinopse
@@ -392,7 +390,7 @@ A documentação é parte integrante do sistema operacional FreeBSD. Enquanto um
Esta seção descreve como usar os fontes ou a Coleção de Ports do FreeBSD para manter uma cópia local da documentação do FreeBSD atualizada.
-Para obter informações sobre como editar e enviar correções para a documentação, consulte o Primer do Projeto de Documentação do FreeBSD para Novos Colaboradores (link:{fdp-primer}[Primer do Projeto de Documentação do FreeBSD]).
+Para obter informações sobre como editar e enviar correções para a documentação, consulte o Primer do Projeto de Documentação do FreeBSD para Novos Colaboradores (extref:{fdp-primer}[Primer do Projeto de Documentação do FreeBSD]).
[[updating-installed-documentation]]
=== Atualizando a documentação a partir do código-fonte
diff --git a/documentation/content/pt-br/books/handbook/desktop/_index.adoc b/documentation/content/pt-br/books/handbook/desktop/_index.adoc
index 5c293be3da..84e73bfb24 100644
--- a/documentation/content/pt-br/books/handbook/desktop/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/desktop/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/multimedia
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[desktop-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/disks/_index.adoc b/documentation/content/pt-br/books/handbook/disks/_index.adoc
index 029b113d6d..008578a06f 100644
--- a/documentation/content/pt-br/books/handbook/disks/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/disks/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/geom
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[disks-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/dtrace/_index.adoc b/documentation/content/pt-br/books/handbook/dtrace/_index.adoc
index b14e208973..c393b8e03e 100644
--- a/documentation/content/pt-br/books/handbook/dtrace/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/dtrace/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/usb-device-mode
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/dtrace/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
-endif::[]
+:images-path: books/handbook/dtrace/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dtrace-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/eresources/_index.adoc b/documentation/content/pt-br/books/handbook/eresources/_index.adoc
index c725d9e8d7..a2b685e718 100644
--- a/documentation/content/pt-br/books/handbook/eresources/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/eresources/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/pgpkeys
[[eresources]]
= Recursos na Internet
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
O ritmo acelerado do progresso do FreeBSD torna a mídia impressa impraticável como um meio de acompanhar os desenvolvimentos mais recentes. Os recursos eletrônicos são a melhor maneira, se não a única, de se manter informado sobre os últimos avanços. Como o FreeBSD é um esforço voluntário, a própria comunidade de usuários geralmente serve como um "departamento de suporte técnico", com o correio eletrônico, fóruns na web e notícias da USENET sendo a maneira mais eficaz de alcançar essa comunidade.
@@ -53,9 +66,9 @@ Os charters das várias listas são dadas na parte inferior deste documento. _Po
_Para testar a capacidade de enviar email para as listas do FreeBSD, envie uma mensagem de teste para http://lists.FreeBSD.org/mailman/listinfo/freebsd-test[freebsd-test]._ Por favor, não envie mensagens de teste para qualquer outra lista.
====
-Em caso de dúvida sobre a lista para colocar uma pergunta, consulte link:{freebsd-questions-article}[Como obter os melhores resultados da lista de discussão FreeBSD-questions].
+Em caso de dúvida sobre a lista para colocar uma pergunta, consulte extref:{freebsd-questions-article}[Como obter os melhores resultados da lista de discussão FreeBSD-questions].
-Antes de postar em qualquer lista, aprenda sobre a melhor forma de usar as listas de discussão, por exemplo, como ajudar a evitar discussões repetidas com frequência, lendo o documento de link:{mailing-list-faq}[Perguntas Frequentes das Mailing Lists] (FAQ).
+Antes de postar em qualquer lista, aprenda sobre a melhor forma de usar as listas de discussão, por exemplo, como ajudar a evitar discussões repetidas com frequência, lendo o documento de extref:{mailing-list-faq}[Perguntas Frequentes das Mailing Lists] (FAQ).
Os arquivos são mantidos para todas as listas de discussão e podem ser pesquisados usando o https://www.FreeBSD.org/search/[servidor da World Wide Web do FreeBSD]. A busca por palavras-chaves no arquivo oferece uma excelente maneira de encontrar respostas para perguntas freqüentes e deve ser consultada antes de postar uma pergunta. Note que isso também significa que as mensagens enviadas para as listas de discussão do FreeBSD são arquivadas perpetuamente. Se a proteção da sua privacidade é uma preocupação, considere usar um endereço de e-mail secundário descartável e postar apenas informações públicas.
diff --git a/documentation/content/pt-br/books/handbook/filesystems/_index.adoc b/documentation/content/pt-br/books/handbook/filesystems/_index.adoc
index ea867121c4..362a4480e1 100644
--- a/documentation/content/pt-br/books/handbook/filesystems/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/filesystems/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/virtualization
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/filesystems/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
-endif::[]
+:images-path: books/handbook/filesystems/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[filesystems-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/firewalls/_index.adoc b/documentation/content/pt-br/books/handbook/firewalls/_index.adoc
index f35d00e653..548d7c1a3b 100644
--- a/documentation/content/pt-br/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/firewalls/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/advanced-networking
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 30
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 30
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[firewalls-intro]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/geom/_index.adoc b/documentation/content/pt-br/books/handbook/geom/_index.adoc
index 0e5161b197..48d518374d 100644
--- a/documentation/content/pt-br/books/handbook/geom/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/geom/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/zfs
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[geom-synopsis]]
== Sinopse
@@ -1139,4 +1137,4 @@ No caso de várias slices, será criado um journal para cada slice individual. P
O journaling também pode ser ativado nos sistemas de arquivos atuais usando o `tunefs`. No entanto, _sempre_ faça um backup antes de tentar alterar um sistema de arquivos existente. Na maioria dos casos, o `gjournal` falhará se não for possível criar o registro de log, mas isso não protege contra a perda de dados incorrida como resultado do uso indevido do `tunefs`. Consulte man:gjournal[8] e man:tunefs[8] para maiores informações sobre esses comandos.
-É possível fazer o journaling do disco de inicialização de um sistema FreeBSD. Consulte o artigo link:{gjournal-desktop}[Implementando o journaling do UFS em um PC de mesa] para obter instruções detalhadas.
+É possível fazer o journaling do disco de inicialização de um sistema FreeBSD. Consulte o artigo extref:{gjournal-desktop}[Implementando o journaling do UFS em um PC de mesa] para obter instruções detalhadas.
diff --git a/documentation/content/pt-br/books/handbook/introduction/_index.adoc b/documentation/content/pt-br/books/handbook/introduction/_index.adoc
index f9d414ada6..df81b955a8 100644
--- a/documentation/content/pt-br/books/handbook/introduction/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/introduction/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/bsdinstall
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/introduction/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/introduction/
-endif::[]
+:images-path: books/handbook/introduction/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/introduction/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-synopsis]]
== Sinopse
@@ -180,7 +178,7 @@ O código em nossa árvore de código-fonte que se enquadra na GNU General Publi
[[development]]
=== O Modelo de Desenvolvimento do FreeBSD
-O desenvolvimento do FreeBSD é um processo muito aberto e flexível, sendo construído literalmente a partir das contribuições de milhares de pessoas ao redor do mundo, como pode ser visto na nossa link:{contributors}[lista de contribuidores]. A infraestrutura de desenvolvimento do FreeBSD permite que milhares de colaboradores colaborem pela Internet. Estamos constantemente à procura de novos desenvolvedores e ideias, e os interessados em se envolver mais estreitamente com o projeto precisam simplesmente entrar em contato conosco pelas http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[lista de discussões técnicas do FreeBSD]. A http://lists.FreeBSD.org/mailman/listinfo/freebsd-announce[lista de discussão de anúncios do FreeBSD] também está disponível para aqueles que desejam fazer com que outros usuários do FreeBSD conheçam as principais áreas de trabalho.
+O desenvolvimento do FreeBSD é um processo muito aberto e flexível, sendo construído literalmente a partir das contribuições de milhares de pessoas ao redor do mundo, como pode ser visto na nossa extref:{contributors}[lista de contribuidores]. A infraestrutura de desenvolvimento do FreeBSD permite que milhares de colaboradores colaborem pela Internet. Estamos constantemente à procura de novos desenvolvedores e ideias, e os interessados em se envolver mais estreitamente com o projeto precisam simplesmente entrar em contato conosco pelas http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[lista de discussões técnicas do FreeBSD]. A http://lists.FreeBSD.org/mailman/listinfo/freebsd-announce[lista de discussão de anúncios do FreeBSD] também está disponível para aqueles que desejam fazer com que outros usuários do FreeBSD conheçam as principais áreas de trabalho.
Coisas úteis para saber sobre o Projeto FreeBSD e seu processo de desenvolvimento, seja trabalhando independentemente ou em estreita cooperação:
@@ -201,7 +199,7 @@ Como a maioria dos desenvolvedores, a maioria dos membros do core team também s
Contribuidores externos::
Por último, mas definitivamente não menos importante, o maior grupo de desenvolvedores são os próprios usuários que fornecem feedback e correções de bugs para nós em uma base quase constante. A principal maneira de manter contato com o desenvolvimento não-centralizado do FreeBSD é inscrever-se nas http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[listas de discussões técnicas sobre o FreeBSD] onde essas coisas são discutidas. Veja crossref:eresources[eresources, Recursos na Internet] para maiores informações sobre as várias listas de discussão do FreeBSD.
+
-A link:{contributors}[Lista de Colaboradores do FreeBSD] é extensa e crescente, então por que não se juntar a ela contribuindo com algo para o FreeBSD hoje?
+A extref:{contributors}[Lista de Colaboradores do FreeBSD] é extensa e crescente, então por que não se juntar a ela contribuindo com algo para o FreeBSD hoje?
+
Fornecer código não é a única maneira de contribuir para o projeto; para uma lista mais completa de coisas que precisam ser feitas, por favor consulte o https://www.FreeBSD.org/[web site do Projeto FreeBSD].
diff --git a/documentation/content/pt-br/books/handbook/jails/_index.adoc b/documentation/content/pt-br/books/handbook/jails/_index.adoc
index c7f0b844ea..1a49ac41b6 100644
--- a/documentation/content/pt-br/books/handbook/jails/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/jails/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mac
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/jails/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
-endif::[]
+:images-path: books/handbook/jails/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[jails-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/kernelconfig/_index.adoc b/documentation/content/pt-br/books/handbook/kernelconfig/_index.adoc
index 1b2611953d..54b5e06baf 100644
--- a/documentation/content/pt-br/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/kernelconfig/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/printing
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kernelconfig-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/l10n/_index.adoc b/documentation/content/pt-br/books/handbook/l10n/_index.adoc
index ba806b0686..4aad488168 100644
--- a/documentation/content/pt-br/books/handbook/l10n/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/l10n/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/cutting-edge
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/linuxemu/_index.adoc b/documentation/content/pt-br/books/handbook/linuxemu/_index.adoc
index 3a274c624d..9cbc429d0d 100644
--- a/documentation/content/pt-br/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/linuxemu/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[linuxemu-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/mac/_index.adoc b/documentation/content/pt-br/books/handbook/mac/_index.adoc
index c21dc60445..71c129eaa1 100644
--- a/documentation/content/pt-br/books/handbook/mac/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/mac/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/audit
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/mail/_index.adoc b/documentation/content/pt-br/books/handbook/mail/_index.adoc
index 8d8db0f0ec..f01fdb6094 100644
--- a/documentation/content/pt-br/books/handbook/mail/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/mail/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/network-servers
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 28
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 28
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mail-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/mirrors/_index.adoc b/documentation/content/pt-br/books/handbook/mirrors/_index.adoc
index e6d2458fb2..ad25e364e4 100644
--- a/documentation/content/pt-br/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/mirrors/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/bibliography
[[mirrors]]
= Obtendo o FreeBSD
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mirrors-cdrom]]
== CD and DVD Sets
diff --git a/documentation/content/pt-br/books/handbook/multimedia/_index.adoc b/documentation/content/pt-br/books/handbook/multimedia/_index.adoc
index 53fb4a9535..39cc2f1650 100644
--- a/documentation/content/pt-br/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/multimedia/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/kernelconfig
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[multimedia-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/network-servers/_index.adoc b/documentation/content/pt-br/books/handbook/network-servers/_index.adoc
index cf6d2c734f..d310b135fe 100644
--- a/documentation/content/pt-br/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/network-servers/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/firewalls
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 29
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 29
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[network-servers-synopsis]]
== Sinopse
@@ -1127,7 +1125,7 @@ O FreeBSD não provê um servidor LDAP embutido. Comece a configuração instala
# pkg install openldap-server
....
-Aqui está um largo conjunto de opções habilitadas no link:{linux-users}#software[pacote]. Reveja-os rodando o comando `pkg info openldap-server`. Se não for suficiente (por exemplo se o suporte a SQL for necessário), por favor considere recompilar o port usando o framework crossref:ports[ports-using,apropriado].
+Aqui está um largo conjunto de opções habilitadas no extref:{linux-users}[pacote, software]. Reveja-os rodando o comando `pkg info openldap-server`. Se não for suficiente (por exemplo se o suporte a SQL for necessário), por favor considere recompilar o port usando o framework crossref:ports[ports-using,apropriado].
A instalação cria o diretório [.filename]#/var/db/openldap-data# para conter os dados. O diretório para armazenar os certificados deve ser criado:
diff --git a/documentation/content/pt-br/books/handbook/parti.adoc b/documentation/content/pt-br/books/handbook/parti.adoc
index b2de694e66..0dcc4c016e 100644
--- a/documentation/content/pt-br/books/handbook/parti.adoc
+++ b/documentation/content/pt-br/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
next: books/handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[getting-started]]
= Primeiros Passos
@@ -17,4 +25,4 @@ Esta parte do handbook é destinada aos usuários e administradores que são nov
O número de referências a tópicos futuros no texto foi mantido no mínimo, para que uma seção possa ser lida do começo ao fim com o mínimo de avanço desnecessário de páginas.
-include::content/pt-br/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/pt-br/books/handbook/partii.adoc b/documentation/content/pt-br/books/handbook/partii.adoc
index 69e7963d6d..f904cc78ca 100644
--- a/documentation/content/pt-br/books/handbook/partii.adoc
+++ b/documentation/content/pt-br/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
next: books/handbook/desktop
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[common-tasks]]
= Tarefas comuns
@@ -17,4 +25,4 @@ Agora que o básico foi abordado, esta parte do livro discute alguns recursos fr
Alguns destes capítulos recomendam leituras prévias, e isso é destacado na sinopse no início de cada capítulo.
-include::content/pt-br/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/pt-br/books/handbook/partiii.adoc b/documentation/content/pt-br/books/handbook/partiii.adoc
index 9cc6f3f957..d3eee488be 100644
--- a/documentation/content/pt-br/books/handbook/partiii.adoc
+++ b/documentation/content/pt-br/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
next: books/handbook/config
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[system-administration]]
= Administração do Sistema
@@ -11,4 +19,4 @@ Os capítulos restantes cobrem todos os aspectos da administração do sistema F
Estes capítulos são projetados para serem lidos conforme as informações são necessárias. Eles não precisam ser lidos em nenhuma ordem específica, nem todos precisam ser lidos antes de começar a usar o FreeBSD.
-include::content/pt-br/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/pt-br/books/handbook/partiv.adoc b/documentation/content/pt-br/books/handbook/partiv.adoc
index 94aaf070e8..6c5d062031 100644
--- a/documentation/content/pt-br/books/handbook/partiv.adoc
+++ b/documentation/content/pt-br/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/usb-device-mode
next: books/handbook/serialcomms
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[network-communication]]
= Comunicação de rede
@@ -18,4 +26,4 @@ O FreeBSD é um dos sistemas operacionais mais amplamente implantados para servi
Esses capítulos são projetados para serem lidos quando a informação for necessária. Eles não precisam ser lidos em qualquer ordem específica, nem é necessário ler todos eles antes de usar o FreeBSD em um ambiente de rede.
-include::content/pt-br/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/pt-br/books/handbook/partv.adoc b/documentation/content/pt-br/books/handbook/partv.adoc
index f6f25b141d..21a1e0e7e1 100644
--- a/documentation/content/pt-br/books/handbook/partv.adoc
+++ b/documentation/content/pt-br/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
next: books/handbook/mirrors
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= Apêndices
-include::content/pt-br/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/pt-br/books/handbook/pgpkeys/_index.adoc b/documentation/content/pt-br/books/handbook/pgpkeys/_index.adoc
index bbd78b9847..07d6a0bffd 100644
--- a/documentation/content/pt-br/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/pgpkeys/_index.adoc
@@ -9,30 +9,46 @@ next: books/handbook/freebsd-glossary
[[pgpkeys]]
= Chaves OpenPGP
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
-As chaves OpenPGP dos Administradores do `FreeBSD.org` são mostradas aqui. Essas chaves podem ser usadas para verificar uma assinatura ou para enviar um email criptografado para um dos administradores. A lista completa das chaves OpenPGP do FreeBSD está disponível no artigo link:{pgpkeys}[PGP Keys]. O keyring completo pode ser baixado em https://www.FreeBSD.org/doc/pgpkeyring.txt[https://www.FreeBSD.org/doc/pgpkeyring.txt] .
+As chaves OpenPGP dos Administradores do `FreeBSD.org` são mostradas aqui. Essas chaves podem ser usadas para verificar uma assinatura ou para enviar um email criptografado para um dos administradores. A lista completa das chaves OpenPGP do FreeBSD está disponível no artigo extref:{pgpkeys}[PGP Keys]. O keyring completo pode ser baixado em https://www.FreeBSD.org/doc/pgpkeyring.txt[https://www.FreeBSD.org/doc/pgpkeyring.txt] .
[[pgpkeys-officers]]
== Administradores
diff --git a/documentation/content/pt-br/books/handbook/ports/_index.adoc b/documentation/content/pt-br/books/handbook/ports/_index.adoc
index 03466133d6..b797b6ba09 100644
--- a/documentation/content/pt-br/books/handbook/ports/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/ports/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/x11
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ports-synopsis]]
== Sinopse
@@ -625,7 +623,7 @@ Ao usar `fetch`, a operação `extract` ou `update` pode ser executada consecuti
====
*Procedure: Método Subversion*
-Se for necessário mais controle sobre a árvore de ports ou se as mudanças locais precisarem ser mantidas, ou se estiver executando o FreeBSD-CURRENT, o Subversion pode ser usado para obter a coleção de ports. Consulte link:{committers-guide}#subversion-primer[O Subversion Primer] para uma descrição detalhada do Subversion.
+Se for necessário mais controle sobre a árvore de ports ou se as mudanças locais precisarem ser mantidas, ou se estiver executando o FreeBSD-CURRENT, o Subversion pode ser usado para obter a coleção de ports. Consulte extref:{committers-guide}[O Subversion Primer, subversion-primer] para uma descrição detalhada do Subversion.
. O Subversion deve ser instalado antes de poder ser usado para fazer o check-out da árvore de ports. Se uma cópia da árvore de ports já estiver presente, instale o Subversion desta forma:
+
@@ -680,7 +678,7 @@ A coleção de ports contém diretórios para categorias de software. Dentro de
* [.filename]#pkg-descr#: fornece uma descrição mais detalhada do programa.
* [.filename]#pkg-plist#: uma lista de todos os arquivos que serão instalados pelo port. Ele também informa ao sistema de ports quais arquivos devem ser removidos após a desinstalação.
-Alguns ports incluem [.filename]#pkg-message# ou outros arquivos para lidar com situações especiais. Para obter mais detalhes sobre esses arquivos e sobre os ports em geral, consulte o link:{porters-handbook}[FreeBSD Porter's Manual].
+Alguns ports incluem [.filename]#pkg-message# ou outros arquivos para lidar com situações especiais. Para obter mais detalhes sobre esses arquivos e sobre os ports em geral, consulte o extref:{porters-handbook}[FreeBSD Porter's Manual].
O port não inclui o código-fonte real, também conhecido como [.filename]#distfile#. A etapa de extração da compilação de um port salvará automaticamente o código-fonte transferido por download para [.filename]#/usr/ports/distfiles#.
@@ -1163,11 +1161,11 @@ Quando um port não é compilado ou instalado, tente o seguinte:
+
[NOTE]
====
-Alguns ports não são mantidos por um indivíduo, mas sim por um grupo de mantenedores representado por uma link:{mailing-list-faq}[lista de discussão]. Muitos, mas não todos, esses endereços se parecem com mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org]. Por favor, leve isso em consideração ao enviar um email.
+Alguns ports não são mantidos por um indivíduo, mas sim por um grupo de mantenedores representado por uma extref:{mailing-list-faq}[lista de discussão]. Muitos, mas não todos, esses endereços se parecem com mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org]. Por favor, leve isso em consideração ao enviar um email.
Em particular, os ports mantidos por mailto:ports@FreeBSD.org[ports@FreeBSD.org] não são mantidos por um indivíduo específico. Em vez disso, quaisquer correções e suporte vêm da comunidade geral que se inscreve nessa lista de discussão. Mais voluntários são sempre necessários!
====
+
-Se não houver resposta ao email, use o Bugzilla para enviar um relatório de bug usando as instruções em link:{problem-reports}[Escrevendo Relatórios de Problemas do FreeBSD].
-. Conserte-o! O link:{porters-handbook}[Porters Handbook] inclui informações detalhadas sobre a infra-estrutura da arvore de ports para que você possa corrigir possiveis erros na compilacao de um ports que quebrou ou ocasionou um erro de compilacao ou até mesmo submeta seu próprio projeto!
+Se não houver resposta ao email, use o Bugzilla para enviar um relatório de bug usando as instruções em extref:{problem-reports}[Escrevendo Relatórios de Problemas do FreeBSD].
+. Conserte-o! O extref:{porters-handbook}[Porters Handbook] inclui informações detalhadas sobre a infra-estrutura da arvore de ports para que você possa corrigir possiveis erros na compilacao de um ports que quebrou ou ocasionou um erro de compilacao ou até mesmo submeta seu próprio projeto!
. Instale o pacote em vez do port usando as instruções em <<pkgng-intro>>.
diff --git a/documentation/content/pt-br/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/pt-br/books/handbook/ppp-and-slip/_index.adoc
index 9c08de8686..48f066695e 100644
--- a/documentation/content/pt-br/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/ppp-and-slip/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mail
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ppp-and-slip-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/preface/_index.adoc b/documentation/content/pt-br/books/handbook/preface/_index.adoc
index 30cff90dc4..242fd2c6e9 100644
--- a/documentation/content/pt-br/books/handbook/preface/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/preface/_index.adoc
@@ -13,14 +13,31 @@ next: books/handbook/parti
:icons: font
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-audience]]
== Audiência Pretendida
diff --git a/documentation/content/pt-br/books/handbook/printing/_index.adoc b/documentation/content/pt-br/books/handbook/printing/_index.adoc
index 9fe885e1a7..9ff6bcc57e 100644
--- a/documentation/content/pt-br/books/handbook/printing/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/printing/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/linuxemu
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/printing/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Colocar informações no papel é uma função vital, apesar de muitas tentativas de eliminá-la. A impressão tem dois componentes básicos. Os dados devem ser entregues à impressora e devem estar em um formato que a impressora possa entender.
@@ -741,7 +739,7 @@ Vários outros sistemas de impressão estão disponíveis, além do man:lpd[8].
[[printing-other-cups]]
=== CUPS (Sistema de impressão comum UNIX(TM))
-O CUPS é um sistema de impressão popular disponível em muitos sistemas operacionais. Usar o CUPS no FreeBSD está documentado em um artigo separado: link:{cups}[CUPS]
+O CUPS é um sistema de impressão popular disponível em muitos sistemas operacionais. Usar o CUPS no FreeBSD está documentado em um artigo separado: extref:{cups}[CUPS]
[[printing-other-hplip]]
=== HPLIP
diff --git a/documentation/content/pt-br/books/handbook/security/_index.adoc b/documentation/content/pt-br/books/handbook/security/_index.adoc
index de9c73b3a8..c559b8a9ec 100644
--- a/documentation/content/pt-br/books/handbook/security/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/security/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/jails
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/serialcomms/_index.adoc b/documentation/content/pt-br/books/handbook/serialcomms/_index.adoc
index e0819d0bb0..fe1980f6b9 100644
--- a/documentation/content/pt-br/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/serialcomms/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ppp-and-slip
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[serial-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/usb-device-mode/_index.adoc b/documentation/content/pt-br/books/handbook/usb-device-mode/_index.adoc
index 8120c760ca..0c8c9d6155 100644
--- a/documentation/content/pt-br/books/handbook/usb-device-mode/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/usb-device-mode/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/usb-device-mode/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/usb-device-mode/
-endif::[]
+:images-path: books/handbook/usb-device-mode/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/usb-device-mode/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[usb-device-mode-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/virtualization/_index.adoc b/documentation/content/pt-br/books/handbook/virtualization/_index.adoc
index be52b00be7..b3224c4364 100644
--- a/documentation/content/pt-br/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/virtualization/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/l10n
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/virtualization/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
-endif::[]
+:images-path: books/handbook/virtualization/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[virtualization-synopsis]]
== Sinopse
diff --git a/documentation/content/pt-br/books/handbook/x11/_index.adoc b/documentation/content/pt-br/books/handbook/x11/_index.adoc
index da059d5b02..abebc8a9a8 100644
--- a/documentation/content/pt-br/books/handbook/x11/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/x11/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[x11-synopsis]]
== Sinopse
@@ -1041,7 +1039,7 @@ Instalar o pacote Compiz Fusion é fácil, mas a configuração requer alguns pa
Os efeitos da área de trabalho podem causar uma carga considerável na placa gráfica. Para uma placa gráfica baseada na nVidia, o driver proprietário é necessário para um bom desempenho. Usuários de outras placas gráficas podem pular esta seção e continuar com a configuração do [.filename]#xorg.conf#.
-Para determinar qual o driver nVidia é necessário, consulte a link:{faq}#idp59950544[Perguntas frequentes sobre o assunto].
+Para determinar qual o driver nVidia é necessário, consulte a extref:{faq}[Perguntas frequentes sobre o assunto, idp59950544].
Tendo determinado o driver correto para usar em sua placa gráfica, a instalação é tão simples quanto instalar qualquer outro pacote.
diff --git a/documentation/content/pt-br/books/handbook/zfs/_index.adoc b/documentation/content/pt-br/books/handbook/zfs/_index.adoc
index 9bcbade6a1..0cc2e0ad1e 100644
--- a/documentation/content/pt-br/books/handbook/zfs/_index.adoc
+++ b/documentation/content/pt-br/books/handbook/zfs/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/filesystems
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/zfs/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/zfs/
-endif::[]
+:images-path: books/handbook/zfs/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/zfs/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
O _Sistema de Arquivos Z_, ou ZFS, é um sistema de arquivos avançado projetado para superar muitos dos principais problemas encontrados em projetos anteriores.
diff --git a/documentation/content/pt-br/books/porters-handbook/_index.adoc b/documentation/content/pt-br/books/porters-handbook/_index.adoc
index 57cb2e9e58..b1f46c3a79 100644
--- a/documentation/content/pt-br/books/porters-handbook/_index.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/_index.adoc
@@ -3,8 +3,8 @@ title: FreeBSD Porter's Handbook
authors:
- author: Projeto de Documentação do FreeBSD
copyright: 2000-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "sun", "unix", "general"]
+trademarks: ["freebsd", "sun", "unix", "general"]
+isIndex: true
---
= FreeBSD Porter's Handbook
@@ -12,46 +12,34 @@ trademarks: ["freebsd", "sun", "unix", "general"]
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
-:part-signifier: Parte
-:chapter-signifier: Capítulo
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
+:book: true
+:pdf: false
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
-:chapters-path: content/pt-br/books/porters-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/porters-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/pt-br/mailing-lists.adoc[]
-include::../../../../shared/pt-br/teams.adoc[]
-include::../../../../shared/pt-br/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/pt-br/mailing-lists.adoc[]
-include::../../../../shared/pt-br/teams.adoc[]
-include::../../../../shared/pt-br/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -62,21 +50,21 @@ include::{chapters-path}toc-tables.adoc[]
include::{chapters-path}toc-examples.adoc[]
-include::{chapters-path}porting-why/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}new-port/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}slow-porting/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}makefiles/chapter.adoc[leveloffset=+1, lines=7..25;36..-1]
-include::{chapters-path}special/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}flavors/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}plist/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}testing/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}upgrading/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}security/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}order/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}uses/chapter.adoc[leveloffset=+1, lines=7..25;36..-1]
-include::{chapters-path}versions/chapter.adoc[leveloffset=+1, lines=6..23;34..-1]
+include::{chapters-path}porting-why/chapter.adoc[leveloffset=+1]
+include::{chapters-path}new-port/chapter.adoc[leveloffset=+1]
+include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1]
+include::{chapters-path}slow-porting/chapter.adoc[leveloffset=+1]
+include::{chapters-path}makefiles/chapter.adoc[leveloffset=+1]
+include::{chapters-path}special/chapter.adoc[leveloffset=+1]
+include::{chapters-path}flavors/chapter.adoc[leveloffset=+1]
+include::{chapters-path}plist/chapter.adoc[leveloffset=+1]
+include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1]
+include::{chapters-path}testing/chapter.adoc[leveloffset=+1]
+include::{chapters-path}upgrading/chapter.adoc[leveloffset=+1]
+include::{chapters-path}security/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1]
+include::{chapters-path}order/chapter.adoc[leveloffset=+1]
+include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1]
+include::{chapters-path}uses/chapter.adoc[leveloffset=+1]
+include::{chapters-path}versions/chapter.adoc[leveloffset=+1]
diff --git a/documentation/content/pt-br/books/porters-handbook/flavors/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/flavors/chapter.adoc
index 6ca306d240..412309f480 100644
--- a/documentation/content/pt-br/books/porters-handbook/flavors/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/flavors/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/plist
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[flavors-intro]]
== Uma Introdução aos Flavors
diff --git a/documentation/content/pt-br/books/porters-handbook/keeping-up/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/keeping-up/chapter.adoc
index e508cac03a..04a185f48a 100644
--- a/documentation/content/pt-br/books/porters-handbook/keeping-up/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/keeping-up/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/uses
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
A coleção de Ports do FreeBSD está em constante mudança. Aqui estão algumas informações sobre como se manter atualizado.
diff --git a/documentation/content/pt-br/books/porters-handbook/makefiles/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/makefiles/chapter.adoc
index 1cab2511ca..97d6a7a8d0 100644
--- a/documentation/content/pt-br/books/porters-handbook/makefiles/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/makefiles/chapter.adoc
@@ -11,27 +11,36 @@ next: books/porters-handbook/special
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-:g-plus-plus: g++
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Configurar o [.filename]#Makefile# é bastante simples e, novamente, sugerimos examinar os exemplos existentes antes de começar. Além disso, há um <<porting-samplem,Makefile de exemplo>> neste manual, então dê uma olhada e por favor siga a ordem das variáveis ​​e seções naquele modelo para tornar o port mais fácil para os outros lerem.
@@ -965,7 +974,7 @@ Como a Coleção de Ports vem crescendo com o tempo, várias novas categorias ta
Nossa prática atual tem sido a de evitar a criação de uma nova categoria física, a menos que um grande número de ports logicamente pertençam a ela, ou os ports que pertenceriam a ela sejam um grupo logicamente distinto de interesse geral limitado (por exemplo, categorias relacionadas com as línguas humanas faladas), ou de preferência ambas.
-A razão para isto é que tal mudança cria uma link:{committers-guide}#ports[quantidade grande de trabalho] tanto para os committers quanto para todos os usuários que rastreiam alterações na coleção de ports. Além disso, propostas de alteração de categorias parecem naturalmente atrair controvérsias. (Talvez isso seja porque não há um consenso claro sobre quando uma categoria é "grande o suficiente", nem quando as categorias devem ser apenas para propósitos de busca (e, portanto, qual número de categorias seria um número ideal), e assim por diante.)
+A razão para isto é que tal mudança cria uma extref:{committers-guide}[quantidade grande de trabalho, ports] tanto para os committers quanto para todos os usuários que rastreiam alterações na coleção de ports. Além disso, propostas de alteração de categorias parecem naturalmente atrair controvérsias. (Talvez isso seja porque não há um consenso claro sobre quando uma categoria é "grande o suficiente", nem quando as categorias devem ser apenas para propósitos de busca (e, portanto, qual número de categorias seria um número ideal), e assim por diante.)
Aqui está o procedimento:
@@ -982,7 +991,7 @@ Aqui está o procedimento:
** (para crédito extra, inclua os outros arquivos que precisam ser alterados, conforme o procedimento no Guia do Committer.)
. Como isso afeta a infraestrutura do ports e envolve a movimentação e alteração de vários ports, pode ser necessário executar testes de regressão no cluster de build, e portanto, atribua o PR para a Equipe de Gerenciamento de Ports mailto:portmgr@FreeBSD.org[portmgr@FreeBSD.org].
-. Se esse PR for aprovado, um committer precisará seguir o restante do procedimento que é link:{committers-guide}#PORTS[descrito no Guia do Committer].
+. Se esse PR for aprovado, um committer precisará seguir o restante do procedimento que é extref:{committers-guide}[descrito no Guia do Committer, ports].
====
A proposta de uma nova categoria virtual é semelhante à acima, mas muito menos trabalhoso, já que nenhum port terá que ser movido. Nesse caso, os únicos patches a serem incluídos no PR serão aqueles para adicionar a nova categoria na linha `CATEGORIES` dos ports afetados.
@@ -2248,7 +2257,7 @@ Defina seu endereço de email aqui. Por favor. _:-)_
Apenas um único endereço sem a parte de comentário é permitido como um valor para `MAINTAINER`. O formato usado é `user@hostname.domain`. Por favor, não inclua nenhum texto descritivo, como um nome nesta entrada. Isso confunde a infraestrutura do Ports e a maioria das ferramentas que a usam.
-O mantenedor é responsável por manter o port atualizado e garantir que elo funcione corretamente. Para obter uma descrição detalhada das responsabilidades de um mantenedor de port, consulte link:{contributing}#maintain-port[O desafio para os mantenedores de port].
+O mantenedor é responsável por manter o port atualizado e garantir que elo funcione corretamente. Para obter uma descrição detalhada das responsabilidades de um mantenedor de port, consulte extref:{contributing}[O desafio para os mantenedores de port, maintain-port].
[NOTE]
====
@@ -2256,7 +2265,7 @@ Um mantenedor se voluntaria para manter um port em bom estado de funcionamento.
Alguns tipos de correções tem "aprovação implícita" da Equipe de Gerenciamento do Ports mailto:portmgr@FreeBSD.org[portmgr@FreeBSD.org], permitindo que qualquer committer conserte essas categorias de problemas em qualquer port. Essas correções não precisam da aprovação do mantenedor.
-Aprovação implícita para a maioria dos ports se aplicam para correções como mudanças de infraestrutura, trivialidades e correções _testadas_ de compilação e execução. A lista atual está disponibilizada em link:{committers-guide}#ports-qa-misc-blanket-approval[Seção Ports do Guia dos Committers].
+Aprovação implícita para a maioria dos ports se aplicam para correções como mudanças de infraestrutura, trivialidades e correções _testadas_ de compilação e execução. A lista atual está disponibilizada em extref:{committers-guide}[Seção Ports do Guia dos Committers, ports-qa-misc-blanket-approval].
====
Outras alterações no port serão enviadas ao mantenedor para revisão e aprovação antes de se fazer o commit. Se o mantenedor não responder a uma solicitação de atualização após duas semanas (excluindo os principais feriados), isso será considerado como timeout do mantenedor, e a atualização poderá ser feita sem a aprovação explícita do mesmo. Se o mantenedor não responder dentro de três meses, ou se houver três timeouts consecutivos, então o mantenedor é considerado ausente, e todas os seus ports podem ser atribuídos de volta para à comunidade. Exceções para isso são quaisquer ports mantidos pela Equipe de Gerenciamento de Ports mailto:portmgr@FreeBSD.org[portmgr@FreeBSD.org] ou pela Equipe de Oficias de Segurança mailto:security-officer@FreeBSD.org[security-officer@FreeBSD.org]. Nenhum commit não autorizado pode ser feito em ports mantidos por esses grupos.
diff --git a/documentation/content/pt-br/books/porters-handbook/new-port/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/new-port/chapter.adoc
index 63f44afe50..eeb1c1c212 100644
--- a/documentation/content/pt-br/books/porters-handbook/new-port/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/new-port/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/quick-porting
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Interessado em fazer um novo port ou atualizar os ports existentes? Ótimo!
diff --git a/documentation/content/pt-br/books/porters-handbook/order/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/order/chapter.adoc
index a40faf7487..78da146b3f 100644
--- a/documentation/content/pt-br/books/porters-handbook/order/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/order/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/keeping-up
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
As primeiras seções do [.filename]#Makefile# devem sempre vir na mesma ordem. Este padrão faz com que todos possam ler facilmente qualquer port sem ter que procurar variáveis em uma ordem aleatória.
diff --git a/documentation/content/pt-br/books/porters-handbook/pkg-files/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/pkg-files/chapter.adoc
index 2987f0657a..aa152280f0 100644
--- a/documentation/content/pt-br/books/porters-handbook/pkg-files/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/pkg-files/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/testing
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Existem alguns truques que ainda não foram mencionamos sobre os arquivos [.filename]#pkg-*# que são úteis às vezes.
diff --git a/documentation/content/pt-br/books/porters-handbook/plist/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/plist/chapter.adoc
index 081b0a8e33..7dc7c5c089 100644
--- a/documentation/content/pt-br/books/porters-handbook/plist/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/plist/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/pkg-files
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[plist-sub]]
== Alterando o [.filename]#pkg-plist# Baseado em Variáveis Make
diff --git a/documentation/content/pt-br/books/porters-handbook/porting-dads/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/porting-dads/chapter.adoc
index 4186efd843..36d877d007 100644
--- a/documentation/content/pt-br/books/porters-handbook/porting-dads/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/porting-dads/chapter.adoc
@@ -11,38 +11,48 @@ next: books/porters-handbook/porting-samplem
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
:freebsd-version: __FreeBSD_version
:freebsd: __FreeBSD__
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dads-intro]]
== Introdução
-Aqui está uma lista comum de o que fazer ou não, encontrada durante o processo de portabilidade. Verifique o port com relação a essa lista, mas também verifique os ports no https://bugs.FreeBSD.org/search/[banco de dados de PR's] que outros enviaram. Envie quaisquer comentários sobre os ports, conforme descrito em link:{contributing}#CONTRIB-GENERAL[Relatórios de Bugs e Comentários Gerais]. Verificar os ports no banco de dados de PR's irá tornar o processo mais rápido para que possamos fazer o seu commit e para provar que você sabe o que está fazendo.
+Aqui está uma lista comum de o que fazer ou não, encontrada durante o processo de portabilidade. Verifique o port com relação a essa lista, mas também verifique os ports no https://bugs.FreeBSD.org/search/[banco de dados de PR's] que outros enviaram. Envie quaisquer comentários sobre os ports, conforme descrito em extref:{contributing}[Relatórios de Bugs e Comentários Gerais, CONTRIB-GENERAL]. Verificar os ports no banco de dados de PR's irá tornar o processo mais rápido para que possamos fazer o seu commit e para provar que você sabe o que está fazendo.
[[porting-wrkdir]]
== `WRKDIR`
-Não escreva nada em arquivos fora do `WRKDIR`. `WRKDIR` é o único lugar garantido com permissão de escrita durante a compilação do port (consulte link:{handbook}#PORTS-CD[instalando ports a partir de um CDROM] para um exemplo de construção de ports de uma árvore somente leitura). Os arquivos [.filename]#pkg-*# podem ser modificados pela <<pkg-names,redefinição de uma variável>> em vez de sobrescrever o arquivo.
+Não escreva nada em arquivos fora do `WRKDIR`. `WRKDIR` é o único lugar garantido com permissão de escrita durante a compilação do port (consulte extref:{handbook}ports[instalando ports a partir de um CDROM, PORTS-CD] para um exemplo de construção de ports de uma árvore somente leitura). Os arquivos [.filename]#pkg-*# podem ser modificados pela <<pkg-names,redefinição de uma variável>> em vez de sobrescrever o arquivo.
[[porting-wrkdirprefix]]
== `WRKDIRPREFIX`
diff --git a/documentation/content/pt-br/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/porting-samplem/chapter.adoc
index 88ee8c6405..dbcd834f8d 100644
--- a/documentation/content/pt-br/books/porters-handbook/porting-samplem/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/porting-samplem/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/order
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Aqui está um exemplo de [.filename]#Makefile# que pode ser usado para criar um novo port. Certifique-se de remover todos os comentários extras (entre colchetes).
diff --git a/documentation/content/pt-br/books/porters-handbook/porting-why/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/porting-why/chapter.adoc
index 229528fbbe..c91b75b047 100644
--- a/documentation/content/pt-br/books/porters-handbook/porting-why/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/porting-why/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/new-port
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
A Coleção de Ports do FreeBSD é a maneira como quase todo mundo instala aplicativos ("ports") no FreeBSD. Como tudo no FreeBSD, é principalmente um esforço voluntário. É importante ter isso em mente ao ler este documento.
diff --git a/documentation/content/pt-br/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/quick-porting/chapter.adoc
index dfa9772b1b..905a356219 100644
--- a/documentation/content/pt-br/books/porters-handbook/quick-porting/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/quick-porting/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/slow-porting
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Esta seção descreve como criar rapidamente um novo port. Para aplicativos em que esse método rápido não for adequado, o processo "Slow Porting" está descrito no <<slow-porting>>.
@@ -273,7 +283,7 @@ Depois de enviar o port, por favor, seja paciente. O tempo necessário para incl
Para obter uma listagem dos PRs _abertos_ para os ports, selecione _Open_ e _Ports & Packages_ no formulário de pesquisa, clique em btn:[Search].
-Depois de analisar o novo port, nós responderemos se necessário, e iremos adicioná-lo a árvore. O nome do remetente também será adicionado à lista de link:{contributors}#contrib-additional[Contribuidores Adicionais do FreeBSD] e outros arquivos.
+Depois de analisar o novo port, nós responderemos se necessário, e iremos adicioná-lo a árvore. O nome do remetente também será adicionado à lista de extref:{contributors}[Contribuidores Adicionais do FreeBSD, contrib-additional] e outros arquivos.
Também é possível enviar ports usando um arquivo man:shar[1]. Usando o exemplo anterior com o port `oneko` acima.
diff --git a/documentation/content/pt-br/books/porters-handbook/security/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/security/chapter.adoc
index 28b6c991db..70dca85239 100644
--- a/documentation/content/pt-br/books/porters-handbook/security/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/security/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/porting-dads
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-intro]]
== Por Que Segurança é Tão Importante
diff --git a/documentation/content/pt-br/books/porters-handbook/slow-porting/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/slow-porting/chapter.adoc
index 04164f8c10..b1d466a219 100644
--- a/documentation/content/pt-br/books/porters-handbook/slow-porting/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/slow-porting/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/makefiles
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Certo, então não foi tão simples e o port precisou de algumas modificações para poder funcionar. Nesta seção, vamos explicar passo a passo como modificá-lo para que funcione com o paradigma do ports.
diff --git a/documentation/content/pt-br/books/porters-handbook/special/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/special/chapter.adoc
index 665f0fc4ca..8750eba096 100644
--- a/documentation/content/pt-br/books/porters-handbook/special/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/special/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/flavors
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Esta seção explica as coisas mais comuns a se considerar ao criar um port.
@@ -4121,7 +4131,7 @@ Veja <<uses-sqlite>> para mais informações.
[[rc-scripts]]
== Iniciando e Parando Serviços (com scripts `rc`)
-Os scripts [.filename]#rc.d# são usados ​​para iniciar serviços na inicialização do sistema e para fornecer aos administradores uma maneira padrão de parar, iniciar e reiniciar o serviço. Ports se integram ao sistema de estrutura do [.filename]#rc.d#. Detalhes sobre seu uso podem ser encontrados no link:{handbook}#configtuning-rcd[capitulo sobre rc.d] do handbook. A explicação detalhada dos comandos disponíveis é fornecida em man:rc[8] e man:rc.sub[8]. Finalmente, existe um link:{rc-scripting}[artigo] sobre aspectos práticos do sistema de scripts do [.filename]#rc.d#.
+Os scripts [.filename]#rc.d# são usados ​​para iniciar serviços na inicialização do sistema e para fornecer aos administradores uma maneira padrão de parar, iniciar e reiniciar o serviço. Ports se integram ao sistema de estrutura do [.filename]#rc.d#. Detalhes sobre seu uso podem ser encontrados no extref:{handbook}config-tuning[capitulo sobre rc.d, configtuning-rcd] do handbook. A explicação detalhada dos comandos disponíveis é fornecida em man:rc[8] e man:rc.sub[8]. Finalmente, existe um extref:{rc-scripting}[artigo] sobre aspectos práticos do sistema de scripts do [.filename]#rc.d#.
Com um port mítico chamado _doorman_, o qual precisa iniciar um daemon _doormand_. Adicione o seguinte ao [.filename]#Makefile#:
diff --git a/documentation/content/pt-br/books/porters-handbook/testing/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/testing/chapter.adoc
index 6278151654..4b01c787bc 100644
--- a/documentation/content/pt-br/books/porters-handbook/testing/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/testing/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/upgrading
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[make-describe]]
== Executando `make describe`
@@ -190,7 +200,7 @@ Utiliza o [.filename]#/etc/resolv.conf# do host dentro do jails para a resoluç
O servidor FTP/HTTP a ser usado quando as jails são instaladas a partir de versões do FreeBSD e atualizadas com o man:freebsd-update[8]. Escolha um servidor cuja localização esteja próxima, por exemplo, se a máquina estiver localizada na Austrália, use `ftp.au.freebsd.org`.
`SVN_HOST`::
-O servidor de onde as jails são instaladas e atualizadas ao usar o Subversion. Também usado para a árvore de ports quando não estiver usando o man:portsnap[8]. Mais uma vez, escolha um local próximo. Uma lista de espelhos oficiais do Subversion podem ser encontrados na seção sobre link:{handbook}#svn-mirrors[Subversion] do Handbook do FreeBSD.
+O servidor de onde as jails são instaladas e atualizadas ao usar o Subversion. Também usado para a árvore de ports quando não estiver usando o man:portsnap[8]. Mais uma vez, escolha um local próximo. Uma lista de espelhos oficiais do Subversion podem ser encontrados na seção sobre extref:{handbook}mirrors[Subversion, svn-mirrors] do Handbook do FreeBSD.
[[testing-poudriere-create-jails]]
=== Criando Poudriere Jails
diff --git a/documentation/content/pt-br/books/porters-handbook/upgrading/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/upgrading/chapter.adoc
index 009af6ed4a..314b0022bc 100644
--- a/documentation/content/pt-br/books/porters-handbook/upgrading/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/upgrading/chapter.adoc
@@ -11,30 +11,40 @@ next: books/porters-handbook/security
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Quando um port não estiver na versão mais recente disponibilizada pelos autores, atualize a sua cópia de trabalho local do [.filename]#/usr/ports#. O port pode já ter sido atualizado para a nova versão.
-Ao trabalhar com diversos ports, provavelmente será mais fácil usar o Subversion para manter toda a coleção de ports atualizada, conforme descrito no link:{handbook}#ports-using[Handbook]. Isso trará o benefício adicional de rastrear todas as dependências de ports.
+Ao trabalhar com diversos ports, provavelmente será mais fácil usar o Subversion para manter toda a coleção de ports atualizada, conforme descrito no extref:{handbook}ports[Handbook, ports-using]. Isso trará o benefício adicional de rastrear todas as dependências de ports.
O próximo passo é ver se há uma atualização já pendente. Para fazer isso, existem duas opções. Há uma interface de pesquisa no https://bugs.freebsd.org/search/[Relatório de Problemas do FreeBSD (PR) ou banco de dados de bugs]. Selecione `Ports & Packages` no menu de seleção múltipla `Product` e digite o nome do port no campo `Summary`.
@@ -60,11 +70,11 @@ Se alguns arquivos foram adicionados, copiados, movidos ou removidos, adicione e
Para simplificar operações comuns com arquivos de patch, use `make makepatch` como descrito em <<slow-patch>>. Existem outras ferramentas, como [.filename]#/usr/ports/Tools/scripts/patchtool.py#. Antes de usá-lo, por favor leia [.filename]#/usr/ports/Tools/scripts/README.patchtool#.
-Se o port não é mantido e você o utiliza ativamente, por favor, considere se voluntariar como o seu mantenedor. O FreeBSD tem mais de 4000 ports sem mantenedores, e esta é uma área onde mais voluntários são sempre necessários. (Para uma descrição detalhada das responsabilidades dos mantenedores, consulte a seção no link:{developers-handbook}#POLICIES-MAINTAINER[Developer's Handbook].)
+Se o port não é mantido e você o utiliza ativamente, por favor, considere se voluntariar como o seu mantenedor. O FreeBSD tem mais de 4000 ports sem mantenedores, e esta é uma área onde mais voluntários são sempre necessários. (Para uma descrição detalhada das responsabilidades dos mantenedores, consulte a seção no extref:{developers-handbook}[Developer's Handbook, POLICIES-MAINTAINER].)
Para enviar o diff, use o https://bugs.freebsd.org/submit/[formulário de envio de bugs] (no produto `Ports & Packages`, e no componente `Individual Port(s)`). Sempre inclua a categoria com o nome do port, seguido por dois pontos e uma breve descrição do problema. Exemplos: `_category/portname_: _add FOO option_`; `_category/portname_: _Update to XY_`. Por favor mencione quaisquer arquivos adicionados ou deletados na mensagem, pois eles devem ser explicitamente especificados no man:svn[1] ao fazer o commit. Não comprima ou codifique o diff.
-Antes de enviar o bug, revise a seção link:{problem-reports}#pr-writing[Escrevendo um relatório de problema] no artigo Relatórios de Problemas. Ele contém muito mais informações sobre como escrever relatórios úteis de problemas.
+Antes de enviar o bug, revise a seção extref:{problem-reports}[Escrevendo um relatório de problema, pr-writing] no artigo Relatórios de Problemas. Ele contém muito mais informações sobre como escrever relatórios úteis de problemas.
[IMPORTANT]
====
@@ -91,7 +101,7 @@ Quando possível, envie por favor um man:svn[1]diff. Eles são mais fáceis de m
....
<.> Isso pode ser em qualquer lugar, é claro. Compilações de ports não se limitam ao [.filename]#/usr/ports/#.
-<.> O https://svn.FreeBSD.org/[svn.FreeBSD.org] é o servidor Subversion público do FreeBSD. Veja link:{handbook}#svn-mirrors[Mirrors do Subversion] para mais informações.
+<.> O https://svn.FreeBSD.org/[svn.FreeBSD.org] é o servidor Subversion público do FreeBSD. Veja extref:{handbook}mirrors[Mirrors do Subversion, svn-mirrors] para mais informações.
Enquanto estiver no diretório de ports, faça as alterações necessárias. Se você adicionar, copiar, mover ou remover um arquivo, use o `svn` para registrar essas alterações:
@@ -144,7 +154,7 @@ O último passo é fazer um man:diff[1] unificado das mudanças:
Se os arquivos foram adicionados, copiados, movidos ou removidos, inclua os comandos man:svn[1]`add`, `copy`, `move` e `remove` que foram usados. O `svn move` ou o `svn copy` deve ser executado antes de aplicar o patch. O `svn add` ou `svn remove` deve ser executado após o patch ser aplicado.
====
-Envie o patch seguindo as link:{problem-reports}#pr-writing[diretrizes de envios de relatórios de problemas].
+Envie o patch seguindo as extref:{problem-reports}[diretrizes de envios de relatórios de problemas, pr-writing].
[[moved-and-updating-files]]
== [.filename]#UPDATE# e [.filename]#MOVED#
diff --git a/documentation/content/pt-br/books/porters-handbook/uses/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/uses/chapter.adoc
index a8bfbb4474..77d467524f 100644
--- a/documentation/content/pt-br/books/porters-handbook/uses/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/uses/chapter.adoc
@@ -11,27 +11,37 @@ next: books/porters-handbook/versions
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
:c-plus-plus: c++
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[uses-intro]]
== Uma introdução ao `USES`
diff --git a/documentation/content/pt-br/books/porters-handbook/versions/chapter.adoc b/documentation/content/pt-br/books/porters-handbook/versions/chapter.adoc
index 6f2917b8d4..ceaccec443 100644
--- a/documentation/content/pt-br/books/porters-handbook/versions/chapter.adoc
+++ b/documentation/content/pt-br/books/porters-handbook/versions/chapter.adoc
@@ -10,26 +10,36 @@ prev: books/porters-handbook/uses
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-:toc-title: Índice
-:table-caption: Tabela
-:figure-caption: Figura
-:example-caption: Exemplo
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/pt-br/mailing-lists.adoc[]
-include::shared/pt-br/teams.adoc[]
-include::shared/pt-br/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Aqui está uma lista conveniente dos valores `__FreeBSD_version` definidos em http://svnweb.FreeBSD.org/base/head/sys/sys/param.h?view=markup[sys/param.h]:
diff --git a/documentation/content/ru/articles/committers-guide/_index.adoc b/documentation/content/ru/articles/committers-guide/_index.adoc
index 527d827223..96448dfda8 100644
--- a/documentation/content/ru/articles/committers-guide/_index.adoc
+++ b/documentation/content/ru/articles/committers-guide/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: The FreeBSD Documentation Project
- author: Дмитрий Морозовский
copyright: 1999-2007 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "cvsup", "ibm", "intel", "sparc", "general"]
---
@@ -17,33 +16,26 @@ trademarks: ["freebsd", "cvsup", "ibm", "intel", "sparc", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-
-ifeval::["{backend}" == "html5"]
+:images-path: articles/committers-guide/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -573,7 +565,7 @@ Host pcvs.FreeBSD.org
+
Это довольно простая задача, но при этом она является неплохим первым тестом ваших навыков работы с CVS.
* Также добавьте свою "SGML сущность" в [.filename]#www/en/developers.xml#.
-* Добавьте себя в раздел "Разработчики" статьи link:{contributors}[Участники проекта FreeBSD] ([.filename]#doc/en_US.ISO8859-1/articles/contributors/contrib.committers.xml#) и удалите свою запись из раздела "Прочие участники" ([.filename]#doc/en_US.ISO8859-1/articles/contributors/contrib.additional.xml#).
+* Добавьте себя в раздел "Разработчики" статьи extref:{contributors}[Участники проекта FreeBSD] ([.filename]#doc/en_US.ISO8859-1/articles/contributors/contrib.committers.xml#) и удалите свою запись из раздела "Прочие участники" ([.filename]#doc/en_US.ISO8859-1/articles/contributors/contrib.additional.xml#).
* Добавьте новость о новом коммиттере в файл [.filename]#www/shared/xml/news.xml#. Используйте существующие записи вида "Новый коммиттер" как шаблон.
* Вам нужно добавить ваш PGP или GnuPG ключ в каталог [.filename]#doc/shared/pgpkeys# (а если у вас нет ключа, вам нужно его создать). Не забудьте изменить и произвести коммит в файл [.filename]#doc/shared/pgpkeys/pgpkeys.ent#.
+
@@ -742,7 +734,7 @@ docs:Documentation Bug:freebsd-doc:
Джон возглавляет проект SMPng и отвечает за архитектуру, дизайн и реализацию перехода на многонитевое ядро. Джон также является редактором статьи "Архитектура SMPng". Если вы работаете с тонкими блокировками многопроцессорного ядра, координируйте свою работу с Джоном.
`{doceng}`::
-doceng - группа, отвечающая за инфраструктуру построения документации, прием новых коммиттеров документации и актуальность информации относительно CVS на веб-сайте и FTP-сайте FreeBSD. Эта группа не разбирает конфликты. Большая часть обсуждений, связанных с документацией, происходит в {freebsd-doc}. Дополнительную информацию о деятельности группы можно найти в ее http://www.FreeBSD.org/internal/doceng/[собственном документе]. Коммиттеры, заинтересованные в обновлении документации, должны ознакомиться с link:{fdp-primer}[Учебником по Проекту Документирования FreeBSD для новых участников].
+doceng - группа, отвечающая за инфраструктуру построения документации, прием новых коммиттеров документации и актуальность информации относительно CVS на веб-сайте и FTP-сайте FreeBSD. Эта группа не разбирает конфликты. Большая часть обсуждений, связанных с документацией, происходит в {freebsd-doc}. Дополнительную информацию о деятельности группы можно найти в ее http://www.FreeBSD.org/internal/doceng/[собственном документе]. Коммиттеры, заинтересованные в обновлении документации, должны ознакомиться с extref:{fdp-primer}[Учебником по Проекту Документирования FreeBSD для новых участников].
`{ru}`::
Руслан великолепно знает тонкости man:mdoc[7]. Если вы пишете справочную страницу и нуждаетесь в совете по ее структуре или разметке, обратитесь к Руслану.
@@ -831,9 +823,9 @@ cvs-committers - адрес, используемый CVS для посылки
Если вы сомневаетесь, просите отзыва!
. Уважайте существующих мейнтейнеров.
+
-Многие части кода FreeBSD не являются чьей-либо "собственностью": ситуация, когда некто подпрыгнет и завопит, если вы внесете изменения в "его" код, редка; однако, всегда стоит предварительно проверить. Одним из используемых соглашений было добавление строки MAINTAINER в файл [.filename]#Makefile# пакета или части дерева, которая активно поддерживается одним или несколькими коммиттерами; см. также соответствующий раздел link:{developers-handbook}#policies[Source Tree Guidelines and Policies]. В случае, если какой-то участок системы имеет несколько мейнтейнеров, изменение его одним из них должно быть одобрено по крайней мере одним из других. В случаях, когда "принадлежность" кода неясна, вы можете взглянуть на историю коммитов, чтобы понять, кто наиболее активно либо в последнее время работал в этой области.
+Многие части кода FreeBSD не являются чьей-либо "собственностью": ситуация, когда некто подпрыгнет и завопит, если вы внесете изменения в "его" код, редка; однако, всегда стоит предварительно проверить. Одним из используемых соглашений было добавление строки MAINTAINER в файл [.filename]#Makefile# пакета или части дерева, которая активно поддерживается одним или несколькими коммиттерами; см. также соответствующий раздел extref:{developers-handbook}[Source Tree Guidelines and Policies, policies]. В случае, если какой-то участок системы имеет несколько мейнтейнеров, изменение его одним из них должно быть одобрено по крайней мере одним из других. В случаях, когда "принадлежность" кода неясна, вы можете взглянуть на историю коммитов, чтобы понять, кто наиболее активно либо в последнее время работал в этой области.
+
-Отдельные области FreeBSD попадают под контроль коммиттеров, занимающихся поддержкой целых категорий на пути эволюции FreeBSD, таких как локализация или сетевая подсистема. Для дополнительной информации смотрите link:{contributors}#staff-who/[http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/contributors/staff-who]
+Отдельные области FreeBSD попадают под контроль коммиттеров, занимающихся поддержкой целых категорий на пути эволюции FreeBSD, таких как локализация или сетевая подсистема. Для дополнительной информации смотрите extref:{contributors}[http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/contributors/staff-who, staff-who]
. Любое спорное изменение необходимо откатить в ожидании решения, если того требует мейнтейнер. Вопросы безопасности могут перекрывать мнение мейнтейнера, если так решит Security Officer.
+
Это может быть нелегко, особенно в период конфликта (когда каждый участник уверен, что прав именно он). К счастью, CVS дает возможность, вместо того чтобы вести бушующую перебранку, просто откатить внесенные изменения, успокоиться всем участникам конфликта, а затем попробовать найти взаимоприемлемый путь. Если в конце концов окажется, что изменение стоит того, оно может быть легко применено вновь. В противном случае, пользователям не придется жить с неправильным состоянием дерева исходных текстов, пока стороны заняты выяснением отношений. Запросы на откаты возникают _крайне_ редко, поскольку обсуждение обычно выявляет неверные или спорные моменты до коммита; однако, если такой запрос все же возник, он должен быть безусловно удовлетворен, чтобы мы могли спокойно выяснить, было изменение неверным или нет.
@@ -963,11 +955,11 @@ FreeBSD является хорошо портируемой операцион
....
-Более подробные инструкции можно найти в link:{porters-handbook}[Руководстве FreeBSD по созданию портов].
+Более подробные инструкции можно найти в extref:{porters-handbook}[Руководстве FreeBSD по созданию портов].
Пользуйтесь man:portlint[1] для проверки корректности порта. Не обязательно добиваться полного отсутствия предупреждений, но по крайней мере исправьте простейшие из них.
-Если новый порт прислал человек, еще не упомянутый в link:{contributors}#contrib-additional[Списке прочих участников], добавьте его имя туда.
+Если новый порт прислал человек, еще не упомянутый в extref:{contributors}[Списке прочих участников, contrib-additional], добавьте его имя туда.
Закройте PR, если новый порт пришел в виде PR. Для этого воспользуйтесь командой `edit-pr _PR#_` на машине `freefall` и измените значение в строке `state` с `open` на `closed`. Затем опишите причину смены статуса, и на этом работа закончена.
diff --git a/documentation/content/ru/articles/contributing/_index.adoc b/documentation/content/ru/articles/contributing/_index.adoc
index 6a3a59c72a..c29f50bc99 100644
--- a/documentation/content/ru/articles/contributing/_index.adoc
+++ b/documentation/content/ru/articles/contributing/_index.adoc
@@ -2,7 +2,6 @@
title: Участие в проекте FreeBSD
authors:
- author: Джордан Хаббард
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ieee", "general"]
---
@@ -15,27 +14,26 @@ trademarks: ["freebsd", "ieee", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-
-ifeval::["{backend}" == "html5"]
-include::shared/ru/mailing-lists.adoc[lines=9..-1]
-include::shared/ru/urls.adoc[]
+:images-path: articles/contributing/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/ru/mailing-lists.adoc[lines=9..-1]
-include::../../../../shared/ru/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/ru/mailing-lists.adoc[lines=9..-1]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -66,7 +64,7 @@ toc::[]
Многие люди, связанные с FreeBSD, не являются программистами. В Проекте участвуют создатели документации, Web-дизайнеры и специалисты по поддержке пользователей. Все, что им нужно для участия, это своё время и желание учиться.
. Периодически читайте FAQ и Руководство. Если что-то описано плохо, устарело или даже полностью неправильно, дайте нам знать. Ещё лучше, если вы пришлёте нам исправление (выучить Docbook не так сложно, но и против посланий в формате ASCII никто возражать не будет).
-. Помогите перевести документацию FreeBSD на ваш родной язык. Если документация на вашем языке уже существует, вы можете помочь перевести дополнительные документы или проверить, не устарели ли переводы. Первым делом взгляните на link:{fdp-primer}#translations[FAQ по переводам] в Учебнике проекта документирования FreeBSD. Вас не призывают перевести все документы FreeBSD - как доброволец, вы можете делать столько переводов, сколько захотите. Если кто-то начал перевод, другие всегда присоединятся. Если у вас есть время и желание перевести одну часть документации, пожалуйста, переведите инструкции по установке.
+. Помогите перевести документацию FreeBSD на ваш родной язык. Если документация на вашем языке уже существует, вы можете помочь перевести дополнительные документы или проверить, не устарели ли переводы. Первым делом взгляните на extref:{fdp-primer}[FAQ по переводам, translations] в Учебнике проекта документирования FreeBSD. Вас не призывают перевести все документы FreeBSD - как доброволец, вы можете делать столько переводов, сколько захотите. Если кто-то начал перевод, другие всегда присоединятся. Если у вас есть время и желание перевести одну часть документации, пожалуйста, переведите инструкции по установке.
. Время от времени (или даже регулярно) читайте {freebsd-questions} и news:comp.unix.bsd.freebsd.misc. Вам может понравиться делиться своим опытом и помогать людям решать их проблемы; иногда вы сможете узнать для себя что-то новое! Эти форумы могут также стать источником идей, над которыми вам стоит поработать.
[[ongoing-programmer-tasks]]
@@ -103,7 +101,7 @@ http://wiki.freebsd.org/IdeasPage[Список проектов и идей дл
[[contrib-general]]
=== Сообщения об ошибках и отзывы общего характера
-Идеи или пожелания _общего_ технического характера должны направляться по электронной почте в адрес {freebsd-hackers}. Подобным же образом тот, кто интересуется такими вещами (и устойчив к _большому_ потоку почты!) может подписаться на список рассылки {freebsd-hackers}. Обратитесь к link:{handbook}#eresources-mail[Руководству FreeBSD] для получения дополнительной информации об этом и других списках рассылки.
+Идеи или пожелания _общего_ технического характера должны направляться по электронной почте в адрес {freebsd-hackers}. Подобным же образом тот, кто интересуется такими вещами (и устойчив к _большому_ потоку почты!) может подписаться на список рассылки {freebsd-hackers}. Обратитесь к extref:{handbook}eresources[Руководству FreeBSD, eresources-mail] для получения дополнительной информации об этом и других списках рассылки.
Если вы нашли ошибку или предлагаете внести какое-то конкретное исправление, пожалуйста, отправьте сообщение при помощи программы man:send-pr[1] или её link:https://www.FreeBSD.org/send-pr/[Web-эквивалента]. Постарайтесь заполнить все поля в сообщении об ошибке. Если его размер оно не превышает 65 Кбайт, включите все патчи непосредственно в сообщение. Если патч предназначен для дерева исходных текстов, поместите `[PATCH]` в теме сообщения. При включении патчей _не используйте_ технику cut-and-paste, потому что при этом символы табуляции преобразуются в пробелы и патч становится непригодным к использованию. Если объём патчей превышает 20 Кбайт, лучше включать их в сообщение в сжатом виде, для чего упакуйте их (например, при помощи man:gzip[1] или man:bzip2[1]) и обработайте архив утилитой man:uuencode[1].
@@ -111,15 +109,15 @@ http://wiki.freebsd.org/IdeasPage[Список проектов и идей дл
Если вы не получили подтверждения в течение разумного периода времени (от 3 дней до недели, в зависимости от вашего подключения к электронной почты) или по какой-то причине не можете воспользоваться командой man:send-pr[1], то можете попросить кого-нибудь направить сообщение за вас на адрес {freebsd-bugs}.
-Прочтите также link:{problem-reports}[эту статью], чтобы узнать, как писать хорошие сообщения о проблемах.
+Прочтите также extref:{problem-reports}[эту статью], чтобы узнать, как писать хорошие сообщения о проблемах.
=== Изменения в документации
-Изменения в документации обсуждаются в {freebsd-doc}. Пожалуйста, посмотрите link:{fdp-primer}[Учебник Проекта документирования FreeBSD] для получения полных инструкций. Посылайте свои пожелания и изменения (принимаются даже самые небольшие!) при помощи man:send-pr[1], как это описано в разделе о <<contrib-general>>.
+Изменения в документации обсуждаются в {freebsd-doc}. Пожалуйста, посмотрите extref:{fdp-primer}[Учебник Проекта документирования FreeBSD] для получения полных инструкций. Посылайте свои пожелания и изменения (принимаются даже самые небольшие!) при помощи man:send-pr[1], как это описано в разделе о <<contrib-general>>.
=== Изменения к имеющемуся исходному коду
-Добавление нового исходного кода или внесение изменений в существующий является не такой простой задачей, и зависит во многом от того, насколько вы далеки от текущего состояния разработок во FreeBSD. Существуют специальные промежуточные релизы FreeBSD, известные как "FreeBSD-CURRENT", которые доступны несколькими разными способами, удобными разработчикам, активно работающим над системой. Обратитесь к link:{handbook}#current-stable[Руководству FreeBSD] для получения дополнительной информации о получении и использовании FreeBSD-CURRENT.
+Добавление нового исходного кода или внесение изменений в существующий является не такой простой задачей, и зависит во многом от того, насколько вы далеки от текущего состояния разработок во FreeBSD. Существуют специальные промежуточные релизы FreeBSD, известные как "FreeBSD-CURRENT", которые доступны несколькими разными способами, удобными разработчикам, активно работающим над системой. Обратитесь к extref:{handbook}updating-upgrading[Руководству FreeBSD, current-stable] для получения дополнительной информации о получении и использовании FreeBSD-CURRENT.
Если вы работаете с несколько устаревшими исходными текстами, то ваши изменения иногда могут оказаться уже ненужными или слишком большими, чтобы повторно интегрировать их во FreeBSD. Уменьшить такой риск можно, подписавшись на списки рассылки {freebsd-announce} и {freebsd-current}, в которых обсуждается текущее состояние системы.
diff --git a/documentation/content/ru/articles/cups/_index.adoc b/documentation/content/ru/articles/cups/_index.adoc
index 92abbf9785..88ef2ee99e 100644
--- a/documentation/content/ru/articles/cups/_index.adoc
+++ b/documentation/content/ru/articles/cups/_index.adoc
@@ -3,7 +3,6 @@ title: Универсальная Система Печати Unix на FreeBSD
authors:
- author: Chess Griffin
email: chess@chessgriffin.com
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -16,13 +15,27 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
+:images-path: articles/cups/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Аннотация
diff --git a/documentation/content/ru/articles/explaining-bsd/_index.adoc b/documentation/content/ru/articles/explaining-bsd/_index.adoc
index 856f56a993..9374ee2ae9 100644
--- a/documentation/content/ru/articles/explaining-bsd/_index.adoc
+++ b/documentation/content/ru/articles/explaining-bsd/_index.adoc
@@ -3,7 +3,6 @@ title: Что такое BSD
authors:
- author: Greg Lehey
email: grog@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sparc", "sun", "unix", "general"]
---
@@ -16,13 +15,27 @@ trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sparc",
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
+:images-path: articles/explaining-bsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Аннотация
diff --git a/documentation/content/ru/articles/fonts/_index.adoc b/documentation/content/ru/articles/fonts/_index.adoc
index 068a415ed4..d67530483b 100644
--- a/documentation/content/ru/articles/fonts/_index.adoc
+++ b/documentation/content/ru/articles/fonts/_index.adoc
@@ -4,7 +4,6 @@ subtitle: Пособие
authors:
- author: Dave Bodenstab
email: imdave@synet.net
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "adobe", "apple", "linux", "microsoft", "opengroup", "general"]
---
@@ -17,13 +16,27 @@ trademarks: ["freebsd", "adobe", "apple", "linux", "microsoft", "opengroup", "ge
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
+:images-path: articles/fonts/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Аннотация
diff --git a/documentation/content/ru/articles/freebsd-questions/_index.adoc b/documentation/content/ru/articles/freebsd-questions/_index.adoc
index a5e814377d..3651ec6cfc 100644
--- a/documentation/content/ru/articles/freebsd-questions/_index.adoc
+++ b/documentation/content/ru/articles/freebsd-questions/_index.adoc
@@ -3,7 +3,6 @@ title: Как работать со списком рассылки FreeBSD-ques
authors:
- author: Greg Lehey
email: grog@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "microsoft", "opengroup", "qualcomm", "general"]
---
@@ -16,27 +15,26 @@ trademarks: ["freebsd", "microsoft", "opengroup", "qualcomm", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-
-ifeval::["{backend}" == "html5"]
-include::shared/ru/mailing-lists.adoc[lines=9..-1]
-include::shared/ru/urls.adoc[]
+:images-path: articles/freebsd-questions/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/ru/mailing-lists.adoc[lines=9..-1]
-include::../../../../shared/ru/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/ru/mailing-lists.adoc[lines=9..-1]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -134,14 +132,14 @@ your options page that will email your current password to you.
. Если вопрос относится к ошибке и вы __уверены__, что это ошибка (например, вы можете указать место в коде, где она происходит, и, может быть, у вас есть для нее исправление), то пошлите сообщение в список рассылки `FreeBSD-hackers`.
. Если вопрос относится к усовершенствованию FreeBSD, и вы можете дать предложения по ее реализации, то посылайте сообщение во `FreeBSD-hackers`.
-Имеется также некоторое количество других link:{handbook}#eresources-mail[специализированных списков рассылки]. Здесь также подходит указанный выше критерий, и в ваших интересах следовать ему, потому что именно так можно получить результат.
+Имеется также некоторое количество других extref:{handbook}eresources[специализированных списков рассылки, eresources-mail]. Здесь также подходит указанный выше критерий, и в ваших интересах следовать ему, потому что именно так можно получить результат.
== Перед посылкой вопроса
Вы можете (и должны) что-нибудь сделать сами перед тем, как задать вопрос в одном из списков рассылки:
* Попытайтесь решить проблему самостоятельно. Если вы пошлёте вопрос, который покажет, что вы пытались решить проблему, ваш вопрос, как правило, привлечёт более положительное внимание со стороны людей, читающих его. Попытка решить проблему самостоятельно также увеличит уровень вашего понимания FreeBSD, и в конечном счёте позволит вам использовать ваши знания для помощи другим, отвечая на вопросы, посылаемые в списки рассылки.
-* Прочтите страницы справочника и документацию FreeBSD (установлена в [.filename]#/usr/doc# или доступна через WWW на http://www.FreeBSD.org[http://www.FreeBSD.org]), особенно link:{handbook}[Руководство пользователя] и link:{faq}[FAQ].
+* Прочтите страницы справочника и документацию FreeBSD (установлена в [.filename]#/usr/doc# или доступна через WWW на http://www.FreeBSD.org[http://www.FreeBSD.org]), особенно extref:{handbook}[Руководство пользователя] и extref:{faq}[FAQ].
* Просмотрите и/или поищите в архивах списка рассылки, задавился ли ваш или схожий вопрос (и возможно отвечался) в списке. Вы можете просмотреть и/или поискать в архивах списков рассылки на http://www.FreeBSD.org/mail[http://www.FreeBSD.org/mail] и http://www.FreeBSD.org/search/#mailinglists[http://www.FreeBSD.org/search#mailinglists] соответственно. Это может быть сделано также и на других WWW сайтах, к примеру, на http://marc.theaimsgroup.com[http://marc.theaimsgroup.com].
* Используйте поисковик, например, http://www.google.com[Google] или http://www.yahoo.com[Yahoo] для поиска ответов на ваш вопрос. Google имеет даже http://www.google.com/bsd[BSD ориентированный поисковой интерфейс].
diff --git a/documentation/content/ru/articles/geom-class/_index.adoc b/documentation/content/ru/articles/geom-class/_index.adoc
index 38cb551ccd..9ec0e0c6e2 100644
--- a/documentation/content/ru/articles/geom-class/_index.adoc
+++ b/documentation/content/ru/articles/geom-class/_index.adoc
@@ -3,7 +3,6 @@ title: Создание класса GEOM
authors:
- author: Ivan Voras
email: ivoras@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "intel", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "intel", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-
-ifeval::["{backend}" == "html5"]
-include::shared/ru/urls.adoc[]
+:images-path: articles/geom-class/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/ru/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -53,8 +54,8 @@ toc::[]
Документация по программированию для ядра скудная, это одна из немногих областей программирования, где почти нет хороших учебных пособий, и совет "читай исходники!" - сохраняет свою справедливость. Однако, существует несколько статей и книг разной актуальности, которые рекомендуются к изучению перед тем, как начать программировать:
-* link:{developers-handbook}[Руководство FreeBSD для разработчиков] - часть Проекта Документации FreeBSD, ничего специфичного о программировании ядра в нем нет, зато есть немного общей полезной информации.
-* link:{arch-handbook}[Руководство по Архитектуре FreeBSD] - также является частью Проекта Документации FreeBSD, содержит описания некоторых низкоуровневых средств и процедур. Уделите внимание разделу номер 13 - link:{arch-handbook}#driverbasics[Написание драйверов устройств для FreeBSD].
+* extref:{developers-handbook}[Руководство FreeBSD для разработчиков] - часть Проекта Документации FreeBSD, ничего специфичного о программировании ядра в нем нет, зато есть немного общей полезной информации.
+* extref:{arch-handbook}[Руководство по Архитектуре FreeBSD] - также является частью Проекта Документации FreeBSD, содержит описания некоторых низкоуровневых средств и процедур. Уделите внимание разделу номер 13 - extref:{arch-handbook}[Написание драйверов устройств для FreeBSD, driverbasics].
* Несколько интересных статей об устройстве ядра можно найти на сайте http://www.freebsddiary.com[FreeBSD Diary].
* Страницы из раздела номер 9 системного справочника, содержат важную документацию по функциям ядра.
* Страница справочника man:geom[4], а также http://phk.freebsd.dk/pubs/[слайды Пола-Хеннинга Кампа ] - общее представление о подсистеме GEOM.
diff --git a/documentation/content/ru/articles/gjournal-desktop/_index.adoc b/documentation/content/ru/articles/gjournal-desktop/_index.adoc
index 521fa7c8e0..d58842adc3 100644
--- a/documentation/content/ru/articles/gjournal-desktop/_index.adoc
+++ b/documentation/content/ru/articles/gjournal-desktop/_index.adoc
@@ -3,7 +3,6 @@ title: Настройка журналирования UFS для настоль
authors:
- author: Manolis Kiagias
email: manolis@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -16,34 +15,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
+:images-path: articles/gjournal-desktop/
-
-ifeval::["{backend}" == "html3"]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/ru/mailing-lists.adoc[lines=9..-1]
-include::shared/ru/urls.adoc[]
-:imagesdir: ../../../images/articles/gjournal-desktop/
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[lines=9..-1]
-include::../../../../shared/ru/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[lines=9..-1]
-include::../../../../shared/ru/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/gjournal-desktop/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -317,7 +308,7 @@ options UFS_GJOURNAL # Прим.: Это включено в GENERIC
options GEOM_JOURNAL # А эту строку необходимо добавить
....
-Соберите и установите новое ядро следуя указаниям link:{handbook}#kernelconfig[Руководства FreeBSD.]
+Соберите и установите новое ядро следуя указаниям extref:{handbook}kernelconfig[Руководства FreeBSD., kernelconfig]
И не забудьте удалить соответствующую строку загрузки модуля ("load") из [.filename]#/boot/loader.conf# (если на предыдущем этапе она была туда внесена).
@@ -438,7 +429,7 @@ tunefs: soft updates set
Журналирование - относительно новая функциональная возможность FreeBSD, и как такова, она еще недостаточно документирована. Однако, вы можете сочти полезными следующие источники:
-* Новый link:{handbook}#geom-gjournal[раздел Руководства FreeBSD], посвященный журналированию.
+* Новый extref:{handbook}geom[раздел Руководства FreeBSD, geom-gjournal], посвященный журналированию.
* http://lists.freebsd.org/pipermail/freebsd-current/2006-June/064043.html[Этот пост] в списке рассылки {freebsd-current}, написанный `{pjd}` - автором man:gjournal[8].
* http://lists.freebsd.org/pipermail/freebsd-questions/2008-April/173501.html[Этот пост] от `{ivoras}` в списке рассылки {freebsd-questions}.
* Страницы справочника man:gjournal[8] и man:geom[8].
diff --git a/documentation/content/ru/articles/hubs/_index.adoc b/documentation/content/ru/articles/hubs/_index.adoc
index c4b0b25c04..ecd63f2649 100644
--- a/documentation/content/ru/articles/hubs/_index.adoc
+++ b/documentation/content/ru/articles/hubs/_index.adoc
@@ -10,7 +10,6 @@ authors:
- author: Ken Smith
email: kensmith@FreeBSD.org
- author: Дмитрий Морозовский
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -23,30 +22,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-
-ifeval::["{backend}" == "html5"]
-include::shared/ru/mailing-lists.adoc[lines=9..-1]
-include::shared/ru/urls.adoc[]
+:images-path: articles/hubs/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/ru/mailing-lists.adoc[lines=9..-1]
-include::../../../../shared/ru/urls.adoc[]
-include::../../../../shared/releases.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/ru/mailing-lists.adoc[lines=9..-1]
-include::../../../../shared/ru/urls.adoc[]
-include::../../../../shared/releases.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -266,7 +261,7 @@ rsync часто используется для предоставления д
* предоставлять доступ для других зеркал
* обеспечивать доступ по протоколам ftp и rsync.
-Кроме того, администратор такого зеркала должен быть подписан на {freebsd-hubs}. См. link:{handbook}#eresources-mail[здесь] для дополнительной информации о подписке.
+Кроме того, администратор такого зеркала должен быть подписан на {freebsd-hubs}. См. extref:{handbook}eresources[здесь, eresources-mail] для дополнительной информации о подписке.
[IMPORTANT]
====
diff --git a/documentation/content/ru/articles/ipsec-must/_index.adoc b/documentation/content/ru/articles/ipsec-must/_index.adoc
index 450de8c6d5..8ef1f8d028 100644
--- a/documentation/content/ru/articles/ipsec-must/_index.adoc
+++ b/documentation/content/ru/articles/ipsec-must/_index.adoc
@@ -3,7 +3,6 @@ title: Независимое исследование работы IPsec во F
authors:
- author: David Honig
email: honig@sprynet.com
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "opengroup", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "opengroup", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-
-ifeval::["{backend}" == "html5"]
-include::shared/ru/urls.adoc[]
+:images-path: articles/ipsec-must/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/ru/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -122,7 +123,7 @@ IPsec представляет собой протокол безопасног
Большинство современных версий FreeBSD уже имеют поддержку IPsec. Вероятно, Вы должны будете лишь добавить опцию `IPSEC` в конфигурационный файл ядра, и после сборки и инсталляции нового ядра, сконфигурировать соединение IPsec с помощью команды man:setkey[8].
-Более подробно о том, как запустить IPsec во FreeBSD можно прочесть в link:{handbook}#ipsec[Руководстве пользователя].
+Более подробно о том, как запустить IPsec во FreeBSD можно прочесть в extref:{handbook}security[Руководстве пользователя, ipsec].
[[kernel]]
== src/sys/i386/conf/KERNELNAME
diff --git a/documentation/content/ru/articles/mailing-list-faq/_index.adoc b/documentation/content/ru/articles/mailing-list-faq/_index.adoc
index 59dd9ed70a..b44a7afc06 100644
--- a/documentation/content/ru/articles/mailing-list-faq/_index.adoc
+++ b/documentation/content/ru/articles/mailing-list-faq/_index.adoc
@@ -3,7 +3,6 @@ title: Часто задаваемые вопросы по спискам рас
authors:
- author: The FreeBSD Documentation Project
copyright: 2004-2005 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
---
= Часто задаваемые вопросы по спискам рассылки FreeBSD
@@ -15,30 +14,26 @@ releaseinfo: "$FreeBSD$"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-
-ifeval::["{backend}" == "html5"]
+:images-path: articles/mailing-list-faq/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/ru/mailing-lists.adoc[lines=9..-1]
-include::shared/ru/urls.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[lines=9..-1]
-include::../../../../shared/ru/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[lines=9..-1]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -98,7 +93,7 @@ toc::[]
=== Что я должен сделать перед отправлением письма?
-Вы уже сделали важный шаг, решив прочитать эту статью. Если вы новичок во FreeBSD, то сначала ознакомьтесь с программным обеспечением и связанной с нею документацией, включающей множество link:https://www.FreeBSD.org/docs/[книг и статьей]. Могут быть интересными: link:{faq}[Часто задаваемые вопросы по FreeBSD (FAQ)], link:{handbook}[Руководство по FreeBSD], и статьи link:{freebsd-questions-article}[Как работать со списком рассылки FreeBSD-questions с максимальной отдачей], link:{explaining-bsd}[Что такое BSD], и link:{new-users}[Пособие для новичков во FreeBSD].
+Вы уже сделали важный шаг, решив прочитать эту статью. Если вы новичок во FreeBSD, то сначала ознакомьтесь с программным обеспечением и связанной с нею документацией, включающей множество extref:https://www.FreeBSD.org/docs/[книг и статьей]. Могут быть интересными: extref:{faq}[Часто задаваемые вопросы по FreeBSD (FAQ)], extref:{handbook}[Руководство по FreeBSD], и статьи extref:{freebsd-questions-article}[Как работать со списком рассылки FreeBSD-questions с максимальной отдачей], extref:{explaining-bsd}[Что такое BSD], и extref:{new-users}[Пособие для новичков во FreeBSD].
Вы можете получить нелицеприятные высказывания в свой адрес, если зададите вопрос, ответ на который есть в приведённой выше документации. Это не потому что добровольцы, работающие над данным проектом очень плохие люди, а после многократного ответа на одни и те же вопросы - раздражение берёт своё. Это особенно справедливо, если уже существует и доступен ответ на вопрос. Не забывайте, что вся работа по улучшению FreeBSD выполняется добровольцами, и что мы только люди.
@@ -163,7 +158,7 @@ toc::[]
[[bikeshed]]
== Что такое велосипедный навес ("Bikeshed")?
-В литературной нотации, `велосипедный навес` - это маленький внешний кожух, в который можно поместить один вид двухколёсного транспорта. Тем не менее, на языке FreeBSD, этот термин ("bikeshed") относится к темам, которые достаточно просты, и на которые (почти) каждый может предложить собственное мнение, и часто (почти) каждый его и предлагает. Детали происхождения данного термина более подробно рассмотрены link:{faq}#BIKESHED-PAINTING[здесь]. У вас должно иметься представление о данном понятии перед отправкой письма в любой список рассылки FreeBSD.
+В литературной нотации, `велосипедный навес` - это маленький внешний кожух, в который можно поместить один вид двухколёсного транспорта. Тем не менее, на языке FreeBSD, этот термин ("bikeshed") относится к темам, которые достаточно просты, и на которые (почти) каждый может предложить собственное мнение, и часто (почти) каждый его и предлагает. Детали происхождения данного термина более подробно рассмотрены extref:{faq}[здесь, BIKESHED-PAINTING]. У вас должно иметься представление о данном понятии перед отправкой письма в любой список рассылки FreeBSD.
Bikeshed - это тема разговора, которая будет иметь тенденцию порождать немедленные мета-дискуссии и флэйм.
@@ -173,7 +168,7 @@ Bikeshed - это тема разговора, которая будет име
== Благодарности
`{grog}`::
-Первоначальный автор большинства материала по этикету списков рассылки, взятого из статьи link:{freebsd-questions-article}[Как работать со списком рассылки FreeBSD-questions с максимальной отдачей].
+Первоначальный автор большинства материала по этикету списков рассылки, взятого из статьи extref:{freebsd-questions-article}[Как работать со списком рассылки FreeBSD-questions с максимальной отдачей].
`{linimon}`::
Создание черновой версии данного FAQ.
diff --git a/documentation/content/ru/articles/new-users/_index.adoc b/documentation/content/ru/articles/new-users/_index.adoc
index 99f6cd4977..541ef8470c 100644
--- a/documentation/content/ru/articles/new-users/_index.adoc
+++ b/documentation/content/ru/articles/new-users/_index.adoc
@@ -3,7 +3,6 @@ title: Пособие для новичков во FreeBSD и UNIX®
authors:
- author: Annelise Anderson
email: andrsn@andrsn.stanford.edu
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"]
---
@@ -16,13 +15,27 @@ trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
+:images-path: articles/new-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Аннотация
diff --git a/documentation/content/ru/articles/pam/_index.adoc b/documentation/content/ru/articles/pam/_index.adoc
index 5faf16ed03..6735323179 100644
--- a/documentation/content/ru/articles/pam/_index.adoc
+++ b/documentation/content/ru/articles/pam/_index.adoc
@@ -2,44 +2,9 @@
title: Подключаемые Модули Аутентификации (PAM)
authors:
- author: Dag-Erling Smørgrav
-releaseinfo: "$FreeBSD$"
trademarks: ["pam", "freebsd", "linux", "opengroup", "sun", "general"]
---
-////
-Copyright (c) 2001-2003 Networks Associates Technology, Inc.
-All rights reserved.
-
-This software was developed for the FreeBSD Project by ThinkSec AS and
-Network Associates Laboratories, the Security Research Division of
-Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035
-("CBOSS"), as part of the DARPA CHATS research program.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions
-are met:
-1. Redistributions of source code must retain the above copyright
- notice, this list of conditions and the following disclaimer.
-2. Redistributions in binary form must reproduce the above copyright
- notice, this list of conditions and the following disclaimer in the
- documentation and/or other materials provided with the distribution.
-3. The name of the author may not be used to endorse or promote
- products derived from this software without specific prior written
- permission.
-
-THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
-ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
-OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-SUCH DAMAGE.
-////
-
= Подключаемые Модули Аутентификации (PAM)
:doctype: article
:toc: macro
@@ -49,24 +14,29 @@ SUCH DAMAGE.
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-
-ifeval::["{backend}" == "html5"]
-:sourcesdir: static/source/articles/pam
+:images-path: articles/pam/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+:include-path: static/source/articles/pam/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:include-path: ../../../../static/source/articles/pam/
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:sourcesdir: ../../../../static/source/articles/pam
endif::[]
-ifeval::["{backend}" == "epub3"]
-:sourcesdir: ../../../../static/source/articles/pam
+ifndef::env-beastie[]
+:include-path: ../../../../static/source/articles/pam/
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -561,7 +531,7 @@ auth required pam_nologin.so no_warn
[.programlisting]
....
-include::{sourcesdir}/su.c[]
+include::{include-path}su.c[]
....
:sectnums!:
@@ -574,7 +544,7 @@ include::{sourcesdir}/su.c[]
[.programlisting]
....
-include::{sourcesdir}/pam_unix.c[]
+include::{include-path}pam_unix.c[]
....
:sectnums!:
@@ -587,7 +557,7 @@ include::{sourcesdir}/pam_unix.c[]
[.programlisting]
....
-include::{sourcesdir}/converse.c[]
+include::{include-path}converse.c[]
....
:sectnums!:
diff --git a/documentation/content/ru/articles/pr-guidelines/_index.adoc b/documentation/content/ru/articles/pr-guidelines/_index.adoc
index b2bc4aeb6a..4ee096306b 100644
--- a/documentation/content/ru/articles/pr-guidelines/_index.adoc
+++ b/documentation/content/ru/articles/pr-guidelines/_index.adoc
@@ -3,7 +3,6 @@ title: Рекомендации по работе с сообщениями о
authors:
- author: Dag-Erling Smørgrav
- author: Hiten Pandya
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "opengroup", "general"]
---
@@ -16,27 +15,26 @@ trademarks: ["freebsd", "opengroup", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-
-ifeval::["{backend}" == "html5"]
-include::shared/ru/mailing-lists.adoc[lines=9..-1]
-include::shared/ru/urls.adoc[]
+:images-path: articles/pr-guidelines/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/ru/mailing-lists.adoc[lines=9..-1]
-include::../../../../shared/ru/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/ru/mailing-lists.adoc[lines=9..-1]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -582,4 +580,4 @@ This was misfiled because the subject did not have the format:
Это перечень ресурсов, относящихся к качественному написанию и обработке сообщений об ошибках. Несомненно, этот список не является полным.
-* link:{problem-reports}[Как писать Сообщения об ошибках FreeBSD]-руководство для авторов PR.
+* extref:{problem-reports}[Как писать Сообщения об ошибках FreeBSD]-руководство для авторов PR.
diff --git a/documentation/content/ru/articles/problem-reports/_index.adoc b/documentation/content/ru/articles/problem-reports/_index.adoc
index 6c911bc0b3..307dc95049 100644
--- a/documentation/content/ru/articles/problem-reports/_index.adoc
+++ b/documentation/content/ru/articles/problem-reports/_index.adoc
@@ -3,7 +3,6 @@ title: Составление сообщений о проблеме во FreeBS
authors:
- author: Dag-Erling Smørgrav
- author: Mark Linimon
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "intel", "sparc", "sun", "general"]
---
@@ -16,30 +15,26 @@ trademarks: ["freebsd", "ibm", "intel", "sparc", "sun", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-
-ifeval::["{backend}" == "html5"]
-include::shared/ru/teams.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/urls.adoc[]
+:images-path: articles/problem-reports/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -77,7 +72,7 @@ toc::[]
+
Если порт поддерживается, PR-ы, указывающие о появлении новых улучшенных (upstream) релизов обычно не очень полезны, так как они прибавляют много вспомогательной работы для коммиттеров, а мэйнтейнер наверняка уже знает о новой версии. Они уже наверняка работали с разработчиками над ней или они возможно тестируют её, чтобы убедиться в отсутствии регрессии и т.п.
+
-В любом случае, следование процессу, описанному в link:{porters-handbook}#port-upgrading[Руководстве по созданию портов] даст наилучшие результаты. (Также можно ознакомиться с статьей link:{contributing-ports}[Контрибуция в коллекцию портов FreeBSD].)
+В любом случае, следование процессу, описанному в extref:{porters-handbook}[Руководстве по созданию портов, port-upgrading] даст наилучшие результаты. (Также можно ознакомиться с статьей link:{contributing-ports}[Контрибуция в коллекцию портов FreeBSD].)
Ошибка, которую нельзя воспроизвести, вряд ли будет исправлена. Если ошибка возникла только единожды, и вы не можете ее воспроизвести, к тому же никто с ней больше не сталкивался, нет никаких шансов, что разработчики смогут ее воспроизвести или понять, что делается неправильно. Это не значит, что такого не случается, но это значит, что шансов у вашего сообщения дойти когда-либо до стадии исправления ошибки очень малы. Часто эти виды ошибок возникают из-за неудовлетворительной работы жёстких дисков, перегревшихся процессоров. Всегда, когда это возможно вы должны отслеживать такие случаи перед посылкой сообщения об ошибке.
@@ -89,7 +84,7 @@ toc::[]
Затем вы должны убедиться, действительно ли проблема существует. Существует всего несколько вещей, которые раздражают разработчика больше, чем получение сообщения об ошибке, которую он уже исправил.
-Если проблема в базовой системе, то вам нужно сначала прочесть раздел link:{faq}#LATEST-VERSION[версии FreeBSD] из FAQ, если вы ещё не знакомы с данной темой. Для FreeBSD возможно исправлять проблемы только для некоторых недавних веток базовой системы, поэтому отправка сообщения об ошибке для более старой версии приведёт к тому, что разработчик посоветует вам обновиться до поддерживаемой версии, чтобы посмотреть присутствует ли в ней проблема. Команда офицеров безопасности поддерживает link:https://www.FreeBSD.org/security/[список поддерживаемых версий.].
+Если проблема в базовой системе, то вам нужно сначала прочесть раздел extref:{faq}[версии FreeBSD, LATEST-VERSION] из FAQ, если вы ещё не знакомы с данной темой. Для FreeBSD возможно исправлять проблемы только для некоторых недавних веток базовой системы, поэтому отправка сообщения об ошибке для более старой версии приведёт к тому, что разработчик посоветует вам обновиться до поддерживаемой версии, чтобы посмотреть присутствует ли в ней проблема. Команда офицеров безопасности поддерживает link:https://www.FreeBSD.org/security/[список поддерживаемых версий.].
Если проблема связана с портами, помните, что вы сначала должны обновиться до самой последней версии Коллекции Портов и проверить, существует ли в ней проблема. Из-за быстрых внесений изменений в эти приложения, неосуществимым для FreeBSD является поддержка чего-либо, кроме самых последних версий, и проблемы со устаревшими версиями приложений просто не могут быть исправлены.
@@ -98,8 +93,8 @@ toc::[]
Нужно следовать хорошему правилу всегда сначала выполнять дополнительные исследования перед тем, как послать сообщение о проблеме. Может быть, о вашей проблеме уже сообщено; может быть, она недавно обсуждалась или обсуждается в списках рассылки; она может быть уже исправлена в более новой версии, чем та, что вы используете. Поэтому вы должны проверить все обычные места до того, как послать ваше сообщение о проблеме. Для FreeBSD это значит:
-* FreeBSD link:{faq}[FAQ] (Ответы на часто задаваемые вопросы). FAQ содержит ответы на вопросы из самых разных категорий, в частности, link:{faq}#hardware[аппаратной совместимости], link:{faq}#applications[пользовательских программ] и link:{faq}#kernelconfig[конфигурации ядра].
-* link:{handbook}[Списки рассылки]-если Вы не подписаны на них, воспользуйтесь http://www.FreeBSD.org/search/#mailinglists[поиском в архивах] на сайте FreeBSD. Если ваша проблема не обсуждалась в списках рассылки, вы можете попытаться опубликовать сообщение о ней и подождать несколько дней, пока кто-нибудь не сможет увидеть то, что вы не заметили.
+* FreeBSD extref:{faq}[FAQ] (Ответы на часто задаваемые вопросы). FAQ содержит ответы на вопросы из самых разных категорий, в частности, extref:{faq}[аппаратной совместимости, hardware], extref:{faq}[пользовательских программ, applications] и extref:{faq}[конфигурации ядра, kernelconfig].
+* extref:{handbook}[Списки рассылки]-если Вы не подписаны на них, воспользуйтесь http://www.FreeBSD.org/search/#mailinglists[поиском в архивах] на сайте FreeBSD. Если ваша проблема не обсуждалась в списках рассылки, вы можете попытаться опубликовать сообщение о ней и подождать несколько дней, пока кто-нибудь не сможет увидеть то, что вы не заметили.
* Как вариант, весь веб-используйте вашу любимую поисковую систему для поиска каких-либо ссылок по вашей проблеме. Вы можете даже увидеть ссылки на архивы списков рассылки или телеконференций, о которых вы не знали или не думали там искать.
* Следующим пунктом должна быть http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[ база данных PR FreeBSD] (GNATS). Если только ваша проблема не нова или редка, есть некоторый шанс, что о ней уже сообщено.
* И самое важное, вы должны посмотреть не затрагивает ли документация в базовой системе вашу проблему.
@@ -150,7 +145,7 @@ toc::[]
Если вы используйте утилиту man:send-pr[1] проверьте, что переменная вашего окружения `VISUAL` (или `EDITOR`, если `VISUAL` не задана) задана подходящим образом.
-Следует также проверить работоспособность системы электронной почты. Утилита man:send-pr[1] использует почтовую систему для отправки и отслеживания сообщения о проблеме. Если с машины, на которой вы запускаете man:send-pr[1], нельзя отправить почту, сообщение не попадёт в базу данных GNATS. О настройке электронной почты во FreeBSD можно прочитать в главе "Электронная почта" Руководства по FreeBSD по адресу link:{handbook}#mail[Electronic Mail].
+Следует также проверить работоспособность системы электронной почты. Утилита man:send-pr[1] использует почтовую систему для отправки и отслеживания сообщения о проблеме. Если с машины, на которой вы запускаете man:send-pr[1], нельзя отправить почту, сообщение не попадёт в базу данных GNATS. О настройке электронной почты во FreeBSD можно прочитать в главе "Электронная почта" Руководства по FreeBSD по адресу extref:{handbook}mail[Electronic Mail, mail].
Убедитесь, что ваш почтовый клиент не исказит сообщение по пути в GNATS. В частности, если ваш почтовый клиент автоматически переносит строки, изменяет символы табуляции на пробелы или предотвращает интерпретацию символов новой строки, любой патч, который вы пришлёте окажется непригодным. Для текста мы хотели бы, чтобы вы делали строчки размером примерно в 70 символов для читабельности PR на веб странице.
@@ -378,4 +373,4 @@ Subject: Re: ports/12345: compilation problem with foo/bar
Это список информационных ресурсов, относящихся к правильному написанию и обработке сообщений о проблемах. Он, без сомнения, не полон.
* http://www.chiark.greenend.org.uk/~sgtatham/bugs.html[How to Report Bugs Effectively]-прекрасное эссе, которое написал Simon G. Tatham о составлении полезных (не специфичных для FreeBSD) сообщений о проблемах.
-* link:{pr-guidelines}[Problem Report Handling Guidelines]-интересный взгляд на обработку сообщений о проблемах самими разработчиками FreeBSD.
+* extref:{pr-guidelines}[Problem Report Handling Guidelines]-интересный взгляд на обработку сообщений о проблемах самими разработчиками FreeBSD.
diff --git a/documentation/content/ru/articles/releng/_index.adoc b/documentation/content/ru/articles/releng/_index.adoc
index c7c58fdd8e..5b539f65dc 100644
--- a/documentation/content/ru/articles/releng/_index.adoc
+++ b/documentation/content/ru/articles/releng/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Murray Stokely
email: murray@FreeBSD.org
webpage: https://people.FreeBSD.org/~murray/
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "cvsup", "intel", "general"]
---
@@ -17,40 +16,26 @@ trademarks: ["freebsd", "cvsup", "intel", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:xrefstyle: full
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-
-ifeval::["{backend}" == "html5"]
+:images-path: articles/releng/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/urls.adoc[]
-:imagesdir: ../../../images/articles/releng/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/releng/
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/urls.adoc[]
-:imagesdir: ../../../../static/images/articles/releng/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -240,7 +225,7 @@ image::branches-releng9.png[Ветка FreeBSD 9.x STABLE]
* `CVSROOT` - Местонахождение CVS-хранилища.
* `RELEASETAG` - Тэг CVS, соответствующий релизу, который вы собираетесь строить.
-Если у вас ещё нет доступа к локальному CVS-хранилищу, то вы можете зеркалировать одно из них при помощи link:{handbook}#CVSUP[CVSup]. Поставляемый sup-файл, [.filename]#/usr/shared/examples/cvsup/cvs-supfile#, может служить хорошей отправной точкой для зеркалирования хранилища CVS.
+Если у вас ещё нет доступа к локальному CVS-хранилищу, то вы можете зеркалировать одно из них при помощи extref:{handbook}[CVSup, svn]. Поставляемый sup-файл, [.filename]#/usr/shared/examples/cvsup/cvs-supfile#, может служить хорошей отправной точкой для зеркалирования хранилища CVS.
Если `RELEASETAG` опущен, то релиз будет строиться из ветки `HEAD` (известной как -CURRENT). Релизы, строящиеся из этой ветки обычно называют "снэпшотами -CURRENT".
@@ -337,7 +322,7 @@ Sysinstall поддерживает установку пакетов с нес
[.filename]#/pub/FreeBSD/releases/arch/ISO-IMAGES/X.Y/X.Y-RELEASE-arch-*.iso#::
ISO-образы. Здесь "*" это [.filename]#disc1#, [.filename]#disc2# и так далее. Только если здесь есть [.filename]#disc1# и альтернативный первый установочный CD (например, обрезанная установка без оконной системы), то здесь может быть также и [.filename]#mini#.
-Для получения дополнительной информации о системе зеркальных FTP-серверов FreeBSD, пожалуйста, прочтите статью о link:{hubs}[Зеркалировании FreeBSD].
+Для получения дополнительной информации о системе зеркальных FTP-серверов FreeBSD, пожалуйста, прочтите статью о extref:{hubs}[Зеркалировании FreeBSD].
Может пройти от нескольких часов до двух дней между тем, как обновится `ftp-master`, и на основной массе FTP-серверов 1-го уровня появится новое программное обеспечение, в зависимости от того, в тоже самое ли время пакет был загружен. Обязательно, чтобы выпускающие релиз координировали свои действия с {mirror-announce} до того, как объявлять об общедоступности нового программного обеспечения с серверов FTP. В идеальном случае набор пакетов к релизу должен быть загружен по крайней мере за четыре дня до момента выпуска релиза. Релиз должен быть загружен в промежутке от 24 до 48 часов до момента выхода запланированного релиза с выключенными полномочиями "other". Это позволит зеркалирующим серверам сгрузить его, но никто не сможет получить его с зеркальных серверов. В момент выхода релиза должно быть послано сообщение в адрес {mirror-announce}, говорящее о том, что релиз выпущен и наступило время для открытия доступа на зеркальных серверах. Обязательно вместе со временем укажите и часовой пояс, например, относительно GMT.
@@ -403,11 +388,11 @@ ISO-образы. Здесь "*" это [.filename]#disc1#, [.filename]#disc2#
(4) Коллекция портов FreeBSD http://www.FreeBSD.org/ports[http://www.FreeBSD.org/ports]
-(5) link:{contributors}#staff-committers[Коммиттеры FreeBSD]
+(5) extref:{contributors}[Коммиттеры FreeBSD, staff-committers]
(6) Правление FreeBSD link:https://www.FreeBSD.org/administration/#t-core[https://www.FreeBSD.org/administration/#t-core]
-(7) link:{handbook}[Руководство FreeBSD]
+(7) extref:{handbook}[Руководство FreeBSD]
(8) GNATS: The GNU Bug Tracking System http://www.gnu.org/software/gnats[http://www.gnu.org/software/gnats]
diff --git a/documentation/content/ru/articles/solid-state/_index.adoc b/documentation/content/ru/articles/solid-state/_index.adoc
index b581f24f16..6c95b718bc 100644
--- a/documentation/content/ru/articles/solid-state/_index.adoc
+++ b/documentation/content/ru/articles/solid-state/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: John Kozubik
email: john@kozubik.com
copyright: 2001, 2009 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -17,13 +16,27 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
+:images-path: articles/solid-state/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Аннотация
diff --git a/documentation/content/ru/articles/vm-design/_index.adoc b/documentation/content/ru/articles/vm-design/_index.adoc
index 43b616c077..99af966d20 100644
--- a/documentation/content/ru/articles/vm-design/_index.adoc
+++ b/documentation/content/ru/articles/vm-design/_index.adoc
@@ -3,7 +3,6 @@ title: Элементы архитектуры системы виртуальн
authors:
- author: Matthew Dillon
email: dillon@apollo.backplane.com
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "linux", "microsoft", "opengroup", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "linux", "microsoft", "opengroup", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/articles/vm-design/
+:images-path: articles/vm-design/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/articles/vm-design/
endif::[]
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/articles/vm-design/
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
diff --git a/documentation/content/ru/books/arch-handbook/book.adoc b/documentation/content/ru/books/arch-handbook/book.adoc
index 863d9aa451..02fb3a4420 100644
--- a/documentation/content/ru/books/arch-handbook/book.adoc
+++ b/documentation/content/ru/books/arch-handbook/book.adoc
@@ -13,48 +13,35 @@ tags: ["Arch Handbook", "FreeBSD"]
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
-:chapter-signifier: Chapter
-:part-signifier: Part
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
:book: true
:pdf: false
+:images-path: books/arch-handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
-:chapters-path: content/ru/books/arch-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/arch-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -63,10 +50,9 @@ toc::[]
// Section one
-include::{chapters-path}locking/chapter.adoc[]
+include::{chapters-path}locking/chapter.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}driverbasics/chapter.adoc[]
-include::{chapters-path}sound/chapter.adoc[]
-
+include::{chapters-path}driverbasics/chapter.adoc[leveloffset=+1]
+include::{chapters-path}sound/chapter.adoc[leveloffset=+1]
diff --git a/documentation/content/ru/books/arch-handbook/driverbasics/chapter.adoc b/documentation/content/ru/books/arch-handbook/driverbasics/chapter.adoc
index 5a94438d17..d845e849be 100644
--- a/documentation/content/ru/books/arch-handbook/driverbasics/chapter.adoc
+++ b/documentation/content/ru/books/arch-handbook/driverbasics/chapter.adoc
@@ -10,16 +10,35 @@ authors:
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Эту главу написал {murray} на основе множества источников, включая справочную страницу intro(4), которую создал {joerg}.
diff --git a/documentation/content/ru/books/arch-handbook/locking/chapter.adoc b/documentation/content/ru/books/arch-handbook/locking/chapter.adoc
index be6faecad7..bdb37f8e29 100644
--- a/documentation/content/ru/books/arch-handbook/locking/chapter.adoc
+++ b/documentation/content/ru/books/arch-handbook/locking/chapter.adoc
@@ -10,16 +10,35 @@ authors:
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
_Эта глава поддерживается проектом FreeBSD SMP Next Generation Project. Комментарии и пожелания направляйте в link:{freebsd-smp}._
diff --git a/documentation/content/ru/books/arch-handbook/sound/chapter.adoc b/documentation/content/ru/books/arch-handbook/sound/chapter.adoc
index bce3a61d3e..4bb8b82ea9 100644
--- a/documentation/content/ru/books/arch-handbook/sound/chapter.adoc
+++ b/documentation/content/ru/books/arch-handbook/sound/chapter.adoc
@@ -10,16 +10,35 @@ authors:
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[oss-intro]]
== Введение
diff --git a/documentation/content/ru/books/design-44bsd/_index.adoc b/documentation/content/ru/books/design-44bsd/_index.adoc
index f7d41c42de..34459e978b 100644
--- a/documentation/content/ru/books/design-44bsd/_index.adoc
+++ b/documentation/content/ru/books/design-44bsd/_index.adoc
@@ -6,8 +6,8 @@ authors:
- author: Michael J. Karels
- author: John S. Quarterman
copyright: 1996 Addison-Wesley Longman, Inc
-releaseinfo: "$FreeBSD$"
-trademarks: ["design-44bsd"]
+trademarks: ["design-44bsd"]
+isIndex: true
---
= Архитектура и реализация операционной системы 4.4BSD
@@ -15,52 +15,35 @@ trademarks: ["design-44bsd"]
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
+:sectnumoffset: 2
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:sectnumoffset: 2
+:images-path: books/design-44bsd/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../images/{images-path}
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
-:imagesdir: ../../../../images/books/design-44bsd/
-:chapters-path: content/ru/books/design-44bsd/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/design-44bsd/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
-:imagesdir: ../../../../static/images/books/design-44bsd/
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
-:imagesdir: ../../../../static/images/books/design-44bsd/
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
diff --git a/documentation/content/ru/books/developers-handbook/_index.adoc b/documentation/content/ru/books/developers-handbook/_index.adoc
index 3071e05dfa..98a3fbc883 100644
--- a/documentation/content/ru/books/developers-handbook/_index.adoc
+++ b/documentation/content/ru/books/developers-handbook/_index.adoc
@@ -3,8 +3,8 @@ title: Руководство FreeBSD для разработчиков
authors:
- author: The FreeBSD Documentation Project
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
+trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
+isIndex: true
---
= Руководство FreeBSD для разработчиков
@@ -12,51 +12,35 @@ trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
+:book: true
+:pdf: false
+:images-path: books/developers-handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
-:imagesdir: ../../images/books/developers-handbook/
-:chapters-path: content/ru/books/developers-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
-:imagesdir: ../../../static/images/books/developers-handbook/
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
-:imagesdir: ../../../static/images/books/developers-handbook/
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
diff --git a/documentation/content/ru/books/developers-handbook/introduction/chapter.adoc b/documentation/content/ru/books/developers-handbook/introduction/chapter.adoc
index ca3d0c852c..c9cab95af5 100644
--- a/documentation/content/ru/books/developers-handbook/introduction/chapter.adoc
+++ b/documentation/content/ru/books/developers-handbook/introduction/chapter.adoc
@@ -12,16 +12,36 @@ authors:
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/developers-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-devel]]
== Разработка во FreeBSD
diff --git a/documentation/content/ru/books/developers-handbook/kerneldebug/chapter.adoc b/documentation/content/ru/books/developers-handbook/kerneldebug/chapter.adoc
index 88e5a643c5..6e116cfec2 100644
--- a/documentation/content/ru/books/developers-handbook/kerneldebug/chapter.adoc
+++ b/documentation/content/ru/books/developers-handbook/kerneldebug/chapter.adoc
@@ -13,16 +13,36 @@ authors:
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/developers-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kerneldebug-obtain]]
== Получение аварийного дампа ядра
@@ -358,7 +378,7 @@ makeoptions DEBUG=-g #Build kernel with gdb(1) debug symbols
options DDB
....
-в ваш конфигурационный файл, и перестройте ядро. (Обратитесь к link:{handbook}[Руководству по FreeBSD] для выяснения подробностей о конфигурации ядра FreeBSD).
+в ваш конфигурационный файл, и перестройте ядро. (Обратитесь к extref:{handbook}[Руководству по FreeBSD] для выяснения подробностей о конфигурации ядра FreeBSD).
[NOTE]
====
diff --git a/documentation/content/ru/books/developers-handbook/policies/chapter.adoc b/documentation/content/ru/books/developers-handbook/policies/chapter.adoc
index cf2c5c3594..970a4b9921 100644
--- a/documentation/content/ru/books/developers-handbook/policies/chapter.adoc
+++ b/documentation/content/ru/books/developers-handbook/policies/chapter.adoc
@@ -12,16 +12,36 @@ authors:
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/developers-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
В этой главе описываются различные рекомендации и требования, которые должны соблюдаться в дереве исходных текстов FreeBSD.
@@ -138,18 +158,18 @@ obrien@FreeBSD.org - 30 March 1997
. Любой файл, интерпретируемый или выполняемый системным(и) CPU, не в форме исходного кода, является нежелательным.
. Любой файл с лицензией, ограничивающей более, чем BSD или GNU, является нежелательным.
. Файл, содержащий загружаемые двоичные данные, используемые аппаратным обеспечением, не являются нежелательными, если только к нему не применимы условия (1) или (2). Он должен быть сохранен в нейтральном к архитектуре формате ASCII (рекомендуется применить утилиты file2c или uuencode).
-. Любой нежелательный файл требует особого одобрения со стороны link:{contributors}#staff-core/[Правления] до того, как он будет добавлен в хранилище CVS.
+. Любой нежелательный файл требует особого одобрения со стороны extref:{contributors}[Правления, staff-core] до того, как он будет добавлен в хранилище CVS.
. Нежелательные файлы помещаются в каталог [.filename]#src/contrib# или [.filename]#src/sys/contrib#.
. Части одного модуля должны храниться вместе. Нет необходимости разбивать их, если только нет совместного использования с кодом, не являющимся нежелательным.
. Объектные файлы именуются [.filename]#arch/filename.o.uu>#.
. Файлы ядра;
.. Должны всегда упоминаться в [.filename]#conf/files.*# (для упрощения построения).
-.. Должны всегда присутствовать в [.filename]#LINT#, но link:{contributors}#staff-core/[Правление] решает в каждом конкретном случае, должны ли они быть раскомментированы или нет. Конечно, позже link:{contributors}#staff-core/[Правление] может изменить свое решение.
+.. Должны всегда присутствовать в [.filename]#LINT#, но extref:{contributors}[Правление, staff-core] решает в каждом конкретном случае, должны ли они быть раскомментированы или нет. Конечно, позже extref:{contributors}[Правление, staff-core] может изменить свое решение.
.. Вопрос о вхождении в состав релиза решается _Группой Выпусков Релизов_.
. Файлы уровня пользователя:
-.. link:{contributors}#staff-core/[Правление] решает, должен ли код стать частью выполнения команды `make world`.
-.. link:{contributors}#staff-who/[Релиз инженер] решает, войдут ли они в релиз.
+.. extref:{contributors}[Правление, staff-core] решает, должен ли код стать частью выполнения команды `make world`.
+.. extref:{contributors}[Релиз инженер, staff-who] решает, войдут ли они в релиз.
[[policies-shlib]]
== Динамические библиотеки
diff --git a/documentation/content/ru/books/developers-handbook/secure/chapter.adoc b/documentation/content/ru/books/developers-handbook/secure/chapter.adoc
index 0d2a138544..28ff3ac158 100644
--- a/documentation/content/ru/books/developers-handbook/secure/chapter.adoc
+++ b/documentation/content/ru/books/developers-handbook/secure/chapter.adoc
@@ -11,16 +11,36 @@ authors:
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/developers-handbook/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[secure-synopsis]]
== Обзор
diff --git a/documentation/content/ru/books/faq/_index.adoc b/documentation/content/ru/books/faq/_index.adoc
index 8f644a518e..40da854402 100644
--- a/documentation/content/ru/books/faq/_index.adoc
+++ b/documentation/content/ru/books/faq/_index.adoc
@@ -3,8 +3,8 @@ title: Часто задаваемые вопросы по FreeBSD 11.X и 12.X
authors:
- author: Проект документации FreeBSD
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
+trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
+isIndex: true
---
= Часто задаваемые вопросы по FreeBSD {rel2-relx} и {rel-relx}
@@ -12,60 +12,46 @@ trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "
:toc: macro
:toclevels: 1
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:rel-numbranch: 3
-:rel-head: 13-CURRENT
-:rel-head-relx: 13.X
+:images-path: books/faq/
+:rel-numbranch: 4
+:rel-head: 14-CURRENT
+:rel-head-relx: 14.X
:rel-head-releng: head/
-:rel-relx: 12.X
-:rel-stable: 12-STABLE
-:rel-releng: stable/12/
+:rel-relx: 13.X
+:rel-stable: 13-STABLE
+:rel-releng: stable/13/
:rel-relengdate: December 2018
-:rel2-relx: 11.X
-:rel2-stable: 11-STABLE
-:rel2-releng: stable/11/
-:rel2-relengdate: October 2016
-
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+:rel2-relx: 12.X
+:rel2-stable: 12-STABLE
+:rel2-releng: stable/12/
+:rel2-relengdate: December 2018
+:rel3-relx: 11.X
+:rel3-stable: 11-STABLE
+:rel3-releng: stable/11/
+:rel3-relengdate: October 2016
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -73,7 +59,7 @@ endif::[]
Этот документ является так называемым FAQ (Frequently Asked Questions), то есть списком Часто Задаваемых Вопросов по FreeBSD версий {rel3-relx}, {rel2-relx} и {rel-relx}. Мы прилагаем все усилия, чтобы сделать этот FAQ максимально информативным; если у вас есть идеи по его усовершенствованию, шлите их на адрес {freebsd-doc}.
-Последняя редакция этого документа всегда доступна с link:{faq}[Web-сервера FreeBSD]. Его также можно получить в виде одного большого link:.[ HTML-файла] по HTTP или в ряде других форматов с link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[FTP-сервера].
+Последняя редакция этого документа всегда доступна с extref:{faq}[Web-сервера FreeBSD]. Его также можно получить в виде одного большого link:.[ HTML-файла] по HTTP или в ряде других форматов с link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[FTP-сервера].
'''
@@ -89,7 +75,7 @@ FreeBSD - это современная операционная система
FreeBSD используется компаниями, Интернет-провайдерами, научными работниками, профессионалами в вычислительной технике, студентами и рядовыми пользователями по всему миру для работы, образования и отдыха.
-Для более детального знакомства с FreeBSD обратитесь к link:{handbook}/[Руководству по FreeBSD].
+Для более детального знакомства с FreeBSD обратитесь к extref:{handbook}/[Руководству по FreeBSD].
[[FreeBSD-goals]]
=== Какова цель FreeBSD?
@@ -116,7 +102,7 @@ FreeBSD используется компаниями, Интернет-пров
Если приложение доступно только для одной операционной системы, то нельзя всего лишь заменить эту операционную систему. Однако есть вероятность, что похожая программа существует для FreeBSD. В качестве сервера для офиса, или сервера Интернет, или надежной рабочей станции FreeBSD практически всегда справится со всем, что вам нужно. Многие пользователи по всему миру, включая как новичков, так и опытных администраторов UNIX(R), используют FreeBSD в качестве своей единственной настольной операционной системы.
-Пользователи при переходе на FreeBSD с другого варианта UNIX(R) найдут для себя FreeBSD очень похожей. Пользователей Windows(R) и Mac OS(R), напротив, может заинтересовать http://www.pcbsd.org/[PC-BSD], дистрибутив на основе FreeBSD. Пользователям, которые не использовали до этого UNIX(R), понадобится затратить дополнительное время на изучение подхода UNIX(R) к работе. Этот FAQ и link:{handbook}[Руководство по FreeBSD] являются прекрасным способом начать это изучение.
+Пользователи при переходе на FreeBSD с другого варианта UNIX(R) найдут для себя FreeBSD очень похожей. Пользователей Windows(R) и Mac OS(R), напротив, может заинтересовать http://www.pcbsd.org/[PC-BSD], дистрибутив на основе FreeBSD. Пользователям, которые не использовали до этого UNIX(R), понадобится затратить дополнительное время на изучение подхода UNIX(R) к работе. Этот FAQ и extref:{handbook}[Руководство по FreeBSD] являются прекрасным способом начать это изучение.
=== Почему система называется именно FreeBSD?
@@ -154,7 +140,7 @@ FreeBSD используется компаниями, Интернет-пров
=== Что такое FreeBSD-CURRENT?
-link:{handbook}#current[ FreeBSD-CURRENT] - это версия операционной системы, находящаяся в стадии разработки, которая должна потом стать новой веткой FreeBSD-STABLE. Таким образом, она представляет реальный интерес только для разработчиков системы и её фанатов. Обратитесь к link:{handbook}#current[соответствующему разделу] link:{handbook}[Руководства] для прояснения деталей работы с _-CURRENT_.
+extref:{handbook}updating-upgrading, current[FreeBSD-CURRENT] - это версия операционной системы, находящаяся в стадии разработки, которая должна потом стать новой веткой FreeBSD-STABLE. Таким образом, она представляет реальный интерес только для разработчиков системы и её фанатов. Обратитесь к extref:{handbook}updating-upgrading[соответствующему разделу, current] extref:{handbook}[Руководства] для прояснения деталей работы с _-CURRENT_.
Пользователям, не знакомым с FreeBSD, не следует использовать FreeBSD-CURRENT. Эта ветвь зачастую меняется очень быстро и иногда из-за ошибок может быть не работоспособна. Те, кто используют FreeBSD-CURRENT, должны быть в состоянии изучить проблему, найти причину и сообщить о этом.
@@ -173,7 +159,7 @@ link:{handbook}#current[ FreeBSD-CURRENT] - это версия операцио
=== В чём смысл FreeBSD-STABLE?
-После того, как была выпущена FreeBSD 2.0.5, разработка FreeBSD разделилась на две части. Одна ветка получила название link:{handbook}#stable[-STABLE], а другая link:{handbook}#current[-CURRENT]. _FreeBSD-STABLE_ предназначена для провайдеров услуг Интернет и других коммерческих пользователей, для которых неожиданные изменения или экспериментальные возможности весьма нежелательны. В неё вносятся только хорошо оттестированные исправления и другие небольшие последовательные усовершенствования. С другой стороны, _FreeBSD-CURRENT_ являлась единой веткой, не разрываемой с момента выхода версии 2.0 и ведущей к {rel120-current}-RELEASE и последующим релизам. Для получения более подробной информации по веткам обратитесь к разделу статьи "link:{releng}#rel-branch[ Подготовка релизов FreeBSD: Создание ветки релиза]". Статус веток и расписание предстоящих релизов можно получить на странице http://www.FreeBSD.org/releng[Информация о подготовке релизов].
+После того, как была выпущена FreeBSD 2.0.5, разработка FreeBSD разделилась на две части. Одна ветка получила название extref:{handbook}updating-upgrading[-STABLE, stable], а другая extref:{handbook}updating-upgrading[-CURRENT, current]. _FreeBSD-STABLE_ предназначена для провайдеров услуг Интернет и других коммерческих пользователей, для которых неожиданные изменения или экспериментальные возможности весьма нежелательны. В неё вносятся только хорошо оттестированные исправления и другие небольшие последовательные усовершенствования. С другой стороны, _FreeBSD-CURRENT_ являлась единой веткой, не разрываемой с момента выхода версии 2.0 и ведущей к {rel120-current}-RELEASE и последующим релизам. Для получения более подробной информации по веткам обратитесь к разделу статьи "extref:{releng}[Подготовка релизов FreeBSD: Создание ветки релиза, rel-branch]". Статус веток и расписание предстоящих релизов можно получить на странице http://www.FreeBSD.org/releng[Информация о подготовке релизов].
Активно разрабатываемой веткой _-STABLE_ является {rel120-current}-STABLE. Последним релизом в ветке {rel120-current}-STABLE является {rel120-current}-RELEASE, выпущенный {rel120-current-date}.
@@ -189,7 +175,7 @@ link:{handbook}#current[ FreeBSD-CURRENT] - это версия операцио
=== Кто разрабатывает FreeBSD?
-Решения, которые касаются ключевых моментов в проекте FreeBSD, такие, как общее направление развития проекта или кто может добавлять код к дереву исходных текстов, принимаются link:https://www.FreeBSD.org/administration/#t-core[основной командой] разработчиков (Core Team), состоящей из 9 человек. Также существует многочисленная группа, состоящая из более чем 350 так называемых link:{contributors}#staff-committers[коммиттеров] (committers), которые могут вносить изменения прямо в дерево исходных текстов FreeBSD.
+Решения, которые касаются ключевых моментов в проекте FreeBSD, такие, как общее направление развития проекта или кто может добавлять код к дереву исходных текстов, принимаются link:https://www.FreeBSD.org/administration/#t-core[основной командой] разработчиков (Core Team), состоящей из 9 человек. Также существует многочисленная группа, состоящая из более чем 350 так называемых extref:{contributors}[коммиттеров, staff-committers] (committers), которые могут вносить изменения прямо в дерево исходных текстов FreeBSD.
Однако большинство нетривиальных изменений широко обсуждается в <<mailing,списках рассылки>>, и не существует никаких ограничений на участие в подобных дискуссиях.
@@ -201,7 +187,7 @@ link:{handbook}#current[ FreeBSD-CURRENT] - это версия операцио
* link:https://www.FreeBSD.org/snapshots/[Снэпшот-релизы] для веток <<current,-CURRENT>> и <<stable,-STABLE>> выпускаются ежемесячно, но они нужны исключительно для разработчиков и тех, кто тестирует самые последние наработки.
* Последний релиз {rel2-stable}, {rel112-current}-RELEASE, можно найти в link:ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/{rel112-current}-RELEASE/[каталоге {rel112-current}-RELEASE].
-Информация о получении/приобретении FreeBSD на CD, DVD и других носителях доступна в link:{handbook}#mirrors/[Руководстве].
+Информация о получении/приобретении FreeBSD на CD, DVD и других носителях доступна в extref:{handbook}mirrors/[Руководстве, mirrors].
=== Как можно получить доступ к базе сообщений о проблемах (Problem Report)?
@@ -209,13 +195,13 @@ link:{handbook}#current[ FreeBSD-CURRENT] - это версия операцио
Можно использовать link:https://www.FreeBSD.org/support/bugreports/[Web-интерфейс] для отсылки сообщений об ошибках через браузер.
-Перед тем, как посылать сообщение об ошибке, прочтите статью link:{problem-reports}[Составление сообщений о проблеме во FreeBSD] о том, как писать хорошие сообщения об ошибках.
+Перед тем, как посылать сообщение об ошибке, прочтите статью extref:{problem-reports}[Составление сообщений о проблеме во FreeBSD] о том, как писать хорошие сообщения об ошибках.
== Документация и поддержка
=== Есть ли хорошие книги по FreeBSD?
-В рамках проекта создан широкий спектр документации, которая доступна on-line по следующей ссылке: http://www.FreeBSD.org/docs/[http://www.FreeBSD.org/docs/]. Кроме того, в <<bibliography,Библиографии>> в конце этого FAQ и в link:{handbook}#bibliography/[Руководстве] имеются ссылки на другие рекомендуемые для чтения книги.
+В рамках проекта создан широкий спектр документации, которая доступна on-line по следующей ссылке: http://www.FreeBSD.org/docs/[http://www.FreeBSD.org/docs/]. Кроме того, в <<bibliography,Библиографии>> в конце этого FAQ и в extref:{handbook}bibliography/[Руководстве, bibliography] имеются ссылки на другие рекомендуемые для чтения книги.
=== Есть ли версии документации в другом формате, например, в виде обычного текста ASCII или PostScript(R)?
@@ -352,7 +338,7 @@ link:{handbook}#current[ FreeBSD-CURRENT] - это версия операцио
=== Где найти информацию по спискам рассылки FreeBSD? Какие существуют телеконференции по FreeBSD?
-Исчерпывающая информация содержится в link:{handbook}#eresources-mail[разделе] Руководства, который посвящён спискам рассылки, и в link:{handbook}#eresources-news/[разделе] Руководства, касающемся телеконференций.
+Исчерпывающая информация содержится в extref:{handbook}eresources[разделе, eresources-mail] Руководства, который посвящён спискам рассылки, и в extref:{handbook}eresources/[разделе, eresources-news] Руководства, касающемся телеконференций.
=== Существуют ли каналы IRC (Internet Relay Chat) по FreeBSD?
@@ -414,7 +400,7 @@ amd64 - это термин, применяемый во FreeBSD для обоз
Пользователям pc98 нужны образы дискет: [.filename]#floppies/boot.flp#, [.filename]#floppies/kern1.flp#, [.filename]#floppies/kern2.flp# и [.filename]#floppies/mfsroot1.flp#. Эти образы нужно перенести на дискеты с помощью таких утилит, как man:dd[1].
-Полные инструкции по этой процедуре и об установке вообще можно найти в link:{handbook}#install/[ разделе] Руководства, посвящённом установке FreeBSD.
+Полные инструкции по этой процедуре и об установке вообще можно найти в extref:{handbook}install/[разделе, install] Руководства, посвящённом установке FreeBSD.
=== Помогите! Установочный образ не загружается!
@@ -426,7 +412,7 @@ amd64 - это термин, применяемый во FreeBSD для обоз
=== Где инструкции по установке FreeBSD?
-Инструкции по установке FreeBSD 9.0 и более поздних версий могут быть найдены в link:{handbook}#bsdinstall/[главе] Руководства, посвящённой установке FreeBSD. Также имеются инструкции по установке link:{handbook}#install/[предыдущих] версий FreeBSD.
+Инструкции по установке FreeBSD 9.0 и более поздних версий могут быть найдены в extref:{handbook}bsdinstall/[главе, bsdinstall] Руководства, посвящённой установке FreeBSD. Также имеются инструкции по установке extref:{handbook}install/[предыдущих, install] версий FreeBSD.
=== Какие минимальные требования для запуска FreeBSD?
@@ -434,7 +420,7 @@ amd64 - это термин, применяемый во FreeBSD для обоз
=== Как сделать собственный установочный диск?
-Индивидуальный установочный носитель FreeBSD можно создать, запустив процедуру построения индивидуального релиза. Следуйте инструкциям в статье о link:{releng}[подготовке релизов FreeBSD].
+Индивидуальный установочный носитель FreeBSD можно создать, запустив процедуру построения индивидуального релиза. Следуйте инструкциям в статье о extref:{releng}[подготовке релизов FreeBSD].
=== Может ли Windows(R) сосуществовать с FreeBSD?
@@ -530,7 +516,7 @@ PAE не является широко используемым в настоя
==== Поддерживает ли FreeBSD аппаратные платформы, отличные от x86?
-Да. Поддержка FreeBSD подразделяется на множество классов. Архитектуры первого класса, такие как i386 или amd64, полностью поддерживаются. Архитектуры 2 и 3 класса поддерживаются по мере возможности. Полное описание классов доступно в link:{committers-guide}#archs/[справочнике коммиттера].
+Да. Поддержка FreeBSD подразделяется на множество классов. Архитектуры первого класса, такие как i386 или amd64, полностью поддерживаются. Архитектуры 2 и 3 класса поддерживаются по мере возможности. Полное описание классов доступно в extref:{committers-guide}[справочнике коммиттера, archs].
Полный список поддерживаемых архитектур находится на http://www.FreeBSD.org/ru/platforms/[странице], посвящённой платформам.
@@ -705,7 +691,7 @@ FreeBSD поддерживает функции ACPI, реализованные
Ядро FreeBSD позволяет одновременно существовать ограниченному числу процессов. Это зависит от значения переменной man:sysctl[8] `kern.maxusers`. `kern.maxusers` также влияет на другие ограничения ядра, такие как буферы работы с сетью. Если система сильно загружена, поднимите `kern.maxusers`. Кроме максимального числа процессов это также увеличит значения других параметров, ограничивающих систему.
-Для корректировки значения `kern.maxusers` обратитесь к разделу link:{handbook}#kern-maxfiles[ Ограничения файлов/процессов] Руководства. В нём говорится об открытых файлах, но те же ограничения касаются процессов.
+Для корректировки значения `kern.maxusers` обратитесь к разделу extref:{handbook}config-tuning[Ограничения файлов/процессов, kern-maxfiles] Руководства. В нём говорится об открытых файлах, но те же ограничения касаются процессов.
Если система загружена слабо, но в ней запущено слишком много процессов, поправьте параметр `kern.maxproc`, определив его значение в [.filename]#/boot/loader.conf#. Изменение не вступит в силу до перезагрузки системы. За дополнительной информацией, касающейся настройки параметров, обращайтесь к странице Справочника man:loader.conf[5]. Если эти процессы запущены одним и тем же пользователем, поправьте значение `kern.maxprocperuid`, чтобы оно было на единицу меньше, чем новое значение `kern.maxproc`. Оно должно быть меньше по крайней мере на единицу, потому что системная программа man:init[8] должна работать всегда.
@@ -735,7 +721,7 @@ FreeBSD поддерживает функции ACPI, реализованные
=== Почему в man:dmesg[8] регулярно выводятся сообщения file: table is full?
-Такое сообщение об ошибке сигнализирует о том, что в системе закончились доступные файловые дескрипторы. Обратитесь к разделу link:{handbook}#kern-maxfiles[ kern.maxfiles] главы о link:{handbook}#configtuning-kernel-limits/[ Настройке ограничений ядра] Руководства для выяснения всех подробностей и устранения этой проблемы.
+Такое сообщение об ошибке сигнализирует о том, что в системе закончились доступные файловые дескрипторы. Обратитесь к разделу extref:{handbook}config-tuning[kern.maxfiles, kern-maxfiles] главы о extref:{handbook}config-tuning/[Настройке ограничений ядра, configtuning-kernel-limits] Руководства для выяснения всех подробностей и устранения этой проблемы.
=== Почему часы на моем компьютере показывают неправильное время?
@@ -833,9 +819,9 @@ FreeBSD умеет работать со сжатыми двоичными па
Любым из указанных способов:
-* Используйте portsnap в большинстве случаев. Обратитесь к разделу link:{handbook}#ports-using/[Использование Коллекции Портов] для получения инструкций по использованию этого инструмента.
-* Используйте SVN, если нужны собственные патчи для дерева портов. Обратитесь к разделу link:{handbook}#svn/[Использование Subversion] для получения дополнительной информации.
-* Используйте CTM как это описано в разделе link:{handbook}#ctm/[Использование CTM] для получения изменений по почте при нестабильном соединении.
+* Используйте portsnap в большинстве случаев. Обратитесь к разделу extref:{handbook}ports/[Использование Коллекции Портов, ports-using] для получения инструкций по использованию этого инструмента.
+* Используйте SVN, если нужны собственные патчи для дерева портов. Обратитесь к разделу extref:{handbook}mirrors/[Использование Subversion, svn] для получения дополнительной информации.
+* Используйте CTM как это описано в разделе extref:{handbook}[Использование CTM] для получения изменений по почте при нестабильном соединении.
=== Поддерживает ли FreeBSD среду Java(TM)?
@@ -843,7 +829,7 @@ FreeBSD умеет работать со сжатыми двоичными па
=== Почему этот порт не компилируется на моей машине с {rel2-relx} - или {rel-relx} -STABLE?
-Если установленная версия FreeBSD, значительно отстаёт от _-CURRENT_ или _-STABLE_, обновите Коллекцию Портов с использованием указаний в разделе link:{handbook}#ports-using/[Использование Коллекции Портов]. Если система в актуальном состоянии, значит кто-то мог внести изменение в порт, с которым он работает в _-CURRENT_, но не работает в _-STABLE_. https://bugs.FreeBSD.org/submit/[Пошлите] сообщение об ошибке, так как Коллекция Портов должна работать как в _-CURRENT_, так и в ветках _-STABLE_.
+Если установленная версия FreeBSD, значительно отстаёт от _-CURRENT_ или _-STABLE_, обновите Коллекцию Портов с использованием указаний в разделе extref:{handbook}ports/[Использование Коллекции Портов, ports-using]. Если система в актуальном состоянии, значит кто-то мог внести изменение в порт, с которым он работает в _-CURRENT_, но не работает в _-STABLE_. https://bugs.FreeBSD.org/submit/[Пошлите] сообщение об ошибке, так как Коллекция Портов должна работать как в _-CURRENT_, так и в ветках _-STABLE_.
=== Я попытался сформировать файл INDEX командой make index, однако попытка окончилась неудачей. Почему?
@@ -853,7 +839,7 @@ FreeBSD умеет работать со сжатыми двоичными па
=== Я обновил исходные тексты. Как теперь обновить установленные порты?
-С FreeBSD не поставляется инструмент обновления портов, но есть несколько инструментов, немного облегчающих этот процесс. Кроме того, для упрощения работы с портами доступны дополнительные инструменты; смотрите раздел Руководства FreeBSD link:{handbook}#ports-using/[Использование Коллекции Портов].
+С FreeBSD не поставляется инструмент обновления портов, но есть несколько инструментов, немного облегчающих этот процесс. Кроме того, для упрощения работы с портами доступны дополнительные инструменты; смотрите раздел Руководства FreeBSD extref:{handbook}ports/[Использование Коллекции Портов, ports-using].
=== Нужно ли мне перекомпилировать все порты каждый раз, когда я выполняю мажорное обновление (со сменой старшей версии FreeBSD)?
@@ -882,14 +868,14 @@ FreeBSD умеет работать со сжатыми двоичными па
% timidity -Ow -s 44100 -o /tmp/juke/01.wav 01.mid
....
-WAV-файлы затем могут быть преобразованы в другие форматы или записаны как аудио-CD, что описано в link:{handbook}#creating-cds/[Руководстве FreeBSD].
+WAV-файлы затем могут быть преобразованы в другие форматы или записаны как аудио-CD, что описано в extref:{handbook}disks/[Руководстве FreeBSD, creating-cds].
== Конфигурирование ядра
[[make-kernel]]
=== Я хочу изменить настройки ядра. Это сложно?
-Вовсе нет! Обратитесь к link:{handbook}#kernelconfig/[соответствующему разделу] Руководства, который посвящён этому вопросу.
+Вовсе нет! Обратитесь к extref:{handbook}kernelconfig/[соответствующему разделу, kernelconfig] Руководства, который посвящён этому вопросу.
[NOTE]
====
@@ -935,7 +921,7 @@ MODULES_OVERRIDE= accf_http ipfw
Для дальнейшего уменьшения размера также можно удалить ненужные устройства из ядра. Для получения дополнительной информации смотрите <<make-kernel>>.
-Для вступления любого из этих действий в силу следуйте указаниям по link:{handbook}#kernelconfig-building/[сборке и установке] нового ядра.
+Для вступления любого из этих действий в силу следуйте указаниям по extref:{handbook}kernelconfig/[сборке и установке, kernelconfig-building] нового ядра.
Большинство ядер ([.filename]#/boot/kernel/kernel#), как правило, занимают от 12 до 16 Мбайт.
@@ -965,7 +951,7 @@ kern.sched.name: ULE
=== Как добавить в систему новый диск?
-Обратитесь к разделу link:{handbook}#disks-adding/[Добавление дисков] Руководства FreeBSD.
+Обратитесь к разделу extref:{handbook}disks/[Добавление дисков, disks-adding] Руководства FreeBSD.
=== Как перенести систему на большой новый диск?
@@ -1072,7 +1058,7 @@ FreeBSD включает сетевую файловую систему NFS. В
=== Существует ли криптографическая файловая система для FreeBSD?
-Да, man:gbde[8] и man:geli[8]. Смотрите раздел link:{handbook}#disks-encrypting/[Шифрование дисковых разделов] Руководства FreeBSD.
+Да, man:gbde[8] и man:geli[8]. Смотрите раздел extref:{handbook}disks/[Шифрование дисковых разделов, disks-encrypting] Руководства FreeBSD.
=== Как загрузить FreeBSD и Linux(R) с помощью GRUB?
@@ -1138,23 +1124,23 @@ kernel /boot/loader
=== При монтировании компакт-диска выдаётся сообщение Incorrect super block.
-Необходимо указать тип монтируемого устройства. Это описано в в разделе Руководства link:{handbook}#creating-cds/#mounting-cd[Использование CD с данными].
+Необходимо указать тип монтируемого устройства. Это описано в в разделе Руководства extref:{handbook}disks[Использование CD с данными, creating-cds].
=== При монтировании компакт-диска выдаётся сообщение Device not configured.
-Обычно это означает, что в приводе нет компакт-диска либо устройство не обнаружено на шине. Обратитесь к разделу link:{handbook}#mounting-cd[Использование CD с данными] в Руководстве, где подробно обсуждается этот вопрос.
+Обычно это означает, что в приводе нет компакт-диска либо устройство не обнаружено на шине. Обратитесь к разделу extref:{handbook}disks[Использование CD с данными, mounting-cd] в Руководстве, где подробно обсуждается этот вопрос.
=== Когда я монтирую CD-ROM, все неанглийские символы в именах файлов выводятся как ?.
-Скорее всего, на компакт-диске для хранения информации о файлах и каталогах используется расширение "Joliet". Это описано в разделе Руководства об link:{handbook}#mounting-cd[использовании CD с данными].
+Скорее всего, на компакт-диске для хранения информации о файлах и каталогах используется расширение "Joliet". Это описано в разделе Руководства об extref:{handbook}disks[использовании CD с данными, mounting-cd].
=== Записанный во FreeBSD CD не читается ни в какой другой операционной системой. Почему?
-Это означает, что на CD был записан непосредственно необработанный файл без создания файловой системы ISO 9660. Прочтите раздел Руководства о link:{handbook}#rawdata-cd[записи данных непосредственно на компакт-диски].
+Это означает, что на CD был записан непосредственно необработанный файл без создания файловой системы ISO 9660. Прочтите раздел Руководства о extref:{handbook}disks[записи данных непосредственно на компакт-диски, rawdata-cd].
=== Как создать образ CD с данными?
-Это описано в разделе Руководства о link:{handbook}#imaging-cd[копировании CD с данными]. Более полную информацию о работе с компакт-дисками можно найти в разделе о link:{handbook}#creating-cds/[создании компакт-дисков] в главе Руководства об устройствах хранения данных.
+Это описано в разделе Руководства о extref:{handbook}disks[копировании CD с данными, imaging-cd]. Более полную информацию о работе с компакт-дисками можно найти в разделе о extref:{handbook}disks/[создании компакт-дисков, creating-cds] в главе Руководства об устройствах хранения данных.
=== Почему я не могу смонтировать (командой mount аудио CD?
@@ -1220,7 +1206,7 @@ kernel /boot/loader
=== Как добавить дополнительную виртуальную память?
-В этом разделе link:{handbook}#adding-swap-space/[Руководства] описывается, как это сделать.
+В этом разделе extref:{handbook}config-tuning/[Руководства, adding-swap-space] описывается, как это сделать.
=== Почему FreeBSD считает, что размер моего диска меньше, чем заявляет его производитель?
@@ -1357,11 +1343,11 @@ ZFS TRIM может не работать на всех конфигурация
=== У меня проблемы с установкой принтера.
-Обратитесь к соответствующему link:{handbook}#printing/[разделу] Руководства, посвящённому печати, за советами по разрешению проблем.
+Обратитесь к соответствующему extref:{handbook}printing/[разделу, printing] Руководства, посвящённому печати, за советами по разрешению проблем.
=== Раскладка клавиатуры неверна.
-Обратитесь к разделу Руководства, посвящённому link:{handbook}#using-localization/[использованию локализации], а именно к части, описывающей link:{handbook}#setting-console[ настройку консоли].
+Обратитесь к разделу Руководства, посвящённому extref:{handbook}l10n/[использованию локализации, using-localization], а именно к части, описывающей extref:{handbook}l10n[настройку консоли, setting-console].
=== Почему не получается заставить работать дисковые квоты?
@@ -1373,7 +1359,7 @@ options QUOTA
....
+
-Прочтите link:{handbook}#quotas/[главу руководства по квотам] для полной информации.
+Прочтитеextref:{handbook}disks/[главу руководства по квотам, quotas] для полной информации.
. Не включайте квотирование на разделе [.filename]#/#.
. Помещайте файл с квотами в ту файловую систему, которую он обслуживает:
+
@@ -1421,7 +1407,7 @@ options SYSVMSG # enable for messaging
[NOTE]
====
-Если корневой раздел не получается смонтировать в однопользовательском режиме, то возможно, что разделы являются зашифрованными, и смонтировать их без ключей доступа не представляется возможным. За дополнительной информацией обращайтесь к разделу link:{handbook}#disks-encrypting/[Руководства], посвященному шифрованию дисков во FreeBSD.
+Если корневой раздел не получается смонтировать в однопользовательском режиме, то возможно, что разделы являются зашифрованными, и смонтировать их без ключей доступа не представляется возможным. За дополнительной информацией обращайтесь к разделу extref:{handbook}disks/[Руководства, disks-encrypting], посвященному шифрованию дисков во FreeBSD.
====
=== Как запретить перезагрузку по нажатию Control Alt Delete?
@@ -1486,7 +1472,7 @@ options SC_DISABLE_REBOOT
Когда делается релиз, то ветвь, из которой он выпускается, подвергается некоторой подготовке. Частью этого процесса является замораживание кода. Когда инициируется замораживание кода, то имя ветки изменяется для того, чтобы отразить факт близости релиза. Например, если ветка называлась 6.2-STABLE, то её имя будет изменено на 6.3-PRERELEASE, чтобы обозначить момент прекращения внесения изменений в код системы и период дополнительного тестирования перед выходом релиза. В это время исправления ошибок могут быть внесены в код системы для того, чтобы быть включенными в релиз. Когда исходный код подготовлен к выпуску релиза, имя будет изменено на 6.3-RC для обозначения того, что релиз будет сделан, скорее всего, именно из этого кода. Когда код находится на этапе RC, в нём могут исправляться только самые критичные ошибки. Как только релиз (в нашем примере 6.3-RELEASE) и ветка релиза будут созданы, ветвь будет переименована в 6.3-STABLE.
-Для получения дополнительной информации о номерах версий и различных ветках Subversion обратитесь к статье о link:{releng}[выпуске релизов].
+Для получения дополнительной информации о номерах версий и различных ветках Subversion обратитесь к статье о extref:{releng}[выпуске релизов].
=== Я попытался установить новое ядро, однако утилита man:chflags[1] не сработала. Как это обойти?
@@ -1584,7 +1570,7 @@ X Window System (обычно `X11`) является наиболее обще
# pkg install xorg
....
-После установки Xorg следуйте указаниям в разделе link:{handbook}#x-config/[Конфигурация X11] Руководства FreeBSD.
+После установки Xorg следуйте указаниям в разделе extref:{handbook}x11/[Конфигурация X11, x-config] Руководства FreeBSD.
=== Я попытался запустить X, но получил сообщение No devices detected. после ввода команды startx. Что мне теперь делать?
@@ -1798,7 +1784,7 @@ psmintr: out of sync (xxxx != yyyy)
=== Как установить экранную заставку и где такие заставки можно найти?
-Подробный ответ находится в разделе link:{handbook}#boot-blocks[Загрузочные экранные заставки] Руководства FreeBSD.
+Подробный ответ находится в разделе extref:{handbook}boot[Загрузочные экранные заставки, boot-blocks] Руководства FreeBSD.
=== Можно ли в X использовать клавишу Windows?
@@ -1864,29 +1850,29 @@ nVidia предоставляет подробную информацию о т
=== Где можно найти информацию о бездисковой загрузке?
-"Бездисковая загрузка" означает, что машина с FreeBSD загружается по сети и читает необходимые файлы с сервера, а не со своего диска. Подробное описание есть в link:{handbook}#network-diskless/[ соответствующей главе] Руководства.
+"Бездисковая загрузка" означает, что машина с FreeBSD загружается по сети и читает необходимые файлы с сервера, а не со своего диска. Подробное описание есть в extref:{handbook}advanced-networking/[ соответствующей главе, network-diskless] Руководства.
=== Может ли машина с FreeBSD использоваться как маршрутизатор?
-Да. Обратитесь к разделу Руководства, посвящённому link:{handbook}#advanced-networking/[сложным вопросам работы в сети], особенно в той части, что касается link:{handbook}#network-routing/[маршрутизации и маршрутизаторов].
+Да. Обратитесь к разделу Руководства, посвящённому extref:{handbook}advanced-networking/[сложным вопросам работы в сети, advanced-networking], особенно в той части, что касается extref:{handbook}advanced-networking/[маршрутизации и маршрутизаторов, network-routing].
=== Можно ли подключить машину с Windows(R) к Internet с помощью FreeBSD?
Как правило, те, кто задают такие вопросы, имеют дома два компьютера, один с FreeBSD, а другой с какой-то версией Windows(R). Идея состоит в использовании FreeBSD для подключения к Internet, а затем осуществлять выход в Internet из Windows(R) через FreeBSD. На самом деле это просто частный случай предыдущего вопроса, который хорошо отработан.
-Для подключения к Internet с использованием коммутируемого соединения нужно указать параметр `-nat` и установить в файле [.filename]#/etc/rc.conf# переменную `gateway_enable` в значение _YES_. Для получения дополнительной информации обратитесь к страницам справочной системы по команде man:ppp[8] или link:{handbook}#userppp/[ разделу Руководства о PPP режима пользователя].
+Для подключения к Internet с использованием коммутируемого соединения нужно указать параметр `-nat` и установить в файле [.filename]#/etc/rc.conf# переменную `gateway_enable` в значение _YES_. Для получения дополнительной информации обратитесь к страницам справочной системы по команде man:ppp[8] или extref:{handbook}ppp-and-slip/[ разделу Руководства о PPP режима пользователя, userppp].
-Если подключение к Internet выполняется через Ethernet, используйте man:natd[8]. Вводная информация находится в разделе Руководства link:{handbook}#network-natd/[natd].
+Если подключение к Internet выполняется через Ethernet, используйте man:natd[8]. Вводная информация находится в разделе Руководства extref:{handbook}/[natd, network-natd].
=== Поддерживает ли FreeBSD протокол PPP?
Да. man:ppp[8] может обслуживать как входящие, так и исходящие соединения.
-Более подробная информация об их использовании находится в link:{handbook}#ppp-and-slip/[разделе Руководства о протоколе PPP].
+Более подробная информация об их использовании находится в extref:{handbook}ppp-and-slip/[разделе Руководства о протоколе PPP, ppp-and-slip].
=== Поддерживает ли FreeBSD технологию NAT или Masquerading?
-Да. Для получения указаний по использованию NAT через подключение PPP обратитесь к link:{handbook}#userppp/[разделу Руководства о PPP]. Чтобы использовать NAT вместе с другим типом сетевого подключения, взгляните на раздел Руководства link:{handbook}#network-natd/[natd].
+Да. Для получения указаний по использованию NAT через подключение PPP обратитесь к extref:{handbook}ppp-and-slip/[разделу Руководства о PPP, userppp]. Чтобы использовать NAT вместе с другим типом сетевого подключения, взгляните на раздел Руководства extref:{handbook}/[natd, network-natd].
=== Как настроить алиас в сети Ethernet?
@@ -1904,7 +1890,7 @@ nVidia предоставляет подробную информацию о т
# ifconfig ed0 alias 172.16.141.5 netmask 0xffffff00
....
-Дополнительная информация находится в link:{handbook}#configtuning-virtual-hosts/[Руководстве] FreeBSD.
+Дополнительная информация находится в extref:{handbook}config-tuning/[Руководстве, configtuning-virtual-hosts] FreeBSD.
=== Почему я не могу смонтировать диск Linux(R) по NFS?
@@ -1917,7 +1903,7 @@ nVidia предоставляет подробную информацию о т
=== Почему mountd продолжает выдавать сообщения can't change attributes и bad exports list на моём сервере NFS, работающем под управлением FreeBSD?
-В большинстве случаев проблема заключается в недостаточном понимании корректного формата файла [.filename]#/etc/exports#. Просмотрите ещё раз справочную информацию по man:exports[5] и раздел об link:{handbook}#network-nfs/[NFS] в Руководстве, особенно в части link:{handbook}#configuring-nfs[настройки NFS].
+В большинстве случаев проблема заключается в недостаточном понимании корректного формата файла [.filename]#/etc/exports#. Просмотрите ещё раз справочную информацию по man:exports[5] и раздел об extref:{handbook}network-servers/[NFS, network-nfs] в Руководстве, особенно в части extref:{handbook}[настройки NFS, configuring-nfs].
=== Как включить поддержку multicast IP?
@@ -1925,7 +1911,7 @@ nVidia предоставляет подробную информацию о т
=== Почему я должен использовать FQDN для хостов не в моей сети?
-За ответом на этот вопрос обращайтесь к link:{handbook}#mail-trouble/[Руководству] FreeBSD.
+За ответом на этот вопрос обращайтесь к extref:{handbook}mail/[Руководству, mail-trouble] FreeBSD.
=== Permission denied для любых действий, связанных с работой сети.
@@ -1940,7 +1926,7 @@ nVidia предоставляет подробную информацию о т
Рассмотрите использование `firewall_type='open'` в файле [.filename]#/etc/rc.conf#.
-Дополнительная информация о настройке данного межсетевого экрана находится в link:{handbook}#firewalls-ipfw/[соответствующей главе] Руководства.
+Дополнительная информация о настройке данного межсетевого экрана находится в extref:{handbook}firewalls/[соответствующей главе, firewalls-ipfw] Руководства.
=== Почему моё правило fwd для ipfw по перенаправлению сервиса на другую машину не работает?
@@ -2099,7 +2085,7 @@ device bpf # Berkeley Packet Filter
=== Не могу заставить работать ppp. Что я делаю не так?
-Первым делом прочтите страницу Справочника man:ppp[8] и link:{handbook}#ppp-and-slip[раздел PPP] Руководства. Для помощи с устранением неполадок включите протоколирование следующей командой:
+Первым делом прочтите страницу Справочника man:ppp[8] и extref:{handbook}ppp-and-slip[раздел PPP, ppp-and-slip] Руководства. Для помощи с устранением неполадок включите протоколирование следующей командой:
[.programlisting]
....
@@ -2149,7 +2135,7 @@ default 10.0.0.2 UGSc 0 0 tun0
delete ALL
....
-В таком случае обратитесь к соответствующему link:{handbook}#userppp-final[разделу] Руководства.
+В таком случае обратитесь к соответствующему extref:{handbook}ppp-and-slip[разделу, userppp-final] Руководства.
=== Что означает сообщение No route to host?
@@ -2170,7 +2156,7 @@ delete ALL
add 0 0 HISADDR
....
-Обратитесь к разделу link:{handbook}#userppp-dynamicip[PPP и динамические IP адреса] Руководства за подробной информацией.
+Обратитесь к разделу extref:{handbook}[PPP и динамические IP адреса, userppp-dynamicip] Руководства за подробной информацией.
=== Соединение разрывается через 3 минуты
@@ -2345,7 +2331,7 @@ set dfilter 3 permit 0/0 0/0
Это не всегда удобно, так как закрывает возможность дозвона по запросу. Большинству программ нужно обратиться к DNS до того, как начать работать.
-В случае DNS попытайтесь установить, что именно пытается определить имя хоста. В большинстве случаев виновным оказывается Sendmail. Проверьте, чтобы в конфигурационном файле программы Sendmail не было указано обращаться к DNS. Обратитесь к разделу об link:{handbook}#smtp-dialup/[использовании электронной почты при коммутируемом соединении] в Руководстве FreeBSD за подробным описанием. Вам может понадобиться добавить в файл [.filename]#.mc# строку:
+В случае DNS попытайтесь установить, что именно пытается определить имя хоста. В большинстве случаев виновным оказывается Sendmail. Проверьте, чтобы в конфигурационном файле программы Sendmail не было указано обращаться к DNS. Обратитесь к разделу об extref:{handbook}mail/[использовании электронной почты при коммутируемом соединении, smtp-dialup] в Руководстве FreeBSD за подробным описанием. Вам может понадобиться добавить в файл [.filename]#.mc# строку:
[.programlisting]
....
@@ -2468,7 +2454,7 @@ FCS является сокращением от Frame Check Sequence (конт
=== Какие многопортовые последовательные адаптеры поддерживаются во FreeBSD?
-Список таких устройств находится в главе Руководства link:{handbook}#serial/[Последовательные соединения].
+Список таких устройств находится в главе Руководства extref:{handbook}serialcomms/[Последовательные соединения, serial].
Большинство многопортовых PCI адаптеров на базе 16550 и их клоны поддерживаются без дополнительных усилий.
@@ -2478,7 +2464,7 @@ FCS является сокращением от Frame Check Sequence (конт
=== Как сделать, чтобы приглашение boot: выводилось на консоль на последовательном порту?
-Подробная информация находится в link:{handbook}#serialconsole-setup/[этом разделе Руководства].
+Подробная информация находится в extref:{handbook}serialcomms/[этом разделе Руководства, serialconsole-setup].
=== Как узнать, обнаружила ли FreeBSD последовательные порты или внутренние модемы?
@@ -2535,15 +2521,15 @@ hint.sio.7.irq="12"
=== Можно ли настроить для порта режим работы по умолчанию?
-Смотрите раздел Руководства FreeBSD, посвящённый link:{handbook}#serial/#serial-hw-config[последовательным соединениям].
+Смотрите раздел Руководства FreeBSD, посвящённый extref:{handbook}serialcomms[последовательным соединениям, serial].
=== Как сделать вход через модем?
-Ознакомьтесь с разделом Руководства FreeBSD, посвящённым link:{handbook}#dialup/[входящим соединениям].
+Ознакомьтесь с разделом Руководства FreeBSD, посвящённым extref:{handbook}serialcomms/[входящим соединениям, dialup].
=== Как подключить терминал к FreeBSD?
-Информация по этому вопросу находится в разделе link:{handbook}#term/[Терминалы] Руководства FreeBSD.
+Информация по этому вопросу находится в разделе extref:{handbook}serialcomms/[Терминалы, term] Руководства FreeBSD.
=== Почему не удаётся запустить tip или cu?
@@ -2605,7 +2591,7 @@ FreeBSD активно перемещает неиспользуемые стр
=== Что мне нужно сделать, чтобы перевести документацию FreeBSD на родной язык?
-Ознакомьтесь с link:{fdp-primer}#translations/[FAQ по Переводам] из FreeBSD Documentation Project Primer.
+Ознакомьтесь с extref:{fdp-primer}[FAQ по Переводам, translations] из FreeBSD Documentation Project Primer.
=== Почему возвращается моя электронная почта, отправленная на любой из адресов FreeBSD.org?
@@ -2645,7 +2631,7 @@ http://www.arbornet.org/[Arbornet, Inc], также известный как _M
=== При просмотре списков рассылки, я встретил акроним или другой термин, который мне не понятен. Где я должен посмотреть, что он значит?
-Пожалуйста, обращайтесь к link:{handbook}#freebsd-glossary/[Глоссарию FreeBSD].
+Пожалуйста, обращайтесь к extref:{handbook}glossary/[Глоссарию FreeBSD, freebsd-glossary].
=== Почему я должен беспокоиться о цвете велосипедных навесов (bikeshed)?
@@ -2770,13 +2756,13 @@ _Пол Робинсон (Paul Robinson) добавляет:_
=== Как можно узнать больше о внутреннем устройстве FreeBSD?
-Список относящихся к делу книг можно найти в разделе Руководства link:{handbook}#bibliography-osinternals/[ Библиография по внутреннему устройству операционной системы].
+Список относящихся к делу книг можно найти в разделе Руководства extref:{handbook}bibliography/[ Библиография по внутреннему устройству операционной системы, bibliography-osinternals].
Кроме того, большинство общих знаний о UNIX(R) непосредственно применимо к FreeBSD.
=== Как можно оказать помощь проекту FreeBSD?
-Пожалуйста, обратитесь к соответствующей link:{contributing}[статье], в которой вы получите советы относительно того, как это сделать. Ваша помощь более чем приветствуется!
+Пожалуйста, обратитесь к соответствующей extref:{contributing}[статье], в которой вы получите советы относительно того, как это сделать. Ваша помощь более чем приветствуется!
=== Что такое снапшоты и релизы?
@@ -2793,11 +2779,11 @@ _Пол Робинсон (Paul Robinson) добавляет:_
=== Можно ли работать с -CURRENT при ограниченном доступе в Internet?
-Да, это можно делать _без_ скачивания полного дерева исходных текстов с помощью link:{handbook}#ctx[системы CTM].
+Да, это можно делать _без_ скачивания полного дерева исходных текстов с помощью extref:{handbook}[системы CTM].
=== Я написал некоторое добавление к ядру, кому его послать?
-Обратитесь к статье о том, как link:{contributing}[помочь проекту FreeBSD], чтобы выяснить, как это сделать.
+Обратитесь к статье о том, как extref:{contributing}[помочь проекту FreeBSD], чтобы выяснить, как это сделать.
И спасибо Вам за Ваши усилия!
@@ -2941,7 +2927,7 @@ options KVA_PAGES=N
Этот небольшой скромный документ с ответами на часто задаваемые вопросы создавался, переписывался, редактировался, сокращался, растягивался, уродовался, потрошился, пристально разглядывался, полностью перетряхивался, обдумывался, отвергался, перестраивался, критиковался и снова укреплялся в течение последнего десятилетия силами сотен, если не тысяч, людей. Постоянно.
-Мы хотим поблагодарить всех их и приглашаем вас link:{contributing}[присоединиться], чтобы сделать этот FAQ ещё лучше.
+Мы хотим поблагодарить всех их и приглашаем вас extref:{contributing}[присоединиться], чтобы сделать этот FAQ ещё лучше.
[bibliography]
[[bibliography]]
diff --git a/documentation/content/ru/books/handbook/_index.adoc b/documentation/content/ru/books/handbook/_index.adoc
index aaed2e9cfb..c6065e3328 100644
--- a/documentation/content/ru/books/handbook/_index.adoc
+++ b/documentation/content/ru/books/handbook/_index.adoc
@@ -3,9 +3,9 @@ title: Руководство FreeBSD
authors:
- author: Проект Документации FreeBSD
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
next: books/handbook/preface
+isIndex: true
---
= FreeBSD Handbook
@@ -15,18 +15,32 @@ next: books/handbook/preface
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
+:images-path: books/handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Аннотация
@@ -35,10 +49,10 @@ include::shared/ru/mailing-lists.adoc[]
'''
-include::content/ru/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
-include::content/ru/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
-include::content/ru/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
-include::content/ru/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/ru/books/handbook/advanced-networking/_index.adoc b/documentation/content/ru/books/handbook/advanced-networking/_index.adoc
index 6e718c4bd5..0b13ef22b2 100644
--- a/documentation/content/ru/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/ru/books/handbook/advanced-networking/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[advanced-networking-synopsis]]
== Краткий обзор
@@ -1469,7 +1467,7 @@ TA полностью полагаются на даемон PPP, который
Как и в случае модемов проблемой использования внешнего TA является потребность в хорошем последовательном адаптере на вашем компьютере.
-Вы должны прочесть учебник link:{serial-uart}[Последовательные устройства во FreeBSD] для того, чтобы в деталях понять работу последовательных устройств и осознать различие между асинхронными и синхронными последовательными портами.
+Вы должны прочесть учебник extref:{serial-uart}[Последовательные устройства во FreeBSD] для того, чтобы в деталях понять работу последовательных устройств и осознать различие между асинхронными и синхронными последовательными портами.
TA, работающий со стандартным последовательным (асинхронным) портом PC, ограничивает вас скоростью 115.2 Кбит/с, хотя реально у вас соединение на скорости 128 Кбит/с. Чтобы использовать 128 Кбит/с, которые обеспечивает ISDN, полностью, вы должны подключить TA к синхронному последовательному адаптеру.
diff --git a/documentation/content/ru/books/handbook/audit/_index.adoc b/documentation/content/ru/books/handbook/audit/_index.adoc
index 5e07d56c80..39417a94f6 100644
--- a/documentation/content/ru/books/handbook/audit/_index.adoc
+++ b/documentation/content/ru/books/handbook/audit/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/disks
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[audit-synopsis]]
== Краткий обзор
diff --git a/documentation/content/ru/books/handbook/basics/_index.adoc b/documentation/content/ru/books/handbook/basics/_index.adoc
index d484276b1d..5937f782e0 100644
--- a/documentation/content/ru/books/handbook/basics/_index.adoc
+++ b/documentation/content/ru/books/handbook/basics/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ports
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[basics-synopsis]]
== Краткий обзор
diff --git a/documentation/content/ru/books/handbook/bibliography/_index.adoc b/documentation/content/ru/books/handbook/bibliography/_index.adoc
index 5429f378bb..0eb08ff175 100644
--- a/documentation/content/ru/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/ru/books/handbook/bibliography/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/eresources
[[bibliography]]
= Библиография
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Так как страницы Справочника FreeBSD предоставляют лишь описание отдельных частей операционной системы FreeBSD, они не очень удобны для иллюстрации объединения этих частей вместе для того, чтобы настроить ОС и сделать ее работу более гладкой. Для этого незаменимы хорошая книга по системному администрированию UNIX(R) и хорошее руководство пользователя.
@@ -118,7 +132,7 @@ _Книги и журналы на английском языке:_
* Leffler, Samuel J., Marshall Kirk McKusick, _The Design and Implementation of the 4.3BSD UNIX Operating System: Answer Book_. Reading, Mass. : Addison-Wesley, 1991. ISBN 0-201-54629-9
* McKusick, Marshall Kirk, Keith Bostic, Michael J Karels, and John Quarterman. _The Design and Implementation of the 4.4BSD Operating System_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-54979-4
+
-(глава 2 этой книги доступна link:{design-44bsd}[онлайн] как часть Проекта документирования FreeBSD, и глава 9 доступна http://www.netapp.com/tech_library/nfsbook.html[ здесь].)
+(глава 2 этой книги доступна extref:{design-44bsd}[онлайн] как часть Проекта документирования FreeBSD, и глава 9 доступна http://www.netapp.com/tech_library/nfsbook.html[ здесь].)
* Marshall Kirk McKusick, George V. Neville-Neil _The Design and Implementation of the FreeBSD Operating System_. Boston, Mass. : Addison-Wesley, 2004. ISBN 0-201-70245-2
* Stevens, W. Richard. _TCP/IP Illustrated, Volume 1: The Protocols_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-63346-9
* Schimmel, Curt. _Unix Systems for Modern Architectures_. Reading, Mass. : Addison-Wesley, 1994. ISBN 0-201-63338-8
diff --git a/documentation/content/ru/books/handbook/book.adoc b/documentation/content/ru/books/handbook/book.adoc
index 306ad325bc..d687fa02e0 100644
--- a/documentation/content/ru/books/handbook/book.adoc
+++ b/documentation/content/ru/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: Руководство FreeBSD
authors:
- author: Проект Документации FreeBSD
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
---
@@ -12,54 +11,35 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
:book: true
:pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
-:chapters-path: content/ru/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -74,87 +54,87 @@ toc::[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
// Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..26;36..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
-include::{chapters-path}install/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}install/_index.adoc[leveloffset=+1]
-include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1]
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
-include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}filesystems/_index.adoc[leveloffset=+1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=7..19]
+include::{chapters-path}partiv.adoc[lines=15..27]
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
// Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
:sectnums!:
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/ru/books/handbook/boot/_index.adoc b/documentation/content/ru/books/handbook/boot/_index.adoc
index bd26d1a2d9..d762459194 100644
--- a/documentation/content/ru/books/handbook/boot/_index.adoc
+++ b/documentation/content/ru/books/handbook/boot/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/security
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== Описание
diff --git a/documentation/content/ru/books/handbook/bsdinstall/_index.adoc b/documentation/content/ru/books/handbook/bsdinstall/_index.adoc
index c9792dffef..988fb67cb7 100644
--- a/documentation/content/ru/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/ru/books/handbook/bsdinstall/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/basics
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/bsdinstall/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
-endif::[]
+:images-path: books/handbook/bsdinstall/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[bsdinstall-synopsis]]
== Краткий обзор
diff --git a/documentation/content/ru/books/handbook/config/_index.adoc b/documentation/content/ru/books/handbook/config/_index.adoc
index c407a483f1..343c8754a9 100644
--- a/documentation/content/ru/books/handbook/config/_index.adoc
+++ b/documentation/content/ru/books/handbook/config/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/boot
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/config/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/config/
-endif::[]
+:images-path: books/handbook/config/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/config/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[config-synopsis]]
== Введение
@@ -304,7 +302,7 @@ HOME=/var/log
[IMPORTANT]
====
-Вы не должны использовать процедуру, описанную здесь, для установки системного crontab. Просто используйте свой любимый текстовый редактор: утилита `cron` узнает о том, что файл изменился и сразу начнет использовать обновленную версию. Обратитесь к link:{faq}#ROOT-NOT-FOUND-CRON-ERRORS[этой части FAQ] за дальнейшей информацией.
+Вы не должны использовать процедуру, описанную здесь, для установки системного crontab. Просто используйте свой любимый текстовый редактор: утилита `cron` узнает о том, что файл изменился и сразу начнет использовать обновленную версию. Обратитесь к extref:{faq}[этой части FAQ, ROOT-NOT-FOUND-CRON-ERRORS] за дальнейшей информацией.
====
Для установки готового [.filename]#crontab# пользователя, сначала создайте в вашем любимом редакторе файл соответствующего формата, а затем воспользуйтесь утилитой `crontab`. Обычно она запускается так:
diff --git a/documentation/content/ru/books/handbook/cutting-edge/_index.adoc b/documentation/content/ru/books/handbook/cutting-edge/_index.adoc
index ed8e4b9dec..e69e4e27df 100644
--- a/documentation/content/ru/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/ru/books/handbook/cutting-edge/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[updating-upgrading-synopsis]]
== Краткий обзор
@@ -388,7 +386,7 @@ before running "/usr/sbin/freebsd-update install"
В этом разделе описывается, как использовать исходный текст или Коллекцию Портов FreeBSD для организации актуальной локальной копии документации FreeBSD.
-За информацией о редактировании и отправке изменений для документации обращайтесь к FreeBSD Documentation Project Primer for New Contributors (link:{fdp-primer}[FreeBSD Documentation Project Primer]).
+За информацией о редактировании и отправке изменений для документации обращайтесь к FreeBSD Documentation Project Primer for New Contributors (extref:{fdp-primer}[FreeBSD Documentation Project Primer]).
[[updating-installed-documentation]]
=== Обновление документации из исходного кода
diff --git a/documentation/content/ru/books/handbook/desktop/_index.adoc b/documentation/content/ru/books/handbook/desktop/_index.adoc
index 944f7d8a09..6835d78603 100644
--- a/documentation/content/ru/books/handbook/desktop/_index.adoc
+++ b/documentation/content/ru/books/handbook/desktop/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/multimedia
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[desktop-synopsis]]
== Краткий обзор
diff --git a/documentation/content/ru/books/handbook/disks/_index.adoc b/documentation/content/ru/books/handbook/disks/_index.adoc
index 08a870808e..46d6f6129b 100644
--- a/documentation/content/ru/books/handbook/disks/_index.adoc
+++ b/documentation/content/ru/books/handbook/disks/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/geom
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[disks-synopsis]]
== Краткий обзор
diff --git a/documentation/content/ru/books/handbook/eresources/_index.adoc b/documentation/content/ru/books/handbook/eresources/_index.adoc
index e542e6e826..7c259b633a 100644
--- a/documentation/content/ru/books/handbook/eresources/_index.adoc
+++ b/documentation/content/ru/books/handbook/eresources/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/pgpkeys
[[eresources]]
= Ресурсы в интернет
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Высокая скорость прогресса FreeBSD делает непрактичным использование печатных изданий для информирования о последних разработках. Электронные ресурсы это лучший, а зачастую и единственный способ информирования о новых возможностях. Поскольку FreeBSD основывается на усилиях добровольцев, сообщество пользователей само по себе зачастую выполняет роль "службы технической поддержки", а электронная почта, веб форумы и новости USENET это наиболее эффективный способ обращения к этому сообществу.
@@ -53,9 +66,9 @@ include::shared/ru/urls.adoc[]
_Если вы желаете проверить возможность отправки сообщений в списки рассылки FreeBSD, пошлите тестовое сообщение на {freebsd-test}._ Пожалуйста, не шлите тестовые сообщения в любой другой список рассылки.
====
-Если вы сомневаетесь, в какой именно список рассылки нужно направить вопрос, то прочтите статью link:{freebsd-questions-article}[Как эффективно использовать список рассылки FreeBSD-questions].
+Если вы сомневаетесь, в какой именно список рассылки нужно направить вопрос, то прочтите статью extref:{freebsd-questions-article}[Как эффективно использовать список рассылки FreeBSD-questions].
-Перед тем, как направлять сообщение в любой список рассылки, пожалуйста, выясните, как лучше всего их использовать, например, как избежать частого повторения одних и тех же дискуссий, прочитав документ link:{mailing-list-faq}[Часто задаваемые вопросы о списках рассылки] (FAQ).
+Перед тем, как направлять сообщение в любой список рассылки, пожалуйста, выясните, как лучше всего их использовать, например, как избежать частого повторения одних и тех же дискуссий, прочитав документ extref:{mailing-list-faq}[Часто задаваемые вопросы о списках рассылки] (FAQ).
Архивы поддерживаются для всех списков рассылки и поиск по ним организован на link:https://www.FreeBSD.org/ru/search/[WWW сервере FreeBSD]. Поиск в архиве по ключевым словам дает отличный способ получения ответов на часто задаваемые вопросы и должен быть выполнен перед отправкой вопроса. Следует также отметить то, что отправленные в списки рассылок сообщения сохраняются в архивах навсегда. Если есть необходимость сохранить приватность, то задействуйте любой доступный вам второстепенный адрес электронной почты, предоставляя в сообщении лишь публичную информацию.
diff --git a/documentation/content/ru/books/handbook/filesystems/_index.adoc b/documentation/content/ru/books/handbook/filesystems/_index.adoc
index a4dbb0283e..732d7dcfb1 100644
--- a/documentation/content/ru/books/handbook/filesystems/_index.adoc
+++ b/documentation/content/ru/books/handbook/filesystems/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/l10n
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/filesystems/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
-endif::[]
+:images-path: books/handbook/filesystems/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[filesystems-synopsis]]
== Краткий обзор
diff --git a/documentation/content/ru/books/handbook/firewalls/_index.adoc b/documentation/content/ru/books/handbook/firewalls/_index.adoc
index a1807e4eb2..d7ec9d8c1d 100644
--- a/documentation/content/ru/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/ru/books/handbook/firewalls/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/advanced-networking
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[firewalls-intro]]
== Введение
diff --git a/documentation/content/ru/books/handbook/geom/_index.adoc b/documentation/content/ru/books/handbook/geom/_index.adoc
index 632cc9b3ea..b06bf0b2fa 100644
--- a/documentation/content/ru/books/handbook/geom/_index.adoc
+++ b/documentation/content/ru/books/handbook/geom/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/filesystems
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[GEOM-synopsis]]
== Краткий обзор
@@ -561,4 +559,4 @@ options GEOM_JOURNAL
Для увеличения производительности может потребоваться хранение журнала на отдельном диске. В таких случаях необходимо указать имя поставщика журнала или устройства хранения после имени устройства, на котором планируется включение журналирования. Журналирование также может быть активировано утилитой `tunefs` на действующих файловых системах; однако, всегда создавайте резервную копию перед попытками изменить настройки файловой системы. В большинстве случаев, выполнение команды `gjournal` завершится ошибкой, если создание журнала невозможно, в то время как некорректное использование команды `tunefs` не защитит против потери данных.
-Также возможно журналирование загрузочного диска системы FreeBSD. За детальными инструкциями по этой возможности обратитесь к статье link:{gjournal-desktop}[Настройка журналирования UFS для настольного компьютера].
+Также возможно журналирование загрузочного диска системы FreeBSD. За детальными инструкциями по этой возможности обратитесь к статье extref:{gjournal-desktop}[Настройка журналирования UFS для настольного компьютера].
diff --git a/documentation/content/ru/books/handbook/install/_index.adoc b/documentation/content/ru/books/handbook/install/_index.adoc
index 4ef12b4b14..30ea7ec96c 100644
--- a/documentation/content/ru/books/handbook/install/_index.adoc
+++ b/documentation/content/ru/books/handbook/install/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/bsdinstall
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/install/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/install/
-endif::[]
+:images-path: books/handbook/install/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/install/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[install-synopsis]]
== Краткий обзор
@@ -2324,7 +2322,7 @@ ISO образы для каждого релиза могут быть загр
[NOTE]
====
-Если вы интересуетесь созданием собственных вариантов релизов FreeBSD, пожалуйста, прочтите статью о link:{releng}[Процессе подготовки релизов].
+Если вы интересуетесь созданием собственных вариантов релизов FreeBSD, пожалуйста, прочтите статью о extref:{releng}[Процессе подготовки релизов].
====
[[install-ftp]]
@@ -2438,7 +2436,7 @@ C:\> xcopy e:\manpages c:\freebsd\manpages\ /s
Если вы используете модем, PPP это конечно почти единственный выбор. Убедитесь что у вас есть информация о провайдере, так как она понадобится на довольно ранней стадии процесса установки.
-Если вы используете PAP или CHAP для соединения с провайдером (другими словами, вы можете соединяться с провайдером из Windows(R) без использования скрипта), все что вам понадобится это ввести `dial` в приглашении ppp. Иначе вам нужно знать, как дозвониться до провайдера с помощью "AT команд", специфичных для вашего модема, так как программа дозвона PPP предоставляет только очень простой эмулятор терминала. Обратитесь к crossref:ppp-and-slip[userppp,руководству] user-ppp и link:{faq}#ppp/[FAQ] для получения более подробных сведений. Если у вас проблемы, логи могут быть выведены на экран с помощью команды `set log local ...`.
+Если вы используете PAP или CHAP для соединения с провайдером (другими словами, вы можете соединяться с провайдером из Windows(R) без использования скрипта), все что вам понадобится это ввести `dial` в приглашении ppp. Иначе вам нужно знать, как дозвониться до провайдера с помощью "AT команд", специфичных для вашего модема, так как программа дозвона PPP предоставляет только очень простой эмулятор терминала. Обратитесь к crossref:ppp-and-slip[userppp,руководству] user-ppp и extref:{faq}[FAQ, ppp] для получения более подробных сведений. Если у вас проблемы, логи могут быть выведены на экран с помощью команды `set log local ...`.
Если доступно постоянное соединение с другой машиной FreeBSD, вы можете также подумать об установке через параллельный порт "laplink" кабелем. Скорость соединения через параллельный порт значительно выше, чем обычно возможно через последовательную линию (до 50 кбайт/с), это приведет к ускорению установки.
diff --git a/documentation/content/ru/books/handbook/introduction/_index.adoc b/documentation/content/ru/books/handbook/introduction/_index.adoc
index 01bfb6462f..3ebb52bf4f 100644
--- a/documentation/content/ru/books/handbook/introduction/_index.adoc
+++ b/documentation/content/ru/books/handbook/introduction/_index.adoc
@@ -13,25 +13,35 @@ next: books/handbook/install
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/handbook/introduction/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-synopsis]]
== Краткий обзор
@@ -49,7 +59,7 @@ toc::[]
[[nutshell]]
== Добро пожаловать во FreeBSD!
-FreeBSD - это основанная на 4.4BSD-Lite операционная система для компьютеров Intel (x86 и Itanium(R)), AMD64, Alpha(TM) и Sun UltraSPARC(R). Ведется работа по портированию и на другие архитектуры. Вы можете также прочесть об <<history,истории FreeBSD>>, или о <<relnotes,текущем релизе>>. Если вы заинтересованы в помощи проекту (кодом, аппаратным обеспечением, деньгами), прочтите статью link:{contributing}[Помощь FreeBSD].
+FreeBSD - это основанная на 4.4BSD-Lite операционная система для компьютеров Intel (x86 и Itanium(R)), AMD64, Alpha(TM) и Sun UltraSPARC(R). Ведется работа по портированию и на другие архитектуры. Вы можете также прочесть об <<history,истории FreeBSD>>, или о <<relnotes,текущем релизе>>. Если вы заинтересованы в помощи проекту (кодом, аппаратным обеспечением, деньгами), прочтите статью extref:{contributing}[Помощь FreeBSD].
=== Что может FreeBSD?
@@ -161,7 +171,7 @@ FreeBSD 2.2 была ответвлена от основной линии ра
[[development]]
=== Модель Разработки FreeBSD
-Разработка FreeBSD - это очень открытый и гибкий процесс. FreeBSD в буквальном смысле создана из кода, предоставленного сотнями людей со всего мира, в чем вы можете убедится, взглянув на link:{contributors}[список этих людей]. Инфраструктура разработки FreeBSD позволяет этим сотням разработчиков сотрудничать с помощью Интернета. Мы постоянно ищем новых разработчиков и новые идеи, и те, кто заинтересован в более тесном взаимодействии и хочет принять участие в проекте, должны просто связаться с нами в рассылке link:{freebsd-hackers-url}[freebsd-hackers]. Для тех, кто желает уведомить других пользователей FreeBSD об основных направлениях работы, доступен {freebsd-announce}.
+Разработка FreeBSD - это очень открытый и гибкий процесс. FreeBSD в буквальном смысле создана из кода, предоставленного сотнями людей со всего мира, в чем вы можете убедится, взглянув на extref:{contributors}[список этих людей]. Инфраструктура разработки FreeBSD позволяет этим сотням разработчиков сотрудничать с помощью Интернета. Мы постоянно ищем новых разработчиков и новые идеи, и те, кто заинтересован в более тесном взаимодействии и хочет принять участие в проекте, должны просто связаться с нами в рассылке link:{freebsd-hackers-url}[freebsd-hackers]. Для тех, кто желает уведомить других пользователей FreeBSD об основных направлениях работы, доступен {freebsd-announce}.
Для независимой работы или тесного сотрудничества, полезно знать о проекте и процессе разработки FreeBSD следующее:
@@ -174,7 +184,7 @@ _Коммиттеры_ - это люди, которые имеют доступ
Core-группа FreeBSD [[development-core]]::
_Core-группа FreeBSD_ могла бы быть эквивалентом Совета Директоров, если бы Проект FreeBSD был компанией. Главная задача Core-группы - гарантировать, что проект в целом в хорошем состоянии и движется в правильном направлении. Приглашение постоянных и ответственных разработчиков присоединиться к группе коммиттеров - одна из функций Core-группы, так же, как и приглашение новых членов в Core-группу по мере того, как другие уходят. Нынешний состав команды был выбран из рядов коммиттеров путем общего голосования в июле 2006 года. Выборы проходят каждые 2 года.
+
-Некоторые члены Core-группы имеют особые области ответственности, то есть, они являются ответственными за работу отдельной большой части системы. Полный список разработчиков FreeBSD и областей их ответственности можно найти в link:{contributors}[Списке участников].
+Некоторые члены Core-группы имеют особые области ответственности, то есть, они являются ответственными за работу отдельной большой части системы. Полный список разработчиков FreeBSD и областей их ответственности можно найти в extref:{contributors}[Списке участников].
+
[NOTE]
====
@@ -184,7 +194,7 @@ _Core-группа FreeBSD_ могла бы быть эквивалентом С
Внешняя помощь::
Последней, но однозначно не менее значимой, и наибольшей группой разработчиков являются сами пользователи, которые предоставляют комментарии и исправления ошибок нам на почти постоянной основе. Основной путь участвовать в не централизованной разработке - это подписка на {freebsd-hackers}, где обсуждаются подобные вещи. Обратитесь к crossref:eresources[eresources, Ресурсы в интернет] за дальнейшей информацией о различных списках рассылки FreeBSD.
+
-link:{contributors}[Список участников проекта FreeBSD] очень длинный и постоянно растет, так почему бы вам не присоединится к нему, предоставив что-нибудь проекту FreeBSD сегодня?
+extref:{contributors}[Список участников проекта FreeBSD] очень длинный и постоянно растет, так почему бы вам не присоединится к нему, предоставив что-нибудь проекту FreeBSD сегодня?
+
Предоставление кода - не единственный способ помочь проекту; более полный список того, что необходимо сделать, можно найти на link:https://www.FreeBSD.org/ru/[Web-сайте проекта FreeBSD].
diff --git a/documentation/content/ru/books/handbook/kernelconfig/_index.adoc b/documentation/content/ru/books/handbook/kernelconfig/_index.adoc
index 1fbf8a622d..990e719811 100644
--- a/documentation/content/ru/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/ru/books/handbook/kernelconfig/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/printing
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kernelconfig-synopsis]]
== Краткий обзор
diff --git a/documentation/content/ru/books/handbook/l10n/_index.adoc b/documentation/content/ru/books/handbook/l10n/_index.adoc
index 342a19e653..eb05bbd4fc 100644
--- a/documentation/content/ru/books/handbook/l10n/_index.adoc
+++ b/documentation/content/ru/books/handbook/l10n/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/cutting-edge
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-synopsis]]
== Краткий обзор
diff --git a/documentation/content/ru/books/handbook/linuxemu/_index.adoc b/documentation/content/ru/books/handbook/linuxemu/_index.adoc
index be1c1717f3..13d23674a8 100644
--- a/documentation/content/ru/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/ru/books/handbook/linuxemu/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[linuxemu-synopsis]]
== Краткий обзор
diff --git a/documentation/content/ru/books/handbook/mac/_index.adoc b/documentation/content/ru/books/handbook/mac/_index.adoc
index e871bb056e..e05b95c9b2 100644
--- a/documentation/content/ru/books/handbook/mac/_index.adoc
+++ b/documentation/content/ru/books/handbook/mac/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/audit
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-synopsis]]
== Краткий обзор
diff --git a/documentation/content/ru/books/handbook/mail/_index.adoc b/documentation/content/ru/books/handbook/mail/_index.adoc
index 46d6b069c2..2864b6f20d 100644
--- a/documentation/content/ru/books/handbook/mail/_index.adoc
+++ b/documentation/content/ru/books/handbook/mail/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/network-servers
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mail-synopsis]]
== Краткий обзор
diff --git a/documentation/content/ru/books/handbook/mirrors/_index.adoc b/documentation/content/ru/books/handbook/mirrors/_index.adoc
index 90a160b7cd..eb38c487ed 100644
--- a/documentation/content/ru/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/ru/books/handbook/mirrors/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/bibliography
[[mirrors]]
= Получение FreeBSD
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mirrors-cdrom]]
== Наборы CD и DVD
diff --git a/documentation/content/ru/books/handbook/multimedia/_index.adoc b/documentation/content/ru/books/handbook/multimedia/_index.adoc
index acde2e23d4..e9b78574b2 100644
--- a/documentation/content/ru/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/ru/books/handbook/multimedia/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/kernelconfig
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[multimedia-synopsis]]
== Краткий обзор
diff --git a/documentation/content/ru/books/handbook/network-servers/_index.adoc b/documentation/content/ru/books/handbook/network-servers/_index.adoc
index eed8b3510d..6a50f45f47 100644
--- a/documentation/content/ru/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/ru/books/handbook/network-servers/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/firewalls
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[network-servers-synopsis]]
== Краткий обзор
diff --git a/documentation/content/ru/books/handbook/parti.adoc b/documentation/content/ru/books/handbook/parti.adoc
index e3f0b633fb..18e1c4bcb5 100644
--- a/documentation/content/ru/books/handbook/parti.adoc
+++ b/documentation/content/ru/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
next: books/handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[getting-started]]
= В начале
@@ -17,4 +25,4 @@ next: books/handbook/introduction
Мы попытались сократить множество ссылок в тексте до минимума для того, чтоб вы могли прочитать этот раздел Руководства с начала до конца с минимумом перелистываний страниц.
-include::content/ru/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/ru/books/handbook/partii.adoc b/documentation/content/ru/books/handbook/partii.adoc
index 12e5e9e1cc..ca91c03bb5 100644
--- a/documentation/content/ru/books/handbook/partii.adoc
+++ b/documentation/content/ru/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
next: books/handbook/desktop
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[common-tasks]]
= Общие задачи
@@ -17,4 +25,4 @@ next: books/handbook/desktop
Перед прочтением некоторых из этих глав необходимо ознакомиться с предварительной информацией, что указано в кратком обзоре в начале каждой главы.
-include::content/ru/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/ru/books/handbook/partiii.adoc b/documentation/content/ru/books/handbook/partiii.adoc
index fb2f658e28..708ae66408 100644
--- a/documentation/content/ru/books/handbook/partiii.adoc
+++ b/documentation/content/ru/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
next: books/handbook/config
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[system-administration]]
= Системное администрирование
@@ -11,4 +19,4 @@ next: books/handbook/config
Эти главы спланированы так, что вы можете прочитать их когда вам нужно узнать какую-либо информацию. Вам не нужно читать их в определенном порядке, и не нужно прочитать их все перед тем, как начать пользоваться FreeBSD.
-include::content/ru/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/ru/books/handbook/partiv.adoc b/documentation/content/ru/books/handbook/partiv.adoc
index 32323a2268..a30715de4a 100644
--- a/documentation/content/ru/books/handbook/partiv.adoc
+++ b/documentation/content/ru/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/cutting-edge
next: books/handbook/serialcomms
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[network-communication]]
= Сетевые коммуникации
@@ -18,4 +26,4 @@ FreeBSD это одна из наиболее широко используем
Эти главы предназначены для получения дополнительной информации. Нет необходимости читать их в определенной последовательности, или читать их все перед тем, как начать использовать FreeBSD в сети.
-include::content/ru/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/ru/books/handbook/partv.adoc b/documentation/content/ru/books/handbook/partv.adoc
index 28dbdc2163..26d460f7f6 100644
--- a/documentation/content/ru/books/handbook/partv.adoc
+++ b/documentation/content/ru/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
next: books/handbook/mirrors
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= Приложения
-include::content/ru/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/ru/books/handbook/pgpkeys/_index.adoc b/documentation/content/ru/books/handbook/pgpkeys/_index.adoc
index 9b85e25682..0ebbe4b851 100644
--- a/documentation/content/ru/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/ru/books/handbook/pgpkeys/_index.adoc
@@ -9,28 +9,44 @@ next: books/handbook/freebsd-glossary
[[pgpkeys]]
= PGP ключи
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
В случае, если вам нужно проверить подпись или послать зашифрованное электронное письмо одному из офицеров или разработчиков, то для вашего удобства здесь представлено некоторое количество ключей. Полный список ключей пользователей `FreeBSD.org` доступен для скачивания с link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
diff --git a/documentation/content/ru/books/handbook/ports/_index.adoc b/documentation/content/ru/books/handbook/ports/_index.adoc
index a201ecc246..8821c85bd7 100644
--- a/documentation/content/ru/books/handbook/ports/_index.adoc
+++ b/documentation/content/ru/books/handbook/ports/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/x11
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ports-synopsis]]
== Обзор
@@ -663,7 +661,7 @@ Portsnap это быстрый и удобный инструмент для п
====
*Procedure: Метод Subversion*
-Если необходим контроль за деревом портов (например, для поддержания локальных изменений), то для получения Коллекции Портов может быть задействован Subversion. Обратитесь к link:{committers-guide}#subversion-primer/[Subversion Primer] за детальным описанием Subversion.
+Если необходим контроль за деревом портов (например, для поддержания локальных изменений), то для получения Коллекции Портов может быть задействован Subversion. Обратитесь к extref:{committers-guide}[Subversion Primer, subversion-primer] за детальным описанием Subversion.
. Для создания рабочей копии дерева портов необходимо иметь установленный Subversion. Если порты есть в наличии, то установите Subversion выполнив следующее:
+
@@ -687,7 +685,7 @@ Portsnap это быстрый и удобный инструмент для п
# pkg install subversion
....
+
-. Создайте рабочую копию дерева портов. Для ускорения процесса вместо _svn0.us-east.FreeBSD.org_ укажите ближайшее к вам crossref:mirrors[svn-mirrors,зеркало Subversion]. Коммиттерам необходимо сначала прочитать link:{committers-guide}#subversion-primer/[Subversion Primer], чтобы удостовериться, что выбран корректный протокол.
+. Создайте рабочую копию дерева портов. Для ускорения процесса вместо _svn0.us-east.FreeBSD.org_ укажите ближайшее к вам crossref:mirrors[svn-mirrors,зеркало Subversion]. Коммиттерам необходимо сначала прочитать extref:{committers-guide}[Subversion Primer, subversion-primer], чтобы удостовериться, что выбран корректный протокол.
+
[source,shell]
....
@@ -795,7 +793,7 @@ Portsnap это быстрый и удобный инструмент для п
* [.filename]#pkg-descr#: этот файл содержит более подробное описание программы.
* [.filename]#pkg-plist#: это список всех файлов, которые будут установлены портом. В нем также содержатся указания системе портов на удаление определенных файлов во время удаления порта.
-В некоторых портах присутствуют и другие файлы, такие, как [.filename]#pkg-message#. Система портов использует эти файлы для обработки особых ситуаций. Если вы хотите узнать более подробно об этих файлах и о портах вообще, то обратитесь к link:{porters-handbook}[Руководству по созданию портов для FreeBSD].
+В некоторых портах присутствуют и другие файлы, такие, как [.filename]#pkg-message#. Система портов использует эти файлы для обработки особых ситуаций. Если вы хотите узнать более подробно об этих файлах и о портах вообще, то обратитесь к extref:{porters-handbook}[Руководству по созданию портов для FreeBSD].
Порт не содержит собственно исходного кода, также известного как "дистрибутивный файл" (distfile). Способ распространения исходного кода определяется предпочтениями автора программы. Ниже описаны два способа установки порта FreeBSD.
@@ -1171,11 +1169,11 @@ Portmaster делит порты на четыре категории:
+
[NOTE]
====
-Некоторые порты поддерживаются группой людей из link:{mailing-list-faq}[списка рассылки], а не отдельными людьми. В большинстве таких случаев адрес мейнтейнера выглядит подобно следующему: mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org]. Пожалуйста, учтите это при формулировании ваших вопросов.
+Некоторые порты поддерживаются группой людей из extref:{mailing-list-faq}[списка рассылки], а не отдельными людьми. В большинстве таких случаев адрес мейнтейнера выглядит подобно следующему: mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org]. Пожалуйста, учтите это при формулировании ваших вопросов.
В частности, если мейнтейнер порта - mailto:ports@FreeBSD.org[ports@FreeBSD.org], то такой порт вообще никем не поддерживается. Решение проблем и поддержка, если и имеют место, то приходят от общества, которое подписано на тот список рассылки. Волонтёры требуются всегда!
====
+
-Если вы не получили ответ, то воспользуйтесь командой man:send-pr[1] для посылки сообщения о проблеме (изучите link:{problem-reports}[составление сообщений о проблеме во FreeBSD]).
-. Исправьте его! В link:{porters-handbook}[Руководстве по созданию портов] содержится подробная информация об инфраструктуре портов, так что вы сможете исправить редкий неработающий порт или даже предложить свой собственный!
+Если вы не получили ответ, то воспользуйтесь командой man:send-pr[1] для посылки сообщения о проблеме (изучите extref:{problem-reports}[составление сообщений о проблеме во FreeBSD]).
+. Исправьте его! В extref:{porters-handbook}[Руководстве по созданию портов] содержится подробная информация об инфраструктуре портов, так что вы сможете исправить редкий неработающий порт или даже предложить свой собственный!
. Воспользуйтесь man:pkg_add[1] и установите пакет вместо порта.
diff --git a/documentation/content/ru/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/ru/books/handbook/ppp-and-slip/_index.adoc
index 514273ab34..f9497cb803 100644
--- a/documentation/content/ru/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/ru/books/handbook/ppp-and-slip/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mail
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ppp-and-slip-synopsis]]
== Краткий обзор
diff --git a/documentation/content/ru/books/handbook/preface/_index.adoc b/documentation/content/ru/books/handbook/preface/_index.adoc
index a85343fe94..7dc28183ba 100644
--- a/documentation/content/ru/books/handbook/preface/_index.adoc
+++ b/documentation/content/ru/books/handbook/preface/_index.adoc
@@ -11,17 +11,33 @@ next: books/handbook/parti
:toc: macro
:toclevels: 1
:icons: font
-:sectnums!:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-audience]]
== Целевая аудитория
diff --git a/documentation/content/ru/books/handbook/printing/_index.adoc b/documentation/content/ru/books/handbook/printing/_index.adoc
index 05ebe2ceda..bdcfd51a9f 100644
--- a/documentation/content/ru/books/handbook/printing/_index.adoc
+++ b/documentation/content/ru/books/handbook/printing/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/linuxemu
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/printing/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[printing-synopsis]]
== Краткий обзор
diff --git a/documentation/content/ru/books/handbook/security/_index.adoc b/documentation/content/ru/books/handbook/security/_index.adoc
index 7dd23310d5..0d89a1c6f5 100644
--- a/documentation/content/ru/books/handbook/security/_index.adoc
+++ b/documentation/content/ru/books/handbook/security/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mac
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-synopsis]]
== Краткое описание
diff --git a/documentation/content/ru/books/handbook/serialcomms/_index.adoc b/documentation/content/ru/books/handbook/serialcomms/_index.adoc
index 6d411132e8..a58042a338 100644
--- a/documentation/content/ru/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/ru/books/handbook/serialcomms/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ppp-and-slip
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[serial-synopsis]]
== Краткое описание
@@ -1126,7 +1124,7 @@ FreeBSD может загружаться при использовании в
Включает поддержку консоли на устройстве (если нет другой консоли с более высоким приоритетом), независимо от наличия описываемой ниже опции `-h`. Флаг `0x20` должен использоваться вместе с флагом `0x10`.
`0x40`:::
-Резервирует это устройство (совместно с флагом `0x10`) и делает устройство недоступным для обычной работы. Вы не должны использовать этот флаг для устройства последовательного порта, которое будет использоваться в качестве последовательной консоли. Используйте этот флаг только если устройство предназначено для удаленной отладки ядра. Обратитесь к link:{developers-handbook}[Руководству для разработчиков] за дополнительной информацией по удаленной отладке.
+Резервирует это устройство (совместно с флагом `0x10`) и делает устройство недоступным для обычной работы. Вы не должны использовать этот флаг для устройства последовательного порта, которое будет использоваться в качестве последовательной консоли. Используйте этот флаг только если устройство предназначено для удаленной отладки ядра. Обратитесь к extref:{developers-handbook}[Руководству для разработчиков] за дополнительной информацией по удаленной отладке.
+
Пример:
+
diff --git a/documentation/content/ru/books/handbook/x11/_index.adoc b/documentation/content/ru/books/handbook/x11/_index.adoc
index 69b5ed898c..72279770e7 100644
--- a/documentation/content/ru/books/handbook/x11/_index.adoc
+++ b/documentation/content/ru/books/handbook/x11/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[x11-synopsis]]
== Обзор
diff --git a/documentation/content/ru/books/porters-handbook/_index.adoc b/documentation/content/ru/books/porters-handbook/_index.adoc
index 4469e6ad49..1b6f7d092c 100644
--- a/documentation/content/ru/books/porters-handbook/_index.adoc
+++ b/documentation/content/ru/books/porters-handbook/_index.adoc
@@ -3,8 +3,8 @@ title: Руководство FreeBSD по созданию портов
authors:
- author: The FreeBSD Documentation Project
copyright: 2000-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "sun", "unix", "general"]
+trademarks: ["freebsd", "sun", "unix", "general"]
+isIndex: true
---
= Руководство FreeBSD по созданию портов
@@ -12,51 +12,34 @@ trademarks: ["freebsd", "sun", "unix", "general"]
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:part-signifier: Часть
-:chapter-signifier: Глава
-:appendix-caption: Приложение
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
+:book: true
+:pdf: false
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
-:chapters-path: content/ru/books/porters-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/porters-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/ru/mailing-lists.adoc[]
-include::../../../../shared/ru/teams.adoc[]
-include::../../../../shared/ru/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -67,19 +50,19 @@ include::{chapters-path}toc-tables.adoc[]
include::{chapters-path}toc-examples.adoc[]
-include::{chapters-path}porting-why/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}new-port/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}slow-porting/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}makefiles/chapter.adoc[leveloffset=+1, lines=7..25;36..-1]
-include::{chapters-path}special/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}plist/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}testing/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}upgrading/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}security/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}uses/chapter.adoc[leveloffset=+1, lines=7..25;36..-1]
-include::{chapters-path}versions/chapter.adoc[leveloffset=+1, lines=6..23;34..-1]
+include::{chapters-path}porting-why/chapter.adoc[leveloffset=+1]
+include::{chapters-path}new-port/chapter.adoc[leveloffset=+1]
+include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1]
+include::{chapters-path}slow-porting/chapter.adoc[leveloffset=+1]
+include::{chapters-path}makefiles/chapter.adoc[leveloffset=+1]
+include::{chapters-path}special/chapter.adoc[leveloffset=+1]
+include::{chapters-path}plist/chapter.adoc[leveloffset=+1]
+include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1]
+include::{chapters-path}testing/chapter.adoc[leveloffset=+1]
+include::{chapters-path}upgrading/chapter.adoc[leveloffset=+1]
+include::{chapters-path}security/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1]
+include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1]
+include::{chapters-path}uses/chapter.adoc[leveloffset=+1]
+include::{chapters-path}versions/chapter.adoc[leveloffset=+1]
diff --git a/documentation/content/ru/books/porters-handbook/keeping-up/chapter.adoc b/documentation/content/ru/books/porters-handbook/keeping-up/chapter.adoc
index b01dc6c3e1..8a69b0487e 100644
--- a/documentation/content/ru/books/porters-handbook/keeping-up/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/keeping-up/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/uses
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Коллекция Портов FreeBSD постоянно изменяется. Здесь находится некоторая информация о том, как поддерживать её в актуальном состоянии.
diff --git a/documentation/content/ru/books/porters-handbook/makefiles/chapter.adoc b/documentation/content/ru/books/porters-handbook/makefiles/chapter.adoc
index 546ce1a2fb..721539ccb6 100644
--- a/documentation/content/ru/books/porters-handbook/makefiles/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/makefiles/chapter.adoc
@@ -11,27 +11,37 @@ next: books/porters-handbook/special
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:gcc-plus-plus: g++
-:sectnumoffset: 5
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Настройка файла [.filename]#Makefile# достаточно проста, и мы снова предполагаем, что перед тем, как начать, вы посмотрите на существующие примеры. К тому же в этом руководстве имеется <<porting-samplem,примерный Makefile>>, так что взгляните на него и, пожалуйста, следуйте порядку переменных и разделов в этом образце, чтобы облегчить чтение вашего порта другими людьми.
@@ -691,7 +701,7 @@ PORTEPOCH= 1
В соответствие с существующей практикой мы избегаем создания новой физической категории, пока достаточно большое число портов логически ей не принадлежит или же порты, которые могли бы ей принадлежать, не являются логически обособленной группой, представляющей для всех ограниченный интерес (в частности, категории, относящиеся к естественным языкам); предпочтительно выполнение обоих условий.
-Основной причиной для этого является то, что такое изменение создает link:{committers-guide}#ports[изрядное количество работы] и для коммиттеров, и для всех тех пользователей, которые отслеживают изменения в Коллекции Портов. В дополнение, предложенная категория создает естественное разногласие. (Пожалуй, потому что не существует четкого соглашения, является ли категория "слишком большой", или должны ли категории предоставлять себя для просмотра (и, таким образом, какое количество категорий было бы идеальным значением), и так далее.)
+Основной причиной для этого является то, что такое изменение создает extref:{committers-guide}[изрядное количество работы, ports] и для коммиттеров, и для всех тех пользователей, которые отслеживают изменения в Коллекции Портов. В дополнение, предложенная категория создает естественное разногласие. (Пожалуй, потому что не существует четкого соглашения, является ли категория "слишком большой", или должны ли категории предоставлять себя для просмотра (и, таким образом, какое количество категорий было бы идеальным значением), и так далее.)
Процедура:
@@ -707,7 +717,7 @@ PORTEPOCH= 1
** (в дополнение, вы можете включить другие файлы, требующие изменений, согласно процедуре из Руководства Коммиттера.)
. Поскольку это затрагивает инфраструктуру портов и охватывает не только выполнение репозиторного копирования, но также, возможно, и выполнение регрессивных тестов на кластере построения, то PR должна назначать себе {portmgr}.
-. Если этот PR одобрен, то коммиттеру нужно продолжить остальную часть процедуры, которая link:{committers-guide}#PORTS[изложена в Руководстве Коммиттера].
+. Если этот PR одобрен, то коммиттеру нужно продолжить остальную часть процедуры, которая extref:{committers-guide}[изложена в Руководстве Коммиттера, ports].
====
Предложение новой виртуальной категории должно быть схожим с вышеизложенным, но при этом затрагивать намного меньше, поскольку ни один из портов не будет перемещен в действительности. В этом случае единственными патчами, включенными в PR, будут те, что добавляют новую категорию в `CATEGORIES` каждого из затрагиваемых портов.
@@ -1211,7 +1221,7 @@ ALWAYS_KEEP_DISTFILES= yes
Заметьте, что в качестве значения для `MAINTAINER` допустимо использование только одного адреса без поля комментария. Должен использоваться формат `user@hostname.domain`. Пожалуйста, не включайте никакого описательного текста, например, вашего настоящего имени в эту строку-это несколько сбивает с толку [.filename]#bsd.port.mk#.
-Сопровождающий ответственен за поддержание порта в актуальном состоянии и обеспечение правильной работы порта. За подробным описанием обязанностей сопровождающего порт обращайтесь к главе link:{contributing}#maintain-port/[The challenge for port maintainers].
+Сопровождающий ответственен за поддержание порта в актуальном состоянии и обеспечение правильной работы порта. За подробным описанием обязанностей сопровождающего порт обращайтесь к главе extref:{contributing}[The challenge for port maintainers, maintain-port].
Перед фиксацией в репозитории изменения в порте будут отправлены сопровождающему для просмотра и одобрения. Если сопровождающий порта не ответил на запрос пользователя об обновлении в течение двух недель (исключая большие праздники), то это можно считать тайм-аутом сопровождающего, и обновление может быть выполнено без явного подтверждения от сопровождающего. Если сопровождающий не отвечает в течение трёх месяцев, то считается, что он отсутствует, и как сопровождающий порта, о котором идёт речь, может быть заменён. Исключениями из этого правила является всё, что сопровождает {portmgr} или {security-officer}. Запрещено делать любые несанкционированные изменения в портах, которые ведут эти группы.
diff --git a/documentation/content/ru/books/porters-handbook/new-port/chapter.adoc b/documentation/content/ru/books/porters-handbook/new-port/chapter.adoc
index 316d15a4f6..43b61bce99 100644
--- a/documentation/content/ru/books/porters-handbook/new-port/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/new-port/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/quick-porting
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Итак, вы интересуетесь, как создать собственный порт или обновить существующий? Великолепно!
diff --git a/documentation/content/ru/books/porters-handbook/pkg-files/chapter.adoc b/documentation/content/ru/books/porters-handbook/pkg-files/chapter.adoc
index d24b172a7d..5f98929394 100644
--- a/documentation/content/ru/books/porters-handbook/pkg-files/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/pkg-files/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/testing
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Есть несколько приёмов работы с файлами [.filename]#pkg-*#, которые мы ещё не описали, но они иногда могут быть очень кстати.
diff --git a/documentation/content/ru/books/porters-handbook/plist/chapter.adoc b/documentation/content/ru/books/porters-handbook/plist/chapter.adoc
index 86369ed7cb..db57d34ca3 100644
--- a/documentation/content/ru/books/porters-handbook/plist/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/plist/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/pkg-files
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[plist-sub]]
== Изменение содержимого [.filename]#pkg-plist# в зависимости от make-переменных
diff --git a/documentation/content/ru/books/porters-handbook/porting-dads/chapter.adoc b/documentation/content/ru/books/porters-handbook/porting-dads/chapter.adoc
index d9e73bd5b7..1960a211a4 100644
--- a/documentation/content/ru/books/porters-handbook/porting-dads/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/porting-dads/chapter.adoc
@@ -11,38 +11,48 @@ next: books/porters-handbook/porting-samplem
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:freebsd-version: __FreeBSD_version
:freebsd: __FreeBSD__
-:sectnumoffset: 12
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dads-intro]]
== Введение
-Вот список часто встречающихся действий, которые нужно и которые нельзя делать во время процесса портирования. Проверьте порт по этому списку, и также проверьте порты в http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[базе сообщений PR], которые присланы другими людьми. Присылайте любые комментарии о портах, которые вы проверили, так, как это описано в статье о link:{contributing}#CONTRIB-GENERAL[ Сообщениях об ошибках и общих замечаниях]. Проверка портов в базе сообщений PR позволит нам быстрее коммиттить их и удостовериться, что вы знаете, что делаете.
+Вот список часто встречающихся действий, которые нужно и которые нельзя делать во время процесса портирования. Проверьте порт по этому списку, и также проверьте порты в http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[базе сообщений PR], которые присланы другими людьми. Присылайте любые комментарии о портах, которые вы проверили, так, как это описано в статье о extref:{contributing}[Сообщениях об ошибках и общих замечаниях, CONTRIB-GENERAL]. Проверка портов в базе сообщений PR позволит нам быстрее коммиттить их и удостовериться, что вы знаете, что делаете.
[[porting-wrkdir]]
== `WRKDIR`
-Не пишите ничего в файлы вне каталога `WRKDIR`. Каталог `WRKDIR` является единственным местом, которое гарантированно будет доступно для записи во время построения порта (обратитесь к главе об link:{handbook}#PORTS-CD[установке портов с CDROM] за примером построения портов из дерева, доступного только для чтения). Если вам нужно изменить какой-либо из файлов [.filename]##pkg-*##, сделайте это, <<porting-pkgfiles,переопределив переменную>>, но не перезаписывая их.
+Не пишите ничего в файлы вне каталога `WRKDIR`. Каталог `WRKDIR` является единственным местом, которое гарантированно будет доступно для записи во время построения порта (обратитесь к главе об extref:{handbook}ports[установке портов с CDROM, PORTS-CD] за примером построения портов из дерева, доступного только для чтения). Если вам нужно изменить какой-либо из файлов [.filename]##pkg-*##, сделайте это, <<porting-pkgfiles,переопределив переменную>>, но не перезаписывая их.
[[porting-wrkdirprefix]]
== `WRKDIRPREFIX`
diff --git a/documentation/content/ru/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/ru/books/porters-handbook/porting-samplem/chapter.adoc
index d6c984a099..62b7c06914 100644
--- a/documentation/content/ru/books/porters-handbook/porting-samplem/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/porting-samplem/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/keeping-up
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Вот примерный [.filename]#Makefile#, который можно использовать при создании нового порта. Обязательно удалите все дополнительные комментарии (те, которые в скобках)!
diff --git a/documentation/content/ru/books/porters-handbook/porting-why/chapter.adoc b/documentation/content/ru/books/porters-handbook/porting-why/chapter.adoc
index 3826351cc4..ad292b3d14 100644
--- a/documentation/content/ru/books/porters-handbook/porting-why/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/porting-why/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/new-port
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Коллекция портов FreeBSD является способом, используемым практически каждым для установки приложений ("портов") на FreeBSD. Как и почти всё остальное во FreeBSD, эта система в основном является добровольно поддерживаемым начинанием. Важно иметь это в виду при чтении данного документа.
diff --git a/documentation/content/ru/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/ru/books/porters-handbook/quick-porting/chapter.adoc
index 820f5cc187..87e1275c42 100644
--- a/documentation/content/ru/books/porters-handbook/quick-porting/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/quick-porting/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/slow-porting
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
В этом разделе описано, как создать новый порт на скорую руку. Во многих случаях этого бывает не достаточно, так что вам нужно будет прочитать документ дальше.
@@ -217,7 +227,7 @@ PLIST_DIRS= lib/X11/oneko
Затем получите файл man:shar[1]. Предполагая, что порт называется oneko, перейдите в каталог выше, где находится каталог `oneko`, и наберите: `shar find oneko > oneko.shar`
-Включите [.filename]#oneko.shar# в сообщение об ошибке и пошлите его с помощью man:send-pr[1]. Обратитесь к разделу link:{contributing}#CONTRIB-GENERAL[Сообщения об ошибках и общие замечания] для получения подробной информации о man:send-pr[1]).
+Включите [.filename]#oneko.shar# в сообщение об ошибке и пошлите его с помощью man:send-pr[1]. Обратитесь к разделу extref:{contributing}[Сообщения об ошибках и общие замечания, CONTRIB-GENERAL] для получения подробной информации о man:send-pr[1]).
Укажите в сообщении категорию `ports` и класс `change-request`. _Не_ указывайте, что сообщение имеет статус `confidential`! Добавьте краткое описание программы в поле "Description" отправляемого PR (например, содержимое `COMMENT` в сокращённом варианте) и сам файл в виде архива [.filename]#.shar# в поле "Fix".
@@ -230,4 +240,4 @@ PLIST_DIRS= lib/X11/oneko
После отправки порта, пожалуйста, потерпите. Время, необходимое для включения нового порта во FreeBSD, может занимать от нескольких дней до нескольких месяцев. http://www.FreeBSD.org/cgi/query-pr-summary.cgi?category=ports[ Здесь] можно увидеть список ожидающих PR для портов.
-После рассмотрения нового порта мы при необходимости вам ответим, а затем включим порт в наше дерево. Ваше имя также будет добавлено в список link:{contributors}#contrib-additional/[Дополнительных контрибуторов проекта FreeBSD] и другие файлы.
+После рассмотрения нового порта мы при необходимости вам ответим, а затем включим порт в наше дерево. Ваше имя также будет добавлено в список extref:{contributors}[Дополнительных контрибуторов проекта FreeBSD, contrib-additional] и другие файлы.
diff --git a/documentation/content/ru/books/porters-handbook/security/chapter.adoc b/documentation/content/ru/books/porters-handbook/security/chapter.adoc
index bb78f84cf1..a9b6e5a63f 100644
--- a/documentation/content/ru/books/porters-handbook/security/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/security/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/porting-dads
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-intro]]
== Почему безопасность так важна
diff --git a/documentation/content/ru/books/porters-handbook/slow-porting/chapter.adoc b/documentation/content/ru/books/porters-handbook/slow-porting/chapter.adoc
index d0baaf0906..1d7cbc61e7 100644
--- a/documentation/content/ru/books/porters-handbook/slow-porting/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/slow-porting/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/makefiles
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Итак, все оказалось не так уж и просто, и порт потребовал некоторых модификаций для того, чтобы заставить его работать. В этом разделе мы расскажем, шаг за шагом, как его модифицировать, чтобы он работал с нашей системой портов.
diff --git a/documentation/content/ru/books/porters-handbook/special/chapter.adoc b/documentation/content/ru/books/porters-handbook/special/chapter.adoc
index 88ea8112df..c46eb9a002 100644
--- a/documentation/content/ru/books/porters-handbook/special/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/special/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/plist
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Имеется ещё несколько вещей, которые вы должны иметь в виду при создании порта. Этот раздел описывает наиболее часто встречающиеся из них.
@@ -2381,7 +2391,7 @@ USE_XFCE= mcsmanager configenv
[[rc-scripts]]
== Запуск и остановка служб (сценарии `rc`)
-Сценарии [.filename]#rc.d# используются для запуска служб при запуске системы и дают администратору стандартный способ остановки, запуска и перезапуска службы. Порты интегрируются в системную инфраструктуру [.filename]#rc.d#. Подробности по её использованию можно найти в link:{handbook}#configtuning-rcd/[главе rc.d Руководства]. Подробное объяснение доступных команд находится в man:rc[8] и man:rc.subr[8]. Наконец, есть link:{rc-scripting}[статья]о практических аспектах написания сценариев [.filename]#rc.d#.
+Сценарии [.filename]#rc.d# используются для запуска служб при запуске системы и дают администратору стандартный способ остановки, запуска и перезапуска службы. Порты интегрируются в системную инфраструктуру [.filename]#rc.d#. Подробности по её использованию можно найти в extref:{handbook}config-tuning/[главе rc.d Руководства, configtuning-rcd]. Подробное объяснение доступных команд находится в man:rc[8] и man:rc.subr[8]. Наконец, есть extref:{rc-scripting}[статья]о практических аспектах написания сценариев [.filename]#rc.d#.
Установить можно один или более сценариев [.filename]#rc.d#:
diff --git a/documentation/content/ru/books/porters-handbook/testing/chapter.adoc b/documentation/content/ru/books/porters-handbook/testing/chapter.adoc
index 76a490ef8c..98b7c82e1f 100644
--- a/documentation/content/ru/books/porters-handbook/testing/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/testing/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/upgrading
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[make-describe]]
== Запуск `make describe`
diff --git a/documentation/content/ru/books/porters-handbook/upgrading/chapter.adoc b/documentation/content/ru/books/porters-handbook/upgrading/chapter.adoc
index 4efbe63a5a..8996df3362 100644
--- a/documentation/content/ru/books/porters-handbook/upgrading/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/upgrading/chapter.adoc
@@ -11,28 +11,38 @@ next: books/porters-handbook/security
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
-Если вы заметите, что ваш порт устарел по сравнению с последней авторской версией, первым делом вы должны получить самую последнюю версия порта. Вы можете найти их в каталоге [.filename]#ports/ports-current# на зеркальных FTP-серверах FreeBSD. Однако если вы работаете с достаточно большим количеством портов, наверное, будет проще использовать Subversion или man:portsnap[8] для поддержания всей коллекции портов в актуальном состоянии, как это описано в link:{handbook}#ports-using/[Руководстве]. К тому же это даст возможность отслеживать все зависимости портов.
+Если вы заметите, что ваш порт устарел по сравнению с последней авторской версией, первым делом вы должны получить самую последнюю версия порта. Вы можете найти их в каталоге [.filename]#ports/ports-current# на зеркальных FTP-серверах FreeBSD. Однако если вы работаете с достаточно большим количеством портов, наверное, будет проще использовать Subversion или man:portsnap[8] для поддержания всей коллекции портов в актуальном состоянии, как это описано в extref:{handbook}ports/[Руководстве, ports-using]. К тому же это даст возможность отслеживать все зависимости портов.
На следующем шаге необходимо выяснить, нет ожидает ли уже это обновление своей очереди. Для этого у вас есть две возможности. Существует интерфейс к http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[базе данных сообщений о проблемах FreeBSD (PR)] (известной также как `GNATS`) с поисковыми возможностями. Выберите из выпадающего списка `ports` и введите название порта.
@@ -53,11 +63,11 @@ toc::[]
Для упрощения повторяющихся операций с файлами заплаток вы можете воспользоваться скриптом [.filename]#/usr/ports/Tools/scripts/patchtool.py#. Перед тем, как его запускать, пожалуйста, прочтите [.filename]#/usr/ports/Tools/scripts/README.patchtool#.
-Если порт никем не поддерживается, а вы активно его используете, пожалуйста, подумайте над тем, чтобы добровольно стать его сопровождающим. Во FreeBSD имеется более 4000 портов без поддержки, и это как раз та область, где всегда нужны добровольцы. (Детальное описание обязанностей сопровождающего можно найти в разделе link:{developers-handbook}#POLICIES-MAINTAINER[Руководства Разработчика].)
+Если порт никем не поддерживается, а вы активно его используете, пожалуйста, подумайте над тем, чтобы добровольно стать его сопровождающим. Во FreeBSD имеется более 4000 портов без поддержки, и это как раз та область, где всегда нужны добровольцы. (Детальное описание обязанностей сопровождающего можно найти в разделе extref:{developers-handbook}[Руководства Разработчика, POLICIES-MAINTAINER].)
Лучше всего послать нам diff-файл, включив его в посылку по команде man:send-pr[1] (категория `ports`). Если вы сопровождаете порт, обязательно поместите текст `[maintainer update]` в начале строки описания и задайте в поле "Class" вашего PR строчку `maintainer-update`. В противном случае в поле "Class" вашего PR должно быть указано `change-request`. Будьте добры, в сообщении отметьте все добавленные или удалённые файлы, так как они будут непосредственно указаны man:svn[1] при выполнении операции коммита. Если diff-файл имеет размер, превышающий 20КБ, сожмите его и обработайте утилитой uuencode; в противном случае просто включите его как есть в PR.
-Прежде чем пользоваться man:send-pr[1] просмотрите раздел о link:{problem-reports}#pr-writing/[Написании сообщений о проблемах] в статье о Сообщениях об ошибках. Он содержит гораздо больше информации о том, как писать полезные сообщения о проблемах.
+Прежде чем пользоваться man:send-pr[1] просмотрите раздел о extref:{problem-reports}[Написании сообщений о проблемах, pr-writing] в статье о Сообщениях об ошибках. Он содержит гораздо больше информации о том, как писать полезные сообщения о проблемах.
[IMPORTANT]
====
@@ -85,7 +95,7 @@ toc::[]
<.> Это может быть где угодно; место, в котором производится построение портов, не привязано к [.filename]#/usr/ports/#.
-<.> https://svn0.us-west.FreeBSD.org/[svn0.us-west.FreeBSD.org] - это общедоступный сервер Subversion. Выберите ближайшее зеркало и проверьте сертификат зеркалирующего сервера на наличие в перечне link:{handbook}#svn-mirrors/[зеркалирующих сайтов Subversion].
+<.> https://svn0.us-west.FreeBSD.org/[svn0.us-west.FreeBSD.org] - это общедоступный сервер Subversion. Выберите ближайшее зеркало и проверьте сертификат зеркалирующего сервера на наличие в перечне extref:{handbook}mirrors/[зеркалирующих сайтов Subversion, svn-mirrors].
Находясь в рабочем каталоге, вносите любые изменения, которые обычно делают для порта. При добавлении или удалении файла используйте `svn` для отслеживания этих изменений:
diff --git a/documentation/content/ru/books/porters-handbook/uses/chapter.adoc b/documentation/content/ru/books/porters-handbook/uses/chapter.adoc
index fa5d32de3f..2862084668 100644
--- a/documentation/content/ru/books/porters-handbook/uses/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/uses/chapter.adoc
@@ -11,27 +11,37 @@ next: books/porters-handbook/versions
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:c-plus-plus: c++
-:sectnumoffset: 15
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[uses-intro]]
== An Introduction to `USES`
diff --git a/documentation/content/ru/books/porters-handbook/versions/chapter.adoc b/documentation/content/ru/books/porters-handbook/versions/chapter.adoc
index f9234dac57..5878273db8 100644
--- a/documentation/content/ru/books/porters-handbook/versions/chapter.adoc
+++ b/documentation/content/ru/books/porters-handbook/versions/chapter.adoc
@@ -10,26 +10,36 @@ prev: books/porters-handbook/uses
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: Содержание
-:table-caption: Таблица
-:figure-caption: Рисунок
-:example-caption: Пример
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/ru/mailing-lists.adoc[]
-include::shared/ru/teams.adoc[]
-include::shared/ru/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Here is a convenient list of `__FreeBSD_version` values as defined in http://svnweb.FreeBSD.org/base/head/sys/sys/param.h?view=markup[sys/param.h]:
diff --git a/documentation/content/tr/articles/explaining-bsd/_index.adoc b/documentation/content/tr/articles/explaining-bsd/_index.adoc
index df52116f0d..4496e6b61a 100644
--- a/documentation/content/tr/articles/explaining-bsd/_index.adoc
+++ b/documentation/content/tr/articles/explaining-bsd/_index.adoc
@@ -3,7 +3,6 @@ title: BSD Nedir?
authors:
- author: Greg Lehey
email: grog@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "apple", "xfree86", "linux", "opengroup", "sun", "general"]
---
@@ -16,6 +15,27 @@ trademarks: ["freebsd", "apple", "xfree86", "linux", "opengroup", "sun", "genera
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
+:images-path: articles/explaining-bsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
Özet
diff --git a/documentation/content/zh-cn/articles/contributing/_index.adoc b/documentation/content/zh-cn/articles/contributing/_index.adoc
index a7ece340a7..dfd55a43bc 100644
--- a/documentation/content/zh-cn/articles/contributing/_index.adoc
+++ b/documentation/content/zh-cn/articles/contributing/_index.adoc
@@ -2,7 +2,6 @@
title: 为 FreeBSD 提供帮助
authors:
- author: Jordan Hubbard
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ieee", "general"]
---
@@ -15,26 +14,26 @@ trademarks: ["freebsd", "ieee", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/urls.adoc[]
+:images-path: articles/contributing/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/zh-cn/mailing-lists.adoc[]
-include::../../../../shared/zh-cn/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/zh-cn/mailing-lists.adoc[]
-include::../../../../shared/zh-cn/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -65,7 +64,7 @@ FreeBSD 项目处理的是一个完整的操作系统环境, 而不只是一
很多参加FreeBSD项目的人不是程序员。 这个项目里有文档撰写者、 网页设计师、 以及技术支持人员。 对于这些志愿者来说, 他们只需要贡献一些时间, 并且具有学习的意愿。
. 您可以经常通读FAQ和手册, 如果您发现了繁琐的解释, 或者是过时的知识, 甚至完全不正确的地方, 都请告诉我们。 如果您能顺手把他们改过来那就更好了 (SGML其实并不难学, 但我们也不反对您直接提交 ASCII 的版本)。
-. 帮助我们把 FreeBSD 文档翻译成您的母语。 如果您的母语版本已经存在了, 您也可以翻译一些其他的文档或者检查那些已有的文档是否是最新更新过的。 您可以先简单看看 FreeBSD 文档计划中有关 link:{fdp-primer}#translations[翻译的常见问题]。 参加翻译工作并不是说您要孤军奋战翻译所有的 FreeBSD 文档。 作为一个志愿者, 做多少工作完全取决于您的意愿。 一旦某个人开始翻译了, 其他人几乎一定会参与到这些工作中来。 如果您只有有限的时间或者精力去翻译部分文档, 您可以首先去翻译安装指南。
+. 帮助我们把 FreeBSD 文档翻译成您的母语。 如果您的母语版本已经存在了, 您也可以翻译一些其他的文档或者检查那些已有的文档是否是最新更新过的。 您可以先简单看看 FreeBSD 文档计划中有关 extref:{fdp-primer}[翻译的常见问题, translations]。 参加翻译工作并不是说您要孤军奋战翻译所有的 FreeBSD 文档。 作为一个志愿者, 做多少工作完全取决于您的意愿。 一旦某个人开始翻译了, 其他人几乎一定会参与到这些工作中来。 如果您只有有限的时间或者精力去翻译部分文档, 您可以首先去翻译安装指南。
. 阅读 {freebsd-questions} 并偶尔看一看 link:news:comp.unix.bsd.freebsd.misc[comp.unix.bsd.freebsd.misc] (甚至有规律地这样做)。 与别人分享您的专业知识, 并帮助他们解决问题是一件令人愉悦的事情; 有些时候您甚至可以在这个过程中学到一些新东西! 这些论坛有时也会为您提供一些有价值的主意。
[[ongoing-programmer-tasks]]
@@ -102,7 +101,7 @@ link:https://www.FreeBSD.org/projects/ideas/[FreeBSD 志愿者项目和点子清
[[contrib-general]]
=== 错误报告和一般的注解
-通常, _一般意义上的_ 技术想法和建议应该发到 {freebsd-hackers}。 同样地, 对于这些东西有兴趣的人 (当然, 他们同时还要能够容忍 _大量的_ 邮件!) 可以考虑订阅 {freebsd-hackers}。 参见 link:{handbook}#eresources-mail[FreeBSD 使用手册] 以了解关于这个邮件列表, 以及其它邮件列表的详细情况。
+通常, _一般意义上的_ 技术想法和建议应该发到 {freebsd-hackers}。 同样地, 对于这些东西有兴趣的人 (当然, 他们同时还要能够容忍 _大量的_ 邮件!) 可以考虑订阅 {freebsd-hackers}。 参见 extref:{handbook}eresources[FreeBSD 使用手册, eresources-mail] 以了解关于这个邮件列表, 以及其它邮件列表的详细情况。
如果您发现了 bug 或者想要提交某些修改, 请通过 man:send-pr[1] 程序或使用 link:https://www.FreeBSD.org/send-pr/[基于 WEB 的提交页面] 来提交。 请试着填写 bug 报告的每一项。 一般来说, 我们建议在 bug 报告中直接附上补丁, 除非它超过了 65KB。 如果补丁可以直接应用到源代码上, 则建议您在报告的 synopsis 一栏写上 `[PATCH]`。 在附带补丁时, 请 _不要_ 通过复制和粘贴来进行, 因为这样做会把 tab 变成空格, 结果补丁很可能就不能用了。 如果补丁超过 20KB 很多, 应考虑将其压缩 (例如使用 man:gzip[1] 或 man:bzip2[1]) 之后用 man:uuencode[1] 进行编码之后再放进您的问题报告中。
@@ -110,15 +109,15 @@ link:https://www.FreeBSD.org/projects/ideas/[FreeBSD 志愿者项目和点子清
如果您在一段时间之后仍然没有收到确认信 (超过 3 天甚至 1 周, 这取决于您的邮件服务) 或者由于某种原因无法使用 man:send-pr[1] 命令, 则可以发信给 {freebsd-bugs} 要求别人代您发送它。
-请参见 link:{problem-reports}[这篇文章] 了解如何撰写好的问题报告。
+请参见 extref:{problem-reports}[这篇文章] 了解如何撰写好的问题报告。
=== 对于文档的修订
-对于文档的修改由 {freebsd-doc} 来审查。 请参见 link:{fdp-primer}[FreeBSD 文档计划初级读本] 来获得完整的指导。 请按照 <<contrib-general>> 中介绍的方法使用 man:send-pr[1] 来发送新的文档或者对于现有文档的完善 (哪怕是很小的改进也是欢迎的!)。
+对于文档的修改由 {freebsd-doc} 来审查。 请参见 extref:{fdp-primer}[FreeBSD 文档计划初级读本] 来获得完整的指导。 请按照 <<contrib-general>> 中介绍的方法使用 man:send-pr[1] 来发送新的文档或者对于现有文档的完善 (哪怕是很小的改进也是欢迎的!)。
=== 对于现有源代码的修改
-在现有代码上进行修改或增加功能在某种程度上是需要更多技巧的事情, 并且还和您对于目前 FreeBSD 的开发现状的了解有关。 有多种方式可以得到被称作 "FreeBSD-CURRENT" 的 FreeBSD 开发版本, 您可以通过它来了解最近的开发情况。 请参见 link:{handbook}#current-stable[FreeBSD 使用手册] 来了解使用 FreeBSD-CURRENT 的进一步详情。
+在现有代码上进行修改或增加功能在某种程度上是需要更多技巧的事情, 并且还和您对于目前 FreeBSD 的开发现状的了解有关。 有多种方式可以得到被称作 "FreeBSD-CURRENT" 的 FreeBSD 开发版本, 您可以通过它来了解最近的开发情况。 请参见 extref:{handbook}updating-upgrading[FreeBSD 使用手册, current-stable] 来了解使用 FreeBSD-CURRENT 的进一步详情。
在旧的代码上进行修改, 则通常可能由于代码已经过时, 或与新的开发版本差异太大而无法被重新集成到 FreeBSD 中。 如果您订阅了 {freebsd-announce} 以及 {freebsd-current} 邮件列表, 则可以通过它们来大体了解目前的开发状态。
@@ -243,4 +242,4 @@ FreeBSD 计划欢迎任何人捐赠可以使用的硬件。 如果您有兴趣
==== 捐赠 Internet 接入
-我们欢迎新的 FTP、 WWW 或 `cvsup` 镜像。 如果您希望成为这样的镜像, 请参见 link:{hubs}[如何架设 FreeBSD 镜像] 一文, 以了解进一步的情况。
+我们欢迎新的 FTP、 WWW 或 `cvsup` 镜像。 如果您希望成为这样的镜像, 请参见 extref:{hubs}[如何架设 FreeBSD 镜像] 一文, 以了解进一步的情况。
diff --git a/documentation/content/zh-cn/articles/leap-seconds/_index.adoc b/documentation/content/zh-cn/articles/leap-seconds/_index.adoc
index 822030ab7d..50533dc558 100644
--- a/documentation/content/zh-cn/articles/leap-seconds/_index.adoc
+++ b/documentation/content/zh-cn/articles/leap-seconds/_index.adoc
@@ -1,6 +1,5 @@
---
title: FreeBSD 对闰秒的支持
-releaseinfo: "$FreeBSD$"
---
= FreeBSD 对闰秒的支持
@@ -12,23 +11,26 @@ releaseinfo: "$FreeBSD$"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
-include::shared/zh-cn/urls.adoc[]
+:images-path: articles/leap-seconds/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/zh-cn/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/zh-cn/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -49,7 +51,7 @@ https://tools.ietf.org/html/rfc7164#section-3[RFC 7164] 描述了闰秒的标准
[[leapseconds-posix]]
== FreeBSD 对闰秒的默认处理方式
-处理闰秒最简单的方法是使用 FreeBSD 预设的 POSIX 时间规则, 以及 link:{handbook}#network-ntp[NTP]。如果 man:ntpd[8] 正在运行,并且时间和正确处理闰秒的上游 NTP 服务器同步,闰秒将使系统时间自动重复当天的最后一秒。不需要进行其它调整。
+处理闰秒最简单的方法是使用 FreeBSD 预设的 POSIX 时间规则, 以及 extref:{handbook}network-servers[NTP, network-ntp]。如果 man:ntpd[8] 正在运行,并且时间和正确处理闰秒的上游 NTP 服务器同步,闰秒将使系统时间自动重复当天的最后一秒。不需要进行其它调整。
如果上游的 NTP 服务器没有正确处理闰秒,man:ntpd[8] 会在错误的上游服务器发现错误并修正后,跟着加上一秒。
diff --git a/documentation/content/zh-cn/articles/linux-users/_index.adoc b/documentation/content/zh-cn/articles/linux-users/_index.adoc
index f96c358fef..764446d8d5 100644
--- a/documentation/content/zh-cn/articles/linux-users/_index.adoc
+++ b/documentation/content/zh-cn/articles/linux-users/_index.adoc
@@ -3,7 +3,6 @@ title: Linux® 用户的 FreeBSD 快速入门向导
authors:
- author: John Ferrell
copyright: 2008 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"]
---
@@ -16,23 +15,26 @@ trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
-include::shared/zh-cn/urls.adoc[]
+:images-path: articles/linux-users/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/zh-cn/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/zh-cn/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -49,14 +51,14 @@ toc::[]
本文档将突出介绍 FreeBSD 与 Linux(R) 的差别, 以使得那些 Linux(R) 高级用户能自己快速熟悉 FreeBSD 的基础内容。这只是份技术上的快速入门, 并非是试图描绘这两种操作系统之间的"哲学"上的差异。
-此文档假定认为你已经安装好了 FreeBSD。 如果你还没有安装 FreeBSD 或者对 FreeBSD 的安装过程方面需要帮助,请参考 FreeBSD 手册的 link:{handbook}#install[安装 FreeBSD] 一章。
+此文档假定认为你已经安装好了 FreeBSD。 如果你还没有安装 FreeBSD 或者对 FreeBSD 的安装过程方面需要帮助,请参考 FreeBSD 手册的 extref:{handbook}install[安装 FreeBSD, install] 一章。
[[shells]]
== Shell程序:没有Bash吗?
那些从 Linux(R) 转过来的用户经常会惊讶于 Bash 不是 FreeBSD 的默认 Shell。 事实上,Bash 甚至没有包括在 FreeBSD 的默认安装中。代替的是,FreeBSD 使用 man:tcsh[1] 作为自己的默认 Shell,尽管如此,Bash 和其他你喜爱的 Shell 程序在 FreeBSD 的 link:./#SOFTWARE[Packages 和 Ports 套件] 里都可以找到。
-如果你安装了其他的 Shell 你可以使用 man:chsh[1] 来设置一个用户的默认 Shell。 通常情况下, 强烈建议不要去更改 `root` 用户的默认 Shell。原因是这些 Shell 没有包括在基本系统中,正常情况下它们会被安装到 [.filename]#/usr/local/bin# 和 [.filename]#/usr/bin# 目录下。万一某天 [.filename]#/usr/local/bin# 和 [.filename]#/usr/bin# 的文件系统不能被挂载, 这样情况下 `root` 将不能进入自己默认的 Shell,从而 `root` 将不能够登录进去。 鉴于这个原因,第二个系统管理员帐户 `toor` 创建时使用的是非默认的 Shell。在安全 FAQ 可以查阅到关于 link:{faq}#TOOR-ACCOUNT[toor 帐户] 的信息。
+如果你安装了其他的 Shell 你可以使用 man:chsh[1] 来设置一个用户的默认 Shell。 通常情况下, 强烈建议不要去更改 `root` 用户的默认 Shell。原因是这些 Shell 没有包括在基本系统中,正常情况下它们会被安装到 [.filename]#/usr/local/bin# 和 [.filename]#/usr/bin# 目录下。万一某天 [.filename]#/usr/local/bin# 和 [.filename]#/usr/bin# 的文件系统不能被挂载, 这样情况下 `root` 将不能进入自己默认的 Shell,从而 `root` 将不能够登录进去。 鉴于这个原因,第二个系统管理员帐户 `toor` 创建时使用的是非默认的 Shell。在安全 FAQ 可以查阅到关于 extref:{faq}[toor 帐户, TOOR-ACCOUNT] 的信息。
[[software]]
== Packages和Ports:在 FreeBSD 中添加软件
@@ -92,14 +94,14 @@ in your /etc/rc.conf. Extra options can be found in startup script.
如果你正运行着 release 版本的 FreeBSD (6.2,6.3,7.0等, 通常从 CD-ROM 被安装的)`pkg_add -r` 会为其下载专门为这些特定版本构建好的软件包。 这些软件包 _可能_ 不是当前最新的程序。 你可以使用 `PACKAGESITE` 变量来覆盖默认的动作。 例如,把 `PACHAGESITE` 设置成 link:ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-6-stable/Latest/[ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-6-stable/Latest/] 来下载 6.X 系列最新的包。
====
-想了解更多的 packages 信息请查阅 FreeBSD 手册的 4.4 小节:link:{handbook}#packages-using[使用 Packages 系统]。
+想了解更多的 packages 信息请查阅 FreeBSD 手册的 4.4 小节:extref:{handbook}ports[使用 Packages 系统, packages-using]。
[[ports]]
=== Ports
FreeBSD 的第二种安装应用程序的方法就是使用 Ports 套件了。 Ports 套件是 FreeBSD 上的一个利用 [.filename]#Makefile# 和一些补丁文件来特定从源码定制安装各种软件程序的框架。 当安装一个 port 时系统会获取程序源码, 应用任何所需要的补丁,编译源码, 并安装应用程序(并针对依赖关系以同样的方式安装解决)。
-Ports 套件,常被称作 ports 树,可以在 [.filename]#/usr/ports# 下找到。 假设Ports套件已经在安装 FreeBSD 时安装过了。 如果 Ports 套件还没有被安装可以通过 man:sysinstall[8] 来进行安装,或者使用 man:csup[1] 或 man:portsnap[8] 来从 FreeBSD 的服务器上面拉下来。在手册的 link:{handbook}#ports-using[4.5.1 小节] 可以找到安装 Ports 套件的详细介绍。
+Ports 套件,常被称作 ports 树,可以在 [.filename]#/usr/ports# 下找到。 假设Ports套件已经在安装 FreeBSD 时安装过了。 如果 Ports 套件还没有被安装可以通过 man:sysinstall[8] 来进行安装,或者使用 man:csup[1] 或 man:portsnap[8] 来从 FreeBSD 的服务器上面拉下来。在手册的 extref:{handbook}ports[4.5.1 小节, ports-using] 可以找到安装 Ports 套件的详细介绍。
安装一个 port 就像进入 port 的目录并开始构建过程一样简单(通常情况下), 下面是从 Ports 套件安装 Apache 2.2 的例子:
@@ -117,7 +119,7 @@ Ports 套件,常被称作 ports 树,可以在 [.filename]#/usr/ports# 下找
# make WITH_LDAP="YES" install clean
....
-请查看 FreeBSD 手册的 4.5 小节,link:{handbook}#ports-using[使用 Ports Collection], 以获取更多关于Ports Collection 的信息。
+请查看 FreeBSD 手册的 4.5 小节,extref:{handbook}ports[使用 Ports Collection, ports-using], 以获取更多关于Ports Collection 的信息。
[[which]]
=== Ports还是packages,我应该使用哪个?
@@ -223,9 +225,9 @@ ifconfig_em0="DHCP"
像 Linux(R) 中的 IPTABLES 一样, FreeBSD 也提供了一个内核级的防火墙; 实际上 FreeBSD 提供了三个防火墙:
-* link:{handbook}#firewalls-ipfw[IPFIREWALL]
-* link:{handbook}#firewalls-ipf[IPFILTER]
-* link:{handbook}#firewalls-pf[handbook]
+* extref:{handbook}firewalls[IPFIREWALL, firewalls-ipfw]
+* extref:{handbook}firewalls[IPFILTER, firewalls-ipf]
+* extref:{handbook}firewalls[PF, firewalls-pf]
IPFIREWALL 或是 IPFW(管理 IPFW 规则的 man:ipfw[8] 命令) 是 FreeBSD 开发者开发并维持的。 IPFW 能够与 man:dummynet[4] 配合使用来提供流量图形功能以及模拟不同网络连接类型的功能。
@@ -259,7 +261,7 @@ pass in on $ext_if inet proto tcp from any to ($ext_if) port 22
共有三种方法来升级 FreeBSD 系统: 源码,二进制更新,还有安装光盘。
-从源码升级是最复杂的升级方法,但是提供了最棒的总体灵活性。 这个过程包含了使用 FreeBSD CVS (并行版本系统)来同步一个本地的 FreeBSD 源代码。 一旦本地源码已经更新到当前最新你便可以构建新版本的内核以及应用程序。 关于源码更新的更多信息可见于 FreeBSD 手册 link:{handbook}#cutting-edge[关于如何更新操作系统的章节]。
+从源码升级是最复杂的升级方法,但是提供了最棒的总体灵活性。 这个过程包含了使用 FreeBSD CVS (并行版本系统)来同步一个本地的 FreeBSD 源代码。 一旦本地源码已经更新到当前最新你便可以构建新版本的内核以及应用程序。 关于源码更新的更多信息可见于 FreeBSD 手册 extref:{handbook}[关于如何更新操作系统的章节, cutting-edge]。
二进制更新类似于使用 `yum` 或 `apt-get` 更新 Linux(R) 系统。man:freebsd-update[8] 命令会获取新的更新并安装它们。 这些更新可以通过 man:cron[8] 使用程序来调度。
@@ -317,7 +319,7 @@ kern.posix1version: 200112
某些 `sysctl` 的参数是只读的。
====
-需要 procfs 的情况是,运行一些较老的软件,使用 man:truss[1] 来跟踪系统信号,以及 link:{handbook}#linuxemu[Linux® 二进制兼容]. (尽管,Linux(R) 二进制兼容性使用其本身的 procfs,man:linprocfs[5]。) 如果你需要挂载 procfs 你可以在 [.filename]#/etc/fstab# 中加入如下内容:
+需要 procfs 的情况是,运行一些较老的软件,使用 man:truss[1] 来跟踪系统信号,以及 extref:{handbook}linuxemu[Linux® 二进制兼容, linuxemu]. (尽管,Linux(R) 二进制兼容性使用其本身的 procfs,man:linprocfs[5]。) 如果你需要挂载 procfs 你可以在 [.filename]#/etc/fstab# 中加入如下内容:
[source,shell]
....
@@ -392,4 +394,4 @@ proc /proc procfs rw,noauto 0 0
[[conclusion]]
== 总结
-非常希望这篇文档能够给予你足够的帮助来开始你的 FreeBSD 之路。务必要再去看一下 link:{handbook}[FreeBSD 手册] 所提到的但并没有被包含在本文档中的那些更深入广泛的主题。
+非常希望这篇文档能够给予你足够的帮助来开始你的 FreeBSD 之路。务必要再去看一下 extref:{handbook}[FreeBSD 手册] 所提到的但并没有被包含在本文档中的那些更深入广泛的主题。
diff --git a/documentation/content/zh-cn/articles/nanobsd/_index.adoc b/documentation/content/zh-cn/articles/nanobsd/_index.adoc
index 93b5b8b031..dd72da146b 100644
--- a/documentation/content/zh-cn/articles/nanobsd/_index.adoc
+++ b/documentation/content/zh-cn/articles/nanobsd/_index.adoc
@@ -3,7 +3,6 @@ title: NanoBSD 简介
authors:
- author: Daniel Gerzo
copyright: 2006 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -16,23 +15,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
+:images-path: articles/nanobsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
diff --git a/documentation/content/zh-cn/articles/rc-scripting/_index.adoc b/documentation/content/zh-cn/articles/rc-scripting/_index.adoc
index 0cd4c5394c..f2e475eab6 100644
--- a/documentation/content/zh-cn/articles/rc-scripting/_index.adoc
+++ b/documentation/content/zh-cn/articles/rc-scripting/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Yar Tikhiy
email: yar@FreeBSD.org
copyright: 2005-2006, 2012 The FreeBSD Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "netbsd", "general"]
---
@@ -17,23 +16,26 @@ trademarks: ["freebsd", "netbsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
-include::shared/zh-cn/urls.adoc[]
+:images-path: articles/rc-scripting/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/zh-cn/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/zh-cn/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -434,7 +436,7 @@ fi
[[rcng-hookup]]
== 链接脚本到 rc.d 框架
-当编写好了一个脚本,它需要被整合到 [.filename]#rc.d# 中去。 一个重要的步骤就是安装脚本到 [.filename]#/etc/rc.d# (对基本系统而言)或 [.filename]#/usr/local/etc/rc.d# (对ports而言)中去。在 [.filename]#bsd.prog.mk# 和 [.filename]#bsd.port.mk# 中都为此提供了方便的接口, 通常你不必担心适当的所有权限和模式。系统脚本应当是通过可以在 [.filename]#src/etc/rc.d# 找到的 [.filename]#Makefile# 安装的。Port 脚本可以像 link:{porters-handbook}#rc-scripts[Porter's Handbook] 中描述那样通过使用 `USE_RC_SUBR` 来被安装。
+当编写好了一个脚本,它需要被整合到 [.filename]#rc.d# 中去。 一个重要的步骤就是安装脚本到 [.filename]#/etc/rc.d# (对基本系统而言)或 [.filename]#/usr/local/etc/rc.d# (对ports而言)中去。在 [.filename]#bsd.prog.mk# 和 [.filename]#bsd.port.mk# 中都为此提供了方便的接口, 通常你不必担心适当的所有权限和模式。系统脚本应当是通过可以在 [.filename]#src/etc/rc.d# 找到的 [.filename]#Makefile# 安装的。Port 脚本可以像 extref:{porters-handbook}[Porter's Handbook, rc-scripts] 中描述那样通过使用 `USE_RC_SUBR` 来被安装。
不过,我们应该预先考虑到我们脚本在系统启动顺序中的位置。 我们的脚本所处理的服务可能依赖于其它的服务。举个例子, 没有网络接口和路由选择的启用运行的话,一个网络守护进程是不起作用的。 即使一个服务看似什么都不需要,在基本文件系统检查挂载完毕之前也很难启动。
diff --git a/documentation/content/zh-cn/articles/remote-install/_index.adoc b/documentation/content/zh-cn/articles/remote-install/_index.adoc
index dfbd64cd6b..2804e1a1e8 100644
--- a/documentation/content/zh-cn/articles/remote-install/_index.adoc
+++ b/documentation/content/zh-cn/articles/remote-install/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Daniel Gerzo
email: danger@FreeBSD.org
copyright: 2008 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -17,26 +16,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
+:images-path: articles/remote-install/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/zh-cn/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/zh-cn/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -193,7 +192,7 @@ mfsBSD 成功被引导后它就应该能够通过 man:ssh[1] 登入了。这一
# dd if=/dev/zero of=/dev/ad0 count=2
....
-下面,使用你喜欢的工具创建 slices 并标记磁盘 label。 比较简单的方法是使用 Sysinstall, 强大也可能几乎没有漏洞方法是使用标准的基于文本的 UNIX(R) 工具, 类似于 man:fdisk[8] 和 man:bsdlabel[8] 这些工具的使用也会在这一节中包括。前者已经被包括在 FreeBSD 手册的 link:{handbook}#install-steps[安装FreeBSD] 一章中了。如本节中刚提到的,这篇文章会展示如何设置一个带有 RAID-1 和 ZFS 性能的系统。我们的设置由一个小工具 man:gmirror[8] 镜像为 [.filename]#/# (root), [.filename]#/usr# 和 [.filename]#/var# 文件系统, 并把剩余的磁盘空间被分配为 man:zpool[8] 镜像出的 ZFS 文件系统。请注意, ZFS 文件系统将在 FreeBSD 操作系统成功安装并启动后才会被配置。
+下面,使用你喜欢的工具创建 slices 并标记磁盘 label。 比较简单的方法是使用 Sysinstall, 强大也可能几乎没有漏洞方法是使用标准的基于文本的 UNIX(R) 工具, 类似于 man:fdisk[8] 和 man:bsdlabel[8] 这些工具的使用也会在这一节中包括。前者已经被包括在 FreeBSD 手册的 extref:{handbook}install-steps[安装FreeBSD, install] 一章中了。如本节中刚提到的,这篇文章会展示如何设置一个带有 RAID-1 和 ZFS 性能的系统。我们的设置由一个小工具 man:gmirror[8] 镜像为 [.filename]#/# (root), [.filename]#/usr# 和 [.filename]#/var# 文件系统, 并把剩余的磁盘空间被分配为 man:zpool[8] 镜像出的 ZFS 文件系统。请注意, ZFS 文件系统将在 FreeBSD 操作系统成功安装并启动后才会被配置。
下面的例子会描述如何去创建 slices 和 labels, 在每个 partition 上初始化 man:gmirror[8] 并如何在每个被镜像过的 partition 上创建 UFS2 文件系统:
diff --git a/documentation/content/zh-cn/books/arch-handbook/_index.adoc b/documentation/content/zh-cn/books/arch-handbook/_index.adoc
index 4e313d6849..2c20857249 100644
--- a/documentation/content/zh-cn/books/arch-handbook/_index.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/_index.adoc
@@ -4,8 +4,8 @@ authors:
- author: The FreeBSD Documentation Project
- author: FreeBSD 中文计划
copyright: Copyright © 2000-2006, 2012-2013 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "apple", "microsoft", "unix", "general"]
+trademarks: ["freebsd", "apple", "microsoft", "unix", "general"]
+isIndex: true
---
= FreeBSD 系统结构手册
@@ -13,50 +13,34 @@ trademarks: ["freebsd", "apple", "microsoft", "unix", "general"]
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:book: true
+:pdf: false
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
-:chapters-path: content/zh-cn/books/arch-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/arch-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/zh-cn/mailing-lists.adoc[]
-include::../../../../shared/zh-cn/teams.adoc[]
-include::../../../../shared/zh-cn/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/zh-cn/mailing-lists.adoc[]
-include::../../../../shared/zh-cn/teams.adoc[]
-include::../../../../shared/zh-cn/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -64,7 +48,7 @@ endif::[]
欢迎您阅读 FreeBSD系统结构手册。 这本手册还在不断由许多人_继续书写_。 许多章节还是空白,有的章节亟待更新。 如果您对这个项目感兴趣并愿意有所贡献,请发信给 {freebsd-doc}。
-本文档的最新英文原始版本可从 link:https:://www.FreeBSD.org[FreeBSD Web 站点] 获得, 由 link:http://www.FreeBSD.org.cn/[http://www.FreeBSD.org.cn] 维护的最新译本可以在 link:http://cnsnap.cn.FreeBSD.org/zh-cn/[http://www.FreeBSD.org.cn 快照 Web 站点] 和 link:http://cnsnap.cn.FreeBSD.org/doc/zh_CN.UTF-8/[http://www.FreeBSD.org.cn 文档快照] 处获得, 这一译本会不断向主站同步。 此外, 您也可以从 link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[FreeBSD FTP 服务器] 或众多的 link:{handbook}#mirrors-ftp/[镜像站点] 得到这份文档的各种其他格式以及压缩形式的版本。
+本文档的最新英文原始版本可从 link:https:://www.FreeBSD.org[FreeBSD Web 站点] 获得, 由 link:http://www.FreeBSD.org.cn/[http://www.FreeBSD.org.cn] 维护的最新译本可以在 link:http://cnsnap.cn.FreeBSD.org/zh-cn/[http://www.FreeBSD.org.cn 快照 Web 站点] 和 link:http://cnsnap.cn.FreeBSD.org/doc/zh_CN.UTF-8/[http://www.FreeBSD.org.cn 文档快照] 处获得, 这一译本会不断向主站同步。 此外, 您也可以从 link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[FreeBSD FTP 服务器] 或众多的 extref:{handbook}mirrors/[镜像站点, mirrors-ftp] 得到这份文档的各种其他格式以及压缩形式的版本。
'''
@@ -73,28 +57,28 @@ toc::[]
[[kernel]]
= 内核
-include::{chapters-path}boot/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}locking/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}kobj/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}jail/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}sysinit/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}mac/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}vm/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}smp/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
+include::{chapters-path}boot/chapter.adoc[leveloffset=+1]
+include::{chapters-path}locking/chapter.adoc[leveloffset=+1]
+include::{chapters-path}kobj/chapter.adoc[leveloffset=+1]
+include::{chapters-path}jail/chapter.adoc[leveloffset=+1]
+include::{chapters-path}sysinit/chapter.adoc[leveloffset=+1]
+include::{chapters-path}mac/chapter.adoc[leveloffset=+1]
+include::{chapters-path}vm/chapter.adoc[leveloffset=+1]
+include::{chapters-path}smp/chapter.adoc[leveloffset=+1]
[[devicedrivers]]
= 设备驱动程序
-include::{chapters-path}driverbasics/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}isa/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}pci/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}scsi/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}usb/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}newbus/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}sound/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
-include::{chapters-path}pccard/chapter.adoc[leveloffset=+1, lines=7..26;37..-1]
+include::{chapters-path}driverbasics/chapter.adoc[leveloffset=+1]
+include::{chapters-path}isa/chapter.adoc[leveloffset=+1]
+include::{chapters-path}pci/chapter.adoc[leveloffset=+1]
+include::{chapters-path}scsi/chapter.adoc[leveloffset=+1]
+include::{chapters-path}usb/chapter.adoc[leveloffset=+1]
+include::{chapters-path}newbus/chapter.adoc[leveloffset=+1]
+include::{chapters-path}sound/chapter.adoc[leveloffset=+1]
+include::{chapters-path}pccard/chapter.adoc[leveloffset=+1]
[[appendices]]
= 附录
-include::{chapters-path}bibliography/chapter.adoc[leveloffset=+1, lines=6..24;35..-1]
+include::{chapters-path}bibliography/chapter.adoc[leveloffset=+1]
diff --git a/documentation/content/zh-cn/books/arch-handbook/bibliography/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/bibliography/chapter.adoc
index e2c403a70b..53c29d8403 100644
--- a/documentation/content/zh-cn/books/arch-handbook/bibliography/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/bibliography/chapter.adoc
@@ -10,26 +10,36 @@ prev: books/arch-handbook/pccard
:toc: macro
:toclevels: 1
:icons: font
-:sectnums!:
+:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[1] __Marshall Kirk McKusick、Keith Bostic、Michael J Karels和John S Quarterman. 版权 © 1996 Addison-Wesley Publishing Company, Inc.. 0-201-54979-4. Addison-Wesley Publishing Company, Inc.. The Design and Implementation of the 4.4 BSD Operating System. 1-2.__
diff --git a/documentation/content/zh-cn/books/arch-handbook/boot/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/boot/chapter.adoc
index dd04c67c9f..431ac89f38 100644
--- a/documentation/content/zh-cn/books/arch-handbook/boot/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/boot/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/locking
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/arch-handbook/driverbasics/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/driverbasics/chapter.adoc
index 8175cbfb6d..9eeb83eb86 100644
--- a/documentation/content/zh-cn/books/arch-handbook/driverbasics/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/driverbasics/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/isa
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[driverbasics-intro]]
== 简介
diff --git a/documentation/content/zh-cn/books/arch-handbook/isa/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/isa/chapter.adoc
index 2367cf2d27..863313a9cd 100644
--- a/documentation/content/zh-cn/books/arch-handbook/isa/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/isa/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/pci
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[isa-driver-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/arch-handbook/jail/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/jail/chapter.adoc
index 629f2bd0a4..928c5564b8 100644
--- a/documentation/content/zh-cn/books/arch-handbook/jail/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/jail/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/sysinit
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
在大多数UNIX(R)系统中,用户``root``是万能的。这也就增加了许多危险。 如果一个攻击者获得了一个系统中的``root``,就可以在他的指尖掌握系统中所有的功能。 在FreeBSD里,有一些sysctl项削弱了``root``的权限, 这样就可以将攻击者造成的损害减小到最低限度。这些安全功能中,有一种叫安全级别。 另一种在FreeBSD 4.0及以后版本中提供的安全功能,就是man:jail[8]。 Jail将一个运行环境的文件树根切换到某一特定位置, 并且对这样环境中叉分生成的进程做出限制。例如, 一个被监禁的进程不能影响这个jail之外的进程、不能使用一些特定的系统调用, 也就不能对主计算机造成破坏。
diff --git a/documentation/content/zh-cn/books/arch-handbook/kobj/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/kobj/chapter.adoc
index d9baf707f6..61db27a441 100644
--- a/documentation/content/zh-cn/books/arch-handbook/kobj/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/kobj/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/jail
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
内核对象,也就是__Kobj__,为内核提供了一种面向对象 的C语言编程方式。被操作的数据也承载操作它的方法。 这使得在不破坏二进制兼容性的前提下,某一个接口能够增/减相应的操作。
diff --git a/documentation/content/zh-cn/books/arch-handbook/locking/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/locking/chapter.adoc
index 56900df9a5..8070ff77fb 100644
--- a/documentation/content/zh-cn/books/arch-handbook/locking/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/locking/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/kobj
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
__这一章由 FreeBSD SMP Next Generation Project 维护。 请将评论和建议发送给link:{freebsd-smp}_._
diff --git a/documentation/content/zh-cn/books/arch-handbook/mac/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/mac/chapter.adoc
index adbf759522..2b9f341fb1 100644
--- a/documentation/content/zh-cn/books/arch-handbook/mac/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/mac/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/vm
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-copyright]]
== MAC 文档版权声明
diff --git a/documentation/content/zh-cn/books/arch-handbook/newbus/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/newbus/chapter.adoc
index 9d61e5d621..18bf1eccb6 100644
--- a/documentation/content/zh-cn/books/arch-handbook/newbus/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/newbus/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/sound
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
__特别感谢Matthew N. Dodd, Warner Losh, Bill Paul, Doug Rabson, Mike Smith, Peter Wemm and Scott Long__.
diff --git a/documentation/content/zh-cn/books/arch-handbook/pccard/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/pccard/chapter.adoc
index 490f28334b..939141d559 100644
--- a/documentation/content/zh-cn/books/arch-handbook/pccard/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/pccard/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/bibliography
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
本章将讨论FreeBSD为编写PC Card或CardBus设备的驱动程序而提供的机制。 但目前本文只记录了如何向现有的pccard驱动程序中添加驱动程序。
diff --git a/documentation/content/zh-cn/books/arch-handbook/pci/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/pci/chapter.adoc
index c211645fe9..51fa5125c7 100644
--- a/documentation/content/zh-cn/books/arch-handbook/pci/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/pci/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/scsi
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
本章将讨论FreeBSD为了给PCI总线上的设备编写驱动程序而提供的机制。
diff --git a/documentation/content/zh-cn/books/arch-handbook/scsi/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/scsi/chapter.adoc
index b4564adb62..a273d223e5 100644
--- a/documentation/content/zh-cn/books/arch-handbook/scsi/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/scsi/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/usb
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[scsi-synopsis]]
== 提纲
diff --git a/documentation/content/zh-cn/books/arch-handbook/smp/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/smp/chapter.adoc
index 9a71cfb8f7..3fa37c019f 100644
--- a/documentation/content/zh-cn/books/arch-handbook/smp/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/smp/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/driverbasics
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[smp-intro]]
== 绪论
diff --git a/documentation/content/zh-cn/books/arch-handbook/sound/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/sound/chapter.adoc
index ee822ff64f..1be1305798 100644
--- a/documentation/content/zh-cn/books/arch-handbook/sound/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/sound/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/pccard
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[oss-intro]]
== 简介
diff --git a/documentation/content/zh-cn/books/arch-handbook/sysinit/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/sysinit/chapter.adoc
index 033ed310d6..e368d81102 100644
--- a/documentation/content/zh-cn/books/arch-handbook/sysinit/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/sysinit/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/mac
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
SYSINIT是一个通用的调用排序与分别执行机制的框架。 FreeBSD目前使用它来进行内核的动态初始化。 SYSINIT使得FreeBSD的内核各子系统可以在内核或模块动态加载链接时被重整、 添加、删除、替换,这样,内核和模块加载时就不必去修改一个静态的有序初始化 安排表甚至重新编译内核。这个体系也使得内核模块 (现在称为__KLD__可以与内核不同时编译、链接、 在引导系统时加载,甚至在系统运行时加载。这些操作是通过 "内核链接器"(kernel linker)和"链接器集合" (linker set)完成的。
diff --git a/documentation/content/zh-cn/books/arch-handbook/usb/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/usb/chapter.adoc
index 8bb022d1c9..5d7a983681 100644
--- a/documentation/content/zh-cn/books/arch-handbook/usb/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/usb/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/newbus
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[usb-intro]]
== 简介
diff --git a/documentation/content/zh-cn/books/arch-handbook/vm/chapter.adoc b/documentation/content/zh-cn/books/arch-handbook/vm/chapter.adoc
index 9517ce863b..5a135977f7 100644
--- a/documentation/content/zh-cn/books/arch-handbook/vm/chapter.adoc
+++ b/documentation/content/zh-cn/books/arch-handbook/vm/chapter.adoc
@@ -11,28 +11,36 @@ next: books/arch-handbook/smp
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
+:images-path: books/arch-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[vm-physmem]]
== 物理内存的管理-``vm_page_t``
diff --git a/documentation/content/zh-cn/books/handbook/_index.adoc b/documentation/content/zh-cn/books/handbook/_index.adoc
index a2b0990c4b..cd9e922255 100644
--- a/documentation/content/zh-cn/books/handbook/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/_index.adoc
@@ -4,36 +4,44 @@ authors:
- author: The FreeBSD Documentation Project
- author: FreeBSD 中文计划
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
next: books/handbook/preface
+isIndex: true
---
= FreeBSD 使用手册
:doctype: book
:toc: macro
-:toclevels: 2
+:toclevels: 1
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:book: true
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
摘要
@@ -42,10 +50,10 @@ include::shared/zh-cn/mailing-lists.adoc[]
'''
-include::content/zh-cn/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
-include::content/zh-cn/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
-include::content/zh-cn/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
-include::content/zh-cn/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/zh-cn/books/handbook/advanced-networking/_index.adoc b/documentation/content/zh-cn/books/handbook/advanced-networking/_index.adoc
index 6ac14ab388..82839359a6 100644
--- a/documentation/content/zh-cn/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/advanced-networking/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 32
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 32
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[advanced-networking-synopsis]]
== 概述
@@ -2712,7 +2710,7 @@ TA 完全依赖于您在运行的 PPP 进程, 以完成它们的功能和稳
对于外置 TA 的实际问题是:象 modem 要一样,您机子需要有一个好的串行卡。
-想要更深入地理解串行设备以及异步和同步串口这间的不同点, 您就要读读 link:{serial-uart}[FreeBSD 串行硬件]教程了。
+想要更深入地理解串行设备以及异步和同步串口这间的不同点, 您就要读读 extref:{serial-uart}[FreeBSD 串行硬件]教程了。
TA 将标准的 PC 串口 (同步的) 限制到了 115.2 Kbs,即使您有 128 Kbs 的连接。 想要完全利用 ISDN 有能力达到的 128 Kbs,您就需要把 TA 移到同步串行卡上。
diff --git a/documentation/content/zh-cn/books/handbook/audit/_index.adoc b/documentation/content/zh-cn/books/handbook/audit/_index.adoc
index cef5f5e8f0..3eae766559 100644
--- a/documentation/content/zh-cn/books/handbook/audit/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/audit/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/disks
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[audit-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/basics/_index.adoc b/documentation/content/zh-cn/books/handbook/basics/_index.adoc
index 4d36561a57..901d0e6f66 100644
--- a/documentation/content/zh-cn/books/handbook/basics/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/basics/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ports
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[basics-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/bibliography/_index.adoc b/documentation/content/zh-cn/books/handbook/bibliography/_index.adoc
index b5c6c91f2b..fe9e56b640 100644
--- a/documentation/content/zh-cn/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/bibliography/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/eresources
[[bibliography]]
= 参考文献
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
尽管手册页能够提供对于 FreeBSD 操作系统最为权威的参考资料, 它们有时却不能告诉我们如何让整个系统很好地运转起来。 因此, 一本关于 UNIX(R) 系统管理的好书, 以及一份好的用户手册是不可或缺的。
@@ -120,7 +134,7 @@ _英文版的书籍和杂志:_
* Leffler, Samuel J., Marshall Kirk McKusick, _The Design and Implementation of the 4.3BSD UNIX Operating System: Answer Book_. Reading, Mass. : Addison-Wesley, 1991. ISBN 0-201-54629-9
* McKusick, Marshall Kirk, Keith Bostic, Michael J Karels, and John Quarterman. _The Design and Implementation of the 4.4BSD Operating System_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-54979-4
+
-(这本书的第二章的 link:{design-44bsd}[在线版本] 是 FreeBSD Documentation Project 的一部分。)
+(这本书的第二章的 extref:{design-44bsd}[在线版本] 是 FreeBSD Documentation Project 的一部分。)
* Marshall Kirk McKusick, George V. Neville-Neil _The Design and Implementation of the FreeBSD Operating System_. Boston, Mass. : Addison-Wesley, 2004. ISBN 0-201-70245-2
* Stevens, W. Richard. _TCP/IP Illustrated, Volume 1: The Protocols_. Reading, Mass. : Addison-Wesley, 1996. ISBN 0-201-63346-9
* Schimmel, Curt. _Unix Systems for Modern Architectures_. Reading, Mass. : Addison-Wesley, 1994. ISBN 0-201-63338-8
diff --git a/documentation/content/zh-cn/books/handbook/book.adoc b/documentation/content/zh-cn/books/handbook/book.adoc
index 73153e3e65..9fb8460b42 100644
--- a/documentation/content/zh-cn/books/handbook/book.adoc
+++ b/documentation/content/zh-cn/books/handbook/book.adoc
@@ -4,7 +4,6 @@ authors:
- author: The FreeBSD Documentation Project
- author: FreeBSD 中文计划
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
---
@@ -13,53 +12,35 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
:book: true
:pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
-:chapters-path: content/zh-cn/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/zh-cn/mailing-lists.adoc[]
-include::../../../../shared/zh-cn/teams.adoc[]
-include::../../../../shared/zh-cn/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/zh-cn/mailing-lists.adoc[]
-include::../../../../shared/zh-cn/teams.adoc[]
-include::../../../../shared/zh-cn/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -74,97 +55,97 @@ toc::[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
// Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..26;36..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
-include::{chapters-path}install/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}install/_index.adoc[leveloffset=+1]
-include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1]
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
-include::{chapters-path}users/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}users/_index.adoc[leveloffset=+1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}jails/_index.adoc[leveloffset=+1]
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
-include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}filesystems/_index.adoc[leveloffset=+1]
-include::{chapters-path}vinum/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}vinum/_index.adoc[leveloffset=+1]
-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
-include::{chapters-path}dtrace/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}dtrace/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=7..19]
+include::{chapters-path}partiv.adoc[lines=15..27]
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
// Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
:sectnums!:
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/zh-cn/books/handbook/boot/_index.adoc b/documentation/content/zh-cn/books/handbook/boot/_index.adoc
index 109dbeebd3..f7b0508992 100644
--- a/documentation/content/zh-cn/books/handbook/boot/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/boot/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/users
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/bsdinstall/_index.adoc b/documentation/content/zh-cn/books/handbook/bsdinstall/_index.adoc
index ca5a3f7f9f..de06d2781f 100644
--- a/documentation/content/zh-cn/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/bsdinstall/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/basics
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/bsdinstall/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
-endif::[]
+:images-path: books/handbook/bsdinstall/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[bsdinstall-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/config/_index.adoc b/documentation/content/zh-cn/books/handbook/config/_index.adoc
index c5d53bf63f..1c815c5085 100644
--- a/documentation/content/zh-cn/books/handbook/config/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/config/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/boot
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/config/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/config/
-endif::[]
+:images-path: books/handbook/config/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/config/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[config-synopsis]]
== 概述
@@ -269,7 +267,7 @@ HOME=/var/log
[IMPORTANT]
====
-绝对不要用这种方法来编辑/安装系统 crontab。 您需要做的只是使用自己喜欢的编辑器: `cron` 程序会注意到文件发生了变化, 并立即开始使用新的版本。参见 link:{faq}#ROOT-NOT-FOUND-CRON-ERRORS[这个 FAQ 项目] 以了解进一步的情况。
+绝对不要用这种方法来编辑/安装系统 crontab。 您需要做的只是使用自己喜欢的编辑器: `cron` 程序会注意到文件发生了变化, 并立即开始使用新的版本。参见 extref:{faq}[这个 FAQ 项目, ROOT-NOT-FOUND-CRON-ERRORS] 以了解进一步的情况。
====
要安装刚写好的用户 [.filename]#crontab#, 首先使用最习惯的编辑器来创建一个符合要求格式的文件,然后用 `crontab` 程序来完成。最常见的用法是:
@@ -359,7 +357,7 @@ Starting background file system checks in 60 seconds.
通过在启动脚本中仔细设定这些关键字, 系统管理员可以很有条理的控制脚本的启动顺序, 进而避免使用像其他 UNIX(R) 操作系统那样混乱的 "runlevels"。
-更多关于 [.filename]#rc.d# 系统的信息, 可以在 man:rc[8] 和 man:rc.subr[8] 联机手册中找到。 如果您有意撰写自己的 [.filename]#rc.d# 脚本, 或对现有的脚本进行一些改进, 也可以参考 link:{rc-scripting}[这篇文章]。
+更多关于 [.filename]#rc.d# 系统的信息, 可以在 man:rc[8] 和 man:rc.subr[8] 联机手册中找到。 如果您有意撰写自己的 [.filename]#rc.d# 脚本, 或对现有的脚本进行一些改进, 也可以参考 extref:{rc-scripting}[这篇文章]。
[[config-network-setup]]
== 设置网卡
diff --git a/documentation/content/zh-cn/books/handbook/cutting-edge/_index.adoc b/documentation/content/zh-cn/books/handbook/cutting-edge/_index.adoc
index de0235edf3..587cdd3e3e 100644
--- a/documentation/content/zh-cn/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/cutting-edge/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/dtrace
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[updating-upgrading-synopsis]]
== 概述
@@ -519,7 +517,7 @@ FreeBSD 文档的更新和联编系统支持一些方便只更新一部分文档
如欲了解 FreeBSD 中其他可供配置的全局 make 变量, 请参阅 man:make.conf[5]。
-关于 FreeBSD 文档联编系统的其他详情, 请参阅 link:{fdp-primer}[FreeBSD 文档计划入门之新手必读部分]。
+关于 FreeBSD 文档联编系统的其他详情, 请参阅 extref:{fdp-primer}[FreeBSD 文档计划入门之新手必读部分]。
[[updating-installed-documentation]]
=== 从源代码安装 FreeBSD 文档
diff --git a/documentation/content/zh-cn/books/handbook/desktop/_index.adoc b/documentation/content/zh-cn/books/handbook/desktop/_index.adoc
index cf50b594f0..27e738bc8d 100644
--- a/documentation/content/zh-cn/books/handbook/desktop/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/desktop/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/multimedia
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[desktop-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/disks/_index.adoc b/documentation/content/zh-cn/books/handbook/disks/_index.adoc
index d5fd9c14ba..bcf677e6f3 100644
--- a/documentation/content/zh-cn/books/handbook/disks/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/disks/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/geom
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[disks-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/dtrace/_index.adoc b/documentation/content/zh-cn/books/handbook/dtrace/_index.adoc
index 4d88ba5b81..e4455971c5 100644
--- a/documentation/content/zh-cn/books/handbook/dtrace/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/dtrace/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/dtrace/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
-endif::[]
+:images-path: books/handbook/dtrace/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dtrace-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/eresources/_index.adoc b/documentation/content/zh-cn/books/handbook/eresources/_index.adoc
index def166d8dc..92a5a9712a 100644
--- a/documentation/content/zh-cn/books/handbook/eresources/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/eresources/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/pgpkeys
[[eresources]]
= Internet上的资源
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
发展迅猛的FreeBSD使得现有的印刷、平面媒体跟不上它的发展进度! 而电子版的也许是最好的,通常是唯一一个可以跟上最新发展方向的。FreeBSD来自于志愿者的成果, 用户社区通常也扮演着是"``技术支持部门``"的角色。通过电子邮, Web 论坛件和 USENET 新闻组可以很快的找到他们。
@@ -47,9 +60,9 @@ include::shared/zh-cn/urls.adoc[]
_如果你想要尝试发送一封邮件到 FreeBSD 邮件列表,你可以把邮件发往 {freebsd-test}。_ 请不要往其他的列表发送测试邮件。
====
-如果不知道哪个邮件列表适合于发送您的问题, 请参见 link:{freebsd-questions-article}[如何从 FreeBSD-questions 邮件列表中更快地得到答案]。
+如果不知道哪个邮件列表适合于发送您的问题, 请参见 extref:{freebsd-questions-article}[如何从 FreeBSD-questions 邮件列表中更快地得到答案]。
-在列表中发送任何问题之前, 请首先学习使用邮件列表的最佳方式, 例如如何通过阅读 link:{mailing-list-faq}[ 邮件列表常见问题回答集] (FAQ) 文档, 来避免经常重复的讨论。
+在列表中发送任何问题之前, 请首先学习使用邮件列表的最佳方式, 例如如何通过阅读 extref:{mailing-list-faq}[ 邮件列表常见问题回答集] (FAQ) 文档, 来避免经常重复的讨论。
全部的邮件列表记录都可以在link:https://www.FreeBSD.org/search/[FreeBSD World Wide Web服务器]上找到。此服务器提供了很棒的关键词搜寻功能,可让您找到FAQ的解答。 而在邮件列表上提问之前,请先搜寻是否已有答案。 请注意这意味着所有发往 FreeBSD 邮件列表的消息都会被永久归档保存。 当涉及到隐私保护的话, 可以考虑使用一个可使用后丢弃的电子邮件地址并只发送公开的信息。
diff --git a/documentation/content/zh-cn/books/handbook/filesystems/_index.adoc b/documentation/content/zh-cn/books/handbook/filesystems/_index.adoc
index 79d92526d5..419d091d51 100644
--- a/documentation/content/zh-cn/books/handbook/filesystems/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/filesystems/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/vinum
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/filesystems/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
-endif::[]
+:images-path: books/handbook/filesystems/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[filesystems-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/firewalls/_index.adoc b/documentation/content/zh-cn/books/handbook/firewalls/_index.adoc
index 56f2a8b48c..d676d99243 100644
--- a/documentation/content/zh-cn/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/firewalls/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/advanced-networking
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 31
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 31
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[firewalls-intro]]
== 入门
diff --git a/documentation/content/zh-cn/books/handbook/geom/_index.adoc b/documentation/content/zh-cn/books/handbook/geom/_index.adoc
index 7f48a3e3d7..4fe8f22669 100644
--- a/documentation/content/zh-cn/books/handbook/geom/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/geom/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/filesystems
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[GEOM-synopsis]]
== 概述
@@ -651,4 +649,4 @@ options GEOM_JOURNAL
出于性能考虑, 可能会希望在其他磁盘上保存日志。 对于这类情形, 应该在启用日志的设备后面,给出日志提供者或存储设备。 在暨存的文件系统上, 可以用 `tunefs` 来启用日志; 不过, 在尝试修改文件系统之前, 您应对其进行备份。 多数情况下, 如果无法创建实际的日志, `gjournal` 就会失败, 并且不会防止由于不当使用 `tunefs` 而造成的数据丢失。
-对于 FreeBSD 系统的启动磁盘使用日志也是可能的。 请参阅 link:{gjournal-desktop}[Implementing UFS Journaling on a Desktop PC] 以获得更多详细信息。
+对于 FreeBSD 系统的启动磁盘使用日志也是可能的。 请参阅 extref:{gjournal-desktop}[Implementing UFS Journaling on a Desktop PC] 以获得更多详细信息。
diff --git a/documentation/content/zh-cn/books/handbook/install/_index.adoc b/documentation/content/zh-cn/books/handbook/install/_index.adoc
index 70e652e803..7eba28ed00 100644
--- a/documentation/content/zh-cn/books/handbook/install/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/install/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/bsdinstall
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/install/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/install/
-endif::[]
+:images-path: books/handbook/install/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/install/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[install-synopsis]]
== 概述
@@ -2361,7 +2359,7 @@ FreeBSD 7.X 系列在 FreeBSD 7.3 之前的版本, 以及 FreeBSD 8.X 系列
[NOTE]
====
-如果有兴趣制作一张定制的 FreeBSD 版本, 请参考 link:{releng}[Release Engineering Article]。
+如果有兴趣制作一张定制的 FreeBSD 版本, 请参考 extref:{releng}[Release Engineering Article]。
====
[[install-ftp]]
@@ -2475,7 +2473,7 @@ C:\> xcopy e:\manpages c:\freebsd\manpages\ /s
如果您使用一个 MODEM,那您就只有 PPP 这一种选择了。在您安装的过程中, 要确定您能很容易地获得完整且快速的关于您服务提供商的信息。
-如果您使用 PAP 或 CHAP 方式连接到您的 ISP, (换句话说,如果您不使用脚本在Windows(R)中连接到您的ISP), 那么您需要在 ppp 提示符下输入 `dial` 命令。否则,当 PPP 连接者只提供一种最简单的终端模拟器,您必须知道如何使用针对 MODEM 的 "AT commands"拨号到您的 ISP。 想知道更深入的信息可以参考 crossref:ppp-and-slip[userppp,使用手册中的用户级PPP那节] 以及 link:{faq}#ppp/[FAQ] 。 如果您有一些问题,可以使用 `set log local ...` 命令将日志显示在屏幕上。
+如果您使用 PAP 或 CHAP 方式连接到您的 ISP, (换句话说,如果您不使用脚本在Windows(R)中连接到您的ISP), 那么您需要在 ppp 提示符下输入 `dial` 命令。否则,当 PPP 连接者只提供一种最简单的终端模拟器,您必须知道如何使用针对 MODEM 的 "AT commands"拨号到您的 ISP。 想知道更深入的信息可以参考 crossref:ppp-and-slip[userppp,使用手册中的用户级PPP那节] 以及 extref:{faq}[FAQ, ppp] 。 如果您有一些问题,可以使用 `set log local ...` 命令将日志显示在屏幕上。
您也可以通过并口电缆连接到另外一台 FreeBSD 机器上进行安装,您可以考虑使用 "laplink" 并口电缆进行安装。通过并口安装要比通过串口 (最高 50 kbytes/sec)安装快得多。
diff --git a/documentation/content/zh-cn/books/handbook/introduction/_index.adoc b/documentation/content/zh-cn/books/handbook/introduction/_index.adoc
index 6a1e5ed67c..9643ec9937 100644
--- a/documentation/content/zh-cn/books/handbook/introduction/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/introduction/_index.adoc
@@ -13,25 +13,35 @@ next: books/handbook/install
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/handbook/introduction/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-synopsis]]
== 概述
@@ -49,7 +59,7 @@ toc::[]
[[nutshell]]
== 欢迎来到 FreeBSD 的世界!
-FreeBSD 是一个支持 Intel (x86 和 Itanium(R)),AMD64, Sun UltraSPARC(R) 计算机的基于 4.4BSD-Lite 的操作系统。 到其他体系结构的移植也在进行中。 您也可以阅读 <<history,FreeBSD 的历史>>, 或者<<relnotes,最新的发行版本>>。 如果您有意捐助(代码, 硬件,基金),请看link:{contributing}[为 FreeBSD 提供帮助]这篇文章。
+FreeBSD 是一个支持 Intel (x86 和 Itanium(R)),AMD64, Sun UltraSPARC(R) 计算机的基于 4.4BSD-Lite 的操作系统。 到其他体系结构的移植也在进行中。 您也可以阅读 <<history,FreeBSD 的历史>>, 或者<<relnotes,最新的发行版本>>。 如果您有意捐助(代码, 硬件,基金),请看extref:{contributing}[为 FreeBSD 提供帮助]这篇文章。
[[os-overview]]
=== FreeBSD 能做些什么?
@@ -176,7 +186,7 @@ FreeBSD 项目的目标是无附加条件地提供能够用于任何目的的软
[[development]]
=== FreeBSD 开发模式
-FreeBSD 的开发是一个非常开放且有有伸缩性的过程, 就像从我们的link:{contributors}[ 贡献者列表]里看到的,它是完全由来自全世界的数以百计的贡献者发展起来的。 FreeBSD 的开发基础结构允许数以百计的开发者通过互联网协同工作。 我们也经常关注着那些对我们的计划感兴趣的新开发者和新的创意, 那些有兴趣更进一步参与项目的人只需要在 {freebsd-hackers} 联系我们。 {freebsd-announce} 对那些希望了解我们工作所涉及到哪些领域的人也是有用的。
+FreeBSD 的开发是一个非常开放且有有伸缩性的过程, 就像从我们的extref:{contributors}[ 贡献者列表]里看到的,它是完全由来自全世界的数以百计的贡献者发展起来的。 FreeBSD 的开发基础结构允许数以百计的开发者通过互联网协同工作。 我们也经常关注着那些对我们的计划感兴趣的新开发者和新的创意, 那些有兴趣更进一步参与项目的人只需要在 {freebsd-hackers} 联系我们。 {freebsd-announce} 对那些希望了解我们工作所涉及到哪些领域的人也是有用的。
无论是独立地工作或者封闭式的团队工作, 了解 FreeBSD 计划和它的开发过程都是有益的:
@@ -189,7 +199,7 @@ _committer_ 是那些对 CVS 树有_写_权限的人, 他们被授权修改 Fr
FreeBSD 核心团队[[development-core]]::
如果把 FreeBSD 项目看作一家公司,那么 _FreeBSD 核心团队_就相当于董事会。 核心团队的主要任务是提出总体上的发展计划,然后确定一个正确的方向。 邀请那些富有献身精神和可靠的开发者加入到 committer 队伍中来也是核心团队的工作之一, 这些新的成员将作为新核心团队成员和其他人一起继续前进。 当前的核心团队是 2010 年 7 月从 committer 中选举产生的。选举每两年一次。
+
-一些核心团队的成员还负责特定的责任范围, 也就是说他们必须尽力确保某个子系统能工作正常。 FreeBSD 开发者的完整列表和他们的责任范围,请参见link:{contributors}[贡献者列表]
+一些核心团队的成员还负责特定的责任范围, 也就是说他们必须尽力确保某个子系统能工作正常。 FreeBSD 开发者的完整列表和他们的责任范围,请参见extref:{contributors}[贡献者列表]
+
[NOTE]
====
@@ -199,7 +209,7 @@ FreeBSD 核心团队[[development-core]]::
外围贡献者::
事实上,最大的开发团队正是为我们提供反馈和错误修补的用户自己。 FreeBSD 的非集中式的开发者保持联系的主要方式就是预订 {freebsd-hackers},很多事情在那里讨论。查看crossref:eresources[eresources,Internet上的资源]了解众多 FreeBSD 邮件列表的更多信息。
+
-link:{contributors}[FreeBSD 贡献者列表] 很长并在不断增长, 为什么不加入它来为 FreeBSD 做贡献呢?
+extref:{contributors}[FreeBSD 贡献者列表] 很长并在不断增长, 为什么不加入它来为 FreeBSD 做贡献呢?
+
提供代码不是为这个计划做贡献的唯一方式; 有一个更完整的需要做的事情的列表,可以参见 link:https://www.FreeBSD.org/[FreeBSD 项目网站]。
diff --git a/documentation/content/zh-cn/books/handbook/jails/_index.adoc b/documentation/content/zh-cn/books/handbook/jails/_index.adoc
index d5ca770b56..acf53e620c 100644
--- a/documentation/content/zh-cn/books/handbook/jails/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/jails/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mac
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/jails/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
-endif::[]
+:images-path: books/handbook/jails/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[jails-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/kernelconfig/_index.adoc b/documentation/content/zh-cn/books/handbook/kernelconfig/_index.adoc
index d14a138218..db8cef023f 100644
--- a/documentation/content/zh-cn/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/kernelconfig/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/printing
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kernelconfig-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/l10n/_index.adoc b/documentation/content/zh-cn/books/handbook/l10n/_index.adoc
index 40779fdf31..1fa6ca00a6 100644
--- a/documentation/content/zh-cn/books/handbook/l10n/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/l10n/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/cutting-edge
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/linuxemu/_index.adoc b/documentation/content/zh-cn/books/handbook/linuxemu/_index.adoc
index bba3a6ced9..b69006cd4c 100644
--- a/documentation/content/zh-cn/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/linuxemu/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[linuxemu-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/mac/_index.adoc b/documentation/content/zh-cn/books/handbook/mac/_index.adoc
index a6359e57c4..37ef96581d 100644
--- a/documentation/content/zh-cn/books/handbook/mac/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/mac/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/audit
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-synopsis]]
== 概要
diff --git a/documentation/content/zh-cn/books/handbook/mail/_index.adoc b/documentation/content/zh-cn/books/handbook/mail/_index.adoc
index 020720d98f..ba43608ea1 100644
--- a/documentation/content/zh-cn/books/handbook/mail/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/mail/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/network-servers
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 29
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 29
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mail-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/mirrors/_index.adoc b/documentation/content/zh-cn/books/handbook/mirrors/_index.adoc
index 8516dbc1c4..e08af9aed5 100644
--- a/documentation/content/zh-cn/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/mirrors/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/bibliography
[[mirrors]]
= 获取 FreeBSD
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mirrors-cdrom]]
== CDROM 和 DVD 发行商
@@ -1018,7 +1031,7 @@ FreeBSD Ports Collection。
+
[IMPORTANT]
====
-要自行构建 [.filename]#ports/INDEX#, 您 _必须_ 接受 `ports-all` (完整的 ports tree)。 在部分 ports tree 上构建 [.filename]#ports/INDEX# 是不被支持的。 请参见 link:{faq}#applications/#MAKE-INDEX[ FAQ]。
+要自行构建 [.filename]#ports/INDEX#, 您 _必须_ 接受 `ports-all` (完整的 ports tree)。 在部分 ports tree 上构建 [.filename]#ports/INDEX# 是不被支持的。 请参见 extref:{faq}[FAQ, MAKE-INDEX]。
====
`ports-accessibility release=cvs`::::
@@ -1446,7 +1459,7 @@ FreeBSD-2.2.X 的开发线, 也被叫做 2.2-STABLE。 这个分支基本上
=== 版本标签
-当一个特定的 FreeBSD 版本发行时, 这些标签代表了一个指定的时间点。发布工程进程在 link:https://www.FreeBSD.org/releng/[Release Engineering Information] 和 link:{releng}#release-proc/[Release Process] 文档中被详细描述。 [.filename]#src# 树使用以 `RELENG_` 开头的标签。 [.filename]#ports# 和 [.filename]#doc# 树使用以 `RELEASE` 开头的标签。 最后, [.filename]#www# 树上不会有任何特定发行版的标签。
+当一个特定的 FreeBSD 版本发行时, 这些标签代表了一个指定的时间点。发布工程进程在 link:https://www.FreeBSD.org/releng/[Release Engineering Information] 和 extref:{releng}[Release Process, release-proc] 文档中被详细描述。 [.filename]#src# 树使用以 `RELENG_` 开头的标签。 [.filename]#ports# 和 [.filename]#doc# 树使用以 `RELEASE` 开头的标签。 最后, [.filename]#www# 树上不会有任何特定发行版的标签。
RELENG_8_2_0_RELEASE::
FreeBSD 8.2
diff --git a/documentation/content/zh-cn/books/handbook/multimedia/_index.adoc b/documentation/content/zh-cn/books/handbook/multimedia/_index.adoc
index 32110bbd15..93e14ed0d2 100644
--- a/documentation/content/zh-cn/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/multimedia/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/kernelconfig
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[multimedia-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/network-servers/_index.adoc b/documentation/content/zh-cn/books/handbook/network-servers/_index.adoc
index a0a6b07a24..f9eeb3f85d 100644
--- a/documentation/content/zh-cn/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/network-servers/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/firewalls
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 30
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 30
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[network-servers-synopsis]]
== 概要
diff --git a/documentation/content/zh-cn/books/handbook/parti.adoc b/documentation/content/zh-cn/books/handbook/parti.adoc
index 9c3118fc97..3372c25d7b 100644
--- a/documentation/content/zh-cn/books/handbook/parti.adoc
+++ b/documentation/content/zh-cn/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
next: books/handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[getting-started]]
= 起步
@@ -17,4 +25,4 @@ next: books/handbook/introduction
我们尝试用最少的页数来保持前言的索引,以至于可以用最少翻页次数将该手册从头至尾读过。
-include::content/zh-cn/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/zh-cn/books/handbook/partii.adoc b/documentation/content/zh-cn/books/handbook/partii.adoc
index 616d12b2e7..7ef07aa662 100644
--- a/documentation/content/zh-cn/books/handbook/partii.adoc
+++ b/documentation/content/zh-cn/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
next: books/handbook/desktop
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[common-tasks]]
= 常见的任务
@@ -17,4 +25,4 @@ next: books/handbook/desktop
某些章节希望您首先阅读过其他部分, 在这些章的开头部分也会给出类似的提示。
-include::content/zh-cn/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/zh-cn/books/handbook/partiii.adoc b/documentation/content/zh-cn/books/handbook/partiii.adoc
index 84c8a6d003..6b58acce10 100644
--- a/documentation/content/zh-cn/books/handbook/partiii.adoc
+++ b/documentation/content/zh-cn/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
next: books/handbook/config
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[system-administration]]
= 系统管理
@@ -11,4 +19,4 @@ FreeBSD 手册中其余章节的内容都是关于系统管理。 每一章节
这些章节在撰写时, 已经设计成了许多相互独立的部分, 如果您需要了解某部分内容, 直接阅读这部分内容即可, 而无需按照顺序, 也不必在您开始使用 FreeBSD 之前完整地阅读它们。
-include::content/zh-cn/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/zh-cn/books/handbook/partiv.adoc b/documentation/content/zh-cn/books/handbook/partiv.adoc
index 7f2e37fb25..ad43d24c7f 100644
--- a/documentation/content/zh-cn/books/handbook/partiv.adoc
+++ b/documentation/content/zh-cn/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/dtrace
next: books/handbook/serialcomms
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[network-communication]]
= 网络通讯
@@ -18,4 +26,4 @@ FreeBSD 是目前以高性能网络服务为目的而部署范围最广的操作
这些章节主要供您在需要时参考。 不必按特定的顺序来阅读它们, 此外, 您开始在网络中使用 FreeBSD 之前也不需要先把它们都读完。
-include::content/zh-cn/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/zh-cn/books/handbook/partv.adoc b/documentation/content/zh-cn/books/handbook/partv.adoc
index f6d1754ef7..da34223eac 100644
--- a/documentation/content/zh-cn/books/handbook/partv.adoc
+++ b/documentation/content/zh-cn/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
next: books/handbook/mirrors
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= 附录
-include::content/zh-cn/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/zh-cn/books/handbook/pgpkeys/_index.adoc b/documentation/content/zh-cn/books/handbook/pgpkeys/_index.adoc
index 568193758e..51c590a235 100644
--- a/documentation/content/zh-cn/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/pgpkeys/_index.adoc
@@ -9,28 +9,44 @@ next: books/handbook/freebsd-glossary
[[pgpkeys]]
= PGP公钥
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
有些时候,您可能需要校验签名或者发送加密的邮件给官员或者开发者, 这里为了方便您而提供了一些密钥。完整的 FreeBSD.org 用户密钥可以在 link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt] 下载。
diff --git a/documentation/content/zh-cn/books/handbook/ports/_index.adoc b/documentation/content/zh-cn/books/handbook/ports/_index.adoc
index 62f98d025c..08d24a692a 100644
--- a/documentation/content/zh-cn/books/handbook/ports/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/ports/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/x11
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ports-synopsis]]
== 概述
@@ -419,7 +417,7 @@ Portsnap 是用于发布 Ports 套件的另一套系统。 请参阅 crossref:cu
* 一个 [.filename]#pkg-descr# 文件。 这是一个提供更多细节,有软件的多行描述。
* 一个 [.filename]#pkg-plist# 文件。 这是即将被安装的所有文件的列表。它告诉 ports 系统在卸载时需要删除哪些文件。
-一些ports还有些其它的文件, 例如 [.filename]#pkg-message#。 ports 系统在一些特殊情况下会用到这些文件。 如果您想知道这些文件更多的细节以及 ports 的概要, 请参阅 link:{porters-handbook}[FreeBSD Porter's Handbook]。
+一些ports还有些其它的文件, 例如 [.filename]#pkg-message#。 ports 系统在一些特殊情况下会用到这些文件。 如果您想知道这些文件更多的细节以及 ports 的概要, 请参阅 extref:{porters-handbook}[FreeBSD Porter's Handbook]。
port里面包含着如何编译源代码的指令, 但不包含真正的源代码。 您可以在网上或 CD-ROM 上获得源代码。 源代码可能被开发者发布成任何格式。 一般来说应该是一个被 tar 和 gzip 过的文件, 或者是被一些其他的工具压缩或未压缩的文件。 ports中这个程序源代码标示文件叫 "distfile", 安装 FreeBSD port的方法还不止这两种。
@@ -827,11 +825,11 @@ Portmaster 默认在删除一个现有的 port 前会做一个备份包。如果
+
[NOTE]
====
-某些 ports 并非一个人维护, 而是写了一个 link:{mailing-list-faq}[邮件列表]。 许多, 但并非所有 port, 使用类似 mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org] 这样的地址。 请在提出问题时考虑这一点。
+某些 ports 并非一个人维护, 而是写了一个 extref:{mailing-list-faq}[邮件列表]。 许多, 但并非所有 port, 使用类似 mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org] 这样的地址。 请在提出问题时考虑这一点。
特别地, 由 mailto:ports@FreeBSD.org[ports@FreeBSD.org] 监护的 port, 实际上并没有人维护。 订阅这个邮件列表的人们会感谢您提供的修正和支持。 我们一直都需要更多志愿者!
====
+
-如果您没有得到回应, 则可以使用 man:send-pr[1] 来提交问题报告 (请参见 link:{problem-reports}[如何撰写 FreeBSD 问题报告])。
-. 修正它! link:{porters-handbook}[Porter 手册] 中提供了关于 "Ports" 基础设施的详细信息, 通过了解这些内容, 您就能修正偶然坏掉的 port, 或甚至提交自己的 port 了!
+如果您没有得到回应, 则可以使用 man:send-pr[1] 来提交问题报告 (请参见 extref:{problem-reports}[如何撰写 FreeBSD 问题报告])。
+. 修正它! extref:{porters-handbook}[Porter 手册] 中提供了关于 "Ports" 基础设施的详细信息, 通过了解这些内容, 您就能修正偶然坏掉的 port, 或甚至提交自己的 port 了!
. 从较近的 FTP 站点下载一个编译好的安装包。 "中央的" package collection 在 `ftp.FreeBSD.org` 的 link:ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/[packages 目录中], 但 _在此之前_ 请 _事先_ 检查一下是否存在较近的 crossref:mirrors[mirrors-ftp,镜像网站]! 通常情况下这些安装包都可以直接使用, 而且应该比自行编译快一些。 安装过程本身可以通过 man:pkg_add[1] 来完成。
diff --git a/documentation/content/zh-cn/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/zh-cn/books/handbook/ppp-and-slip/_index.adoc
index 1793d2ca0e..9fda380840 100644
--- a/documentation/content/zh-cn/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/ppp-and-slip/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mail
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 28
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 28
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ppp-and-slip-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/preface/_index.adoc b/documentation/content/zh-cn/books/handbook/preface/_index.adoc
index 949c29505a..d90bcd0de4 100644
--- a/documentation/content/zh-cn/books/handbook/preface/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/preface/_index.adoc
@@ -11,17 +11,33 @@ next: books/handbook/parti
:toc: macro
:toclevels: 1
:icons: font
-:sectnums!:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-audience]]
== 预期的读者
diff --git a/documentation/content/zh-cn/books/handbook/printing/_index.adoc b/documentation/content/zh-cn/books/handbook/printing/_index.adoc
index b09ff30d0b..002d1fe10a 100644
--- a/documentation/content/zh-cn/books/handbook/printing/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/printing/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/linuxemu
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/printing/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[printing-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/security/_index.adoc b/documentation/content/zh-cn/books/handbook/security/_index.adoc
index 9ddf9c9992..3c4805f2eb 100644
--- a/documentation/content/zh-cn/books/handbook/security/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/security/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/jails
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/serialcomms/_index.adoc b/documentation/content/zh-cn/books/handbook/serialcomms/_index.adoc
index 4887be42da..b8b1090c24 100644
--- a/documentation/content/zh-cn/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/serialcomms/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ppp-and-slip
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[serial-synopsis]]
== 概述
@@ -1166,7 +1164,7 @@ FreeBSD可以通过一个串口只使用一个哑 (dumb) 终端就可以启动
无论是否使用了下面将要讨论的 `-h` 选项, 都强制这个单元作为控制台 (除非使用了更高优先级的控制台)。 标志 `0x20` 必须与 `0x10` 一起使用。
`0x40`:::
-预留这个单元 (配合 `0x10`) 并让它不能用于普通的使用。 您不应在希望作为控制台的串口单元上设置这个标志。 这一标志是为内核远程调试准备的。 参见 link:{developers-handbook}[开发者手册] 以了解关于远程调试更进一步的情况。
+预留这个单元 (配合 `0x10`) 并让它不能用于普通的使用。 您不应在希望作为控制台的串口单元上设置这个标志。 这一标志是为内核远程调试准备的。 参见 extref:{developers-handbook}[开发者手册] 以了解关于远程调试更进一步的情况。
+
例如:
+
diff --git a/documentation/content/zh-cn/books/handbook/users/_index.adoc b/documentation/content/zh-cn/books/handbook/users/_index.adoc
index 696c914f45..911ea2accd 100644
--- a/documentation/content/zh-cn/books/handbook/users/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/users/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/security
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/users/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/users/
-endif::[]
+:images-path: books/handbook/users/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/users/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[users-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/vinum/_index.adoc b/documentation/content/zh-cn/books/handbook/vinum/_index.adoc
index 48203be389..068cda94a5 100644
--- a/documentation/content/zh-cn/books/handbook/vinum/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/vinum/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/virtualization
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/vinum/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/vinum/
-endif::[]
+:images-path: books/handbook/vinum/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/vinum/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[vinum-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/virtualization/_index.adoc b/documentation/content/zh-cn/books/handbook/virtualization/_index.adoc
index 8290ae9952..8c515d11bb 100644
--- a/documentation/content/zh-cn/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/virtualization/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/l10n
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/virtualization/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
-endif::[]
+:images-path: books/handbook/virtualization/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[virtualization-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/handbook/x11/_index.adoc b/documentation/content/zh-cn/books/handbook/x11/_index.adoc
index e15a822a9b..9a15047788 100644
--- a/documentation/content/zh-cn/books/handbook/x11/_index.adoc
+++ b/documentation/content/zh-cn/books/handbook/x11/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[x11-synopsis]]
== 概述
diff --git a/documentation/content/zh-cn/books/porters-handbook/_index.adoc b/documentation/content/zh-cn/books/porters-handbook/_index.adoc
index b4a362601b..162fe551a3 100644
--- a/documentation/content/zh-cn/books/porters-handbook/_index.adoc
+++ b/documentation/content/zh-cn/books/porters-handbook/_index.adoc
@@ -5,7 +5,7 @@ authors:
- author: FreeBSD 中文计划
copyright: 2000-2020 The FreeBSD Documentation Project
trademarks: ["freebsd", "sun", "unix", "general"]
-releaseinfo: "$FreeBSD$"
+isIndex: true
---
= FreeBSD Porter 手册
@@ -13,50 +13,34 @@ releaseinfo: "$FreeBSD$"
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:book: true
+:pdf: false
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
-:chapters-path: content/zh-cn/books/porters-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/porters-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/zh-cn/mailing-lists.adoc[]
-include::../../../../shared/zh-cn/teams.adoc[]
-include::../../../../shared/zh-cn/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/zh-cn/mailing-lists.adoc[]
-include::../../../../shared/zh-cn/teams.adoc[]
-include::../../../../shared/zh-cn/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -67,17 +51,17 @@ include::{chapters-path}toc-tables.adoc[]
include::{chapters-path}toc-examples.adoc[]
-include::{chapters-path}why-port/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}own-port/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}slow/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}makefile/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}special/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}plist/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}testing/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}port-upgrading/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}security/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1, lines=7..24;35..-1]
-include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1, lines=6..23;34..-1]
+include::{chapters-path}why-port/chapter.adoc[leveloffset=+1]
+include::{chapters-path}own-port/chapter.adoc[leveloffset=+1]
+include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1]
+include::{chapters-path}slow/chapter.adoc[leveloffset=+1]
+include::{chapters-path}makefile/chapter.adoc[leveloffset=+1]
+include::{chapters-path}special/chapter.adoc[leveloffset=+1]
+include::{chapters-path}plist/chapter.adoc[leveloffset=+1]
+include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1]
+include::{chapters-path}testing/chapter.adoc[leveloffset=+1]
+include::{chapters-path}port-upgrading/chapter.adoc[leveloffset=+1]
+include::{chapters-path}security/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1]
+include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1]
diff --git a/documentation/content/zh-cn/books/porters-handbook/keeping-up/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/keeping-up/chapter.adoc
index c462303c33..ed180f9bf5 100644
--- a/documentation/content/zh-cn/books/porters-handbook/keeping-up/chapter.adoc
+++ b/documentation/content/zh-cn/books/porters-handbook/keeping-up/chapter.adoc
@@ -10,26 +10,36 @@ prev: books/porters-handbook/porting-samplem
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
FreeBSD 的 Ports Collection 在持续地进行修改。 这里提供了一些关于如何保持同步的信息。
diff --git a/documentation/content/zh-cn/books/porters-handbook/makefile/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/makefile/chapter.adoc
index 53c4a17bfd..58ab9de20b 100644
--- a/documentation/content/zh-cn/books/porters-handbook/makefile/chapter.adoc
+++ b/documentation/content/zh-cn/books/porters-handbook/makefile/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/special
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
配置 [.filename]#Makefile# 是相当简单的, 我们在此建议您在开始之前看一下现有的例子。 在这份手册里也有一个 <<porting-samplem,Makefile例子>>, 照着里面变量的顺序来写能使得您的 port 更容易地被其它人看懂。
@@ -682,7 +692,7 @@ _-compiled.specifics_ 部分应该通过 `PKGNAMESUFFIX` 变量来设置。
我们目前的做法是避免建立新的物理分类, 除非有非常多的 port 应被归入这一分类, 或者 port 属于某一特定的小团体 (例如, 与某种人类语言相关), 或两者皆是。
-这样做的原因是这类修改会让 committer 和用户都不得不进行 link:{committers-guide}#ports[许多工作] 来在 Ports Collection 进行或追踪修改。 此外, 提议新的分类通常都会引起争论。 (可能这是因为关于某个分类是否 "太大" 一直没有非常一致的意见的缘故, 另一方面, 分类是否能够能够有助于浏览 (以及多少个分类是合适的), 等等, 也都是问题。)
+这样做的原因是这类修改会让 committer 和用户都不得不进行 extref:{committers-guide}[许多工作, ports] 来在 Ports Collection 进行或追踪修改。 此外, 提议新的分类通常都会引起争论。 (可能这是因为关于某个分类是否 "太大" 一直没有非常一致的意见的缘故, 另一方面, 分类是否能够能够有助于浏览 (以及多少个分类是合适的), 等等, 也都是问题。)
下面是具体的步骤:
@@ -699,7 +709,7 @@ _-compiled.specifics_ 部分应该通过 `PKGNAMESUFFIX` 变量来设置。
** (此外, 作为一项加分因素, 您还可以按照 Committer 指南所介绍的流程, 提供一些其它需要修改的文件。)
. 由于这是一项影响 ports 基础设施的变动, 它不仅涉及 repo-copy 的使用, 而且也可能会影响联编集群的回归测试操作, 因此这类 PR 应分派给 {portmgr}。
-. 如果这一 PR 得到批准, 某个 committer 将按照在 link:{committers-guide}#PORTS[ Committer 指南] 中所介绍的步骤来完成余下的工作。
+. 如果这一 PR 得到批准, 某个 committer 将按照在 extref:{committers-guide}[ Committer 指南, ports] 中所介绍的步骤来完成余下的工作。
====
提议新的虚拟分类和上述过程类似, 但会容易许多, 因为不需要实际地移动任何 port。 这种情况下, PR 应附带的补丁, 就只需要修改影响到的 port 的 Makefile, 以便在其中的 `CATEGORIES` 中加入新的分类了。
diff --git a/documentation/content/zh-cn/books/porters-handbook/own-port/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/own-port/chapter.adoc
index 7fd92bd1e2..b1441238d9 100644
--- a/documentation/content/zh-cn/books/porters-handbook/own-port/chapter.adoc
+++ b/documentation/content/zh-cn/books/porters-handbook/own-port/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/quick-porting
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
那么, 您有兴趣创建自己的 port 或升级现有的 port? 太好了。
diff --git a/documentation/content/zh-cn/books/porters-handbook/pkg-files/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/pkg-files/chapter.adoc
index 670efa4734..076ade2e6b 100644
--- a/documentation/content/zh-cn/books/porters-handbook/pkg-files/chapter.adoc
+++ b/documentation/content/zh-cn/books/porters-handbook/pkg-files/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/testing
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
前面有一些没有提及的关于 [.filename]#pkg-*# 文件的技巧, 它们可以方便地完成许多任务。
diff --git a/documentation/content/zh-cn/books/porters-handbook/plist/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/plist/chapter.adoc
index ce7378c451..0d3cb23c4f 100644
--- a/documentation/content/zh-cn/books/porters-handbook/plist/chapter.adoc
+++ b/documentation/content/zh-cn/books/porters-handbook/plist/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/pkg-files
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[plist-sub]]
== 根据 make 变量对 [.filename]#pkg-plist# 进行修改
diff --git a/documentation/content/zh-cn/books/porters-handbook/port-upgrading/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/port-upgrading/chapter.adoc
index b5fb7f9070..f09dd7e97b 100644
--- a/documentation/content/zh-cn/books/porters-handbook/port-upgrading/chapter.adoc
+++ b/documentation/content/zh-cn/books/porters-handbook/port-upgrading/chapter.adoc
@@ -11,28 +11,38 @@ next: books/porters-handbook/security
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
-如果您发现某个 port 相对原作者所发布的版本已经过时, 则首先需要确认的是您的 port 是最新的。 您可以在 FreeBSD FTP 镜像的 [.filename]#ports/ports-current# 目录中找到它们。 但是, 如果您正在使用较多的 port, 则可能使用 CVSup 来保持 Ports Collection 最新更为简单, 这在 link:{handbook}#CVSUP-CONFIG[使用手册] 中进行了介绍。 此外, 这样做也有助于保持 port 依赖关系的正确性。
+如果您发现某个 port 相对原作者所发布的版本已经过时, 则首先需要确认的是您的 port 是最新的。 您可以在 FreeBSD FTP 镜像的 [.filename]#ports/ports-current# 目录中找到它们。 但是, 如果您正在使用较多的 port, 则可能使用 CVSup 来保持 Ports Collection 最新更为简单, 这在 extref:{handbook}[使用手册, CVSUP-CONFIG] 中进行了介绍。 此外, 这样做也有助于保持 port 依赖关系的正确性。
下一步是检查是否已经有在等待的更新。 要完成这项工作, 可以采用下列两种方法之一。 有一个用于搜索 http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[ FreeBSD 问题报告 (PR) 数据库] (也被称作 `GNATS`)。 在下拉框中选择 `ports`, 然后输入 port 的名字。
@@ -53,11 +63,11 @@ toc::[]
为了简化常用的补丁文件操作, 您可以使用 [.filename]#/usr/ports/Tools/scripts/patchtool.py#。 使用之前, 请首先阅读 [.filename]#/usr/ports/Tools/scripts/README.patchtool#。
-如果 port 目前还无人维护, 而且您自己经常使用它, 请考虑自荐为它的维护者。 FreeBSD 有超过 4000 个没有维护者的 port, 而这正是最需要志愿人员的领域。 (要了解关于维护者的任务描述, 请参见 link:{developers-handbook}#POLICIES-MAINTAINER[ 开发手册中的相关部分]。)
+如果 port 目前还无人维护, 而且您自己经常使用它, 请考虑自荐为它的维护者。 FreeBSD 有超过 4000 个没有维护者的 port, 而这正是最需要志愿人员的领域。 (要了解关于维护者的任务描述, 请参见 extref:{developers-handbook}[开发手册中的相关部分, POLICIES-MAINTAINER]。)
将 diff 发送给我们的最佳方式是通过 man:send-pr[1] (category 一栏写 `ports`)。 如果您正维护那个 port, 请务必在 synopsis 的开头写上 `[maintainer update]`, 并将您的 PR 的 "Class" 设置为 `maintainer-update`。 反之, 您的 PR 的 "Class" 就应该是 `change-request`。 请在信中逐个提及每一个删除或增加的文件, 因为这些都必须明确地在使用 man:cvs[1] 进行 commit 时明确地指定。 如果 diff 超过了 20K, 请考虑压缩并对其进行 uuencode; 否则, 简单地将其原样加入 PR 即可。
-在您 man:send-pr[1] 之前, 请再次阅读 Problem Reports 一文中的 link:{problem-reports}#pr-writing/[ 如何撰写问题报告] 小节; 它给出了丰富的关于如何撰写更好的问题报告的介绍。
+在您 man:send-pr[1] 之前, 请再次阅读 Problem Reports 一文中的 extref:{problem-reports}[如何撰写问题报告, pr-writing] 小节; 它给出了丰富的关于如何撰写更好的问题报告的介绍。
[IMPORTANT]
====
@@ -85,7 +95,7 @@ toc::[]
<.> 当然, 这可以是您指定的任意目录; 联编 port 并不局限于 [.filename]#/usr/ports/# 的子目录。
-<.> R_CVSROOT 是任何一个公共的 cvs 镜像服务器, 您可以在 link:{handbook}#cvsup/[FreeBSD 使用手册] 中挑选一个。
+<.> R_CVSROOT 是任何一个公共的 cvs 镜像服务器, 您可以在 extref:{handbook}mirrors/[FreeBSD 使用手册, cvsup] 中挑选一个。
<.> pdnsd 是 port 的模块名字; 通常说来它和 port 的名字一样, 不过也有些例外, 特别是那些本地化类别 (package:german/selfhtml[] 对应的模块名字是 de-selfhtml); 您可以通过 link:https://www.FreeBSD.org/cgi/cvsweb.cgi/ports[cvsweb 界面] 查询, 或者也可以指定完整路径, 例如在我们这个例子中是 [.filename]#ports/dns/pdnsd#。
diff --git a/documentation/content/zh-cn/books/porters-handbook/porting-dads/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/porting-dads/chapter.adoc
index a31a409b40..b9e8cb4124 100644
--- a/documentation/content/zh-cn/books/porters-handbook/porting-dads/chapter.adoc
+++ b/documentation/content/zh-cn/books/porters-handbook/porting-dads/chapter.adoc
@@ -11,36 +11,46 @@ next: books/porters-handbook/porting-samplem
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dads-intro]]
== 介绍
-这里是一些在移植软件时可能会遇到的常见问题。 您应按照这个列表检查自己的 port, 同样地, 您也可以帮助检查 http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[PR 数据库] 中由其它人提交的 port。 请按照在 link:{contributing}#CONTRIB-GENERAL[问题报告和一般性注释] 中介绍的方法提交您的看法。 帮助检查 PR 数据库中的 ports 即能够帮助我们更快地 commit 它们, 也能证明您清楚地了解如何完成这些工作。
+这里是一些在移植软件时可能会遇到的常见问题。 您应按照这个列表检查自己的 port, 同样地, 您也可以帮助检查 http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[PR 数据库] 中由其它人提交的 port。 请按照在 extref:{contributing}[问题报告和一般性注释, CONTRIB-GENERAL] 中介绍的方法提交您的看法。 帮助检查 PR 数据库中的 ports 即能够帮助我们更快地 commit 它们, 也能证明您清楚地了解如何完成这些工作。
[[porting-wrkdir]]
== `WRKDIR` (联编时使用的临时目录)
-任何时候都不要在 `WRKDIR` 以外的位置写文件。 `WRKDIR` 是在 port 联编过程中唯一的一处一定可写的地方 (参见 link:{handbook}#PORTS-CD[如何从 CDROM 安装 port] 以了解从只读的目录中联编和安装 port 的例子)。 如果您需要改变 [.filename]##pkg-*## 文件, 请按照 <<porting-pkgfiles,重新定义某个变量>> 介绍的方法, 而不是覆盖它们来实现。
+任何时候都不要在 `WRKDIR` 以外的位置写文件。 `WRKDIR` 是在 port 联编过程中唯一的一处一定可写的地方 (参见 extref:{handbook}ports[如何从 CDROM 安装 port, PORTS-CD] 以了解从只读的目录中联编和安装 port 的例子)。 如果您需要改变 [.filename]##pkg-*## 文件, 请按照 <<porting-pkgfiles,重新定义某个变量>> 介绍的方法, 而不是覆盖它们来实现。
[[porting-wrkdirprefix]]
== `WRKDIRPREFIX` (用于联编的临时目录的父目录名)
diff --git a/documentation/content/zh-cn/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/porting-samplem/chapter.adoc
index 437b43628e..16a386b685 100644
--- a/documentation/content/zh-cn/books/porters-handbook/porting-samplem/chapter.adoc
+++ b/documentation/content/zh-cn/books/porters-handbook/porting-samplem/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/keeping-up
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
这里是一个您可以在建立新 port 时参考的 [.filename]#Makefile#。 请务必删除不需要的那些注释 (方括号中间的文字)!
diff --git a/documentation/content/zh-cn/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/quick-porting/chapter.adoc
index 3383e753c5..4e1c482cf7 100644
--- a/documentation/content/zh-cn/books/porters-handbook/quick-porting/chapter.adoc
+++ b/documentation/content/zh-cn/books/porters-handbook/quick-porting/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/slow
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
这一章将介绍如何快速创建一个全新的 port。 很多时候, 这点内容是不够的, 您需要阅读这份文档中更深入的内容。
@@ -190,7 +200,7 @@ PLIST_DIRS= lib/X11/oneko
既然已经对所制作的 port 相当满意了, 剩下的工作, 便是将它放进 FreeBSD 的主 ports 树, 以便让更多的人从中受益。 我们并不需要您的 [.filename]#work# 目录以及 [.filename]#pkgname.tgz# 包, 因此现在可以删除它们了。 假定您的 port 的名字是 oneko, 接下来要做的是 `cd` 到 `oneko` 所在的目录, 然后输入命令: `shar find oneko > oneko.shar`
-将这个 `oneko.shar` 文件作为附件, 使用 man:send-pr[1] 程序提交 (请参阅 link:{contributing}#CONTRIB-GENERAL[Bug Reports and General Commentary] 以了解关于 man:send-pr[1] 的进一步详情) 将其送出。 请务必将您的 bug 报告分类 (category) 为 `ports` 并把子分类 (class) 设置为 `change-request` (不要把报告表及为机密的, 即 `confidential`!)。 此外, 在 PR 的描述 ("Description") 一栏中的内容应该是 port 的简要介绍 (例如 `COMMENT` 内容的简化版本), 而 shar 文件则应填入修正 ("Fix") 栏中。
+将这个 `oneko.shar` 文件作为附件, 使用 man:send-pr[1] 程序提交 (请参阅 extref:{contributing}[Bug Reports and General Commentary, CONTRIB-GENERAL] 以了解关于 man:send-pr[1] 的进一步详情) 将其送出。 请务必将您的 bug 报告分类 (category) 为 `ports` 并把子分类 (class) 设置为 `change-request` (不要把报告表及为机密的, 即 `confidential`!)。 此外, 在 PR 的描述 ("Description") 一栏中的内容应该是 port 的简要介绍 (例如 `COMMENT` 内容的简化版本), 而 shar 文件则应填入修正 ("Fix") 栏中。
[NOTE]
====
@@ -201,4 +211,4 @@ PLIST_DIRS= lib/X11/oneko
在您提交的您的 port 以后请耐心等待。 有时在一个 port 正式加入 FreeBSD 之前需要花费好几个月, 尽管也有可能是几天。 您可以查看 http://www.FreeBSD.org/cgi/query-pr-summary.cgi?category=ports[ 正等待被 commit 到 FreeBSD 的 port PR]。
-一旦我们看过了您的报告, 有必要的话我们会联系您, 并把它放到 ports 树里。 您的名字也会出现在 link:{contributors}#contrib-additional/[Additional FreeBSD Contributors] 和其它的文件。 不是很棒吗!? :-)
+一旦我们看过了您的报告, 有必要的话我们会联系您, 并把它放到 ports 树里。 您的名字也会出现在 extref:{contributors}[Additional FreeBSD Contributors, contrib-additional] 和其它的文件。 不是很棒吗!? :-)
diff --git a/documentation/content/zh-cn/books/porters-handbook/security/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/security/chapter.adoc
index a2f0b6bbf7..d0cfa884c7 100644
--- a/documentation/content/zh-cn/books/porters-handbook/security/chapter.adoc
+++ b/documentation/content/zh-cn/books/porters-handbook/security/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/porting-dads
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-intro]]
== 安全为何如此重要
diff --git a/documentation/content/zh-cn/books/porters-handbook/slow/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/slow/chapter.adoc
index 75c039ac44..c83eba2142 100644
--- a/documentation/content/zh-cn/books/porters-handbook/slow/chapter.adoc
+++ b/documentation/content/zh-cn/books/porters-handbook/slow/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/makefile
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
好了, 也许工作没那么简单, port 需要做些修改才能够在 FreeBSD 上跑起来。 在这一章里, 我们将会一步步举例来介绍应该如何修改来使您的 port 能在 FreeBSD 上面运行。
diff --git a/documentation/content/zh-cn/books/porters-handbook/special/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/special/chapter.adoc
index 27edaed819..fce05bfac8 100644
--- a/documentation/content/zh-cn/books/porters-handbook/special/chapter.adoc
+++ b/documentation/content/zh-cn/books/porters-handbook/special/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/plist
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
有一些您在创建port时的特殊情况,我们在这里提一下。
@@ -2100,7 +2110,7 @@ USE_XFCE= mcsmanager configenv
[[rc-scripts]]
== 启动和停止服务 (rc 脚本)
-[.filename]#rc.d# 脚本在系统启动时用于启动服务, 并为管理员提供停止、 启动和重新启动某个服务的标准方法。 Ports 安装的脚本会集成到系统的 [.filename]#rc.d# 框架中。 关于如何使用它的说明, 可以在 link:{handbook}#configtuning-rcd/[使用手册的 rc.d 章节] 找到。 关于可用命令的详细解释, 则可以在 man:rc[8] 和 man:rc.subr[8] 找到。 最后, 您可以参阅 link:{rc-scripting}[这篇文章] 了解撰写 [.filename]#rc.d# 脚本的最佳实践。
+[.filename]#rc.d# 脚本在系统启动时用于启动服务, 并为管理员提供停止、 启动和重新启动某个服务的标准方法。 Ports 安装的脚本会集成到系统的 [.filename]#rc.d# 框架中。 关于如何使用它的说明, 可以在 extref:{handbook}config-tuning/[使用手册的 rc.d 章节, configtuning-rcd] 找到。 关于可用命令的详细解释, 则可以在 man:rc[8] 和 man:rc.subr[8] 找到。 最后, 您可以参阅 extref:{rc-scripting}[这篇文章] 了解撰写 [.filename]#rc.d# 脚本的最佳实践。
可以安装一或多个 [.filename]#rc.d# 脚本:
diff --git a/documentation/content/zh-cn/books/porters-handbook/testing/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/testing/chapter.adoc
index f515d6b1cd..85582be66d 100644
--- a/documentation/content/zh-cn/books/porters-handbook/testing/chapter.adoc
+++ b/documentation/content/zh-cn/books/porters-handbook/testing/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/port-upgrading
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[make-describe]]
== 运行 `make describe`
diff --git a/documentation/content/zh-cn/books/porters-handbook/why-port/chapter.adoc b/documentation/content/zh-cn/books/porters-handbook/why-port/chapter.adoc
index 8764466f84..9c96aacfc8 100644
--- a/documentation/content/zh-cn/books/porters-handbook/why-port/chapter.adoc
+++ b/documentation/content/zh-cn/books/porters-handbook/why-port/chapter.adoc
@@ -11,26 +11,36 @@ next: books/porters-handbook/own-port
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-cn/mailing-lists.adoc[]
-include::shared/zh-cn/teams.adoc[]
-include::shared/zh-cn/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
几乎每个人都是通过 FreeBSD Ports Collection 在 FreeBSD 上面装应用程序 ("`ports`")的。 就像FreeBSD的其它部分一样, 它主要来自于志愿者的努力。 所以在阅读这份文档的时候请务必记住这些。
diff --git a/documentation/content/zh-tw/articles/contributing/_index.adoc b/documentation/content/zh-tw/articles/contributing/_index.adoc
index 36ddcf9aa7..faf066201e 100644
--- a/documentation/content/zh-tw/articles/contributing/_index.adoc
+++ b/documentation/content/zh-tw/articles/contributing/_index.adoc
@@ -2,7 +2,6 @@
title: 幫助 FreeBSD
authors:
- author: Jordan Hubbard
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ieee", "general"]
---
@@ -15,27 +14,26 @@ trademarks: ["freebsd", "ieee", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+:images-path: articles/contributing/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -66,7 +64,7 @@ FreeBSD 計劃所處理的是一個完整的作業系統環境,而不只是一
很多參加 FreeBSD 計劃的人不是 Programmer。 這個計劃裡有文件撰寫者、網頁設計師、以及技術支援人員。 對於這些義工來說,他們只需要貢獻一些時間,並且具有學習的意願。
. 您可以時常翻閱 FAQ 和手冊(Handbook) ,如果發現有解釋不清楚的地方,或是不合時宜的文件,甚至完全不正確的地方, 都請告訴我們。當然,若能順手把他們修正,並把勘誤寄給我們,那就更好了。:) (SGML 其實並不難學,但我們也不反對您直接提交一般 ASCII 的純文字版本)。
-. 幫助我們把 FreeBSD 文件翻譯成你的母語。 如果你的母語版本已經存在了, 也可以翻譯一些額外的文件,或者檢查那些已有的文件是否為最新版。 您可以先簡單看看 FreeBSD 文件計劃中有關 link:{fdp-primer}#translations[翻譯時的常見問題]。 參加翻譯工作,並不是說您要孤軍奮戰翻譯所有 FreeBSD 文件。 身為義工,要做多少工作完全取決於您的意願。一旦某個人開始翻譯了, 之後幾乎一定會有其他人參與到這些工作中來。 如果時間有限,或者精力不夠去翻譯整份文件,那可以首先去翻譯安裝指南。
+. 幫助我們把 FreeBSD 文件翻譯成你的母語。 如果你的母語版本已經存在了, 也可以翻譯一些額外的文件,或者檢查那些已有的文件是否為最新版。 您可以先簡單看看 FreeBSD 文件計劃中有關 extref:{fdp-primer}[翻譯時的常見問題, translations]。 參加翻譯工作,並不是說您要孤軍奮戰翻譯所有 FreeBSD 文件。 身為義工,要做多少工作完全取決於您的意願。一旦某個人開始翻譯了, 之後幾乎一定會有其他人參與到這些工作中來。 如果時間有限,或者精力不夠去翻譯整份文件,那可以首先去翻譯安裝指南。
. 閱讀 {freebsd-questions} 並偶爾翻閱(甚至有規律地這樣做) link:news:comp.unix.bsd.freebsd.misc[comp.unix.bsd.freebsd.misc] 。與別人分享您的專業知識, 並幫助他們解決問題,是件令人愉悅的事情; 有時候,您甚至可以在這個過程中學到一些新東西! 這些論壇有時也會為您激發出一些不錯的想法。
[[ongoing-programmer-tasks]]
@@ -103,7 +101,7 @@ link:https://www.FreeBSD.org/projects/ideas/[FreeBSD list of projects and ideas
[[contrib-general]]
=== 錯誤報告和意見發表
-通常,__一般__ 的技術想法和建議應該發到 {freebsd-hackers}。 同樣地,對於這些東西有興趣的人 (當然, 他們同時還要能夠容忍 _大量的_ 郵件!) 可以考慮訂閱 {freebsd-hackers}。 請參閱 link:{handbook}#eresources-mail[FreeBSD 使用手冊] 以了解關於這個郵遞論壇, 以及其它郵遞論壇的詳細情況。
+通常,__一般__ 的技術想法和建議應該發到 {freebsd-hackers}。 同樣地,對於這些東西有興趣的人 (當然, 他們同時還要能夠容忍 _大量的_ 郵件!) 可以考慮訂閱 {freebsd-hackers}。 請參閱 extref:{handbook}eresources[FreeBSD 使用手冊, eresources-mail] 以了解關於這個郵遞論壇, 以及其它郵遞論壇的詳細情況。
如果您發現了 bug 或者想要提交某些修改, 請透過 man:send-pr[1] 程式或使用 link:https://www.FreeBSD.org/send-pr/[網頁介面 的回報] 來提交。請試著填寫 PR 的每個項目。 一般來說,除非 patch 檔超過 65 KB,我們建議在 PR 中直接附上 patch 就可以了。 若可直接套用 patch 到原始碼的話,那麼建議在 PR 的 Synopsis 欄位註明 `[PATCH]`。 對了,在附上 patch 時,請 _不要_ 透過滑鼠的『複製、貼上』來進行,因為這樣做會把 Tab 變成空格, 會導致 patch 就不能用了。如果 patch 超過 20KB, 請考慮壓縮它並使用 man:uuencode[1] 來進行編碼。
@@ -111,15 +109,15 @@ link:https://www.FreeBSD.org/projects/ideas/[FreeBSD list of projects and ideas
如果您在一段時間 (超過 3 天甚至 1 週,這取決於您的郵件服務)之後仍然沒有收到確認信 或者由於一些原因無法使用 man:send-pr[1] 程式, 則可以發信到 {freebsd-bugs} 來請別人幫你代寄。
-請參閱 link:{problem-reports}[這篇文章] 了解如何撰寫好的問題報告。
+請參閱 extref:{problem-reports}[這篇文章] 了解如何撰寫好的問題報告。
=== 對於文件的修訂
-文件的修改方面,是由 {freebsd-doc} 來審查。 請參閱 link:{fdp-primer}[FreeBSD Documentation Project Primer] 來獲得完整的教學細節。 請按照 <<contrib-general>> 中介紹的方法使用 man:send-pr[1] 來提交新的文件,或者改善現有的文件 (哪怕是很小的改進也是歡迎的!)。
+文件的修改方面,是由 {freebsd-doc} 來審查。 請參閱 extref:{fdp-primer}[FreeBSD Documentation Project Primer] 來獲得完整的教學細節。 請按照 <<contrib-general>> 中介紹的方法使用 man:send-pr[1] 來提交新的文件,或者改善現有的文件 (哪怕是很小的改進也是歡迎的!)。
=== 對於現有原始碼的修改
-在現有原始碼上進行修改或增加功能,在某種程度上是需要更多技巧的事, 並且還跟您對於目前 FreeBSD 的開發現狀了解程度有關。 有多種方式可以得到被稱作 "FreeBSD-CURRENT" 的 FreeBSD 開發版本。 請參閱 FreeBSD 使用手冊的 link:{handbook}#current-stable[相關部份] ,來了解使用 FreeBSD-CURRENT 的詳情。
+在現有原始碼上進行修改或增加功能,在某種程度上是需要更多技巧的事, 並且還跟您對於目前 FreeBSD 的開發現狀了解程度有關。 有多種方式可以得到被稱作 "FreeBSD-CURRENT" 的 FreeBSD 開發版本。 請參閱 FreeBSD 使用手冊的 extref:{handbook}updating-upgrading[相關部份, current-stable] ,來了解使用 FreeBSD-CURRENT 的詳情。
在舊的原始碼上進行修改,則通常可能原始碼已過時, 或與新的版本差異太大而無法被重新整合到 FreeBSD 中。 如果您有訂 {freebsd-announce} 以及 {freebsd-current} 的話, 則可以透過它們來大致了解目前的開發狀態。
@@ -244,4 +242,4 @@ FreeBSD 計劃歡迎任何人捐贈可以使用的硬體。 如果您有興趣
==== 成為 FreeBSD mirror 的網站
-我們歡迎新的 FTP、WWW 或 `cvsup` mirror 站。如果您希望成為這樣的 mirror 站, 請參閱 link:{hubs}[如何架設 FreeBSD mirror] 一文,以了解進一步的情況。
+我們歡迎新的 FTP、WWW 或 `cvsup` mirror 站。如果您希望成為這樣的 mirror 站, 請參閱 extref:{hubs}[如何架設 FreeBSD mirror] 一文,以了解進一步的情況。
diff --git a/documentation/content/zh-tw/articles/freebsd-questions/_index.adoc b/documentation/content/zh-tw/articles/freebsd-questions/_index.adoc
index c614749423..cef644d54d 100644
--- a/documentation/content/zh-tw/articles/freebsd-questions/_index.adoc
+++ b/documentation/content/zh-tw/articles/freebsd-questions/_index.adoc
@@ -3,7 +3,6 @@ title: 如何在 FreeBSD-questions mailing list 上得到正解
authors:
- author: Greg Lehey
email: grog@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "microsoft", "opengroup", "qualcomm", "general"]
---
@@ -16,27 +15,26 @@ trademarks: ["freebsd", "microsoft", "opengroup", "qualcomm", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+:images-path: articles/freebsd-questions/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -140,7 +138,7 @@ There are also a number of other specialized mailing lists, for example `FreeBSD
You can (and should) do some things yourself before asking a question on one of the mailing lists:
* Try solving the problem on your own. If you post a question which shows that you have tried to solve the problem, your question will generally attract more positive attention from people reading it. Trying to solve the problem yourself will also enhance your understanding of FreeBSD, and will eventually let you use your knowledge to help others by answering questions posted to the mailing lists.
-* Read the manual pages, and the FreeBSD documentation (either installed in [.filename]#/usr/doc# or accessible via WWW at http://www.FreeBSD.org[http://www.FreeBSD.org]), especially the link:{handbook}[handbook] and the link:{faq}[FAQ].
+* Read the manual pages, and the FreeBSD documentation (either installed in [.filename]#/usr/doc# or accessible via WWW at http://www.FreeBSD.org[http://www.FreeBSD.org]), especially the extref:{handbook}[handbook] and the extref:{faq}[FAQ].
* Browse and/or search the archives for the mailing list, to see if your question or a similar one has been asked (and possibly answered) on the list. You can browse and/or search the mailing list archives at http://www.FreeBSD.org/mail[http://www.FreeBSD.org/mail] and http://www.FreeBSD.org/search/#mailinglists[http://www.FreeBSD.org/search/#mailinglists] respectively. This can be done at other WWW sites as well, for example at http://marc.theaimsgroup.com[http://marc.theaimsgroup.com].
* Use a search engine such as http://www.google.com[Google] or http://www.yahoo.com[Yahoo] to find answers to your question. Google even has a http://www.google.com/bsd[BSD-specific search interface].
diff --git a/documentation/content/zh-tw/articles/hubs/_index.adoc b/documentation/content/zh-tw/articles/hubs/_index.adoc
index fb74f127f5..18e91f6cfa 100644
--- a/documentation/content/zh-tw/articles/hubs/_index.adoc
+++ b/documentation/content/zh-tw/articles/hubs/_index.adoc
@@ -9,7 +9,6 @@ authors:
email: dl@leo.org
- author: Ken Smith
email: kensmith@FreeBSD.org
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -22,24 +21,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
-include::shared/zh-tw/urls.adoc[]
+:images-path: articles/hubs/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/zh-tw/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/zh-tw/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -278,7 +279,7 @@ It is not so easy to state requirements for all official mirrors, since the proj
* allow access to other mirror sites
* provide ftp and rsync access
-Furthermore, admins should be subscribed to the http://lists.FreeBSD.org/mailman/listinfo/freebsd-hubs[FreeBSD mirror sites mailing lists]. See link:{handbook}#eresources-mail[this link] for details, how to subscribe.
+Furthermore, admins should be subscribed to the http://lists.FreeBSD.org/mailman/listinfo/freebsd-hubs[FreeBSD mirror sites mailing lists]. See extref:{handbook}eresources[this link, eresources-mail] for details, how to subscribe.
[IMPORTANT]
====
diff --git a/documentation/content/zh-tw/articles/leap-seconds/_index.adoc b/documentation/content/zh-tw/articles/leap-seconds/_index.adoc
index 3ec5291688..21b68da4b1 100644
--- a/documentation/content/zh-tw/articles/leap-seconds/_index.adoc
+++ b/documentation/content/zh-tw/articles/leap-seconds/_index.adoc
@@ -1,6 +1,5 @@
---
title: FreeBSD 對潤秒的支援
-releaseinfo: "$FreeBSD$"
---
= FreeBSD 對潤秒的支援
@@ -12,24 +11,26 @@ releaseinfo: "$FreeBSD$"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
-include::shared/zh-tw/urls.adoc[]
+:images-path: articles/leap-seconds/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/zh-tw/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/zh-tw/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -50,7 +51,7 @@ __潤秒__是為了同步地球自轉,與原子鐘所做的特定一秒的修
[[leapseconds-posix]]
== FreeBSD預設的潤秒處理
-最簡單的處理潤秒方法使用FreeBSD預設的 POSIX 時間規則,並使用 link:{handbook}#network-ntp[NTP]。如果 man:ntpd[8] 在執行,而且時間和上游正確處理潤秒的 NTP 伺服器同步,潤秒會使系統時間自動重複當天的最後一秒。不需要其他調整。
+最簡單的處理潤秒方法使用FreeBSD預設的 POSIX 時間規則,並使用 extref:{handbook}network-servers[NTP, network-ntp]。如果 man:ntpd[8] 在執行,而且時間和上游正確處理潤秒的 NTP 伺服器同步,潤秒會使系統時間自動重複當天的最後一秒。不需要其他調整。
如果上游的 NTP 伺服器無法正確地處理潤秒,man:ntpd[8] 會在錯誤的上游伺服器發現錯誤並跳一秒後,跟著把時間跳一秒。
diff --git a/documentation/content/zh-tw/articles/mailing-list-faq/_index.adoc b/documentation/content/zh-tw/articles/mailing-list-faq/_index.adoc
index 469ee37646..8fe433e1f5 100644
--- a/documentation/content/zh-tw/articles/mailing-list-faq/_index.adoc
+++ b/documentation/content/zh-tw/articles/mailing-list-faq/_index.adoc
@@ -3,7 +3,6 @@ title: FreeBSD Mailing Lists 常見問答集
authors:
- author: The FreeBSD Documentation Project
copyright: 2004-2006 FreeBSD 文件計畫
-releaseinfo: "$FreeBSD$"
---
= FreeBSD Mailing Lists 常見問答集
@@ -15,30 +14,26 @@ releaseinfo: "$FreeBSD$"
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
+:images-path: articles/mailing-list-faq/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -98,7 +93,7 @@ FreeBSD mailing lists 主要是提供 FreeBSD 社群間的溝通管道,這裡
=== 在發文之前,有什麼注意事項呢?
-最重要的是你已經看了這篇文章,然而,若您對 FreeBSD 不熟的話, 可能需要先廣泛閱讀 link:https://www.FreeBSD.org/docs/books/[相關書籍及文章] 來先熟悉這套作業系統和一些典故,尤其是其中的 link:{faq}[FreeBSD 常見問答集 (FAQ)] 文件,link:{handbook}[FreeBSD 使用手冊(Handbook)],以及相關文章:link:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list]、link:{explaining-bsd}[Explaining BSD]、以及 link:{new-users}[FreeBSD First Steps]。
+最重要的是你已經看了這篇文章,然而,若您對 FreeBSD 不熟的話, 可能需要先廣泛閱讀 link:https://www.FreeBSD.org/docs/books/[相關書籍及文章] 來先熟悉這套作業系統和一些典故,尤其是其中的 extref:{faq}[FreeBSD 常見問答集 (FAQ)] extref:{handbook}[FreeBSD 使用手冊(Handbook)]extref:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list]extref:{explaining-bsd}[Explaining BSD]、以及 extref:{new-users}[FreeBSD First Steps]。
此外,對上述文件內已有解答的部份又提出來問的話,會被認為是相當不禮貌的。 這並不是因為這群志工是相當吝於回答的,而是一再被相同的問題不斷疲勞轟炸之後,所產生的挫折感很重。 尤其是現成答案明明就在眼前,卻仍同樣問題滿天飛,這實在是...。 請注意:這些 FreeBSD 相關文件幾乎都是由一群無薪志工的好心成果,而他們也是人。
@@ -167,7 +162,7 @@ archives 的內容無疑地相當廣泛,而且會有些問題不斷反覆出
[[bikeshed]]
== 什麼是 "Bikeshed" 呀?
-單就字面上意思解釋的話,`bikeshed` 是指專門給腳踏車、機車之類的兩輪交通工具使用的遮雨棚, 然而呢,在 FreeBSD 這邊的說法卻有其他意思(帶有貶抑)指的是: 某些特定話題的重複討論,尤其是指在 FreeBSD 社群內絕不會有共識,且有爭議的話題。 (這字彙的起源在 link:{faq}#BIKESHED-PAINTING[這份文件] 內有更多說明)。你只要在發信到任一 FreeBSD mailing lists 之前,知道這個基本概念就行了。
+單就字面上意思解釋的話,`bikeshed` 是指專門給腳踏車、機車之類的兩輪交通工具使用的遮雨棚, 然而呢,在 FreeBSD 這邊的說法卻有其他意思(帶有貶抑)指的是: 某些特定話題的重複討論,尤其是指在 FreeBSD 社群內絕不會有共識,且有爭議的話題。 (這字彙的起源在 extref:{faq}[這份文件, BIKESHED-PAINTING] 內有更多說明)。你只要在發信到任一 FreeBSD mailing lists 之前,知道這個基本概念就行了。
一般來講,『bikeshed』是很容易產生許多波的筆戰與額外討論的爭議話題,如果事先不知道這些背景的話。
@@ -177,7 +172,7 @@ archives 的內容無疑地相當廣泛,而且會有些問題不斷反覆出
== 致謝
`{grog}`::
-link:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list] 一文的原作者, 我們從他這文內獲得許多 mailing list 上的禮儀(或默契)寫作題材。
+extref:{freebsd-questions-article}[How to get best results from the FreeBSD-questions mailing list] 一文的原作者, 我們從他這文內獲得許多 mailing list 上的禮儀(或默契)寫作題材。
`{linimon}`::
本 FAQ 雛形的原作
diff --git a/documentation/content/zh-tw/articles/nanobsd/_index.adoc b/documentation/content/zh-tw/articles/nanobsd/_index.adoc
index 3315fa790b..f9f349824e 100644
--- a/documentation/content/zh-tw/articles/nanobsd/_index.adoc
+++ b/documentation/content/zh-tw/articles/nanobsd/_index.adoc
@@ -3,7 +3,6 @@ title: NanoBSD 簡介
authors:
- author: Daniel Gerzo
copyright: 2006 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -16,24 +15,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
+:images-path: articles/nanobsd/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
diff --git a/documentation/content/zh-tw/articles/pr-guidelines/_index.adoc b/documentation/content/zh-tw/articles/pr-guidelines/_index.adoc
index 203fa06a0e..234e88d592 100644
--- a/documentation/content/zh-tw/articles/pr-guidelines/_index.adoc
+++ b/documentation/content/zh-tw/articles/pr-guidelines/_index.adoc
@@ -3,7 +3,6 @@ title: 問題回報(PR)的處理原則
authors:
- author: Dag-Erling Smørgrav
- author: Hiten Pandya
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "opengroup", "general"]
---
@@ -16,27 +15,26 @@ trademarks: ["freebsd", "opengroup", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+:images-path: articles/pr-guidelines/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -464,4 +462,4 @@ Junk PRs are not backed up, so filing spam mail under this category makes it obv
下面這是在寫、處理 PR 時,可以參考的資料。當然很明顯,這份清單仍須補充。
-* link:{problem-reports}[How to Write FreeBSD Problem Reports]-給 PR 回報者用的參考原則。
+* extref:{problem-reports}[How to Write FreeBSD Problem Reports]-給 PR 回報者用的參考原則。
diff --git a/documentation/content/zh-tw/articles/problem-reports/_index.adoc b/documentation/content/zh-tw/articles/problem-reports/_index.adoc
index e3f264be10..1d52733c39 100644
--- a/documentation/content/zh-tw/articles/problem-reports/_index.adoc
+++ b/documentation/content/zh-tw/articles/problem-reports/_index.adoc
@@ -3,7 +3,6 @@ title: Writing FreeBSD Problem Reports
authors:
- author: Dag-Erling Smørgrav
- author: Mark Linimon
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "cvsup", "ibm", "intel", "sparc", "sun", "general"]
---
@@ -16,30 +15,26 @@ trademarks: ["freebsd", "cvsup", "ibm", "intel", "sparc", "sun", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
-include::shared/en/teams.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+:images-path: articles/problem-reports/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -78,7 +73,7 @@ For unmaintained ports (`MAINTAINER` contains `ports@FreeBSD.org`), such update
+
If the port is maintained, PRs announcing new upstream releases are usually not very useful since they generate supplementary work for the committers, and the maintainer likely knows already there is a new version, they have probably worked with the developers on it, they are probably testing to see there is no regression, etc.
+
-In either case, following the process described in link:{porters-handbook}#port-upgrading[Porter's Handbook] will yield the best results.
+In either case, following the process described in extref:{porters-handbook}[Porter's Handbook, port-upgrading] will yield the best results.
A bug that can not be reproduced can rarely be fixed. If the bug only occurred once and you can not reproduce it, and it does not seem to happen to anybody else, chances are none of the developers will be able to reproduce it or figure out what is wrong. That does not mean it did not happen, but it does mean that the chances of your problem report ever leading to a bug fix are very slim. To make matters worse, often these kinds of bugs are actually caused by failing hard drives or overheating processors - you should always try to rule out these causes, whenever possible, before submitting a PR.
@@ -90,7 +85,7 @@ Next, to decide to whom you should file your problem report, you need to underst
Then you should ascertain whether or not the problem is timely. There are few things that will annoy a developer more than receiving a problem report about a bug she has already fixed.
-If the problem is in the base system, you should first read the FAQ section on link:{faq}#LATEST-VERSION[FreeBSD versions], if you are not already familiar with the topic. It is not possible for FreeBSD to fix problems in anything other than certain recent branches of the base system, so filing a bug report about an older version will probably only result in a developer advising you to upgrade to a supported version to see if the problem still recurs. The Security Officer team maintains the http://www.freebsd.org/security/[list of supported versions].
+If the problem is in the base system, you should first read the FAQ section on extref:{faq}[FreeBSD versions, LATEST-VERSION], if you are not already familiar with the topic. It is not possible for FreeBSD to fix problems in anything other than certain recent branches of the base system, so filing a bug report about an older version will probably only result in a developer advising you to upgrade to a supported version to see if the problem still recurs. The Security Officer team maintains the http://www.freebsd.org/security/[list of supported versions].
If the problem is in a port, note that you must first upgrade to the latest version of the Ports Collection and see if the problem still applies. Due to the rapid pace of changes in these applications, it is infeasible for FreeBSD to support anything other than the absolute latest versions, and problems with older version of applications simply cannot be fixed.
@@ -99,8 +94,8 @@ If the problem is in a port, note that you must first upgrade to the latest vers
A good rule to follow is to always do a background search before submitting a problem report. Maybe your problem has already been reported; maybe it is being discussed on the mailing lists, or recently was; it may even already be fixed in a newer version than what you are running. You should therefore check all the obvious places before submitting your problem report. For FreeBSD, this means:
-* The FreeBSD link:{faq}[Frequently Asked Questions] (FAQ) list. The FAQ attempts to provide answers for a wide range of questions, such as those concerning link:{faq}#hardware[hardware compatibility], link:{faq}#applications[user applications], and link:{faq}#kernelconfig[kernel configuration].
-* The link:{handbook}#eresources-mail[mailing lists]-if you are not subscribed, use http://www.FreeBSD.org/search/#mailinglists[the searchable archives] on the FreeBSD web site. If your problem has not been discussed on the lists, you might try posting a message about it and waiting a few days to see if someone can spot something you have overlooked.
+* The FreeBSD extref:{faq}[Frequently Asked Questions] (FAQ) list. The FAQ attempts to provide answers for a wide range of questions, such as those concerning extref:{faq}[hardware compatibility, hardware], extref:{faq}[user applications, applications], and extref:{faq}[kernel configuration, kernelconfig].
+* The extref:{handbook}[mailing lists, eresources-mail]-if you are not subscribed, use http://www.FreeBSD.org/search/#mailinglists[the searchable archives] on the FreeBSD web site. If your problem has not been discussed on the lists, you might try posting a message about it and waiting a few days to see if someone can spot something you have overlooked.
* Optionally, the entire web-use your favorite search engine to locate any references to your problem. You may even get hits from archived mailing lists or newsgroups you did not know of or had not thought to search through.
* Next, the searchable http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query[FreeBSD PR database] (GNATS). Unless your problem is recent or obscure, there is a fair chance it has already been reported.
* Most importantly, you should attempt to see if existing documentation in the source base addresses your problem.
@@ -147,7 +142,7 @@ Now that you have decided that your issue merits a problem report, and that it i
If you are using the man:send-pr[1] program, make sure your `VISUAL` (or `EDITOR` if `VISUAL` is not set) environment variable is set to something sensible.
-You should also make sure that mail delivery works fine. man:send-pr[1] uses mail messages for the submission and tracking of problem reports. If you cannot post mail messages from the machine you are running man:send-pr[1] on, your problem report will not reach the GNATS database. For details on the setup of mail on FreeBSD, see the "Electronic Mail" chapter of the FreeBSD Handbook at link:{handbook}#mail[Electronic Mail].
+You should also make sure that mail delivery works fine. man:send-pr[1] uses mail messages for the submission and tracking of problem reports. If you cannot post mail messages from the machine you are running man:send-pr[1] on, your problem report will not reach the GNATS database. For details on the setup of mail on FreeBSD, see the "Electronic Mail" chapter of the FreeBSD Handbook at extref:{handbook}mail[Electronic Mail, mail].
Make sure that your mailer will not mangle the message on its way to GNATS. In particular, if your mailer automatically breaks lines, changes tabs to spaces, or escapes newline characters, any patch that you submit will be rendered unusable. For the text sections, however, we request that you insert manual linebreaks somewhere around 70 characters, so that the web display of the PR will be readable.
@@ -337,4 +332,4 @@ On rare occasions you will encounter a GNATS bug where a PR is accepted and assi
This is a list of resources relevant to the proper writing and processing of problem reports. It is by no means complete.
* http://www.chiark.greenend.org.uk/~sgtatham/bugs.html[How to Report Bugs Effectively]-an excellent essay by Simon G. Tatham on composing useful (non-FreeBSD-specific) problem reports.
-* link:{pr-guidelines}[Problem Report Handling Guidelines]-valuable insight into how problem reports are handled by the FreeBSD developers.
+* extref:{pr-guidelines}[Problem Report Handling Guidelines]-valuable insight into how problem reports are handled by the FreeBSD developers.
diff --git a/documentation/content/zh-tw/articles/remote-install/_index.adoc b/documentation/content/zh-tw/articles/remote-install/_index.adoc
index e8b75cca4e..70813bd948 100644
--- a/documentation/content/zh-tw/articles/remote-install/_index.adoc
+++ b/documentation/content/zh-tw/articles/remote-install/_index.adoc
@@ -4,7 +4,6 @@ authors:
- author: Daniel Gerzo
email: danger@FreeBSD.org
copyright: 2008 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "general"]
---
@@ -17,27 +16,26 @@ trademarks: ["freebsd", "general"]
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-
-ifeval::["{backend}" == "html5"]
+:images-path: articles/remote-install/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -194,7 +192,7 @@ ifconfig_re0="inet 192.168.0.2 netmask 255.255.255.0"
# dd if=/dev/zero of=/dev/ad0 count=2
....
-接著,以您慣用的工具來建立 slice 以及設定 label。 通常會建議以 的 Sysinstall 工具來作會比較輕鬆, 或者是強而又不太會出槌的文字介面 UNIX(R) 標準工具(像是 man:fdisk[8], man:bsdlabel[8]),這部分稍後也會一併介紹。 前者部分在 FreeBSD Handbook 的 link:{handbook}#install-steps[安裝 FreeBSD] 章節有相當詳盡的介紹,所以這邊主要要介紹的是如何建立 RAID-1 系統以及 ZFS。 這邊會介紹建立以 man:gmirror[8] 做成的小型 mirrored 檔案系統: [.filename]#/# (根目錄), [.filename]#/usr# 以及 [.filename]#/var#,而硬碟的其餘剩餘空間則通通以 man:zpool[8] 做成 ZFS 的 mirrored 檔案系統 。 請注意:必須要先把 FreeBSD 作業系統裝好並開完機後,才能進行設定 ZFS 檔案系統。
+接著,以您慣用的工具來建立 slice 以及設定 label。 通常會建議以 的 Sysinstall 工具來作會比較輕鬆, 或者是強而又不太會出槌的文字介面 UNIX(R) 標準工具(像是 man:fdisk[8], man:bsdlabel[8]),這部分稍後也會一併介紹。 前者部分在 FreeBSD Handbook 的 extref:{handbook}install-steps[安裝 FreeBSD, install] 章節有相當詳盡的介紹,所以這邊主要要介紹的是如何建立 RAID-1 系統以及 ZFS。 這邊會介紹建立以 man:gmirror[8] 做成的小型 mirrored 檔案系統: [.filename]#/# (根目錄), [.filename]#/usr# 以及 [.filename]#/var#,而硬碟的其餘剩餘空間則通通以 man:zpool[8] 做成 ZFS 的 mirrored 檔案系統 。 請注意:必須要先把 FreeBSD 作業系統裝好並開完機後,才能進行設定 ZFS 檔案系統。
下面的例子會介紹如何建立 slice 以及 label、在每個分割區上啟用 man:gmirror[8]、如何在每個 mirrored 分割區上建立 UFS2 檔案系統:
diff --git a/documentation/content/zh-tw/books/developers-handbook/_index.adoc b/documentation/content/zh-tw/books/developers-handbook/_index.adoc
index 4f2d623cd0..6a63a67756 100644
--- a/documentation/content/zh-tw/books/developers-handbook/_index.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/_index.adoc
@@ -3,8 +3,8 @@ title: FreeBSD Developers' Handbook
authors:
- author: FreeBSD 文件計畫
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "ibm", "ieee", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
+trademarks: ["freebsd", "ibm", "ieee", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "general"]
+isIndex: true
---
= FreeBSD Developers' Handbook
@@ -12,51 +12,35 @@ trademarks: ["freebsd", "ibm", "ieee", "apple", "intel", "linux", "microsoft", "
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:book: true
+:pdf: false
+:images-path: books/developers-handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-:imagesdir: ../../../../images/books/developers-handbook/
-:chapters-path: content/zh-tw/books/developers-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/developers-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
-:imagesdir: ../../../../static/images/books/developers-handbook/
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
-:imagesdir: ../../../../static/images/books/developers-handbook/
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -65,7 +49,7 @@ endif::[]
歡迎使用 Developers' Handbook! 這份文件是由許多人 _不斷撰寫_ 而成的, 而且許多章節仍需更新或者內容還是一片空白, 如果你想幫忙 FreeBSD 文件計劃, 請寄信到 {freebsd-doc}。
-最新版的文件都在 link:https://www.FreeBSD.org[FreeBSD 官網] 上面, 也可從 link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[FreeBSD FTP server] 下載不同格式的資料。 當然也可以在其他的 link:{handbook}#mirrors-ftp/[mirror站]下載。
+最新版的文件都在 link:https://www.FreeBSD.org[FreeBSD 官網] 上面, 也可從 link:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/[FreeBSD FTP server] 下載不同格式的資料。 當然也可以在其他的 extref:{handbook}mirrors/[mirror站, mirrors-ftp]下載。
'''
@@ -75,29 +59,29 @@ toc::[]
[[basics]]
= 基本概念
-include::{chapters-path}introduction/chapter.adoc[leveloffset=+1, lines=10..30;40..-1]
-include::{chapters-path}tools/chapter.adoc[leveloffset=+1, lines=10..35;45..-1]
-include::{chapters-path}secure/chapter.adoc[leveloffset=+1, lines=9..29;39..-1]
-include::{chapters-path}l10n/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}policies/chapter.adoc[leveloffset=+1, lines=10..30;40..-1]
-include::{chapters-path}testing/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
+include::{chapters-path}introduction/chapter.adoc[leveloffset=+1]
+include::{chapters-path}tools/chapter.adoc[leveloffset=+1]
+include::{chapters-path}secure/chapter.adoc[leveloffset=+1]
+include::{chapters-path}l10n/chapter.adoc[leveloffset=+1]
+include::{chapters-path}policies/chapter.adoc[leveloffset=+1]
+include::{chapters-path}testing/chapter.adoc[leveloffset=+1]
// Section two
[[ipc]]
= Interprocess Communication(IPC)
-include::{chapters-path}sockets/chapter.adoc[leveloffset=+1, lines=9..29;40..-1]
-include::{chapters-path}ipv6/chapter.adoc[leveloffset=+1, lines=9..29;39..-1]
+include::{chapters-path}sockets/chapter.adoc[leveloffset=+1]
+include::{chapters-path}ipv6/chapter.adoc[leveloffset=+1]
// Section three
[[kernel]]
= Kernel(核心)
-include::{chapters-path}kernelbuild/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}kerneldebug/chapter.adoc[leveloffset=+1, lines=11..31;41..-1]
+include::{chapters-path}kernelbuild/chapter.adoc[leveloffset=+1]
+include::{chapters-path}kerneldebug/chapter.adoc[leveloffset=+1]
// Section four
[[architectures]]
= Architectures(電腦架構)
-include::{chapters-path}x86/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
+include::{chapters-path}x86/chapter.adoc[leveloffset=+1]
// Appendices
-include::{chapters-path}bibliography/chapter.adoc[leveloffset=+1, lines=6..20;28..-1]
+include::{chapters-path}bibliography/chapter.adoc[leveloffset=+1]
diff --git a/documentation/content/zh-tw/books/developers-handbook/bibliography/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/bibliography/chapter.adoc
index b35397cdd2..1642722b36 100644
--- a/documentation/content/zh-tw/books/developers-handbook/bibliography/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/bibliography/chapter.adoc
@@ -10,20 +10,37 @@ prev: books/developers-handbook/x86
:toc: macro
:toclevels: 1
:icons: font
-:sectnums!:
+:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[COD,1]] [1] Dave A Patterson and John L Hennessy. Copyright(R) 1998 Morgan Kaufmann Publishers, Inc. 1-55860-428-6. Morgan Kaufmann Publishers, Inc. Computer Organization and Design. The Hardware / Software Interface. 1-2.
diff --git a/documentation/content/zh-tw/books/developers-handbook/introduction/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/introduction/chapter.adoc
index b81f6a6d52..61ee4970a5 100644
--- a/documentation/content/zh-tw/books/developers-handbook/introduction/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/introduction/chapter.adoc
@@ -14,28 +14,36 @@ next: books/developers-handbook/tools
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-devel]]
== 在 FreeBSD 開發程式
diff --git a/documentation/content/zh-tw/books/developers-handbook/ipv6/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/ipv6/chapter.adoc
index 02f69a0f4d..5cf1433a1e 100644
--- a/documentation/content/zh-tw/books/developers-handbook/ipv6/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/ipv6/chapter.adoc
@@ -13,28 +13,36 @@ next: books/developers-handbook/kernelbuild
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ipv6-implementation]]
== IPv6/IPsec Implementation
diff --git a/documentation/content/zh-tw/books/developers-handbook/kernelbuild/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/kernelbuild/chapter.adoc
index c01d4aa826..0c4a4c4153 100644
--- a/documentation/content/zh-tw/books/developers-handbook/kernelbuild/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/kernelbuild/chapter.adoc
@@ -11,36 +11,44 @@ next: books/developers-handbook/kerneldebug
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Being a kernel developer requires understanding of the kernel build process. To debug the FreeBSD kernel it is required to be able to build one. There are two known ways to do so:
-The supported procedure to build and install a kernel is documented in the link:{handbook}#kernelconfig-building[Building and Installing a Custom Kernel] chapter of the FreeBSD Handbook.
+The supported procedure to build and install a kernel is documented in the extref:{handbook}kernelconfig/[Building and Installing a Custom Kernel, kernelconfig-building] chapter of the FreeBSD Handbook.
[NOTE]
====
-It is supposed that the reader of this chapter is familiar with the information described in the link:{handbook}#kernelconfig-building[Building and Installing a Custom Kernel] chapter of the FreeBSD Handbook. If this is not the case, please read through the above mentioned chapter to understand how the build process works.
+It is supposed that the reader of this chapter is familiar with the information described in the extref:{handbook}kernelconfig/[Building and Installing a Custom Kernel, kernelconfig-building] chapter of the FreeBSD Handbook. If this is not the case, please read through the above mentioned chapter to understand how the build process works.
====
[[kernelbuild-traditional]]
diff --git a/documentation/content/zh-tw/books/developers-handbook/kerneldebug/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/kerneldebug/chapter.adoc
index 94cff71150..50b8de3416 100644
--- a/documentation/content/zh-tw/books/developers-handbook/kerneldebug/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/kerneldebug/chapter.adoc
@@ -15,28 +15,36 @@ next: books/developers-handbook/x86
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kerneldebug-obtain]]
== Obtaining a Kernel Crash Dump
@@ -280,7 +288,7 @@ options KDB
options DDB
....
-to your config file, and rebuild. (See link:{handbook}/[The FreeBSD Handbook] for details on configuring the FreeBSD kernel).
+to your config file, and rebuild. (See extref:{handbook}/[The FreeBSD Handbook] for details on configuring the FreeBSD kernel).
Once your DDB kernel is running, there are several ways to enter DDB. The first, and earliest way is to use the boot flag `-d`. The kernel will start up in debug mode and enter DDB prior to any device probing. Hence you can even debug the device probe/attach functions. To use this, exit the loader's boot menu and enter `boot -d` at the loader prompt.
diff --git a/documentation/content/zh-tw/books/developers-handbook/l10n/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/l10n/chapter.adoc
index b95a6e5c75..849d840a4e 100644
--- a/documentation/content/zh-tw/books/developers-handbook/l10n/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/l10n/chapter.adoc
@@ -11,28 +11,36 @@ next: books/developers-handbook/policies
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-programming]]
== Programming I18N Compliant Applications
diff --git a/documentation/content/zh-tw/books/developers-handbook/policies/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/policies/chapter.adoc
index 3fa6638788..91cbf6b295 100644
--- a/documentation/content/zh-tw/books/developers-handbook/policies/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/policies/chapter.adoc
@@ -14,28 +14,36 @@ next: books/developers-handbook/testing
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
This chapter documents various guidelines and policies in force for the FreeBSD source tree.
diff --git a/documentation/content/zh-tw/books/developers-handbook/secure/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/secure/chapter.adoc
index 742a2c43d8..ec5a9cc4f5 100644
--- a/documentation/content/zh-tw/books/developers-handbook/secure/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/secure/chapter.adoc
@@ -13,28 +13,36 @@ next: books/developers-handbook/l10n
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[secure-synopsis]]
== Synopsis
diff --git a/documentation/content/zh-tw/books/developers-handbook/sockets/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/sockets/chapter.adoc
index 80e6284948..db0b2db27e 100644
--- a/documentation/content/zh-tw/books/developers-handbook/sockets/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/sockets/chapter.adoc
@@ -13,29 +13,36 @@ next: books/developers-handbook/ipv6
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-:imagesdir: ../../../../images/books/developers-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[sockets-synopsis]]
== Synopsis
diff --git a/documentation/content/zh-tw/books/developers-handbook/testing/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/testing/chapter.adoc
index 9e730710de..7bf62f89e2 100644
--- a/documentation/content/zh-tw/books/developers-handbook/testing/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/testing/chapter.adoc
@@ -11,28 +11,36 @@ next: books/developers-handbook/sockets
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Regression tests are used to exercise a particular bit of the system to check that it works as expected, and to make sure that old bugs are not reintroduced.
diff --git a/documentation/content/zh-tw/books/developers-handbook/tools/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/tools/chapter.adoc
index ba8dcd4f44..fe6852d1d0 100644
--- a/documentation/content/zh-tw/books/developers-handbook/tools/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/tools/chapter.adoc
@@ -15,32 +15,39 @@ next: books/developers-handbook/secure
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:c-plus-plus-command: c++
:g-plus-plus-command: g++
:lg-plus-plus: -lg++
:lstdc-plus-plus: -lstdc++
-:sectnumoffset: 2
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[tools-synopsis]]
== 概敘
@@ -73,7 +80,7 @@ FreeBSD 提供一個非常棒的開發環境, 比如說像是 C、C++、Fortra
下面這邊有份 Ports Collection 所提供的直譯器清單,還有討論一些比較受歡迎的直譯式語言
-至於如何使用 Ports Collection 安裝的說明,可參閱 FreeBSD Handbook 中的 link:{handbook}ports-using[Ports章節]。
+至於如何使用 Ports Collection 安裝的說明,可參閱 FreeBSD Handbook 中的 extref:{handbook}ports[Ports章節, ports-using]。
BASIC::
BASIC 是 Beginner's ALL-purpose Symbolic Instruction Code 的縮寫。 BASIC 於 1950 年代開始發展,最初開發這套語言的目的是為了教導當時的大學學生如何寫程式。 到了 1980,BASIC已經是很多 programmer 第一個學習的程式語言了。 此外,BASIC 也是 Visual Basic 的基礎。
@@ -622,10 +629,10 @@ The standard debugger supplied with FreeBSD {rel121-current} is called `lldb` (L
[NOTE]
====
-The `lldb` command is available for FreeBSD {rel113-current} link:{handbook}#ports-using/[from ports or packages] as package:devel/llvm[]. This will install the default version of lldb (currently 9.0).
+The `lldb` command is available for FreeBSD {rel113-current} extref:{handbook}ports/[from ports or packages, ports-using] as package:devel/llvm[]. This will install the default version of lldb (currently 9.0).
====
-The other debugger available with FreeBSD is called `gdb` (GNU debugger). Unlike lldb, it is not installed by default on FreeBSD {rel121-current}; to use it, link:{handbook}#ports-using/[install] package:devel/gdb[] from ports or packages. The version installed by default on FreeBSD {rel113-current} is old; instead, install package:devel/gdb[] there as well. It has quite good on-line help, as well as a set of info pages.
+The other debugger available with FreeBSD is called `gdb` (GNU debugger). Unlike lldb, it is not installed by default on FreeBSD {rel121-current}; to use it, extref:{handbook}ports/[install, ports-using] package:devel/gdb[] from ports or packages. The version installed by default on FreeBSD {rel113-current} is old; instead, install package:devel/gdb[] there as well. It has quite good on-line help, as well as a set of info pages.
Which one to use is largely a matter of taste. If familiar with one only, use that one. People familiar with neither or both but wanting to use one from inside Emacs will need to use `gdb` as `lldb` is unsupported by Emacs. Otherwise, try both and see which one you prefer.
diff --git a/documentation/content/zh-tw/books/developers-handbook/x86/chapter.adoc b/documentation/content/zh-tw/books/developers-handbook/x86/chapter.adoc
index 876f940252..fa49e3d364 100644
--- a/documentation/content/zh-tw/books/developers-handbook/x86/chapter.adoc
+++ b/documentation/content/zh-tw/books/developers-handbook/x86/chapter.adoc
@@ -11,28 +11,36 @@ next: books/developers-handbook/bibliography
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
+:images-path: books/developers-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
_This chapter was written by {stanislav}._
diff --git a/documentation/content/zh-tw/books/faq/_index.adoc b/documentation/content/zh-tw/books/faq/_index.adoc
index 59b4a7d274..b1b3ae06e0 100644
--- a/documentation/content/zh-tw/books/faq/_index.adoc
+++ b/documentation/content/zh-tw/books/faq/_index.adoc
@@ -3,8 +3,8 @@ title: FreeBSD 11.X and 12.X 常見問答集
authors:
- author: FreeBSD 文件計畫
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
+trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"]
+isIndex: true
---
= FreeBSD {rel2-relx} and {rel-relx} 常見問答集
@@ -12,60 +12,46 @@ trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "
:toc: macro
:toclevels: 1
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:rel-numbranch: 3
-:rel-head: 13-CURRENT
-:rel-head-relx: 13.X
+:images-path: books/faq/
+:rel-numbranch: 4
+:rel-head: 14-CURRENT
+:rel-head-relx: 14.X
:rel-head-releng: head/
-:rel-relx: 12.X
-:rel-stable: 12-STABLE
-:rel-releng: stable/12/
+:rel-relx: 13.X
+:rel-stable: 13-STABLE
+:rel-releng: stable/13/
:rel-relengdate: December 2018
-:rel2-relx: 11.X
-:rel2-stable: 11-STABLE
-:rel2-releng: stable/11/
-:rel2-relengdate: October 2016
-
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+:rel2-relx: 12.X
+:rel2-stable: 12-STABLE
+:rel2-releng: stable/12/
+:rel2-relengdate: December 2018
+:rel3-relx: 11.X
+:rel3-stable: 11-STABLE
+:rel3-releng: stable/11/
+:rel3-relengdate: October 2016
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/en/mailing-lists.adoc[]
-include::../../../../shared/en/teams.adoc[]
-include::../../../../shared/en/urls.adoc[]
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -73,7 +59,7 @@ endif::[]
這份文件是 FreeBSD {rel-relx} 和 {rel2-relx} 常見問答集 ( (FAQ) )。我們盡可能地讓這份 FAQ 提供有用的資訊 ; 如果您有任何改善建議,請寄到 http://lists.FreeBSD.org/mailman/listinfo/freebsd-doc[FreeBSD 文件計畫郵件論壇]。
-本文件的最新版本可由 link:{faq}[FreeBSD 網站]取得。 也可以由 https://download.freebsd.org/ftp/doc/[FreeBSD FTP 伺服器] 以 HTTP 下載單一大型 link:.[HTML] 檔或是其他格式的檔案。
+本文件的最新版本可由 extref:{faq}[FreeBSD 網站]取得。 也可以由 https://download.freebsd.org/ftp/doc/[FreeBSD FTP 伺服器] 以 HTTP 下載單一大型 link:.[HTML] 檔或是其他格式的檔案。
'''
@@ -89,7 +75,7 @@ FreeBSD 是一個使用於桌機、筆電、伺服器與嵌入式系統平台的
FreeBSD 已被廣泛地被世界各地的公司行號、ISP、研究人員、電腦 專家、學生,以及家庭用戶所使用,用在工作、教育以及娛樂上。
-如果想看關於 FreeBSD 更深入的資料,請看 link:{handbook}[FreeBSD 使用手冊]。
+如果想看關於 FreeBSD 更深入的資料,請看 extref:{handbook}[FreeBSD 使用手冊]。
=== 發展 FreeBSD 計畫的目的是什麼?
@@ -115,7 +101,7 @@ FreeBSD 計畫的目的是提供可以任意使用且沒有限制的穩定快速
但是如果你想要使用的應用程式只能在某個特定的作業系統上面執行 的話,你就不能輕易地把它換掉,或者指望在 FreeBSD 上有很相似的應用程式才有機會。如果你想要的是一個強健的辦公室或是網路伺服器,或是一部穩定的工作站,FreeBSD 無疑是您的最佳選擇。世界各地有很多使用者,包括初學或資深的 UNIX(TM) 管理人員都選用 FreeBSD 當他們唯一的桌上作業系統。
-如果你是從其他的 UNIX(TM)-like 環境轉換到 FreeBSD 的話會很熟悉。 Windows(TM) 或是 Mac OS(TM) 的使用者可能會對 https://www.trueos.org[TrueOS] 有興趣,他是基於 FreeBSD 的一個桌面環境發行版,非UNIX(TM) 使用者可能就要多花一點時間來學習怎麼用 UNIX(TM) 的 方法來做事。你可以從這份 FAQ 和 link:{handbook}[FreeBSD 使用手冊] 來入門。
+如果你是從其他的 UNIX(TM)-like 環境轉換到 FreeBSD 的話會很熟悉。 Windows(TM) 或是 Mac OS(TM) 的使用者可能會對 https://www.trueos.org[TrueOS] 有興趣,他是基於 FreeBSD 的一個桌面環境發行版,非UNIX(TM) 使用者可能就要多花一點時間來學習怎麼用 UNIX(TM) 的 方法來做事。你可以從這份 FAQ 和 extref:{handbook}[FreeBSD 使用手冊] 來入門。
=== 為什麼要叫做 FreeBSD?
@@ -151,7 +137,7 @@ Releases 版 <<release-freq,每幾個月>> 才會發行一次。 雖然如此,
=== 什麼是 FreeBSD-CURRENT?
-link:{handbook}#current[FreeBSD-CURRENT] 指的是正在發展中的作業系統版本,它終將在適當的時機成為 FreeBSD-STABLE 分支。它實在是只適合給系統發展者以及有毅力的業餘愛好者使用 。如果想要得到有關如何使用__-CURRENT__的深入資訊,請參考link:{handbook}[使用手冊]的link:{handbook}#current[相關部份]。
+extref:{handbook}updating-upgrading[FreeBSD-CURRENT, current] 指的是正在發展中的作業系統版本,它終將在適當的時機成為 FreeBSD-STABLE 分支。它實在是只適合給系統發展者以及有毅力的業餘愛好者使用 。如果想要得到有關如何使用__-CURRENT__的深入資訊,請參考extref:{handbook}[使用手冊]的extref:{handbook}updating-upgrading[相關部份, current]。
如果您對 FreeBSD 本身並不是很熟悉那麼您就不應該使用FreeBSD-CURRENT。 這個分支的程式碼有時候變動得很快,而且可能會因此 而使您有好幾天的時間無法更新您的系統。我們假設使用 FreeBSD-CURRENT 的使用者都有能力去分析他們所遇到的問題,除錯,並且回報問題。
@@ -170,7 +156,7 @@ link:{handbook}#current[FreeBSD-CURRENT] 指的是正在發展中的作業系統
=== 什麼是 FreeBSD-STABLE ?
-回溯到 FreeBSD 2.0.5 剛發表的時候,我們決定把 FreeBSD 的發展 分成兩支。一支叫做 link:{handbook}#stable[-STABLE],另一支叫 link:{handbook}#current[-CURRENT]。主要發行版是由__FreeBSD-STABLE__ 這個開發分支而來。他的變動較慢,而且一般來說假設他們都已經先在FreeBSD-CURRENT測試過了。然而在任何時候,FreeBSD-STABLE的原始碼仍有可能不一定適合一般用途,因為他可能包含在 FreeBSD-CURRENT 沒有發現到的錯誤。沒有能力和資源的使用者應該改使用 FreeBSD 正式發行版。_FreeBSD-CURRENT_ 從2.0開始就是另一個分支,一直到12.0-RELEASE和之後的版本都還是。更多關於開發分支的資訊請見 "link:{handbook}#rel-branch[FreeBSD Release Engineering: Creating the Release Branch]" ,分支的開發狀態和接下來的發行計畫時間表可以在 https://www.FreeBSD.org/releng[Release Engineering 資訊] 找到。
+回溯到 FreeBSD 2.0.5 剛發表的時候,我們決定把 FreeBSD 的發展 分成兩支。一支叫做 extref:{handbook}updating-upgrading[-STABLE, stable],另一支叫 extref:{handbook}updating-upgrading[-CURRENT, current]。主要發行版是由__FreeBSD-STABLE__ 這個開發分支而來。他的變動較慢,而且一般來說假設他們都已經先在FreeBSD-CURRENT測試過了。然而在任何時候,FreeBSD-STABLE的原始碼仍有可能不一定適合一般用途,因為他可能包含在 FreeBSD-CURRENT 沒有發現到的錯誤。沒有能力和資源的使用者應該改使用 FreeBSD 正式發行版。_FreeBSD-CURRENT_ 從2.0開始就是另一個分支,一直到12.0-RELEASE和之後的版本都還是。更多關於開發分支的資訊請見 "extref:{handbook}[FreeBSD Release Engineering: Creating the Release Branch]" ,分支的開發狀態和接下來的發行計畫時間表可以在 https://www.FreeBSD.org/releng[Release Engineering 資訊] 找到。
12.0-STABLE 是目前正在發展中的 _-STABLE_ 分支。最新的 12.0-STABLE 是在 2018年12月發行的 12.0-RELEASE。
@@ -186,7 +172,7 @@ _12-CURRENT_ 這個分支是 FreeBSD 的 _-CURRENT_ 分支,仍然不斷地在
=== 誰負責 FreeBSD 的發展?
-如果是一些有關 FreeBSD 計畫的關鍵性決定,像是整個計畫的走向 或是決定誰可以改 source tree 裡的程式碼這類的事,是由一個由 9 個 人所組成的 https://www.FreeBSD.org/administration/#t-core[core team] 來決定。而有另一群超過 350 個人的 link:{contributors}#staff-committers[committers] 有權利可以直接修改 FreeBSD 的 source tree。
+如果是一些有關 FreeBSD 計畫的關鍵性決定,像是整個計畫的走向 或是決定誰可以改 source tree 裡的程式碼這類的事,是由一個由 9 個 人所組成的 https://www.FreeBSD.org/administration/#t-core[core team] 來決定。而有另一群超過 350 個人的 extref:{contributors}[committers, staff-committers] 有權利可以直接修改 FreeBSD 的 source tree。
無論如何,大多數的改變都會事前在 <<mailing,郵件論壇>>先討論過,而且不分角色,每個人都可以參與討論。
@@ -198,7 +184,7 @@ Every significant release of FreeBSD is available via anonymous FTP from the lin
* <<current,-CURRENT>> 和 <<stable,-STABLE>> 分支的link:https://www.FreeBSD.org/snapshots/[Snapshot]版本通常每個月會做一次, 主要是為了提供給那些熱心的測試者和開發人員。
* The latest _11-STABLE_ release, 10.4-RELEASE can be found in the link:ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/10.4-RELEASE/[10.4-RELEASE directory].
-FreeBSD 的 CD、DVD,還有其他取得方式可以在 link:{handbook}#mirrors[the Handbook] 中找到解答。
+FreeBSD 的 CD、DVD,還有其他取得方式可以在 extref:{handbook}mirrors[the Handbook, mirrors] 中找到解答。
=== 我要如何去查詢、提交問題回報(Problem Report,簡稱PR)資料庫呢?
@@ -206,13 +192,13 @@ FreeBSD 的 CD、DVD,還有其他取得方式可以在 link:{handbook}#mirrors
可以使用瀏覽器經由link:https://www.FreeBSD.org/support/bugreports/[網頁版的 PR 界面] 來傳送問題回報
-然而,在您回報問題之前,請先閱讀 link:{problem-reports}[如何撰寫 FreeBSD 的問題回報單],這是一篇告訴你怎樣才能寫出一篇真正有用的問題回報單。
+然而,在您回報問題之前,請先閱讀 extref:{problem-reports}[如何撰寫 FreeBSD 的問題回報單],這是一篇告訴你怎樣才能寫出一篇真正有用的問題回報單。
== 文件與技術支援
=== 有哪些 FreeBSD 相關的好書呢?
-FreeBSD 文件計畫已陸續發表了相當廣泛範圍的文件,可在 https://www.FreeBSD.org/docs/[https://www.FreeBSD.org/docs/] 取得。除此之外,也可以參閱使用手冊的 link:{handbook}#bibliography[參考書目]建議的其他書籍。
+FreeBSD 文件計畫已陸續發表了相當廣泛範圍的文件,可在 https://www.FreeBSD.org/docs/[https://www.FreeBSD.org/docs/] 取得。除此之外,也可以參閱使用手冊的 extref:{handbook}bibliography[參考書目, bibliography]建議的其他書籍。
=== 這些文件有其他格式的嗎?像是:純文字(ASCII)或 PostScript 之類的格式?
@@ -346,7 +332,7 @@ FreeBSD 文件計畫已陸續發表了相當廣泛範圍的文件,可在 https
=== 哪裡有關於 FreeBSD 的郵遞論壇(mailing lists)呢? 有哪些可以使用的 FreeBSD 新聞群組(news groups)呢?
-請參考FreeBSD 使用手冊上的 link:{handbook}#eresources-mail[郵件論壇 (mailing-lists)] 。
+請參考FreeBSD 使用手冊上的 extref:{handbook}eresources[郵件論壇 (mailing-lists), eresources-mail] 。
=== 有 FreeBSD IRC (Internet Relay Chat)頻道嗎?
@@ -406,7 +392,7 @@ Any of the following can be used:
|A minimal image that requires network access during installation to completely install FreeBSD.
|===
-Full instructions on this procedure and a little bit more about installation issues in general can be found in the link:{handbook}#bsdinstall[Handbook entry on installing FreeBSD].
+Full instructions on this procedure and a little bit more about installation issues in general can be found in the extref:{handbook}bsdinstall[Handbook entry on installing FreeBSD, bsdinstall].
=== What do I do if the install image does not boot?
@@ -418,7 +404,7 @@ When using a command line FTP client, type _binary_ at the FTP command prompt af
=== 可以在哪邊找到安裝 FreeBSD 的解說步驟呢?
-安裝說明可以在 link:{handbook}#bsdinstall[使用手冊的安裝 FreeBSD] 找到。
+安裝說明可以在 extref:{handbook}bsdinstall[使用手冊的安裝 FreeBSD, bsdinstall] 找到。
=== 要跑 FreeBSD 至少需要什麼樣的配備呢?
@@ -426,7 +412,7 @@ FreeBSD 需要 486 以上的 PC,64 MB 以上的 RAM,和至少 1.1 GB 的硬
=== 要怎樣才能自行打造專用的安裝磁片呢?
-可以透過編譯客製化發行版本來建立客製化的 FreeBSD 安裝媒體。請參閱 link:{releng}[Release Engineering] 文章的說明。
+可以透過編譯客製化發行版本來建立客製化的 FreeBSD 安裝媒體。請參閱 extref:{releng}[Release Engineering] 文章的說明。
=== Windows 可以與 FreeBSD 共存嗎?
@@ -516,7 +502,7 @@ PAE is not much used nowadays because most new x86 hardware also supports runnin
==== Does FreeBSD support architectures other than the x86?
-Yes. FreeBSD divides support into multiple tiers. Tier 1 architectures, such as i386 or amd64; are fully supported. Tiers 2 and 3 are supported on a best-effort basis. A full explanation of the tier system is available in the link:{committers-guide}#archs[Committer's Guide.]
+Yes. FreeBSD divides support into multiple tiers. Tier 1 architectures, such as i386 or amd64; are fully supported. Tiers 2 and 3 are supported on a best-effort basis. A full explanation of the tier system is available in the extref:{committers-guide}[Committer's Guide., archs]
A complete list of supported architectures can be found on the https://www.FreeBSD.org/platforms/[platforms page.]
@@ -691,7 +677,7 @@ The FreeBSD developers are interested in these errors, but need more information
The FreeBSD kernel will only allow a certain number of processes to exist at one time. The number is based on the `kern.maxusers` man:sysctl[8] variable. `kern.maxusers` also affects various other in-kernel limits, such as network buffers. If the machine is heavily loaded, increase `kern.maxusers`. This will increase these other system limits in addition to the maximum number of processes.
-To adjust the `kern.maxusers` value, see the link:{handbook}#kern-maxfiles[File/Process Limits] section of the Handbook. While that section refers to open files, the same limits apply to processes.
+To adjust the `kern.maxusers` value, see the extref:{handbook}config-tuning[File/Process Limits, kern-maxfiles] section of the Handbook. While that section refers to open files, the same limits apply to processes.
If the machine is lightly loaded but running a very large number of processes, adjust the `kern.maxproc` tunable by defining it in [.filename]#/boot/loader.conf#. The tunable will not get adjusted until the system is rebooted. For more information about tuning tunables, see man:loader.conf[5]. If these processes are being run by a single user, adjust `kern.maxprocperuid` to be one less than the new `kern.maxproc` value. It must be at least one less because one system program, man:init[8], must always be running.
@@ -721,7 +707,7 @@ Following a fresh install of FreeBSD, it is also possible that domain and name s
=== Why does file: table is full show up repeatedly in dmesg8?
-This error message indicates that the number of available file descriptors have been exhausted on the system. Refer to the link:{handbook}#kern-maxfiles[kern.maxfiles] section of the link:{handbook}#configtuning-kernel-limits[Tuning Kernel Limits] section of the Handbook for a discussion and solution.
+This error message indicates that the number of available file descriptors have been exhausted on the system. Refer to the extref:{handbook}config-tuning[kern.maxfiles, kern-maxfiles] section of the extref:{handbook}config-tuning[Tuning Kernel Limits, configtuning-kernel-limits] section of the Handbook for a discussion and solution.
=== Why does the clock on my computer keep incorrect time?
@@ -819,8 +805,8 @@ FreeBSD supports compressed binary packages to easily install and uninstall port
Any of the methods listed here work:
-* Use portsnap for most use cases. Refer to link:{handbook}#ports-using[Using the Ports Collection] for instructions on how to use this tool.
-* Use Subversion if custom patches to the ports tree are needed. Refer to link:{handbook}#svn[Using Subversion] for details.
+* Use portsnap for most use cases. Refer to extref:{handbook}ports[Using the Ports Collection, ports-using] for instructions on how to use this tool.
+* Use Subversion if custom patches to the ports tree are needed. Refer to extref:{handbook}mirrors[Using Subversion, svn] for details.
=== Does FreeBSD support Java?
@@ -828,7 +814,7 @@ Yes. Refer to https://www.FreeBSD.org/java/[https://www.FreeBSD.org/java/] for m
=== Why can I not build this port on my 11.X -, or 12.X -STABLE machine?
-If the installed FreeBSD version lags significantly behind _-CURRENT_ or _-STABLE_, update the Ports Collection using the instructions in link:{handbook}#ports-using[Using the Ports Collection]. If the system is up-to-date, someone might have committed a change to the port which works for _-CURRENT_ but which broke the port for _-STABLE_. https://bugs.FreeBSD.org/submit/[Submit] a bug report, since the Ports Collection is supposed to work for both the _-CURRENT_ and _-STABLE_ branches.
+If the installed FreeBSD version lags significantly behind _-CURRENT_ or _-STABLE_, update the Ports Collection using the instructions in extref:{handbook}ports[Using the Ports Collection, ports-using]. If the system is up-to-date, someone might have committed a change to the port which works for _-CURRENT_ but which broke the port for _-STABLE_. https://bugs.FreeBSD.org/submit/[Submit] a bug report, since the Ports Collection is supposed to work for both the _-CURRENT_ and _-STABLE_ branches.
=== I just tried to build INDEX using make index, and it failed. Why?
@@ -838,7 +824,7 @@ There are rare cases where [.filename]#INDEX# will not build due to odd cases in
=== I updated the sources, now how do I update my installed ports?
-FreeBSD does not include a port upgrading tool, but it does have some tools to make the upgrade process somewhat easier. Additional tools are available to simplify port handling and are described the link:{handbook}#ports-using[Upgrading Ports] section in the FreeBSD Handbook.
+FreeBSD does not include a port upgrading tool, but it does have some tools to make the upgrade process somewhat easier. Additional tools are available to simplify port handling and are described the extref:{handbook}ports[Upgrading Ports, ports-using] section in the FreeBSD Handbook.
=== Do I need to recompile every port each time I perform a major version update?
@@ -846,7 +832,7 @@ Yes! While a recent system will run with software compiled under an older releas
When the system is upgraded, various shared libraries, loadable modules, and other parts of the system will be replaced with newer versions. Applications linked against the older versions may fail to start or, in other cases, fail to function properly.
-For more information, see link:{handbook}#freebsdupdate-upgrade[the section on upgrades] in the FreeBSD Handbook.
+For more information, see extref:{handbook}updating-upgrading[the section on upgrades, freebsdupdate-upgrade] in the FreeBSD Handbook.
=== Do I need to recompile every port each time I perform a minor version update?
@@ -867,14 +853,14 @@ To create audio CDs from MIDI files, first install package:audio/timidity[] from
% timidity -Ow -s 44100 -o /tmp/juke/01.wav 01.mid
....
-The WAV files can then be converted to other formats or burned onto audio CDs, as described in the link:{handbook}#creating-cds[FreeBSD Handbook].
+The WAV files can then be converted to other formats or burned onto audio CDs, as described in the extref:{handbook}disks[FreeBSD Handbook, creating-cds].
== Kernel Configuration
[[make-kernel]]
=== I would like to customize my kernel. Is it difficult?
-Not at all! Check out the link:{handbook}#kernelconfig[kernel config section of the Handbook].
+Not at all! Check out the extref:{handbook}kernelconfig[kernel config section of the Handbook, kernelconfig].
[NOTE]
====
@@ -920,7 +906,7 @@ Replace _accf_httpd ipfw_ with a list of needed modules. Only the listed modules
Unneeded devices can be removed from the kernel to further reduce the size. See <<make-kernel>> for more information.
-To put any of these options into effect, follow the instructions to link:{handbook}#kernelconfig-building[build and install] the new kernel.
+To put any of these options into effect, follow the instructions to extref:{handbook}kernelconfig/[build and install, kernelconfig-building] the new kernel.
For reference, the FreeBSD 11 amd64 kernel ([.filename]#/boot/kernel/kernel#) is approximately 25 MB.
@@ -950,7 +936,7 @@ kern.sched.name: ULE
=== How can I add my new hard disk to my FreeBSD system?
-See the link:{handbook}#disks-adding[Adding Disks] section in the FreeBSD Handbook.
+See the extref:{handbook}disks[Adding Disks, disks-adding] section in the FreeBSD Handbook.
=== How do I move my system over to my huge new disk?
@@ -1057,7 +1043,7 @@ The secondary DOS partitions are found after _all_ the primary partitions. For e
=== Is there a cryptographic file system for FreeBSD?
-Yes, man:gbde[8] and man:geli[8]. See the link:{handbook}#disks-encrypting[Encrypting Disk Partitions] section of the FreeBSD Handbook.
+Yes, man:gbde[8] and man:geli[8]. See the extref:{handbook}disks[Encrypting Disk Partitions, disks-encrypting] section of the FreeBSD Handbook.
=== How do I boot FreeBSD and Linux using GRUB?
@@ -1123,23 +1109,23 @@ It is a good idea to add a line to [.filename]#/etc/fstab# (see man:fstab[5]) so
=== Why do I get Incorrect super block when mounting a CD?
-The type of device to mount must be specified. This is described in the Handbook section on link:{handbook}#mounting-cd[Using Data CDs].
+The type of device to mount must be specified. This is described in the Handbook section on extref:{handbook}disks[Using Data CDs, mounting-cd].
=== Why do I get Device not configured when mounting a CD?
-This generally means that there is no CD in the drive, or the drive is not visible on the bus. Refer to the link:{handbook}#mounting-cd[Using Data CDs] section of the Handbook for a detailed discussion of this issue.
+This generally means that there is no CD in the drive, or the drive is not visible on the bus. Refer to the extref:{handbook}disks[Using Data CDs, mounting-cd] section of the Handbook for a detailed discussion of this issue.
=== Why do all non-English characters in filenames show up as ? on my CDs when mounted in FreeBSD?
-The CD probably uses the "Joliet" extension for storing information about files and directories. This is discussed in the Handbook section on link:{handbook}#mounting-cd[Using Data CD-ROMs].
+The CD probably uses the "Joliet" extension for storing information about files and directories. This is discussed in the Handbook section on extref:{handbook}disks[Using Data CD-ROMs, mounting-cd].
=== A CD burned under FreeBSD cannot be read under any other operating system. Why?
-This means a raw file was burned to the CD, rather than creating an ISO 9660 file system. Take a look at the Handbook section on link:{handbook}#mounting-cd[Using Data CDs].
+This means a raw file was burned to the CD, rather than creating an ISO 9660 file system. Take a look at the Handbook section on extref:{handbook}disks[Using Data CDs, mounting-cd].
=== How can I create an image of a data CD?
-This is discussed in the Handbook section on link:{handbook}#mkisofs[Writing Data to an ISO File System]. For more on working with CD-ROMs, see the link:{handbook}#creating-cds[Creating CDs Section] in the Storage chapter in the Handbook.
+This is discussed in the Handbook section on extref:{handbook}disks[Writing Data to an ISO File System, mkisofs]. For more on working with CD-ROMs, see the extref:{handbook}disks[Creating CDs Section, creating-cds] in the Storage chapter in the Handbook.
=== Why can I not mount an audio CD?
@@ -1205,7 +1191,7 @@ Note that Soft Updates can delay the freeing of disk space and it can take up to
=== How can I add more swap space?
-This section link:{handbook}#adding-swap-space[of the Handbook] describes how to do this.
+This section extref:{handbook}config-tuning[of the Handbook, adding-swap-space] describes how to do this.
=== Why does FreeBSD see my disk as smaller than the manufacturer says it is?
@@ -1334,11 +1320,11 @@ After performing these steps, edit [.filename]#/etc/rc.conf# to fix the syntax e
=== Why am I having trouble setting up my printer?
-See the link:{handbook}#printing[Handbook entry on printing] for troubleshooting tips.
+See the extref:{handbook}printing[Handbook entry on printing, printing] for troubleshooting tips.
=== How can I correct the keyboard mappings for my system?
-Refer to the Handbook section on link:{handbook}#using-localization[using localization], specifically the section on link:{handbook}#setting-console[console setup].
+Refer to the Handbook section on extref:{handbook}l10n[using localization, using-localization], specifically the section on extref:{handbook}l10n[console setup, setting-console].
=== Why can I not get user quotas to work properly?
@@ -1350,7 +1336,7 @@ options QUOTA
....
+
-Refer to the link:{handbook}#quotas[Handbook entry on quotas] for full details.
+Refer to theextref:{handbook}disks[Handbook entry on quotas, quotas] for full details.
. Do not turn on quotas on [.filename]#/#.
. Put the quota file on the file system that the quotas are to be enforced on:
+
@@ -1398,7 +1384,7 @@ If you are still prompted to give the `root` password when entering the single-u
[NOTE]
====
-If the root partition cannot be mounted from single-user mode, it is possible that the partitions are encrypted and it is impossible to mount them without the access keys. For more information see the section about encrypted disks in the FreeBSD link:{handbook}#disks-encrypting[Handbook].
+If the root partition cannot be mounted from single-user mode, it is possible that the partitions are encrypted and it is impossible to mount them without the access keys. For more information see the section about encrypted disks in the FreeBSD extref:{handbook}disks[Handbook, disks-encrypting].
====
=== How do I keep ControlAltDelete from rebooting the system?
@@ -1463,7 +1449,7 @@ Long answer: FreeBSD derives its releases from one of two places. Major, dot-zer
When a release is about to be made, the branch from which it will be derived from has to undergo a certain process. Part of this process is a code freeze. When a code freeze is initiated, the name of the branch is changed to reflect that it is about to become a release. For example, if the branch used to be called 6.2-STABLE, its name will be changed to 6.3-PRERELEASE to signify the code freeze and signify that extra pre-release testing should be happening. Bug fixes can still be committed to be part of the release. When the source code is in shape for the release the name will be changed to 6.3-RC to signify that a release is about to be made from it. Once in the RC stage, only the most critical bugs found can be fixed. Once the release (6.3-RELEASE in this example) and release branch have been made, the branch will be renamed to 6.3-STABLE.
-For more information on version numbers and the various Subversion branches, refer to the link:{releng}[Release Engineering] article.
+For more information on version numbers and the various Subversion branches, refer to the extref:{releng}[Release Engineering] article.
=== I tried to install a new kernel, and the chflags1 failed. How do I get around this?
@@ -1561,7 +1547,7 @@ Install Xorg from FreeBSD packages:
# pkg install xorg
....
-After the installation of Xorg, follow the instructions from the link:{handbook}#x-config[X11 Configuration] section of the FreeBSD Handbook.
+After the installation of Xorg, follow the instructions from the extref:{handbook}x11[X11 Configuration, x-config] section of the FreeBSD Handbook.
=== I tried to run X, but I get a No devices detected. error when I type startx. What do I do now?
@@ -1770,7 +1756,7 @@ Type `xmodmap -e "pointer = 3 2 1"`. Add this command to [.filename]#~/.xinitrc#
=== How do I install a splash screen and where do I find them?
-The detailed answer for this question can be found in the link:{handbook}#boot-splash[Boot Time Splash Screens] section of the FreeBSD Handbook.
+The detailed answer for this question can be found in the extref:{handbook}boot[Boot Time Splash Screens, boot-splash] section of the FreeBSD Handbook.
=== Can I use the Windows keys on my keyboard in X?
@@ -1836,29 +1822,29 @@ For ATI Rage 128 and Radeon see man:ati[4], man:r128[4] and man:radeon[4].
=== Where can I get information on diskless booting?
-"Diskless booting" means that the FreeBSD box is booted over a network, and reads the necessary files from a server instead of its hard disk. For full details, see link:{handbook}#network-diskless[the Handbook entry on diskless booting].
+"Diskless booting" means that the FreeBSD box is booted over a network, and reads the necessary files from a server instead of its hard disk. For full details, see extref:{handbook}advanced-networking[the Handbook entry on diskless booting, network-diskless].
=== Can a FreeBSD box be used as a dedicated network router?
-Yes. Refer to the Handbook entry on link:{handbook}#advanced-networking[advanced networking], specifically the section on link:{handbook}#network-routing[routing and gateways].
+Yes. Refer to the Handbook entry on extref:{handbook}advanced-networking[advanced networking, advanced-networking], specifically the section on extref:{handbook}advanced-networking[routing and gateways, network-routing].
=== Can I connect my Windows box to the Internet via FreeBSD?
Typically, people who ask this question have two PCs at home, one with FreeBSD and one with some version of Windows(TM) the idea is to use the FreeBSD box to connect to the Internet and then be able to access the Internet from the Windows(TM) box through the FreeBSD box. This is really just a special case of the previous question and works perfectly well.
-Dialup users must use `-nat` and set `gateway_enable` to _YES_ in [.filename]#/etc/rc.conf#. For more information, refer to man:ppp[8] or the link:{handbook}#userppp[Handbook entry on user PPP].
+Dialup users must use `-nat` and set `gateway_enable` to _YES_ in [.filename]#/etc/rc.conf#. For more information, refer to man:ppp[8] or the extref:{handbook}ppp-and-slip[Handbook entry on user PPP, userppp].
-If the connection to the Internet is over Ethernet, use man:natd[8]. A tutorial can be found in the link:{handbook}#network-natd[natd] section of the Handbook.
+If the connection to the Internet is over Ethernet, use man:natd[8]. A tutorial can be found in the extref:{handbook}[natd, network-natd] section of the Handbook.
=== Does FreeBSD support PPP?
Yes. man:ppp[8] provides support for both incoming and outgoing connections.
-For more information on how to use this, refer to the link:{handbook}#ppp-and-slip/[Handbook chapter on PPP].
+For more information on how to use this, refer to the extref:{handbook}ppp-and-slip/[Handbook chapter on PPP, ppp-and-slip].
=== Does FreeBSD support NAT or Masquerading?
-Yes. For instructions on how to use NAT over a PPP connection, see the link:{handbook}#userppp[Handbook entry on PPP]. To use NAT over some other sort of network connection, look at the link:{handbook}#network-natd[natd] section of the Handbook.
+Yes. For instructions on how to use NAT over a PPP connection, see the extref:{handbook}ppp-and-slip[Handbook entry on PPP, userppp]. To use NAT over some other sort of network connection, look at the extref:{handbook}[natd, network-natd] section of the Handbook.
=== How can I set up Ethernet aliases?
@@ -1876,7 +1862,7 @@ Otherwise, specify the network address and netmask as usual:
# ifconfig ed0 alias 172.16.141.5 netmask 0xffffff00
....
-More information can be found in the FreeBSD link:{handbook}#configtuning-virtual-hosts/[Handbook].
+More information can be found in the FreeBSD extref:{handbook}config-tuning/[Handbook, configtuning-virtual-hosts].
=== Why can I not NFS-mount from a Linux box?
@@ -1889,7 +1875,7 @@ Some versions of the Linux(TM) NFS code only accept mount requests from a privil
=== Why does mountd keep telling me it can't change attributes and that I have a bad exports list on my FreeBSD NFS server?
-The most frequent problem is not understanding the correct format of [.filename]#/etc/exports#. Review man:exports[5] and the link:{handbook}#network-nfs/[NFS] entry in the Handbook, especially the section on link:{handbook}#configuring-nfs[configuring NFS].
+The most frequent problem is not understanding the correct format of [.filename]#/etc/exports#. Review man:exports[5] and the extref:{handbook}network-servers/[NFS, network-nfs] entry in the Handbook, especially the section on extref:{handbook}[configuring NFS, configuring-nfs].
=== How do I enable IP multicast support?
@@ -1897,7 +1883,7 @@ Install the package:net/mrouted[] package or port and add `mrouted_enable="YES"`
=== Why do I have to use the FQDN for hosts on my site?
-See the answer in the FreeBSD link:{handbook}#mail-trouble[Handbook].
+See the answer in the FreeBSD extref:{handbook}mail[Handbook, mail-trouble].
=== Why do I get an error, Permission denied, for all networking operations?
@@ -1912,7 +1898,7 @@ If the firewall is unintentionally misconfigured, restore network operability by
Consider setting `firewall_type="open"` in [.filename]#/etc/rc.conf#.
-For further information on configuring this firewall, see the link:{handbook}#firewalls-ipfw[Handbook chapter].
+For further information on configuring this firewall, see the extref:{handbook}firewalls[Handbook chapter, firewalls-ipfw].
=== Why is my ipfw fwd rule to redirect a service to another machine not working?
@@ -2084,7 +2070,7 @@ Some people use `toor` for day-to-day `root` tasks with a non-standard shell, le
=== I cannot make ppp8 work. What am I doing wrong?
-First, read man:ppp[8] and the link:{handbook}#userppp[PPP section of the Handbook]. To assist in troubleshooting, enable logging with the following command:
+First, read man:ppp[8] and the extref:{handbook}ppp-and-slip[PPP section of the Handbook, userppp]. To assist in troubleshooting, enable logging with the following command:
[.programlisting]
....
@@ -2134,7 +2120,7 @@ Another reason for the default route line being missing is that a default route
delete ALL
....
-If this is the case, go back to the link:{handbook}#userppp-final[Final System Configuration] section of the Handbook.
+If this is the case, go back to the extref:{handbook}ppp-and-slip[Final System Configuration, userppp-final] section of the Handbook.
=== What does No route to host mean?
@@ -2155,7 +2141,7 @@ delete ALL
add 0 0 HISADDR
....
-Refer to the link:{handbook}#userppp-dynamicip[PPP and Dynamic IP addresses] section of the Handbook for further details.
+Refer to the extref:{handbook}[PPP and Dynamic IP addresses, userppp-dynamicip] section of the Handbook for further details.
=== Why does my connection drop after about 3 minutes?
@@ -2330,7 +2316,7 @@ set dfilter 3 permit 0/0 0/0
This is not always suitable, as it will effectively break demand-dial capabilities. Most programs will need a DNS lookup before doing any other network related things.
-In the DNS case, try to determine what is actually trying to resolve a host name. A lot of the time, Sendmail is the culprit. Make sure to configure Sendmail not to do any DNS lookups in its configuration file. See the section on link:{handbook}#dialup[using email with a dialup connection] in the FreeBSD Handbook for details. You may also want to add the following line to [.filename]#.mc#:
+In the DNS case, try to determine what is actually trying to resolve a host name. A lot of the time, Sendmail is the culprit. Make sure to configure Sendmail not to do any DNS lookups in its configuration file. See the section on extref:{handbook}serialcomms[using email with a dialup connection, dialup] in the FreeBSD Handbook for details. You may also want to add the following line to [.filename]#.mc#:
[.programlisting]
....
@@ -2439,7 +2425,7 @@ This section answers common questions about serial communications with FreeBSD.
=== Which multi-port serial cards are supported by FreeBSD?
-There is a list of these in the link:{handbook}#serial[Serial Communications] chapter of the Handbook.
+There is a list of these in the extref:{handbook}serialcomms[Serial Communications, serial] chapter of the Handbook.
Most multi-port PCI cards that are based on 16550 or clones are supported with no extra effort.
@@ -2449,7 +2435,7 @@ Check man:uart[4] and man:sio[4] to get more information on configuring such car
=== How do I get the boot: prompt to show on the serial console?
-See link:{handbook}#serialconsole-setup[this section of the Handbook].
+See extref:{handbook}serialcomms[this section of the Handbook, serialconsole-setup].
=== How do I tell if FreeBSD found my serial ports or modem cards?
@@ -2506,15 +2492,15 @@ The flags indicate that the master port has minor number `7` (`0x700`), and all
=== Can I set the default serial parameters for a port?
-See the link:{handbook}#serial-hw-config[Serial Communications] section in the FreeBSD Handbook.
+See the extref:{handbook}serialcomms[Serial Communications, serial-hw-config] section in the FreeBSD Handbook.
=== How can I enable dialup logins on my modem?
-Refer to the section about link:{handbook}#dialup[Dial-in Services] in the FreeBSD Handbook.
+Refer to the section about extref:{handbook}serialcomms[Dial-in Services, dialup] in the FreeBSD Handbook.
=== How can I connect a dumb terminal to my FreeBSD box?
-This information is in the link:{handbook}#term[Terminals] section of the FreeBSD Handbook.
+This information is in the extref:{handbook}serialcomms[Terminals, term] section of the FreeBSD Handbook.
=== Why can I not run tip or cu?
@@ -2576,7 +2562,7 @@ The Ports Collection also has package:emulators/dosbox[]. The main focus of this
=== What do I need to do to translate a FreeBSD document into my native language?
-See the link:{fdp-primer}#translations[Translation FAQ] in the FreeBSD Documentation Project Primer.
+See the extref:{fdp-primer}[Translation FAQ, translations] in the FreeBSD Documentation Project Primer.
=== Why does my email to any address at FreeBSD.org bounce?
@@ -2616,7 +2602,7 @@ Xfig and eps drawings are available under [.filename]#/usr/shared/examples/BSD_d
=== I have seen an acronym or other term on the mailing lists and I do not understand what it means. Where should I look?
-Refer to the link:{handbook}#freebsd-glossary[FreeBSD Glossary].
+Refer to the extref:{handbook}glossary[FreeBSD Glossary, freebsd-glossary].
=== Why should I care what color the bikeshed is?
@@ -2747,13 +2733,13 @@ Install package:games/sl[] and wait for her to mistype `sl` for `ls`.
=== How can I learn more about FreeBSD's internals?
-See the link:{arch-handbook}[FreeBSD Architecture Handbook].
+See the extref:{arch-handbook}[FreeBSD Architecture Handbook].
Additionally, much general UNIX(TM) knowledge is directly applicable to FreeBSD.
=== How can I contribute to FreeBSD? What can I do to help?
-We accept all types of contributions: documentation, code, and even art. See the article on link:{contributing}[Contributing to FreeBSD] for specific advice on how to do this.
+We accept all types of contributions: documentation, code, and even art. See the article on extref:{contributing}[Contributing to FreeBSD] for specific advice on how to do this.
And thanks for the thought!
@@ -2910,4 +2896,4 @@ To find the correct value of _N_, divide the desired address space size (in mega
This innocent little Frequently Asked Questions document has been written, rewritten, edited, folded, spindled, mutilated, eviscerated, contemplated, discombobulated, cogitated, regurgitated, rebuilt, castigated, and reinvigorated over the last decade, by a cast of hundreds if not thousands. Repeatedly.
-We wish to thank every one of the people responsible, and we encourage you to link:{contributing}[join them] in making this FAQ even better.
+We wish to thank every one of the people responsible, and we encourage you to extref:{contributing}[join them] in making this FAQ even better.
diff --git a/documentation/content/zh-tw/books/handbook/_index.adoc b/documentation/content/zh-tw/books/handbook/_index.adoc
index 44a59fc25c..d6d051d3c5 100644
--- a/documentation/content/zh-tw/books/handbook/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/_index.adoc
@@ -3,9 +3,9 @@ title: FreeBSD 使用手冊
authors:
- author: FreeBSD 文件計劃
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
next: books/handbook/preface
+isIndex: true
---
= FreeBSD 使用手冊
@@ -15,18 +15,32 @@ next: books/handbook/preface
:icons: font
:sectnums:
:sectnumlevels: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:images-path: books/handbook/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[.abstract-title]
摘要
@@ -37,10 +51,10 @@ include::shared/zh-tw/mailing-lists.adoc[]
'''
-include::content/zh-tw/books/handbook/toc.adoc[]
+include::{chapters-path}toc.adoc[]
-include::content/zh-tw/books/handbook/toc-figures.adoc[]
+include::{chapters-path}toc-figures.adoc[]
-include::content/zh-tw/books/handbook/toc-tables.adoc[]
+include::{chapters-path}toc-tables.adoc[]
-include::content/zh-tw/books/handbook/toc-examples.adoc[]
+include::{chapters-path}toc-examples.adoc[]
diff --git a/documentation/content/zh-tw/books/handbook/advanced-networking/_index.adoc b/documentation/content/zh-tw/books/handbook/advanced-networking/_index.adoc
index 9c49175adf..957bffb932 100644
--- a/documentation/content/zh-tw/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/advanced-networking/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 31
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 31
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/advanced-networking/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
-endif::[]
+:images-path: books/handbook/advanced-networking/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/advanced-networking/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[advanced-networking-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/audit/_index.adoc b/documentation/content/zh-tw/books/handbook/audit/_index.adoc
index 1ad3ae721c..c1172d91c7 100644
--- a/documentation/content/zh-tw/books/handbook/audit/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/audit/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/disks
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/audit/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
-endif::[]
+:images-path: books/handbook/audit/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/audit/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[audit-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/basics/_index.adoc b/documentation/content/zh-tw/books/handbook/basics/_index.adoc
index e27653b5c4..e4a694e9c8 100644
--- a/documentation/content/zh-tw/books/handbook/basics/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/basics/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ports
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/basics/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
-endif::[]
+:images-path: books/handbook/basics/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/basics/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[basics-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/bibliography/_index.adoc b/documentation/content/zh-tw/books/handbook/bibliography/_index.adoc
index bda8b005d8..2c0797a9c2 100644
--- a/documentation/content/zh-tw/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/bibliography/_index.adoc
@@ -9,26 +9,40 @@ next: books/handbook/eresources
[[bibliography]]
= 參考書目
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: B
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: B
+:images-path: books/handbook/bibliography/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
雖然操作手冊提供 FreeBSD 作業系統各個部分完整的說明,卻難免有「小學而大遺」之憾,像是如何讓整個作業系統運作順暢。因此,身邊有 UNIX(TM) 系統管理的好書以及好的使用手冊是不可或缺的。
diff --git a/documentation/content/zh-tw/books/handbook/book.adoc b/documentation/content/zh-tw/books/handbook/book.adoc
index e5b39e931b..586d7fde1f 100644
--- a/documentation/content/zh-tw/books/handbook/book.adoc
+++ b/documentation/content/zh-tw/books/handbook/book.adoc
@@ -3,7 +3,6 @@ title: FreeBSD 使用手冊
authors:
- author: FreeBSD 文件計劃
copyright: 1995-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"]
---
@@ -12,52 +11,35 @@ trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "inte
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
:book: true
:pdf: false
-:pgpkeys-path: ../../../../../
+:images-path: books/handbook/
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
-:chapters-path: content/zh-tw/books/handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
[.abstract-title]
@@ -74,95 +56,95 @@ toc::[]
:sectnums!:
-include::{chapters-path}preface/_index.adoc[leveloffset=+1, lines=7..-1]
+include::{chapters-path}preface/_index.adoc[leveloffset=+1]
:sectnums:
// Section one
-include::{chapters-path}parti.adoc[lines=7..18]
+include::{chapters-path}parti.adoc[lines=15..26]
-include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}introduction/_index.adoc[leveloffset=+1]
-include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}bsdinstall/_index.adoc[leveloffset=+1]
-include::{chapters-path}basics/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}basics/_index.adoc[leveloffset=+1]
-include::{chapters-path}ports/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ports/_index.adoc[leveloffset=+1]
-include::{chapters-path}x11/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}x11/_index.adoc[leveloffset=+1]
// Section two
-include::{chapters-path}partii.adoc[lines=7..18]
+include::{chapters-path}partii.adoc[lines=15..26]
-include::{chapters-path}desktop/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}desktop/_index.adoc[leveloffset=+1]
-include::{chapters-path}multimedia/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}multimedia/_index.adoc[leveloffset=+1]
-include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}kernelconfig/_index.adoc[leveloffset=+1]
-include::{chapters-path}printing/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}printing/_index.adoc[leveloffset=+1]
-include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}linuxemu/_index.adoc[leveloffset=+1]
// Section three
-include::{chapters-path}partiii.adoc[lines=7..12]
+include::{chapters-path}partiii.adoc[lines=15..20]
-include::{chapters-path}config/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}config/_index.adoc[leveloffset=+1]
-include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}boot/_index.adoc[leveloffset=+1]
-include::{chapters-path}security/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}security/_index.adoc[leveloffset=+1]
-include::{chapters-path}jails/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}jails/_index.adoc[leveloffset=+1]
-include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mac/_index.adoc[leveloffset=+1]
-include::{chapters-path}audit/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}audit/_index.adoc[leveloffset=+1]
-include::{chapters-path}disks/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}disks/_index.adoc[leveloffset=+1]
-include::{chapters-path}geom/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}geom/_index.adoc[leveloffset=+1]
-include::{chapters-path}zfs/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}zfs/_index.adoc[leveloffset=+1]
-include::{chapters-path}filesystems/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}filesystems/_index.adoc[leveloffset=+1]
-include::{chapters-path}virtualization/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}virtualization/_index.adoc[leveloffset=+1]
-include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}l10n/_index.adoc[leveloffset=+1]
-include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}cutting-edge/_index.adoc[leveloffset=+1]
-include::{chapters-path}dtrace/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}dtrace/_index.adoc[leveloffset=+1]
-include::{chapters-path}usb-device-mode/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}usb-device-mode/_index.adoc[leveloffset=+1]
// Section four
-include::{chapters-path}partiv.adoc[lines=7..19]
+include::{chapters-path}partiv.adoc[lines=15..27]
-include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}serialcomms/_index.adoc[leveloffset=+1]
-include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}ppp-and-slip/_index.adoc[leveloffset=+1]
-include::{chapters-path}mail/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}mail/_index.adoc[leveloffset=+1]
-include::{chapters-path}network-servers/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}network-servers/_index.adoc[leveloffset=+1]
-include::{chapters-path}firewalls/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}firewalls/_index.adoc[leveloffset=+1]
-include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1, lines=8..38;48..-1]
+include::{chapters-path}advanced-networking/_index.adoc[leveloffset=+1]
// Section five
-include::{chapters-path}partv.adoc[lines=7..8]
+include::{chapters-path}partv.adoc[lines=15..16]
:sectnums!:
-include::{chapters-path}mirrors/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}mirrors/_index.adoc[leveloffset=+1]
-include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=8..25;33..-1]
+include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
-include::{chapters-path}eresources/_index.adoc[leveloffset=+1, lines=8..25;34..-1]
+include::{chapters-path}eresources/_index.adoc[leveloffset=+1]
-include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1, lines=8..25;35..-1]
+include::{chapters-path}pgpkeys/_index.adoc[leveloffset=+1]
:sectnums:
diff --git a/documentation/content/zh-tw/books/handbook/boot/_index.adoc b/documentation/content/zh-tw/books/handbook/boot/_index.adoc
index 74d620f13c..7bcdcd5f86 100644
--- a/documentation/content/zh-tw/books/handbook/boot/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/boot/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/security
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/bsdinstall/_index.adoc b/documentation/content/zh-tw/books/handbook/bsdinstall/_index.adoc
index 3af5550c37..2633268d77 100644
--- a/documentation/content/zh-tw/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/bsdinstall/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/basics
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/bsdinstall/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
-endif::[]
+:images-path: books/handbook/bsdinstall/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/bsdinstall/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[bsdinstall-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/config/_index.adoc b/documentation/content/zh-tw/books/handbook/config/_index.adoc
index babbd9fa67..31891f049a 100644
--- a/documentation/content/zh-tw/books/handbook/config/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/config/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/boot
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/config/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[config-synopsis]]
== 概述
@@ -286,7 +284,7 @@ Starting background file system checks in 60 seconds.
透過仔細的設定每個啟動 Script 的這些關鍵字,管理者便可對 Script 的啟動順序進行微調,而不需使用到其他 UNIX(TM) 作業系統所使用的 "runlevels"。
-額外的資訊可在 man:rc[8] 以及 man:rc.subr[8] 中找到。請參考 link:{rc-scripting}[此文章] 來取得如何建立自訂 man:rc[8] Script 的操作說明。
+額外的資訊可在 man:rc[8] 以及 man:rc.subr[8] 中找到。請參考 extref:{rc-scripting}[此文章] 來取得如何建立自訂 man:rc[8] Script 的操作說明。
[[configtuning-core-configuration]]
=== 管理系統特定的設定
diff --git a/documentation/content/zh-tw/books/handbook/cutting-edge/_index.adoc b/documentation/content/zh-tw/books/handbook/cutting-edge/_index.adoc
index 5b2db37acb..b0ce170f03 100644
--- a/documentation/content/zh-tw/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/cutting-edge/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/dtrace
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 23
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 23
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/cutting-edge/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
-endif::[]
+:images-path: books/handbook/cutting-edge/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/cutting-edge/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[updating-upgrading-synopsis]]
== 概述
@@ -388,7 +386,7 @@ before running "/usr/sbin/freebsd-update install"
本節將說明如何使用原始碼與 FreeBSD Port 套件集來取得最新版本 FreeBSD 文件本地複本。
-有關編輯與提出修正說明文件的資訊,請參考 FreeBSD 文件計畫入門書 (link:{fdp-primer}[FreeBSD Documentation Project Primer])。
+有關編輯與提出修正說明文件的資訊,請參考 FreeBSD 文件計畫入門書 (extref:{fdp-primer}[FreeBSD Documentation Project Primer])。
[[updating-installed-documentation]]
=== 自原始碼更新說明文件
diff --git a/documentation/content/zh-tw/books/handbook/desktop/_index.adoc b/documentation/content/zh-tw/books/handbook/desktop/_index.adoc
index ee388acd4f..3a7314ce14 100644
--- a/documentation/content/zh-tw/books/handbook/desktop/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/desktop/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/multimedia
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/desktop/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
-endif::[]
+:images-path: books/handbook/desktop/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/desktop/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[desktop-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/disks/_index.adoc b/documentation/content/zh-tw/books/handbook/disks/_index.adoc
index 576534b016..93b2fbbf87 100644
--- a/documentation/content/zh-tw/books/handbook/disks/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/disks/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/geom
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 17
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/disks/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
-endif::[]
+:images-path: books/handbook/disks/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/disks/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[disks-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/dtrace/_index.adoc b/documentation/content/zh-tw/books/handbook/dtrace/_index.adoc
index 811a2e4525..f1964e688a 100644
--- a/documentation/content/zh-tw/books/handbook/dtrace/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/dtrace/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/usb-device-mode
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 24
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 24
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/dtrace/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
-endif::[]
+:images-path: books/handbook/dtrace/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/dtrace/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dtrace-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/eresources/_index.adoc b/documentation/content/zh-tw/books/handbook/eresources/_index.adoc
index e8fc43ca34..8ac105b2a6 100644
--- a/documentation/content/zh-tw/books/handbook/eresources/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/eresources/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/pgpkeys
[[eresources]]
= 網路資源
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: C
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: C
+:images-path: books/handbook/eresources/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
The rapid pace of FreeBSD progress makes print media impractical as a means of following the latest developments. Electronic resources are the best, if not often the only, way to stay informed of the latest advances. Since FreeBSD is a volunteer effort, the user community itself also generally serves as a "technical support department" of sorts, with electronic mail, web forums, and USENET news being the most effective way of reaching that community.
diff --git a/documentation/content/zh-tw/books/handbook/filesystems/_index.adoc b/documentation/content/zh-tw/books/handbook/filesystems/_index.adoc
index f6cd8f9cbc..6598962d87 100644
--- a/documentation/content/zh-tw/books/handbook/filesystems/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/filesystems/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/virtualization
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 20
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 20
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/filesystems/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
-endif::[]
+:images-path: books/handbook/filesystems/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/filesystems/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[filesystems-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/firewalls/_index.adoc b/documentation/content/zh-tw/books/handbook/firewalls/_index.adoc
index b0107b060d..07729db7f4 100644
--- a/documentation/content/zh-tw/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/firewalls/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/advanced-networking
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 30
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 30
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/firewalls/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
-endif::[]
+:images-path: books/handbook/firewalls/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/firewalls/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[firewalls-intro]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/geom/_index.adoc b/documentation/content/zh-tw/books/handbook/geom/_index.adoc
index 0bc8f410c5..cba6b206ca 100644
--- a/documentation/content/zh-tw/books/handbook/geom/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/geom/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/zfs
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/geom/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
-endif::[]
+:images-path: books/handbook/geom/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/geom/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[geom-synopsis]]
== 概述
@@ -1139,4 +1137,4 @@ In the case of several slices, a journal will be created for each individual sli
Journaling may also be enabled on current file systems by using `tunefs`. However, _always_ make a backup before attempting to alter an existing file system. In most cases, `gjournal` will fail if it is unable to create the journal, but this does not protect against data loss incurred as a result of misusing `tunefs`. Refer to man:gjournal[8] and man:tunefs[8] for more information about these commands.
-It is possible to journal the boot disk of a FreeBSD system. Refer to the article link:{gjournal-desktop}[Implementing UFS Journaling on a Desktop PC] for detailed instructions.
+It is possible to journal the boot disk of a FreeBSD system. Refer to the article extref:{gjournal-desktop}[Implementing UFS Journaling on a Desktop PC] for detailed instructions.
diff --git a/documentation/content/zh-tw/books/handbook/introduction/_index.adoc b/documentation/content/zh-tw/books/handbook/introduction/_index.adoc
index 261bee1ae6..cf4e68dca3 100644
--- a/documentation/content/zh-tw/books/handbook/introduction/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/introduction/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/bsdinstall
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/introduction/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/introduction/
-endif::[]
+:images-path: books/handbook/introduction/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/introduction/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[introduction-synopsis]]
== 概述
@@ -94,7 +92,7 @@ FreeBSD 能應用的情境完全限制在你的想像力上。 從軟體開發
* __教育:__您是電腦科學相關領域的學生嗎?再也沒有比使用 FreeBSD 能學到更多作業系統、計算機結構、及網路的方法了。其中許多免費提供的 CAD,數學和圖形設計套件對於那些需要在電腦完成 __其他__ 工作的人也非常有用!
* __研究:__有了完整的原始程式碼,FreeBSD 是研究作業系統及電腦科學的極佳環境。 具有免費且自由取得特性的 FreeBSD 也使得一個分置兩地的合作計劃,不必擔心版權及系統開放性的問題, 而能自在的交流。
* _網路:_ 你如果需要 路由器、名稱伺服器 (DNS) 或安全的防火牆, FreeBSD 可以輕易的將你沒有用到的 386 或 486 PC 變身成為絕佳的伺服器,甚至具有過濾封包的功能。
-* _嵌入式:_ FreeBSD 是一套可用來建立嵌入式系統的傑出平台。 支援 ARM(TM), MIPS(TM) 以及 PowerPC(TM) 平台,再加上健全的網路環境、尖端的功能以及自由的 link:{faq}#bsd-license-restrictions[BSD 授權條款],FreeBSD 成為用來建置嵌入式路由器、防火牆及其他裝置的絕佳基礎。
+* _嵌入式:_ FreeBSD 是一套可用來建立嵌入式系統的傑出平台。 支援 ARM(TM), MIPS(TM) 以及 PowerPC(TM) 平台,再加上健全的網路環境、尖端的功能以及自由的 extref:{faq}[BSD 授權條款, bsd-license-restrictions],FreeBSD 成為用來建置嵌入式路由器、防火牆及其他裝置的絕佳基礎。
* _桌面:_ FreeBSD 同時也是低成本桌面解決方案中不錯的選擇,使用了免費的 X11 伺服器。FreeBSD 提供許多開源桌面環境可選擇,包含了標準 GNOME 及 KDE 圖型化使用者介面。FreeBSD 甚至可以透過中央伺服器做 "無磁碟" 開機,讓個人工作站變的更便宜、更易於管理。
* _軟體開發:_ 基本安裝的 FreeBSD 就包含了完整的程式開發工具,如 C/C++ 編譯器及除錯器。 透過 Port 與套件管理系統也可支援需多其他語言。
@@ -179,7 +177,7 @@ FreeBSD 計劃的目標在於提供可作任意用途的軟體而不附帶任何
[[development]]
=== FreeBSD 開發模式
-FreeBSD 的開發是一個非常開放且具彈性的過程,就像從 link:{contributors}[貢獻者名單] 所看到的,是由全世界成千上萬的貢獻者發展起來的。 FreeBSD 的開發基礎架構允許數以百計的開發者透過網際網路協同工作。 我們也經常關注著那些對我們的計畫感興趣的新開發者和新的創意, 那些有興趣更進一步參與計劃的人只需要在 http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[FreeBSD 技術討論郵遞論壇] 連繫我們。 http://lists.FreeBSD.org/mailman/listinfo/freebsd-announce[FreeBSD 公告郵遞論壇] 對那些希望了解我們進度的人也是相當有用的。
+FreeBSD 的開發是一個非常開放且具彈性的過程,就像從 extref:{contributors}[貢獻者名單] 所看到的,是由全世界成千上萬的貢獻者發展起來的。 FreeBSD 的開發基礎架構允許數以百計的開發者透過網際網路協同工作。 我們也經常關注著那些對我們的計畫感興趣的新開發者和新的創意, 那些有興趣更進一步參與計劃的人只需要在 http://lists.FreeBSD.org/mailman/listinfo/freebsd-hackers[FreeBSD 技術討論郵遞論壇] 連繫我們。 http://lists.FreeBSD.org/mailman/listinfo/freebsd-announce[FreeBSD 公告郵遞論壇] 對那些希望了解我們進度的人也是相當有用的。
無論是單獨開發者或者封閉式的團隊合作,多瞭解 FreeBSD 計劃和它的開發過程會是不錯的:
diff --git a/documentation/content/zh-tw/books/handbook/jails/_index.adoc b/documentation/content/zh-tw/books/handbook/jails/_index.adoc
index 009ca198c7..d3801e3303 100644
--- a/documentation/content/zh-tw/books/handbook/jails/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/jails/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mac
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/jails/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
-endif::[]
+:images-path: books/handbook/jails/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/jails/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[jails-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/kernelconfig/_index.adoc b/documentation/content/zh-tw/books/handbook/kernelconfig/_index.adoc
index 462ad9dfcf..f7e08e5de6 100644
--- a/documentation/content/zh-tw/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/kernelconfig/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/printing
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/kernelconfig/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
-endif::[]
+:images-path: books/handbook/kernelconfig/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/kernelconfig/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[kernelconfig-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/l10n/_index.adoc b/documentation/content/zh-tw/books/handbook/l10n/_index.adoc
index 74f28a455a..e08ad133d5 100644
--- a/documentation/content/zh-tw/books/handbook/l10n/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/l10n/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/cutting-edge
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 22
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 22
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/l10n/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
-endif::[]
+:images-path: books/handbook/l10n/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/l10n/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[l10n-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/linuxemu/_index.adoc b/documentation/content/zh-tw/books/handbook/linuxemu/_index.adoc
index 18db640d73..4aec095145 100644
--- a/documentation/content/zh-tw/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/linuxemu/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/linuxemu/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
-endif::[]
+:images-path: books/handbook/linuxemu/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/linuxemu/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[linuxemu-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/mac/_index.adoc b/documentation/content/zh-tw/books/handbook/mac/_index.adoc
index 16fd90a81e..e294ee0bc2 100644
--- a/documentation/content/zh-tw/books/handbook/mac/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/mac/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/audit
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/mac/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
-endif::[]
+:images-path: books/handbook/mac/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mac/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mac-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/mail/_index.adoc b/documentation/content/zh-tw/books/handbook/mail/_index.adoc
index b344860205..bb7a686ce8 100644
--- a/documentation/content/zh-tw/books/handbook/mail/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/mail/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/network-servers
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 28
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 28
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/mail/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
-endif::[]
+:images-path: books/handbook/mail/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/mail/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mail-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/mirrors/_index.adoc b/documentation/content/zh-tw/books/handbook/mirrors/_index.adoc
index 6f8a241032..5ff76e4b54 100644
--- a/documentation/content/zh-tw/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/mirrors/_index.adoc
@@ -9,27 +9,40 @@ next: books/handbook/bibliography
[[mirrors]]
= 取得 FreeBSD
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: A
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: A
+:images-path: books/handbook/mirrors/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[mirrors-cdrom]]
== CD 與 DVD 合集
diff --git a/documentation/content/zh-tw/books/handbook/multimedia/_index.adoc b/documentation/content/zh-tw/books/handbook/multimedia/_index.adoc
index 54046b3cc0..7377415062 100644
--- a/documentation/content/zh-tw/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/multimedia/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/kernelconfig
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/multimedia/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
-endif::[]
+:images-path: books/handbook/multimedia/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/multimedia/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[multimedia-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/network-servers/_index.adoc b/documentation/content/zh-tw/books/handbook/network-servers/_index.adoc
index c7b67b941d..741c8ee8ae 100644
--- a/documentation/content/zh-tw/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/network-servers/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/firewalls
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 29
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 29
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/network-servers/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
-endif::[]
+:images-path: books/handbook/network-servers/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/network-servers/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[network-servers-synopsis]]
== 概述
@@ -1174,7 +1172,7 @@ FreeBSD 並未提供內建的 LDAP 伺服器,要開始設定前請先安裝 pa
# pkg install openldap-server
....
-在link:{linux-users}#software[套件]中已開啟了許多的預設選項,可以透過執行 `pkg info openldap-server` 來查看已開啟的選項,若有不足的地方 (例如需要開啟 SQL 的支援),請考慮使用適當的crossref:ports[ports-using,方式]重新編譯該 Port。
+在extref:{linux-users}[套件, software]中已開啟了許多的預設選項,可以透過執行 `pkg info openldap-server` 來查看已開啟的選項,若有不足的地方 (例如需要開啟 SQL 的支援),請考慮使用適當的crossref:ports[ports-using,方式]重新編譯該 Port。
安裝程序會建立目錄 [.filename]#/var/db/openldap-data# 來儲存資料,同時需要建立儲存憑證的目錄:
diff --git a/documentation/content/zh-tw/books/handbook/parti.adoc b/documentation/content/zh-tw/books/handbook/parti.adoc
index 9c3c5ed8a6..5eae92418f 100644
--- a/documentation/content/zh-tw/books/handbook/parti.adoc
+++ b/documentation/content/zh-tw/books/handbook/parti.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/preface
next: books/handbook/introduction
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[getting-started]]
= 入門
@@ -17,4 +25,4 @@ next: books/handbook/introduction
我們試著儘可能的讓這段文字的參考連結數目降到最低,讓您在讀使用手冊的這部份時可以不太需要常常前後翻頁。
-include::content/zh-tw/books/handbook/toc-1.adoc[]
+include::{chapters-path}toc-1.adoc[]
diff --git a/documentation/content/zh-tw/books/handbook/partii.adoc b/documentation/content/zh-tw/books/handbook/partii.adoc
index bdb4d986b2..af524ce51f 100644
--- a/documentation/content/zh-tw/books/handbook/partii.adoc
+++ b/documentation/content/zh-tw/books/handbook/partii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/x11
next: books/handbook/desktop
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[common-tasks]]
= 一般作業
@@ -17,4 +25,4 @@ next: books/handbook/desktop
這些章節中有些需要您預先閱讀些相關文件,在各章節開頭的概要內會提及。
-include::content/zh-tw/books/handbook/toc-2.adoc[]
+include::{chapters-path}toc-2.adoc[]
diff --git a/documentation/content/zh-tw/books/handbook/partiii.adoc b/documentation/content/zh-tw/books/handbook/partiii.adoc
index 2d492ec3ac..cbf9274e48 100644
--- a/documentation/content/zh-tw/books/handbook/partiii.adoc
+++ b/documentation/content/zh-tw/books/handbook/partiii.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/linuxemu
next: books/handbook/config
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[system-administration]]
= 系統管理
@@ -11,4 +19,4 @@ FreeBSD 使用手冊剩下的這些章節涵蓋了全方位的 FreeBSD 系統管
這些章節是讓您在需要查資料的時候翻閱用的。 您不需要依照特定的順序來讀,也不需要將這些章節全部過讀之後才開始用 FreeBSD。
-include::content/zh-tw/books/handbook/toc-3.adoc[]
+include::{chapters-path}toc-3.adoc[]
diff --git a/documentation/content/zh-tw/books/handbook/partiv.adoc b/documentation/content/zh-tw/books/handbook/partiv.adoc
index 79163aaff0..6cc27f7020 100644
--- a/documentation/content/zh-tw/books/handbook/partiv.adoc
+++ b/documentation/content/zh-tw/books/handbook/partiv.adoc
@@ -4,6 +4,14 @@ prev: books/handbook/usb-device-mode
next: books/handbook/serialcomms
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[network-communication]]
= 網路通訊
@@ -18,4 +26,4 @@ FreeBSD 是一種廣泛的被使用在高效能的網路伺服器中的作業系
這些章節是讓您在需要查資料的時候翻閱用的。 您不需要依照特定的順序來讀,也不需要將這些章節全部讀過之後才將 FreeBSD 用在網路環境下。
-include::content/zh-tw/books/handbook/toc-4.adoc[]
+include::{chapters-path}toc-4.adoc[]
diff --git a/documentation/content/zh-tw/books/handbook/partv.adoc b/documentation/content/zh-tw/books/handbook/partv.adoc
index c4004a9e04..46a56c5a83 100644
--- a/documentation/content/zh-tw/books/handbook/partv.adoc
+++ b/documentation/content/zh-tw/books/handbook/partv.adoc
@@ -4,7 +4,15 @@ prev: books/handbook/advanced-networking
next: books/handbook/mirrors
---
+ifdef::env-beastie+backend-html5[]
+:chapters-path: content/{{% lang %}}/books/handbook/
+endif::[]
+
+ifndef::env-beastie[]
+:chapters-path:
+endif::[]
+
[[appendices]]
= 附錄
-include::content/zh-tw/books/handbook/toc-5.adoc[]
+include::{chapters-path}toc-5.adoc[]
diff --git a/documentation/content/zh-tw/books/handbook/pgpkeys/_index.adoc b/documentation/content/zh-tw/books/handbook/pgpkeys/_index.adoc
index 5758a5cfa9..f5ae897d5b 100644
--- a/documentation/content/zh-tw/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/pgpkeys/_index.adoc
@@ -9,30 +9,46 @@ next: books/handbook/freebsd-glossary
[[pgpkeys]]
= OpenPGP 金鑰
:doctype: book
+:toc: macro
+:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: D
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: D
+:images-path: books/handbook/pgpkeys/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:pgpkeys-path: ../../../../../
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+:pgpkeys-path:
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
-:pgpkeys-path:
+ifndef::env-beastie[]
+toc::[]
+:pgpkeys-path: ../../../../../
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
-The OpenPGP keys of the `FreeBSD.org` officers are shown here. These keys can be used to verify a signature or send encrypted email to one of the officers. A full list of FreeBSD OpenPGP keys is available in the link:{pgpkeys}[PGP Keys] article. The complete keyring can be downloaded at link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
+The OpenPGP keys of the `FreeBSD.org` officers are shown here. These keys can be used to verify a signature or send encrypted email to one of the officers. A full list of FreeBSD OpenPGP keys is available in the extref:{pgpkeys}[PGP Keys] article. The complete keyring can be downloaded at link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[pgpkeyring.txt].
[[pgpkeys-officers]]
== Officers
diff --git a/documentation/content/zh-tw/books/handbook/ports/_index.adoc b/documentation/content/zh-tw/books/handbook/ports/_index.adoc
index 537c083d4b..156e027917 100644
--- a/documentation/content/zh-tw/books/handbook/ports/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/ports/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/x11
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ports/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
-endif::[]
+:images-path: books/handbook/ports/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ports/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ports-synopsis]]
== 概述
@@ -593,7 +591,7 @@ FreeBSD 的基礎系統內含 Portsnap,這是一個可用來取得 Port 套件
====
*Procedure: Subversion 方法*
-若要取得更多對 Port 樹的控制,或若有本地的變更需要維護,可以使用 Subversion 來取得 Port 套件集。請參考 link:{committers-guide}#subversion-primer[Subversion Primer] 來取得 Subversion 的詳細說明。
+若要取得更多對 Port 樹的控制,或若有本地的變更需要維護,可以使用 Subversion 來取得 Port 套件集。請參考 extref:{committers-guide}[Subversion Primer, subversion-primer] 來取得 Subversion 的詳細說明。
. 必須安裝 Subversion 才可用來取出 (Check out) Port 樹。若已存在 Port 樹的複本,可使用此方式安裝 Subversion:
+
@@ -633,7 +631,7 @@ Port 套件集中含有代表不同軟體分類的目錄,每個分類底下的
* [.filename]#pkg-descr#:提供程式更詳細的說明。
* [.filename]#pkg-plist#:Port 安裝的所有檔案清單,也同時會告訴 Port 系統解除安裝時要移除那一些檔案。
-部份 Port 含有 [.filename]#pkg-message# 或其他檔案用來處理特殊情況。要取得有關這些檔案的詳細資訊,以及 Port 的概要可參考 link:{porters-handbook}[FreeBSD Porter's Handbook]。
+部份 Port 含有 [.filename]#pkg-message# 或其他檔案用來處理特殊情況。要取得有關這些檔案的詳細資訊,以及 Port 的概要可參考 extref:{porters-handbook}[FreeBSD Porter's Handbook]。
Port 中並不含實際的原始碼,即為 [.filename]#distfile#,在編譯 Port 解壓縮時會自動下載的原始碼到 [.filename]#/usr/ports/distfiles#。
@@ -1114,11 +1112,11 @@ custom: {
+
[NOTE]
====
-有一些 Port 並非由個人維護,而是由 link:{mailing-list-faq}[郵遞論壇] 維護,有許多,但並非全部,只要郵件地址長的像 mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org] 都是,寄信時記得代入實際的論壇名稱。
+有一些 Port 並非由個人維護,而是由 extref:{mailing-list-faq}[郵遞論壇] 維護,有許多,但並非全部,只要郵件地址長的像 mailto:freebsd-listname@FreeBSD.org[freebsd-listname@FreeBSD.org] 都是,寄信時記得代入實際的論壇名稱。
尤其是由 mailto:ports@FreeBSD.org[ports@FreeBSD.org] 所維護的 Port 都不是由特定個人維護,而該 Port 的修正與支援都是來自訂閱該郵遞論壇的一般社群所提供,我們隨時歡迎志工參與!
====
+
-若寄信後沒有取得任何回應,可以依照 link:{problem-reports}[撰寫 FreeBSD 問題回報] 的說明使用 Bugzilla 提出問題回報。
-. 自行修正看看!link:{porters-handbook}[Porter's Handbook] 中含有 Port 基礎架構的詳細資訊,可提供資訊讓您可修正偶然損壞的 Port 或甚至您可以提交之自己的 Port!
+若寄信後沒有取得任何回應,可以依照 extref:{problem-reports}[撰寫 FreeBSD 問題回報] 的說明使用 Bugzilla 提出問題回報。
+. 自行修正看看!extref:{porters-handbook}[Porter's Handbook] 中含有 Port 基礎架構的詳細資訊,可提供資訊讓您可修正偶然損壞的 Port 或甚至您可以提交之自己的 Port!
. 依照 <<pkgng-intro>> 中的說明安裝 Binary 套件,替代使用 Port 安裝。
diff --git a/documentation/content/zh-tw/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/zh-tw/books/handbook/ppp-and-slip/_index.adoc
index 1875b79581..738056c459 100644
--- a/documentation/content/zh-tw/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/ppp-and-slip/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/mail
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 27
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 27
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/ppp-and-slip/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
-endif::[]
+:images-path: books/handbook/ppp-and-slip/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/ppp-and-slip/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[ppp-and-slip-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/preface/_index.adoc b/documentation/content/zh-tw/books/handbook/preface/_index.adoc
index feccf55614..ae156941e1 100644
--- a/documentation/content/zh-tw/books/handbook/preface/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/preface/_index.adoc
@@ -13,14 +13,31 @@ next: books/handbook/parti
:icons: font
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
+:images-path: books/handbook/preface/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[preface-audience]]
== 給讀者的話
diff --git a/documentation/content/zh-tw/books/handbook/printing/_index.adoc b/documentation/content/zh-tw/books/handbook/printing/_index.adoc
index c5fdd88e87..725cb16476 100644
--- a/documentation/content/zh-tw/books/handbook/printing/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/printing/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/linuxemu
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/printing/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
-endif::[]
+:images-path: books/handbook/printing/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/printing/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
儘管很多人試圖淘汰列印功能,但列印資訊到紙上仍是一個重要的功能。列印由兩個基本元件組成,包含了資料傳送到印表機的方式以及印表機可以理解的資料形式。
@@ -742,7 +740,7 @@ Several other printing systems are available in addition to the built-in man:lpd
[[printing-other-cups]]
=== CUPS (Common UNIX(TM) Printing System)
-CUPS is a popular printing system available on many operating systems. Using CUPS on FreeBSD is documented in a separate article: link:{cups}[CUPS]
+CUPS is a popular printing system available on many operating systems. Using CUPS on FreeBSD is documented in a separate article: extref:{cups}[CUPS]
[[printing-other-hplip]]
=== HPLIP
diff --git a/documentation/content/zh-tw/books/handbook/security/_index.adoc b/documentation/content/zh-tw/books/handbook/security/_index.adoc
index fc639315b1..0c6e43e79c 100644
--- a/documentation/content/zh-tw/books/handbook/security/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/security/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/jails
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/security/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/security/
-endif::[]
+:images-path: books/handbook/security/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/security/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/serialcomms/_index.adoc b/documentation/content/zh-tw/books/handbook/serialcomms/_index.adoc
index a3db1b2e1a..22614eea8c 100644
--- a/documentation/content/zh-tw/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/serialcomms/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/ppp-and-slip
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 26
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 26
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/serialcomms/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
-endif::[]
+:images-path: books/handbook/serialcomms/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/serialcomms/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[serial-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/usb-device-mode/_index.adoc b/documentation/content/zh-tw/books/handbook/usb-device-mode/_index.adoc
index 025db8ab8e..0366dcf61c 100644
--- a/documentation/content/zh-tw/books/handbook/usb-device-mode/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/usb-device-mode/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partiv
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 25
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 25
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/usb-device-mode/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/usb-device-mode/
-endif::[]
+:images-path: books/handbook/usb-device-mode/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/usb-device-mode/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[usb-device-mode-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/virtualization/_index.adoc b/documentation/content/zh-tw/books/handbook/virtualization/_index.adoc
index 1a0801a8a1..0465a03bf7 100644
--- a/documentation/content/zh-tw/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/virtualization/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/l10n
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 21
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 21
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/virtualization/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
-endif::[]
+:images-path: books/handbook/virtualization/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/virtualization/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[virtualization-synopsis]]
== 概述
diff --git a/documentation/content/zh-tw/books/handbook/x11/_index.adoc b/documentation/content/zh-tw/books/handbook/x11/_index.adoc
index bd6cf8473a..66a4d19344 100644
--- a/documentation/content/zh-tw/books/handbook/x11/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/x11/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/partii
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 5
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/x11/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
-endif::[]
+:images-path: books/handbook/x11/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/x11/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[x11-synopsis]]
== 概述
@@ -1045,7 +1043,7 @@ dbus_enable="YES"
桌面特效需要使用相當程度的顯示卡,對於以 nVidia 為基礎的顯示卡,需要使用專用的驅動程序來取得較佳的性能。其他顯示卡的使用可以跳過這一節,並繼續 [.filename]#xorg.conf# 設定。
-要知道需要那一種 nVidia 驅動程式可以查看 link:{faq}#idp59950544[FAQ 中與此主題相關的問題]。
+要知道需要那一種 nVidia 驅動程式可以查看 extref:{faq}[FAQ 中與此主題相關的問題, idp59950544]。
知道您的顯示卡要使用那種驅動程式才是正確的之後,接下來的安裝程序跟安裝其他套件一樣簡單。
diff --git a/documentation/content/zh-tw/books/handbook/zfs/_index.adoc b/documentation/content/zh-tw/books/handbook/zfs/_index.adoc
index 03771200a6..881290e3d0 100644
--- a/documentation/content/zh-tw/books/handbook/zfs/_index.adoc
+++ b/documentation/content/zh-tw/books/handbook/zfs/_index.adoc
@@ -13,37 +13,35 @@ next: books/handbook/filesystems
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 19
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 19
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../images/books/handbook/zfs/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/zfs/
-endif::[]
+:images-path: books/handbook/zfs/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/zfs/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-include::shared/zh-tw/teams.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
_Z 檔案系統_ 或 ZFS 是設計來克服許多在以往設計中發現的主要問題的一個先進的檔案系統。
diff --git a/documentation/content/zh-tw/books/porters-handbook/_index.adoc b/documentation/content/zh-tw/books/porters-handbook/_index.adoc
index d4553da521..9a78c5fe23 100644
--- a/documentation/content/zh-tw/books/porters-handbook/_index.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/_index.adoc
@@ -3,8 +3,8 @@ title: FreeBSD Porter 手冊
authors:
- author: The FreeBSD Documentation Project
copyright: 2000-2020 The FreeBSD Documentation Project
-releaseinfo: "$FreeBSD$"
-trademarks: ["freebsd", "sun", "unix", "general"]
+trademarks: ["freebsd", "sun", "unix", "general"]
+isIndex: true
---
= FreeBSD Porter 手冊
@@ -12,48 +12,34 @@ trademarks: ["freebsd", "sun", "unix", "general"]
:toc: macro
:toclevels: 2
:icons: font
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:sectnums:
:sectnumlevels: 6
:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
+:book: true
+:pdf: false
-ifeval::["{backend}" == "html5"]
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
-:chapters-path: content/zh-tw/books/porters-handbook/
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:chapters-path: content/{{% lang %}}/books/porters-handbook/
endif::[]
-
-ifeval::["{backend}" == "pdf"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
+ifdef::backend-pdf,backend-epub3[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
endif::[]
-ifeval::["{backend}" == "epub3"]
-include::../../../../shared/mirrors.adoc[]
-include::../../../../shared/authors.adoc[]
-include::../../../../shared/releases.adoc[]
-include::../../../../shared/zh-tw/mailing-lists.adoc[]
-include::../../../../shared/zh-tw/urls.adoc[]
+ifndef::env-beastie[]
:chapters-path:
+include::../../../../../shared/asciidoctor.adoc[]
endif::[]
'''
@@ -64,21 +50,21 @@ include::{chapters-path}toc-tables.adoc[]
include::{chapters-path}toc-examples.adoc[]
-include::{chapters-path}porting-why/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}new-port/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}slow-porting/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}makefiles/chapter.adoc[leveloffset=+1, lines=7..28;38..-1]
-include::{chapters-path}special/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}flavors/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}plist/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}testing/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}upgrading/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}security/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1, lines=7..29;39..-1]
-include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}order/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1, lines=7..27;37..-1]
-include::{chapters-path}uses/chapter.adoc[leveloffset=+1, lines=7..28;38..-1]
-include::{chapters-path}versions/chapter.adoc[leveloffset=+1, lines=6..26;36..-1]
+include::{chapters-path}porting-why/chapter.adoc[leveloffset=+1]
+include::{chapters-path}new-port/chapter.adoc[leveloffset=+1]
+include::{chapters-path}quick-porting/chapter.adoc[leveloffset=+1]
+include::{chapters-path}slow-porting/chapter.adoc[leveloffset=+1]
+include::{chapters-path}makefiles/chapter.adoc[leveloffset=+1]
+include::{chapters-path}special/chapter.adoc[leveloffset=+1]
+include::{chapters-path}flavors/chapter.adoc[leveloffset=+1]
+include::{chapters-path}plist/chapter.adoc[leveloffset=+1]
+include::{chapters-path}pkg-files/chapter.adoc[leveloffset=+1]
+include::{chapters-path}testing/chapter.adoc[leveloffset=+1]
+include::{chapters-path}upgrading/chapter.adoc[leveloffset=+1]
+include::{chapters-path}security/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-dads/chapter.adoc[leveloffset=+1]
+include::{chapters-path}porting-samplem/chapter.adoc[leveloffset=+1]
+include::{chapters-path}order/chapter.adoc[leveloffset=+1]
+include::{chapters-path}keeping-up/chapter.adoc[leveloffset=+1]
+include::{chapters-path}uses/chapter.adoc[leveloffset=+1]
+include::{chapters-path}versions/chapter.adoc[leveloffset=+1]
diff --git a/documentation/content/zh-tw/books/porters-handbook/flavors/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/flavors/chapter.adoc
index 314d7f8c7b..d7fb913a66 100644
--- a/documentation/content/zh-tw/books/porters-handbook/flavors/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/flavors/chapter.adoc
@@ -11,28 +11,36 @@ next: books/porters-handbook/plist
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 7
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 7
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[flavors-intro]]
== An Introduction to Flavors
diff --git a/documentation/content/zh-tw/books/porters-handbook/keeping-up/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/keeping-up/chapter.adoc
index 85621b2f00..d7007ede19 100644
--- a/documentation/content/zh-tw/books/porters-handbook/keeping-up/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/keeping-up/chapter.adoc
@@ -11,28 +11,36 @@ next: books/porters-handbook/uses
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 16
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 16
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
The FreeBSD Ports Collection is constantly changing. Here is some information on how to keep up.
diff --git a/documentation/content/zh-tw/books/porters-handbook/makefiles/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/makefiles/chapter.adoc
index d710f9affd..7e15a3648e 100644
--- a/documentation/content/zh-tw/books/porters-handbook/makefiles/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/makefiles/chapter.adoc
@@ -11,29 +11,37 @@ next: books/porters-handbook/special
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 5
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:g-plus-plus: g++
-:sectnumoffset: 5
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Configuring the [.filename]#Makefile# is pretty simple, and again we suggest looking at existing examples before starting. Also, there is a <<porting-samplem,sample Makefile>> in this handbook, so take a look and please follow the ordering of variables and sections in that template to make the port easier for others to read.
@@ -966,7 +974,7 @@ As the Ports Collection has grown over time, various new categories have been in
Our existing practice has been to avoid creating a new physical category unless either a large number of ports would logically belong to it, or the ports that would belong to it are a logically distinct group that is of limited general interest (for instance, categories related to spoken human languages), or preferably both.
-The rationale for this is that such a change creates a link:{committers-guide}#ports[fair amount of work] for both the committers and also for all users who track changes to the Ports Collection. In addition, proposed category changes just naturally seem to attract controversy. (Perhaps this is because there is no clear consensus on when a category is "too big", nor whether categories should lend themselves to browsing (and thus what number of categories would be an ideal number), and so forth.)
+The rationale for this is that such a change creates a extref:{committers-guide}[fair amount of work, ports] for both the committers and also for all users who track changes to the Ports Collection. In addition, proposed category changes just naturally seem to attract controversy. (Perhaps this is because there is no clear consensus on when a category is "too big", nor whether categories should lend themselves to browsing (and thus what number of categories would be an ideal number), and so forth.)
Here is the procedure:
@@ -983,7 +991,7 @@ Here is the procedure:
** (for extra credit, include the other files that have to change, as per the procedure in the Committer's Guide.)
. Since it affects the ports infrastructure and involves moving and patching many ports but also possibly running regression tests on the build cluster, assign the PR to the {portmgr}.
-. If that PR is approved, a committer will need to follow the rest of the procedure that is link:{committers-guide}#PORTS[outlined in the Committer's Guide].
+. If that PR is approved, a committer will need to follow the rest of the procedure that is extref:{committers-guide}[outlined in the Committer's Guide, ports].
====
Proposing a new virtual category is similar to the above but much less involved, since no ports will actually have to move. In this case, the only patches to include in the PR would be those to add the new category to `CATEGORIES` of the affected ports.
@@ -2262,7 +2270,7 @@ Set your mail-address here. Please. _:-)_
Only a single address without the comment part is allowed as a `MAINTAINER` value. The format used is `user@hostname.domain`. Please do not include any descriptive text such as a real name in this entry. That merely confuses the Ports infrastructure and most tools using it.
-The maintainer is responsible for keeping the port up to date and making sure that it works correctly. For a detailed description of the responsibilities of a port maintainer, refer to link:{contributing}#maintain-port[The challenge for port maintainers].
+The maintainer is responsible for keeping the port up to date and making sure that it works correctly. For a detailed description of the responsibilities of a port maintainer, refer to extref:{contributing}[The challenge for port maintainers, maintain-port].
[NOTE]
====
@@ -2270,7 +2278,7 @@ A maintainer volunteers to keep a port in good working order. Maintainers have t
Some types of fixes have "blanket approval" from the {portmgr}, allowing any committer to fix those categories of problems on any port. These fixes do not need approval from the maintainer.
-Blanket approval for most ports applies to fixes like infrastructure changes, or trivial and _tested_ build and runtime fixes. The current list is available in link:{committers-guide}#ports-qa-misc-blanket-approval[Ports section of the Committer's Guide].
+Blanket approval for most ports applies to fixes like infrastructure changes, or trivial and _tested_ build and runtime fixes. The current list is available in extref:{committers-guide}[Ports section of the Committer's Guide, ports-qa-misc-blanket-approval].
====
Other changes to the port will be sent to the maintainer for review and approval before being committed. If the maintainer does not respond to an update request after two weeks (excluding major public holidays), then that is considered a maintainer timeout, and the update can be made without explicit maintainer approval. If the maintainer does not respond within three months, or if there have been three consecutive timeouts, then that maintainer is considered absent without leave, and all of their ports can be assigned back to the pool. Exceptions to this are anything maintained by the {portmgr}, or the {security-officer}. No unauthorized commits may ever be made to ports maintained by those groups.
diff --git a/documentation/content/zh-tw/books/porters-handbook/new-port/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/new-port/chapter.adoc
index 2131e2aabc..296ea4fb96 100644
--- a/documentation/content/zh-tw/books/porters-handbook/new-port/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/new-port/chapter.adoc
@@ -11,28 +11,36 @@ next: books/porters-handbook/quick-porting
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 2
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 2
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
開始對製作新的 port 或更新現有 port 有一些興趣了嗎?太好囉!
diff --git a/documentation/content/zh-tw/books/porters-handbook/order/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/order/chapter.adoc
index e848e16cd4..92375d174a 100644
--- a/documentation/content/zh-tw/books/porters-handbook/order/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/order/chapter.adoc
@@ -11,28 +11,36 @@ next: books/porters-handbook/keeping-up
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 15
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
The first sections of the [.filename]#Makefile# must always come in the same order. This standard makes it so everyone can easily read any port without having to search for variables in a random order.
diff --git a/documentation/content/zh-tw/books/porters-handbook/pkg-files/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/pkg-files/chapter.adoc
index 1c26a69302..f84f709772 100644
--- a/documentation/content/zh-tw/books/porters-handbook/pkg-files/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/pkg-files/chapter.adoc
@@ -11,28 +11,36 @@ next: books/porters-handbook/testing
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 9
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 9
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
There are some tricks we have not mentioned yet about the [.filename]#pkg-*# files that come in handy sometimes.
diff --git a/documentation/content/zh-tw/books/porters-handbook/plist/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/plist/chapter.adoc
index 8fcd6787da..3dba67ceeb 100644
--- a/documentation/content/zh-tw/books/porters-handbook/plist/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/plist/chapter.adoc
@@ -11,28 +11,36 @@ next: books/porters-handbook/pkg-files
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 8
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 8
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[plist-sub]]
== Changing [.filename]#pkg-plist# Based on Make Variables
diff --git a/documentation/content/zh-tw/books/porters-handbook/porting-dads/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/porting-dads/chapter.adoc
index c6eccca5a1..90bb0bef05 100644
--- a/documentation/content/zh-tw/books/porters-handbook/porting-dads/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/porting-dads/chapter.adoc
@@ -11,40 +11,48 @@ next: books/porters-handbook/porting-samplem
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 13
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
:freebsd-version: __FreeBSD_version
:freebsd: __FreeBSD__
-:sectnumoffset: 13
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[dads-intro]]
== Introduction
-Here is a list of common dos and don'ts that are encountered during the porting process. Check the port against this list, but also check ports in the https://bugs.FreeBSD.org/search/[PR database] that others have submitted. Submit any comments on ports as described in link:{contributing}#CONTRIB-GENERAL[Bug Reports and General Commentary]. Checking ports in the PR database will both make it faster for us to commit them, and prove that you know what you are doing.
+Here is a list of common dos and don'ts that are encountered during the porting process. Check the port against this list, but also check ports in the https://bugs.FreeBSD.org/search/[PR database] that others have submitted. Submit any comments on ports as described in extref:{contributing}[Bug Reports and General Commentary, CONTRIB-GENERAL]. Checking ports in the PR database will both make it faster for us to commit them, and prove that you know what you are doing.
[[porting-wrkdir]]
== `WRKDIR`
-Do not write anything to files outside `WRKDIR`. `WRKDIR` is the only place that is guaranteed to be writable during the port build (see link:{handbook}#PORTS-CD[ installing ports from a CDROM] for an example of building ports from a read-only tree). The [.filename]##pkg-*## files can be modified by <<pkg-names,redefining a variable>> rather than overwriting the file.
+Do not write anything to files outside `WRKDIR`. `WRKDIR` is the only place that is guaranteed to be writable during the port build (see extref:{handbook}ports[ installing ports from a CDROM, PORTS-CD] for an example of building ports from a read-only tree). The [.filename]##pkg-*## files can be modified by <<pkg-names,redefining a variable>> rather than overwriting the file.
[[porting-wrkdirprefix]]
== `WRKDIRPREFIX`
diff --git a/documentation/content/zh-tw/books/porters-handbook/porting-samplem/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/porting-samplem/chapter.adoc
index 1fc1ae1b6f..b7800427bc 100644
--- a/documentation/content/zh-tw/books/porters-handbook/porting-samplem/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/porting-samplem/chapter.adoc
@@ -11,28 +11,36 @@ next: books/porters-handbook/order
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 14
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 14
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Here is a sample [.filename]#Makefile# that can be used to create a new port. Make sure to remove all the extra comments (ones between brackets).
diff --git a/documentation/content/zh-tw/books/porters-handbook/porting-why/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/porting-why/chapter.adoc
index 09bbe8eca7..f596393064 100644
--- a/documentation/content/zh-tw/books/porters-handbook/porting-why/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/porting-why/chapter.adoc
@@ -11,28 +11,36 @@ next: books/porters-handbook/new-port
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 1
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 1
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
幾乎每個 FreeBSD 愛用者都是透過 FreeBSD Ports Collection 來裝各式應用程式("ports")。如同 FreeBSD 的其他部分一樣, 這些 ports 都主要來自許多志工的努力成果,所以在閱讀這份文件時, 請務必感恩在心。
diff --git a/documentation/content/zh-tw/books/porters-handbook/quick-porting/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/quick-porting/chapter.adoc
index 6e9f487c6d..6be1b324f0 100644
--- a/documentation/content/zh-tw/books/porters-handbook/quick-porting/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/quick-porting/chapter.adoc
@@ -11,28 +11,36 @@ next: books/porters-handbook/slow-porting
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 3
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 3
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
本節主要介紹如何來快速打造 port,然而實際應用時這快速方法可能不足,完整的 "慢速打造 Port" 的步驟在 <<slow-porting>> 詳述。
@@ -235,5 +243,5 @@ Giving a good description in the summary of the problem report makes the work of
送出 port 之後,請耐心等候佳音。 有時候可能需要等個幾天或幾個月時間,才會在 FreeBSD ports tree 上正式出現。 等待中的 port PR 清單可以在 http://www.FreeBSD.org/cgi/query-pr-summary.cgi?category=ports[] 查閱。
-在看過新的 port 之後,如果需要的話,我們會回覆您,然後會將它提交到 port tree 。 您的大名會被列在 link:{contributors}#contrib-additional[Additional FreeBSD Contributors] 列表上,以及其他檔案中。
+在看過新的 port 之後,如果需要的話,我們會回覆您,然後會將它提交到 port tree 。 您的大名會被列在 extref:{contributors}[Additional FreeBSD Contributors, contrib-additional] 列表上,以及其他檔案中。
diff --git a/documentation/content/zh-tw/books/porters-handbook/security/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/security/chapter.adoc
index 9e42934945..a4deea774a 100644
--- a/documentation/content/zh-tw/books/porters-handbook/security/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/security/chapter.adoc
@@ -11,28 +11,36 @@ next: books/porters-handbook/porting-dads
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 12
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 12
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[security-intro]]
== Why Security is So Important
diff --git a/documentation/content/zh-tw/books/porters-handbook/slow-porting/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/slow-porting/chapter.adoc
index 6c8b2ab3bc..27d89ca691 100644
--- a/documentation/content/zh-tw/books/porters-handbook/slow-porting/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/slow-porting/chapter.adoc
@@ -11,28 +11,36 @@ next: books/porters-handbook/makefiles
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 4
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 4
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Ok...事實上並不太可能這麼簡單,port 方面可能需要作些修改才能正常使用。 因此, 本節將一步一步來介紹如何修改上一章的樣本以正常使用。
diff --git a/documentation/content/zh-tw/books/porters-handbook/special/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/special/chapter.adoc
index 77032655af..4e10c9c19a 100644
--- a/documentation/content/zh-tw/books/porters-handbook/special/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/special/chapter.adoc
@@ -11,28 +11,36 @@ next: books/porters-handbook/flavors
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 6
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
This section explains the most common things to consider when creating a port.
@@ -4063,7 +4071,7 @@ See <<uses-sqlite>> for more information.
[[rc-scripts]]
== Starting and Stopping Services (`rc` Scripts)
-[.filename]#rc.d# scripts are used to start services on system startup, and to give administrators a standard way of stopping, starting and restarting the service. Ports integrate into the system [.filename]#rc.d# framework. Details on its usage can be found in link:{handbook}#configtuning-rcd/[the rc.d Handbook chapter]. Detailed explanation of the available commands is provided in man:rc[8] and man:rc.subr[8]. Finally, there is link:{rc-scripting}[an article] on practical aspects of [.filename]#rc.d# scripting.
+[.filename]#rc.d# scripts are used to start services on system startup, and to give administrators a standard way of stopping, starting and restarting the service. Ports integrate into the system [.filename]#rc.d# framework. Details on its usage can be found in extref:{handbook}config-tuning/[the rc.d Handbook chapter, configtuning-rcd]. Detailed explanation of the available commands is provided in man:rc[8] and man:rc.subr[8]. Finally, there is extref:{rc-scripting}[an article] on practical aspects of [.filename]#rc.d# scripting.
With a mythical port called _doorman_, which needs to start a _doormand_ daemon. Add the following to the [.filename]#Makefile#:
diff --git a/documentation/content/zh-tw/books/porters-handbook/testing/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/testing/chapter.adoc
index d96624b2d4..fe566aff91 100644
--- a/documentation/content/zh-tw/books/porters-handbook/testing/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/testing/chapter.adoc
@@ -11,28 +11,36 @@ next: books/porters-handbook/upgrading
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 10
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 10
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[make-describe]]
== Running `make describe`
@@ -192,7 +200,7 @@ Use the host [.filename]#/etc/resolv.conf# inside jails for DNS. This is needed
The FTP/HTTP server to use when the jails are installed from FreeBSD releases and updated with man:freebsd-update[8]. Choose a server location which is close, for example if the machine is located in Australia, use `ftp.au.freebsd.org`.
`SVN_HOST`::
-The server from where jails are installed and updated when using Subversion. Also used for ports tree when not using man:portsnap[8]. Again, choose a nearby location. A list of official Subversion mirrors can be found in the link:{handbook}#svn-mirrors[FreeBSD Handbook Subversion section].
+The server from where jails are installed and updated when using Subversion. Also used for ports tree when not using man:portsnap[8]. Again, choose a nearby location. A list of official Subversion mirrors can be found in the extref:{handbook}mirrors[FreeBSD Handbook Subversion section, svn-mirrors].
[[testing-poudriere-create-jails]]
=== Creating Poudriere Jails
diff --git a/documentation/content/zh-tw/books/porters-handbook/upgrading/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/upgrading/chapter.adoc
index fc39415577..ce72ab3f4c 100644
--- a/documentation/content/zh-tw/books/porters-handbook/upgrading/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/upgrading/chapter.adoc
@@ -11,32 +11,40 @@ next: books/porters-handbook/security
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 11
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 11
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
When a port is not the most recent version available from the authors, update the local working copy of [.filename]#/usr/ports#. The port might have already been updated to the new version.
-When working with more than a few ports, it will probably be easier to use Subversion to keep the whole ports collection up-to-date, as described in the link:{handbook}#ports-using/[Handbook]. This will have the added benefit of tracking all the port's dependencies.
+When working with more than a few ports, it will probably be easier to use Subversion to keep the whole ports collection up-to-date, as described in the extref:{handbook}ports/[Handbook, ports-using]. This will have the added benefit of tracking all the port's dependencies.
The next step is to see if there is an update already pending. To do this, there are two options. There is a searchable interface to the https://bugs.freebsd.org/search/[FreeBSD Problem Report (PR) or bug database]. Select `Ports & Packages` in the `Product` multiple select menu, and enter the name of the port in the `Summary` field.
@@ -62,11 +70,11 @@ If some files have been added, copied, moved, or removed, add this information t
To simplify common operations with patch files, use `make makepatch` as described in <<slow-patch>>. Other tools exists, like [.filename]#/usr/ports/Tools/scripts/patchtool.py#. Before using it, please read [.filename]#/usr/ports/Tools/scripts/README.patchtool#.
-If the port is unmaintained, and you are actively using it, please consider volunteering to become its maintainer. FreeBSD has over 4000 ports without maintainers, and this is an area where more volunteers are always needed. (For a detailed description of the responsibilities of maintainers, refer to the section in the link:{developers-handbook}#POLICIES-MAINTAINER[Developer's Handbook].)
+If the port is unmaintained, and you are actively using it, please consider volunteering to become its maintainer. FreeBSD has over 4000 ports without maintainers, and this is an area where more volunteers are always needed. (For a detailed description of the responsibilities of maintainers, refer to the section in the extref:{developers-handbook}[Developer's Handbook]., POLICIES-MAINTAINER)
To submit the diff, use the https://bugs.freebsd.org/submit/[bug submit form] (product `Ports & Packages`, component `Individual Port(s)`). Always include the category with the port name, followed by colon, and brief descripton of the issue. Examples: `_category/portname_: _add FOO option_`; `_category/portname_: _Update to X.Y_`. Please mention any added or deleted files in the message, as they have to be explicitly specified to man:svn[1] when doing a commit. Do not compress or encode the diff.
-Before submitting the bug, review the link:{problem-reports}#pr-writing/[ Writing the problem report] section in the Problem Reports article. It contains far more information about how to write useful problem reports.
+Before submitting the bug, review the extref:{problem-reports}#pr-writing/[ Writing the problem report] section in the Problem Reports article. It contains far more information about how to write useful problem reports.
[IMPORTANT]
====
@@ -94,7 +102,7 @@ When possible, please submit a man:svn[1] diff. They are easier to handle than d
<.> This can be anywhere, of course. Building ports is not limited to within [.filename]#/usr/ports/#.
-<.> https://svn.FreeBSD.org/[svn.FreeBSD.org] is the FreeBSD public Subversion server. See link:{handbook}#svn-mirrors[Subversion mirror sites] for more information.
+<.> https://svn.FreeBSD.org/[svn.FreeBSD.org] is the FreeBSD public Subversion server. See extref:{handbook}mirrors[Subversion mirror sites, svn-mirrors] for more information.
While in the port directory, make any changes that are needed. If adding, copying, moving, or removing a file, use `svn` to track these changes:
@@ -147,7 +155,7 @@ The last step is to make a unified man:diff[1] of the changes:
If files have been added, copied, moved, or removed, include the man:svn[1] `add`, `copy`, `move`, and `remove` commands that were used. `svn move` or `svn copy` must be run before the patch can be applied. `svn add` or `svn remove` must be run after the patch is applied.
====
-Send the patch following the link:{problem-reports}#pr-writing/[problem report submission guidelines].
+Send the patch following the extref:{problem-reports}[problem report submission guidelines, pr-writing].
[[moved-and-updating-files]]
== [.filename]#UPDATING# and [.filename]#MOVED#
diff --git a/documentation/content/zh-tw/books/porters-handbook/uses/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/uses/chapter.adoc
index 58e4a93c47..fc2a800eac 100644
--- a/documentation/content/zh-tw/books/porters-handbook/uses/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/uses/chapter.adoc
@@ -11,29 +11,36 @@ next: books/porters-handbook/versions
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 17
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:c-plus-plus: c++
-:sectnumoffset: 17
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[uses-intro]]
== An Introduction to `USES`
diff --git a/documentation/content/zh-tw/books/porters-handbook/versions/chapter.adoc b/documentation/content/zh-tw/books/porters-handbook/versions/chapter.adoc
index b7a2d3522f..bd29671154 100644
--- a/documentation/content/zh-tw/books/porters-handbook/versions/chapter.adoc
+++ b/documentation/content/zh-tw/books/porters-handbook/versions/chapter.adoc
@@ -10,28 +10,36 @@ prev: books/porters-handbook/uses
:toclevels: 1
:icons: font
:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 18
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:toc-title: 目录
-:part-signifier: 部分
-:chapter-signifier: 第
-:appendix-caption: 附录
-:table-caption: 表
-:figure-caption: 图
-:example-caption: 例
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 18
+:images-path: books/porters-handbook/
-include::shared/mirrors.adoc[]
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/zh-tw/mailing-lists.adoc[]
-include::shared/zh-tw/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
Here is a convenient list of `__FreeBSD_version` values as defined in http://svnweb.FreeBSD.org/base/head/sys/sys/param.h?view=markup[sys/param.h]: