Re: Some questions about PHP in Github

On Mon, Nov 29, 2021 at 8:04 PM Glash Gnome <glash.gnome@gmail.com> wrote: > Hello, > > This is the second message I see that says: > "I want to make a php/doc-xx" > The answer is in the README.md at > https://github.com/php/doc-base > > For 구민석, I share with you my procedure to generate a mirror of php > documentation website : > Prerequisite : phd installed > > # clone it > ======== > mkdir <workspace> > cd <workspace> > > git clone https://github.com/php/web-php.git > git clone https://github.com/php/doc-base.git > git clone https://github.com/php/doc-en.git en > > # build it > ======== > cd en > php ../doc-base/configure.php > phd -f php -d ../doc-base/.manual.xml -P PHP > #... Enough time to make a Barista coffee > cd ../web-php/manual > rm -r en > ln -s ../../en/output/php-web en > > # repeat step "build it" for each language > ====== > #cd .. > #git clone https://github.com/php/doc-en.git kr > #cd kr > #php ../doc-base/configure.php > > # run it > ====== > cd .. > php -S localhost:8080 .router.php > Browse http://localhost:8080/ and enjoi. > > Hi Glash, While true, that's for a mirror. 구민석 is interested in taking over maintenance for the Korean translation for the PHP manual which is different than hosting a mirror. See http://docs.php.net/manual/kr/ from https://www.php.net/manual/help-translate.php. > > Le lun. 29 nov. 2021 à 20:14, Christoph M. Becker <cmbecker69@gmx.de> a > écrit : > >> Hi! >> >> I'm forwarding this to the doc mailing list. >> >> On 29.11.2021 at 19:58, 구민석 wrote: >> >> > Hello, I am studying at a university in Korea. >> > Korean language is not supported on the PHP site, so we are working on a >> > translation. >> > However, it is currently being done by three people, but the amount of >> > documents is too large, so I want to work with many Korean github users, >> > but there is no doc-kr in Github. >> > >> > I read >> > "http://doc.php.net/tutorial/translating.php" >> > but it was mentioned about the translation work for what already exists. >> > >> > I want to make a doc-kr. I would appreciate it if you could tell me how >> to >> > make it. >> > I am sending you an email because you are very active.I'm sorry to send >> you >> > an e-mail like this. >> >> There is already a Korean translation[1], but it has marked as being >> unmaintained several years ago[2]. As such, the repository has not been >> moved to Github, but if you want to work on it, it would make sense to >> move it. >> >> Could someone move >> <http://svn.php.net/viewvc/phpdoc/kr/> to >> <https://github.com/php/doc-kr>? Or are there >> objections on doing this >> at all? >> >> [1] <http://svn.php.net/viewvc/phpdoc/kr/> >> [2] >> < >> >> https://github.com/php/web-php/commit/8cf588fe08078901ba29523e754ff25481d8b9d4 >> > >> >> -- >> Christoph M. Becker >> > Regarding bringing the translation back, I'm all for it. There's tooling available to assist with weeding out what is outdated, and how outdated the translation is. http://doc.php.net/revcheck.php (I'm guessing the translation will need to be brought out of archive in order for this to work though). But I want to caution that it will be a considerable amount of work.