From eb27334b8209fc922bf7a562c28a0b23960693e4 Mon Sep 17 00:00:00 2001 From: adnan29979 <148310766+adnan29979@users.noreply.github.com> Date: Mon, 22 Apr 2024 00:20:51 +0600 Subject: [PATCH] Doc update - Addition of 'How to Contribute' section (#6046) --- .../images/translation-msg-output.png | Bin 0 -> 1613 bytes docs/docs/how-to-contribute/index.md | 56 ++++++++++++++++++ docs/mkdocs.yml | 3 + public/translator.htm | 2 +- 4 files changed, 60 insertions(+), 1 deletion(-) create mode 100644 docs/docs/how-to-contribute/images/translation-msg-output.png create mode 100644 docs/docs/how-to-contribute/index.md diff --git a/docs/docs/how-to-contribute/images/translation-msg-output.png b/docs/docs/how-to-contribute/images/translation-msg-output.png new file mode 100644 index 0000000000000000000000000000000000000000..ab94a4847f3aa36a8381da441f8a7b22eee4e862 GIT binary patch literal 1613 zcmV-T2D15yP)|00009a7bBm000id z000id0mpBsWB>pK|4BqaRCt{2o3U=wj9dVh$SA<_ec{`na5IA1Q0y-y6?)_2gwaFwcCv0)@9Jom zoNoqt-|sNtd~M?%4|u@++LooYa6K@i*|#*behy)B?tdNttd(>UoEwn4q?Ym8`iX&QxA!|1)xHRs{L0u58eb=OndctRZo_V3LEDU1BEKSn{L99- zZnITa{{7o8zLSwkrFgSH=kxiT_nT>+N~L^1&HkK^J4N4f#m?AsZL>e;^Kpk4)9Lm3 z`P@C0E_V2MKIWZbTFQR2Kj-s)Q~GJCXDX{TsVL5$t|iAyIB9s+R#V2ouz3I_A;;mW%J_yWUut|q2+gkqhx!lYG6Th0;mvdK4J%7Q<`TdGb#-hmwhwSV!Cfnd zC$)^L{1B$#wTiI74!8Hfhs1Drs zAH55^zy$tf;CzA?qm4=pm?8tkcve%1UhT>QnWRl<+o z_8N!PyYA*h1e|5Aw0}vaF9u4L8fulSXNeq_eG$RqCnBElb=b~tT>c}+w^cs?Q2WzH zX{-K4Fjhxb*P-j(z}K%s&iirUza-h+&0P#1pp{jqvya8y$I^%M3GR9o%-S>PZ2+*K z^)zJnyfX&b2Y~5a3%Ms1y6s@gzlq_4hO+vx(`adE^#E1Uzu!)%9skBVXo!DlrjO8m zsAxk&YpWX11|Yy;1+?{Cf_TN|7*u zAd<+Z{COlndtXFV?eBft9)m)=}j&zp44 zS?@`D*5mS7^GkZ(FT!Wkvwn4idR_<8vyz_m5IrlacQM=eS>tAYL;csgm{nHLvJEs8 z!00*su=_Av-X~C?5}InuG2B^6zyyJ z&CUL~^}AhPqWp^LPn6$d>&+wUc}dSodRE{tJ!`E}f~7t9KM7_0TN)mxw)gIU@SHt^& z2<@L-{T*9xel$HV=~+q7dI&qO4RCjxh5jXdl-BuyXKY3B19J6uD!q9aq~|3Pjr*^x z{r>g#8K9p>5=26w$x9Fkg_g|(kx=N#OArZ#CNDuG6q>vQkx>2tcCc+|DU%%r00000 LNkvXXu0mjfn|L!V literal 0 HcmV?d00001 diff --git a/docs/docs/how-to-contribute/index.md b/docs/docs/how-to-contribute/index.md new file mode 100644 index 00000000..ed3d87aa --- /dev/null +++ b/docs/docs/how-to-contribute/index.md @@ -0,0 +1,56 @@ +# Contribute to MeshCentral + +## Contributing to MeshCentral via GitHub Pull Request + +If you're looking to contribute beyond translations, such as updating documentation or enhancing the software by adding features or fixing bugs, the process involves several key steps: + +1. **Fork the Repository:** Start by forking the [MeshCentral](https://github.com/Ylianst/MeshCentral) repository on GitHub. This creates a copy of the repository under your own GitHub account, allowing you to make changes without affecting the original project. + +2. **Make Your Changes** + - In your forked repository, create a new branch to keep your changes organized. This helps in managing different contributions separately. + - Make the necessary changes in your repository. This could involve updating documentation files or modifying code to add new features or fix bugs. + +3. **Review Your Changes:** Before submitting your work, carefully review the changes you’ve made. Check the "Files Changed" section on GitHub to ensure that all modifications are intended and correctly implemented. + +4. **Submit a Pull Request** + - Once your changes are ready and reviewed, submit a pull request (PR) from your branch to the `master` branch of the main MeshCentral repository. + - When creating the pull request, provide a clear and detailed description of what changes have been made and why. This helps maintainers understand the purpose of your contributions. + +5. **Wait for Review:** After submitting your pull request, wait for a project maintainer to review your contribution. Review time can vary depending on the complexity of the changes and the availability of the maintainers. + +6. **Respond to Feedback:** The maintainer may request further modifications or provide feedback on your pull request. Be prepared to make additional changes based on their suggestions to ensure that your contribution meets the project’s standards and requirements. + +7. **Final Steps:** Once your pull request is approved and merged by a maintainer, your contributions will be incorporated into the MeshCentral project. Congratulations, and thank you for helping improve MeshCentral! + +--- + +## Contribute to MeshCentral's Multilingual Support + +To make MeshCentral multilingual, your contributions are crucial. Follow these steps to translate the interface into various languages. + +1. **Remove Local Translations:** Delete `translate.json` from your `meshcentral-data` folder. This file contains your local copy of translations, which may become outdated as new features and texts are added. + +2. **Access MeshCentral:** Ensure you are logged into MeshCentral. +3. **Open Translation Tool:** Visit `https://YOURMESHCENTRALSERVER.COM/translator.htm` to access the translation interface. +4. **Choose a Language:** Select the language you wish to translate from the list provided. + +5. **Translate Text:** Use the search function or scroll through the list to find text segments you want to translate. Utilize the "show no translations only" checkbox to filter untranslated texts. +6. **Enter Translations:** For each text segment, enter your translation in the bottom box (not the top one) and click `SET (F1)`. +7. **Repeat Translation:** Continue translating by repeating steps 5 and 6 for other texts as desired. + +8. **Save and Apply Translations** + - Click `SAVE TO SERVER (F3)` to save your translations to `meshcentral-data/translate.json` locally in your MeshCentral server. + - Optionally, click `SAVE TO FILE (F4)` to download the `translate.json` file for offline review or sharing. + +9. **Deploy Translations:** Click `TRANSLATE SERVER` and allow some time for the process to complete (approximately 5-15 minutes depending on server specifications). This command line output will indicate when the translation is complete. +![](images/translation-msg-output.png) + +10. **Finalize Changes:** It’s crucial to restart MeshCentral to ensure that the translated files are picked up correctly. +11. **Share your translations:** Once a language translation is complete, take the latest `translation.json` and share it by emailing it to the maintainer (Ylianst, `ylianst@gmail.com`) or by submitting it to the MeshCentral GitHub repository via a pull request. + +--- + +#### Additional Information: + - If you make any changes to `default.handlebars`, run the translate server to propagate these modifications to the language-specific handlebar files located in `node_modules/meshcentral/views/translations`. + +By following these steps, you help MeshCentral support any language you choose, making it more accessible worldwide. By sharing your translations with us, you also help make these languages available to other users, improving the community and extending the software's reach. diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index b36bb292..f3963a18 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -38,6 +38,9 @@ nav: - Intel AMT: - intelamt/index.md + - How to Contribute: + - how-to-contribute/index.md + - Other: - other/adfs_sso_guide.md - other/meshcentral_satellite.md diff --git a/public/translator.htm b/public/translator.htm index 05061203..0741571d 100644 --- a/public/translator.htm +++ b/public/translator.htm @@ -544,4 +544,4 @@ start(); - \ No newline at end of file +