standardize style

keenanlang · keenanlang · commit 309a8401b997 · 2026-06-07T15:05:53.000-05:00
diff --git a/docs/Acromag_AVME9210.md b/docs/Acromag_AVME9210.md
@@ -7,9 +7,16 @@ nav_order: 2
 
 
 # Acromag AVME-9210 Analog Output
+{: .no_toc}
 
 Author: Joe White (SLAC, 1995)
 
+## Table of contents
+{: .no_toc .text-delta }
+
+- TOC
+{:toc}
+
 The Acromag AVME-9210 is an 8-channel, 12-bit DAC analog output VME module in
 A16 short I/O address space. This module provides device support and a
 low-level driver for controlling the AVME-9210.
diff --git a/docs/Acromag_AVME9440.md b/docs/Acromag_AVME9440.md
@@ -7,15 +7,23 @@ nav_order: 3
 
 
 # Acromag AVME-9440 Digital I/O
+{: .no_toc}
 
 Author: Greg Nawrocki (1993), David M. Kline (2005)
 
+## Table of contents
+{: .no_toc .text-delta }
+
+- TOC
+{:toc}
+
 The Acromag AVME-9440 is a 16-bit binary input and output VME board. This
 device support provides EPICS access to all 16 input and 16 output channels
 via bi, bo, mbbi, and mbbo records. Change-of-state I/O interrupts are
 available for binary input signals 0-7 only, and only for the bi record type.
 
-**Note:** This device support is OS independent (uses EPICS devLib).
+{: .note }
+> This device support is OS independent (uses EPICS devLib).
 
 ## Configuration
 
diff --git a/docs/BunchClkGen.md b/docs/BunchClkGen.md
@@ -7,9 +7,16 @@ nav_order: 4
 
 
 # APS BCG-100 Bunch Clock Generator
+{: .no_toc}
 
 Author: Frank Lenkszus (1995), David M. Kline (2005)
 
+## Table of contents
+{: .no_toc .text-delta }
+
+- TOC
+{:toc}
+
 The BCG-100 is a VMEbus bunch clock generator module used at the Advanced
 Photon Source. This module provides combined driver and device support for
 controlling the BCG-100 in the A16 VME address space. It supports ai, ao, bi,
@@ -73,4 +80,4 @@ var devBunchClkGenDebug 0
 
 ## Dependencies
 
-The fill pattern sequence program requires the **SNCSEQ** (sequencer) module.
+The fill pattern sequence program requires the **seq** (sequencer) module.
diff --git a/docs/CAEN_v895.md b/docs/CAEN_v895.md
@@ -7,9 +7,16 @@ nav_order: 5
 
 
 # CAEN V895 16-Channel Discriminator
+{: .no_toc}
 
 Author: Tim Mooney
 
+## Table of contents
+{: .no_toc .text-delta }
+
+- TOC
+{:toc}
+
 The CAEN V895 is a 16-channel leading edge discriminator in a VME module. This
 driver is implemented as an asynPortDriver subclass, providing access to the
 per-channel threshold values (0-255) through standard asyn interfaces.
