1 files changed, 28 insertions, 23 deletions
diff --git a/documentation/content/en/books/handbook/usb-device-mode/_index.adoc b/documentation/content/en/books/handbook/usb-device-mode/_index.adoc
index e3e454056a..4e22c4b8ec 100644
--- a/documentation/content/en/books/handbook/usb-device-mode/_index.adoc
+++ b/documentation/content/en/books/handbook/usb-device-mode/_index.adoc
@@ -1,10 +1,13 @@
 ---
-title: Chapter 26. USB Device Mode / USB OTG
+title: Chapter 28. USB Device Mode / USB OTG
 part: Part III. System Administration
 prev: books/handbook/dtrace
 next: books/handbook/partiv
 description: This chapter covers the use of USB Device Mode and USB On The Go (USB OTG) in FreeBSD
 tags: ["OTG", "USB"]
+showBookMenu: true
+weight: 32
+path: "/books/handbook/usb-device-mode/"
 ---
 
 [[usb-device-mode]]
@@ -15,33 +18,35 @@ tags: ["OTG", "USB"]
 :icons: font
 :sectnums:
 :sectnumlevels: 6
+:sectnumoffset: 28
+: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/attributes/attributes-{{% lang %}}.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
@@ -135,7 +140,7 @@ To load the module and set the template without rebooting use:
 
 To connect to a board configured to provide USB device mode serial ports, connect the USB host, such as a laptop, to the boards USB OTG or USB client port.
 Use `pstat -t` on the host to list the terminal lines.
-Near the end of the list you should see a USB serial port, eg "ttyU0".
+Near the end of the list you should see a USB serial port, e.g. "ttyU0".
 To open the connection, use:
 
 [source,shell]
@@ -235,7 +240,7 @@ The cfumass startup script sets the correct template number automatically when s
 === Configuring USB Mass Storage Using Other Means
 
 The rest of this chapter provides detailed description of setting the target without using the cfumass rc file.
-This is necessary if eg one wants to provide a writeable LUN.
+This is necessary if e.g. one wants to provide a writeable LUN.
 
 USB Mass Storage does not require the man:ctld[8] daemon to be running, although it can be used if desired.
 This is different from iSCSI.
@@ -270,7 +275,7 @@ man:ctld[8] can also be used to manage LUNs.
 Create [.filename]#/etc/ctl.conf#, add a line to [.filename]#/etc/rc.conf# to make sure man:ctld[8] is automatically started at boot, and then start the daemon.
 
 This is an example of a simple [.filename]#/etc/ctl.conf# configuration file.
-Refer to man:ctl.conf[5] for a more complete description of the options.
+Refer to man:ctl.conf[5] for a complete description of the options.
 
 [.programlisting]
 ....