Created Managing_Assets.md

This is a first draft.

Managing_Assets.md

@@ -0,0 +1,55 @@
+
+# Static Site - asset management
+### Dave Morriss
+### Last update: 2023-08-31 11:49:34
+
+* * *
+
+# Overview
+
+This document describes a script which is being planned to perform actions on
+the HPR database. The main actions are:
+
+- Manage the existing contents in the `assets` table for a given show
+    - This means that the table entries need to represent all of the files
+      such as audio files, transcript files and any files included by the
+      creator of the show.
+    - The asset information is primarily used to provide information about
+      audio files when creating RSS feeds including this show. In particular
+      the audio file size is needed, as well as its name.
+    - Show creator-provided assets are currently stored in the corresponding
+      item on the Internet Archive. Previously they were held on the HPR
+      server, but due to space restrictions on the new server are being held
+      on archive.org. The `assets` table entries should indicate file
+      locations. It is possible that alternative locations will be
+      provided in the future, and this will need to be reflected in this
+      table.
+
+- It is intended that this script will be run to populate the assets table for
+  a new show. It will also set the `valid` field of the `eps` (episodes)
+  table to `true` once the asset details are ready.
+
+- The script will additionally manage links to assets in the `notes` field of
+  the `eps` table for the show.
+    - Existing shows with creator-provided assets will contain links to them,
+      assuming they are on the HPR server. These must be updated to reflect
+      their current locations (on the Internet Archive).
+    - This same process will be required should assets be moved to another
+      location.
+    - The process of changing HTML links will be considerably simplified if a
+      record of their current location is kept in the `assets` table. An URL
+      stored in the `assets` table might be the only record of which URLs in
+      the HTML notes and any HTML assets are assets and which are other
+      resources. At present all asset URLs are either absolute, referring to
+      the HPR IP address or are relative URLs where the base URL is assumed to
+      be HPR.
+    - It is assumed that URLs stored in the `assets` table will be absolute.
+      Other strategies might be used however.
+
+- Details of show creator-provided assets do not exist at present. It will be
+  necessary to gather this information as new shows are added and existing
+  shows post-processed.
+
+<!--
+   - vim: syntax=markdown:ts=8:sw=4:ai:et:tw=78:fo=tcqn:fdm=marker:com+=fb\:-
+   -->