Updates on OLX custom pages and textbooks

Author: sarina

source/educators/olx/assets/assets.rst

@@ -15,8 +15,6 @@ see :ref:`Course Asset Policy`.
 
 .. seealso::
 
-  :ref:`Add Course Assets` (reference)
-
   :ref:`Course Asset Policy` (reference) 
 
   :ref:`What is Open Learning XML?` (concept)
@@ -27,11 +25,14 @@ see :ref:`Course Asset Policy`.
 
   :ref:`OLX Directory Structure` (reference)
 
+  :ref:`Add Course Assets` (via Studio) (reference)
+
+
 
 **Maintenance chart**
 
 +--------------+-------------------------------+----------------+--------------------------------+
 | Review Date  | Working Group Reviewer        |   Release      |Test situation                  |
 +--------------+-------------------------------+----------------+--------------------------------+
-|              |                               |                |                                |
+| 2025-11-06   | sarina                        |  Ulmo          | Pass                           |
 +--------------+-------------------------------+----------------+--------------------------------+

source/educators/olx/pages/pages.rst

@@ -1,26 +1,53 @@
 .. _Course Tabs:
 
-#################################
+########################################
 Create Course Tabs in OLX
-#################################
+#########################################
 
 .. tags:: educator, how-to
 
-You can add tabs, or pages, to your course. Each page appears in your course's
+You can add custom tabs, or pages, to your course. Each page appears in your course's
 navigation bar.
 
 *********************************************
 Create the Tab File
 *********************************************
 
 For each page you want your course to offer, you create an HTML file in the
-``tabs`` directory.
+``tabs`` directory. It can be as simple as this:
+
+*Contents of* ``html_custom_tab.html``:
+
+.. code-block:: html
+
+  <h1>Welcome to the OLX Example Course!</h1>
+
+  <p>This is a custom HTML page added as a custom tab to the course.</p>
 
 You can add any text and HTML markup to the page. Pages can also be links or
 other types of content. One design pattern is to link a tab to a chromeless
 XBlock in the courseware, which allows for top-level interactive course
 content.
 
+Ensure you place the custom tab properly in the ``policy.json`` file as detailed
+in :ref:`Course Policies`.
+
+.. code-block:: json
+
+  {
+    "course/2025": {
+    ...
+
+      {
+          "course_staff_only": false,
+          "name": "HTML Custom Tab",
+          "type": "static_tab",
+          "url_slug": "html_custom_tab"
+      }
+  }
+
+
+
 .. seealso::
 
   :ref:`What is Open Learning XML?` (concept)

source/educators/olx/policies/assets-policy.rst

@@ -1,8 +1,8 @@
 .. _Course Asset Policy:
 
-#####################################
-Create the Course Asset Policy in OLX
-#####################################
+#####################################################
+Create Course Assets and Textbooks in OLX
+#####################################################
 
 .. tags:: educator, how-to
 
@@ -119,6 +119,44 @@ The following example shows the JSON policy for an image file and a PDF textbook
       },
     }
 
+.. _Course Textbooks OLX:
+
+*********************************************
+Create Textbooks
+*********************************************
+
+As described above, first upload a textbook asset to
+your course in the ``static`` directory.
+
+.. admonition:: Accessibility concerns
+
+  See the notes in the :ref:`Add Course Textbooks` article around accessibility - namely, that
+  PDF textbooks are accessible whereas PNG/image files are not.
+
+Then, as described above, link it in your ``assets.json`` file.
+
+Finally, update the ``policy.json`` file (described in :ref:`Course Policies`)
+with information in the ``pdf_textbooks`` key:
+
+.. code-block:: json
+
+  {
+    "course/2025": {
+      ...
+      "pdf_textbooks": [
+          {
+              "chapters": [
+                  {
+                      "title": "Full Book",
+                      "url": "/asset-v1:OpenedX+OLXex+2025+type@asset+block@Education_for_a_Digital_World.pdf"
+                  }
+              ],
+              "id": "6Education_for_a_Digital_World",
+              "tab_title": "Education for a Digital World: Advice, Guidelines and Effective Practice from Around Globe"
+          }
+      ],
+      ...
+  }      
 
 .. seealso::