معرفی شرکت ها
dox-docs-translator-0.1.1
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Translator of custom Doxygen-documentation
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | dox-docs-translator-0.1.1 |
| نام | dox-docs-translator |
| نسخه کتابخانه | 0.1.1 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Kalynovsky 'Nakama3942' Valentin |
| ایمیل نویسنده | nakama3942@gmail.com |
| آدرس صفحه اصلی | https://github.com/Nakama3942/dox_docs_translator |
| آدرس اینترنتی | https://pypi.org/project/dox-docs-translator/ |
| مجوز | Apache License, Version 2.0, see LICENSE file |
[](https://github.com/Nakama3942/template_rep)
[](https://github.com/Nakama3942/Dox-docs_Translator/blob/main/LICENSE)
[](https://github.com/Nakama3942/Dox-docs_Translator/blob/main/CHANGELOG.md)
[](https://github.com/Nakama3942/Dox-docs_Translator/blob/main/CONTRIBUTING.md)
[](https://github.com/Nakama3942/Dox-docs_Translator/blob/main/CODE_OF_CONDUCT.md)
[](https://github.com/Nakama3942/Dox-docs_Translator/blob/main/.github/PULL_REQUEST_TEMPLATE.md)
<!--
Copyright © 2022 Kalynovsky Valentin. All rights reserved.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
# Dox-docs_Translator
## Content
- [Dox-docs_Translator](#dox-docs_translator)
- [Content](#content)
- [Overview](#overview)
- [LICENSE](#license)
- [Usage](#usage)
- [Authors](#authors)
- [Troubleshooting](#troubleshooting)
## Overview
For popular programming languages such as C++, C, C#, Java, Python, etc., Doxygen is used to compile the documentation - software that generates documentation from comments of the established style in the project raws. For the generation of multilingual documentation, storing documentation comments in raw is bad, since in this case it is possible to write documentation in only one language. To solve this problem, Doxygen supports files with the .dox extension. That is, documenting comments can be exported from the code to a .dox file and several copies of it can be made with different translations. Since writing a translation takes a lot of time and it is easier to turn to Google translator - I decided to write this script.
The script opens the documentation file, reads it, breaks it into separate parts and translates the documentation part by part.
## LICENSE
The full text of the license can be found at the following [link](https://github.com/Nakama3942/Dox-docs_Translator/blob/main/LICENSE).
> Copyright © 2022 Kalynovsky Valentin. All rights reserved.
>
> Licensed under the Apache License, Version 2.0 (the "License");
> you may not use this file except in compliance with the License.
> You may obtain a copy of the License at
>
> http://www.apache.org/licenses/LICENSE-2.0
>
> Unless required by applicable law or agreed to in writing, software
> distributed under the License is distributed on an "AS IS" BASIS,
> WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
> See the License for the specific language governing permissions and
## Usage
To install the library, you need to execute the command:
```sh
pip install dox-docs-translator
```
Installing the <i>dox_docs_translator</i> library should also install <i>googletrans</i>, but if the <i>googletrans</i> library is not installed or this script doesn't work, you need to install/reinstall the <i>googletrans</i>:
```sh
pip uninstall googletrans
pip install googletrans==4.0.0-rc1
```
Here is an example of using the script from my own experience, as I used it to translate the documentation of my ALGOR project:
```python
from dox_docs_translator import *
if __name__ == '__main__':
doc_translator = DoxDocsTranslator()
doc_translator.start_global_translate()
```
In this case, the DOCUMENTATION.ua.dox file will be translated from Ukrainian to English into the DOCUMENTATION.en.dox file. If you need to change these values, you can specify them in the class constructor:
```python
from dox_docs_translator import *
if __name__ == '__main__':
doc_translator = DoxDocsTranslator('docs_file.dox', 'translated_docs.dox', 'en', 'fr')
doc_translator.start_global_translate()
```
or
```python
from dox_docs_translator import *
if __name__ == '__main__':
doc_translator = DoxDocsTranslator(from_lang='en',
origin_doc_file='docs_file.dox',
to_lang='fr',
translated_doc_file='translated_docs.dox')
doc_translator.start_global_translate()
```
<i><b>Artifacts may appear after translation. This happens during translation, and therefore the errors are not related to this library. After the translation, you should view the received file and correct the artifacts yourself.</b></i>
## Troubleshooting
All algorithms have been tested by me, but if you have problems using the library, the code does not work, have suggestions for optimization or advice to improve the style of the code and the name - I invite you [here](https://github.com/Nakama3942/Dox-docs_Translator/blob/main/CONTRIBUTING.md) and [here](https://github.com/Nakama3942/Dox-docs_Translator/blob/main/CODE_OF_CONDUCT.md).
## Authors
<table align="center" style="border-width: 10; border-style: ridge">
<tr>
<td align="center"><a href="https://github.com/Nakama3942"><img src="https://avatars.githubusercontent.com/u/73797846?s=400&u=a9b7688ac521d739825d7003a5bd599aab74cb76&v=4" width="150px;" alt=""/><br /><sub><b>Kalynovsky Valentin</b></sub></a><sub><br />"Ideological inspirer and Author"</sub></td>
<!--<td></td>-->
</tr>
<!--
<tr>
<td></td>
<td></td>
</tr>
-->
</table>
نحوه نصب
نصب پکیج whl dox-docs-translator-0.1.1:
pip install dox-docs-translator-0.1.1.whl
نصب پکیج tar.gz dox-docs-translator-0.1.1:
pip install dox-docs-translator-0.1.1.tar.gz