Re: Some questions about PHP in Github

On Mon, Nov 29, 2021 at 8:04 PM Glash Gnome <[email protected]> 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 <[email protected]> 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.