Skip to main content

· One min read

Finally, I can announe that the beta version is out!

This is what I updated since last time:

  • Parsed again all the specification to account for missing/overwritten pages because of similarly named items.
  • Added glossary definition tooltips everywhere I could (programatically, we can add more by hand by identifying any place missing a definition).
  • Added all the links of "See Also" and any time something is referenced in the text of the specification, the link for that item should now be working.
  • Added a lot of code blocks for example sections to provide syntax highlighting. Not all of the code in the reference is inside a code block, but most of them are. The rest most be parsed manually.

Enjoy!

· One min read

This is a major update. This is basically (hopefully) the last time we parsed the specification. There were a few bugs in the previous parsing which led to some missing pages because they were overwritten when multiple dictionary items shared the same name.

With this parsing, I fixed a bunch of other issues, so hopefully this will be the last parsing update, and from here on out it will just be manual updates to this project.

So this makes it version 2.0 beta is out!

Additionally, the glossary has been parsed again, and improved dramatically, so that the tooltips should now show, and have proper html rendering.

· One min read

Definitions Tooltip​

I made a react component tooltip for definitions to show you the definition of a term in place instead of a having to navigate to the glossary page. In addition, the same tooltip will link to the proper dictionary item if it exists, and if not, to the glossary page of the term. We still need to add the component all around, but this should make the functionality of the page much better. Here's an example: See the "forms" word in section 6.1.1.1 of Loops

Dictionary Pages​

There are a bunch of dictionary pages that did not get split correctly, so instead of showing up as a different page, they are part of another page. I've been checking them manually (a lot of work) and have made a list of about half the chapters. The rest need to be checked. I hope to make a script to help splitting a lot of these pages. Please help identifying the pages in the missing chapters as they are marked.

· One min read

Code Blocks Indented​

Good news, now the code blocks look even better! I indented them using the emacs indentation so it follows the conventional indentation. Changes made to 414 files :D

Enjoy!

· One min read

Glossary Improved​

The glossary has now:

  • Been split into multiple pages, one per letter
  • The legend and introduction have their page
  • A lot of the text was fixed for formatting issues, this was the bulk of the work

· 2 min read

Finally, we are at Alpha, version 1.0 is out!​

As of today, 2023/12/06 the Alpha version of the technical reference is out.

These are a few of the improvements since last time:

  • Complete Specification Update: There were parts of the spec missing because of an issue of files getting truncated before they were converted into markdown. I have now recovered the truncated parts, parsed them, and added them to the specification
  • A large amount of code now shows up in code blocks with syntax highlighting.
  • A lot of symbols like →, ≡, and a few others are now properly displayed
  • The Index, Figures, and Credits were parsed to be displayed properly per the original
  • The search index was updated to account for the new content
  • A bunch of formatting issues for the markdown to be displayed properly

What Alpha version means​

  • Now we are finally open to contributions of examples and added explanation
    • Contribution stubs were added at the end of Dictionary Items type pages see for example progn
  • The main text is unlikely to change much except for:
    • Minor formatting issues
    • Maybe there are still some symbols that are not rendering properly
    • Code Blocks for syntax highlighting in the non dictionary type pages have not yet been added
    • Tables have to be formatted
  • Therefore we are open to other contributions that are more meaningful in terms of content and development, please see our To Do Page for how you can contribute!

· One min read

Dicionary Sections​

As of now, 2023/12/03, all the dicionary pages have been broken up into their particular directories with a page per entry.

However there are still a few that need to be manually fixed because of problems with parsing the text with regex for certain exceptions.

Nevertheless, this improves the search results dramatically! The reference should now be much easier to use!

I also added a Dicionary Item's To Do Page for adding specific examples.

Cheers!

· One min read

Code Blocks​

The current status is that for some reason replacing the code with lisp formatted code blocks was failing due to regex issues.

Here are the lisp highlighted code blocks. Edit: removed link.

If you find any code that is not highlighted, please find the appropiate code block and replace it in the code!