fix documentation generation

.gitlab-ci.yml

@@ -36,38 +36,24 @@ test:
     paths:
       - public
 
+## The job "doc" will re-run the tests, but I'm keeping that
+## redundancy because the job "test" will be expanded to work on
+## multiple cl implementations.
+
 # Build public/ folder using org-publish on docs/
-org-mode-publish:
+doc:
   image: docker:24.0.7
   services:
     - docker:24.0.5-dind
   script:
     - apk add --no-cache make
     - make public
-    - mv public org-mode-publish
   artifacts:
     paths:
-      - org-mode-publish
+      - public
   rules:
     - when: manual
 
-# Merge "test" and "org-mode-publish"'s outputs
-doc:
-  needs:
-    - job: test
-      parallel:
-        matrix:
-          - STACK:
-            - sbcl
-      artifacts: true
-    - job: org-mode-publish
-      artifacts: true
-  script:
-    - cp org-mode-publish/* public/
-  artifacts:
-    paths:
-      - public
-
 pages:
   needs:
     - job: doc

docs/editor_integrations.org

@@ -8,7 +8,7 @@
 
 * TODO Make sure the commands are executed against _common lisp_ code :ux:editor:
 
-Gavinok tried breeze, but ran ~C-.~ on ~breeze.el~, this causes
+Gavinok tried breeze, but ran ~C-.~ on ~breeze.el~, this caused
 confusion for everybody.
 
 Here's some ideas to help with this:

makefile

@@ -1,5 +1,6 @@
 
 # Run the unit tests
+.PHONY: test
 test:
 	scripts/test.sh
 
@@ -10,6 +11,7 @@ doc:
 
 DOCKER_BUILD := DOCKER_BUILDKIT=1 docker build --progress=plain
 
+.PHONY: build-within-container
 build-within-container:
 	$(DOCKER_BUILD) --target=$(TARGET) --output type=local,dest=$(or $(DEST),.) . 2>&1 | tee $(TARGET).log
 
@@ -23,20 +25,23 @@ integration: TARGET=test
 integration: DEST=public
 integration: build-within-container dependencies.core
 
+.PHONY: public
+public: TARGET=public
+public: DEST=public
+public: build-within-container dependencies.core
+
+
 # Run some "integration tests" that generates some screenshots
 # This is work-in-progress
+.PHONY: demo
 demo:
 	scripts/demo/build-docker-image.sh
 
 # Fix spelling
+.PHONY: spell
 spell:
 	codespell --write-changes --interactive 3 --ignore-words scripts/ignore-words.txt $$(fd -e lisp) README.md notes.org docs/*.md src/breeze.el
 
+.PHONY: watch
 watch:
 	( fd . -e lisp src/ tests/; echo breeze.asd ) | entr time scripts/test.sh
-
-.PHONY: \
-	test \
-	demo \
-	spell \
-	watch

scripts/org-publish-project.el

@@ -39,4 +39,6 @@
           :with-toc nil
           )))
   (org-id-update-id-locations (directory-files root t "\\.org$"))
-  (org-publish project-alist forcep))
+  (org-publish project-alist forcep)
+  (copy-file "docs/listing-breeze.html" "public/")
+  (copy-file "docs/style.css" "public/"))