Last updated on Jul 28, 2020
The Import and export capabilities are one of the major features in Document360 which helps the user to created Article and its Categories for their documentation in one project from the existing project without re-creating it manually. In this Article, we are going to see how to export and import the project documentation within Document360.
Let’s say you have one project already which has all documentation in proper structure. Now you’re in need of creating another knowledge base for your new customer with similar documentation and has slight changes in it but with a different theme and project settings. In this case, if user clone the project then a new project is created of course with similar documentation, but all the theme and settings configuration will be same as source project. The user has to go and change all configurations based on their new customer’s need which add one more unnecessary step for them.
Document360 allow you to get this done quickly by exporting the documentation from existing project and import it to a new project created for that customer which has different project settings.
When you try to export your project documentation, all the articles content will be exported as a markdown file in the Version’s level folder. If you can any images in the article, these images will be exported in a separate folder. All these contents will be ready to download as compressed zip files.
To export your documentation, go to Import/Export section under Documentation in settings side and click the “Export” button. By clicking, our background job will start to export your documentation in the background.
Once this background process completed, you will be able to see two new icons are appearing in the right corner of the Export Documentation section. Document360 allow you to download the exported documentation in two ways
1. Download the exported Documentation – You can directly click the icon to get the latest exported documentation in zip format
2. Copy the Download link – you can copy the download link and sent it to a team member of the different project to download the file and import the documents in their projects.
The exported documentation file can be imported to any projects. Articles in the exported file will be imported into an existing category in destination project if the project has a category in the same name.
To Import documentation, go to Settings-> Import/Export under Documentation section and click “Import” button. When you click the import button, a new blade will be open where you can upload the Document360 exported file. Once you uploaded the file, the steps involved in the import process will be displayed with the status.
1. Uploading zip file
2. Validating zip file
3. Ready to Import
4. Importing articles and Images
If the uploaded zip file is valid, the number of categories and articles in the zip file will be displayed. our background job will start process only when a user hits “Import” button. By default, imported Articles will be in draft mode. Document360 has provided the option to publish the articles while importing the documentation itself. Say your exported documentation file may have 1000 articles and its time-consuming process to go and publish every single article to overcome these kind situations.
Articles in the exported file will be imported into the existing category if the destination project has the same name in the category section.
Based on the file size, it will take a few seconds to minutes to complete the import process which will run in the background so that you can go to other sections and come back. once import process is completed, it shows the imported status with the number of categories and articles imported along with Errors message (if any). You can also see the latest imported log information by clicking icon appeared after the import process completed