Create irc-meetings-ical-tox-publish job

This is in preparation for making this output a static site on AFS.
Put the output in the expected location for the publish jobs, make a
symlink to the old location.

Change-Id: I73ff15231a6a3b2d86eeff0ee4e90dbf77ed9e2e

.zuul.yaml

@@ -1,6 +1,6 @@
 - job:
-    name: irc-meetings-tox-ical
-    parent: openstack-tox
+    name: irc-meetings-ical-tox-publish
+    parent: openstack-tox-docs
     description: |
       Run tests using tox with the ``ical`` environment.
     vars:
@@ -9,7 +9,7 @@
 - project:
     check:
       jobs:
-        - irc-meetings-tox-ical
+        - irc-meetings-ical-tox-publish
     gate:
       jobs:
-        - irc-meetings-tox-ical
+        - irc-meetings-ical-tox-publish

tox.ini

@@ -13,14 +13,20 @@ commands = {posargs}
 
 [testenv:ical]
 basepython = python3
-whitelist_externals = mkdir
+whitelist_externals =
+    mkdir
+    ln
 commands =
-    mkdir -p output/calendars
+    mkdir -p doc/build/html/calendars
     yaml2ical -n "OpenStack Meetings" \
         -d "Meeting schedule for the OpenStack projects" \
-        -y meetings -o output/irc-meetings.ical \
-        -t meetingindex.jinja -w output/index.html -f
-    yaml2ical -y meetings -i output/calendars/ -f
+        -y meetings -o doc/build/html/irc-meetings.ical \
+        -t meetingindex.jinja -w doc/build/html/index.html -f
+    yaml2ical -y meetings -i doc/build/html/calendars/ -f
+    # NOTE(ianw) 2021-06-02 : to maintain compatbility
+    # with old jobs that aren't using the default tox docs
+    # publishing methods, we symlink ./output
+    ln -sf ./doc/build/html/ output
 
 [testenv:pep8]
 basepython = python3