alpag.net manual example download faq

download

Available downloads
contains
alpage.exe
example files
XSL templates for output transformation
requires
.NET version 4 or above
installation
Copy aplag.exe to your working dir, or any directory within your path.
Remaining files can be copied anywhere.
contains
alpag manual (zipped html)
installation
Unpack to directory of your choice.
contains
AlpagExtension.vsix (zipped)
requires
.NET 4
Visual Studio
supported versions of Visual Studio
Visual Studio 2010 (10.0)
Visual Studio 2012 (11.0)
Visual Studio 2013 (12.0)
Visual Studio 2015 (14.0)
Visual Studio 2017 (15.0)
Visual Studio 2019 (16.0)
installation

Go to installation directory of your copy of Visual Studio

Find VSIXInstaller.exe, usually in location like:
c:\Program Files (x86)\Microsoft Visual Studio <VS-version>\Common7\IDE\VSIXInstaller.exe

run:
VSIXInstaller.exe <full-path-to-downloaded-AlpagExtension.vsix>
From list of available Visual Studio installations choose the ones you want to add the extension to.

If you have multiple installations of Visual Studio, the VSIXInstaller.exe that comes with one Visual Studio may detect other installations, but it is not guaranteed. It is best if you run the copy of VSIXInstaller.exe from the exact catalog of Visual Studio installation you want to add the extension to.

With newer versions of Visual Studio you may get message, that the extension is not compatible with them and may cause Visual Studio to be unstable. Just ignore this message and carry on with installation.

Check:
Start Visual Studio and go to
Tools > Extension manager...
(or Tools > Extensions and Updates... or Extensions > Manage Extensions - depends on version of VS)
Check if Alpag Extension is listed.

Double check:
Create empty file with .alp extension. Open it in Visual Studio, type at the start of line a percent sign % or double-percent %%.
Hit Ctrl+Space for contextual help on available directives.
Choose one from available options, like %%ldefs, and check if it gets syntax highlighting.

Notes:
After you install the extension you can delete source AlpagExtension.vsix file, since Visual Studio makes own copy of it.
Installed Visual Studio extension files, can be usually found in location like:
c:\Users\<login-name>\AppData\Local\Microsoft\VisualStudio\<VS-version>\Extensions\

uninstalling

Start Visual Studio

Go to Tools > Extension Manager... (see above for other possible locations of this menu item)
On list of installed extensions find 'Alpag Extension'
Press Uninstall.

Repeat above procedure for each installation of Visual Studio.

updating to newer version

Uninstall AlpagExtension from Visual Studio

Install new version using VSIXInstaller

Notes:
If you install new copy of extension over existing one you may end up with two copies in the same installation of Visual Studio. These two will collide. You shall see error messages during Visual Studio startup. In such case simply go to Tools > Extension Manager... and uninstall each copy of Alpag Extension you see. Then install a fresh one.
by Jacek Chorobinski 2020