[TYPO3-doc] Merged: [BUGFIX] Make highlighting possible for PHP without "<?php"

[Martin Bless]

Just to let you know ...

(1)
This has been merged:

https://review.typo3.org/#/c/16005/

[BUGFIX] Make highlighting possible for PHP without "<?php"

The PHPlexer that is used for highlighting literal blocks by
default only accepts PHP that starts with an explicit tag like
"<?php". Currently there is no way to change that behaviour from
inside the ReST markup.

Since we don't want that strict default behaviour code has been
added to our "t3sphinx" Python package to change the default. For
this to take effect in local rendering on your own machine you
have to reinstall "t3sphinx" like so:

- git pull git.typo3.org/Documentation/RestTools.git
- cd ....../RestTools/ExtendingSphinxForTYPO3/
- (sudo) python setup.py install

Change-Id: If655bc73404847f942c5c91620eb2e84b1dfcc98
Related: #42265


(2) I've just added::

    highlight_language: 'php'

to GlobalSettings.yml on the srv123 server to make "php" the
default (and now working) highlight_language for us in general.

(3) Use::

    .. code-block:: php


       // some *valid* PHP snippet

to definitely get PHP highlighting.

Shine a light ...

Martin

-- 
Certified TYPO3 Integrator | TYPO3 Documentation Team Member

http://mbless.de