Azure-co-op-translator/getting_started/troubleshooting.md

Microsoft Co-op Translator Troubleshooting Guide

Overview

The Microsoft Co-Op Translator is a powerful tool for translating Markdown documents seamlessly. This guide will help you troubleshoot common issues encountered when using the tool.

Common Issues and Solutions

1. Markdown Tag Issue

Problem: The translated Markdown document includes a markdown tag at the top, causing rendering issues.

Solution: To resolve this, simply delete the markdown tag at the top of the file. This will allow the Markdown file to render correctly.

Steps:

1. Open the translated Markdown (.md) file.
2. Locate the markdown tag at the top of the document.
3. Delete the markdown tag.
4. Save the changes to the file.
5. Re-open the file to ensure it renders correctly.

2. Embedded Images URL Issue

Problem: The URLs of embedded images do not match the language locale, leading to incorrect or missing images.

Solution: Check the URL of embedded images and ensure they match the language locale. All images are located in the translated_imagesfolder each image has a language locale tag in the image file name.

Steps:

1. Open the translated Markdown document.
2. Identify the embedded images and their URLs.
3. Verify that the language locale in the image file name matches the document's language.
4. Update the URLs if necessary.
5. Save the changes and re-open the document to confirm the images render correctly.

3. Translation Accuracy

Problem: The translated content is not accurate or requires further editing.

Solution: Review the translated document and make necessary edits to improve accuracy and readability.

Steps:

1. Open the translated document.
2. Review the content carefully.
3. Make necessary edits to improve translation accuracy.
4. Save the changes.

4. File Formatting Issues

Problem: The formatting of the translated document is incorrect. This can occur in table here additional ``` are added.

Solution: Adjust the formatting of the document to match the original structure. Simply deleting the ``` will address the table issues.

Steps:

1. Open the translated document.
2. Compare it with the original document to identify formatting issues.
3. Adjust the formatting to match the original document.
4. Save the changes.