Merge branch 'main' of git.beagleboard.org:lorforlinux/docs.beagleboard.io

boards/beagleboard/index.rst

@@ -3,8 +3,9 @@
 BeagleBoard (all)
 ###################
 
-BeagleBoard boards are low-cost, ARM-based development boards suitable for rapid prototyping and 
-open-hardware to enable professionals to develop production systems.
+BeagleBoard.org Single Board Computers (SBCs) and microcontroller development boards are fully OpenSource, low-cost, RISC-V & ARM 
+based boards. Which makes them suitable for students to learn about embedded electronics & embedded linux. The BeagleBoard development 
+platforms also enables rapid prototyping for professionals to develop industrial & production systems.
 
 .. note::
     Make sure to read and accept all the terms & condition provided in the :ref:`boards-terms-and-conditions` page. 
@@ -12,7 +13,11 @@ open-hardware to enable professionals to develop production systems.
     Use of either the boards or the design materials constitutes agreement to the T&C including any 
     modifications done to the hardware or software solutions provided by beagleboard.org foundation.
 
-The latest PDF-formatted System Reference Manual for each BeagleBoard board is linked below.
+The latest unified docs PDF is linked below.
+
+* `BeagleBoard.org unified docs PDF <https://docs.beagleboard.org/latest/beagleboard-docs.pdf>`_
+
+The latest System Reference Manual (PDF) for some older boards is linked below.
 
 * `BeagleBoard <https://git.beagleboard.org/beagleboard/beagleboard/-/blob/master/BeagleBoard_revC5_SRM.pdf>`_
 * `BeagleBoard-xM <https://git.beagleboard.org/beagleboard/beagleboard-xm/-/blob/master/BeagleBoard-xM_SRM.pdf>`_

conf.py

@@ -16,6 +16,12 @@ ImagemagickConverter.conversion_rules.append(('image/webp', 'image/png'))
 
 BBDOCS_BASE = Path(__file__).resolve().parents[0]
 
+rst_epilog =""
+
+# Add latest images to rst_epilog
+with open('latest.images') as f:
+     rst_epilog += f.read()    
+                       
 # -- Project information -----------------------------------------------------
 
 project = 'BeagleBoard Docs'
@@ -36,6 +42,7 @@ extensions = [
     "sphinx.ext.todo",
     "sphinx_tabs.tabs",
     "breathe",
+    "sphinx_copybutton",
 ]
 
 #    "exhale"

intro/support/getting-started.rst

@@ -23,6 +23,20 @@ The "IoT" images provide more free disk space if you don't need to use a graphic
 .. NOTE::
 	Due to sizing necessities, this download may take 30 minutes or more.
 
+1. `BeaglePlay latest image (xfce)`_
+2. `BeaglePlay latest image (home-assistant)`_
+3. `AM57xx latest image (IoT)`_ for BeagleBone AI and BeagleBone-X15
+4. `AM57xx latest image (Xfce)`_ for BeagleBone AI and BeagleBone-X15
+5. `BeagleBone AI-64 latest image (Minimal)`_
+6. `BeagleBone AI-64 latest image (TI EDGEAI)`_
+7. `BeagleBone AI-64 latest image (Xfce)`_
+8. `AM335x latest image`_ for BeagleBone Black, PocketBeagle, BeagleBone Blue, etc.
+9. `AM335x latest image (Xfce)`_ for BeagleBone Black, PocketBeagle, BeagleBone Blue, etc.
+10. `AM335x latest image (IoT)`_ for BeagleBone Black, PocketBeagle, BeagleBone Blue, etc.
+11. `BeagleConnect Freedom latest image (micropython)`_
+12. `BeagleV-Ahead latest image (Ubuntu)`_
+13. `BeagleV-Ahead latest image (Yocto)`_
+
 The Debian/Ubuntu distribution is provided for the boards. The file you download will have an .img.xz extension.
 This is a compressed sector-by-sector image of the SD card.
 
