Re: git: b113509f32 - main - Handbook WG - Create a new network chapter
- In reply to: Sergio Carlavilla Delgado : "git: b113509f32 - main - Handbook WG - Create a new network chapter"
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Thu, 06 Jul 2023 17:57:06 UTC
On 7/6/23 5:09 AM, Sergio Carlavilla Delgado wrote:
> The branch main has been updated by carlavilla:
>
> URL: https://cgit.FreeBSD.org/doc/commit/?id=b113509f32da681db41fd60594b723c13334df8e
>
> commit b113509f32da681db41fd60594b723c13334df8e
> Author: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
> AuthorDate: 2023-07-06 12:04:54 +0000
> Commit: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
> CommitDate: 2023-07-06 12:04:54 +0000
>
> Handbook WG - Create a new network chapter
>
> Create a new chaper with the basic configuration of a wired
> and wireless networks in FreeBSD.
>
> Sections of the new chapter:
> - Synopsis
> - Setting up the Network
> - Wired Networks
> - Wireless Networks
> - Hostname
> - DNS
> - Troubleshooting
>
> Changes:
> - Move wired network section from config to network
> - Move virtual hosts section from config to advanced networking
> - Move basic wireless section from advanced networking to network
> - Move IPv6 from advanced networking to network
> - Upgrade all command outputs
> - Use sysrc
> - Improve AsciiDoc syntax
>
> Differential Revision: https://reviews.freebsd.org/D40546
> Reviewed by: bcr, dbaio, fernape, karels
> Sponsored by: Daifressh
> ---
> .../books/handbook/advanced-networking/_index.adoc | 897 +------------------
> .../content/en/books/handbook/audit/_index.adoc | 6 +-
> .../en/books/handbook/bibliography/_index.adoc | 2 +-
> documentation/content/en/books/handbook/book.adoc | 2 +
> .../content/en/books/handbook/boot/_index.adoc | 6 +-
> .../content/en/books/handbook/colophon.adoc | 2 +-
> .../content/en/books/handbook/config/_index.adoc | 492 +----------
> .../en/books/handbook/cutting-edge/_index.adoc | 8 +-
> .../content/en/books/handbook/desktop/_index.adoc | 6 +-
> .../content/en/books/handbook/disks/_index.adoc | 6 +-
> .../content/en/books/handbook/dtrace/_index.adoc | 6 +-
> .../en/books/handbook/eresources/_index.adoc | 2 +-
> .../en/books/handbook/filesystems/_index.adoc | 6 +-
> .../en/books/handbook/firewalls/_index.adoc | 6 +-
> .../content/en/books/handbook/geom/_index.adoc | 6 +-
> .../content/en/books/handbook/glossary.adoc | 4 +-
> .../content/en/books/handbook/jails/_index.adoc | 6 +-
> .../en/books/handbook/kernelconfig/_index.adoc | 153 ++--
> .../content/en/books/handbook/l10n/_index.adoc | 6 +-
> .../content/en/books/handbook/linuxemu/_index.adoc | 42 +-
> .../content/en/books/handbook/mac/_index.adoc | 6 +-
> .../content/en/books/handbook/mail/_index.adoc | 6 +-
> .../content/en/books/handbook/mirrors/_index.adoc | 8 +-
> .../en/books/handbook/multimedia/_index.adoc | 6 +-
> .../en/books/handbook/network-servers/_index.adoc | 6 +-
> .../content/en/books/handbook/network/_index.adoc | 951 +++++++++++++++++++++
> .../content/en/books/handbook/partii.adoc | 4 +-
> .../content/en/books/handbook/partiii.adoc | 2 +-
> .../content/en/books/handbook/partiv.adoc | 2 +-
> documentation/content/en/books/handbook/partv.adoc | 2 +-
> .../content/en/books/handbook/pgpkeys/_index.adoc | 2 +-
> .../content/en/books/handbook/ports/_index.adoc | 28 +-
> .../en/books/handbook/ppp-and-slip/_index.adoc | 6 +-
> .../content/en/books/handbook/printing/_index.adoc | 6 +-
> .../content/en/books/handbook/security/_index.adoc | 12 +-
> .../en/books/handbook/serialcomms/_index.adoc | 6 +-
> .../en/books/handbook/usb-device-mode/_index.adoc | 6 +-
> .../en/books/handbook/virtualization/_index.adoc | 6 +-
> .../content/en/books/handbook/wayland/_index.adoc | 2 +-
> .../content/en/books/handbook/wine/_index.adoc | 6 +-
> .../content/en/books/handbook/zfs/_index.adoc | 11 +-
> 41 files changed, 1202 insertions(+), 1546 deletions(-)
>
> diff --git a/documentation/content/en/books/handbook/advanced-networking/_index.adoc b/documentation/content/en/books/handbook/advanced-networking/_index.adoc
> index 732de75166..b9194449cd 100644
> --- a/documentation/content/en/books/handbook/advanced-networking/_index.adoc
> +++ b/documentation/content/en/books/handbook/advanced-networking/_index.adoc
> @@ -1,12 +1,12 @@
> ---
> -title: Chapter 33. Advanced Networking
> +title: Chapter 34. Advanced Networking
> part: IV. Network Communication
> prev: books/handbook/firewalls
> next: books/handbook/partv
> description: "Advanced networking in FreeBSD: basics of gateways and routes, CARP, how to configure multiple VLANs on FreeBSD, etc"
> -tags: ["Advanced Networking", "Handbook", "gateway", "routes", "wireless", "tethering", "bluetooth", "bridging", "ipv6", "CARP", "VLAN"]
> +tags: ["Advanced Networking", "Handbook", "gateway", "routes", "wireless", "tethering", "bluetooth", "bridging", "CARP", "VLAN"]
> showBookMenu: true
> -weight: 38
> +weight: 39
> path: "/books/handbook/"
> ---
>
> @@ -18,7 +18,7 @@ path: "/books/handbook/"
> :icons: font
> :sectnums:
> :sectnumlevels: 6
> -:sectnumoffset: 33
> +:sectnumoffset: 34
> :partnums:
> :source-highlighter: rouge
> :experimental:
It seems a bit unfortunate (and fragile?) that chapter and section numbers
had to be manually changed in this commit for other chapters besides the
added one. Is there a way to use a counter to auto-generate these similar
to using <chapter> tags in DocBook or \begin{chapter} in LaTeX?
Also, I'm kind of curious what the "weight" attribute is and if it can similarly
be auto-computed and not manually set?
--
John Baldwin