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 --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*} == "" @@ -124,6 +125,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 @@ -136,13 +146,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 @@ -157,252 +170,26 @@ # pdf: pdf-articles pdf-books -pdf-books-target: +pdf-books: 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: .for _lang in ${ARTICLE_LANGS} -TTMP += ${.CURDIR}/content/${_lang}/articles/*/ -.endfor -ARTICLESDIR != echo ${TTMP} - -pdf-books: 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: 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: -.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/ -.endif -.endfor - -html-clean: html-resources-clean html-articles-clean html-books-clean - -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-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-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 -.for _lang in ${ARTICLE_LANGS} - rm -fr ${.CURDIR}/public/${_lang}/articles - rm -fr ${.CURDIR}/public/${_lang}/images/articles - -rmdir ${.CURDIR}/public/${_lang} -.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 +pdf-articles-clean: .for _lang in ${ARTICLE_LANGS} rm -fr ${.CURDIR}/public/${_lang}/articles .if !exists(${.CURDIR}/public/${_lang}/books) @@ -411,3 +198,9 @@ .endfor -rmdir ${.CURDIR}/public +# +# HTML targets +# +html: generate-books-toc-offline build-offline + +html-clean: hugo-clean 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/bd/articles/_index.adoc b/documentation/content/bd/articles/_index.adoc deleted file mode 100644 --- a/documentation/content/bd/articles/_index.adoc +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Articles ---- - -= Articles - -{{< list-articles-directories >}} diff --git a/documentation/content/bd/articles/explaining-bsd/_index.adoc b/documentation/content/bd/articles/explaining-bsd/_index.adoc deleted file mode 100644 --- a/documentation/content/bd/articles/explaining-bsd/_index.adoc +++ /dev/null @@ -1,160 +0,0 @@ ---- -title: BSD কি, কেন, কার জন্য -authors: - - author: গ্রেগ লেহেই - email: grog@FreeBSD.org -releaseinfo: "$FreeBSD$" -trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sparc", "sun", "unix", "general"] ---- - -= BSD কি, কেন, কার জন্য -:doctype: article -:toc: macro -:toclevels: 1 -:icons: font -:sectnums: -:sectnumlevels: 6 -:source-highlighter: rouge -:experimental: - -[.abstract-title] -Abstract - -ওপেনসোর্স সফটওয়ারের জগতে "অপারেটিং সিস্টেম" বলতে যেন `লিন্যাক্স` এর নামই ভেসে ওঠে। কিন্তু লিন্যাক্স'ই একমাত্র ওপেনসোর্স `ইউনিক্স` নয়। http://www.leb.net/hzo/ioscount/data/r.9904.txt[ইন্টারনেট অপারেটিং সিস্টেম কাউন্টারের] ১৯৯৯ এর রিপোর্ট অনুযায়ী নেটওয়ার্কের সাথে যুক্ত বিশ্বের ৩১.৩% কম্পিউটারে ব্যবহার করা হয় লিন্যাক্স আর ১৪.৬% কম্পিউটারে ব্যবহৃত হয় `BSD` ইউনিক্স। বিশ্বের সর্ববৃহত্‍ ইন্টারনেট ভিত্তিক প্রতিষ্ঠাগুলোর কয়েকটি, যেমন, http://www.yahoo.com[Yahoo!] BSD ইউনিক্স ব্যবহার করে থাকে। বিশ্বের ব্যস্ততম FTP সার্ভার link:ftp://ftp.cdrom.com[ftp.cdrom.com] BSD ব্যবহার করে প্রতিদিন প্রায় ১.৪ টেরাবাইট ডাটা আদান প্রদান করে। সুতরাং BSD'র বাজার যে একেবারে ছোট, তাও নয়। এতকিছুর পরও BSD যেন লোকচক্ষুর আড়ালেই থেকে গিয়েছে। - -BSD'র পরিচিতির অভাবের পেছনে কি কোন রহস্য আছে ? এই প্রশ্নটি এবং এরকম আরো কিছু চিন্তাভাবনাই এই লেখার বিষয়বস্তু। - -এই প্রবন্ধে BSD ও লিন্যাক্স এর পার্থক্যগুলো এভাবে উল্লেখ করা হবে। - -''' - -toc::[] - -== BSD কি ? - -BSD অর্থ হল _Berkley Software Distribution_ । সাধারণভাবে BSD বলতে ক্যালিফোর্নিয়া বিশ্ববিদ্যালয়, বার্কলী কতৃক প্রকাশিত সোর্সকোডকে বোঝানো হত। AT&T'র গবেষণালব্ধ ইউনিক্স অপারেটিং সিস্টেমের ওপর ভিত্তি করে এই সোর্সকোড লেখা হয়েছিল। 4.4BSD-Lite বলে পরিচিত এই সোর্সকোড ব্যবহার করে বেশ কয়েকটি ওপেনসোর্স অপারেটিং সিস্টেম প্রজেক্ট গড়ে উঠেছে। এই প্রজেক্টগুলো আরো কিছু ওপেনসোর্স প্রজেক্টের সফটওয়ার ব্যবহার করে, যার মধ্যে উল্লেখযোগ্য হল গনুহ (GNU) প্রজেক্ট। স্বয়ংসম্পূর্ণ একটি BSD অপারেটিং সিস্টেমের বিভিন্ন অংশগুলো হল ঃ - -BSD কার্নেল:: -এটি বিভিন্ন প্রসেসের মধ্যে সময় ও মেমরী বন্টন করে এবং একাধিক প্রসেসর থাকলে তাদেরকেও নিয়ন্ত্রণ করে। এছাড়া ডিভাইস ড্রাইভারও কার্নেলের অংশ। -+ -লক্ষণীয় ব্যাপার হল, লিন্যাক্স কার্নেল বলতে একটি কার্নেলকেই বোঝায়, কিন্তু BSD কার্নেলের সংখ্যা একাধিক এবং এদের প্রত্যেকের মাঝেই শক্তিসামর্থে বেশ পার্থক্য পরিলক্ষিত হয়। - -`C` লাইব্রেরী :: -এটি হল অপারেটিং সিস্টেমের API ফাংশনের মূল সংগ্রহ। -+ -BSD `C` লাইব্রেরীর উত্‍পত্তি বার্কলীর সোর্সকোড হতে, গনুহ (GNU) প্রজেক্টের কোড থেকে নয়। - -বিভিন্ন ইউটিলিটি সফটওয়ার:: -উদাহরণস্বরূপ শেল, ফাইল ইউটিলিটি, কম্পাইলার, লিঙ্কার ইত্যাদি। বেশ কিছু ইউটিলিটি সফটওয়ার নেয়া হয়েছে GNU প্রজেক্ট থেকে, তবে সব নয়। - -X WINDOW:: -এটি একটি গ্রাফিক্যাল কম্পিউটার ব্যবহার পদ্ধতি (GUI)। -+ -অধিকাংশ BSD'তে X WINDOW ব্যবহৃত হয়। তবে এটি http://www.XFree86.org/[XFree86] নামক সম্পূর্ণ ভিন্ন একটি প্রজেক্টের অবদান। - -== আসল ইউনিক্স!!! সেটা আবার কি ? - -BSD অপারেটিং সিস্টেমগুলো কোন ইউনিক্স ক্লোন নয়। এগুলো উদ্ভূত হয়েছে AT&T'র গবেষণালব্ধ ইউনিক্স অপারেটিং সিস্টেম হতে যা কিনা আজকের দিনের `UNIX System V`'র পূর্বসূরী। ঘটনাটা একটু আশ্চর্যজনক, বিশেষ করে AT&T যখন তাদের সোর্সকোডকে কখনই ওপেনসোর্স হিসেবে উন্মুক্ত করে দেয়নি। - -এটি সত্যি যে AT&T ইউনিক্স কোন ওপেনসোর্স সফটওয়ার নয়। কপিরাইটের কথা চিন্তা করলে BSD'কেও ইউনিক্স বলা যায় না। কিন্তু প্রকৃতপক্ষে AT&T তাদের ইউনিক্সে ক্যালিফোর্নিয়া বিশ্ববিদ্যালয়, বার্কলীস্থিত _কম্পিউটার সায়েন্স রিসার্চ গ্রুপের_ সোর্সকোড ব্যবহার করেছিল। ১৯৭৬ থেকে CSRG তাদের সফটওয়ারের টেপ ছাড়তে থাকে এবং সফটওয়ারগুলোর নাম দেয়া হয়__Berkley Software Distribution বা BSD__। - -প্রথম দিককার BSD'তে শুধু ইউজার সফটওয়ারই থাকতো। কিন্তু হঠাত্‍ করেই এ অবস্থার পরিবর্তন হয় যখন Defence Advanced Research Agency (DARPA) র সাথে CSRG'র একটি চুক্তি সম্পাদিত হয়। এই চুক্তির ফলে CSRG'র উপর DARPA'র নেটওয়ার্ক প্রটোকল ARPANET আপগ্রেড করার দায়িত্ব বর্তায়। নতুন এই প্রটোকলটিকে তখন বলা হত ইন্টারনেট প্রটোকল। পরবর্তীতে এই প্রটোকলের নাম হয়ে যায় TCP/IP। TCP/IP ছিল ইন্টারনেট প্রটোকলের সবচাইতে গুরুত্বপূর্ণ অংশ। একটি স্বয়ংসম্পূর্ণ অপারেটিং সিস্টেম হিসেবে যে BSD'টি ব্যাপকভাবে ব্যবহৃত হয়েছিল, তা ছিল 4.2 BSD'র অংশ; এটা ১৯৮২ সালের কথা। - -আশির দশকে বেশ কিছু নতুন ওয়ার্কস্টেশন কোম্পানী গড়ে ওঠে। এদের অনেকেই নিজস্ব অপারেটিং সিস্টেম তৈরী না করে ইউনিক্সকেই তাদের কম্পিউটারের জন্য লাইসেন্স করিয়ে নেয়। বিশেষ করে সান মাইক্রোসিস্টেম ইউনিক্সকে লাইসেন্স করিয়ে 4.2 BSD'র ওপর ভিত্তি করে SunOS তৈরী করে। যখন AT&T নিজেই ইউনিক্সকে বাণিজ্যিকভাবে বিক্রি করার অনুমতি পায়, তখন তারা প্রথমে System III এবং তার কিছুকাল পরেই System V বাজারজাত করতে থাকে। System V'র কোন নেটওয়ার্কিং কোড ছিল না, তাই প্রতিটি সংস্করণেই BSD'র সফটওয়ার অন্তর্ভুক্ত থাকতো। এর মধ্যে উল্লেখযোগ্য ছিল TCP/IP সফটওয়ার, csh শেল এবং VI এডিটর। BSD থেকে নেয়া এই সফটওয়ারগুলোকে একত্রে বলা হত _Berkeley Extensions_। - -BSD'র সফটওয়ার টেপে AT&T'র সোর্সকোড থাকতো বলে ইউনিক্স সোর্স লাইসেন্সের প্রয়োজন হত। ১৯৯০ সালের দিকে দেখা গেল যে CSRG'র অর্থসংস্থান প্রায় শেষ এবং সম্পূর্ণ BSD প্রজেক্টটিই বন্ধ হওয়ার উপক্রম। এ অবস্থায় গ্রুপের কিছু সদস্য AT&T'র মালিকানাধীন অংশটুকু বাদ দিয়ে সোর্সকোডের অবশিষ্ট অংশ প্রকাশের উদ্যোগ নেয়। উল্লেখ্য যে, BSD'র কোডের নিজস্ব অংশটুকু ছিল ওপেনসোর্স। অবশেষে নেটওয়ার্কিং টেপ ২, যা কিনা _NET/2_ নামে পরিচিত, প্রকাশের মাধ্যমে সোর্সকোড প্রকাশের এই উদ্যোগ বাস্তবায়িত হয়। Net/2 কোন স্বয়ংসম্পূর্ণ অপারেটিং সিস্টেম ছিল না, Net/2'র কার্নেল থেকে প্রায় ২০% কোড বাদ দেয়া হয়েছিল। CSRG'র একজন সদস্য উইলিয়াম এফ জোলিটস্‌ এই অবশিষ্ট কোডটুকু নতুন করে লেখেন এবং ১৯৯২ এর প্রথম দিকে 386BSD নামে প্রকাশ করেন। একই সময় CSRG'র প্রাক্তন সদ্যস্যদের একটি গ্রুপ http://www.bsdi.com/[Berkley Software Design Inc] নামে একটি কোম্পানি গঠন করেন এবং তারপরই Net/2'র সোর্সকোডের ওপর ভিত্তি করে http://www.bsdi.com/[BSD/386] নামের একটি অপারেটিং সিস্টেমের বেটা সংস্করণ প্রকাশ করেন। এই অপারেটিং সিস্টেমটির নাম পরির্বতন করে পরে BSD/OS করা হয়। - -অপারেটিং সিস্টেম প্রজেক্ট হিসেবে 386BSD কখনই ভালভাবে দাঁড়াতে পারেনি। ১৯৯৩ সালে এই প্রজেক্ট থেকে দুটি দল বের হয়ে যায় এবং `NetBSD` ও `FreeBSD` নামে আরো দুটি অপারেটিং সিস্টেম প্রজেক্টের সূচনা করে। মূলতঃ 386BSD'র উন্নতির ব্যাপারে অনেকে অপেক্ষা করতে রাজি না হওয়াতেই এই দুটি প্রজেক্টের আবির্ভাব ঘটে। NetBSD প্রজেক্টের কাযক্রম শুরু হয় বছরের প্রথমদিকে আর বছরের শেষে প্রকাশিত হয় FreeBSD'র প্রথম সংস্করণ। মাঝের সময়ে এই প্রজেক্ট দুটির সোর্সকোডে এত বেশি পার্থক্য দেখা দেয় যে এদেরকে আর কখনই একীভূত করা যায়নি। তাছাড়া প্রজেক্ট দুটোর লক্ষ্যও ছিল ভিন্ন, পরে যা আলোচনা করা হয়েছে। ১৯৯৬ সালে NetBSD প্রজেক্ট থেকে আরেকটি দল বের হয়ে যায় এবং এভাবেই সূচিত হয় `OpenBSD` প্রজেক্ট। - -== BSD কেন সুপরিচিত নয় ? - -বেশ কিছু কারণে BSD অপেক্ষাকৃত অখ্যাতঃ - -. BSD ডেভেলপাররা অধিকাংশ ক্ষেত্রেই BSD'র গুণগান প্রচারের চাইতে BSD'র সোর্সকোডের উন্নতির দিকেই বেশী মনোযোগী। -. লিন্যাক্সের খ্যাতির জন্য প্রকৃতপক্ষে লিন্যাক্সভিত্তিক প্রজেক্টগুলো দায়ী নয়, দায়ী হল পত্রপত্রিকা এবং লিন্যাক্সভিত্তিক সেবা প্রদানকারী বিভিন্ন প্রতিষ্ঠান। কিছুদিন পূর্ব পর্যন্তও ওপেনসোর্স BSD গুলোর এধরনের কোন সমর্থক ছিল না। -. BSD ডেভেলপাররা সাধারণত লিন্যাক্স ডেভেলপারদের থেকে বেশী অভিজ্ঞ। তাই BSD'কে আরো বেশী সহজ ব্যবহারযোগ্য করার ব্যাপারে তাদের আগ্রহ কম। ফলে নবীন ব্যবহারকারিদের কাছে লিন্যাক্স ব্যবহার করাই বেশী সুবিধাজনক মনে হয়। -. ১৯৯২ সালে BSD/386 এর বিক্রেতা _BSDi_ এর বিরুদ্ধে AT&T একটি মামলা দায়ের করে। মামলায় AT&T অভিযোগ করে যে, তাদের কপিরাইটকৃত সোর্সকোড BSD/386 এ ব্যবহার করা হচ্ছে। অবশেষে ১৯৯৪ সালে দুপক্ষই একটি সমঝোতায় পৌছায় এবং AT&T মামলা প্রত্যাহার করে নেয়। কিন্তু তারপরও এই মামলার আতঙ্ক অনেককেই তাড়া করে ফিরতে থাকে এবং BSD থেকে দূরে থাকাটাই তারা নিরাপদ মনে করতে থাকে। কিছুদিন পূর্বে মাত্র মার্চ ২০০০ এ ওয়েবে প্রকাশিত এক প্রবন্ধে লেখা হয় যে এই মামলাটির নিষ্পত্তি হয়েছে " অতি সম্প্রতি "। -+ -মামলার ফলে অবশ্য যে ব্যাপারটি পরিষ্কার হয়ে যায় তা হল অপারেটিং সিস্টেমের নাম। আশির দশকে BSD পরিচিত ছিল "BSD ইউনিক্স" হিসেবে। AT&T'র মালিকানাধীন কোডের শেষ চিহ্নটুকুও বাদ দেয়াতে ইউনিক্স নামের প্রতি BSD'র আর কোন দাবি থাকলো না। একারণেই বইয়ের তালিকায় দেখতে পাবেন "the 4.3BSD UNIX operating system" এবং "the 4.4BSD operating system" এর মত নাম। -. এরকম একটা ধারনা অনেকের মধ্যে আছে যে, BSD প্রজেক্টগুলো খন্ডবিখন্ড হয়ে নিজেদের মধ্যে বিবাদে লিপ্ত। http://interactive.wsj.com/bin/login?Tag=/&URI=/archive/retrieve.cgi%253Fid%253DSB952470579348918651.djm&[ওয়াল স্ট্রিট জার্নাল] একবার BSD প্রজেক্টগুলোর "বলকান পরিণতির" কথা লিখেছিল। মামলার মতই, এসব ধারনাও মূলতঃ বহু পুরনো ঘটনার ওপর ভিত্তি করে গড়ে উঠেছে। - -== BSD বনাম লিন্যাক্স - -BSD'র সাথে লিন্যাক্সের কোন একটি ডিস্ট্রিবিউশন, যেমন Debian লিন্যাক্সের পার্থক্যটা কোথায় ? সাধারণ ব্যবহারকারীদের জন্য পার্থক্য আসলেই খুব কম; কারণ দুটোই ইউনিক্স জাতীয় অপারেটিং সিস্টেম। তাছাড়া উভয়েই সম্পূর্ণ অলাভজনক প্রজেক্টের অবদান। ( অন্য অনেক লিন্যাক্স ডিস্ট্রিবিউশনের ক্ষেত্রে অবশ্য একথা প্রযোজ্য নয় )। পরবর্তি পরিচ্ছেদে আমরা BSD'র বিভিন্ন বৈশিষ্ট্য বর্ণনা করার পাশাপাশি লিন্যাক্সের সাথে তা তুলনা করবো। এই বর্ণনাটি সবচেয়ে ভালভাবে প্রযোজ্য FreeBSD'র ক্ষেত্রে; তবে NetBSD বা OpenBSD'র সাথেও এর পার্থক্য খুব একটা বেশি নয়। - -=== BSD কি কারো মালিকানাধীন ? - -প্রশ্নই আসে না; BSD কোন একক ব্যক্তি বা প্রতিষ্ঠানের সম্পত্তি নয়। BSD উন্নয়ন ও প্রকাশনার দায়িত্বে নিয়োজিত রয়েছে পৃথিবীব্যাপী ছড়িয়ে থাকা একদল অত্যন্ত উচ্চপ্রযুক্তি জ্ঞানসম্পন্ন ও আত্মনিবেদিত মানুষের একটি দল। তবে BSD'র কিছু অংশ অন্যান্য ওপেনসোর্স প্রজেক্টের তৈরী করা। - -=== BSD উন্নয়ন প্রক্রিয়া - -BSD কার্নেলগুলোর উন্নয়ন প্রক্রিয়া ওপেনসোর্স সফটওয়ার তৈরীর পদ্ধতিতে পরিচালিত হয়। প্রত্যেক প্রজেক্ট তাদের সমস্ত সোর্সকোডকে CVS এর মাধ্যমে সবার জন্য উন্মুক্ত করে দেয়। BSD বিষয়ক লেখালেখি এবং অন্যান্য প্রাসঙ্গিক ফাইলও BSD সোর্সের অংশ। CVS ব্যবহারকারীগণ পছন্দমত সোর্সের যেকোন সংস্করণ ডাউনলোড করতে পারেন। - -পৃথিবীব্যাপী অসংখ্য ব্যক্তি BSD'র উন্নয়নের পেছনে কাজ করেন। এদেরকে মোটামুটি তিনটি ভাগে বিভক্ত করা যায়ঃ - -কন্ট্রিবিউটর:: -এরা সোর্সকোড এবং বিভিন্ন বিবরণ লেখার কাজে নিয়োজিত। তবে BSD সোর্সে পরিবর্তনের অধিকার কন্ট্রিবিউটরদের নেই। কোন কমিটার পরীক্ষা করে সম্মতি দেবার পরই কেবল কন্ট্রিবিউটরদের করা কাজগুলো BSD সোর্সের অন্তর্ভুক্ত হয়। - -কমিটার:: -এরা BSD সোর্সে সরাসরি পরিবর্তন করতে পারেন। নিজ নিজ ক্ষেত্রে যথেষ্ট যোগ্যতাসম্পন্ন হলেই কেবল কমিটার হওয়া যায়। -+ -কোন কমিটার সবাইকে জানিয়ে নাকি নিজ দায়িত্বে BSD সোর্সে পরিবর্তন করবেন তা তার বিচার বিবেচনার ওপর নির্ভরশীল। ভুল হওয়ার কোন সম্ভাবনাই না থাকলে অভিজ্ঞ কমিটারগণ সকলের সম্মতি নেয়ার প্রয়োজন বোধ করেন না। উদাহরণস্বরূপ ডকুমেন্টেশন প্রজেক্টের একজন কমিটার যেকোন সময় বানান বা ব্যাকরণগত ভুল সংশোধন করতে পারেন, এজন্য অন্যান্য কমিটারদের সম্মতি নেয়াটা অর্থহীন। অন্যদিকে একজন ডেভেলপার যখন জটিল ও দীর্ঘমেয়াদী প্রভাব ফেলতে সক্ষম কোন পরিবর্তন করেন বা নতুন কিছু যোগ করেন তখন তা পরীক্ষার জন্য সকলের সামনে পেশ করাটাই প্রচলিত নিয়ম। খুবই বিরল কিছু ক্ষেত্রে অবশ্য মূখ্য রূপরেখা প্রণয়নকারীর (Principal Architect) দায়িত্বপ্রাপ্ত কেন্দ্রীয় কমিটির একজন সদস্য কোন কমিটারের করা পরিবর্তনকে বাদ দিতে পারেন; এই ব্যাপারটিকে বলা হয় "Backing Out"। BSD সোর্সে কোন পরিবর্তন করা হলে তা প্রত্যেক কমিটারকেই ইমেইল এর মাধ্যমে জানানো হয়। ফলে গোপনে কোন পরিবর্তন করা কখনই সম্ভব নয়। - -Core Team বা কেন্দ্রীয় কমিটি:: -FreeBSD এবং NetBSD উভয় প্রজেক্টেরই নিজস্ব কেন্দ্রীয় কমিটি রয়েছে, যাদের দায়িত্ব হল প্রজেক্টের সামগ্রিক দিক দেখাশোনা করা। কেন্দ্রীয় কমিটির ভূমিকা কোন সুনির্দিষ্ট, সুঘোষিত গন্ডীতে আবদ্ধ নয়। সাধারণত ডেভেলপাররাই কেন্দ্রীয় কমিটির সদস্য নির্বাচিত হন; তবে কমিটির প্রত্যেক সদস্যকেই যে ডেভেলপার হতে হবে এমন কোন কথা নেই। বিভিন্ন BSD প্রজেক্টের কেন্দ্রীয় কমিটির ভূমিকায় পার্থক্য থাকলেও প্রতিটি প্রজেক্টের দিকনির্দেশনায় সাধারণ একজন কমিটার অপেক্ষা কেন্দ্রীয় কমিটির একজন সদস্যের কথার মূল্য অনেক বেশি। - -BSD প্রজেক্টগুলোর এধরনের পরিচালনা পদ্ধতির সাথে লিন্যাক্সের বেশ কিছু পার্থক্য রয়েছে ঃ - -. সম্পূর্ন প্রক্রিয়াটি কোন একক ব্যক্তির নিয়ন্ত্রাণাধীন নয়। কার্যত অবশ্য এটা খুব বড় কোন পার্থক্য নয়, কারণ BSD প্রজেক্টের মূখ্য রূপরেখা প্রণয়নকারী (Chief Architect) কমিটারদের করা যেকোন পরিবর্তনকে বাদ দিতে পারেন। তাছাড়া লিন্যাক্সের ক্ষেত্রেও বেশ কিছু ব্যক্তির সোর্সকোড পরিবর্তনের অধিকার আছে। -. BSD সোর্সকে কেন্দ্রীয়ভাবে সংরক্ষণ করা হয়। ফলে একটিমাত্র সাইট থেকেই সমগ্র অপারেটিং সিস্টেমের যেকোন সংস্করণ পাওয়া যায়। -. শুধুমাত্র কার্নেল নয় বরং সম্পূর্ন অপারেটিং সিস্টেমের পেছনেই BSD প্রজেক্টগুলো কাজ করে। তবে এটি খুব বড় কোন সুবিধা নয়, কারণ অ্যাপলিকেশন সফটওয়ার ছাড়া লিন্যাক্স বা BSD কোনটিই আমাদের কোন কাজে আসবে না। আর BSD'তে ব্যবহৃত অ্যাপলিকেশন সফটওয়ারগুলো প্রায়শঃই লিন্যাক্সেও ব্যবহৃত হয়। -. নিয়মতান্ত্রিকভাবে একটিমাত্র CVS ব্যবহার করায় BSD'র উন্নয়ন প্রক্রিয়া বেশ সরল। শুধুমাত্র প্রকাশের তারিখ বা সংস্করণ সূচক সংখ্যা ব্যবহার করেই যেকোন BSD সোর্সকে খুজে বের করা যায়। CVS ব্যবহার করে প্রতিদিন প্রায় ১০০ বার BSD সোর্সকে পরিবর্তন করা হয়। এসব পরিবর্তনের অধিকাংশই অবশ্য খুবই ক্ষুদ্র। - -প্রতিটি BSD প্রজেক্টই তাদের অপারেটিং সিস্টেমের তিন প্রকারের সংস্করণ প্রকাশ করে। লিন্যাক্সের মতই প্রতিটি সংস্করণকে একটি সংখ্যা দিয়ে নির্দেশ করা হয়, যেমন ১.৪.১ বা ৩.৫। তাছাড়া সংস্করণসূচক সংখ্যার শেষে আরো একটি শব্দ যোগ করা হয়ঃ - -. বর্তমানে যে সংস্করণটির উন্নয়নের জন্য কাজ চলছে, তাকে বলা হয় __CURRENT__। FreeBSD প্রজেক্টে CURRENT এর পূর্বে একটি সংখ্যা থাকে, যেমন FreeBSD 0.5-CURRENT। NetBSD প্রজেক্টের নামকরণ পদ্ধতি কিছুটা ভিন্ন; অভ্যন্তরীন পরিবর্তন বোঝানোর জন্য এই প্রজেক্টে সংস্করণ সূচক সংখ্যার শেষে একটি অক্ষর যোগ করা হয়, যেমন - NetBSD 1.4.3__G__। OpenBSD প্রজেক্টে কোন সংস্করণ সূচক সংখ্যা ব্যবহৃত হয়না, যেমন - OpenBSD-current। BSD'তে যা কিছু পরিবর্তন করা হয় বা যোগ করা হয় তার সবই CURRENT সংস্করণেই প্রথম অন্তর্ভূক্ত হয়। -. প্রতি বছর নির্দষ্ট সময় অন্তর দু থেকে চারবার প্রতিটি BSD প্রজেক্ট তাদের অপারেটিং সিস্টেমের _RELEASE_ সংস্করণ প্রকাশ করে। এই সংস্করণ সিডিতে পাওয়া যায় এবং FTP সাইট থেকেও ডাউনলোড করা যায়। RELEASE এর উদাহরণ হল OpenBSD 2.6-RELEASE এবং NetBSD 1.4-RELEASE। RELEASE সংস্করণ প্রকাশ করা হয় সাধারণত সাধারণ ব্যবহারকারীদের জন্য এবং এটিই সর্বাপেক্ষা বেশি ব্যবহৃত হয়। NetBSD প্রজেক্টও তাদের অপারেটিং সিস্টেমের প্যাচ (Patch) সংস্করণ প্রকাশ করে। এই সংস্করণের নামের শেষে তৃতীয় একটি সংখ্যা ব্যবহৃত হয়, যেমন - NetBSD 1.4.__2__ -. RELEASE সংস্করণে ভুল (BUG) পাওয়া গেলে তা সংশোধন করে CVS এ অবস্থিত মূল BSD সোর্সের অন্তর্ভুক্ত করা হয়। ফলে যে নতুন BSD সংস্করণ পাওয়া যায় তাকে FreeBSD র ক্ষেত্রে বলা হয় __STABLE__। তবে NetBSD ও OpenBSD'র ক্ষেত্রে RELEASE নামই চালু থাকে। একটি নির্দিষ্ট সময় ধরে CURRENT সংস্করণে পরীক্ষানিরীক্ষার পর কিছু কিছু নতুন উপদান অনেক সময় RELEASE সংস্করণেও যোগ করা হয়। - -=== BSD'র রকমফের - -লিন্যাক্স ডিস্ট্রিবিউশনের সংখ্যা অনেক হলেও ওপেনসোর্স BSD'র সংখ্যা মাত্র তিনটি। প্রতিটি BSD প্রজেক্টেরই নিজস্ব সোর্স সংগ্রহ এবং কার্নেল রয়েছে। কার্যত অবশ্য দেখা যায় যে বিভিন্ন লিন্যাক্সে ব্যবহৃত অ্যাপলিকেশন সফটওয়ারে যতটুকু পার্থক্য রয়েছে, বিভিন্ন BSD'তে ব্যবহৃত অ্যাপলিকেশনের মাঝে পার্থক্য তার থেকেও কম। - -বিভিন্ন BSD প্রজেক্টের লক্ষ্য ও উদ্দেশ্যকে ছকে ফেলে পৃথক করাটা বেশ কঠিন। মূল ব্যাপারগুলো অনেকটা এরকম ঃ - -* FreeBSD'র লক্ষ্য হল উচ্চক্ষমতা ও সহজ ব্যবহারযোগ্যতা। ইন্টারনেটভিত্তিক সংস্থাগুলোর মাঝে এটি বিশেষভাবে জনপ্রিয়। পিসি এবং কম্প্যাক কর্পোরেশনের আলফা কম্পিউটারে FreeBSD চালানো যায়। অন্যান্য BSD থেকে FreeBSD ব্যবহারকারীর সংখ্যা অনেক বেশি। -* NetBSD প্রজেক্টের লক্ষ্য হল বিভিন্ন মডেলের কম্পিউটারে তাদের অপারেটিং সিস্টেমকে চালাতে পারা; তাই তাদের মূলমন্ত্রই হল "of course it runs NetBSD" অর্থাত্‍ "নিশ্চয় NetBSD এই কম্পিউটারটিকে চালাতে পারে"। ছোট্ট পামটপ থেকে শুরু করে শক্তিশালী বড়মাপের সার্ভার - সবকিছুতেই আজ NetBSD চালানো যায়। এমনকি একসময় নাসা (NASA) কর্তৃক পরিচালিত নভোযানেও NetBSD ব্যবহৃত হয়েছে। বিশেষ করে পুরনো ধরনের যেসব কম্পিউটার ইন্টেল প্রসেসর ব্যবহার করে না, সেসব চালানোর জন্য NetBSD একটি চমত্‍কার অপারেটিং সিস্টেম। -* OpenBSD'র লক্ষ্য নিশ্ছিদ্র নিরাপত্তা এবং সোর্সকোডের নির্ভূলতা। ওপেনসোর্স চিন্তাধারা অনুসরণের পাশাপাশি কঠিন সর্তকতার সাথে সোর্সকোড পরীক্ষার ফলে OpenBSD'র নিরাপত্তা ও নির্ভুলতা একটি প্রমাণিত ও স্বীকৃত সত্য। এজন্য নিরাপত্তার ব্যাপারে বিশেষভাবে সচেতন বিভিন্ন প্রতিষ্ঠান, যেমন - ব্যাংক, শেয়ার বাজার, মার্কিন সরকারি দপ্তর - এদের কাছে OpenBSD বিশেষভাবে সমাদৃত। NetBSD'র মত OpenBSDও বেশকিছু মডেলের কম্পিউটারে চলতে সক্ষম। - -এছাড়াও ওপেনসোর্স নয় এরকম রয়েছে আরও দুটি BSD। এরা হল BSD/OS এবং অ্যাপল কর্পোরেশনের `Mac OS X` - -* 4.4 BSD থেকে উদ্ভুত অপারেটিং সিস্টেমগুলোর মধ্যে BSD/OS সবচেয়ে প্রাচীন। যদিও এটি ওপেনসোর্স নয়, কিন্তু বেশ অল্প খরচেই এর সোর্সকোড লাইসেন্স কেনা যায়। FreeBSD'র সাথে BSD/OS এর প্রচুর মিল রয়েছে। -* অ্যাপল কম্পিউটার কর্পোরেশনের ম্যাকিন্টশ কম্পিউটারে ব্যবহৃত অপারেটিং সিস্টেমের সর্বশেষ সংস্করণ হল MacOS X। এই অপারেটিং সিস্টেমটির কার্নেল ব্যাতীত অন্যান্য অংশ ওপেনসোর্স নয়। অ্যাপল কর্পোরেশনের প্রধান কয়েকজন ডেভেলপারের FreeBSD সোর্সকোড পরিবর্তনের অধিকার রয়েছে। - -=== BSD ও গনুহ (GNU) পাবলিক লাইসেন্সের পার্থক্য - -লিন্যাক্সের লাইসেন্স হল _GNU General Public License_ বা GPL। GPL এর উদ্দেশ্য হল ওপেনসোর্স নয় এধরনের সকল সফটওয়ারকে ঝেঁটিয়ে বিদায় করা। GPL সফটওয়ারের ওপর ভিত্তি করে নির্মিত নতুন কোন সফটওয়ারের সোর্সকোড প্রকাশ করতে সফটওয়ার নির্মাতা বাধ্য। কিন্তু BSD লাইসেন্স এতটা কঠোর নয়। ফলে BSD লাইসেন্স ব্যবহার করে সফটওয়ারের শুধুমাত্র বাইনারি বা কম্পাইল্ড সংস্করণও প্রকাশ করা সম্ভব। বিশেষ কর _Embedded_ অ্যাপলিকেশনের জন্য এই ব্যবস্থা খুবই সুবিধাজনক। - -=== আর যা কিছু জানা দরকার - -যেহেতু BSD'তে চলতে সক্ষম অ্যাপলিকেশন সফটওয়ারের সংখ্যা লিন্যাক্স অপেক্ষা কম, তাই BSD ডেভেলপাররা BSD'তেই লিন্যাক্সের সফটওয়ার চালাবার জন্য একটি প্যাকেজ তৈরী করেছেন। এই প্যাকেজের অংশ হল লিন্যাক্সের `C` লাইব্রেরী এবং BSD কার্নেলকে প্রয়োজনীয় পরিবর্তনের ব্যবস্থা। এই পরিবর্তনের ফলে BSD কার্নেল লিন্যাক্সের সিস্টেম কল অনুযায়ী কাজ করতে পারে। একই গতির একটি BSD ব্যবহারকারী কম্পিউটার ও একটি লিন্যাক্স ব্যবহারকারী কম্পিউটারে লিন্যাক্স ভিত্তিক অ্যাপলিকেশন সফটওয়ার চালালে সফটওয়ারটির কার্জদক্ষতাতে তেমন কোন পার্থক্য পরিলক্ষিত হয় না। - -লিন্যাক্সের তুলনায় BSD'কে আপগ্রেড করা অপেক্ষাকৃত সহজ। কারণ প্রতিটি BSD অপারেটিং সিস্টেম একটিমাত্র গোষ্ঠীর নিয়ন্ত্রণাধীন, অন্যদিকে বিভিন্ন লিন্যাক্স ডিস্ট্রিবিউশন বিভিন্ন গোষ্ঠী বা প্রতিষ্ঠানের নিয়ন্ত্রণাধীন। BSD'তে যখন লাইব্রেরী আপগ্রড করা হয় তখন পূর্ববর্তী লাইব্রেরীর জন্যও উপযুক্ত মডিউল দেয়া হয়। ফলে কয়েক বছরের পুরনো সফটওয়ারও কোন সমস্যা ছাড়াই চালানো যায়। - -=== তাহলে কি BSD, না লিন্যাক্স ব্যবহার করবো ? - -BSD এবং লিন্যাক্সের মাঝে বিভিন্ন পার্থক্য থাকলেও বাস্তবে এর প্রভাব কতটুকু ? BSD কার জন্য আর লিন্যাক্সই বা কার জন্য ? - -এই প্রশ্নের জবাব দেয়া খুবই কঠিন। নিচের পরামর্শগুলো হয়তো কিছুটা সাহায্য করতে পারেঃ - -* যদি আপনি এ মুহূর্তে কোন ওপেনসোর্স অপারেটিং সিস্টেম ব্যবহার করে সন্তুষ্ট থাকেন, তবে তা পরিবর্তনের পেছনে তেমন কোন যুক্তি নেই। -* BSD অপারেটিং সিস্টেমগুলোর মধ্যে বিশেষ করে FreeBSD ব্যবহার করে লিন্যাক্স অপেক্ষা বেশি সুবিধা পাওয়া সম্ভব। তবে এটি সবক্ষেত্রে সত্য নয়। কখনো কখনো লিন্যাক্স হয়তো FreeBSD থেকেও ভাল ফল দিতে পারে। -* নির্ভরযোগ্যতার জন্য BSD অপারেটিং সিস্টেমগুলোর দীর্ঘদিনের খ্যাতি আছে। সোর্সকোডে দীর্ঘ ব্যবহারজনিত অভিজ্ঞতার প্রতিফলনই এর মূল কারণ। -* BSD লাইসেন্স অনেকক্ষেত্রেই GPL লাইসেন্স অপেক্ষা অধিক সুবিধাজনক। -* লিন্যাক্সের সফটওয়ার BSD'তে চালানো গেলেও তার উল্টোটা সত্যি নয়। দু দুটো অপারেটিং সিস্টেমের সফটওয়ার চালাতে পারায় BSD'র সফটওয়ারের সংখ্যা লিন্যাক্স থেকেও বেশি। - -=== BSD সংক্রান্ত সেবা ও প্রশিক্ষণ - -BSDi সবসময়ই BSD/OS সংক্রান্ত সেবা দিয়ে এসেছে। সম্প্রতি তারা FreeBSD ভিত্তিক সেবা দেয়ারও ঘোষণা দিয়েছে। - -এছাড়া FreeBSD, NetBSD ও OpenBSD'র ব্যাপারে পরামর্শ দিয়ে থাকেন এরকম ব্যক্তিদের তালিকাও প্রত্যেক প্রজেক্টের নিকট থেকে পাওয়া যায়। diff --git a/documentation/content/bd/articles/new-users/_index.adoc b/documentation/content/bd/articles/new-users/_index.adoc deleted file mode 100644 --- a/documentation/content/bd/articles/new-users/_index.adoc +++ /dev/null @@ -1,418 +0,0 @@ ---- -title: ইউনিক্স ও FreeBSD'র হাতেখড়ি -authors: - - author: অ্যানেলিস এন্ডারসন - email: andrsn@andrsn.stanford.edu -releaseinfo: "$FreeBSD$" -trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"] ---- - -= ইউনিক্স ও FreeBSD'র হাতেখড়ি -:doctype: article -:toc: macro -:toclevels: 1 -:icons: font -:sectnums: -:sectnumlevels: 6 -:source-highlighter: rouge -:experimental: - -[.abstract-title] -Abstract - -`FreeBSD` ইনস্টল করতে পারায় আপনাকে _স্যালুট!!!_ বিভিন্ন ইউনিক্স এবং বিশেষ করে FreeBSD'র জগতে যারা নতুন, তাদেরকে উদ্দেশ্য করেই এই লেখা; তাই ইউনিক্সের প্রাথমিক ব্যাপারগুলো দিয়েই লেখাটি শুরু হয়েছে। আমরা ধরে নিচ্ছি যে, আপনি BSDi বা http://www.FreeBSD.org/[FreeBSD.org] এর সরবরাহকৃত FreeBSD'র ২.০.৫ বা তার পরবর্তী কোন সংস্করণ ব্যবহার করছেন; তাছাড়া আপনিই এমুহূর্তে আপনার সিস্টেমের একমাত্র ব্যবহারকারী এবং `ডস`/`উইন্ডোস` বা OS/2 ব্যবহারেও আপনি মোটামুটি অভ্যস্ত। - -''' - -toc::[] - -== লগ ইন ও লগ আউট - -যখন `login:` লেখাটি দেখতে পাবেন, তখন `root` অথবা সাধারণ একজন ব্যবহারকারীরূপে লগ ইন করুন, অর্থাত্‍ সিস্টেমে প্রবেশ করুন। সাধারণ ব্যবহারকারির এই অ্যাকাউন্টটি পূর্বেই ইনস্টলেশনের সময় অথবা root হিসেবে তৈরী করে রাখতে হবে। root নামক অ্যাকাউন্টটি FreeBSD ইনস্টলেশনের সময় নিজে থেকেই তৈরী হয়। এই root অ্যাকাউন্টটির ক্ষমতা অপরিসীম। এটি থেকে সিস্টেমের যেকোন স্থানে প্রবেশ করে যেকোন পরিবর্তন করা যায়; এমনকি প্রয়োজনীয় ফাইল মুছে ফেলাও root এর জন্য কোন সমস্যা নয়। তাই root অ্যাকাউন্টে লগ ইন করলে যথেষ্ট সতর্কতা অবলম্বন করা প্রয়োজন। `%` এবং `#` চিহ্নদুটি কমান্ড প্রম্পট নির্দশ করে। কমান্ড প্রম্পট হল ব্যবহারকারীর নিকট থেকে বিভিন্ন কমান্ড বা নির্দেশ গ্রহন করার একটি বিশেষ প্রোগ্রাম। এই লেখায়, সাধারণ একজন ব্যবহারকারীর নিকট উপস্থাপিত কমান্ড প্রম্পট বোঝাতে `%` এবং root এর জন্য `#` ব্যবহৃত হয়েছে। আপনি যে কমান্ড প্রম্পটটি ব্যবহার করেন, তা এর থেকে ভিন্ন হতে পারে। - -লগ আউট করে প্রতিবার নতুন একটি `login:` প্রম্পট পেতে হলে লিখুন - - -[source,shell] -.... -# exit -.... - -এটিসহ অন্যান্য প্রতিটি কমান্ড লিখে kbd:[Enter] চাপুন। তাছাড়া একথাও মনে রাখবেন যে, ইউনিক্স ছোট ও বড় হাতের অক্ষরকে ভিন্নভাবে বিবেচনা করে, অর্থাত্‍ `exit` ও `EXIT` কখনোই এক নয়। - -কম্পিউটার বন্ধ (shut down) করতে চাইলে লিখুন - - -[source,shell] -.... -# /sbin/shutdown -h now -.... - -আর রিবুট করতে চাইলে লিখুন - - -[source,shell] -.... -# /sbin/shutdown -r now -.... - -অথবা - -[source,shell] -.... -# /sbin/reboot -.... - -একত্রে kbd:[Ctrl+Alt+Delete] চেপেও রিবুট করতে পারেন। রিবুটের পূর্বে FreeBSD কিছুটা সময় নেবে। FreeBSD'র নতুন সংস্করণগুলোতে `/sbin/reboot` ও kbd:[Ctrl+Alt+Delete] একই ফল দেয়। রিস্টার্ট বাটন চেপে কম্পিউটার রিবুট করা অপেক্ষা এদুটি অনেক ভাল উপায়। তাছাড়া নতুন করে FreeBSD ইনস্টলের ঝুকি এড়ানোর জন্যও এই দুটি পদ্ধতি ব্যবহার করা উচিত্‍। - -== Root হিসেবে নতুন ব্যবহারকারীর জন্য অ্যাকাউন্ট তৈরী - -ইনস্টলেশনের সময় যদি কোন অ্যাকাউন্ট তৈরী করে না থাকেন এবং এখন root হিসেবে লগ ইন করে থাকেন, তবে একটি অ্যাকাউন্ট তৈরীর সময় হয়েছে। এজন্য লিখুন - - -[source,shell] -.... -# adduser -.... - -প্রথমবার এই কমান্ডটি ব্যবহার করলে কিছু প্রশ্ন করা হয় এবং কোন পছন্দ না থাকলে ডিফল্ট হিসেবে কি গ্ড়গ্রহন করা হবে তাও দেখানো হয়। ডিফল্ট শেল হিসেবে হয়তো sh এর নাম দেখানো হবে কিন্তু আপনি csh শেলও পছন্দ করতে পারেন। কিছুই পছন্দ করার না থাকলে শুধু kbd:[Enter] চাপুন। এই পছন্দগুলোই পরবর্তী প্রতিটি অ্যাকাউন্ট তৈরীর সময় ব্যবহৃত হবে। [.filename]#/etc/adduser.conf# নামক একটি পরিবর্তনযোগ্য ফাইলে এই তথ্যগুলো লেখা হয়। - -নতুন কোন ব্যবহারকারীর জন্য অ্যাকাউন্ট তৈরীর একটি উদাহরণ এখন দেয়া হচ্ছে যেখানে _জ্যাক বেনিম্বলের জন্য জ্যাক_ নামে একটি অ্যাকাউন্ট তৈরী করা হয়। নিরাপত্তার ব্যাপারটি বেশ গুরুত্বপূর্ণ হলে জ্যাককে একটি পাসওয়ার্ডও দিতে হবে। জ্যাককে অন্যকোন গ্রুপের অন্তর্ভুক্ত করা হবে কিনা জানতে চাইলে লিখুন `wheel` - -[source,shell] -.... -Login group is "jack". Invite jack into other groups: wheel -.... - -এর ফলে _jack_ অ্যাকাউন্টে লগ ইন করেও `su` কমান্ড ব্যবহার করে root হওয়া যাবে। এভাবে root অ্যাকাউন্টে লগ ইন করলে অন্য কারো বিরক্তি উত্‍পাদনেরও কোন সম্ভাবনা নেই। - -যেকোন সময় kbd:[Ctrl+C] চেপে `adduser` থেকে বের হয়ে আসা যায়। বের হওয়ার পূর্বে নতুন অ্যাকাউন্ট তৈরী হবে কি হবে না তা নিশ্চিত করার জন্য একটি সুযোগ দেয়া হবে; নতুন অ্যাকাউন্ট তৈরী করতে না চাইলে শুধু kbd:[n] চেপে না করে দেয়া যাবে। ইচ্ছা হলে _jill_ নামে দ্বিতীয় আরেকটি অ্যাকাউন্ট তৈরী করতে পারেন। এর সুবিধা হল - কোন কারণে _jack_ নামের অ্যাকাউন্টটি ক্ষতিগ্রস্থ হলে _jill_ নামের অ্যাকাউন্টটি ব্যবহার করতে পারবেন। - -জ্যাকের জন্য নতুন অ্যাকাউন্ট তৈরী হয়ে গেলে `exit` কমান্ড ব্যবহার করে বের হয়ে আসুন ও জ্যাক হিসেবে পুনরায় লগ ইন করুন। বিশেষ দরকার না হলে root হিসেবে কাজ না করাই ভাল; এতে root এর শক্তি অপব্যবহার হওয়ার ঝুকি থাকে না। - -যদি আপনি ইতিপূর্বেই জ্যাকের জন্য একটি অ্যাকাউন্ট তৈরী করে থাকেন এবং এখন তাকে শুধু `su` কমান্ড ব্যবহার করে root হওয়ার সুযোগ দিতে চান, তবে আপনি নিজে root হিসেবে লগ ইন করে [.filename]#/etc/group# ফাইলের প্রথম লাইনে _jack_ শব্দটি যোগ করুন। এই লাইনটিতে `wheel` গ্রুপের সদস্যদের নাম তালিকাভুক্ত থাকে। তবে এর পূর্বে আপনাকে Vi টেক্সট এডিটর কিংবা Vi এর পরিবর্তে ee ব্যবহার করা শিখতে হবে। Vi থেকে ee ব্যবহার করা অপেক্ষাকৃত সহজ। সাধারণত FreeBSD'র নতুন সংস্করণগুলোতে ee দেয়া থাকে। - -কোন ব্যবহারকারীর অ্যাকাউন্ট মুছে ফেলতে চাইলে `rmuser` কমান্ড ব্যবহার করুন। - -== ঘুরে দেখা - -একজন সাধারণ ব্যবহারকারীরূপে লগ ইন করুন এবং বিভিন্ন ডিরেক্টরি ঘুরে ফিরে দেখুন। প্রয়োজনীয় সহায়িকা ও FreeBSD সংক্রান্ত বিভিন্ন তথ্য জানার জন্য কিছু কমান্ড ব্যবহার করে দেখতে পারেন। - -এখানে কয়েকটি কমান্ড ও তাদের কার্যকারিতা উল্লেখ করা হলঃ - -`id`:: -আপনার অ্যাকাউন্ট, গ্রুপ ইত্যাদির নাম জানাবে। - -`pwd`:: -এ মুহূর্ত কোন ডিরেক্টরিতে অবস্থান করছেন তা জানাবে। - -`ls`:: -বর্তমান ডিরেক্টরির সকল ফাইলের নাম দেখাবে। - -`ls -F`:: -ফাইলের নাম দেখানোর সময় এক্সিকিউটেবল বা বাইনারি ফাইলের শেষে `*`, ডিরেক্টরির শেষে `/` এবং সিম্বলিক লিঙ্কের শেষে `@` জুড়ে দেবে। - -`ls -l`:: -নামসহ প্রতিটি ফাইলের বিভিন্ন তথ্য এই ক্রমানুসারে দেখাবে - আকার, তারিখ ও ব্যবহারের অনুমতি। - -`ls -a`:: -লুক্কায়িত "dot" ফাইলসহ সব ফাইলের নামই দেখাবে। root হিসাবে লগ ইন করলে অবশ্য -a ছাড়াই লুক্কায়িত ফাইলের নাম দেখা যায়। - -`cd`:: -ডিরেক্টরি পরিবর্তন করে। cd .. লিখলে একধাপ উপরের ডিরেক্টরিতে যাওয়া যায়। cd'র পর যে একঘর space আছে, তা অবশ্যই লিখতে হবে। /usr/local/ ডিরেক্টরিতে যেতে চাইলে লিখুন cd /usr/local । cd ~ লিখলে যে অ্যাকাউন্টে লগ ইন করেছেন তার home ডিরেক্টরিতে প্রবেশ করবেন। জ্যাক অ্যাকাউন্টের হোম ডিরেক্টরি হল /usr/home/jack। /cdrom এ cd কমান্ড ব্যবহার করে প্রবেশ করুন এবং ls ব্যবহার করে দেখুন যে কোন সিডিরম মাউন্ট করা আছে কিনা এবং থাকলে তা কাজ করছে কিনা। - -`view filename`:: -কোন পরিবর্তন না করে একটি ফাইল পড়তে দেয়। view /etc/fstab লিখে একবার পরীক্ষা করে দেখুন। পড়া শেষ হলে q চেপে বের হয়ে আসুন। - -`cat filename`:: -কম্পিউটার স্ক্রীনে _filename_ নামের ফাইলটিকে প্রিন্ট করে। যদি ফাইলটি খুব বড় হয় এবং স্ক্রীনে শুধুমাত্র ফাইলের শেষাংশই দেখা যায় তবে kbd:[Scroll Lock] চেপে kbd:[up-arrow] চাপলে ফাইলের অন্যান্য অংশও পড়তে পারবেন। এই একই প্রক্রিয়া ম্যানুয়াল পেজের ক্ষেত্রেও প্রযোজ্য। পুনর্বার kbd:[Scroll Lock] চাপলে এই প্রক্রিয়া বন্ধ হয়ে যাবে। আপনার home ডিরেক্টরির কিছু লুকানো ফাইলের ওপর `cat` কমান্ডটি ব্যবহার করে দেখতে পারেন, যেমন - `cat .cshrc`, `cat .login`, `cat .profile`। - -[.filename]#.cshrc# ফাইলে `ls` কমান্ডের কিছু alias দেখতে পাবেন। আপনি নিজেও [.filename]#.cshrc# ফাইলে কিছু alias তৈরী করতে পারেন। যদি সিস্টেমের প্রত্যেক ব্যবহারকারীকে alias'গুলো ব্যবহার করতে দিতে চান, তবে csh এর মূল কনফিগারেশন ফাইল [.filename]#/etc/csh.cshrc#'তে আপনার alias গুলো লিখে রাখুন। - -== তথ্য ও সহায়িকা - -এখন সহায়িকা পড়ার বিভিন্ন পদ্ধতির বর্ণনা দেয়া হচ্ছে। "text" শব্দটির সাহায্য আপনার পছন্দের কোন একটি বিষয়কে বোঝানো হচ্ছে। সাধারণত বিভিন্ন কমান্ড ও গুরুত্বপূর্ণ ফাইলের জন্য প্রয়োজনীয় সহায়িকা দেয়া থাকে। - -`apropos text`:: -`whatis` ডাটাবেসে _text_ এর ওপর কোন তথ্য থাকলে তা দেখায়। - -`man text`:: -_text_ সংক্রান্ত ম্যানুয়াল পেজ থাকলে তা দেখায়। ম্যানুয়াল পেজ হল ইউনিক্স সিস্টেমগুলোতে ডকুমেন্টেশনের সবচেয়ে বড় উত্‍স। উদাহরণস্বরূপ `man ls` কমান্ডটি আপনাকে `ls` কমান্ড ব্যবহারের সমস্ত পদ্ধতি জানাবে। ম্যানুয়াল পেজ দেখার সময় kbd:[Enter] চাপলে একলাইন সামনে, kbd:[Ctrl+B] চাপলে এক স্ক্রীন পেছনে, kbd:[Ctrl+F] চাপলে এক স্ক্রীন সামনে এবং kbd:[q] বা kbd:[Ctrl+C] চাপলে ম্যানপেজ থেকে বের হয়ে আসা যায়। - -`which text`:: -আপনার ব্যবহৃত path এ _text_ কমান্ডটি পাওয়া গেলে path টি জানানো হয়। - -`locate text`:: -যে সকল path এ _text_ শব্দটি পাওয়া যাবে, তা আপনাকে জানানো হবে। - -`whatis text`:: -সংক্ষিপ্তাকারে _text_ কমান্ডটির কাজ সম্পর্কে জানায়। `whatis *` লিখলে বর্তমান ডিরেক্টরির সকল বাইনারি ফাইলের কাজ সম্পর্কে জানাতে চেষ্টা করে । - -`whereis text`:: -_text_ নামক ফাইলটিকে খুজে বের করার চেষ্টা করে এবং খুজে পেলে _ text_ ফাইলের path জানায়। - -কিছু বহুল ব্যবহৃত ও গুরুত্বপুর্ণ কমান্ডের ওপর `whatis` ব্ঃব্যবহার করে দেখতে পারেন, যেমন- `cat`, `more`, `grep`, `mv`, `find`, `tar`, `chmod`, `date` এবং `script` । `more` কমান্ডটি এক পৃষ্ঠা করে লেখা পড়তে দেয়। ডস-এও কমান্ডটি একই কাজ করে; উদাহরণস্বরূপ: `ls -l | more` কিংবা `more filename` । ``*`` চিহ্নটি wildcard হিসেবে কাজ করে, যেমন- `ls w*` লিখলে নামের প্রথম অক্ষর w, এ ধরনের সব ফাইলের নাম দেখা যায়। - -হয়তো কিছু কমান্ড আপনার সিস্টেমে ভালভাবে কাজ করছে না। `locate` এবং `whatis` উভয়ই একটি ডাটাবেসের ওপর নির্ভর করে যা প্রতি সপ্তাহে নতুন করে তৈরী করা হয়। যদি আপনার কম্পিউটারটি সাপ্তাহিক ছুটির দিনে বন্ধ থাকে কিংবা ঐ দিন FreeBSD চালানো না হয়, তবে দৈনিক, সাপ্তাহিক কিংবা মাসিক কাজগুলো যেকোন সময়ই করতে পারেন। পরবর্তি কমান্ডগুলো আপনাকে এই ব্যবস্থা করে দেবে; root হিসেবে কমান্ডগুলো চালান এবং একটি কমান্ডের কাজ শেষ হলেই কেবল পরের কমান্ডটি প্রয়োগ করুন। - -[source,shell] -.... -# periodic daily -সংশ্লিষ্ট আউটপুট -# periodic weekly -সংশ্লিষ্ট আউটপুট -# periodic monthly -সংশ্লিষ্ট আউটপুট -.... - -এই কমান্ডগুলো চলার সময় বসে থেকে অপেক্ষা করতে না চাইলে kbd:[Alt+F2] চেপে আরেকটি _ভার্চুয়াল কনসোল_ খুলে তাতে লগ ইন করুন। মনে রাখবেন, ইউনিক্স একটি মাল্টিটাস্কিং, মাল্টিইউজার সিস্টেম, তাই একত্রে অসংখ্য ব্যবহারকারী ও প্রোগ্রাম চলানো কোন সমস্যা নয়। নতুন কনসোল চালু করলেও অবশ্য কমান্ডগুলো আপনার বর্তমান কনসোলে কিছু লেখা দেখাবে; `clear` কমান্ড ব্যবহার করে খুব সহজেই স্ক্রীন পরিস্কার করতে পারেন। কমান্ডগুলোর কাজ শেষ হয়ে গেলে [.filename]#/var/mail/root# এবং [.filename]#/var/log/messages# ফাইলদুটোতে একবার চোখ বুলিয়ে দেখুন। - -সিস্টেম অ্যাডমিনস্ট্রেশনের অংশ হিসেবে প্রায়ই এধরনের কমান্ড চালাবার প্রয়োজন হয়। যেহেতু আপনার ইউনিক্স সিস্টেমটির আপনিই একমাত্র ব্যবহারকারী, তাই সিস্টেম অ্যাডমিনস্ট্রেরের ভূমিকাও আপনাকেই পালন করতে হবে। সাধারণত যে কাজগুলো root হিসেবে না করলেই নয়, সেগুলোই সিস্টেম অ্যাডমিনস্ট্রেশনের অংশ। বাজারে ইউনিক্স সিস্টেম অ্যাডমিনস্ট্রেশনের ওপর অনেক মোটা মোটা বই পাওয়া গেলেও সিস্টেম অ্যাডমিনস্ট্রেশনের ভাল বর্ণনা এসব বইয়ের অধিকাংশতেই থাকে না। বরং এদের একটা বড় অংশ ব্যায় হয় উইন্ডো ম্যানেজারের ব্যবহার পদ্ধতি সংক্রান্ত বর্ণনা দিয়েই। ইউনিক্স সিস্টেম অ্যাডমিনস্ট্রেশনের ওপর দুটি অসাধারণ বই হল এডি নেমেথে র লেখা Unix System Administration Handbook (Prentice-Hall, 1995, ISBN 0-13-15051-7) (যার দ্বিতীয় সংস্করণের প্রচ্ছদ লাল রঙের) এবং এলিন ফ্রিজে র লেখা Essential System Administration (O'Reilly Associates, 1993, ISBN 0-937175-80-3)। আমি নিজে অবশ্য পড়ি নেমেথের বই। - -== লেখা এডিট করা - -সিস্টেমকে প্রয়োজন মত কনফিগার করার জন্য আপনাকে বিভিন্ন ফাইল এডিট করতে হবে। এই ফাইলগুলোর অধিকাংশই [.filename]#/etc# ডিরেক্টরিতে অবস্থিত এবং এদেরকে root হিসেবে এডিট করতে হয়; root হওয়ার জন্য `su` কমান্ডটি ব্যবহার করতে পারেন। সহজে চালানো যায় এরকম একটি এডিটর হল `ee`; কিন্তু দূরদর্শী চিন্তাভাবনা করলে `vi` এডিটরই চালাতে শেখা উচিত্‍। `vi` ইনস্টল করা থাকলে `vi` এর ওপর একটি চমত্‍কার টিউটোরিয়াল পাবেন এখানে- [.filename]#/usr/src/contrib/nvi/docs/tutorial# । এছাড়াও এটি পেতে পারেন link:ftp.cdrom.com[ftp.cdrom.com] নামক FTP সাইটের link:ftp.cdrom.com/FreeBSD/FreeBSD-current/src/contrib/nvi/docs/tutorial/[FreeBSD/FreeBSD-current/src/contrib/nvi/docs/tutorial] অবস্থান থেকে। - -এডিট করার পূর্বে প্রতিটি ফাইলের একটি ব্যাকআপ কপি রাখা উচিত্‍। যদি আপনি [.filename]#/etc/rc.conf# ফাইলটি এডিট করতে চান তবে `cd /etc` লিখে [.filename]#/etc# ডিরেক্টরিতে প্রবেশ করুন এবং লিখুন - -[source,shell] -.... -# cp rc.conf rc.conf.orig -.... - -এর ফলে [.filename]#rc.conf# ফাইলের [.filename]#rc.conf.orig# নামক একটি কপি তৈরী হবে। পরে যদি কোন কারণে [.filename]#rc.conf# এর মূল কপি ব্যবহারের প্রয়োজন হয় তবে [.filename]#rc.conf.orig# কে [.filename]#rc.conf# এ কপি করা যাবে। তবে সবচেয়ে ভাল হয় [.filename]#rc.conf# এর নাম পরিবর্তন করে [.filename]#rc.conf.orig# করার পর [.filename]#rc.conf.orig# কে [.filename]#rc.conf# এ কপি করলে: - -[source,shell] -.... -# mv rc.conf rc.conf.orig -# cp rc.conf.orig rc.conf -.... - -এরকম করার কারণ হল, `mv` কমান্ডের সাহায্যে ফাইলের নাম পরির্বতন করলেও ফাইল সংক্রান্ত বিভিন্ন তথ্য, যেমন- তারিখ, মালিকানা ইত্যাদি অপরিবর্তিত থাকে। এখন [.filename]#rc.conf# কে এডিট করতে পারেন। কোন কারণে এডিটপূর্ব [.filename]#rc.conf# এর প্রয়োজন হলে প্রথমে বর্তমান [.filename]#rc.conf# এর নাম পরিবর্তন করে [.filename]#rc.conf.myedit# করুন (কারণ আপনার এডিটকৃত [.filename]#rc.conf#'কেও হয়তো ভবিষ্যতে প্রয়োজন হতে পারে) ঃ - -[source,shell] -.... -# mv rc.conf.orig rc.conf -.... - -এর ফলে সবকিছু পূর্বের মত হয়ে যাবে। - -কোন ফাইল এডিট করতে চাইলে লিখুন, - -[source,shell] -.... -# vi filename -.... - -kbd:[Arrow] key ব্যবহার করে ফাইলের আগে ও পিছে যেতে পারবেন। kbd:[ESC] চাপলে `vi` তার কমান্ড মোডে প্রবেশ করে। এখানে `vi` এর নিজস্ব কিছু কমান্ডের বর্ণনা দেয়া হলঃ - -x:: -যে অক্ষরটির ওপর কার্সর অবস্থান করছে তা মুছে ফেলে। - -dd:: -সম্পূর্ণ একটি লাইন মুছে ফেলে(একটি প্রকৃত লাইন স্ক্রীনের একাধিক লাইন জুড়ে থাকতে পারে; সেজন্য এ কমান্ডটি লিখলে একটি প্রকৃত লাইনের জন্য স্ক্রীনে দৃশ্যমান সবগুলো লাইনই মুছে যাবে)। - -i:: -কার্সরের অবস্থানে লেখা ঢুকাতে দেয়। - -a:: -কার্সর পরবর্তী অবস্থানে লেখা ঢুকাতে দেয়। - -kbd:[a] বা kbd:[i] চাপার পর আপনি ফাইলে লিখতে পারবেন এবং kbd:[ESC] চেপে আবারো কমান্ড মোডে প্রবেশ করতে পারবেন। কমান্ডমোডের আরো কিছু কমান্ড দেয়া হল, - -:w:: -আপনার করা পরিবর্তনগুলো ডিস্কে সেভ হয় ও তারপর আবার ফাইল এডিট করা যায়। - -:wq:: -ফাইল সেভ হয় ও `vi` থেকে বের হয়ে আসে। - -:q!:: -কোন পরিবর্তন সেভ না করেই `vi` থেকে বের হয়ে আসে। - -/text:: -_text_ কে খুজে বের করে ও কার্সরকে সেখানে নিয়ে যায়। এরপর kbd:[/] ও kbd:[Enter] চাপলে পরবর্তী _text_ এর পূর্বে কার্সর নিয়ে যায়। - -G:: -ফাইলের শেষে যায়। - -nG:: -nতম লাইনে যায়। - -Ctrl-L:: -স্ক্রীনে সবকিছু নতুন করে লেখা হয়। - -kbd:[Ctrl+b] এবং kbd:[Ctrl+f]:: -যথাক্রমে একস্ক্রীন সামনে ও পেছনে যায়। `more` ও `view` কমান্ডের ক্ষেত্রেও এরা অনুরূপ কাজ করে। - -আপনার home ডিরেক্টরিতে `vi` চালিয়ে অভ্যাস করুন। `vi filename` লিখে একটি নতুন ফাইল খুলুন, কয়েকটি লাইন লিখুন, মুছে ফেলুন, সেভ করুন, `vi` থেকে বের হয়ে যান, আবার নতুন ফাইলটি `vi`-এ ওপেন করুন। এডিটর হিসেবে `vi` আসলেই কিছুটা জটিল এবং একারণে অনেক কিছুই আপনার কাছে অদ্ভূত মনে হতে পারে। কখনো হয়তো ভুল কমান্ডের কারণে `vi` এমন কিছু করে বসবে যা আপনি মোটেও করতে চাচ্ছেন না। এতকিছুর পরও `vi` অনেকেরই পছন্দের এডিটর; DOS EDIT থেকে এটি অনেক শক্তিশালী, `:r` কমান্ডটি ব্যবহার করে এসম্পর্কে কিছু ধারনা পেতে পারেন। একবার দুবার kbd:[ESC] চেপে নিশ্চিত হয়ে নিন যে আপনি `vi` এর কমান্ড মোডে আছেন। তারপর `:w` চেপে লেখা সেভ করুন, কিছু লিখে `:q!` চেপে সেভ না করেই বের হয়ে আসুন এবং নতুন করে ফাইলটি খুলে সর্বশেষ সেভ করা অবস্থা থেকে আবারও এডিট করতে থাকুন। - -এখন `cd` কমান্ডের সাহায্যে [.filename]#/etc# ডিরেক্টরিতে প্রবেশ করুন, `su` কমান্ড ব্যবহার করে root হোন, `vi` দিয়ে [.filename]#/etc/groups# ফাইলটি এডিট করে `whell` গ্রুপে কোন একজন ব্যবহারকারীকে যোগ করুন। এজন্য প্রথম লাইনটির শেষে একটি কমা এবং তারপর উক্ত ব্যবহারকারীর লগ ইনের নাম লিখুন। এরপর প্রথমে kbd:[Esc] ও পরে `:wq` চেপে ফাইলটি সেভ করুন ও `vi` থেকে বের হয়ে আসুন। এই পরিবর্তন তাত্‍ক্ষণিকভাবে কার্যকর হবে। (আশা করি কমার পর কোন space বসাননি) - -== ডস থেকে ফাইল প্রিন্ট করা - -এ অবস্থায় সম্ভবত আপনার প্রিন্টার কাজ করছে না। তাই কোন ম্যানুয়াল পেজকে ফ্লপিতে করে ডস-এ নিয়ে কিভাবে প্রিন্ট করবেন তার বর্ণনা এখানে দেয়া হল। মনে করুন আপনি কোন ফাইল ব্যবহারের অনুমতি পরিবর্তনের প্রক্রিয়া ভালভাবে পড়তে চাইছেন (এটি যথেষ্ট গুরুত্বপূর্ণ একটি ব্যাপার)। `man chmod` কমান্ড ব্যবহার করে আপনি এসম্পর্কে পড়তে পারবেন, - -[source,shell] -.... -% man chmod | col -b > chmod.txt -.... - -এই কমান্ডটি `chmod` এর ম্যানুয়াল পেজকে স্ক্রীনে না দেখিয়ে [.filename]#chmod.txt# ফাইলে লিখে দেবে। এখন ফ্লপি ড্রাইভে একটি ডস ফরম্যাটের ফ্লপি রাখুন, `su` কমান্ড ব্যবহার করে root হোন এবং লিখুন - -[source,shell] -.... -# /sbin/mount -t msdos /dev/fd0 /mnt -.... - -এর ফলে [.filename]#/mnt# ডিরেক্টরিতে ফ্লপি ড্রাইভ মাউন্ট হবে। - -এখন যে ডিরেক্টরিতে [.filename]#chmod.txt# নামের ফাইলটি তৈরী করেছেন সেখানে গিয়ে [.filename]#chmod.txt# কে ফ্লপিতে কপি করতে পারেন (এজন্য root হিসেবে কাজ করার কোন প্রয়োজন নেই, তাই `exit` লিখে অনায়াসে `jack` হিসেবে কাজকর্ম চালিয়ে যেতে পারেন)। - -[source,shell] -.... -% cp chmod.txt /mnt -.... - -`ls /mnt` কমান্ড লিখলে [.filename]#/mnt# ডিরেক্টরির সব ফাইলের নাম দেখতে পাবেন এবং সেখানে [.filename]#chmod.txt# এর নামও থাকবে। - -আপনি বিশেষ করে [.filename]#/sbin/dmesg# কমান্ডের আউটপুটকে একটি ফাইলে লিখে রাখার প্রয়োজনীয়তা অনুভব করতে পারেনঃ - -[source,shell] -.... -% /sbin/dmesg > dmesg.txt -.... - -তৈরী হয়ে গেলে ফাইলটিকে ফ্লপিতে স্থানান্তর করতে পারেন। [.filename]#/sbin/dmesg# আউটপুট হিসেবে বুটলগ রেকর্ড দেখায় এবং এটি বিশেষভাবে গুরুত্বপূর্ণ কারণ এর মাধ্যমে জানা যায় যে FreeBSD চালু হওয়ার সময় কি কি যন্ত্রপাতি সনাক্ত করেছে। যদি আপনি FreeBSD Generals Questions মেইলিং লিস্ট mailto:freebsd-questions@FreeBSD.org[freebsd-questions@FreeBSD.org] কিংবা কোন ইউজনেট গ্রুপে এধরনের কোন প্রশ্ন করেন যে, "FreeBSD আমার কম্পিউটারের টেপড্রাইভ খুজে পাচ্ছে না, এখন আমি কি করব ?" তবে উত্তরদাতাদের প্রত্যেকেই `dmesg` কি দেখাচ্ছে তা জানতে চাইবে। - -এখন আপনি root হিসেবে ফ্লপিড্রাইভকে ডিসমাউন্ট করতে পারেন, - -[source,shell] -.... -# /sbin/umount /mnt -.... - -এবার ফ্লপি ডিস্কটি বের করে কম্পিউটার রিবুট করুন ও তারপর ডস-এ প্রবেশ করুন। এই ফাইলগুলোকে ফ্লপি থেকে কোন একটি ডস ডিরেক্টরিতে কপি করে ডস-এর EDIT, উইন্ডোসের নোটপ্যাড, ওয়ার্ডপ্যাড বা অন্য কোন ওয়ার্ডপ্রসেসরে ওপেন করুন এবং ছোটখাট কোন পরিবর্তন করুন যেন ফাইলটিকে নতুন করে সেভ করার সুযোগ পাওয়া যায়। এরপর ফাইলটি প্রিন্ট করুন। আশা করা যায় যে এই পদ্ধতিতে ফাইলটি ঠিক মতই প্রিন্ট হবে। সবচেয়ে ভাল ফল পাওয়ার জন্য ডস-এর `print` কমান্ড ব্যবহার করে ম্যানুয়াল পেজকে প্রিন্ট করতে পারেন। (এ মুহূর্তে FreeBSD থেকে মাউন্টকৃত কোন ডস পার্টিশনে সরাসরি ফাইল কপি করাটা কিছুটা ঝুকিপূর্ণ) - -FreeBSD থেকে প্রিন্ট করার জন্য [.filename]#/etc/printcap# ফাইলে একটি এন্ট্রি থাকতে হবে এবং [.filename]#/var/spool/output# ডিরেক্টরিতে এই এন্ট্রির নামানুসারে একটি ডিরেক্টরি থাকতে হবে। যদি আপনার প্রিন্টারটি পোর্টে (যাকে ডস-এ বলা হয়) থাকে এবং [.filename]#/var/spool/output# ডিরেক্টরিতে [.filename]#lpd# নামে কোন ডিরেক্টরি না থাকে তবে root হিসেবে `mkdir lpd` কমান্ড দিয়ে [.filename]#lpd# নামের ডিরেক্টরিটি তৈরী করলেই প্রিন্টারটি হয়তো কাজ করবে। প্রিন্টারটি FreeBSD'তে কাজের উপযোগী হলে সিস্টেম বুট হওয়ার সময় সাড়া দেবে এবং lp বা lpr একটি ফাইল প্রিন্ট করার চেষ্টা করবে। ফাইলটি শেষ পর্যন্ত প্রিন্ট হবে কি হবে না তা নির্ভর করে প্রয়োজনীয় প্রিন্টার কনফিগারেশনের ওপর। প্রিন্টার কনফিগার করার বিস্তারিত বিবরণ রয়েছে FreeBSD link:{handbook}l[হ্যান্ডবুকে]। - -== আরো কিছু প্রয়োজনীয় কমান্ড - -`df`:: -মাউন্টকৃত সকল ফাইল সিস্টেমের আয়তন দেখায়। - -`ps aux`:: -চলন্ত প্রসেসগুলোর নাম ও অন্যান্য কিছু বৈশিষ্ট্য দেখায়। কমান্ডটির সংক্ষিপ্তরূপ হল ps ax । - -`rm filename`:: -_filename_ নামের ফাইলটিকে মুছে ফেলে। - -`rm -R dir`:: -_dir_ নামের ডিরেক্টরি ও তার অন্তর্গত সকল সাবডিরেক্টরি মুছে ফেলে -- এই কমান্ডটি ব্যবহারের পূর্বে যথেষ্ট সতর্ক হওয়া প্রয়োজন। - -`ls -R`:: -বর্তমান ডিরেক্টরি ও তার বিভিন্ন সাবডিরেক্টরিতে অবস্থিত সকল ফাইলের নাম দেখায়। ফাইল খুজে বের করার কোন ভাল পদ্ধতি যখন আমার জানা ছিল না তখন আমি `ls -AFR > where.txt` কমান্ডটি ব্যবহার করে [.filename]#/# অথবা [.filename]#/usr# ডিরেক্টরির সব ফাইলের তালিকা তৈরী করে তাতে দরকারী ফাইলটি খুজতাম। - -`passwd`:: -কোন সাধারণ ব্যবহারকারী বা root এর পাসওয়ার্ড পরিবর্তন করে। - -`man hier`:: -ইউনিক্সে ব্যবহৃত ফাইল সিস্টেম বিন্যাসের ওপর লিখিত ম্যানুয়াল পেজ দেখায়। - -`find` কমান্ড ব্যবহার করে [.filename]#/usr# ডিরেক্টরির কোন ফাইলকে এভাবে খুঁজে পেতে পারেন, - -[source,shell] -.... -# find /usr -name "filename" -.... - -আপনি ইচ্ছা করলে _filename_ এর পরিবর্তে ওয়াইল্ডকার্ড হিসেবে `*` ব্যবহার করতে পারেন (ফাইলের নাম লিখলে তার পূর্বে ও পরে উদ্ধৃতি চিহ্ন থাকবে)। যদি `find` কমান্ডকে [.filename]#/usr# এর পরিবর্তে [.filename]#/# ডিরেক্টরির নাম দেয়া হয় তবে সিডিরম ও ডস পার্টিশনসহ মাউন্টকৃত সকল ফাইল সিস্টেমেই ফাইলটি খোঁজা হবে। - -ইউনিক্স কমান্ড ও ইউটিলিটির ওপর একটি চমত্‍কার বই হল, অ্যাব্রাহাম ও লারসেনের লেখা Unix for the Impatient (2nd ed., Addison-Wesley, 1996). এছাড়া ইন্টারনেটেও ইউনিক্স এর ওপর প্রচুর তথ্য পাওয়া যায়। এর মধ্যে বিশেষ উল্লেখযোগ্য হল http://www.eecs.nwu.edu/unix.html[Unix Reference Desk] । - -== এখন যা করবেন - -আপনি সম্ভবত এখন বিভিন্ন ডিরেক্টরিতে প্রবেশ করতে ও সেখানকার ফাইল এডিট করতে পারছেন। সুতরাং অন্যান্য কাজগুলোও আপনি এখন করতে পারবেন। এ সম্পর্কিত প্রচুর তথ্য FreeBSD হ্যান্ডবুক (যা সম্ভবত আপনার হার্ডডিস্কেই রয়েছে) ও FreeBSD'র ওয়েবসাইটে রয়েছে। বিভিন্ন কাজের জন্য অসংখ্য সফটওয়ারের প্যাকেজ ও পোর্ট সংস্করণ সিডিরম ও ওয়েবসাইট দুস্থানেই আছে। কিভাবে প্যাকেজ ও পোর্ট ইনস্টল করতে হবে সে সম্পর্কে হ্যান্ডবুকে বিস্তারিত বিবরণ দেয়া হয়েছে। কোন প্যাকেজ সিডিরমে থাকলে তা ইনস্টল করার সহজ পদ্ধতিহল `pkg_add /cdrom/packages/All/packagename`, এখানে _packagename_ শব্দটি দিয়ে যে সফটওয়ারটি ইনস্টল করা হচ্ছে তার প্যাকেজ ফাইলের নাম বোঝানো হয়েছে। সিডিরমের [.filename]#cdrom/packages/index#, [.filename]#cdrom/packages/index.txt# এবং [.filename]#cdrom/ports/index# ফাইলগুলোতে সব প্যাকেজ ও পোর্টের নাম ও অতি সংক্ষিপ্ত বর্ণনা রয়েছে। সফটওয়ারগুলোর সম্পূর্ণ বিবরণ থাকে [.filename]#/cdrom/ports/*/*/pkg/DESCR# ফাইলে। এখানে `*` দুটো যথাক্রমে সফটওয়ারের ধরন ও নামের পরিবর্তে ব্যবহৃত হচ্ছে। - -সিডিরম থেকে পোর্ট ইনস্টল করার জন্য হ্যান্ডবুকে যে বর্ণনা রয়েছে তা যদি আপনার কাছে বেশ জটিল মনে হয় তবে এই সংক্ষিপ্ত বর্ণনাটি আপনার কাজে আসতে পারেঃ - -যে পোর্টটি ইনস্টল করবেন তা প্রথমে খুজে বের করুন। মনে করুন পোর্টটির নাম Kermit। সিডিরমের ভেতর Kermit এর জন্য একটি ডিরেক্টরি থাকবে। এই ডিরেক্টরিকে [.filename]#/usr/local# ডিরেক্টরিতে কপি করুন ( যেসকল সফটওয়ার সিস্টেমের সকল ব্যবহারকারীই চালাবে সেগুলো ইনস্টল করার জন্য [.filename]#/usr/local# একটি ভাল জায়গা)ঃ - -[source,shell] -.... -# cp -R /cdrom/ports/comm/kermit /usr/local -.... - -এর ফলে সিডিরমের kermit সাবডিরেক্টরির সব ফাইলই [.filename]#/usr/local/kermit# ডিরেক্টরিতে কপি হবে। - -আপনার সিস্টেমে [.filename]#/usr/ports/distfiles# নামে কোন ডিরেক্টরি না থাকলে `mkdir` কমান্ডের সাহায্যে তা তৈরী করুন। এখন [.filename]#/cdrom/ports/distfiles# ডিরেক্টরিতে আপনার প্রয়োজনীয় পোর্ট ফাইলটি আছে কিনা তা দেখুন। যদি থাকে, তবে তা [.filename]#/usr/ports/distfiles# ডিরেক্টরিতে কপি করুন। FreeBSD'র নতুন সংস্করণগুলোতে অবশ্য এই কপি করার কাজটি স্বয়ংক্রিয়ভাবে হয় আর তাই আপনার ব্যবহৃত সংস্করণটি মোটামুটি নতুন হলে এই ধাপটি বাদ দিতে পারেন। জেনে রাখা ভাল যে, Kermit এর জন্য সিডিরমে কোন পোর্ট ফাইল থেকে না। - -এখন `cd` কমান্ড ব্যবহার করে [.filename]#/usr/local/kermit# ডিরেক্টরিতে প্রবেশ করুন। এখানে [.filename]#Makefile# নামে একটি ফাইল থাকবে। এবার লিখুন, - -[source,shell] -.... -# make all install -.... - -সিডিরম বা [.filename]#/usr/ports/distfiles# ডিরেক্টরিতে যদি প্রয়োজনীয় কম্প্রেসকৃত পোর্ট ফাইল না থাকে, তবে FTP ব্যবহার করে এসময় তা আনা হবে। যদি [.filename]#/usr/ports/distfiles# ডিরেক্টরিতে সংশ্লিষ্ট ফাইল না থাকে এবং নেটওয়ার্কও সচল না থাকে তবে অন্য কোন কম্পিউটার থেকে পোর্ট ফাইলটি ডাউনলোড করে ফ্লপিতে করে নিয়ে আসতে হবে অথবা আপনার কম্পিউটারের ডস পার্টিশনে প্রথমে কপি করে পরে তা [.filename]#/usr/ports/distfiles#-এ কপি করতে হবে। যদি ডস ব্যবহার করে পোর্ট ফাইলটি ডাউনলোড করতে চান তবে উক্ত পোর্টের [.filename]#Makefile# পড়ে (`cat`, `more` বা `view` কমান্ডের সাহায্যে) জেনে নিতে হবে যে কোন সাইট থেকে ফাইলটি ডাউনলোড করা যায়। ডস থেকে ডাউনলোড করা হলে ফাইলের নাম ছোট হয়ে যাবে। তাই [.filename]#/usr/ports/distfiles#-এ কপি করার পর ফাইলটিকে প্রকৃত নামে পরিবর্তন করতে হবে (`mv` কমান্ড ব্যবহার করে) যেন পরবর্তীতে তা মূল নামেই খুঁজে পাওয়া যায় (FTP ব্যবহার করতে চাইলে বাইনারি মোডে ডাউনলোড করুন)। এখন [.filename]#/usr/local/kermit#-এ প্রবেশ করে যে ডিরেক্টরিতে [.filename]#Makefile# আছে তা খুজে বের করুন এবং `make all install` কমান্ডটি প্রয়োগ করুন। - -কোন পোর্ট বা প্যাকেজ ইনস্টল করার সময় আরেকটি ব্যাপার যা ঘটে তা হল সংশ্লিষ্ট সফটওয়ারটি ছাড়াও অন্যান্য এক বা একাধিক সফটওয়ার ইনস্টলেশনের প্রয়োজনীয়তা। যদি ইনস্টলেশন প্রক্রিয়াটি can't find unzip বা এধরনের কোন লেখা দেখিয়ে বন্ধ হয়ে যায়, তবে প্রথমে unzip এর প্যাকেজ বা পোর্ট ইনস্টল করে তারপর সংশ্লিষ্ট সফটওয়ারটি ইনস্টল করতে হবে। - -ইনস্টলেশন সম্পন্ন হলে `rehash` কমান্ডটি ব্যবহার করুন। এর ফলে FreeBSD তার path এ অবস্থিত ফাইলগুলোর নাম নতুন করে জানতে পারবে। যদি `which` ও `whereis` কমান্ড চালালে ঘনঘন path not found দেখতে পান তবে home ডিরেক্টরির [.filename]#.cshrc# ফাইলে path এর অন্তর্গত ডিরেক্টরির তালিকাতে নতুন কিছু ডিরেক্টরির নাম যোগ করতে পারেন। ইউনিক্স ও ডস উভয়টিতেই path এর ভূমিকা অনুরূপ; বে ইউনিক্সে নিরাপত্তার খাতিরে বর্তমান ডিরেক্টরি নিজে থেকে path এর অন্তর্ভুক্ত হয় না। যদি বর্তমান ডিরেক্টরিতে অবস্থিত কোন কমান্ড ব্যবহার করতে চান, তবে কমান্ডের পূর্বে [.filename]#./# যোগ করতে হবে। এক্ষেত্রে লক্ষ্য রাখতে হবে যেন slash ও কমান্ডের মাঝে কোন space না থাকে। - -আপনি ইচ্ছা করলে Netscape এর সর্বশেষ সংস্করণ তার FTP সাইট থেকে ডাউনলোড করতে পারেন। তবে Netscape চালানোর জন্য X Window থাকতে হবে। এখন FreeBSD'র জন্য Netscape এর একটি পৃথক সংস্করণ রয়েছে; তাই ডাউনলোডের পূর্বে এই সংস্করণটির কথা বিশেষভাবে মনে রাখবেন। ডাউনলোডের পর প্রথমে `gunzip filename` ও তারপর `tar xvf filename` কমান্ড লিখুন। এরপর বাইনারি ফাইলটিকে [.filename]#/usr/local/bin# অথবা সাধারণত বাইনারি ফাইল রাখা হয় এরকম কোন ডিরেক্টরিতে রাখুন, `rehash` কমান্ড দিন এবং তারপর প্রত্যেক ব্যবহারকারীর home ডিরেক্টরিস্থিত [.filename]#.cshrc# অথবা সমগ্র সিস্টেমের জন্য csh শেলের স্টার্টআপ ফাইল [.filename]#/etc/csh.cshrc#-এ নিচের লাইনগুলো লিখুনঃ - -[.programlisting] -.... -setenv XKEYSYMDB /usr/X11R6/lib/X11/XKeysymDB -setenv XNLSPATH /usr/X11R6/lib/X11/nls -.... - -এখানে ধরে নেয়া হয়েছে যে [.filename]#XKeysymDB# ফাইল ও [.filename]#nls# ডিরেক্টরি উভয়ই [.filename]#/usr/X11R6/lib/X11# ডিরেক্টরিতে অবস্থিত। যদি এগুলো এই ডিরেক্টরিতে না থেকে তবে খুজে বের করে [.filename]#/usr/X11R6/lib/X11# ডিরেক্টরিতে কপি করে দিন। - -ইতিপূর্বে যদি সিডিরম থেকে Netscape এর পোর্ট ইনস্টল করে থাকেন, তবে [.filename]#/usr/local/bin/netscape# এর স্থলে Netscape এর নতুন বাইনারি ফাইলটিকে রাখবেন না। [.filename]#/usr/local/bin/netscape# হল একটি শেল স্ক্রিপ্ট যা বেশ কিছু Environment Variable এর মান নির্ধারণ করে । বরং নতুন বাইনারি ফাইলটির নাম পরিবর্তন করে [.filename]#netscape.bin# রাখুন এবং পুরনো বাইনারি ফাইলটিকে সরিয়ে ফেলুন। পুরনো বাইনারি ফাইলটির নাম হল [.filename]#/usr/local/netscape/netscape# । - -== কাজের পরিবেশ - -শেল হল আপনার কাজের পরিবেশের সর্বাপেক্ষা গুরুত্বপূর্ণ অংশ। সাধারণত ডস-এ যে শেলটি ব্যবহৃত হয় তার নাম command.com । কমান্ড লাইনে যেসব কমান্ড লেখা হয়, শেল তা থেকে আপনি কি করতে চান তা বুঝতে পারে ও অপারেটিং সিস্টেমকে জানায়। এছাড়া শেলে ব্যবহারের জন্য শেল স্ক্রিপ্টও লেখা যায় যা অনেকটা ডস-এর ব্যাচ ফাইল এর মতই। শেল স্ক্রিপ্টে অনেকগুলো কমান্ড লেখা থাকে এবং ব্যবহারকারীর হস্তক্ষেপ ছাড়াই কমান্ডগুলো চালানো হয়। - -FreeBSD'তে প্রথম থেকেই csh ও sh নামে দুটি শেল ইনস্টল করা থাকে। কমান্ড লাইন থেকে কাজকর্মের জন্য csh শেল ভাল, তবে শেল স্ক্রিপ্ট লেখা উচিত্‍ sh (বা bash) শেলের জন্য। এমুহূর্তে কি শেল ব্যবহার করছেন তা জানতে চাইলে `echo $SHELL` কমান্ডটি ব্যবহার করুন। - -শেল হিসেবে csh বেশ ভাল কিন্তু tcsh শেল csh এর সব কাজই করতে পারে এবং এটির আরো কিছু অতিরিক্ত সুবিধা আছে। tcsh শেল ব্যবহার করলে kbd:[Arrow Key] চেপে পূর্বে ব্যবহৃত কমান্ডগুলো খুজে বের করা ও এডিট করা যায়। এই শেলে ফাইলের নামের প্রথম কিছু অংশ লিখে kbd:[tab] চাপলে (csh এর ক্ষেত্রে Esc) নামের অবশিষ্ট অংশ নিজে থেকেই লেখা হয়ে যায়। এছাড়া `cd -` লিখে সর্বশেষ ব্যবহৃত ডিরেক্টরিতে সরাসরি চলে যাওয়া যায়। এই শেলটির কমান্ড প্রম্পটকেও বেশ সহজেই পরিবর্তন করা যায়। সব মিলিয়ে tcsh শেলে কাজ করা বেশ সুবিধাজনক। - -পরবর্তি তিনটি ধাপে একটি নতুন শেল ইনস্টল করার পদ্ধতি বর্ণিত হলঃ - -. অন্যান্য সব পোর্ট বা প্যাকেজের মতই যে শেলটি ব্যবহার করতে চান তার পোর্ট বা প্যাকেজ ইনস্টল করুন। এখন প্রথমে `rehash` কমান্ড দিন ও পরে `which tcsh` (tcsh শেল ইনস্টলের ক্ষেত্রে) কমান্ড দিয়ে শেলটি আসলেই ইনস্টল হয়েছে কিনা তা নিশ্চিত হন । -. root হিসেবে [.filename]#/etc/shells# ফাইলটি এডিট করুন। ফাইলের শেষে নতুন শেলটির জন্য একটি লাইন যোগ করুন, এক্ষেত্রে যা হল [.filename]#/usr/local/bin/tcsh# । এখন ফাইলটি সেভ করুন। (কিছু পোর্ট ইনস্টল হওয়ার সময় নিজে থেকেই এই পরিবর্তনগুলো সম্পন্ন হয়) -. স্থায়ীভাবে tcsh শেল ব্যবহার করতে চাইলে `chsh` কমান্ড ব্যবহার করুন। আর সাময়িকভাবে ব্যবহার করার ইচ্ছা থাকলে কমান্ড হিসেবে `tcsh` লিখুন। এর ফলে নতুন করে লগ ইন না করেই tcsh শেল ব্যবহার করতে পারবেন। - -[NOTE] -==== -বিভিন্ন ইউনিক্স বিশেষ করে FreeBSD'র পুরনো সংস্করণগুলোতে root এর শেল হিসেবে sh বা csh ব্যতীত অন্য কিছু ব্যবহারকরাটা বেশ বিপদজনক। কারণ অন্য কোন শেল ব্যবহার করলে, যখন single user mode এ কম্পিউটার ব্যবহারের প্রয়োজন হয়, তখন হয়তো কোন শেলই থাকবে না।দ্জতাই root এর শেল হিসেবে tcsh ব্যবহার করতে চাইলে `su -m` কমান্ড ব্যবহার করুন। এর ফলে tcsh শেল root এর Environment এর অংশ হয়ে যায়। আপনার home ডিরেক্টরির [.filename]#.tcshrc# ফাইলে alias রূপে এই লাইনটি ব্যবহার করে স্থায়ীভাবে এধরনের ব্যবস্থা করতে পারেন, - -[.programlisting] -.... -alias su su -m -.... - -==== - -tcsh শেল চালু হওয়ার সময় csh এর মতই [.filename]#/etc/csh.cshrc# ও [.filename]#/etc/csh.login# ফাইলদুটো পড়ে থাকে। যদি home ডিরেক্টরিতে কোন [.filename]#.tcshrc# ফাইল না থাকে তবে সেখানকার [.filename]#.login# ও [.filename]#.cshrc# ফাইলদুটোও tcsh পড়বে। [.filename]#.tcshrc# ফাইল তৈরীর একটি সহজ উপায় হল সরাসরি [.filename]#.cshrc#'কে [.filename]#.tcshrc#'তে কপি করা। - -আপনার ব্যবহৃত শেলের প্রম্পট কিরকম দেখাবে, tcsh শেল ইনস্টলের পর আপনি এখন তা নির্ধারণ করতে পারেন। tcsh এর ম্যানুয়াল পেজে এসম্পর্কে বিস্তারিত বলা হয়েছে। এখানে প্রম্পট নির্ধারণের জন্য একটি লাইন উল্লেখ করা হল। [.filename]#.tcshrc# ফাইলে এই লাইনটি লিখলে প্রম্পট থেকে জানা যাবে - এ পর্যন্ত ব্যবহৃত কমান্ড, সময় ও বর্তমান ডিরেক্টরির নাম। এছাড়া tcsh শেল ব্যবহার করলে সবসময়ই প্রম্পটের শেষে root এর জন্য `#` এবং সাধারণ ব্যবহারকারীর জন্য `>` দেখা যাবে। লাইনটি হলঃ - -[.programlisting] -.... -set prompt "%h %t %~ %# " -.... - -যদি [.filename]#.tcshrc# ফাইলে কোন "set prompt" লাইন থাকে, তবে সেখানে এই লাইনটি লিখুন। আর যদি না থাকে, তবে "if($?prompt) then" এর নিচে লাইনটি যোগ করুন। পুরনো লাইন থাকলে তা _ comment out_ করে দিন। এর ফলে পুরনো লাইনটিকে সহজেই ভবিষ্যতে ব্যবহার করতে পারবেন। এই পরিবর্তনগুলো করার সময় উল্লেখিন space ও quote গুলো ব্যবহার করতে ভুলবেন না। `source .tcshrc` কমান্ড প্রয়োগ করলে শেল নতুন করে [.filename]#.tcshrc# ফাইলটি পড়বে। - -সকল Environment Variable এর মান দেখতে হলে `env` কমান্ড ব্যবহার করুন। ফলস্বরূপ যে মানগুলো দেখতে পাবেন, তার মধ্যে উল্লেখযোগ্য হল ডিফল্ট এডিটর, পেজার, টার্মিনালের ধরন ইত্যাদি। যদি আপনি দূরবর্তী কোন কম্পিউটার থেকে লগ ইন করেন এবং টার্মিনালের অক্ষমতার কারণে কোন একটি প্রোগ্রাম চালাতে না পারেন, তবে খুবই কাজের একটি কমান্ড হল `setenv TERM vt100` । - -== অন্যান্য - -সিডিরম আনমাউন্ট করতে হলে root হিসেবে `/sbin/umount /cdrom` কমান্ড ব্যবহার করুন এবং সিডিরম বের করে নিন। আর সিডিরম মাউন্ট করার জন্য ট্রেতে ডিস্ক ভরে `/sbin/mount_cd9660 /dev/cd0a /cdrom` কমান্ড ব্যবহার করুন। এখানে হল সিডিরম ড্রাইভের প্রতিনিধিত্বকারী ডিভাইস ফাইলের নাম। FreeBSD'র নতুন সংস্করণগুলোতে সিডিরম মাউন্ট করার জন্য শুধু `/sbin/mount /cdrom` লেখাই যথেষ্ট। - -হার্ডডিস্কে স্থান সংকুলান না হলে live filesystem নামের FreeBSD'র দ্বিতীয় সিডিরমটি ব্যবহার করতে পারেন। Live filesystem এ কি থাকবে না থাকবে তা বিভিন্ন সংস্করণের ক্ষেত্রে বিভিন্ন হয়। আপনি হয়তো সিডিরম থেকে গেমস্‌ চালাতে পারেন। এজন্য অবশ্য `lndir` কমান্ড ব্যবহার করতে হবে যা X Window সিস্টেমের সাথে ইনস্টল হয়। সাধারণত ধরে নেয়া হয় যে প্রয়োজনীয় ফাইলগুলো [.filename]#/usr# ও তার বিভিন্ন সাবডিরেক্টরিতে থাকে। কিন্তু এক্ষেত্রে [.filename]#/cdrom# এর ভেতর ফাইলগুলো থাকায় `lndir` কমান্ড ব্যবহার করে বিভিন্ন প্রোগ্রামগুলোকে তাদের প্রয়োজনীয় ফাইলের প্রকৃত অবস্থান জানিয়ে দিতে হবে। ``lndir``-এর ব্যাপারে বিস্তারিত জানার জন্য `man lndir` কমান্ড দিয়ে `lndir` এর ম্যানুয়াল পেজ পড়ুন। - -== মন্তব্য - -আপনি যদি এই গাইডটি পড়ে থাকেন তবে আমি জানতে খুবই আগ্রহী যে, লেখাটি কোথাও অস্পষ্ট মনে হয়েছে কিনা কিংবা কোন বিষয় বাদ পড়েছে বলে আপনার মনে হয় কিনা। লেখাটি আপনার উপকারে আসলে তাও জানাতে পারেন। পরিশেষে, চমত্‍কার পরামর্শের জন্য আমি বিশেষভাবে ধন্যবাদ জানাই, জন ফাইবার ও সানি-স্টোনি ব্রুক এর কম্পিউটার বিজ্ঞানের অধ্যাপক ইউজিন ডব্লিউ স্টার্ক কে। - -অ্যানেলিসএন্ডারসন mailto:andrsnATandrsn.stanford.edu[andrsnATandrsn.stanford.edu] 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,26 @@ :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/{{% 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 +126,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,25 @@ :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/{{% 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 +65,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 +102,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 +110,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 +243,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,26 @@ :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/{{% 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,25 @@ :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/{{% 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 +71,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 +375,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 +407,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 +566,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 +595,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,25 @@ :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/{{% 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 +50,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,25 @@ :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/{{% 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 +50,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 +89,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 +114,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 +123,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 +198,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 +249,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 +331,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,25 @@ :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/{{% 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,25 @@ :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/{{% 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 +317,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,25 @@ :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/{{% 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 +75,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,26 @@ :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/{{% 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,44 @@ :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/{{% 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 +59,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,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: -: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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +48,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 +91,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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +358,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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,39 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +80,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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,45 @@ :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/{{% 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 +74,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 +101,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 +137,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 +156,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 +172,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 +184,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 +192,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 +335,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 +397,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 +409,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 +417,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 +512,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 +687,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 +717,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 +815,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 +824,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 +834,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 +842,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 +863,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 +916,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 +946,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 +1053,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 +1119,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 +1201,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 +1336,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 +1352,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 +1400,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 +1465,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 +1563,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 +1777,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 +1843,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 +1883,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 +1896,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 +1904,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 +1919,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 +2078,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 +2128,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 +2149,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 +2324,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 +2433,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 +2443,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 +2500,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 +2570,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 +2610,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 +2741,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 +2763,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 +2907,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,38 @@ :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/{{% 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 +52,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,39 @@ [[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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +115,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,41 @@ :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/{{% 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 +57,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +283,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,39 @@ [[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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +65,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +1126,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +91,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 +177,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 +198,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +330,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,39 @@ [[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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +1108,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,45 @@ [[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/{{% 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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +615,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 +655,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 +1139,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,32 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +719,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +1046,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +1050,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,33 @@ :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/{{% 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 +49,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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +691,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 +708,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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,37 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +62,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 +94,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,45 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +199,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 +210,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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +2106,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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,26 @@ :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/{{% 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,25 @@ :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/{{% 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 +64,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 +101,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 +109,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 +242,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,26 @@ :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/{{% 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,25 @@ :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/{{% 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 +137,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,26 @@ :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/{{% 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 +305,7 @@ options GEOM_JOURNAL # Θα πρέπει να προσθέσετε αυτή τη γραμμή .... -Μεταγλωττίστε και επανεγκαταστήστε τον πυρήνα σας χρησιμοποιώντας τις σχετικές link:{handbook}#kernelconfig[οδηγίες στο Εγχειρίδιο του FreeBSD.] +Μεταγλωττίστε και επανεγκαταστήστε τον πυρήνα σας χρησιμοποιώντας τις σχετικές extref:{handbook}kernelconfig[οδηγίες στο Εγχειρίδιο του FreeBSD., kernelconfig] Μην ξεχάσετε να αφαιρέσετε την αντίστοιχη καταχώρηση "load" από το αρχείο [.filename]#/boot/loader.conf# αν την είχατε χρησιμοποιήσει προηγουμένως. @@ -433,7 +426,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,25 @@ :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/{{% 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 +162,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,25 @@ :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/{{% 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 +50,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 +93,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 +118,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 +224,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 +260,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 +318,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 +393,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,31 @@ :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/{{% 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 +91,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 +160,7 @@ [[bikeshed]] == Τι είναι το "Bikeshed"; -Κυριολεκτικά το `bikeshed` είναι ένα μικρό εξωτερικό καταφύγιο όπου κάποιος μπορεί να φυλάξει το δίτροχο του (υπόστεγο ποδηλάτων). Στην ορολογία του FreeBSD ωστόσο, η λέξη αυτή χρησιμοποιείται για να αναφερόμαστε σε θέματα συζήτησης που είναι τόσο απλά ώστε (σχεδόν) καθένας να μπορεί να εκφέρει μια γνώμη για αυτά - και πολύ συχνά συμβαίνει ακριβώς αυτό. Η γέννηση αυτού του όρου εξηγείται με περισσότερη λεπτομέρεια σε link:{faq}#BIKESHED-PAINTING[αυτό το κείμενο]. Θα πρέπει να κατανοείτε την έννοια αυτού του όρου πριν αρχίσετε να στέλνετε μηνύματα σε οποιαδήποτε λίστα του FreeBSD. +Κυριολεκτικά το `bikeshed` είναι ένα μικρό εξωτερικό καταφύγιο όπου κάποιος μπορεί να φυλάξει το δίτροχο του (υπόστεγο ποδηλάτων). Στην ορολογία του FreeBSD ωστόσο, η λέξη αυτή χρησιμοποιείται για να αναφερόμαστε σε θέματα συζήτησης που είναι τόσο απλά ώστε (σχεδόν) καθένας να μπορεί να εκφέρει μια γνώμη για αυτά - και πολύ συχνά συμβαίνει ακριβώς αυτό. Η γέννηση αυτού του όρου εξηγείται με περισσότερη λεπτομέρεια σε extref:{faq}[αυτό το κείμενο, BIKESHED-PAINTING]. Θα πρέπει να κατανοείτε την έννοια αυτού του όρου πριν αρχίσετε να στέλνετε μηνύματα σε οποιαδήποτε λίστα του FreeBSD. Πιο γενικά, το bikeshed είναι ένα θέμα το οποίο τείνει να δημιουργεί περισσότερες παράπλευρες συζητήσεις και λεκτικούς διαξιφισμούς, αν δεν έχετε διαβάσει σχετικά με την προϊστορία του. @@ -173,7 +170,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,25 @@ :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/{{% 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,25 @@ :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/{{% 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 +306,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,25 @@ :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/{{% 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 +71,7 @@ + Όταν ένα πακέτο είναι υπό την επίβλεψη κάποιου, συνήθως δεν είναι ιδιαίτερα χρήσιμες οι αναφορές που απλώς ανακοινώνουν μια καινούρια έκδοση από τον συγγραφέα του πηγαίου κώδικα του πακέτου. Συνήθως το ξέρει ήδη ο υπεύθυνος του πακέτου για το FreeBSD, ή έχει συνεργαστεί με τον συγγραφέα του πηγαίου κώδικα για τη νέα έκδοση, ή δοκιμάζει το πακέτο για να δει ότι όλα εξακολουθούν να δουλεύουν, κοκ. + -Όπως και να 'χει, είναι καλή ιδέα να ακολουθήσετε τη διαδικασία από το link:{porters-handbook}#port-upgrading[Porter's Handbook]. +Όπως και να 'χει, είναι καλή ιδέα να ακολουθήσετε τη διαδικασία από το extref:{porters-handbook}[Porter's Handbook, port-upgrading]. Ένα bug που δεν μπορεί κανείς να το αναπαράγει είναι πολύ δύσκολο να διορθωθεί. Αν το bug εμφανίστηκε μια φορά μόνο και δεν μπορείτε να το αναπαράγετε εσείς, και φαινομενικά δεν εμφανίζεται σε κανέναν άλλο, είναι πολύ μικρές οι πιθανότητες να μπορεί κάποιος προγραμματιστής να το ανακαλύψει και να καταλάβει τί είναι αυτό που προκαλεί το λάθος. Αυτό δεν σημαίνει πως δεν συμβαίνει, αλλά σημαίνει πως η πιθανότητα να οδηγήσει η αναφορά σας στην λύση του προβλήματος είναι πάρα πολύ μικρή, και μάλλον είναι καλύτερο να σταματήσετε να ασχολείστε με το θέμα. Ακόμα χειρότερα, κάποιες φορές αυτού του είδους τα προβλήματα οφείλονται σε προβλήματα του υλικού (χαλασμένους σκληρούς δίσκους ή επεξεργαστές που υπερθερμαίνονται). Πρέπει πάντοτε πριν στέλνετε μια αναφορά προβλήματος, όταν φυσικά είναι δυνατόν να γίνει κάτι τέτοιο, να προσπαθείτε να αποκλείσετε τέτοιες περιπτώσεις. @@ -83,7 +83,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 +92,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 +140,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 +271,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,25 @@ :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/{{% 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 +179,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 +281,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 +349,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,56 @@ --- -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/{{% 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 +76,7 @@ Το FreeBSD χρησιμοποιείται από εταιρίες, παροχείς υπηρεσιών Internet (ISPs), ερευνητές, επαγγελματίες της Πληροφορικής, φοιτητές και οικιακούς χρήστες από όλο τον κόσμο, στη δουλειά τους, στην εκπαίδευση και για αναψυχή. -Για περισσότερες λεπτομέρειες σχετικά με το FreeBSD, παρακαλούμε διαβάστε το link:{handbook}[Εγχειρίδιο του FreeBSD]. +Για περισσότερες λεπτομέρειες σχετικά με το FreeBSD, παρακαλούμε διαβάστε το extref:{handbook}[Εγχειρίδιο του FreeBSD]. === Ποιος είναι ο σκοπός του FreeBSD Project; @@ -114,7 +99,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 +131,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 +150,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 +168,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 +180,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 +188,7 @@ Η εντολή man:send-pr[1] μπορεί να χρησιμοποιηθεί για την υποβολή αναφορών προβλημάτων, καθώς και αιτήσεων για αλλαγές, μέσω ηλεκτρονικού ταχυδρομείου. Εναλλακτικά, μπορείτε να χρησιμοποιήσετε την αντίστοιχη δυνατότητα http://www.freebsd.org/send-pr/[υποβολής αναφορών προβλημάτων μέσω της διεπαφής web] με τη βοήθεια ενός προγράμματος φυλλομετρητή. -Πριν υποβάλετε μια αναφορά προβλήματος, παρακαλούμε διαβάστε το link:{problem-reports}[Γράφοντας Αναφορές Προβλημάτων για το FreeBSD], ένα άρθρο για το πως να γράφετε καλές αναφορές προβλημάτων. +Πριν υποβάλετε μια αναφορά προβλήματος, παρακαλούμε διαβάστε το extref:{problem-reports}[Γράφοντας Αναφορές Προβλημάτων για το FreeBSD], ένα άρθρο για το πως να γράφετε καλές αναφορές προβλημάτων. === Τι άλλες πηγές πληροφοριών υπάρχουν; @@ -390,11 +375,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 +418,7 @@ * doc/ * src/ssys.* -Πλήρεις οδηγίες σχετικά με τη διαδικασία καθώς και περισσότερες πληροφορίες σχετικά με γενικά προβλήματα κατά την εγκατάσταση μπορείτε να βρείτε στο link:{handbook}#install/[Κεφάλαιο του Εγχειριδίου σχετικά με την εγκατάσταση του FreeBSD]. +Πλήρεις οδηγίες σχετικά με τη διαδικασία καθώς και περισσότερες πληροφορίες σχετικά με γενικά προβλήματα κατά την εγκατάσταση μπορείτε να βρείτε στο extref:{handbook}install/[Κεφάλαιο του Εγχειριδίου σχετικά με την εγκατάσταση του FreeBSD, install]. === Τι μπορώ να κάνω αν το image της δισκέτας δεν χωράει σε μια μόνο δισκέτα; @@ -448,11 +433,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 +451,7 @@ Τη δεδομένη στιγμή, δεν υπάρχει τρόπος να φτιάξετε _απλώς_ μια προσαρμοσμένη δισκέτα εγκατάστασης. Θα πρέπει να δημιουργήσετε ολόκληρη νέα έκδοση, η οποία θα περιλαμβάνει και την προσαρμοσμένη δισκέτα εγκατάστασης σας. -Για να δημιουργήσετε μια προσαρμοσμένη έκδοση, ακολουθήστε τις οδηγίες στο άρθρο σχετικά με την link:{releng}[Οργάνωση Εκδόσεων]. +Για να δημιουργήσετε μια προσαρμοσμένη έκδοση, ακολουθήστε τις οδηγίες στο άρθρο σχετικά με την extref:{releng}[Οργάνωση Εκδόσεων]. === Μπορούν να συνυπάρξουν τα Windows(R) με το FreeBSD; @@ -582,7 +567,7 @@ === Μπορώ να εγκαταστήσω το FreeBSD στο φορητό μου χρησιμοποιώντας PLIP (Parallel Line IP, IP μέσω Παράλληλης Θύρας); -Ναι. Χρησιμοποιήστε τυποποιημένο καλώδιο τύπου Laplink. Αν χρειάζεται, διαβάστε το link:{handbook}#network-plip/[τμήμα PLIP του Εγχειριδίου] για λεπτομέρειες σχετικές με δικτύωση μέσω παράλληλης θύρας. +Ναι. Χρησιμοποιήστε τυποποιημένο καλώδιο τύπου Laplink. Αν χρειάζεται, διαβάστε το extref:{handbook}advanced-networking/[τμήμα PLIP του Εγχειριδίου, network-plip] για λεπτομέρειες σχετικές με δικτύωση μέσω παράλληλης θύρας. === Τι γεωμετρία να χρησιμοποιήσω για το σκληρό μου δίσκο; @@ -969,7 +954,7 @@ ==== Ποιες κάρτες πολλαπλών σειριακών θυρών υποστηρίζονται από το FreeBSD; -Υπάρχει μια λίστα για αυτές στην ενότητα link:{handbook}#install/[διάφορων συσκευών] του Εγχειριδίου. +Υπάρχει μια λίστα για αυτές στην ενότητα extref:{handbook}install/[διάφορων συσκευών, install] του Εγχειριδίου. Ακόμα φαίνεται ότι λειτουργούν και κάποιες κάρτες που είναι αντιγραφές επώνυμων μοντέλων, ειδικά όσες υποστηρίζουν ότι είναι συμβατές με τις αντίστοιχες τις AST. @@ -1009,7 +994,7 @@ ==== Ποιες άλλες συσκευές υποστηρίζονται από το FreeBSD; -Δείτε το link:{handbook}#install/[Εγχειρίδιο] για τη λίστα των υπόλοιπων συσκευών που υποστηρίζονται. +Δείτε το extref:{handbook}install/[Εγχειρίδιο, install] για τη λίστα των υπόλοιπων συσκευών που υποστηρίζονται. ==== Υποστηρίζει το FreeBSD διαχείριση ενέργειας για το φορητό μου υπολογιστή; @@ -1062,7 +1047,7 @@ device card 1 .... -Μεταγλωττίστε ξανά και εγκαταστήστε το νέο πυρήνα όπως περιγράφεται στην link:{handbook}#kernelconfig/[Ρύθμιση Πυρήνα του FreeBSD]. +Μεταγλωττίστε ξανά και εγκαταστήστε το νέο πυρήνα όπως περιγράφεται στην extref:{handbook}kernelconfig/[Ρύθμιση Πυρήνα του FreeBSD, kernelconfig]. == Αντιμετώπιση Προβλημάτων @@ -1107,7 +1092,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 +1125,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 +1198,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 +1412,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 +1536,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 +1651,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 +1707,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 +1724,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 +2141,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 +2263,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 +2338,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 +2363,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 +2552,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 +2639,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 +2675,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 +3043,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 +3101,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 +3123,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 +3238,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 +3289,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 +3331,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 +3434,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 +3484,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 +3505,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 +3687,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 +4298,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 +4332,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 +4352,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 +4481,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 +4501,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 +4519,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 +4539,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 +4725,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,33 @@ :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/{{% 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 +48,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +1834,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,39 @@ [[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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +116,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,34 @@ :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/{{% 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 +53,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +301,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 +386,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,39 @@ [[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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +59,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +643,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +2286,7 @@ [NOTE] ==== -Αν ενδιαφέρεστε να δημιουργήσετε μια εξειδικευμένη έκδοση του FreeBSD, δείτε το link:{releng}[Release Engineering Article]. +Αν ενδιαφέρεστε να δημιουργήσετε μια εξειδικευμένη έκδοση του FreeBSD, δείτε το extref:{releng}[Release Engineering Article]. ==== [[install-ftp]] @@ -2400,7 +2397,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +58,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 +98,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 +195,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 +216,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,39 @@ [[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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +983,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 +1418,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,43 @@ [[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/{{% 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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +414,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 +819,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,32 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/network-servers/ -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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +1167,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,26 @@ :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/{{% 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,25 @@ :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/{{% 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 +178,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 +198,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 +278,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 +338,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 +357,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 +377,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,25 @@ :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/{{% 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] @@ -290,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; + @@ -302,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 @@ -510,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 +665,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 +2480,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 +3204,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 +3236,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 +3390,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 +3682,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 +3808,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 +3842,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 +3851,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,25 @@ :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/{{% 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 +81,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 +124,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 +144,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 +156,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 +285,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 +336,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 +366,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 +555,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 +574,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,30 @@ :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/{{% 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 +111,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,29 @@ :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/{{% 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,29 @@ :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/{{% 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,28 @@ :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/{{% 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 +95,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,29 @@ :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/{{% 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,25 @@ :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/{{% 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] @@ -146,7 +151,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-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 @@ -154,7 +159,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,27 @@ :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/{{% 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,32 @@ = 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/{{% 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,25 @@ :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/{{% 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 +77,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 +391,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 +426,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 +591,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 +620,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,25 @@ :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/{{% 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 +57,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,25 @@ :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/{{% 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 +370,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 +503,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,25 @@ :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/{{% 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 +368,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,25 @@ :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/{{% 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 +142,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,26 @@ :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/{{% 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,25 @@ :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/{{% 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 +55,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,25 @@ :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/{{% 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,25 @@ :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/{{% 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 +53,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 +64,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 +104,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 +113,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 +132,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 +147,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 +230,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 +289,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 +373,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,25 @@ :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/{{% 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] @@ -110,7 +112,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. @@ -188,7 +190,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. @@ -200,7 +202,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,25 @@ :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/{{% 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 +248,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 +271,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,26 @@ :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/{{% 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 @@ -17,6 +17,29 @@ :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/{{% 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 @@ -584,17 +607,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!: @@ -608,17 +621,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!: @@ -633,17 +636,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,31 @@ :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/{{% 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,25 @@ :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/{{% 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 +79,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,25 @@ :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/{{% 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 +511,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,25 @@ :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/{{% 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 +77,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 +93,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 +108,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 +265,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 +286,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,25 @@ :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/{{% 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 +586,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,25 @@ :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/{{% 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 +46,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 +65,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 +85,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 +163,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 +268,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 +384,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 +411,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,25 @@ :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/{{% 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 +232,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,25 @@ :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/{{% 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 +877,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,26 @@ :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/{{% 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 @@ -15,20 +15,25 @@ :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/{{% 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::[] ''' @@ -52,7 +57,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#. @@ -684,7 +689,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]] @@ -695,6 +700,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,25 @@ :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/{{% 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,30 @@ :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/{{% 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 +50,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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,33 @@ :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/{{% 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 +48,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,38 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,33 @@ :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[] 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/{{% 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 --- = A project model for the FreeBSD Project @@ -14,46 +15,32 @@ :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[] 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/{{% 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::[] ''' @@ -1209,7 +1196,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!: @@ -1234,28 +1221,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,30 @@ :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/{{% 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 +54,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,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: -: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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,33 @@ :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/{{% 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 +52,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,44 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +324,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,36 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +100,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 +695,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 +950,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,22 @@ :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/{{% 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 +62,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 +83,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 +128,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 +174,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 +192,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 +233,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 +247,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 +256,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 +394,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 +458,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 +474,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 +633,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 +838,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 +892,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 +1025,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 +1042,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 +1053,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 +1080,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 +1137,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 +1172,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 +1320,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 +1399,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 +1515,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 +1705,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 +1724,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 +1787,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 +1861,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 +2004,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 +2245,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 +2325,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 +2356,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 +2372,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 +2383,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 +2400,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 +2627,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 +2703,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 +2785,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 +2844,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 +3009,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 +3017,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 +3206,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,31 @@ :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/{{% 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 +58,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +229,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,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 +: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/{{% 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 +65,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +268,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +57,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 +272,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 +367,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 +376,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,30 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +50,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +242,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +103,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,31 @@ :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/{{% 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 +61,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,39 @@ [[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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +118,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,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 -: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/{{% 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 +64,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,37 @@ [[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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +330,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +487,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,39 @@ [[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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +76,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +1297,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,37 @@ [[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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +165,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 +788,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +99,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 +206,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 +243,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,39 @@ [[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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +593,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 +632,7 @@ - https://lists.freebsd.org/mailman/listinfo/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +1318,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,47 @@ [[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/{{% 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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +650,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 +715,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 +1326,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 +1334,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,30 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +882,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +1224,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,32 @@ :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/{{% 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,33 @@ :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/{{% 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 +51,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,35 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +1047,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 +1065,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 +2457,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 +2472,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,49 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +305,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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. @@ -4429,9 +4441,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +264,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,40 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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 +95,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 +103,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] @@ -127,7 +139,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: @@ -173,7 +185,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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,34 @@ :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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/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,26 @@ :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/{{% 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,25 @@ :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/{{% 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] @@ -161,7 +159,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 <>. @@ -179,7 +177,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. @@ -251,7 +249,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]. + @@ -296,7 +294,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 @@ -312,19 +310,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. @@ -332,4 +330,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 @@ -4,7 +4,6 @@ - author: Jordan Hubbard - author: Sam Lawrance - author: Mark Linimon -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "ieee", "general"] --- @@ -17,16 +16,26 @@ :sectnumlevels: 6 :source-highlighter: rouge :experimental: -:lang: es -:toc-title: Tabla de contenidos -:part-signifier: Parte -:chapter-signifier: Capítulo -:appendix-caption: Apéndice -:table-caption: Tabla -:figure-caption: Figura -:example-caption: Ejemplo - -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/{{% lang %}}/teams.adoc[] +include::shared/{{% lang %}}/mailing-lists.adoc[] +include::shared/{{% lang %}}/urls.adoc[] +:imagesdir: ../../../images/{images-path} +endif::[] +ifdef::backend-pdf,backend-epub3[] +include::../../../shared/asciidoctor.adoc[] +endif::[] +endif::[] + +ifndef::env-beastie[] +include::../../../../../shared/asciidoctor.adoc[] +endif::[] [.abstract-title] Resumen @@ -58,7 +67,7 @@ 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. . 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 link:{fdp-primer}#translations[FAQ de las traducciones] 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. +. 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]] @@ -91,7 +100,7 @@ Existen varias formas de ayudar a mantener la colección de ports actualizada y en buen funcionamiento: -* Encuentre algún software interesante o útil y link:{porters-handbook}[cree un port]. +* 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 <>. @@ -108,21 +117,21 @@ [[contrib-general]] === Informes de errores y comentarios generales -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 link:{handbook}#eresources-mail[Handbook de FreeBSD] para obtener más información sobre esta 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 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. -Consulte también link:{problem-reports}[este artículo] sobre cómo escribir buenos informes de problemas. +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 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 link:{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. +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 -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 link:{handbook}#current-stable[Handbook de FreeBSD] para obtener más información sobre cómo obtener y usar 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. 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. @@ -206,7 +215,7 @@ ==== Cómo adoptar un port -Primero, asegúrese de de comprender cuáles serán sus <>. Lea también el link:{porters-handbook}[Handbook del Porter]. _Por favor, no se comprometa con más de lo que crea que puede manejar cómodamente._ +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. @@ -246,7 +255,7 @@ Esta sección describe el proceso a seguir para mantener sus ports actualizados. -Esto es un resumen. Dispone de más información sobre la actualización de un port en el link:{porters-handbook}[Handbook del Porter]. +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] ==== @@ -270,11 +279,11 @@ . Enviar los cambios + -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 link:{problem-reports}[Cómo enviar informes de problemas de FreeBSD] para obtener más información sobre como escribir un PR correctamente. +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] ====== -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 link:{porters-handbook}#port-upgrading[actualización] del Handbook del Porter para 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 + @@ -406,9 +415,9 @@ [[resources]] === Recursos para maintainers y colaboradores de los ports -El link:{porters-handbook}[Handbook del Porter] es su guía de referencia para el sistema de ports. ¡Tengala a mano! +El extref:{porters-handbook}[Handbook del Porter] es su guía de referencia para el sistema de ports. ¡Tengala a mano! -El artículo link:{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 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. La https://bugs.freebsd.org/bugzilla/query.cgi[base de datos de informes de problemas]. @@ -418,7 +427,7 @@ 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]. -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 link:{porters-handbook}[Handbook del Porter] o pida consejo. +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. 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/]. 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,30 @@ :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/{{% 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 +111,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 +122,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 +131,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 +140,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 +149,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 +172,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 H