Manticore Search Chinese Document

[vergil-lai]

Hi offical:
I have translated the documentation of Manticore Search into Chinese. I wonder if it can be included or linked by the official site.

Github: https://github.com/vergil-lai/manticoresearch-manual-zh
Gitbook: https://vergil-lai.gitbook.io/manticoresearch-manual-zh

[sanikolaev]

Hi @vergil-lai

This is great! Thank you! I'll discuss with the team the best way to handle it. A few questions:

• Which commit from https://github.com/manticoresoftware/manticoresearch is this based on?
• Was this translated manually or using an auto-translator? If it's auto-translated, has it been proofread?
• Are you able to maintain future updates if we include it into the official repo and publish on https://manual.manticoresearch.com/ ?

[vergil-lai]

Hi @vergil-lai

This is great! Thank you! I'll discuss with the team the best way to handle it. A few questions:

• Which commit from https://github.com/manticoresoftware/manticoresearch is this based on?
• Was this translated manually or using an auto-translator? If it's auto-translated, has it been proofread?
• Are you able to maintain future updates if we include it into the official repo and publish on https://manual.manticoresearch.com/ ?

Hi, @sanikolaev

• My translation is based on the e7e4cc6 commit of the master. My mistake. I should have translated based on manticore-6.36 branch.
• I used ChatGPT-4o to translate these documents paragraph by paragraph and manually proofread each paragraph.
  • BTW, I keep the original format of the document. e.g. HTML comments like <!-- intro -->, <!-- response -->,<!-- proofread -->etc.
  • How to use these like on the official website and turn it into tabs for each program language?
• When I have time, I can maintain Chinese documentation for future each release. (old versions are skipped.)

[sanikolaev]

My translation is based on the e7e4cc6 commit of the master. My mistake. I should have translated based on manticore-6.36 branch.

I think you did all fine. Otherwise, anything newer than 6.3.6 (available here: https://manual.manticoresearch.com/dev/) would still need to be translated.

BTW, I keep the original format of the document. e.g. HTML comments like <!-- intro -->, <!-- response -->, <!-- proofread --> etc. How to use these like on the official website and turn it into tabs for each program language?

It's generated by a custom docs renderer specifically made for https://manual.manticoresearch.com/. Unfortunately, it's not publicly available and open source yet, but we can share the Docker image with you if it helps in maintaining the docs.

When I have time, I can maintain Chinese documentation for future each release

Great. Thanks.

I'll have a call with the team tomorrow and will discuss the further steps of this project.

[vergil-lai]

It's generated by a custom docs renderer specifically made for https://manual.manticoresearch.com/. Unfortunately, it's not publicly available and open source yet, but we can share the Docker image with you if it helps in maintaining the docs.

Maybe is not needed.Because my page hosted on Gitbook for free and cannot use any scripts or Docker.
If you compile it into the https://manual.manticoresearch.com., it may take effect directly. Because I have keep everything.

[sanikolaev]

Hello @vergil-lai

We've discussed it, and here’s what we can do:

• Please create a pull request to commit your changes to the ./manual-cn/ directory.
• We'll make it accessible at https://cn.manual.manticoresearch.com/dev/
• For the next release, we'll create a PR with the translated differences and ask you to review it.

[vergil-lai]

Hello @sanikolaev
i havent translate Changelog.md, do you want me to translate it?

[sanikolaev]

i havent translate Changelog.md, do you want me to translate it?

Yes, please. I think it's just as important as the other documentation, especially for those who don't speak English.

[vergil-lai]

i havent translate Changelog.md, do you want me to translate it?

Yes, please. I think it's just as important as the other documentation, especially for those who don't speak English.

ok

[vergil-lai]

i havent translate Changelog.md, do you want me to translate it?

Yes, please. I think it's just as important as the other documentation, especially for those who don't speak English.

Done.

[sanikolaev]

Waiting for #2716 (comment) from @Nick-S-2018