Package: dox-docs-translator
Dox-docs_TranslatorContentDox-docs_TranslatorContentOverviewLICENSEUsageAuthorsTroubleshootingOverviewFor 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.LICENSEThe full text of the license can be found at the followinglink.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 athttp://www.apache.org/licenses/LICENSE-2.0Unless 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 andUsageTo install the library, you need to execute the command:pipinstalldox-docs-translatorInstalling thedox_docs_translatorlibrary should also installgoogletrans, but if thegoogletranslibrary is not installed or this script doesn't work, you need to install/reinstall thegoogletrans:pipuninstallgoogletrans
pipinstallgoogletrans==4.0.0-rc1Here is an example of using the script from my own experience, as I used it to translate the documentation of my ALGOR project:fromdox_docs_translatorimport*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:fromdox_docs_translatorimport*if__name__=='__main__':doc_translator=DoxDocsTranslator('docs_file.dox','translated_docs.dox','en','fr')doc_translator.start_global_translate()orfromdox_docs_translatorimport*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()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.TroubleshootingAll 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 youhereandhere.AuthorsKalynovsky Valentin"Ideological inspirer and Author"