[TYPO3-core] Migrating the system extension manuals to ReStructured Text

Tolleiv Nietsch tolleiv.nietsch at typo3.org
Mon Aug 6 10:46:56 CEST 2012


Hi,

doesn't answer how this all integrates in general into typo3.org 
(search, header/footer parts of the website) and who's going to do that ;)

Cheers,
Tolleiv


Steffen Gebert schrieb:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> I think we should finalize the URLs and then use nginx to proxy let's
> say /documentation/read/ to the external server.
>
> Kind regards
> Steffen
>
> - --
> Steffen Gebert
> TYPO3 v4 Core Team Member
> TYPO3 Server Administration Team Member
>
> TYPO3 .... inspiring people to share!
> Get involved: http://typo3.org
>
> I work for TYPO3 solely in my spare time. If you think that
> my work helps you running your business, you are invited to
> send me a donation via PayPal to this email address. Thanks
>
> Am 8/6/12 9:50 AM, schrieb Tolleiv Nietsch:
>> Hi,
>>
>> sorry to come back on this so late. It's nice that you finally
>> transform the stuff to rst - but once you do this, this means that
>> we won't be able to see anything on typo3.org for now because (as
>> you know) the integration between your documentation server and
>> typo3.org isn't ready at all (from my perspective). And I doubt
>> that this will be done until 6.0.
>>
>> Cheers, Tolleiv
>>
>> François Suter schrieb:
>>> Hi all,
>>>
>>> I have discussed with the TYPO3 6.0 RM team about migrating all
>>> system extension manuals to ReST. This would entail the
>>> following:
>>>
>>> - migrating the manuals themselves - changing the EM to have
>>> links pointing to the rendered docs online - provide a fallback
>>> when someone has no internet connection to view the raw ReST
>>> files in the TYPO3 BE
>>>
>>> The changes would apply to the new-new EM. I wanted to post this
>>> here so that you could ask questions and express worries.
>>>
>>> On the Doc Team side we are confident that we will be ready with
>>> a full rendering chain - including for system extension manuals -
>>> by the time 6.0 is released.
>>>
>>> It would be good if the new-new EM provided hooks for things such
>>> as extra documentation links and such. I'm thinking that the
>>> Documentation Team could provide extensions related to
>>> documentation that enable things like linking to other formats
>>> (PDF, for example) and downloading such resources for offline
>>> viewing. But as we have no PDF rendering yet (only experimental)
>>> we can't implement such a feature now. Thus it would be good to
>>> have possibilities for extensions.
>>>
>>> Cheers
>>>
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG/MacGPG2 v2.0.18 (Darwin)
> Comment: GPGTools - http://gpgtools.org
> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
>
> iQEcBAEBAgAGBQJQH3x2AAoJEIskG/rSlyw44NAIAIEuUjRks0MgeA6IgOgbek+N
> a5QnMZOQ1K8r1dhbgHYuVzzuvqe5zZ9AM1Zh3VzEolWuL+nVknqxsCqMuMC2UlsA
> zfioS0jcm9e5PbIPvgA3yi402y6ddUgIlNTBDOhrd5+2L6mC9mo7OkBC+DU8x2Xq
> qcXc9qD/pAQeRAl8vIyZyDKBC1MHHvmfYDZqeqfguAKpH83Tu8aajb2mjvJ8FKLG
> dtjbVRTq44LvsT1AYO9FkXRfSzk2m0N86ZVYFREA3DE4lC1hPqdy5yYhsxHq2OrS
> bdZ6s0UymVaE1gVvlkTownC4wIfvJUaI+KPqeF5AzAhY7rz/3HxzeLJnOZpZaA0=
> =/FbM
> -----END PGP SIGNATURE-----

-- 
Tolleiv Nietsch
TYPO3 Core Developer


TYPO3 .... inspiring people to share!
Get involved: typo3.org




More information about the TYPO3-team-core mailing list