mirror of synced 2026-03-23 09:31:09 +00:00

Files

Larry Masinter 5a24a52819 Update CI and docs to use submodules for maiko/notecards/loops/test

doHCFILES.yml: replace 5 separate checkout steps with a single
  checkout using submodules:true; remove now-redundant .git cleanup step.

buildLoadup.yml: add submodules:true to Checkout Medley; remove
  separate Checkout Notecards + tar steps (notecards.tgz was already
  commented out of the release push).

make-gh-pages.md: replace manual clone+copy instructions with
  git clone --recurse-submodules; remove rm -rf of submodule dirs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-03-08 19:45:39 -07:00

1.7 KiB

Raw Blame History

preliminary documentation -- needs validation HCFILES writes in {MEDLEYDIR} but it should write in something like (SRCDIR)

setup

Remove extraneous files

There are lots of ways to get there but basically set up the execution environment with everything clean. If you don't make fresh, at least 'git clean'.

git clone --recurse-submodules https://github.com/Interlisp/medley

Or, if you already have a clone:

git submodule update --init --recursive

This will populate notecards, loops, test (and maiko) inside the medley directory.

making the .pdfs and index.html files

best start with a fresh loadup

./scripts/loadup-all.sh

Now run in Medley "apps" loadup

  ./medley -a &

and enter the following to make the PDFs and the index.html files that links them.

(DRIBBLE "medley/loadups/hcfiles.dribble")

(FILESLOAD MEDLEY-UTILS PDFSTREAM GITFNS)

(SETQ NO-HELP NIL)
ADVISE(HELP :BEFORE (IF NO-HELP THEN ( (ERROR MESS1 MESS2)))
    (LET ((NO-HELP T)) (DECLARE (SPECIAL NO-HELP)) (HCFILES)))

(MAKE-INDEX-HTML)

Deploying

The trick is to take a repository based on the master branch of medley and produce a gh-pages branch in the Interlisp/src reposiory.

git remote set-url --push https://github.com/Interlisp/src
git branch -D gh-pages  ## if necessary
git checkout -b gh-pages ## make the current directory content the same

## make sure the .gitignore DOESN'T ignore .pdf and index.html files

git add .
git commit -m "add created pdf's and index.html's"
git push --force

# Put it all back

after you've done this, you can clean up (from the medley folder):

find . -iname "*.pdf" -exec rm {} ; git remote set-url --push https://github.com/Interlisp/medley

1.7 KiB Raw Blame History