@@ -221,21 +235,26 @@ Books
 
 For a complete list of books on BeagleBone, see `beagleboard.org/books <https://beagleboard.org/books>`_.
 
-`Bad to the Bone <https://bbb.io/bad-to-the-bone>`_
+|image8|
 
 Perfect for high-school seniors or freshman univerisity level text, consider using "Bad to the Bone"
 
-`BeagleBone Cookbook <https://bbb.io/cookbook>`_
+|image9|
 
 A lighter treatment suitable for a bit broader audience without the backgrounders on programming and
 electronics, consider "BeagleBone Cookbook"
 
-`Exploring BeagleBone <https://bbb.io/ebb>`_ and `Embedded Linux Primer <https://bbb.io/elp>`_
+|image10|
 
 To take things to the next level of detail, consider "Exploring BeagleBone" which can be considered
-the missing software manual and utilize "Embedded Linux Primer" as a companion textbook to provide
+the missing software manual.
+
+|image11|
+
+utilize "Embedded Linux Primer" as a companion textbook to provide
 a strong base on embedded Linux suitable for working with any hardware that will run Linux.
 
+
 .. |image0| image:: images/distros.png
    :width: 75.0%
 .. |image1| image:: images/download-etcher.png

latest.images

+.. Latest distro images
+.. Created on: 2023-11-17
+.. Updated on: 2023-11-17
+
+.. _BeaglePlay latest image (Xfce): https://www.beagleboard.org/distros/beagleplay-11-8-2023-10-07-10gb-emmc-xfce-flasher
+.. _BeaglePlay latest image (home-assistant): https://www.beagleboard.org/distros/beagleplay-11-8-2023-10-07-8gb-emmc-home-assistant-flasher
+
+.. _AM57xx latest image (IoT): https://www.beagleboard.org/distros/am57xx-12-2-2023-10-07-4gb-emmc-iot-flasher
+.. _AM57xx latest image (Xfce): https://www.beagleboard.org/distros/am57xx-11-7-2023-09-02-4gb-emmc-xfce-flasher
+
+.. _BeagleBone AI-64 latest image (Minimal): https://www.beagleboard.org/distros/bbai64-12-2-2023-10-07-6gb-emmc-minimal-flasher
+.. _BeagleBone AI-64 latest image (TI EDGEAI): https://www.beagleboard.org/distros/bbai64-11-8-2023-10-07-10gb-emmc-ti-edgeai-xfce-flasher
+.. _BeagleBone AI-64 latest image (Xfce): https://www.beagleboard.org/distros/bbai64-11-8-2023-10-07-10gb-emmc-xfce-flasher
+
+.. _AM335x latest image: https://www.beagleboard.org/distros/am335x-11-7-2023-09-02-4gb-microsd-iot
+.. _AM335x latest image (Xfce): https://www.beagleboard.org/distros/am335x-11-7-2023-09-02-4gb-emmc-xfce-flasher
+.. _AM335x latest image (IoT): https://www.beagleboard.org/distros/am335x-11-7-2023-09-02-4gb-emmc-iot-flasher
+
+.. _BeagleConnect Freedom latest image (micropython): https://www.beagleboard.org/distros/beagleconnect-freedom-micropython-v0-0-3
+
+.. _BeagleV-Ahead latest image (Ubuntu): https://www.beagleboard.org/distros/beaglev-ahead-ubuntu-2023-07-05
+.. _BeagleV-Ahead latest image (Yocto): https://www.beagleboard.org/distros/beaglev-ahead-yocto-npi-2023-06-10
+

venv-build-env.sh

@@ -6,6 +6,6 @@ fi
 source ./sphinx-env/bin/activate
 python3 -m pip install --upgrade pip
 python3 -m pip install sphinx==5.3.0 sphinx-rtd-theme sphinx_design sphinx-tabs sphinxcontrib.svg2pdfconverter sphinx-reredirects
-python3 -m pip install sphinxcontrib-images
+python3 -m pip install sphinxcontrib-images sphinx-copybutton
 python3 -m pip install breathe exhale
 python3 -m pip install graphviz