[
https://issues.apache.org/jira/browse/COMMONSSITE-165?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17687899#comment-17687899
]
Alex Herbert commented on COMMONSSITE-165:
------------------------------------------
I released the most recent version of Commons Skin (4.2). Before this release
there were no changes for years.
The commit log has most of the changes as minor cosmetic items and some
clean-up of unused functionality. The main reason for the release was to update
the velocity template to handle injected XHTML in the HEAD section and support
optional rendering of <pre> tags using prettyprint. See commits 42bcfff and
9592278. Prior to the release of this skin the sites for the Commons Math
derived components did not support colour for the code examples and could not
add the header to enable MathJax. Here are some current pages that previously
had problems:
h3. Code examples
RNG: Previously either APT generated pages, or the XDoc pages did not render
code with syntax highlighting (I cannot remember which). Here is an example of
each:
[Commons RNG overview|https://commons.apache.org/proper/commons-rng/]
[Commons RNG
userguide|https://commons.apache.org/proper/commons-rng/userguide/rng.html#a2._Usage_overview]
h3. MathJax
RNG Developers guide:
[Documentation section using a Pythagorean triplet written in
MathJax|https://commons.apache.org/proper/commons-rng/developers.html#Documentation]
Some components use MathJax heavily in Javadoc and would not be easily
replaceable using HTML, e.g.
[Numbers Complex
asin|https://commons.apache.org/proper/commons-numbers/commons-numbers-complex/javadocs/api-1.1/org/apache/commons/numbers/complex/Complex.html#asin()]
[RNG Stable
Sampler|https://commons.apache.org/proper/commons-rng/commons-rng-sampling/javadocs/api-1.5/org/apache/commons/rng/sampling/distribution/StableSampler.html]
As long as any new skin can support this functionality then moving to a more
widely supported skin seems sensible. I am happy to provide some testing of
alternative skins using the components I am familiar with.
> [SKIN] Update Commons Skin Bootstrap
> ------------------------------------
>
> Key: COMMONSSITE-165
> URL: https://issues.apache.org/jira/browse/COMMONSSITE-165
> Project: Apache Commons All
> Issue Type: Bug
> Components: Commons Skin
> Reporter: Bruno P. Kinoshita
> Priority: Minor
> Labels: gsoc2023, part-time
>
> Our Commons components use Commons Skin, a skin, or theme, for Apache Maven
> Site.
> Our skin uses Bootstrap 2.x, but Bootstrap is already at 5.x release, and we
> are missing several improvements (UIUX, accessibility, browser compatibility)
> and JS/CSS bugs fixed over the years.
> Work happening on Apache Maven Skins. Maybe we could adapt/use that one?
> https://issues.apache.org/jira/browse/MSKINS-97
>
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
