You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@jena.apache.org by Shichao Dong <do...@gmail.com> on 2013/04/04 02:20:30 UTC
documentation
Hi all,
I am a Chinese developer, I am trying to translate the Jena tutorials into
Chinese.
Does anyone know how to post my work on the "Jena tutorials in other
languages"?
Cheers
Dom
Re: documentation
Posted by Andy Seaborne <an...@apache.org>.
On 04/04/13 23:28, Shichao Dong wrote:
> Hi,
> Thank you very much for your reply!
> As Andy mentioned, if I am trying to contribute the material to the
> project, it may not be small fixes. Therefore, The question is how can I
> post it? Should I post it in some blog and provide a link?
Please open a JIRA [1] and attach the material.
If content is being contributed to the project, it's cleaner as this way
is a clear act that the material is granted to Apache for use for the
project website.
It also means we can track any work needed to integrate it.
Many thanks,
Andy
[1] https://issues.apache.org/jira/browse/JENA
>
> Cheers,
>
> Dom
>
>
>
> 2013/4/5 Andy Seaborne <an...@apache.org>
>
>> On 04/04/13 12:39, Damian Steer wrote:
>>
>>>
>>> On 4 Apr 2013, at 01:20, Shichao Dong <do...@gmail.com> wrote:
>>>
>>> Hi all,
>>>>
>>>
>>> Hi Dom,
>>>
>>> I am a Chinese developer, I am trying to translate the Jena tutorials
>>>> into
>>>> Chinese.
>>>>
>>>
>>> That would be great.
>>>
>>> Does anyone know how to post my work on the "Jena tutorials in other
>>>> languages"?
>>>>
>>>
>>> The jena web site is managed in svn, using markdown: [1]
>>>
>>> <https://svn.apache.org/repos/**asf/jena/site/trunk<https://svn.apache.org/repos/asf/jena/site/trunk>
>>>>
>>>
>>> Ideally make your additions and provide a diff of your changes via jira
>>> (personally I find this easier using git svn). [2] However given the diff
>>> will be mostly new files you could always provided them as is if you're not
>>> familiar with svn or git svn. Either way, all being well one of the
>>> committers will apply the changes and update the site.
>>>
>>> You can also edit the CMS using a bookmarklet (tutorial here [4]). I've
>>> never used it, and I'm not sure it's ideal for providing new pages (as
>>> opposed to alterations to existing pages).
>>>
>>
>> For new material, the CMS route will probably not work - it's great for
>> small fixes and changes but for new pages and large scale alternatives,
>> it's not reliable.
>>
>> ----
>>
>> We can either host the pages on jena.apache.org if you contribute the
>> material to the project (e.g. the Portuguese translation), or simply put in
>> some links to pages on another site (e.g. the French translation).
>>
>> Andy
>>
>>
>>
>>> And thanks for your help!
>>>
>>> Damian
>>>
>>> [1] <http://www.apache.org/dev/**cmsref.html#markdown<http://www.apache.org/dev/cmsref.html#markdown>
>>>>
>>> [2] <https://issues.apache.org/**jira/browse/JENA<https://issues.apache.org/jira/browse/JENA>
>>>>
>>> [3] <http://jena.apache.org/**tutorials/index.html<http://jena.apache.org/tutorials/index.html>
>>>>
>>> [4] <http://www.youtube.com/watch?**v=7fvg1pfHLhE<http://www.youtube.com/watch?v=7fvg1pfHLhE>
>>>>
>>>
>>>
>>
>
Re: documentation
Posted by Shichao Dong <do...@gmail.com>.
Hi,
Thank you very much for your reply!
As Andy mentioned, if I am trying to contribute the material to the
project, it may not be small fixes. Therefore, The question is how can I
post it? Should I post it in some blog and provide a link?
Cheers,
Dom
2013/4/5 Andy Seaborne <an...@apache.org>
> On 04/04/13 12:39, Damian Steer wrote:
>
>>
>> On 4 Apr 2013, at 01:20, Shichao Dong <do...@gmail.com> wrote:
>>
>> Hi all,
>>>
>>
>> Hi Dom,
>>
>> I am a Chinese developer, I am trying to translate the Jena tutorials
>>> into
>>> Chinese.
>>>
>>
>> That would be great.
>>
>> Does anyone know how to post my work on the "Jena tutorials in other
>>> languages"?
>>>
>>
>> The jena web site is managed in svn, using markdown: [1]
>>
>> <https://svn.apache.org/repos/**asf/jena/site/trunk<https://svn.apache.org/repos/asf/jena/site/trunk>
>> >
>>
>> Ideally make your additions and provide a diff of your changes via jira
>> (personally I find this easier using git svn). [2] However given the diff
>> will be mostly new files you could always provided them as is if you're not
>> familiar with svn or git svn. Either way, all being well one of the
>> committers will apply the changes and update the site.
>>
>> You can also edit the CMS using a bookmarklet (tutorial here [4]). I've
>> never used it, and I'm not sure it's ideal for providing new pages (as
>> opposed to alterations to existing pages).
>>
>
> For new material, the CMS route will probably not work - it's great for
> small fixes and changes but for new pages and large scale alternatives,
> it's not reliable.
>
> ----
>
> We can either host the pages on jena.apache.org if you contribute the
> material to the project (e.g. the Portuguese translation), or simply put in
> some links to pages on another site (e.g. the French translation).
>
> Andy
>
>
>
>> And thanks for your help!
>>
>> Damian
>>
>> [1] <http://www.apache.org/dev/**cmsref.html#markdown<http://www.apache.org/dev/cmsref.html#markdown>
>> >
>> [2] <https://issues.apache.org/**jira/browse/JENA<https://issues.apache.org/jira/browse/JENA>
>> >
>> [3] <http://jena.apache.org/**tutorials/index.html<http://jena.apache.org/tutorials/index.html>
>> >
>> [4] <http://www.youtube.com/watch?**v=7fvg1pfHLhE<http://www.youtube.com/watch?v=7fvg1pfHLhE>
>> >
>>
>>
>
Re: documentation
Posted by Andy Seaborne <an...@apache.org>.
On 04/04/13 12:39, Damian Steer wrote:
>
> On 4 Apr 2013, at 01:20, Shichao Dong <do...@gmail.com> wrote:
>
>> Hi all,
>
> Hi Dom,
>
>> I am a Chinese developer, I am trying to translate the Jena tutorials into
>> Chinese.
>
> That would be great.
>
>> Does anyone know how to post my work on the "Jena tutorials in other
>> languages"?
>
> The jena web site is managed in svn, using markdown: [1]
>
> <https://svn.apache.org/repos/asf/jena/site/trunk>
>
> Ideally make your additions and provide a diff of your changes via jira (personally I find this easier using git svn). [2] However given the diff will be mostly new files you could always provided them as is if you're not familiar with svn or git svn. Either way, all being well one of the committers will apply the changes and update the site.
>
> You can also edit the CMS using a bookmarklet (tutorial here [4]). I've never used it, and I'm not sure it's ideal for providing new pages (as opposed to alterations to existing pages).
For new material, the CMS route will probably not work - it's great for
small fixes and changes but for new pages and large scale alternatives,
it's not reliable.
----
We can either host the pages on jena.apache.org if you contribute the
material to the project (e.g. the Portuguese translation), or simply put
in some links to pages on another site (e.g. the French translation).
Andy
>
> And thanks for your help!
>
> Damian
>
> [1] <http://www.apache.org/dev/cmsref.html#markdown>
> [2] <https://issues.apache.org/jira/browse/JENA>
> [3] <http://jena.apache.org/tutorials/index.html>
> [4] <http://www.youtube.com/watch?v=7fvg1pfHLhE>
>
Re: documentation
Posted by Damian Steer <d....@bris.ac.uk>.
On 4 Apr 2013, at 01:20, Shichao Dong <do...@gmail.com> wrote:
> Hi all,
Hi Dom,
> I am a Chinese developer, I am trying to translate the Jena tutorials into
> Chinese.
That would be great.
> Does anyone know how to post my work on the "Jena tutorials in other
> languages"?
The jena web site is managed in svn, using markdown: [1]
<https://svn.apache.org/repos/asf/jena/site/trunk>
Ideally make your additions and provide a diff of your changes via jira (personally I find this easier using git svn). [2] However given the diff will be mostly new files you could always provided them as is if you're not familiar with svn or git svn. Either way, all being well one of the committers will apply the changes and update the site.
You can also edit the CMS using a bookmarklet (tutorial here [4]). I've never used it, and I'm not sure it's ideal for providing new pages (as opposed to alterations to existing pages).
And thanks for your help!
Damian
[1] <http://www.apache.org/dev/cmsref.html#markdown>
[2] <https://issues.apache.org/jira/browse/JENA>
[3] <http://jena.apache.org/tutorials/index.html>
[4] <http://www.youtube.com/watch?v=7fvg1pfHLhE>