Re: git: b113509f32 - main - Handbook WG - Create a new network chapter

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 <[email protected]>
> AuthorDate: 2023-07-06 12:04:54 +0000
> Commit:     Sergio Carlavilla Delgado <[email protected]>
> 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