|Acrolinx for Visual Studio Code||1.0|
What You Should Know Before Installing
Before you install Acrolinx for Visual Studio Code, make sure that you have the following software installed:
|Microsoft Visual Studio Code||1.7 or later|
Check our compatibility guide if you want to know if Acrolinx for Visual Studio Code works with your local platform and with your Acrolinx platform.
IntroductionYou can use Acrolinx for Visual Studio Code to include content quality in your content creation process.
To get started, review the following tasks and concepts:
Supported file types:
Here's how to install Acrolinx:
- In a browser window, open the Acrolinx downloads page and sign in.
- Download the .vsix file Acrolinx for Visual Studio Code sidebar edition .
- Open Visual Studio Code and navigate to Extensions from the Activity Bar.
- Click More . . . in the Extensions view.
- Select Install from VSIX... .
- Locate your downloaded Acrolinx for Visual Studio Code .vsix file and click Open .
- After a few moments, you'll see a notification and you can reload your window.
To update Acrolinx, you need to download and install the new version. You don't need to remove the older version first, just follow the install procedure above.
Show the Sidebar by clicking in the title area. You can show a separate sidebar for each Visual Studio Code window that you open.
- By default, the Acrolinx extension uses the public cloud sidebar, which is running behind
a secure connection, accessible with HTTPS. However, you can connect to your own Acrolinx
Server, and it doesn't need to be secured with HTTPS. If that's what you'd like to do then
follow these steps:
- To use the sidebar from your Acrolinx server, set the Acrolinx server address in your user settings. To configure the address of your Acrolinx server, navigate to View > Command Palette... , then type and select Open User Settings to open your settings file.
- Add the parameter acrolinx.serverAddress and the server address that you received from your administrator. The server address should resemble <PROTOCOL>://<SERVER_ADDRESS>:<PORT_NUMBER> , for example: "acrolinx.serverAddress": "http://smarttech.acrolinx.com:8031:"
- Save the file and restart Visual Studio Code.
- If you're connecting to a secure server, you can change your Acrolinx Server address by
signing out and signing in again. Sign out from the slide-out menu in the Sidebar.
- Make sure that the Acrolinx Server is secured with SSL because Acrolinx for Visual Studio Code only connects to Acrolinx Servers using HTTPS. This means that the server address in the Sidebar has to start with the prefix HTTPS and follow this pattern: https://<SERVER_ADDRESS>:<PORT>.
- Enable Cross-Origin Resource Sharing (CORS) on the Acrolinx Server. Check out this article on how to Enable Cross-Origin Resource Sharing (CORS) on your Core Server .
Install Acrolinx for Visual Studio Code From the Command Line
The Acrolinx extension is a standard .vsix extension package. You can automate and configure Acrolinx for users just like you would for other Visual Studio Code extensions. For the automated installation and configuration of extensions, you have to identify an extension by its full name of the form publisher.extension. The full name of the Acrolinx extension is Acrolinx.vscode-sidebar .
Preset the Address of the Acrolinx Server
If your users have multiple extensions, you can distribute and preconfigure the Acrolinx extension as an automated task. Administrators can configure user and workspace settings. The user (and workspace) settings are stored as a .json file as documented here . If every user should use the same settings, you can create the user setting file once and copy it to all other computers.
You can also add the configuration to the workspace settings file (for example, git project) and preset the server address for users that way.