Overview
As of today the design framework for Tuleap is only internal. There is no practical way to re-use it outside the sources of Tuleap.
However there are few situations where it would make sense to re-use Tuleap design outside Tuleap context:
- Having standalone documentation (for instance integrated in https://docs.tuleap.org)
- Used for a 3rd party app skin (Mediawiki for instance)
This requests aims to centralize the thoughts and steps toward this.
General approach
At this stage, only style sheets are considered in order to:
- limit the scope
- learn how to do it
The publication will be handled manually, the version will be the tuleap version and the rhythm of update will be driven by the theme updates (not the tuleap versions). Even if there are slightly different rendering, it's not worth the trouble to take into account a continuous upgrade.
Proposal
- Fix sass variable dependency in existing code
- Move style sheet build into dedicated component that generates
- style sheets with code
- MxN style sheets per theme colors + condensed mode
- Extract tlp css stylesheet into
@tuleap/tlp-style on npm
- Publish with tuleap version eg
@tuleap/tlp-style-12.8
- License: GPLv2+
- Release guidelines are in a
Readme.md in @tuleap/tlp-style
- Every release should be considered as major (as per semver)
The TLP documentation will be provided as a tarball on demand.