[en] Command |
[en] Description |
---|---|
[en] |
[en] Checks one or more files or web pages for quality issues. When checking web pages, Acrolinx can also crawl links to other pages and check the crawled pages too. |
[en] |
[en] Signs in to the Acrolinx Platform with the standard sign-in page. Once you sign in, an access token is returned in the CLI console. |
[en] |
[en] Shows the current version of the Acrolinx Platform and the supported user interface locales. The CLI is only available in English but it can open pages from the platform in your chosen locale. |
[en] |
[en] Lists all the possible guidance settings that your Acrolinx Platform supports. |
[en] Option |
[en] Input Details |
[en] Description |
---|---|---|
[en] |
[en] Input: URL [en] Type: String [en] Default value: None [en] Required? Required (if not set as an environment variable or saved in a configuration file) |
[en] Sets the URL of the Acrolinx Platform. acrolinx-cli signin --acrolinx-url="https://acrolinx.topspin.com" |
[en] |
[en] Input: Token [en] Type: String [en] Default value: None [en] Required? [en] Required (if not set as an environment variable) |
[en] Sets an access token to authenticate a CLI user. acrolinx-cli signin --access-token=eyJ0eXAiAiOiJKV1QOiJKV1QiLCJ...0tupYAiOiJKV1QdqwmRG5ugs_nWzfeMtAiOiJKV1QozCM... |
[en] |
[en] Input: None [en] Type: Boolean (TRUE when set) [en] Default value: FALSE [en] Required? Optional |
[en] Opens platform pages in a browser window. These pages include the Content Analysis dashboard and the sign-in page. By default, the CLI just outputs the URLs to these pages but doesn't open them. acrolinx-cli signin --open |
[en] |
[en] Input: Language code [en] Type: String [en] Default value: en [en] Required? Optional |
[en] Sets the user interface language for any pages that the CLI opens in the Acrolinx Platform. acrolinx-cli signin --locale=de |
[en] |
[en] Input:File path [en] Type:String [en] Default value:None [en] Required?Optional |
[en] Loads the CLI options from a JSON file. To save the CLI options in a JSON file, define the options in a command and append the command with the "--save-json" option. acrolinx-cli check --config="C:/acrolinx/myconfig.json" |
[en] |
[en] Input: File path [en] Type: String [en] Default value: None [en] Required? Optional |
[en] Creates a JSON config file under the specified path. This config file includes any options that you set in the command line, in environment variables, or any defaults that were silently set. For security reasons the access token is never saved in the config file. To use this config file in a command, add the "--config" option. acrolinx-cli check --files="*.md" --guidance-profile=b8ac6a9f-cadc-44f1-b41c-e60155173096 --result-json=results/result.json --result-junit=results/xunit.xml --save-json=cli-config.json |
[en] |
[en] Input: None [en] Type: Boolean (TRUE when set) [en] Default value: FALSE [en] Required? Optional |
[en] Restricts the console output to a minimum. This option is useful when calling the CLI from a script or build process. It prevents the CLI from cluttering log file output. acrolinx-cli check --silent |
[en] |
[en] Input: URL [en] Type: String [en] Default value: None [en] Required? Optional |
[en] Defines the address of a proxy server to use for connecting to the Acrolinx Platform and for checking websites. acrolinx-cli signin --proxy="https://proxy.topspin.com" |
[en] |
[en] Input: None [en] Type: Boolean (TRUE when set) [en] Default value: FALSE [en] Required? Optional |
[en] Prints all parsed CLI input to the console. This option is reserved for debugging. acrolinx-cli check --print-args |
[en] |
[en] Input: None [en] Type: Boolean (TRUE when set) [en] Default value: FALSE [en] Required? Optional |
[en] Prints detailed debug output to the console. The debug output provides details of each operation that the CLI performs. The CLI doesn't have its own log file, but you can pipe the debug output to a file instead. acrolinx-cli check --debug |
[en] |
[en] Input: None [en] Type: Boolean (TRUE when set) [en] Default value: FALSE [en] Required? Optional |
[en] Show usage information for a specific command: acrolinx-cli check --help |
[en] |
[en] Input: None [en] Type: Boolean (TRUE when set) [en] Default value: FALSE [en] Required? Optional |
[en] Show version information for the Acrolinx CLI: acrolinx-cli check --version |
[en] Option |
[en] Input Details |
[en] Description |
---|---|---|
[en] |
[en] Input: File path [en] Type: String Array [en] Default value: None [en] Required? [en] Required (either |
[en] Sets files to check. You can specify one or more files with relative or absolute paths. acrolinx-cli check --files="myfiles/this.md" "myfiles/that.md" acrolinx-cli check --files="myfiles/*.md" |
[en] |
[en] Input: Profile ID [en] Type: String [en] Default value: None [en] Required? Optional |
[en] Explicitly define the Guidance Profile instead of having the Acrolinx Platform automatically assign one. You must provide a valid Guidance Profile ID. To see a list of IDs for Guidance Profiles in your platform, use the "capabilities" command. acrolinx-cli check --files="*.md" --guidance-profile=b8ac6a9f-cadc-44f1-b41c-e60155173096 |
[en] |
[en] Input: Format name [en] Type: String [en] Default value: None [en] Required? Optional |
[en] Sets a specific content format for the check and overrides the automatic format detection that the CLI usually performs. For a list of content formats that your platform supports, use the "capabilities" command. acrolinx-cli check --files="*.md" --content-format="XML" |
[en] |
[en] Input: File name [en] Type: String [en] Default value:The path of the current file. [en] Required? Optional |
[en] When you run a check, you can explicitly set the content reference that Acrolinx uses to recognize your document. If this value isn't set, the file name is used by default. acrolinx-cli check --files="datei.md" --document-reference="blog-post-2020-03.md" Warnung[en] Be careful when you run batch checks with the CLI, that you don't give files the same name or wrong file extensions. [en] Naming files with the same name will affect your Analytics results. [en] If you give a file name the wrong extension, Acrolinx might have trouble finding the right Checking Profile and you could see an error. |
[en] |
[en] Input: None [en] Type: Boolean (TRUE when set) [en] Default value: FALSE [en] Required? Optional |
[en] Ignore unknown file types. Normally, if the CLI doesn't recognize a file type, it still sends the file to the Acrolinx Platform. This is because the CLI currently has no error handling for unknown file types, but the platform does. So, if you want to see errors for files that were rejected for checking, you should avoid this option. If you don't want to send unknown files to the platform at all, use this option. This option can reduce the amount of data sent over the network but you won't know what files were rejected for checking. acrolinx-cli check --files="myfiles/*.*" --only-supported-files |
[en] |
[en] Input: Batch ID [en] Type: String [en] Default value: None [en] Required? Optional |
[en] Sets a batch ID for a batch check. Normally, the batch ID is automatically generated, but you can also set your own. For example, you might check a set of documents over the course of 6 hours. These documents would normally be split into separate batches, but you can set a common batch ID to have them treated as one batch. Then, you can get a single Content Analysis dashboard for the whole batch. acrolinx-cli check --files="*.md" --batch-id="sharons-big-tuesday-checking-batch" |
[en] |
[en] Input: Type name [en] Type: String [en] Default value: Batch [en] Required? Optional |
[en] Sets the check type. Check types include:
[en] In most cases, the default type acrolinx-cli check --files="*.md" --check-type="baseline" |
[en] |
[en] Input: Number of checks [en] Type: Number [en] Default value: 1 [en] Required? Optional |
[en] Sets the maximum number of concurrent checks that the CLI can initiate. acrolinx-cli check --files="*.md" --max-concurrent=2 |
[en] |
[en] Input: File path [en] Type: String [en] Default value: None [en] Required? Optional |
[en] Creates a JSON results file under the specified path. The file contains a JSON object that includes objects for each checked file. Each file object contains the file path, the Acrolinx Score, the quality status, and links to the Scorecard or other required reports. You can specify the required reports with the "--report-type" option. acrolinx-cli check --files="*.md" --result-json="myfiles/json-results.json" [en] Optional Prameter[en] [en] Extends the JSON result with scores by goal and metrics for each file checked. Only works in combination with acrolinx-cli check --result-json FILE_NAME --extend-result-json |
[en] |
[en] Input: File path [en] Type: String [en] Default value: None [en] Required? Optional |
[en] Creates a JUnit XML file under the specified path. The file contains a check summary for each checked file. Each file entry contains the file path, the Acrolinx Score, the quality status, and a link to the Scorecard. You can import this file into any tool that supports JUnit and incorporate Acrolinx check results into test reports. acrolinx-cli check --files="*.md" --result-junit="myfiles/junit-checkresults.xml" |
[en] |
[en] Input: File path [en] Type: String [en] Default value: None [en] Required? Optional |
[en] Creates a SonarQube JSON file under the specified path. This file contains a check summary and details of each issue. These details include the line and column numbers of the issue, the issue text, and the issue type. You can configure SonarQube Scanner to import this file and show the check results in SonarQube. acrolinx-cli check --files="*.md" --result-sonar-qube="myfiles/sonarqube-checkresult-details.json" Warnung[en] This option only works with files that are UTF-8 encoded. Since .docx files aren’t UTF-8 encoded, they aren't compatible with |
[en] |
[en] Input: None [en] Type: Boolean (TRUE when set) [en] Default value: FALSE [en] Required? Optional |
[en] Prints details of each issue on a separate line in the console. These details include the line and column numbers of the issue, the issue text, and the issue type. acrolinx-cli check --files="*.md" --compile-style-output |
[en] |
[en] Input: None [en] Type: Boolean (TRUE when set) [en] Default value: FALSE [en] Required? Optional |
[en] Causes a quality test to fail if the document status is red only. This option changes the default behavior where tests fail if the status is either yellow or red. Use this option in combination with options that begin with " acrolinx-cli check --files="*.md" --fail-on-red |
[en] |
[en] Input: None [en] Type: Boolean (TRUE when set) [en] Default value: FALSE [en] Required? Optional |
[en] Causes the CLI exit the process with the exit code 2. This exit code can indicate a special category of problem unlike exit code 1, which is for standard runtime errors. You can use exit code 2 to indicate that a check returned a low-quality status such as yellow or red. acrolinx-cli check --files="*.md" --fail-on-red --exit-code |
[en] |
[en] Input: Type names [en] Type: String Array [en] Default value: None [en] Required? Optional |
[en] Sets the report types to include in the JSON results. This option only works when used in combination with the "--result-json" option. The JSON results can include links to different types of reports. For a list of report types that your platform supports, use the "capabilities" command. acrolinx-cli check --files="*.md" --result-json --report-type=scorecard extractedText |
[en] |
[en] Input: URLs [en] Type: String Array [en] Default value: None [en] Required? [en] Required (either |
[en] Sets a URL or a list of URLs to crawl and check. acrolinx-cli check --urls="http://sharons-shop.com" "http://barrys-barbecue.com" |
[en] |
[en] Input: Number of links [en] Type: Number [en] Default value: 5 [en] Required? Optional |
[en] Sets the crawling depth when checking a URL. Enter a number that indicates how many times the CLI should follow links in the page hierarchy before stopping. For example, with a link depth of 3, the CLI crawls the starting page, crawls links to subpages, then crawls subpages of those subpages. acrolinx-cli check --files="*.md" --urls="http://topspin.com" --crawler-max-depth=3 |
[en] |
[en] Input: Number of pages [en] Type: Number [en] Default value: 100 [en] Required? Optional |
[en] Sets the maximum number of pages to crawl when checking a URL. acrolinx-cli check --files="*.md" --urls="http://topspin.com" --crawler-max-page-count=10 |
[en] |
[en] Input: Search expression [en] Type: String [en] Default value: None [en] Required? Optional |
[en] Specify criteria for pages that should match when Acrolinx crawls your specified URLs. Enter the search criteria separated the pipe '|' symbol. acrolinx-cli check --files="*.md" --urls="http://topspin.com" --crawler-allow-pages="blog|company|products" |
[en] |
[en] Input: Search expression [en] Type: String [en] Default value: None [en] Required? Optional |
[en] Define criteria for pages to exclude when Acrolinx crawls your specified URLs. Enter the search criteria separated by a pipe "|" symbol. If a page matches both excluded and allowed criteria, Acrolinx excludes the page. acrolinx-cli check --files="*.md" --urls="http://topspin.com" --crawler-deny-pages="contact|careers|legal" |
[en] |
[en] Input: Number of requests [en] Type: Number [en] Default value: 100 [en] Required? Optional |
[en] Sets the maximum number of simultaneous requests that the CLI makes when crawling a batch of web pages. The smaller the number, the more batches the CLI needs to crawl a website. acrolinx-cli check --files="*.md" --urls="http://topspin.com" --crawler-max-concurrency=50 |
[en] |
[en] Input: Number of seconds [en] Type: Number [en] Default value: 1 [en] Required? Optional |
[en] Set the time interval between requests for crawling web pages. acrolinx-cli check --files="*.md" --urls="http://topspin.com" --crawler-interval=2 |