Maintenance
Target group: Contributors, Developers
Translations
The translation to other languages is done within the Crowdin service. It is appreciated to add missing or incomplete languages. Please navigate to the project home. If the language is not available please drop me a note and I will create it.
Note
For now, the language files are integrated into a release of the extension. When the new translation structure (based on the translations within Crowdin) is in place, the language files (other than English) will be removed in favour of the new infrastructure.
PrismJS library
For syntax highlighting PrismJS is used. The JavaScript library and its dependencies are managed with npm and build with gulp:
cd Build
npm ci
npm run build
The npm run build
command runs the according gulp task and copies the
Prism components (aka languages), plugins and themes to the
Resources/
folder. Also a PHP file
Resources/
is generated
with the available languages. It will be used for the select box of programming
languages in the backend form. The option values are "translated" via the
Resources/
file.
Update
To update the library to the recent version just call on the console:
cd Build
npm update prismjs
npm run build
The copied artifacts can now be committed (along with the package.
file to the repository. Don't forget to add new files to the commit and add
these to the translation file
Resources/
.
Note
Due to the variants JavaScript files can be integrated into the page (like
last modification timestamp is embedded into the filename), the script
Build/
was patched: The variable autoloader
regex has to be set to
adjusted to consider a possibly available timestamp in the filename.
When updating the PrismJS library, the patch under
Build/
has to be adjusted eventually.
The package patch-package
is used for that.
Packaging of extension for TER
Set the new version in the files
ext_
emconf. php Documentation/
,guides. xml
adjust the CHANGELOG.
and tag the release. The packaging of the
extension for the TYPO3 Extension Repository (TER) can be done with:
make zip
This creates/replaces a file ../
which is
ready for upload to TER. x.
holds the recent version number.