@@ -50,8 +57,9 @@ dbLoadRecords("$(VME)/vmeApp/Db/singleDiscrim.db", "P=$(PREFIX),D=$(INSTANCE),N=
 The driver is configured as `ASYN_MULTIDEVICE` with 16 channels (addresses
 0-15).
 
-**Note:** The CAEN V895 hardware is write-only. Read operations return 0; the
-last written value is tracked via the asyn parameter library.
+{: .note }
+> The CAEN V895 hardware is write-only. Read operations return 0; the last
+> written value is tracked via the asyn parameter library.
 
 ## Dependencies
 
diff --git a/docs/HP_10895A.md b/docs/HP_10895A.md
@@ -7,9 +7,16 @@ nav_order: 8
 
 
 # HP 10895A Laser Axis Interferometer
+{: .no_toc}
 
 Author: Tim Mooney (1995)
 
+## Table of contents
+{: .no_toc .text-delta }
+
+- TOC
+{:toc}
+
 The Hewlett-Packard 10895A is a VMEbus laser axis board for laser
 interferometer measurements. This device support provides access to the
 board's status, position, control, and command registers through bi, bo, mbbi,
diff --git a/docs/IK320_setup.md b/docs/IK320_setup.md
@@ -7,15 +7,23 @@ nav_order: 7
 
 
 # Heidenhain IK320 Encoder Setup
+{: .no_toc}
 
 Author: Kurt Goetze (goetze@aps.anl.gov)
 
+## Table of contents
+{: .no_toc .text-delta }
+
+- TOC
+{:toc}
+
 The Heidenhain IK320 is a VME counter/interpolator for linear and angular
 encoders. This page describes how to configure the IK320 for use with EPICS
 (synApps). The IK320 device support and driver were written by Till Straumann
 of PTB at BESSY.
 
-**Note:** The IK320 builds on both **vxWorks** and **RTEMS**.
+{: .note }
+> The IK320 builds on both **vxWorks** and **RTEMS**.
 
 ## Supported Record Types
 
diff --git a/docs/Joerger_scaler.md b/docs/Joerger_scaler.md
@@ -7,9 +7,16 @@ nav_order: 9
 
 
 # Joerger Scalers
+{: .no_toc}
 
 Author: Tim Mooney (1995, 2003)
 
+## Table of contents
+{: .no_toc .text-delta }
+
+- TOC
+{:toc}
+
 The vme module provides device support for two families of Joerger VME scaler
 modules:
 
diff --git a/docs/MRD100.md b/docs/MRD100.md
@@ -7,9 +7,16 @@ nav_order: 10
 
 
 # MRD-100 Machine Status Link
+{: .no_toc}
 
 Author: APS BCDA
 
+## Table of contents
+{: .no_toc .text-delta }
+
+- TOC
+{:toc}
+
 The MRD-100 is a VMEbus Machine Status Link (MSL) module that provides
 real-time access to accelerator status data from the APS storage ring. The
 module is located in the A32/D32 VME address space and provides data including
@@ -40,7 +47,8 @@ The script calls `devAvmeMRDConfig(base, vector, level)` and loads
 `msl_mrd100.db`. For canted undulator beamlines, use `MRD100_CantedID.db`
 instead.
 
-**Note:** Only one instance of the MRD-100 is supported.
+{: .note }
+> Only one instance of the MRD-100 is supported.
 
 When configuring manually:
 
diff --git a/docs/VMI4116.md b/docs/VMI4116.md
@@ -7,9 +7,16 @@ nav_order: 11
 
 
 # VMIC VMI4116 16-Bit DAC
+{: .no_toc}
 
 Authors: Bob Dalesio, Mike Bordua (1994)
 
+## Table of contents
+{: .no_toc .text-delta }
+
+- TOC
+{:toc}
+
 The VMIVME-4116 is an 8-channel, 16-bit digital-to-analog converter (DAC) VME
 module in A16 short I/O address space. This device support provides EPICS ao
 record access to all 8 output channels.
diff --git a/docs/Varoc.md b/docs/Varoc.md
@@ -7,9 +7,16 @@ nav_order: 6
 
 
 # ESRF Varoc SSI Absolute Encoder Interface
+{: .no_toc}
 
 Authors: Karen J. Coulter (1993), Robert A. Popper (1994)
 
+## Table of contents
+{: .no_toc .text-delta }
+
+- TOC
+{:toc}
+
 The Varoc (ZIO085) is a VMEbus SSI (Synchronous Serial Interface) absolute
 encoder interface card originally developed at ESRF. It supports up to 16
 encoder channels per card. This module provides device support and a low-level
diff --git a/docs/_config.yml b/docs/_config.yml
@@ -1 +1,13 @@
 remote_theme: BCDA-APS/bcda-pages-style
+
+callouts_level: quiet
+callouts:
+  note:
+    title: Note
+    color: purple
+  important:
+    title: Important
+    color: blue
+  warning:
+    title: Warning
+    color: red
diff --git a/docs/devA32Vme.md b/docs/devA32Vme.md
@@ -7,9 +7,16 @@ nav_order: 1
 
 
 # Generic A32/D32 VME Device Support
+{: .no_toc}
 
 Author: Ned D. Arnold (1997)
 
+## Table of contents
+{: .no_toc .text-delta }
+
+- TOC
+{:toc}
+
 This device support module provides generic access to any VME register in the
 A32/D32 address space. It supports ai, ao, bi, bo, longin, longout, mbbi, and
 mbbo record types. Arbitrary bit fields within 32-bit registers can be read and
diff --git a/docs/device_support.md b/docs/device_support.md
@@ -7,6 +7,7 @@ has_children: true
 
 
 # Device Support
+{: .no_toc}
 
 The vme module provides device support and drivers for the following VME
 hardware:
diff --git a/docs/index.md b/docs/index.md
@@ -6,6 +6,13 @@ nav_order: 1
 
 
 # vme -- EPICS VME Device Support Module
+{: .no_toc}
+
+## Table of contents
+{: .no_toc .text-delta }
+
+- TOC
+{:toc}
 
 The **vme** module is part of the
 [APS BCDA synApps](https://github.com/epics-modules) suite. It provides EPICS
diff --git a/docs/vmeRecord.md b/docs/vmeRecord.md
@@ -1,20 +1,20 @@
 ---
 layout: default
 title: VME Record
-nav_order: 2
+nav_order: 3
 ---
 
 
 # vme - Generic VME Record
+{: .no_toc}
 
 Author: Mark Rivers
 
-## Contents
+## Table of contents
+{: .no_toc .text-delta }
 
-- [Overview](#overview)
-- [Field Descriptions](#field-descriptions)
-- [Files](#files)
-- [Example](#example)
+- TOC
+{:toc}
 
 ## Overview
 
@@ -35,10 +35,11 @@ contains the data to be written or the data read. The SARR (Status Array) field
 contains the status of each VME I/O operation, i.e. whether the operation
 succeeded or generated a VME bus error.
 
-**Warning:** The VME record should be used with care, since it is possible to
-write to any location in the VME address space. It is definitely possible to
-affect VME modules in unintended ways. Even read-only operations can have
-significant side-effects.
+{: .warning }
+> The VME record should be used with care, since it is possible to write to
+> any location in the VME address space. It is definitely possible to affect
+> VME modules in unintended ways. Even read-only operations can have
+> significant side-effects.
 
 ---
 
diff --git a/docs/vmeReleaseNotes.md b/docs/vmeReleaseNotes.md
@@ -1,11 +1,18 @@
 ---
 layout: default
 title: Release Notes
-nav_order: 3
+nav_order: 2
 ---
 
 
 # vme Release Notes
+{: .no_toc}
+
+## Table of contents
+{: .no_toc .text-delta }
+
+- TOC
+{:toc}
 
 ## Release 2-9-5 (Jun 7, 2023)
 
