diff --git a/documentation/Makefile b/documentation/Makefile --- a/documentation/Makefile +++ b/documentation/Makefile @@ -33,9 +33,10 @@ RUBY_CMD = ${LOCALBASE}/bin/ruby HUGO_CMD = ${LOCALBASE}/bin/hugo HUGO_ARGS?= --verbose --minify +HUGO_OFFLINE_ARGS?= --environment offline --verbose --minify ASCIIDOCTOR_CMD= ${LOCALBASE}/bin/asciidoctor ASCIIDOCTORPDF_CMD= ${LOCALBASE}/bin/asciidoctor-pdf -SED_CMD = /usr/bin/sed + .if defined(DOC_LANG) && !empty(DOC_LANG) LANGUAGES= ${DOC_LANG:S/,/ /g} .if ${LANGUAGES:Men} == "" && ${.TARGETS:Mpdf*} == "" && ${.TARGETS:Mhtml*} == "" @@ -112,7 +113,6 @@ @(echo ${LOCALBASE}/bin/asciidoctor-pdf not found, please run 'pkg install rubygem-asciidoctor-pdf'; exit 1) .endif - starting-message: .PHONY @echo --------------------------------------------------------------- @echo Building the documentation @@ -129,6 +129,15 @@ ${PYTHON_CMD} ./tools/books-toc-examples-creator.py -l ${BOOK_LANGS} .endif +generate-books-toc-offline: .PHONY +.if !empty(BOOK_LANGS) + ${PYTHON_CMD} ./tools/books-toc-parts-creator.py -o -l ${BOOK_LANGS} + ${PYTHON_CMD} ./tools/books-toc-creator.py -o -l ${BOOK_LANGS} + ${PYTHON_CMD} ./tools/books-toc-figures-creator.py -o -l ${BOOK_LANGS} + ${PYTHON_CMD} ./tools/books-toc-tables-creator.py -o -l ${BOOK_LANGS} + ${PYTHON_CMD} ./tools/books-toc-examples-creator.py -o -l ${BOOK_LANGS} +.endif + generate-pgpkeys-txt: static/pgpkeys/pgpkeys.txt static/pgpkeys/pgpkeys.txt: static/pgpkeys/*key @@ -141,13 +150,16 @@ build: .PHONY HUGO_DISABLELANGUAGES="${SKIP_LANGS}" ${HUGO_CMD} ${HUGO_ARGS} +build-offline: .PHONY + HUGO_DISABLELANGUAGES="${SKIP_LANGS}" ${HUGO_CMD} ${HUGO_OFFLINE_ARGS} + toc-clean: .PHONY .if !empty(BOOK_LANGS) - rm -f $$(${PYTHON_CMD} ./tools/books-toc-parts-creator.py -l ${BOOK_LANGS} -o) - rm -f $$(${PYTHON_CMD} ./tools/books-toc-creator.py -l ${BOOK_LANGS} -o) - rm -f $$(${PYTHON_CMD} ./tools/books-toc-figures-creator.py -l ${BOOK_LANGS} -o) - rm -f $$(${PYTHON_CMD} ./tools/books-toc-tables-creator.py -l ${BOOK_LANGS} -o) - rm -f $$(${PYTHON_CMD} ./tools/books-toc-examples-creator.py -l ${BOOK_LANGS} -o) + rm -f $$(${PYTHON_CMD} ./tools/books-toc-parts-creator.py -l ${BOOK_LANGS} -p) + rm -f $$(${PYTHON_CMD} ./tools/books-toc-creator.py -l ${BOOK_LANGS} -p) + rm -f $$(${PYTHON_CMD} ./tools/books-toc-figures-creator.py -l ${BOOK_LANGS} -p) + rm -f $$(${PYTHON_CMD} ./tools/books-toc-tables-creator.py -l ${BOOK_LANGS} -p) + rm -f $$(${PYTHON_CMD} ./tools/books-toc-examples-creator.py -l ${BOOK_LANGS} -p) .endif pgp-clean: .PHONY @@ -162,257 +174,52 @@ # pdf: pdf-articles pdf-books -pdf-books-target: +pdf-books: requirements-pdf generate-books-toc .for _lang in ${BOOK_LANGS} -TMP+= ${.CURDIR}/content/${_lang}/books/*/ + ./tools/asciidoctor.sh books ${_lang} pdf .endfor -BOOKSDIR != echo ${TMP} -pdf-articles-target: +pdf-articles: requirements-pdf .for _lang in ${ARTICLE_LANGS} -TTMP += ${.CURDIR}/content/${_lang}/articles/*/ -.endfor -ARTICLESDIR != echo ${TTMP} - -pdf-books: requirements-pdf pdf-books-target generate-books-toc - -# Books build -# -# Notes: -# pdf-theme=default-with-fallback-font is -# used instead of pdf-theme=./themes/default-pdf-theme.yml because -# it allows ja, ru, tr, zh-* fonts to be embedded and rendering is -# better for other languages. -# -# asciidoctor-pdf-cjk and/or specific themes should be used for cjk -# fonts -.for _curpdf in ${BOOKSDIR} - @mkdir -p ${.CURDIR}/public${_curpdf:S|^${.CURDIR}/content||} -.if exists(${_curpdf}book.adoc) - ${ASCIIDOCTORPDF_CMD} \ - -r ./shared/lib/man-macro.rb \ - -r ./shared/lib/man-macro.rb \ - -r ./shared/lib/git-macro.rb \ - -r ./shared/lib/packages-macro.rb \ - -r ./shared/lib/inter-document-references-macro.rb \ - -r ./shared/lib/sectnumoffset-treeprocessor.rb \ - --doctype=book \ - -a skip-front-matter \ - -a pdf-theme=default-with-fallback-font \ - -o ${.CURDIR}/public${_curpdf:S|^${.CURDIR}/content||}book.pdf \ - ${_curpdf}book.adoc -.else -# some books use _index.adoc as main document - ${ASCIIDOCTORPDF_CMD} \ - -r ./shared/lib/man-macro.rb \ - -r ./shared/lib/man-macro.rb \ - -r ./shared/lib/git-macro.rb \ - -r ./shared/lib/packages-macro.rb \ - -r ./shared/lib/inter-document-references-macro.rb \ - -r ./shared/lib/sectnumoffset-treeprocessor.rb \ - --doctype=book \ - -a skip-front-matter \ - -a pdf-theme=default-with-fallback-font \ - -o ${.CURDIR}/public${_curpdf:S|^${.CURDIR}/content||}book.pdf \ - ${_curpdf}_index.adoc -.endif -.endfor - -pdf-articles: requirements-pdf pdf-articles-target - -# Articles build -.for _curpdf in ${ARTICLESDIR} - @mkdir -p ${.CURDIR}/public${_curpdf:S|^${.CURDIR}/content||} - ${ASCIIDOCTORPDF_CMD} \ - -r ./shared/lib/man-macro.rb \ - -r ./shared/lib/man-macro.rb \ - -r ./shared/lib/git-macro.rb \ - -r ./shared/lib/packages-macro.rb \ - -r ./shared/lib/inter-document-references-macro.rb \ - -r ./shared/lib/sectnumoffset-treeprocessor.rb \ - --doctype=article \ - -a skip-front-matter \ - -a pdf-theme=default-with-fallback-font \ - -o ${.CURDIR}/public${_curpdf:S|^${.CURDIR}/content||}article.pdf \ - ${_curpdf}_index.adoc -.if exists(${.CURDIR}/static/source/articles/${_curpdf:H:T}) - cp -R ${.CURDIR}/static/source/articles/${_curpdf:H:T}/ \ - ${.CURDIR}/public${_curpdf:S|^${.CURDIR}/content||} -.endif + ./tools/asciidoctor.sh articles ${_lang} pdf .endfor pdf-clean: pdf-articles-clean pdf-books-clean -pdf-books-clean: pdf-books-target toc-clean -.for _curpdf in ${BOOKSDIR} - rm -f ${.CURDIR}/public${_curpdf:S|^${.CURDIR}/content||}book.pdf -.endfor +pdf-books-clean: .for _lang in ${BOOK_LANGS} rm -fr ${.CURDIR}/public/${_lang}/books -rmdir ${.CURDIR}/public/${_lang} .endfor -rmdir ${.CURDIR}/public/ -# -# HTML targets -# Use DOC_LANG to choose the language, e.g., make DOC_LANG="en fr" html-books -# -html: html-articles html-books - -html-books-target: -.for _lang in ${BOOK_LANGS} -TMPH += ${.CURDIR}/content/${_lang}/books/*/ -.endfor -BOOKSDIR != echo ${TMPH} - -html-articles-target: +pdf-articles-clean: .for _lang in ${ARTICLE_LANGS} -TTMPH += ${.CURDIR}/content/${_lang}/articles/*/ -.endfor -ARTICLESDIR != echo ${TTMPH} - -html-books: html-books-target generate-books-toc - -# Books build -# -.for _curhtml in ${BOOKSDIR} - @mkdir -p ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||} -.if exists(${_curhtml}book.adoc) - ${ASCIIDOCTOR_CMD} \ - -B ${.CURDIR}/ \ - -r ./shared/lib/man-macro.rb \ - -r ./shared/lib/man-macro.rb \ - -r ./shared/lib/git-macro.rb \ - -r ./shared/lib/packages-macro.rb \ - -r ./shared/lib/inter-document-references-macro.rb \ - -r ./shared/lib/sectnumoffset-treeprocessor.rb \ - --doctype=book \ - -a skip-front-matter \ - -a linkcss -a copycss=${.CURDIR}/themes/beastie/static/css/docbook.css -a stylesheet=docbook.css -a stylesdir=../../css \ - -a iconfont-remote! -a iconfont-name=font-awesome-min \ - -o ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||}book.html \ - ${_curhtml}book.adoc -.if exists(${.CURDIR}/static/images/books/${_curhtml:H:T}) - @mkdir -p ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||:H:H:H}/images/books/ - cp -R ${.CURDIR}/static/images/books/${_curhtml:H:T}/ \ - ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||:H:H:H}/images/books/${_curhtml:H:T}/ - ${SED_CMD} -i '' -e "s|../../../../images|../../images|g" \ - ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||}book.html -.endif -.else -# some books use _index.adoc as main document - ${ASCIIDOCTOR_CMD} \ - -B ${.CURDIR}/ \ - -r ./shared/lib/man-macro.rb \ - -r ./shared/lib/man-macro.rb \ - -r ./shared/lib/git-macro.rb \ - -r ./shared/lib/packages-macro.rb \ - -r ./shared/lib/inter-document-references-macro.rb \ - -r ./shared/lib/sectnumoffset-treeprocessor.rb \ - --doctype=book \ - -a skip-front-matter \ - -a linkcss -a copycss=${.CURDIR}/themes/beastie/static/css/docbook.css -a stylesheet=docbook.css -a stylesdir=../../css \ - -a iconfont-remote! -a iconfont-name=font-awesome-min \ - -o ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||}book.html \ - ${_curhtml}_index.adoc -.if exists(${.CURDIR}/static/images/books/${_curhtml:H:T}) - @mkdir -p ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||:H:H:H}/images/books/ - cp -R ${.CURDIR}/static/images/books/${_curhtml:H:T}/ \ - ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||:H:H:H}/images/books/${_curhtml:H:T}/ - ${SED_CMD} -i '' -e "s|../../../../images|../../images|g" \ - ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||}book.html -.endif -.endif -.if !exists(${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||:H:H:H}/fonts/) - mkdir -p ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||:H:H:H}/fonts/ - cp -R ${.CURDIR}/themes/beastie/static/fonts/ \ - ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||:H:H:H}/fonts/ - cp ${.CURDIR}/themes/beastie/static/css/font-awesome-min.css \ - ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||:H:H:H}/css/ -.endif -.endfor - -html-articles: html-articles-target - -# Articles build -.for _curhtml in ${ARTICLESDIR} - @mkdir -p ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||} - ${ASCIIDOCTOR_CMD} \ - -B ${.CURDIR}/ \ - -r ./shared/lib/man-macro.rb \ - -r ./shared/lib/man-macro.rb \ - -r ./shared/lib/git-macro.rb \ - -r ./shared/lib/packages-macro.rb \ - -r ./shared/lib/inter-document-references-macro.rb \ - -r ./shared/lib/sectnumoffset-treeprocessor.rb \ - --doctype=article \ - -a skip-front-matter \ - -a linkcss -a copycss=${.CURDIR}/themes/beastie/static/css/docbook.css -a stylesheet=docbook.css -a stylesdir=../../css \ - -a iconfont-remote! -a iconfont-name=font-awesome-min \ - -o ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||}article.html \ - ${_curhtml}_index.adoc -.if exists(${.CURDIR}/static/source/articles/${_curhtml:H:T}) - cp -R ${.CURDIR}/static/source/articles/${_curhtml:H:T}/ \ - ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||} -.endif -.if exists(${.CURDIR}/static/images/articles/${_curhtml:H:T}) - @mkdir -p ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||:H:H:H}/images/articles/ - cp -R ${.CURDIR}/static/images/articles/${_curhtml:H:T}/ \ - ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||:H:H:H}/images/articles/${_curhtml:H:T}/ - ${SED_CMD} -i '' -e "s|../../../images|../../images|g" \ - ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||}article.html -.endif -.if !exists(${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||:H:H:H}/fonts/) - mkdir -p ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||:H:H:H}/fonts/ - cp -R ${.CURDIR}/themes/beastie/static/fonts/ \ - ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||:H:H:H}/fonts/ - cp ${.CURDIR}/themes/beastie/static/css/font-awesome-min.css \ - ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||:H:H:H}/css/ + rm -fr ${.CURDIR}/public/${_lang}/articles +.if !exists(${.CURDIR}/public/${_lang}/books) + rm -fr ${.CURDIR}/public/${_lang} .endif .endfor + -rmdir ${.CURDIR}/public -html-clean: html-resources-clean html-articles-clean html-books-clean +# +# HTML targets +# +html: generate-books-toc-offline build-offline html-clean-global html-clean-articles html-clean-books -html-resources-clean: -.for _lang in ${LANGUAGES} - rm -fr ${.CURDIR}/public/${_lang}/css - rm -fr ${.CURDIR}/public/${_lang}/fonts - rm -fr ${.CURDIR}/public/${_lang}/images -.endfor +html-clean: hugo-clean -html-books-clean: html-books-target toc-clean -.for _curhtml in ${BOOKSDIR} - rm -f ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||}book.html ${_curhtml}toc*.adoc - -rmdir ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||} -.endfor -.for _lang in ${BOOK_LANGS} - rm -fr ${.CURDIR}/public/${_lang}/books - rm -fr ${.CURDIR}/public/${_lang}/images/books - -rmdir ${.CURDIR}/public/${_lang} -.endfor - -rmdir ${.CURDIR}/public +html-clean-global: + rm -fr ${.CURDIR}/public/index.html + rm -rf pgpkeys js -html-articles-clean: html-articles-target -.for _curhtml in ${ARTICLESDIR} - rm -f ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||}article.html - -rmdir ${.CURDIR}/public${_curhtml:S|^${.CURDIR}/content||} -.endfor +html-clean-articles: .for _lang in ${ARTICLE_LANGS} - rm -fr ${.CURDIR}/public/${_lang}/articles - rm -fr ${.CURDIR}/public/${_lang}/images/articles - -rmdir ${.CURDIR}/public/${_lang} + rm -fr ${.CURDIR}/public/${_lang}/index.html + rm -fr ${.CURDIR}/public/${_lang}/articles/index.html .endfor - -rmdir ${.CURDIR}/public -pdf-articles-clean: pdf-articles-target -.for _curpdf in ${ARTICLESDIR} - rm -f ${.CURDIR}/public${_curpdf:S|^${.CURDIR}/content||}article.pdf -.endfor -.for _lang in ${ARTICLE_LANGS} - rm -fr ${.CURDIR}/public/${_lang}/articles -.if !exists(${.CURDIR}/public/${_lang}/books) - rm -fr ${.CURDIR}/public/${_lang} -.endif +html-clean-books: +.for _lang in ${BOOK_LANGS} + rm -fr ${.CURDIR}/public/${_lang}/books/index.html .endfor - -rmdir ${.CURDIR}/public - diff --git a/documentation/config/_default/config.toml b/documentation/config/_default/config.toml --- a/documentation/config/_default/config.toml +++ b/documentation/config/_default/config.toml @@ -1,5 +1,4 @@ # FreeBSD documentation -# $FreeBSD$ baseURL = "https://docs.freebsd.org/" title = "FreeBSD Documentation Portal" @@ -10,17 +9,21 @@ theme = "beastie" disableKinds = [ "taxonomy", "taxonomyTerm" ] authors = [ "carlavilla@FreeBSD.org" ] -preserveTOC = true -ignoreFiles = [ "chapters-order.adoc$", "toc.adoc$", "toc-tables.adoc$", "toc-figures.adoc$", "toc-examples.adoc$", "toc-1.adoc$", "toc-2.adoc$", "toc-3.adoc$", "toc-4.adoc$", "toc-5.adoc$", "books.adoc$", "chapter.adoc$", "\\.po$" ] +ignoreFiles = [ "chapters-order.adoc$", "toc.adoc$", "toc-tables.adoc$", "toc-figures.adoc$", "toc-examples.adoc$", "toc-1.adoc$", "toc-2.adoc$", "toc-3.adoc$", "toc-4.adoc$", "toc-5.adoc$", "books.adoc$", "chapter.adoc$", "contrib-386bsd.adoc$", "contrib-additional.adoc$", "contrib-committers.adoc$", "contrib-corealumni.adoc$", "contrib-develalumni.adoc$", "contrib-develinmemoriam.adoc$", "contrib-portmgralumni.adoc$", "\\.po$" ] enableRobotsTXT = true [params] websiteURL = "https://www.FreeBSD.org/" description = "FreeBSD Documentation Portal" + isOnline = true [markup.asciidocExt] preserveTOC = true - extensions = ["man-macro", "inter-document-references-macro", "sectnumoffset-treeprocessor", "packages-macro", "git-macro"] + extensions = ["man-macro", "inter-document-references-macro", "cross-document-references-macro", "sectnumoffset-treeprocessor", "packages-macro", "git-macro"] + [markup.asciidocExt.attributes] + env-beastie = true + isOnline = true + skip-front-matter = true [outputs] home = [ "HTML" ] diff --git a/documentation/config/offline/config.toml b/documentation/config/offline/config.toml new file mode 100644 --- /dev/null +++ b/documentation/config/offline/config.toml @@ -0,0 +1,33 @@ +# FreeBSD documentation + +baseURL = "localhost" +title = "FreeBSD Documentation Portal" +copyright = "BSD 2-clause 'Simplified' License" +DefaultContentLanguage = "en" +defaultContentLanguageInSubdir = true +disablePathToLower = true +theme = "beastie" +disableKinds = [ "taxonomy", "term", "RSS", "sitemap", "robotsTXT", "404" ] +authors = [ "carlavilla@FreeBSD.org" ] +ignoreFiles = [ "chapters-order.adoc$", "toc.adoc$", "toc-tables.adoc$", "toc-figures.adoc$", "toc-examples.adoc$", "toc-1.adoc$", "toc-2.adoc$", "toc-3.adoc$", "toc-4.adoc$", "toc-5.adoc$", "chapter.adoc$", "contrib-386bsd.adoc$", "contrib-additional.adoc$", "contrib-committers.adoc$", "contrib-corealumni.adoc$", "contrib-develalumni.adoc$", "contrib-develinmemoriam.adoc$", "contrib-portmgralumni.adoc$", "books.adoc$", "\\.po$" ] +enableRobotsTXT = true + +[params] + websiteURL = "https://www.FreeBSD.org/" + description = "FreeBSD Documentation Portal" + isOnline = false + +[markup.asciidocExt] + preserveTOC = true + extensions = ["man-macro", "inter-document-references-macro", "cross-document-references-macro", "sectnumoffset-treeprocessor", "packages-macro", "git-macro"] + [markup.asciidocExt.attributes] + env-beastie = true + isOnline = false + skip-front-matter = true + +[outputs] +home = [ "HTML" ] +page = [ "HTML" ] +list = [ "HTML" ] +single = [ "HTML" ] +section = [ "HTML" ] diff --git a/documentation/content/bn-bd/articles/explaining-bsd/_index.adoc b/documentation/content/bn-bd/articles/explaining-bsd/_index.adoc --- a/documentation/content/bn-bd/articles/explaining-bsd/_index.adoc +++ b/documentation/content/bn-bd/articles/explaining-bsd/_index.adoc @@ -3,7 +3,6 @@ authors: - author: গ্রেগ লেহেই email: grog@FreeBSD.org -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sparc", "sun", "unix", "general"] --- @@ -16,6 +15,27 @@ :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 --- a/documentation/content/bn-bd/articles/new-users/_index.adoc +++ b/documentation/content/bn-bd/articles/new-users/_index.adoc @@ -3,7 +3,6 @@ authors: - author: অ্যানেলিস এন্ডারসন email: andrsn@andrsn.stanford.edu -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"] --- @@ -16,6 +15,27 @@ :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 --- a/documentation/content/da/articles/ipsec-must/_index.adoc +++ b/documentation/content/da/articles/ipsec-must/_index.adoc @@ -3,7 +3,6 @@ authors: - author: David Honig email: honig@sprynet.com -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "opengroup", "general"] --- @@ -16,10 +15,27 @@ :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 @@ 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 --- 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 @@ :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 @@ 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 @@ [[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 @@ 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 <>. +Ä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 <>. === Ä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 @@ ==== 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 --- a/documentation/content/de/articles/explaining-bsd/_index.adoc +++ b/documentation/content/de/articles/explaining-bsd/_index.adoc @@ -3,7 +3,6 @@ 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 @@ :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 --- a/documentation/content/de/articles/freebsd-update-server/_index.adoc +++ b/documentation/content/de/articles/freebsd-update-server/_index.adoc @@ -4,7 +4,6 @@ - author: Jason Helfman email: jgh@FreeBSD.org copyright: 2009-2011, 2013 Jason Helfma -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "amd", "intel", "general"] --- @@ -17,21 +16,26 @@ :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 @@ ==== * 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 @@ ==== -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 @@ % 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 @@ [[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 @@ 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 --- 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 @@ :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 @@ [[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 --- a/documentation/content/de/articles/linux-users/_index.adoc +++ b/documentation/content/de/articles/linux-users/_index.adoc @@ -3,7 +3,6 @@ authors: - author: John Ferrell copyright: 2008 The FreeBSD Documentation Project -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"] --- @@ -16,21 +15,26 @@ :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 @@ 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 @@ # 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 @@ # 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 @@ 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 @@ 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 @@ ==== -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 @@ [[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 --- a/documentation/content/de/articles/nanobsd/_index.adoc +++ b/documentation/content/de/articles/nanobsd/_index.adoc @@ -15,21 +15,26 @@ :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 --- a/documentation/content/de/articles/new-users/_index.adoc +++ b/documentation/content/de/articles/new-users/_index.adoc @@ -3,7 +3,6 @@ authors: - author: Annelise Anderson email: andrsn@andrsn.stanford.edu -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"] --- @@ -16,24 +15,26 @@ :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 @@ 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 --- a/documentation/content/de/articles/port-mentor-guidelines/_index.adoc +++ b/documentation/content/de/articles/port-mentor-guidelines/_index.adoc @@ -3,7 +3,6 @@ organizations: - organization: Das FreeBSD Ports-Management Team copyright: 2011 Thomas Abthorpe, Chris Rees -releaseinfo: "$FreeBSD$" --- = Richtlinien für Port-Mentoren @@ -15,21 +14,26 @@ :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 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 --- a/documentation/content/de/articles/solid-state/_index.adoc +++ b/documentation/content/de/articles/solid-state/_index.adoc @@ -4,7 +4,6 @@ - author: John Kozubik email: john@kozubik.com copyright: 2001, 2009 The FreeBSD Documentation Project -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "general"] --- @@ -17,10 +16,27 @@ :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 --- a/documentation/content/de/books/developers-handbook/_index.adoc +++ b/documentation/content/de/books/developers-handbook/_index.adoc @@ -3,8 +3,8 @@ 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 @@ :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 @@ [[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 --- a/documentation/content/de/books/developers-handbook/bibliography/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/bibliography/chapter.adoc @@ -10,21 +10,37 @@ :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 --- a/documentation/content/de/books/developers-handbook/introduction/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/introduction/chapter.adoc @@ -11,24 +11,36 @@ :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 --- a/documentation/content/de/books/developers-handbook/ipv6/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/ipv6/chapter.adoc @@ -11,26 +11,36 @@ :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 --- a/documentation/content/de/books/developers-handbook/kernelbuild/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/kernelbuild/chapter.adoc @@ -11,25 +11,36 @@ :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 @@ [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 @@ [[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 --- a/documentation/content/de/books/developers-handbook/kerneldebug/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/kerneldebug/chapter.adoc @@ -15,25 +15,36 @@ :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 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 --- a/documentation/content/de/books/developers-handbook/l10n/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/l10n/chapter.adoc @@ -11,25 +11,36 @@ :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 --- a/documentation/content/de/books/developers-handbook/policies/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/policies/chapter.adoc @@ -14,25 +14,36 @@ :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 --- a/documentation/content/de/books/developers-handbook/secure/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/secure/chapter.adoc @@ -13,25 +13,36 @@ :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 --- a/documentation/content/de/books/developers-handbook/sockets/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/sockets/chapter.adoc @@ -13,24 +13,35 @@ :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 <>. 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 --- a/documentation/content/de/books/developers-handbook/testing/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/testing/chapter.adoc @@ -11,25 +11,36 @@ :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 --- a/documentation/content/de/books/developers-handbook/tools/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/tools/chapter.adoc @@ -15,30 +15,40 @@ :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 @@ 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 --- a/documentation/content/de/books/developers-handbook/x86/chapter.adoc +++ b/documentation/content/de/books/developers-handbook/x86/chapter.adoc @@ -11,25 +11,36 @@ :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 --- a/documentation/content/de/books/faq/_index.adoc +++ b/documentation/content/de/books/faq/_index.adoc @@ -3,8 +3,8 @@ 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 @@ :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 @@ 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 @@ 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 @@ === 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 @@ === 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 @@ === 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 <> diskutiert und es bestehen keinerlei Einschränkungen darüber, wer sich an diesen Diskussionen beteiligen darf. @@ -199,7 +185,7 @@ * https://www.FreeBSD.org/snapshots/[Snapshot]-Releases werden monatlich aus dem <>-Zweig sowie aus dem <>-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 @@ Ü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 <> 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 <> 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 @@ === 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 @@ 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 @@ === 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 @@ === 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 @@ === 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 @@ 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 @@ === 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 @@ 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 @@ === 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 @@ === 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 @@ 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 @@ % 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 @@ Um die Größe des Kernels weiter zu reduzieren, können nicht benötigte Geräte aus dem Kernel entfernt werden. <> 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 @@ === 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 @@ === 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 @@ === 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 @@ === 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 @@ === 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 @@ .... + -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 @@ [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 @@ 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 @@ # 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 @@ === 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 @@ === 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 @@ # 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 @@ === 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 @@ === 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 @@ 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 @@ === 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 @@ 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 @@ 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 @@ 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 @@ === 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 @@ === 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 @@ === 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 @@ === 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 @@ === 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 @@ === 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 @@ === 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 @@ 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 --- a/documentation/content/de/books/handbook/_index.adoc +++ b/documentation/content/de/books/handbook/_index.adoc @@ -3,9 +3,9 @@ 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 @@ :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 @@ ''' -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 --- a/documentation/content/de/books/handbook/advanced-networking/_index.adoc +++ b/documentation/content/de/books/handbook/advanced-networking/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/audit/_index.adoc +++ b/documentation/content/de/books/handbook/audit/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/basics/_index.adoc +++ b/documentation/content/de/books/handbook/basics/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/bibliography/_index.adoc +++ b/documentation/content/de/books/handbook/bibliography/_index.adoc @@ -9,25 +9,40 @@ [[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 @@ * 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 --- a/documentation/content/de/books/handbook/book.adoc +++ b/documentation/content/de/books/handbook/book.adoc @@ -3,7 +3,6 @@ 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 @@ :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 @@ :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 --- a/documentation/content/de/books/handbook/boot/_index.adoc +++ b/documentation/content/de/books/handbook/boot/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/bsdinstall/_index.adoc +++ b/documentation/content/de/books/handbook/bsdinstall/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/config/_index.adoc +++ b/documentation/content/de/books/handbook/config/_index.adoc @@ -13,36 +13,35 @@ :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 @@ 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 --- a/documentation/content/de/books/handbook/cutting-edge/_index.adoc +++ b/documentation/content/de/books/handbook/cutting-edge/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/desktop/_index.adoc +++ b/documentation/content/de/books/handbook/desktop/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/disks/_index.adoc +++ b/documentation/content/de/books/handbook/disks/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/dtrace/_index.adoc +++ b/documentation/content/de/books/handbook/dtrace/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/eresources/_index.adoc +++ b/documentation/content/de/books/handbook/eresources/_index.adoc @@ -9,26 +9,40 @@ [[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 @@ _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 --- a/documentation/content/de/books/handbook/filesystems/_index.adoc +++ b/documentation/content/de/books/handbook/filesystems/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/firewalls/_index.adoc +++ b/documentation/content/de/books/handbook/firewalls/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/geom/_index.adoc +++ b/documentation/content/de/books/handbook/geom/_index.adoc @@ -13,36 +13,35 @@ :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 @@ 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 --- a/documentation/content/de/books/handbook/introduction/_index.adoc +++ b/documentation/content/de/books/handbook/introduction/_index.adoc @@ -13,24 +13,35 @@ :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 @@ * _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 @@ [[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 @@ 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 --- a/documentation/content/de/books/handbook/jails/_index.adoc +++ b/documentation/content/de/books/handbook/jails/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/kernelconfig/_index.adoc +++ b/documentation/content/de/books/handbook/kernelconfig/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/l10n/_index.adoc +++ b/documentation/content/de/books/handbook/l10n/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/linuxemu/_index.adoc +++ b/documentation/content/de/books/handbook/linuxemu/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/mac/_index.adoc +++ b/documentation/content/de/books/handbook/mac/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/mail/_index.adoc +++ b/documentation/content/de/books/handbook/mail/_index.adoc @@ -13,36 +13,35 @@ :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 @@ [[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 --- a/documentation/content/de/books/handbook/mirrors/_index.adoc +++ b/documentation/content/de/books/handbook/mirrors/_index.adoc @@ -9,26 +9,40 @@ [[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 --- a/documentation/content/de/books/handbook/multimedia/_index.adoc +++ b/documentation/content/de/books/handbook/multimedia/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/network-servers/_index.adoc +++ b/documentation/content/de/books/handbook/network-servers/_index.adoc @@ -13,36 +13,35 @@ :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 @@ # 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 --- a/documentation/content/de/books/handbook/parti.adoc +++ b/documentation/content/de/books/handbook/parti.adoc @@ -4,6 +4,14 @@ 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 @@ 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 --- a/documentation/content/de/books/handbook/partii.adoc +++ b/documentation/content/de/books/handbook/partii.adoc @@ -4,6 +4,14 @@ 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 @@ 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 --- a/documentation/content/de/books/handbook/partiii.adoc +++ b/documentation/content/de/books/handbook/partiii.adoc @@ -4,6 +4,14 @@ 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 @@ 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 --- a/documentation/content/de/books/handbook/partiv.adoc +++ b/documentation/content/de/books/handbook/partiv.adoc @@ -4,6 +4,14 @@ 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 @@ 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 --- a/documentation/content/de/books/handbook/partv.adoc +++ b/documentation/content/de/books/handbook/partv.adoc @@ -4,7 +4,15 @@ 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 --- a/documentation/content/de/books/handbook/pgpkeys/_index.adoc +++ b/documentation/content/de/books/handbook/pgpkeys/_index.adoc @@ -9,29 +9,46 @@ [[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 --- a/documentation/content/de/books/handbook/ports/_index.adoc +++ b/documentation/content/de/books/handbook/ports/_index.adoc @@ -13,36 +13,35 @@ :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 @@ **** *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 @@ * [.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 @@ + [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 <>. diff --git a/documentation/content/de/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/de/books/handbook/ppp-and-slip/_index.adoc --- 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 @@ :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 --- a/documentation/content/de/books/handbook/preface/_index.adoc +++ b/documentation/content/de/books/handbook/preface/_index.adoc @@ -11,16 +11,33 @@ :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 --- a/documentation/content/de/books/handbook/printing/_index.adoc +++ b/documentation/content/de/books/handbook/printing/_index.adoc @@ -13,36 +13,35 @@ :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 @@ [[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 --- a/documentation/content/de/books/handbook/security/_index.adoc +++ b/documentation/content/de/books/handbook/security/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/serialcomms/_index.adoc +++ b/documentation/content/de/books/handbook/serialcomms/_index.adoc @@ -13,36 +13,35 @@ :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 @@ 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 --- 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 @@ :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 --- a/documentation/content/de/books/handbook/virtualization/_index.adoc +++ b/documentation/content/de/books/handbook/virtualization/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/handbook/x11/_index.adoc +++ b/documentation/content/de/books/handbook/x11/_index.adoc @@ -13,36 +13,35 @@ :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 @@ 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 --- a/documentation/content/de/books/handbook/zfs/_index.adoc +++ b/documentation/content/de/books/handbook/zfs/_index.adoc @@ -13,36 +13,35 @@ :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 --- a/documentation/content/de/books/porters-handbook/_index.adoc +++ b/documentation/content/de/books/porters-handbook/_index.adoc @@ -3,8 +3,8 @@ 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 @@ :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-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 --- 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 @@ :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 --- a/documentation/content/de/books/porters-handbook/makefile/chapter.adoc +++ b/documentation/content/de/books/porters-handbook/makefile/chapter.adoc @@ -11,19 +11,36 @@ :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 <> 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 @@ 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 @@ ** 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 --- 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 @@ :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 --- 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 @@ :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 --- a/documentation/content/de/books/porters-handbook/plist/chapter.adoc +++ b/documentation/content/de/books/porters-handbook/plist/chapter.adoc @@ -11,19 +11,36 @@ :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 --- 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 @@ :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 @@ 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 @@ <.> 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 --- 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 @@ :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 <>, 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 <>, 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 --- 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 @@ :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 --- 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 @@ :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 @@ 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 @@ 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 --- a/documentation/content/de/books/porters-handbook/security/chapter.adoc +++ b/documentation/content/de/books/porters-handbook/security/chapter.adoc @@ -11,19 +11,36 @@ :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 --- a/documentation/content/de/books/porters-handbook/slow/chapter.adoc +++ b/documentation/content/de/books/porters-handbook/slow/chapter.adoc @@ -11,19 +11,36 @@ :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 --- a/documentation/content/de/books/porters-handbook/special/chapter.adoc +++ b/documentation/content/de/books/porters-handbook/special/chapter.adoc @@ -11,19 +11,36 @@ :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 @@ [[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 --- a/documentation/content/de/books/porters-handbook/testing/chapter.adoc +++ b/documentation/content/de/books/porters-handbook/testing/chapter.adoc @@ -11,19 +11,36 @@ :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 --- 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 @@ :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 --- a/documentation/content/el/articles/bsdl-gpl/_index.adoc +++ b/documentation/content/el/articles/bsdl-gpl/_index.adoc @@ -5,7 +5,6 @@ email: brucem@alumni.cse.ucsc.edu - author: Γιώργος Κεραμίδας email: keramida@FreeBSD.org -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "cvsup", "intel", "xfree86", "general"] --- @@ -18,10 +17,27 @@ :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 --- a/documentation/content/el/articles/contributing/_index.adoc +++ b/documentation/content/el/articles/contributing/_index.adoc @@ -3,7 +3,6 @@ authors: - author: Jordan Hubbard - author: Κυριάκος Κεντρωτής -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "ieee", "general"] --- @@ -16,24 +15,26 @@ :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 @@ Αρκετοί άνθρωποι που σχετίζονται με το 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 @@ [[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 @@ Εάν δε λάβετε επιβεβαίωση εγκαίρως (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] όπως περιγράφετε στο <>. +Οι αλλαγές στην τεκμηρίωση επιβλέπονται από την {freebsd-doc}. Για πλήρεις οδηγίες σχετικά με τον τρόπο που μπορείτε να συνεισφέρετε στην τεκμηρίωση του FreeBSD, δείτε τον extref:{fdp-primer}[Οδηγό τεκμηρίωσης του FreeBSD]. Στείλτε τα καινούρια σας κείμενα ή τις αλλαγές σας (ακόμη και μικροδιορθώσεις είναι πάντα καλοδεχούμενες) χρησιμοποιώντας την εντολή man:send-pr[1] όπως περιγράφετε στο <>. === Αλλαγές στον Πηγαίο Κώδικα -Μία προσθήκη ή αλλαγή στον υπάρχοντα κώδικα είναι κατά κάποιο τρόπο περίτεχνη υπόθεση και εξαρτάται αρκετά από τον βαθμό της ενημέρωσης που έχετε με την τρέχουσα κατάσταση της ανάπτυξης του 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 @@ ==== Δωρέες Πρόσβασης στο Διαδίκτυο -Πάντα είναι χρήσιμο να έχουμε καινούρια 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 --- a/documentation/content/el/articles/explaining-bsd/_index.adoc +++ b/documentation/content/el/articles/explaining-bsd/_index.adoc @@ -3,7 +3,6 @@ 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 @@ :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 --- a/documentation/content/el/articles/freebsd-questions/_index.adoc +++ b/documentation/content/el/articles/freebsd-questions/_index.adoc @@ -3,7 +3,6 @@ authors: - author: Greg Lehey email: grog@FreeBSD.org -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "microsoft", "opengroup", "qualcomm", "general"] --- @@ -16,24 +15,26 @@ :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 @@ Μπορείτε (και πρέπει) να κάνετε κάποια πράγματα από μόνοι σας πριν στείλετε μια ερώτηση σε κάποια από τις λίστες ηλεκτρονικού ταχυδρομείου. * Προσπαθείστε να λύσετε το πρόβλημα μόνοι σας. Αν στείλετε μια ερώτηση η οποία δείχνει ότι έχετε προσπαθήσει ήδη να λύσετε το πρόβλημα, είναι σχεδόν σίγουρο ότι η ερώτησή σας θα κινήσει το ενδιαφέρον περισσότερο ενδιαφέρον. Η προσπάθεια να λύσετε το πρόβλημα μόνοι σας έχει κι άλλα καλά αποτελέσματα: θα βελτιώσει την κατανόηση που έχετε για τον τρόπο που δουλεύει το 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 --- a/documentation/content/el/articles/gjournal-desktop/_index.adoc +++ b/documentation/content/el/articles/gjournal-desktop/_index.adoc @@ -3,7 +3,6 @@ authors: - author: Μανώλης Κιαγιάς email: manolis@FreeBSD.org -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "general"] --- @@ -16,32 +15,27 @@ :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 GEOM_JOURNAL # Θα πρέπει να προσθέσετε αυτή τη γραμμή .... -Μεταγλωττίστε και επανεγκαταστήστε τον πυρήνα σας χρησιμοποιώντας τις σχετικές link:{handbook}#kernelconfig[οδηγίες στο Εγχειρίδιο του FreeBSD.] +Μεταγλωττίστε και επανεγκαταστήστε τον πυρήνα σας χρησιμοποιώντας τις σχετικές extref:{handbook}kernelconfig[οδηγίες στο Εγχειρίδιο του FreeBSD., kernelconfig] Μην ξεχάσετε να αφαιρέσετε την αντίστοιχη καταχώρηση "load" από το αρχείο [.filename]#/boot/loader.conf# αν την είχατε χρησιμοποιήσει προηγουμένως. @@ -433,7 +427,7 @@ Το 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 --- a/documentation/content/el/articles/greek-language-support/_index.adoc +++ b/documentation/content/el/articles/greek-language-support/_index.adoc @@ -3,7 +3,6 @@ authors: - author: Νικόλαος Κόκκαλης email: nickkokkalis@yahoo.co.uk -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "general"] --- @@ -16,24 +15,26 @@ :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 @@ Τα πιο συνηθισμένα γραφικό περιβάλλον εργασίας σε 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 --- a/documentation/content/el/articles/linux-users/_index.adoc +++ b/documentation/content/el/articles/linux-users/_index.adoc @@ -3,7 +3,6 @@ authors: - author: John Ferrell copyright: 2008 Η Ομάδα Τεκμηρίωσης του FreeBSD -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"] --- @@ -16,21 +15,26 @@ :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 @@ Το κείμενο αυτό τονίζει τις διαφορές μεταξύ του 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 καθώς και άλλα κελύφη που ίσως θέλετε να εγκαταστήσετε, είναι διαθέσιμα στη <> του 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 @@ Αν χρησιμοποιείτε μια "επίσημη" έκδοση του 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 @@ # 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 @@ Στο 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 @@ Υπάρχουν τρεις μέθοδοι για την αναβάθμιση ενός συστήματος 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 @@ Κάποιες από τις τιμές που δείχνει η εντολή `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 @@ [[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 --- 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 @@ :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 @@ === Τι πρέπει να κάνω πριν από μια δημοσίευση; -Διαβάζοντας αυτό το κείμενο, έχετε ήδη κάνει το πιο σημαντικό βήμα. Ωστόσο, αν είστε νέος στο 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 @@ [[bikeshed]] == Τι είναι το "Bikeshed"; -Κυριολεκτικά το `bikeshed` είναι ένα μικρό εξωτερικό καταφύγιο όπου κάποιος μπορεί να φυλάξει το δίτροχο του (υπόστεγο ποδηλάτων). Στην ορολογία του FreeBSD ωστόσο, η λέξη αυτή χρησιμοποιείται για να αναφερόμαστε σε θέματα συζήτησης που είναι τόσο απλά ώστε (σχεδόν) καθένας να μπορεί να εκφέρει μια γνώμη για αυτά - και πολύ συχνά συμβαίνει ακριβώς αυτό. Η γέννηση αυτού του όρου εξηγείται με περισσότερη λεπτομέρεια σε link:{faq}#BIKESHED-PAINTING[αυτό το κείμενο]. Θα πρέπει να κατανοείτε την έννοια αυτού του όρου πριν αρχίσετε να στέλνετε μηνύματα σε οποιαδήποτε λίστα του FreeBSD. +Κυριολεκτικά το `bikeshed` είναι ένα μικρό εξωτερικό καταφύγιο όπου κάποιος μπορεί να φυλάξει το δίτροχο του (υπόστεγο ποδηλάτων). Στην ορολογία του FreeBSD ωστόσο, η λέξη αυτή χρησιμοποιείται για να αναφερόμαστε σε θέματα συζήτησης που είναι τόσο απλά ώστε (σχεδόν) καθένας να μπορεί να εκφέρει μια γνώμη για αυτά - και πολύ συχνά συμβαίνει ακριβώς αυτό. Η γέννηση αυτού του όρου εξηγείται με περισσότερη λεπτομέρεια σε extref:{faq}[αυτό το κείμενο, BIKESHED-PAINTING]. Θα πρέπει να κατανοείτε την έννοια αυτού του όρου πριν αρχίσετε να στέλνετε μηνύματα σε οποιαδήποτε λίστα του FreeBSD. Πιο γενικά, το bikeshed είναι ένα θέμα το οποίο τείνει να δημιουργεί περισσότερες παράπλευρες συζητήσεις και λεκτικούς διαξιφισμούς, αν δεν έχετε διαβάσει σχετικά με την προϊστορία του. @@ -173,7 +171,7 @@ == Ευχαριστίες `{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 --- a/documentation/content/el/articles/nanobsd/_index.adoc +++ b/documentation/content/el/articles/nanobsd/_index.adoc @@ -4,7 +4,6 @@ - author: Daniel Gerzo - author: Κυριάκος Κεντρωτής copyright: 2006, 2009 Η Ομάδα Τεκμηρίωσης του FreeBSD -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "general"] --- @@ -17,21 +16,26 @@ :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 --- a/documentation/content/el/articles/new-users/_index.adoc +++ b/documentation/content/el/articles/new-users/_index.adoc @@ -3,7 +3,6 @@ authors: - author: Annelise Anderson email: andrsn@andrsn.stanford.edu -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"] --- @@ -16,21 +15,26 @@ :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 @@ και να επανεκκινήσετε το σύστημά σας σε 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 --- 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 @@ :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 @@ + Όταν ένα πακέτο είναι υπό την επίβλεψη κάποιου, συνήθως δεν είναι ιδιαίτερα χρήσιμες οι αναφορές που απλώς ανακοινώνουν μια καινούρια έκδοση από τον συγγραφέα του πηγαίου κώδικα του πακέτου. Συνήθως το ξέρει ήδη ο υπεύθυνος του πακέτου για το FreeBSD, ή έχει συνεργαστεί με τον συγγραφέα του πηγαίου κώδικα για τη νέα έκδοση, ή δοκιμάζει το πακέτο για να δει ότι όλα εξακολουθούν να δουλεύουν, κοκ. + -Όπως και να 'χει, είναι καλή ιδέα να ακολουθήσετε τη διαδικασία από το link:{porters-handbook}#port-upgrading[Porter's Handbook]. +Όπως και να 'χει, είναι καλή ιδέα να ακολουθήσετε τη διαδικασία από το extref:{porters-handbook}[Porter's Handbook, port-upgrading]. Ένα bug που δεν μπορεί κανείς να το αναπαράγει είναι πολύ δύσκολο να διορθωθεί. Αν το bug εμφανίστηκε μια φορά μόνο και δεν μπορείτε να το αναπαράγετε εσείς, και φαινομενικά δεν εμφανίζεται σε κανέναν άλλο, είναι πολύ μικρές οι πιθανότητες να μπορεί κάποιος προγραμματιστής να το ανακαλύψει και να καταλάβει τί είναι αυτό που προκαλεί το λάθος. Αυτό δεν σημαίνει πως δεν συμβαίνει, αλλά σημαίνει πως η πιθανότητα να οδηγήσει η αναφορά σας στην λύση του προβλήματος είναι πάρα πολύ μικρή, και μάλλον είναι καλύτερο να σταματήσετε να ασχολείστε με το θέμα. Ακόμα χειρότερα, κάποιες φορές αυτού του είδους τα προβλήματα οφείλονται σε προβλήματα του υλικού (χαλασμένους σκληρούς δίσκους ή επεξεργαστές που υπερθερμαίνονται). Πρέπει πάντοτε πριν στέλνετε μια αναφορά προβλήματος, όταν φυσικά είναι δυνατόν να γίνει κάτι τέτοιο, να προσπαθείτε να αποκλείσετε τέτοιες περιπτώσεις. @@ -83,7 +84,7 @@ Τέλος, ελέγξτε ότι η αναφορά που στέλνετε αφορά ένα πρόβλημα το οποίο υπάρχει ακόμα. Μερικές φορές είναι κάπως ενοχλητικό για έναν προγραμματιστή να παίρνει ειδοποιήσεις για ένα πρόβλημα το οποίο έχει ήδη διορθωθεί. -Αν το πρόβλημα που αντιμετωπίζετε αφορά το βασικό σύστημα και δεν έχετε ενημερωθεί ήδη για τις τελευταίες εκδόσεις του 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 @@ Είναι καλή ιδέα να κάνετε πάντα μια μικρή έρευνα πριν να στείλετε κάποια αναφορά προβλήματος. Μπορεί το πρόβλημά σας να το έχει ήδη αναφέρει και κάποιος άλλος. Μπορεί να είναι θέμα συζητήσεων σε κάποια λίστα ηλεκτρονικού ταχυδρομείου ή να ήταν πρόσφατα. Μπορεί ακόμα, να είναι ήδη διορθωμένο το πρόβλημα σε κάποια έκδοση νεώτερη από αυτή που τρέχετε. Πρέπει λοιπόν να ελέγχετε όλα τα προφανή σημεία, πριν να στείλετε μια αναφορά προβλήματος. Για το 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 @@ Αν χρησιμοποιείτε το πρόγραμμα 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 @@ Παρακάτω θα βρείτε κάποιες πηγές που είναι σχετικές με το θέμα των αναφορών προβλήματος. Δεν είναι μια πλήρης ή επαρκής λίστα, φυσικά. * 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 --- a/documentation/content/el/articles/releng/_index.adoc +++ b/documentation/content/el/articles/releng/_index.adoc @@ -4,7 +4,6 @@ - author: Murray Stokely email: murray@FreeBSD.org webpage: https://people.FreeBSD.org/~murray/ -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "intel", "general"] --- @@ -17,34 +16,26 @@ :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 @@ * `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 @@ [.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 @@ (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 --- 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 @@ Το FreeBSD χρησιμοποιείται από εταιρίες, παροχείς υπηρεσιών Internet (ISPs), ερευνητές, επαγγελματίες της Πληροφορικής, φοιτητές και οικιακούς χρήστες από όλο τον κόσμο, στη δουλειά τους, στην εκπαίδευση και για αναψυχή. -Για περισσότερες λεπτομέρειες σχετικά με το FreeBSD, παρακαλούμε διαβάστε το link:{handbook}[Εγχειρίδιο του FreeBSD]. +Για περισσότερες λεπτομέρειες σχετικά με το FreeBSD, παρακαλούμε διαβάστε το extref:{handbook}[Εγχειρίδιο του FreeBSD]. === Ποιος είναι ο σκοπός του FreeBSD Project; @@ -114,7 +100,7 @@ Αν χρειάζεται να χρησιμοποιήσετε μια εφαρμογή που είναι διαθέσιμη σε ένα μόνο λειτουργικό σύστημα, τότε απλά δεν μπορείτε να αντικαταστήσετε αυτό το λειτουργικό σύστημα. Είναι, όμως, πολύ πιθανό ότι θα βρείτε μια αντίστοιχη εφαρμογή στο 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 @@ === Τι είναι το 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 @@ === Τι είναι το 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 @@ === Ποιος είναι υπεύθυνος για το 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. Ωστόσο οι περισσότερες σημαντικές αλλαγές συζητούνται από πριν στις <>, και δεν υπάρχουν περιορισμοί σχετικά με το ποιοι λαμβάνουν μέρος σε αυτές τις συζητήσεις. @@ -195,7 +181,7 @@ * Εκδόσεις που βασίζονται σεlink:https://www.FreeBSD.org/snapshots/[Στιγμιότυπα] γίνονται καθημερινά από τους κλάδους <> και <>, και εξυπηρετούν κατά βάση όσους ασχολούνται με την ανάπτυξη και τον έλεγχο των τελευταίας γενιάς προγραμμάτων. * Η τελευταία κυκλοφορία που βασίζεται στον κλάδο 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 @@ Η εντολή man:send-pr[1] μπορεί να χρησιμοποιηθεί για την υποβολή αναφορών προβλημάτων, καθώς και αιτήσεων για αλλαγές, μέσω ηλεκτρονικού ταχυδρομείου. Εναλλακτικά, μπορείτε να χρησιμοποιήσετε την αντίστοιχη δυνατότητα http://www.freebsd.org/send-pr/[υποβολής αναφορών προβλημάτων μέσω της διεπαφής web] με τη βοήθεια ενός προγράμματος φυλλομετρητή. -Πριν υποβάλετε μια αναφορά προβλήματος, παρακαλούμε διαβάστε το link:{problem-reports}[Γράφοντας Αναφορές Προβλημάτων για το FreeBSD], ένα άρθρο για το πως να γράφετε καλές αναφορές προβλημάτων. +Πριν υποβάλετε μια αναφορά προβλήματος, παρακαλούμε διαβάστε το extref:{problem-reports}[Γράφοντας Αναφορές Προβλημάτων για το FreeBSD], ένα άρθρο για το πως να γράφετε καλές αναφορές προβλημάτων. === Τι άλλες πηγές πληροφοριών υπάρχουν; @@ -390,11 +376,11 @@ === Που μπορώ να βρω πληροφορίες για λίστες ηλεκτρονικού ταχυδρομείου του 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 @@ * doc/ * src/ssys.* -Πλήρεις οδηγίες σχετικά με τη διαδικασία καθώς και περισσότερες πληροφορίες σχετικά με γενικά προβλήματα κατά την εγκατάσταση μπορείτε να βρείτε στο link:{handbook}#install/[Κεφάλαιο του Εγχειριδίου σχετικά με την εγκατάσταση του FreeBSD]. +Πλήρεις οδηγίες σχετικά με τη διαδικασία καθώς και περισσότερες πληροφορίες σχετικά με γενικά προβλήματα κατά την εγκατάσταση μπορείτε να βρείτε στο extref:{handbook}install/[Κεφάλαιο του Εγχειριδίου σχετικά με την εγκατάσταση του FreeBSD, install]. === Τι μπορώ να κάνω αν το image της δισκέτας δεν χωράει σε μια μόνο δισκέτα; @@ -448,11 +434,11 @@ Για να παρακάμψετε το πρόβλημα: γράψτε _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 @@ Τη δεδομένη στιγμή, δεν υπάρχει τρόπος να φτιάξετε _απλώς_ μια προσαρμοσμένη δισκέτα εγκατάστασης. Θα πρέπει να δημιουργήσετε ολόκληρη νέα έκδοση, η οποία θα περιλαμβάνει και την προσαρμοσμένη δισκέτα εγκατάστασης σας. -Για να δημιουργήσετε μια προσαρμοσμένη έκδοση, ακολουθήστε τις οδηγίες στο άρθρο σχετικά με την link:{releng}[Οργάνωση Εκδόσεων]. +Για να δημιουργήσετε μια προσαρμοσμένη έκδοση, ακολουθήστε τις οδηγίες στο άρθρο σχετικά με την extref:{releng}[Οργάνωση Εκδόσεων]. === Μπορούν να συνυπάρξουν τα Windows(R) με το FreeBSD; @@ -582,7 +568,7 @@ === Μπορώ να εγκαταστήσω το FreeBSD στο φορητό μου χρησιμοποιώντας PLIP (Parallel Line IP, IP μέσω Παράλληλης Θύρας); -Ναι. Χρησιμοποιήστε τυποποιημένο καλώδιο τύπου Laplink. Αν χρειάζεται, διαβάστε το link:{handbook}#network-plip/[τμήμα PLIP του Εγχειριδίου] για λεπτομέρειες σχετικές με δικτύωση μέσω παράλληλης θύρας. +Ναι. Χρησιμοποιήστε τυποποιημένο καλώδιο τύπου Laplink. Αν χρειάζεται, διαβάστε το extref:{handbook}advanced-networking/[τμήμα PLIP του Εγχειριδίου, network-plip] για λεπτομέρειες σχετικές με δικτύωση μέσω παράλληλης θύρας. === Τι γεωμετρία να χρησιμοποιήσω για το σκληρό μου δίσκο; @@ -969,7 +955,7 @@ ==== Ποιες κάρτες πολλαπλών σειριακών θυρών υποστηρίζονται από το FreeBSD; -Υπάρχει μια λίστα για αυτές στην ενότητα link:{handbook}#install/[διάφορων συσκευών] του Εγχειριδίου. +Υπάρχει μια λίστα για αυτές στην ενότητα extref:{handbook}install/[διάφορων συσκευών, install] του Εγχειριδίου. Ακόμα φαίνεται ότι λειτουργούν και κάποιες κάρτες που είναι αντιγραφές επώνυμων μοντέλων, ειδικά όσες υποστηρίζουν ότι είναι συμβατές με τις αντίστοιχες τις AST. @@ -1009,7 +995,7 @@ ==== Ποιες άλλες συσκευές υποστηρίζονται από το FreeBSD; -Δείτε το link:{handbook}#install/[Εγχειρίδιο] για τη λίστα των υπόλοιπων συσκευών που υποστηρίζονται. +Δείτε το extref:{handbook}install/[Εγχειρίδιο, install] για τη λίστα των υπόλοιπων συσκευών που υποστηρίζονται. ==== Υποστηρίζει το FreeBSD διαχείριση ενέργειας για το φορητό μου υπολογιστή; @@ -1062,7 +1048,7 @@ device card 1 .... -Μεταγλωττίστε ξανά και εγκαταστήστε το νέο πυρήνα όπως περιγράφεται στην link:{handbook}#kernelconfig/[Ρύθμιση Πυρήνα του FreeBSD]. +Μεταγλωττίστε ξανά και εγκαταστήστε το νέο πυρήνα όπως περιγράφεται στην extref:{handbook}kernelconfig/[Ρύθμιση Πυρήνα του FreeBSD, kernelconfig]. == Αντιμετώπιση Προβλημάτων @@ -1107,7 +1093,7 @@ Το πρόβλημα αυτό είναι γνωστό. Ο ενσωματωμένος στη μητρική ελεγκτής 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 @@ === Ο εκτυπωτής μου στην παράλληλη θύρα είναι απελπιστικά αργός. Τι μπορώ να κάνω; -Αν το μόνο πρόβλημα είναι ο υπερβολικά αργός εκτυπωτής, μπορείτε να δοκιμάσετε να αλλάξετε την 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 @@ === Το σύστημα μου δεν έχει 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) (δείτε <>). Αν το μηχάνημα σας λειτουργεί σε υψηλό φορτίο, ίσως έχει νόημα να αυξήσετε την επιλογή `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 @@ === Γιατί βλέπω συνέχεια το μήνυμα 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 @@ === 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 @@ === 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 @@ === 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 @@ === 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 @@ === 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 @@ === 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 @@ === 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 @@ .... + -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 @@ 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 @@ 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 @@ 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 <> for more details. @@ -3058,35 +3044,35 @@ === 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 @@ 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 @@ === 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 @@ 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 @@ # 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 @@ /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 @@ === 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 @@ 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 @@ 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 @@ 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 @@ === 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.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 @@ === 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 @@ 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 @@ === 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 @@ === 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 @@ === 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 @@ 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 --- a/documentation/content/el/books/handbook/_index.adoc +++ b/documentation/content/el/books/handbook/_index.adoc @@ -3,9 +3,9 @@ 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 @@ :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::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 --- a/documentation/content/el/books/handbook/advanced-networking/_index.adoc +++ b/documentation/content/el/books/handbook/advanced-networking/_index.adoc @@ -13,37 +13,35 @@ :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 @@ 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 --- a/documentation/content/el/books/handbook/audit/_index.adoc +++ b/documentation/content/el/books/handbook/audit/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/basics/_index.adoc +++ b/documentation/content/el/books/handbook/basics/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/bibliography/_index.adoc +++ b/documentation/content/el/books/handbook/bibliography/_index.adoc @@ -9,26 +9,40 @@ [[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 --- a/documentation/content/el/books/handbook/book.adoc +++ b/documentation/content/el/books/handbook/book.adoc @@ -3,7 +3,6 @@ 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 @@ :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 @@ :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 --- a/documentation/content/el/books/handbook/boot/_index.adoc +++ b/documentation/content/el/books/handbook/boot/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/bsdinstall/_index.adoc +++ b/documentation/content/el/books/handbook/bsdinstall/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/config/_index.adoc +++ b/documentation/content/el/books/handbook/config/_index.adoc @@ -13,37 +13,35 @@ :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 @@ [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 @@ Χρησιμοποιώντας την μέθοδο αυτή, οι διαχειριστές μπορούν εύκολα να ελέγξουν τις υπηρεσίες του συστήματος χωρίς τα δυσνόητα "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 --- a/documentation/content/el/books/handbook/cutting-edge/_index.adoc +++ b/documentation/content/el/books/handbook/cutting-edge/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/desktop/_index.adoc +++ b/documentation/content/el/books/handbook/desktop/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/disks/_index.adoc +++ b/documentation/content/el/books/handbook/disks/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/dtrace/_index.adoc +++ b/documentation/content/el/books/handbook/dtrace/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/eresources/_index.adoc +++ b/documentation/content/el/books/handbook/eresources/_index.adoc @@ -9,27 +9,40 @@ [[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 @@ _Αν θέλετε να δοκιμάσετε την ικανότητα σας να στέλνετε μηνύματα στις λίστες του 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 --- a/documentation/content/el/books/handbook/filesystems/_index.adoc +++ b/documentation/content/el/books/handbook/filesystems/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/firewalls/_index.adoc +++ b/documentation/content/el/books/handbook/firewalls/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/geom/_index.adoc +++ b/documentation/content/el/books/handbook/geom/_index.adoc @@ -13,37 +13,35 @@ :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 @@ Για καλύτερη απόδοση, ίσως είναι επιθυμητή η τήρηση του 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 --- a/documentation/content/el/books/handbook/install/_index.adoc +++ b/documentation/content/el/books/handbook/install/_index.adoc @@ -13,37 +13,35 @@ :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 @@ [NOTE] ==== -Αν ενδιαφέρεστε να δημιουργήσετε μια εξειδικευμένη έκδοση του FreeBSD, δείτε το link:{releng}[Release Engineering Article]. +Αν ενδιαφέρεστε να δημιουργήσετε μια εξειδικευμένη έκδοση του FreeBSD, δείτε το extref:{releng}[Release Engineering Article]. ==== [[install-ftp]] @@ -2400,7 +2398,7 @@ Αν χρησιμοποιείτε 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 --- a/documentation/content/el/books/handbook/introduction/_index.adoc +++ b/documentation/content/el/books/handbook/introduction/_index.adoc @@ -13,25 +13,35 @@ :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 @@ [[nutshell]] == Καλώς ήλθατε στο FreeBSD! -Το FreeBSD είναι ένα λειτουργικό σύστημα βασισμένο στο 4.4BSD-Lite, το οποίο μπορεί να χρησιμοποιηθεί σε Η/Υ Intel (x86 και Itanium(R)), AMD64 και Sun UltraSPARC(R). Σε εξέλιξη βρίσκεται επίσης η διαδικασία μεταφοράς του FreeBSD σε άλλες αρχιτεκτονικές. Μπορείτε επίσης να διαβάσετε για <>, ή για την <>. Εάν ενδιαφέρεστε να συμβάλλετε με κάποιο τρόπο στο Project (κώδικα, hardware, χρηματοδότηση), διαβάστε το άρθρο link:{contributing}[Συνεισφέροντας στην Ανάπτυξη του FreeBSD]. +Το FreeBSD είναι ένα λειτουργικό σύστημα βασισμένο στο 4.4BSD-Lite, το οποίο μπορεί να χρησιμοποιηθεί σε Η/Υ Intel (x86 και Itanium(R)), AMD64 και Sun UltraSPARC(R). Σε εξέλιξη βρίσκεται επίσης η διαδικασία μεταφοράς του FreeBSD σε άλλες αρχιτεκτονικές. Μπορείτε επίσης να διαβάσετε για <>, ή για την <>. Εάν ενδιαφέρεστε να συμβάλλετε με κάποιο τρόπο στο Project (κώδικα, hardware, χρηματοδότηση), διαβάστε το άρθρο extref:{contributing}[Συνεισφέροντας στην Ανάπτυξη του FreeBSD]. [[os-overview]] === Τι μπορεί να κάνει το FreeBSD; @@ -89,7 +99,7 @@ * _Εκπαίδευση:_ Είστε φοιτητής πληροφορικής ή κάποιου σχετικού τομέα; Δεν υπάρχει καλύτερος τρόπος να μάθετε για λειτουργικά συστήματα, αρχιτεκτονικές Η/Υ, και συστήματα δικτύων από την πρακτική εμπειρία και την σε βάθος γνώση που μπορεί να σας παρέχει το 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 @@ [[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 @@ Εξωτερικοί συνεργάτες:: Τέλος, αλλά οπωσδήποτε όχι μικρότερης σημασίας, η μεγαλύτερη ομάδα ανάπτυξης είναι οι ίδιοι οι χρήστες που μας παρέχουν σχόλια και διορθώσεις των 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 --- a/documentation/content/el/books/handbook/jails/_index.adoc +++ b/documentation/content/el/books/handbook/jails/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/kernelconfig/_index.adoc +++ b/documentation/content/el/books/handbook/kernelconfig/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/l10n/_index.adoc +++ b/documentation/content/el/books/handbook/l10n/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/linuxemu/_index.adoc +++ b/documentation/content/el/books/handbook/linuxemu/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/mac/_index.adoc +++ b/documentation/content/el/books/handbook/mac/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/mail/_index.adoc +++ b/documentation/content/el/books/handbook/mail/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/mirrors/_index.adoc +++ b/documentation/content/el/books/handbook/mirrors/_index.adoc @@ -9,27 +9,40 @@ [[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 @@ + [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 @@ === Ετικέτες Εκδόσεων (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 --- a/documentation/content/el/books/handbook/multimedia/_index.adoc +++ b/documentation/content/el/books/handbook/multimedia/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/network-servers/_index.adoc +++ b/documentation/content/el/books/handbook/network-servers/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/parti.adoc +++ b/documentation/content/el/books/handbook/parti.adoc @@ -4,6 +4,14 @@ 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 @@ Σε αυτό το τμήμα του βιβλίου, έχουμε προσπαθήσει να μειώσουμε στο ελάχιστο τις αναφορές σε τμήματα ή κεφάλαια του Εγχειριδίου τα οποία δεν έχετε ήδη διαβάσει. Αυτό αποσκοπεί στο να γίνει πιο εύκολη η ανάγνωση του τμήματος αυτού του Εγχειριδίου από την αρχή μέχρι και το τέλος, χωρίς να απαιτείται να ψάχνετε συνεχώς τα επόμενα ή προηγούμενα τμήματα. -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 --- a/documentation/content/el/books/handbook/partii.adoc +++ b/documentation/content/el/books/handbook/partii.adoc @@ -4,6 +4,14 @@ 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 @@ Μερικά από αυτά τα κεφάλαια απαιτούν να έχετε μελετήσει πιο πριν κάποιο άλλο κεφάλαιο. Όπου είναι απαραίτητο κάτι τέτοιο, αναφέρεται στη σύνοψη του κάθε κεφαλαίου. -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 --- a/documentation/content/el/books/handbook/partiii.adoc +++ b/documentation/content/el/books/handbook/partiii.adoc @@ -4,6 +4,14 @@ 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/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 --- a/documentation/content/el/books/handbook/partiv.adoc +++ b/documentation/content/el/books/handbook/partiv.adoc @@ -4,6 +4,14 @@ 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/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 --- a/documentation/content/el/books/handbook/partv.adoc +++ b/documentation/content/el/books/handbook/partv.adoc @@ -4,7 +4,15 @@ 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 --- a/documentation/content/el/books/handbook/pgpkeys/_index.adoc +++ b/documentation/content/el/books/handbook/pgpkeys/_index.adoc @@ -9,28 +9,44 @@ [[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 --- a/documentation/content/el/books/handbook/ports/_index.adoc +++ b/documentation/content/el/books/handbook/ports/_index.adoc @@ -13,37 +13,35 @@ :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 @@ * Ένα αρχείο [.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 @@ + [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 --- 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 @@ :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 --- a/documentation/content/el/books/handbook/preface/_index.adoc +++ b/documentation/content/el/books/handbook/preface/_index.adoc @@ -11,17 +11,33 @@ :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 --- a/documentation/content/el/books/handbook/printing/_index.adoc +++ b/documentation/content/el/books/handbook/printing/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/security/_index.adoc +++ b/documentation/content/el/books/handbook/security/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/serialcomms/_index.adoc +++ b/documentation/content/el/books/handbook/serialcomms/_index.adoc @@ -13,37 +13,35 @@ :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 @@ Εξαναγκάζει τη συγκεκριμένη θύρα να γίνει η κονσόλα (εκτός αν υπάρχει άλλη κονσόλα υψηλότερης προτεραιότητας) άσχετα με την επιλογή `-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 --- a/documentation/content/el/books/handbook/users/_index.adoc +++ b/documentation/content/el/books/handbook/users/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/virtualization/_index.adoc +++ b/documentation/content/el/books/handbook/virtualization/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/el/books/handbook/x11/_index.adoc +++ b/documentation/content/el/books/handbook/x11/_index.adoc @@ -13,37 +13,35 @@ :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 --- a/documentation/content/en/articles/bsdl-gpl/_index.adoc +++ b/documentation/content/en/articles/bsdl-gpl/_index.adoc @@ -17,6 +17,27 @@ :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 --- a/documentation/content/en/articles/building-products/_index.adoc +++ b/documentation/content/en/articles/building-products/_index.adoc @@ -19,27 +19,26 @@ :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 @@ 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] <> documents the rules and responsibilities for committers. +The extref:{committers-guide}[FreeBSD Committer's guide] <> documents the rules and responsibilities for committers. FreeBSD's project model is examined in detail in <>. @@ -200,7 +199,7 @@ 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 @@ 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. + <> shows a portion of an annotated listing of the file referenced by the change log in <>. The ancestry of each line of the source is clearly visible. @@ -340,7 +339,7 @@ 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 @@ [[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 @@ [[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 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -18,26 +18,26 @@ :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 @@ * 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 {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 @@ .... 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 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 @@ [.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 @@ 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 @@ 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 @@ . 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 @@ 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 @@ [[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 @@ . 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 @@ 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 --- a/documentation/content/en/articles/contributing/_index.adoc +++ b/documentation/content/en/articles/contributing/_index.adoc @@ -19,20 +19,26 @@ :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 @@ 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 @@ 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 <>. * If you have created or adopted a port, be aware of <>. * When you are looking for a quick challenge you could <>. @@ -139,7 +145,7 @@ 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 @@ 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 @@ ==== How to adopt the port First make sure you understand your <>. -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 @@ 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 @@ . 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 @@ [[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 @@ 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 --- a/documentation/content/en/articles/contributors/_index.adoc +++ b/documentation/content/en/articles/contributors/_index.adoc @@ -11,25 +11,31 @@ :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 @@ * _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 --- a/documentation/content/en/articles/cups/_index.adoc +++ b/documentation/content/en/articles/cups/_index.adoc @@ -14,9 +14,30 @@ :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 --- a/documentation/content/en/articles/explaining-bsd/_index.adoc +++ b/documentation/content/en/articles/explaining-bsd/_index.adoc @@ -14,9 +14,30 @@ :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 --- a/documentation/content/en/articles/filtering-bridges/_index.adoc +++ b/documentation/content/en/articles/filtering-bridges/_index.adoc @@ -14,20 +14,29 @@ :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 @@ 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 --- a/documentation/content/en/articles/fonts/_index.adoc +++ b/documentation/content/en/articles/fonts/_index.adoc @@ -15,9 +15,30 @@ :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 --- a/documentation/content/en/articles/freebsd-questions/_index.adoc +++ b/documentation/content/en/articles/freebsd-questions/_index.adoc @@ -17,20 +17,26 @@ :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 @@ . 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 @@ 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 --- a/documentation/content/en/articles/freebsd-releng/_index.adoc +++ b/documentation/content/en/articles/freebsd-releng/_index.adoc @@ -36,6 +36,28 @@ :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 --- a/documentation/content/en/articles/freebsd-src-lsp/_index.adoc +++ b/documentation/content/en/articles/freebsd-src-lsp/_index.adoc @@ -13,12 +13,33 @@ = 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 --- a/documentation/content/en/articles/freebsd-update-server/_index.adoc +++ b/documentation/content/en/articles/freebsd-update-server/_index.adoc @@ -18,20 +18,26 @@ :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 @@ ==== * 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 @@ 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 @@ 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 @@ [[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 @@ 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 --- a/documentation/content/en/articles/geom-class/_index.adoc +++ b/documentation/content/en/articles/geom-class/_index.adoc @@ -17,17 +17,26 @@ :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 @@ 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 --- a/documentation/content/en/articles/gjournal-desktop/_index.adoc +++ b/documentation/content/en/articles/gjournal-desktop/_index.adoc @@ -17,35 +17,26 @@ :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 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 @@ 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 --- a/documentation/content/en/articles/hubs/_index.adoc +++ b/documentation/content/en/articles/hubs/_index.adoc @@ -23,23 +23,26 @@ :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 @@ * 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 --- a/documentation/content/en/articles/ipsec-must/_index.adoc +++ b/documentation/content/en/articles/ipsec-must/_index.adoc @@ -17,17 +17,26 @@ :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 @@ 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 --- a/documentation/content/en/articles/ldap-auth/_index.adoc +++ b/documentation/content/en/articles/ldap-auth/_index.adoc @@ -18,6 +18,27 @@ :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 --- a/documentation/content/en/articles/leap-seconds/_index.adoc +++ b/documentation/content/en/articles/leap-seconds/_index.adoc @@ -13,17 +13,26 @@ :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 @@ [[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 --- a/documentation/content/en/articles/linux-emulation/_index.adoc +++ b/documentation/content/en/articles/linux-emulation/_index.adoc @@ -17,17 +17,26 @@ :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 --- a/documentation/content/en/articles/linux-users/_index.adoc +++ b/documentation/content/en/articles/linux-users/_index.adoc @@ -17,17 +17,26 @@ :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 @@ 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 @@ 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 @@ # 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 @@ 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 @@ # 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 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 @@ 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 @@ ==== -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 @@ == 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 --- a/documentation/content/en/articles/mailing-list-faq/_index.adoc +++ b/documentation/content/en/articles/mailing-list-faq/_index.adoc @@ -16,23 +16,26 @@ :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 @@ 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 @@ == 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 @@ == 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 --- a/documentation/content/en/articles/nanobsd/_index.adoc +++ b/documentation/content/en/articles/nanobsd/_index.adoc @@ -17,20 +17,26 @@ :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 @@ 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 @@ * 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 --- a/documentation/content/en/articles/new-users/_index.adoc +++ b/documentation/content/en/articles/new-users/_index.adoc @@ -17,6 +17,27 @@ :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 --- a/documentation/content/en/articles/pam/_index.adoc +++ b/documentation/content/en/articles/pam/_index.adoc @@ -51,6 +51,30 @@ :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 @@ [.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 @@ [.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 @@ [.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 --- a/documentation/content/en/articles/pgpkeys/_index.adoc +++ b/documentation/content/en/articles/pgpkeys/_index.adoc @@ -13,26 +13,32 @@ :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 --- a/documentation/content/en/articles/port-mentor-guidelines/_index.adoc +++ b/documentation/content/en/articles/port-mentor-guidelines/_index.adoc @@ -16,17 +16,26 @@ :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 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 --- a/documentation/content/en/articles/pr-guidelines/_index.adoc +++ b/documentation/content/en/articles/pr-guidelines/_index.adoc @@ -17,20 +17,26 @@ :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 @@ 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 --- a/documentation/content/en/articles/problem-reports/_index.adoc +++ b/documentation/content/en/articles/problem-reports/_index.adoc @@ -17,20 +17,26 @@ :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 @@ * 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 @@ 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 @@ 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 @@ 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 @@ 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 --- a/documentation/content/en/articles/rc-scripting/_index.adoc +++ b/documentation/content/en/articles/rc-scripting/_index.adoc @@ -18,17 +18,26 @@ :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 @@ 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 --- a/documentation/content/en/articles/releng/_index.adoc +++ b/documentation/content/en/articles/releng/_index.adoc @@ -18,34 +18,26 @@ :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 @@ ==== 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 @@ 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 @@ 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 @@ 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 @@ == 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 @@ 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 @@ === 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 --- a/documentation/content/en/articles/remote-install/_index.adoc +++ b/documentation/content/en/articles/remote-install/_index.adoc @@ -18,20 +18,26 @@ :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 @@ 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 --- a/documentation/content/en/articles/serial-uart/_index.adoc +++ b/documentation/content/en/articles/serial-uart/_index.adoc @@ -17,21 +17,26 @@ :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 @@ 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 --- a/documentation/content/en/articles/solid-state/_index.adoc +++ b/documentation/content/en/articles/solid-state/_index.adoc @@ -18,6 +18,27 @@ :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 --- a/documentation/content/en/articles/vinum/_index.adoc +++ b/documentation/content/en/articles/vinum/_index.adoc @@ -25,20 +25,26 @@ :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 @@ [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 @@ ==== 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 @@ 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 --- a/documentation/content/en/articles/vm-design/_index.adoc +++ b/documentation/content/en/articles/vm-design/_index.adoc @@ -17,17 +17,26 @@ :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 --- a/documentation/content/en/books/arch-handbook/_index.adoc +++ b/documentation/content/en/books/arch-handbook/_index.adoc @@ -9,6 +9,7 @@ next: books/arch-handbook/parti weight: 50 add_single_page_link: true +isIndex: true --- = FreeBSD Architecture Handbook @@ -18,37 +19,31 @@ :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 @@ 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 --- a/documentation/content/en/books/arch-handbook/bibliography/_index.adoc +++ b/documentation/content/en/books/arch-handbook/bibliography/_index.adoc @@ -12,19 +12,36 @@ :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 --- a/documentation/content/en/books/arch-handbook/book.adoc +++ b/documentation/content/en/books/arch-handbook/book.adoc @@ -14,48 +14,34 @@ :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 @@ 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 --- a/documentation/content/en/books/arch-handbook/boot/_index.adoc +++ b/documentation/content/en/books/arch-handbook/boot/_index.adoc @@ -14,22 +14,35 @@ :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 --- a/documentation/content/en/books/arch-handbook/driverbasics/_index.adoc +++ b/documentation/content/en/books/arch-handbook/driverbasics/_index.adoc @@ -14,22 +14,35 @@ :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 --- a/documentation/content/en/books/arch-handbook/isa/_index.adoc +++ b/documentation/content/en/books/arch-handbook/isa/_index.adoc @@ -14,22 +14,35 @@ :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 --- a/documentation/content/en/books/arch-handbook/jail/_index.adoc +++ b/documentation/content/en/books/arch-handbook/jail/_index.adoc @@ -14,26 +14,39 @@ :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 --- a/documentation/content/en/books/arch-handbook/kobj/_index.adoc +++ b/documentation/content/en/books/arch-handbook/kobj/_index.adoc @@ -14,22 +14,35 @@ :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 --- a/documentation/content/en/books/arch-handbook/locking/_index.adoc +++ b/documentation/content/en/books/arch-handbook/locking/_index.adoc @@ -14,22 +14,35 @@ :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 --- a/documentation/content/en/books/arch-handbook/mac/_index.adoc +++ b/documentation/content/en/books/arch-handbook/mac/_index.adoc @@ -19,22 +19,35 @@ :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 --- a/documentation/content/en/books/arch-handbook/newbus/_index.adoc +++ b/documentation/content/en/books/arch-handbook/newbus/_index.adoc @@ -19,22 +19,35 @@ :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 --- 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 --- a/documentation/content/en/books/arch-handbook/partii.adoc +++ b/documentation/content/en/books/arch-handbook/partii.adoc @@ -4,7 +4,15 @@ 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 --- a/documentation/content/en/books/arch-handbook/partiii.adoc +++ b/documentation/content/en/books/arch-handbook/partiii.adoc @@ -4,7 +4,15 @@ 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 --- a/documentation/content/en/books/arch-handbook/pccard/_index.adoc +++ b/documentation/content/en/books/arch-handbook/pccard/_index.adoc @@ -14,22 +14,35 @@ :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 --- a/documentation/content/en/books/arch-handbook/pci/_index.adoc +++ b/documentation/content/en/books/arch-handbook/pci/_index.adoc @@ -14,22 +14,35 @@ :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 --- a/documentation/content/en/books/arch-handbook/scsi/_index.adoc +++ b/documentation/content/en/books/arch-handbook/scsi/_index.adoc @@ -14,22 +14,35 @@ :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 --- a/documentation/content/en/books/arch-handbook/smp/_index.adoc +++ b/documentation/content/en/books/arch-handbook/smp/_index.adoc @@ -14,22 +14,35 @@ :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 --- a/documentation/content/en/books/arch-handbook/sound/_index.adoc +++ b/documentation/content/en/books/arch-handbook/sound/_index.adoc @@ -14,22 +14,35 @@ :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 --- a/documentation/content/en/books/arch-handbook/sysinit/_index.adoc +++ b/documentation/content/en/books/arch-handbook/sysinit/_index.adoc @@ -14,22 +14,35 @@ :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 --- a/documentation/content/en/books/arch-handbook/usb/_index.adoc +++ b/documentation/content/en/books/arch-handbook/usb/_index.adoc @@ -14,22 +14,35 @@ :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 --- a/documentation/content/en/books/arch-handbook/vm/_index.adoc +++ b/documentation/content/en/books/arch-handbook/vm/_index.adoc @@ -14,22 +14,35 @@ :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 --- a/documentation/content/en/books/design-44bsd/_index.adoc +++ b/documentation/content/en/books/design-44bsd/_index.adoc @@ -10,6 +10,7 @@ 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 @@ :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 --- a/documentation/content/en/books/dev-model/_index.adoc +++ b/documentation/content/en/books/dev-model/_index.adoc @@ -7,6 +7,7 @@ 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 @@ :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 @@ Like the ports sub-project, the Documentation project can appoint documentation committers without FreeBSD Core's approval. [<>]. -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 @@ [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 --- a/documentation/content/en/books/developers-handbook/_index.adoc +++ b/documentation/content/en/books/developers-handbook/_index.adoc @@ -9,6 +9,7 @@ weight: 25 tags: ["FreeBSD Developers' Handbook"] add_single_page_link: true +isIndex: true --- = FreeBSD Developers' Handbook @@ -18,34 +19,31 @@ :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 @@ 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 --- a/documentation/content/en/books/developers-handbook/bibliography/_index.adoc +++ b/documentation/content/en/books/developers-handbook/bibliography/_index.adoc @@ -12,21 +12,37 @@ :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 --- a/documentation/content/en/books/developers-handbook/book.adoc +++ b/documentation/content/en/books/developers-handbook/book.adoc @@ -14,51 +14,34 @@ :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 @@ 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 --- a/documentation/content/en/books/developers-handbook/introduction/_index.adoc +++ b/documentation/content/en/books/developers-handbook/introduction/_index.adoc @@ -17,22 +17,35 @@ :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 --- a/documentation/content/en/books/developers-handbook/ipv6/_index.adoc +++ b/documentation/content/en/books/developers-handbook/ipv6/_index.adoc @@ -16,22 +16,35 @@ :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 --- a/documentation/content/en/books/developers-handbook/kernelbuild/_index.adoc +++ b/documentation/content/en/books/developers-handbook/kernelbuild/_index.adoc @@ -15,32 +15,45 @@ :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 --- a/documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc +++ b/documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc @@ -18,22 +18,35 @@ :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 @@ .... 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 --- a/documentation/content/en/books/developers-handbook/l10n/_index.adoc +++ b/documentation/content/en/books/developers-handbook/l10n/_index.adoc @@ -15,22 +15,35 @@ :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 --- 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 --- a/documentation/content/en/books/developers-handbook/partii.adoc +++ b/documentation/content/en/books/developers-handbook/partii.adoc @@ -4,7 +4,15 @@ 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 --- a/documentation/content/en/books/developers-handbook/partiii.adoc +++ b/documentation/content/en/books/developers-handbook/partiii.adoc @@ -4,7 +4,15 @@ 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 --- a/documentation/content/en/books/developers-handbook/partiv.adoc +++ b/documentation/content/en/books/developers-handbook/partiv.adoc @@ -4,8 +4,16 @@ 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 --- a/documentation/content/en/books/developers-handbook/partv.adoc +++ b/documentation/content/en/books/developers-handbook/partv.adoc @@ -4,7 +4,15 @@ 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 --- a/documentation/content/en/books/developers-handbook/policies/_index.adoc +++ b/documentation/content/en/books/developers-handbook/policies/_index.adoc @@ -17,22 +17,35 @@ :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 --- a/documentation/content/en/books/developers-handbook/secure/_index.adoc +++ b/documentation/content/en/books/developers-handbook/secure/_index.adoc @@ -16,22 +16,35 @@ :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 --- a/documentation/content/en/books/developers-handbook/sockets/_index.adoc +++ b/documentation/content/en/books/developers-handbook/sockets/_index.adoc @@ -16,23 +16,35 @@ :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 --- a/documentation/content/en/books/developers-handbook/testing/_index.adoc +++ b/documentation/content/en/books/developers-handbook/testing/_index.adoc @@ -15,22 +15,35 @@ :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 --- a/documentation/content/en/books/developers-handbook/tools/_index.adoc +++ b/documentation/content/en/books/developers-handbook/tools/_index.adoc @@ -17,24 +17,37 @@ :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 @@ 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 @@ [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 @@ [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 --- a/documentation/content/en/books/developers-handbook/x86/_index.adoc +++ b/documentation/content/en/books/developers-handbook/x86/_index.adoc @@ -15,22 +15,35 @@ :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 --- a/documentation/content/en/books/faq/_index.adoc +++ b/documentation/content/en/books/faq/_index.adoc @@ -7,6 +7,7 @@ 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 @@ :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 @@ :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 @@ 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 @@ 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 @@ 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 @@ [[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 @@ 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 @@ 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 <>, and there are no restrictions on who may take part in the discussion. @@ -261,7 +248,7 @@ * link:https://www.FreeBSD.org/snapshots/[Snapshot] releases are made monthly for the <> and <> 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 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 @@ [[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 @@ |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 @@ [[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 @@ 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 @@ 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 @@ === 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 @@ [[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 @@ === 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 @@ 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 @@ [[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 @@ Unneeded devices can be removed from the kernel to further reduce the size. See <> 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 @@ [[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 @@ === 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 @@ === 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 @@ [[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 @@ [[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 @@ 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 @@ ==== 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 @@ 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 @@ # 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 @@ [[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 @@ === 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 @@ # 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 @@ === 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 @@ [[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 @@ 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 @@ [[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 @@ [[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 @@ [[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 @@ [[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 @@ [[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 @@ === 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 @@ 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 --- a/documentation/content/en/books/fdp-primer/_index.adoc +++ b/documentation/content/en/books/fdp-primer/_index.adoc @@ -9,6 +9,7 @@ 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 @@ :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 @@ ''' -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 --- 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 @@ :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 @@ . 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 --- a/documentation/content/en/books/fdp-primer/book.adoc +++ b/documentation/content/en/books/fdp-primer/book.adoc @@ -14,48 +14,35 @@ :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 @@ :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 --- 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 @@ :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 --- 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 @@ :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 --- a/documentation/content/en/books/fdp-primer/examples/_index.adoc +++ b/documentation/content/en/books/fdp-primer/examples/_index.adoc @@ -14,15 +14,35 @@ :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 --- 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 @@ :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 @@ 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 --- a/documentation/content/en/books/fdp-primer/overview/_index.adoc +++ b/documentation/content/en/books/fdp-primer/overview/_index.adoc @@ -14,18 +14,35 @@ :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 --- 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 @@ :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 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 @@ .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 @@ .... 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 @@ .... 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 --- 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 @@ :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 --- a/documentation/content/en/books/fdp-primer/rosetta/_index.adoc +++ b/documentation/content/en/books/fdp-primer/rosetta/_index.adoc @@ -14,15 +14,35 @@ :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 --- 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 @@ :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 @@ == 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 --- a/documentation/content/en/books/fdp-primer/structure/_index.adoc +++ b/documentation/content/en/books/fdp-primer/structure/_index.adoc @@ -14,15 +14,35 @@ :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 @@ 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 --- a/documentation/content/en/books/fdp-primer/tools/_index.adoc +++ b/documentation/content/en/books/fdp-primer/tools/_index.adoc @@ -14,15 +14,35 @@ :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 --- a/documentation/content/en/books/fdp-primer/translations/_index.adoc +++ b/documentation/content/en/books/fdp-primer/translations/_index.adoc @@ -14,18 +14,35 @@ :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 @@ % 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 --- 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 @@ :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 --- 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 @@ :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 --- a/documentation/content/en/books/handbook/_index.adoc +++ b/documentation/content/en/books/handbook/_index.adoc @@ -9,6 +9,7 @@ next: books/handbook/preface weight: 1 add_single_page_link: true +isIndex: true --- = FreeBSD Handbook @@ -18,11 +19,32 @@ :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 @@ ''' -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 --- a/documentation/content/en/books/handbook/advanced-networking/_index.adoc +++ b/documentation/content/en/books/handbook/advanced-networking/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/audit/_index.adoc +++ b/documentation/content/en/books/handbook/audit/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/basics/_index.adoc +++ b/documentation/content/en/books/handbook/basics/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/bibliography/_index.adoc +++ b/documentation/content/en/books/handbook/bibliography/_index.adoc @@ -11,22 +11,40 @@ [[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 @@ * 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 --- a/documentation/content/en/books/handbook/book.adoc +++ b/documentation/content/en/books/handbook/book.adoc @@ -14,49 +14,35 @@ :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 @@ :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 --- a/documentation/content/en/books/handbook/boot/_index.adoc +++ b/documentation/content/en/books/handbook/boot/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/bsdinstall/_index.adoc +++ b/documentation/content/en/books/handbook/bsdinstall/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/colophon.adoc +++ b/documentation/content/en/books/handbook/colophon.adoc @@ -8,14 +8,38 @@ [[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 --- a/documentation/content/en/books/handbook/config/_index.adoc +++ b/documentation/content/en/books/handbook/config/_index.adoc @@ -15,33 +15,35 @@ :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 @@ 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 --- a/documentation/content/en/books/handbook/cutting-edge/_index.adoc +++ b/documentation/content/en/books/handbook/cutting-edge/_index.adoc @@ -15,33 +15,35 @@ :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 @@ 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 --- a/documentation/content/en/books/handbook/desktop/_index.adoc +++ b/documentation/content/en/books/handbook/desktop/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/disks/_index.adoc +++ b/documentation/content/en/books/handbook/disks/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/dtrace/_index.adoc +++ b/documentation/content/en/books/handbook/dtrace/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/eresources/_index.adoc +++ b/documentation/content/en/books/handbook/eresources/_index.adoc @@ -11,23 +11,40 @@ [[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 @@ 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 --- a/documentation/content/en/books/handbook/filesystems/_index.adoc +++ b/documentation/content/en/books/handbook/filesystems/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/firewalls/_index.adoc +++ b/documentation/content/en/books/handbook/firewalls/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/geom/_index.adoc +++ b/documentation/content/en/books/handbook/geom/_index.adoc @@ -15,33 +15,35 @@ :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 @@ 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 --- a/documentation/content/en/books/handbook/glossary.adoc +++ b/documentation/content/en/books/handbook/glossary.adoc @@ -9,16 +9,38 @@ [[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 @@ [[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 @@ [[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 --- a/documentation/content/en/books/handbook/introduction/_index.adoc +++ b/documentation/content/en/books/handbook/introduction/_index.adoc @@ -15,33 +15,35 @@ :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 @@ * _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 @@ [[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 @@ 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 --- a/documentation/content/en/books/handbook/jails/_index.adoc +++ b/documentation/content/en/books/handbook/jails/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/kernelconfig/_index.adoc +++ b/documentation/content/en/books/handbook/kernelconfig/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/l10n/_index.adoc +++ b/documentation/content/en/books/handbook/l10n/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/linuxemu/_index.adoc +++ b/documentation/content/en/books/handbook/linuxemu/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/mac/_index.adoc +++ b/documentation/content/en/books/handbook/mac/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/mail/_index.adoc +++ b/documentation/content/en/books/handbook/mail/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -11,23 +11,40 @@ [[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 @@ === 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 @@ - 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 --- a/documentation/content/en/books/handbook/multimedia/_index.adoc +++ b/documentation/content/en/books/handbook/multimedia/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/network-servers/_index.adoc +++ b/documentation/content/en/books/handbook/network-servers/_index.adoc @@ -15,33 +15,35 @@ :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 @@ # 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 --- a/documentation/content/en/books/handbook/parti.adoc +++ b/documentation/content/en/books/handbook/parti.adoc @@ -4,6 +4,14 @@ 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 @@ 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 --- a/documentation/content/en/books/handbook/partii.adoc +++ b/documentation/content/en/books/handbook/partii.adoc @@ -4,6 +4,14 @@ 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 @@ 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 --- a/documentation/content/en/books/handbook/partiii.adoc +++ b/documentation/content/en/books/handbook/partiii.adoc @@ -4,6 +4,14 @@ 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 @@ 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 --- a/documentation/content/en/books/handbook/partiv.adoc +++ b/documentation/content/en/books/handbook/partiv.adoc @@ -4,6 +4,14 @@ 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 @@ 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 --- a/documentation/content/en/books/handbook/partv.adoc +++ b/documentation/content/en/books/handbook/partv.adoc @@ -4,7 +4,15 @@ 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 --- a/documentation/content/en/books/handbook/pgpkeys/_index.adoc +++ b/documentation/content/en/books/handbook/pgpkeys/_index.adoc @@ -11,28 +11,48 @@ [[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 --- a/documentation/content/en/books/handbook/ports/_index.adoc +++ b/documentation/content/en/books/handbook/ports/_index.adoc @@ -15,33 +15,35 @@ :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 @@ * [.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 @@ 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 @@ + [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 @@ 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 <>. diff --git a/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc --- 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 @@ :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 --- 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 @@ :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 --- a/documentation/content/en/books/handbook/printing/_index.adoc +++ b/documentation/content/en/books/handbook/printing/_index.adoc @@ -15,33 +15,35 @@ :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 @@ === 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 --- a/documentation/content/en/books/handbook/security/_index.adoc +++ b/documentation/content/en/books/handbook/security/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/serialcomms/_index.adoc +++ b/documentation/content/en/books/handbook/serialcomms/_index.adoc @@ -15,33 +15,35 @@ :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 --- 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 @@ :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 --- a/documentation/content/en/books/handbook/virtualization/_index.adoc +++ b/documentation/content/en/books/handbook/virtualization/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/wine/_index.adoc +++ b/documentation/content/en/books/handbook/wine/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/handbook/x11/_index.adoc +++ b/documentation/content/en/books/handbook/x11/_index.adoc @@ -15,33 +15,35 @@ :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 @@ 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 --- a/documentation/content/en/books/handbook/zfs/_index.adoc +++ b/documentation/content/en/books/handbook/zfs/_index.adoc @@ -15,33 +15,35 @@ :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 --- a/documentation/content/en/books/porters-handbook/_index.adoc +++ b/documentation/content/en/books/porters-handbook/_index.adoc @@ -9,6 +9,7 @@ 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 @@ :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 --- a/documentation/content/en/books/porters-handbook/book.adoc +++ b/documentation/content/en/books/porters-handbook/book.adoc @@ -14,46 +14,34 @@ :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-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 --- a/documentation/content/en/books/porters-handbook/flavors/_index.adoc +++ b/documentation/content/en/books/porters-handbook/flavors/_index.adoc @@ -14,22 +14,35 @@ :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 --- 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 @@ :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 --- a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc +++ b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc @@ -14,23 +14,36 @@ :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 @@ 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 @@ ** (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 @@ 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 @@ 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 --- 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 @@ :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 --- a/documentation/content/en/books/porters-handbook/order/_index.adoc +++ b/documentation/content/en/books/porters-handbook/order/_index.adoc @@ -14,22 +14,35 @@ :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 --- 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 @@ :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 --- a/documentation/content/en/books/porters-handbook/plist/_index.adoc +++ b/documentation/content/en/books/porters-handbook/plist/_index.adoc @@ -14,22 +14,35 @@ :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 --- 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 @@ :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 --- 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 @@ :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 --- 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 @@ :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 --- 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 @@ :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 @@ 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 --- a/documentation/content/en/books/porters-handbook/security/_index.adoc +++ b/documentation/content/en/books/porters-handbook/security/_index.adoc @@ -14,22 +14,35 @@ :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 --- 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 @@ :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 --- a/documentation/content/en/books/porters-handbook/special/_index.adoc +++ b/documentation/content/en/books/porters-handbook/special/_index.adoc @@ -14,22 +14,35 @@ :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 @@ [.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 --- a/documentation/content/en/books/porters-handbook/testing/_index.adoc +++ b/documentation/content/en/books/porters-handbook/testing/_index.adoc @@ -14,22 +14,35 @@ :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 @@ 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 --- a/documentation/content/en/books/porters-handbook/upgrading/_index.adoc +++ b/documentation/content/en/books/porters-handbook/upgrading/_index.adoc @@ -14,28 +14,41 @@ :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 @@ 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 @@ 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 @@ <.> 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 @@ `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 --- a/documentation/content/en/books/porters-handbook/uses/_index.adoc +++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc @@ -14,23 +14,35 @@ :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 --- a/documentation/content/en/books/porters-handbook/versions/_index.adoc +++ b/documentation/content/en/books/porters-handbook/versions/_index.adoc @@ -13,22 +13,35 @@ :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 --- a/documentation/content/es/articles/bsdl-gpl/_index.adoc +++ b/documentation/content/es/articles/bsdl-gpl/_index.adoc @@ -18,6 +18,27 @@ :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 --- a/documentation/content/es/articles/building-products/_index.adoc +++ b/documentation/content/es/articles/building-products/_index.adoc @@ -21,27 +21,26 @@ :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 @@ 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] <> 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] <> documenta las reglas y responsabilidades de los committers. El modelo de proyecto de FreeBSD se examina con detalle en <>. @@ -180,7 +179,7 @@ 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 @@ 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. + <> muestra una porción de un listado anotado del fichero referenciado por el registro de cambio en >. 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 @@ 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 @@ [[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 @@ [[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 --- 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 @@ :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 @@ 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 @@ 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 <>. -* Si has creado o adoptado un port, considera <>. -* Cuando busques un desafío rápido piensa en <>. +* 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 <>. +* Si ha creado o adoptado un port tenga en cuenta lo <>. +* Si busca un desafío rápido, puede <>. -=== 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 @@ [[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 @@ [[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 <>. 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 <>. 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 @@ [[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 <> 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 <>. ** 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 <> 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 <> 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 @@ [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 --- a/documentation/content/es/articles/contributors/_index.adoc +++ b/documentation/content/es/articles/contributors/_index.adoc @@ -11,25 +11,31 @@ :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 @@ * _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 @@ (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 @@ _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 @@ _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 @@ _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 @@ (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 --- a/documentation/content/es/articles/contributors/_index.po +++ b/documentation/content/es/articles/contributors/_index.po @@ -447,7 +447,7 @@ 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 @@ 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 --- /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 --- /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:chri