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