Major Feature #39835

Improve the "typo3sphinx" theme

Added by Martin Bless 9 months ago. Updated 6 months ago.

Status:Resolved Start date:2012-08-15
Priority:Must have Due date:
Assignee:Martin Bless % Done:

100%

Category:-
Target version:ReStructured Text Infrastructure - TYPO3, TER & typo3.org integ.
Votes: 0

Description

Up to now we've been using the "typo3sphinx" theme which I hacked together last year. It already looks like TYPO3 in many ways - but not completely. And there are a lot of usability problems with the current HTML output from that theme. See http://preview.docs.typo3.org/TYPO3/ for examples.

So the tasks are:
- improve the "typo3sphinx" theme
- find a rendering that can be integrated into typo3.org

Associated revisions

Revision 483194e2
Added by Martin Bless 6 months ago

[TASK] Improve Python package t3sphinx in RestTools

Grab git://git.typo3.org/Documentation/RestTools.git,
cd to ExtendingSphinxForTYPO3, run python setup.py install.

New:

- t3html.py, a TYPO3 specific subclass of the html builder

- t3sphinx.ext.t3tablerow, a Sphinx extension to render the
"tablerow definition lists" better (the data we got from
that old Tsref-like tables)

- t3sphinx.ext.t3extras, does TYPO3 specific stuff like
including our t3html builder

- Sphinx theme 't3org' that currently produces the docs.typo3.org
pages (including the static(!) menus.

Resolves: #39835

Change-Id: I7006f490314597b803f508e5504adda9cabd4837

History

Updated by Martin Bless 9 months ago

  • Target version set to TYPO3, TER & typo3.org integ.

Updated by Martin Bless 6 months ago

[TASK] Improve Python package t3sphinx in RestTools

Grab git://git.typo3.org/Documentation/RestTools.git,
cd to ExtendingSphinxForTYPO3, run python setup.py install.

New:

- t3html.py, a TYPO3 specific subclass of the html builder

- t3sphinx.ext.t3tablerow, a Sphinx extension to render the
"tablerow definition lists" better (the data we got from
that old Tsref-like tables)

- t3sphinx.ext.t3extras, does TYPO3 specific stuff like
including our t3html builder

- Sphinx theme 't3org' that currently produces the docs.typo3.org
pages (including the static(!) menus.

Resolves: #39835

Updated by Gerrit Code Review 6 months ago

  • Status changed from Accepted to Under Review

Patch set 1 for branch master has been pushed to the review server.
It is available at http://review.typo3.org/16998

Updated by Martin Bless 6 months ago

  • Status changed from Under Review to Resolved
  • % Done changed from 0 to 100

Also available in: Atom PDF