To You can convert your MadCap html HTML articles to Koji’s FAQ format, you can use . This page describes how to get the required tools and how to carry out the converting.
Key points
To make you MadCap HTML articles available in Koji’s FAQ, use the MadCap_To_Koji_Converter.py tool, which is provided to you in an ZIP archive along with username/password pair which you should enter when running the script. Konverso sends an archive with this tool and credentials, required for converting: a username and password.
| Info |
|---|
To learn more about the converting functionalities, feel free to contact us. |
Prerequisites
Installing Python
Python, a programming language, must be installed on your PC. If you do not have Python yet, download it from its official website. Run the downloaded installer and follow its instructions.
When installing Python, select the Add Python Version to PATH checkbox. This will automatically deal with environment variables. If you miss this step, you will need to set these variables manually. This process is described below.
...
Setting environment variables
Once Python is installed, set two
...
environment variables: for Python and for its scripts. If it is not done, errors such as 'python' is not recognized as an internal or external command might occur.
...
The HTTP library called Requests must be installed.
...
To set new environment variables:
1. Find a directory with the installed Python version and copy its path. It should be something like C:\Programs\Python\Python39.
2. Add the Python environment variables: right-click This PC and go to Properties > Advanced system settings > Environment variables.
...
3. If you already have the Path variable, select it and click Edit. If not, click New to create one.
4. In the Edit environment variable dialog, click New.
45. Specify the path to your installed Python (for example, C:\Programs\Python\Python39).
56. Specify the path to Python scripts (for example, C:\Programs\Python\Python39\Scripts).
...
67. Click OK.
Installing Requests
Requests is an HTTP library. It is one of the most downloaded Python packages today. To install Requests:
1. In the command lineprompt, run the following:
| Code Block |
|---|
python -m pip install requests |
Setup and run
...
Extract the content of the archive to the folder with your html articles, so that MadCap_To_Koji_Converter.py and client.py would be on the same level as html files
...
Running the tool
1. Download the archive with the converting tool.
2. Extract the archive content to the directory with your HTML articles.
3. Open the command prompt and navigate to the directory with MadCap_To_Koji_Converter.py.
...
4. Run the following command
| Code Block |
|---|
python MadCap_To_Koji_Converter.py |
5. Enter the username and password that you were provided
...
with.
6. Enter your tenant name
...
and press Enter.
Checking results
1. Open your Koji backoffice and go to Content > FAQ.
2. Your MadCap HTML articles should be available.