Skip to content

Commit

Permalink
add 9.18.0
Browse files Browse the repository at this point in the history
  • Loading branch information
perlang committed Feb 4, 2022
1 parent a29ef30 commit cf1cc27
Show file tree
Hide file tree
Showing 125 changed files with 24,089 additions and 26 deletions.
370 changes: 359 additions & 11 deletions LICENSE

Large diffs are not rendered by default.

33 changes: 18 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,28 @@

# 变化
* 从bind-9.16.4开始,ISC官方文档使用reStructuredText替代了以前使用的docbook5,构建工具也随之改为sphinx-doc,中文文档也对应做了改变。

# 构建环境
* 当前版本在 Fedora33 和 Windows 10 上成功构建。
* 构建需要的环境
* 当前版本在 Fedora33/34/35 上成功构建。
* 构建需要的软件
* python3
* sphinx-doc
* texlive
* 中文字体
* 中文字体(Fedora系统上可选google和adobe的字体。)

软件包:

.. code-block::
# dnf -y install python3-sphinx python3-sphinx-theme-alabaster python3-sphinx_rtd_theme

texlive-* (这个数量较多,如果缺少,构建时会有相应的错误提示。)

# 构建
make latexpdf
# 生成PDF文件

# 待改进
* 支持在 FreeBSD和macOS上的构建。主要问题是Makefile语法和字体的适配。
* 对configure的支持,因为改为reStructuredText,还需要更改相应的文件。
$ cd arm

$ make pdf

# 变化
* 从bind-9.16.4开始,ISC官方文档使用reStructuredText替代了以前使用的docbook5,构建工具也随之改为sphinx-doc,中文文档也对应做了改变。
* 从bind-9.16.11开始,增加了第九章《DNSSEC指南》。

# 其它
* 经过从9.16.3改格式到9.16.4,重新浏览核对了一遍文档,发现错误疏漏还是不少,今后有空再慢慢修订。
* 欢迎任何建议和指正。
* 欢迎对本项目有兴趣的小伙伴加入!

联系方式: sunguonian@yahoo.com
28 changes: 28 additions & 0 deletions branches/9.18.0/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@

# 构建环境
* 当前版本在 Fedora33/34/35 上成功构建。
* 构建需要的软件
* python3
* sphinx-doc
* texlive
* 中文字体(Fedora系统上可选google和adobe的字体。)

软件包:

.. code-block::
# dnf -y install python3-sphinx python3-sphinx-theme-alabaster python3-sphinx_rtd_theme

texlive-* (这个数量较多,如果缺少,构建时会有相应的错误提示。)

# 生成PDF文件

$ cd arm

$ make pdf

# 变化
* 从bind-9.16.4开始,ISC官方文档使用reStructuredText替代了以前使用的docbook5,构建工具也随之改为sphinx-doc,中文文档也对应做了改变。
* 从bind-9.16.11开始,增加了第九章《DNSSEC指南》。

# 其它
* 欢迎任何建议和指正。
29 changes: 29 additions & 0 deletions branches/9.18.0/arm/Makefile
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# Minimal makefile for Sphinx documentation
#

# You can set these variables from the command line, and also
# from the environment for the first two.
SPHINXOPTS ?= -a -b latex -v
SPHINXBUILD ?= sphinx-build
SOURCEDIR = .
BUILDDIR = _build

# Put it first so that "make" without argument is like "make help".
help:
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

.PHONY: help Makefile

RELEASE_DATE=`date -r conf.py +"%Y-%m-%d"`

# Catch-all target: route all unknown targets to Sphinx using the new
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
#%: Makefile
pdf:
$(SPHINXBUILD) $(SPHINXOPTS) -D today=${RELEASE_DATE} . "$(BUILDDIR)"
(./chg_fmt.pl $(BUILDDIR)/sphinxlatexstyletext.sty; cd $(BUILDDIR); make)
cp "$(BUILDDIR)/Bv9ARM.pdf" "$(SOURCEDIR)"

clean::
rm -rf $(BUILDDIR)
rm -f Bv9ARM.pdf
Loading

0 comments on commit cf1cc27

Please sign in to comment.