Commit Graph

155 Commits

Author SHA1 Message Date
Simon Forman 9057e3b347 Most of the C's. 2022-03-24 12:33:20 -07:00
Simon Forman 43649685ac Ref docs B's. 2022-03-24 11:15:25 -07:00
Simon Forman e9a5fbdb51 Got through the A's. 2022-03-24 09:45:29 -07:00
Simon Forman b13832b792 Update some ref docs. 2022-03-23 21:25:22 -07:00
Simon Forman b3ddc52f9e Update some ref docs. 2022-03-23 14:22:53 -07:00
Simon Forman 6a3576e9ef Minor cleanup. 2022-03-23 13:47:58 -07:00
Simon Forman cde292e24b Use the right files. 2022-03-23 13:43:18 -07:00
Simon Forman cdb05c6c68 Move the build stuff to its own dir.
Now Joypy/docs/reference/*.md are just the individual function
documents.
2022-03-23 13:40:20 -07:00
Simon Forman a3b3b840e1 It woulda looked like this,
if I hadda not had to manually tweak it.
2022-03-23 13:06:32 -07:00
Simon Forman 188f6e42c7 Goodness, that was brutal.
The `!-` name doesn't work as a title for the conversion from ReST to
Markdown.  Maybe that's a bug in Pandoc, but more likely it's a legit
syntax gotcha in Mearkdown itself.

    !-
    ^^^^

In ReST turns into:

    !-\^\^\^\^

In the Markdown.  :(

It should be:

    # !-

Instead.
2022-03-23 13:02:19 -07:00
Simon Forman 18b7c1f6a9 How hard can it be to concatenate files with newlines between them?
This hard.

Now add '#'s to those headers...
2022-03-23 11:45:36 -07:00
Simon Forman 0e79ba480f MD in the yow dir. Why not? 2022-03-23 11:44:38 -07:00
Simon Forman 2297204280 This is some janky Rube Goldberg shtuff. 2022-03-23 10:59:23 -07:00
Simon Forman b609f9a2c7 And rebuild the HTML to see how it looks. 2022-03-23 10:53:29 -07:00
Simon Forman 7048dd6017 Now pile all the ref docs into the refs dir. 2022-03-23 10:52:58 -07:00
Simon Forman 88f8723454 Pandoc!?
<p>if basis</p>
    <h2 id="discussion-60">Discussion</h2>
    <h2 id="crosslinks-59">## Crosslinks</h2>
    <h1 id="drop">drop</h1>
    <p>Basis Function Combinator</p>
2022-03-23 10:50:32 -07:00
Simon Forman 8f0f733ca3 Move the MD files into the reference dir. 2022-03-23 10:40:04 -07:00
Simon Forman 58e97aa124 And there we are, Markdown stubs for each function.
I hate filenames, Git hates Bullet • symbol, SNAFU.
I have no idea how to properly escape gnarly filenames.  I don't want to
restrict Joy function names (any non-space, non-[] Unicode) so I just
did the quick and dirty thing to make filenames.
2022-03-23 10:36:30 -07:00
Simon Forman dc76b4da2e Way overthinking this.
I want stub Markdown files for each (as yet undocumented) function.
The functions have docstrings but they are in ReST format.  Using the
`wrod.py` script I can fins all the functions that don't yet have doc
files and write their docstrings into a ReST template.  Then I use Make
and Pandoc to convert the ReST files to Markdown.
2022-03-23 10:33:02 -07:00
Simon Forman 6d9c4f14dc D'oh! Forgot to add HEADER.md file. 2022-03-22 21:50:52 -07:00
Simon Forman 9173e6de44 Make Functor-Reference from individual pages.
This is a little clunky, for example, see "!-" aka "not negative".
2022-03-22 21:47:23 -07:00
Simon Forman c5b59e1549 Minor cleanup. 2022-03-22 21:42:24 -07:00
Simon Forman 75faaf3acf Move some misc docs. 2022-03-22 21:28:39 -07:00
Simon Forman 7dbb3c69ed Working to clean up docs. 2022-03-22 21:22:57 -07:00
Simon Forman 4ac8fd5f4c Sphinx confused by `•`.
When building the HTML docs with Sphinx v4.3.0 the bullet symbol in
backticks quotes causes this warning message:

    .../Joypy/implementations/Python/joy/utils/pretty_print.py:docstring of joy.utils.pretty_print:15: WARNING: Inline interpreted text or phrase reference start-string without end-string.
2022-02-19 07:39:07 -08:00
Simon Forman 2b15f88c29 Move Jupyter kernel into notebooks dir. 2022-02-19 07:31:11 -08:00
Simon Forman 1553ba0a59 Adding in some old notes. 2022-02-19 07:30:26 -08:00
Simon Forman c467393bb7 Move notebooks to own dir. 2022-02-19 07:28:27 -08:00
Simon Forman b05f13fc90 WIP docs update 2022-01-15 15:22:17 -08:00
Simon Forman 2cc0ea0548 Some work on docs. 2021-12-23 19:08:30 -08:00
Simon Forman 384d391175 Switch to Joy kernel. 2021-11-30 21:00:26 -08:00
Simon Forman fcd4c613e4 Clean up Zipper notebook. 2021-11-28 15:39:24 -08:00
Simon Forman 5d856bf444 I think the real solution is to "not do that" as it were.
Unquoted symbols on the stack are verboten.
2021-11-28 15:03:47 -08:00
Simon Forman 89550cdd5f Working on bug #15
https://todo.sr.ht/~sforman/thun-der/15
2021-11-28 13:41:19 -08:00
Simon Forman d420f572df Update Square_Spiral notebook to use Joy kernel
https://todo.sr.ht/~sforman/thun-der/19
2021-11-27 17:04:15 -08:00
Simon Forman bc16f5f621 Bleah. 2021-11-27 10:31:32 -08:00
Simon Forman 1b193b1924 Recover the square spiral example code.
I hve no idea how this isn't in VCS.  I checked hg and git.  Is it in
an old branch that I deleted before merging or something?  I have
backups from which to restore, but it would be nice to know how I effed
it up in the first place, eh?
2021-11-27 09:04:25 -08:00
Simon Forman f96013d649 Update links on home front page. 2021-11-26 09:55:16 -08:00
Simon Forman f07db9da0a Zipper notebook with defs shadowing built-ins. 2021-11-25 11:57:26 -08:00
Simon Forman 61c4d4b16e Working on bug #15
https://todo.sr.ht/~sforman/thun-der/15/

The bug file output was too large for a comment, and you can't attach
files to the ticket, so I'm checking it in to have a handy reference.
2021-11-25 11:52:06 -08:00
Simon Forman b0b9a71fd9 Joy Jupyter kernel loads defs.txt 2021-11-25 11:12:02 -08:00
Simon Forman 770cd783fa More changes to the zipper notebook. 2021-11-25 11:10:21 -08:00
Simon Forman 600dc05030 Update zipper notebook to use Joy kernel. 2021-11-25 10:55:33 -08:00
Simon Forman 0ab8979d7a Change zipper doc over to Joy kernel. 2021-11-25 09:51:45 -08:00
Simon Forman e013096f47 backup-and-remove-htdocs script doc. 2021-11-25 09:33:09 -08:00
Simon Forman 0c51a3fc7d Just playing around. 2021-11-24 14:53:26 -08:00
Simon Forman 688f880b9f Start to convert Newton-Raphson notebook to Joy kernel. 2021-11-24 13:44:38 -08:00
Simon Forman 865f06d93d Let's switch to the Joy kernel. 2021-11-24 12:08:41 -08:00
Simon Forman f7364a6161 Updating the docs. Playing with Joy Kernel. 2021-11-24 08:54:08 -08:00
Simon Forman 876c68c02f Capture stdout so commands like words and trace work. 2021-11-23 15:12:59 -08:00