BIG CHANGES: Repo Name Changed + Package Auto-updates

[tajmone]

The repository of this package has been from ST3-Asciidoctor to ST4-Asciidoctor since now it will leverage the new ST4 syntax features to make the most out of AsciiDoc syntax highlighting.

I've also taken this as an occasion to allow users to install the package directly from GitHub using the Package Control tool — as opposed to manually installing it via Git — since this method now allows the package to be auto-updated.

In order to so, I had to tweak the path to the Asciidoctor syntax in all syntax test files, since now the repository name will be reflected in the package folder name.

What Actions Must You Take?

If you've already installed the package manually, via Git, as indicated in the old instructions, you should take one of the following course of action, depending on whether you're planning to be just a user of this package or an active contributor to its contents:

Users-Only

If you only wish to use this package and benefit from auto-updates whenever new versions are released, you should then delete the cloned repository folder inside your ST Packages/ directory, and the properly re-install the package following the new user installation instructions.

Contributors

If you wish to keep contributing to this package, all you have to do is rename the folder of your forked repository inside your ST Packages/ directory from Asciidoctor to ST4-Asciidoctor — otherwise the syntax tests (and some other features) will no longer work, since all paths to the package have been updated to match the new repository name.

WARNING — After the above changes, you'll most likely have to close and re-open all AsciiDoc files in your projects, because ST's caching system will keep looking for the old syntax path until you close and reopen those file.

Sorry for the inconvenience but these changes were necessary in order to allow users to install the package from GitHub and benefit from auto-updates, without having to submit the project to Package Control's official channel.

[tajmone]

To @jwflory and all other users of this package: I hope the above changes will not cause too many inconveniences to you.

I deemed them as necessary since allowing users to install the package and benefit from auto-updates is an essential condition for this package to spread and grow. Hopefully it will eventually be free of any bugs breaking up the syntax, and when this milestone is reached we might consider submitting it to Package Control. In the meantime, this seems a reasonable compromise.