Add ability to export event schedule as an HTML file

New menu action in the Advanced menu do download event data in the spreadsheet
either as an HTML page (for the schedule) or as a JSON file (for debugging and
for setting up the event initially when the repository/project do not exist
yet).

Author: tidoust

tools/appscript/add-custom-menu.mjs

@@ -22,7 +22,7 @@ export default function () {
         .addItem('Retrieve latest published schedule (from GitHub)', 'importGrid')
         .addItem('Fetch event info, rooms, days, slots (from GitHub)', 'importMetadata')
         /*.addItem('Export event info, rooms, days, slots to GitHub', 'exportMetadata')*/
-        .addItem('Dump event data as JSON', 'exportEventData')
+        .addItem('Export event to files (HTML, JSON)', 'exportEventToFiles')
     )
     .addToUi();
 }

tools/appscript/export-event-data.mjs

@@ -0,0 +1,73 @@
+import { getProject } from './lib/project.mjs';
+import reportError from './lib/report-error.mjs';
+import { fetchMapping } from './lib/w3cid-map.mjs';
+import { convertProjectToHTML } from '../common/project2html.mjs';
+
+
+/**
+ * Generate the grid for the current spreadsheet
+ */
+export default function () {
+  return exportEventToFiles(SpreadsheetApp.getActiveSpreadsheet());
+}
+
+
+/**
+ * Generate the grid in the provided spreadsheet
+ */
+async function exportEventToFiles(spreadsheet) {
+  try {
+    console.log('Read data from spreadsheet...');
+    const project = getProject(spreadsheet);
+    project.w3cIds = await fetchMapping();
+    if (!project.sheets.sessions.sheet) {
+      reportError('No sheet found that contains the list of sessions, please import data from GitHub first.');
+      return;
+    }
+    console.log('Read data from spreadsheet... done');
+
+    console.log('Convert to HTML...');
+    const html = await convertProjectToHTML(project); 
+    console.log('Convert to HTML... done');
+
+    console.log('Create data URL for the HTML export...');
+    const htmlBase64 = Utilities.base64Encode(html, Utilities.Charset.UTF_8);
+    const htmlDataUrl = `data:text/html;charset=UTF8;base64,${htmlBase64}`;
+    console.log('Create data URL for the HTML export... done');
+
+    console.log('Create data URL for the JSON export...');
+    const jsonBase64 = Utilities.base64Encode(
+      JSON.stringify(project, null, 2),
+      Utilities.Charset.UTF_8);
+    const jsonDataUrl = `data:application/json;charset=UTF8;base64,${jsonBase64}`;
+    console.log('Create data URL for the JSON export... done');
+
+    console.log('Report result...');
+    const htmlOutput = HtmlService
+      .createHtmlOutput(`<p>
+          Event data files prepared.
+          Click following link(s) to download them:
+        </p>
+        <ul>
+          <li>
+            <a href="${htmlDataUrl}" download="event.html">
+              Download event schedule as an HTML file
+            </a>
+          </li>
+          <li>
+            <a href="${jsonDataUrl}" download="event.json">
+              Download event data as a JSON file
+            </a>
+          </li>
+        </ul>
+    `)
+      .setWidth(300)
+      .setHeight(400);
+    SpreadsheetApp.getUi().showModalDialog(htmlOutput, 'Export event to a file');
+    console.log('Report result... done');
+  }
+  catch(err) {
+    reportError(err.toString());
+    return;
+  }
+}

tools/appscript/export-event-to-files.mjs

