* * * News on StdLib WIP + AsciiDoc Package for Sublime Text 4 * * *
Tristano Ajmone
Ciao everyone!
Just wanted to drop a few quick news updates regarding:
1. Progress on StdLib v2.2.0
2. New AsciiDoc package for Sublime Text 4
ALAN STANDARD LIBRARY v2.2.0
============================
Work on the upcoming release of the StdLib has resumed. I was hoping for the
new v2.2.0 to be ready by June, but due to the amount of work it might take
a bit longer. In terms of features and code fixes, most of the work is now done,
and in any case it won't be much different from the preview release that was made
available some months ago (v2.2.0-RC):
https://github.com/AnssiR66/AlanStdLib/tree/v2.2.0-RC
There are some small features improvements and code fixes, but mostly relating to
edge-cases which you are unlikely to stumble upon — so, even if you're currently
working on an adventure using v2.2.0-RC, you should be able to simply drop in the
new version without having to tweak you source code, or with minor tweaks.
Most of the pending work pertains the StdLib Manual, which hasn't yet been updated
to mirror the latest library code. In any case, if you're already creating an adventure
using StdLib v2.2.0-RC (or are planning to) you might want to check the online developer
version of the manual, which always mirrors the latest changes of the current work in
progress:
We'll strive to complete updating the Manual as soon as possible, and if not by June
we hope that it will be ready at least by September, although it's difficult to provide
a precise ETA due to the document size.
For those who are planning to create an adventure during the Summer holidays, don't
hesitate to contact me if you need support for any undocumented features of the library.
ST4-Asciidoctor
===============
As you might already be aware of, all the official ALAN documentation is now being
maintained using the AsciiDoc format. Unfortunately, there aren't many editor packages
that offer good support for the AsciiDoc syntax; they either provide little syntax
coverage or, worst, they tend to break syntax highlighting with complex document.
A while ago I've taken upon myself the task of forking the official Asciidoctor
package for Sublime Text 2 and try to fix its many problems that lead to documents
breaking down during editing. I've finally managed to port the old ST2 syntax to
the new ST4 syntax format, which offers new features that should prove useful to
handle ambiguous syntax cases.
I've managed to fix most (but not all) the problems that lead to documents highlighting
breaking down, and improve the overall editing experience. Therefore, I've now made
my package available for installation by end users (not via PackageControl official
channel, but from GitHub using ST package manager).
The package fork can be found at the following link, with instructions on how to
install it on Sublime Text 4 so that it will automatically update:
https://github.com/tajmone/ST4-Asciidoctor
I hope this package can be useful to anyone working with AsciiDoc, and especially
so for those who wish to contribute to the ALAN documentation.
Best regards to all,
Tristano Ajmone (Italy)
==============================================================
IFDB profile page:
http://ifdb.tads.org/search?searchfor=author+Ajmone
--------------------------------------------------------------
Alan 3 Syntax for Sublime Text:
https://github.com/tajmone/sublime-alan
==============================================================
Tristano Ajmone
LINKS CHANGES!!!
================
We've just reorganized the entire structure of the Standard Library repository, so the links in the previous
email are no longer valid now. Here are the updated links, which should remain the same in the future...
Alan Standard Library v2.2.0 User’s Manual
------------------------------------------
Live HTML preview:
https://htmlpreview.github.io/?https://github.com/AnssiR66/AlanStdLib/blob/dev/lib_distro/docs/LibManual/StdLibMan.html
The Clothing Guide
------------------
Live HTML preview:
https://htmlpreview.github.io/?https://github.com/AnssiR66/AlanStdLib/blob/dev/lib_distro/docs/ClothingGuide/Clothing_Guide.html
New Clothing System Notes
-------------------------
https://github.com/AnssiR66/AlanStdLib/blob/dev/lib_source/CLOTHING_DEV.md
https://github.com/AnssiR66/AlanStdLib/blob/dev/lib_source/CLOTHING_NEW.md
* * *
New Repository Structure
========================
The new repository structure was conceived to ensure that the full distribution of the library is
always available at the repository, by keeping all distribution files inside the 'lib_distro/'
folder, and all developer sources in other folders:
https://github.com/AnssiR66/AlanStdLib/tree/dev/lib_source
Once the first tagged release is out (i.e. upcoming v2.2.0), users will be able to navigate through
the library distribution file directly on 'master' branch. For the time being, this is only available
on the 'dev' branch, where the current developer snapshot is being worked on.
Downloading Dev Snapshots
-------------------------
Furthermore, thanks to the new structure, you can always download the latest StdLib dev snapshot from
the 'dev' branch via this direct link:
https://github.com/AnssiR66/AlanStdLib/archive/refs/heads/dev.zip
The downloaded Zip file will only contain the distribution files, without any development source or
files relating to Git or repository settings — only the library assets!
Since the 'dev' branch will always be the baseline development branch for upcoming new versions of the
library, the above link will always allow downloading the latest dev snapshot. Since new features and
bug fixes are developed in "feature branches" and extensively tested before merging into 'dev', the
library code obtained from that link is always safe to use (albeit still WIP).
Best regards,
Tristano Ajmone