@@ -178,9 +178,7 @@ export function getProject(spreadsheet) {
     days: sheets.days.values
       .filter(v => !!v.date)
       .map(v => {
-        const name = v.weekday ?
-          v.weekday + ' (' + v.date + ')' :
-          v.date;
+        const name = v.date;
         return {
           id: v.id,
           name,

tools/appscript/lib/project.mjs

@@ -1,3 +1,19 @@
+/**
+ * The `add-custom-menu.mjs` script creates the custom menu in the spreadsheet.
+ * Entries in the custom menu trigger a call to a JavaScript function, but that
+ * association is done through a string.
+ *
+ * This file forces the exposition of these menu functions as global functions.
+ * That is needed because the rollup bundler does not know anything about
+ * the AppScript environment, and does not understand the association between
+ * the custom menu and the functions.
+ *
+ * Bundle generation with Rollup must also run with the `--no-treeshake` option
+ * for the same reason: Rollup would simply drop all code and generate an empty
+ * bundle otherwise (precisely because, as far as it can tell, nothing calls
+ * these global functions).
+ */
+
 import _createOnOpenTrigger from './create-onopen-trigger.mjs';
 import _addTPACMenu from './add-custom-menu.mjs';
 import _generateGrid from './generate-grid.mjs';
@@ -8,7 +24,7 @@ import _importGrid from './import-grid.mjs';
 import _importSessions from './import-sessions.mjs';
 import _importMetadata from './import-metadata.mjs';
 import _exportMetadata from './export-metadata.mjs';
-import _exportEventData from './export-event-data.mjs';
+import _exportEventToFiles from './export-event-to-files.mjs';
 
 function main() { _createOnOpenTrigger(); }
 function addTPACMenu() { _addTPACMenu(); }
@@ -20,4 +36,4 @@ function importGrid() { _importGrid(); }
 function importSessions() { _importSessions(); }
 function importMetadata() { _importMetadata(); }
 function exportMetadata() { _exportMetadata(); }
-function exportEventData() { _exportEventData(); }
+function exportEventToFiles() { _exportEventToFiles(); }

tools/appscript/main.mjs

@@ -374,9 +374,15 @@ export async function fetchProjectFromGitHub(login, id, sessionTemplate) {
     // all sessions will be associated with it.
     daysFieldId: days.id,
     days: days.options.map(day => {
+      const metadata = {};
+      (day.description ?? '')
+        .split(/\n/)
+        .map(line => line.trim().replace(/^[*\-] /, '').split(/:\s*/))
+        .filter(data => data[0] && data[1])
+        .forEach(data => metadata[data[0].toLowerCase()] = data[1]);
       const match =
         day.name.match(/(.*) \((\d{4}\-\d{2}\-\d{2})\)$/) ??
-        [day.name, day.name, day.name];
+        [day.name, metadata.weekday ?? day.name, day.name];
       return {
         id: day.id,
         name: match[0],

tools/common/project.mjs

@@ -1,6 +1,6 @@
-import { parseSessionMeetings, groupSessionMeetings } from '../../common/meetings.mjs';
-import { validateGrid } from '../../common/validate.mjs';
-import * as YAML from 'yaml';
+import { parseSessionMeetings, groupSessionMeetings } from './meetings.mjs';
+import { validateGrid } from './validate.mjs';
+import * as YAML from '../../node_modules/yaml/browser/index.js';
 
 const hasMeeting = s => s.atomicMeetings.find(m => m.room && m.day && m.slot);
 
@@ -245,7 +245,7 @@ export async function convertProjectToHTML(project, cliParams) {
   for (const table of tables) {
     // Columns represent the rooms
     writeLine(3, `<section id="d${table.day.date}">
-        <h3>${table.day.name}</h3>
+        <h3>${table.day.label ? table.day.label + ' (' + table.day.date + ')' : table.day.name}</h3>
         <table>
           <thead>
             <tr>
@@ -516,7 +516,7 @@ export async function convertProjectToHTML(project, cliParams) {
     writeLine(2, '</section>');
   }
 
-  if (cliParams && !reduce) {
+  if (cliParams?.cmd && !reduce) {
     writeLine(2, `<section id="cli">
       <h2>Generation parameters</h2>
       <ul>

tools/node/lib/project2html.mjs tools/common/project2html.mjstools/node/lib/project2html.mjs renamed to tools/common/project2html.mjs

@@ -1,5 +1,5 @@
 import { readFile } from 'fs/promises';
-import { convertProjectToHTML } from './lib/project2html.mjs';
+import { convertProjectToHTML } from '../common/project2html.mjs';
 import { saveSessionMeetings } from '../common/project.mjs';
 import { parseMeetingsChanges, applyMeetingsChanges } from './lib/meetings.mjs';
 import { validateGrid } from '../common/validate.mjs';

tools/node/schedule.mjs

@@ -1,6 +1,6 @@
 import { validateGrid } from '../common/validate.mjs';
 import { saveSessionMeetings } from '../common/project.mjs';
-import { convertProjectToHTML } from './lib/project2html.mjs';
+import { convertProjectToHTML } from '../common/project2html.mjs';
 
 export default async function (project, options) {
   if (!project.allowTryMeOut) {

tools/node/try-changes.mjs

@@ -1,4 +1,4 @@
-import { convertProjectToHTML } from './lib/project2html.mjs';
+import { convertProjectToHTML } from '../common/project2html.mjs';
 import { convertProjectToJSON } from '../common/project.mjs';
 
 export default async function (project, options) {