You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by sl...@apache.org on 2026/08/09 17:16:42 UTC
(maven-doxia-sitetools) branch master updated (809e6d7 -> 42ac395)
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/maven-doxia-sitetools.git
from 809e6d7 Drop the version.maven-site-plugin property the parent already provides
new 978ab72 Rename the site document ahead of converting it
new 42ac395 Convert the index page from xdoc to Markdown
The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
src/site/{xdoc/index.xml => markdown/index.md} | 37 ++++++++------------------
1 file changed, 11 insertions(+), 26 deletions(-)
rename src/site/{xdoc/index.xml => markdown/index.md} (62%)
(maven-doxia-sitetools) 01/02: Rename the site document ahead of converting it
Posted by sl...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-doxia-sitetools.git
commit 978ab72122cf1f425b6ced742bf4d3bbace71cf3
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Sun Aug 9 17:34:48 2026 +0200
Rename the site document ahead of converting it
Git's rename detection is similarity-based, so a rename and a rewrite in
one commit is recorded as a delete plus an add and git log --follow stops
there. Please merge or rebase rather than squash.
Generated-by: Claude Opus 5 (1M context)
---
src/site/{xdoc/index.xml => markdown/index.md} | 0
1 file changed, 0 insertions(+), 0 deletions(-)
diff --git a/src/site/xdoc/index.xml b/src/site/markdown/index.md
similarity index 100%
rename from src/site/xdoc/index.xml
rename to src/site/markdown/index.md
(maven-doxia-sitetools) 02/02: Convert the index page from xdoc to Markdown
Posted by sl...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-doxia-sitetools.git
commit 42ac39593fa6e4413925e1c2469d50f4ead06e3b
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Sun Aug 9 17:36:29 2026 +0200
Convert the index page from xdoc to Markdown
Converted with doxia-converter. The YAML front matter is kept: it carries
the page's title and author, which the skin turns into <title> and
<meta name="author">.
The dependency diagram's image map is written back as inline HTML. The
converter drops it -- "Unknown Sink event 'map', ignoring!" -- which would
have silently turned a diagram with 8 clickable module links into a plain
picture. Doxia passes the raw block through unchanged.
Verified by rendering the site before and after and comparing the two on
title, author, visible text and every link target.
Generated-by: Claude Opus 5 (1M context)
---
src/site/markdown/index.md | 37 +++++++++++--------------------------
1 file changed, 11 insertions(+), 26 deletions(-)
diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
index 36a097c..89dfe05 100644
--- a/src/site/markdown/index.md
+++ b/src/site/markdown/index.md
@@ -1,4 +1,8 @@
-<?xml version="1.0"?>
+---
+title: Doxia Sitetools
+author:
+ - Hervé Boutemy
+---
<!--
/*
@@ -19,27 +23,14 @@
*/
-->
-<document xmlns="http://maven.apache.org/XDOC/2.0"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
+# Doxia Sitetools
- <properties>
- <title>Doxia Sitetools</title>
- <author email="hboutemy_AT_apache_DOT_org">Hervé Boutemy</author>
- </properties>
+Doxia Sitetools is an extension of [base Doxia component](../doxia) that generates: **HTML sites**, adding site (header, footer, navigation bar, menu, ...) to content that was generated by Doxia: a site is defined in a **site skin**.
- <body>
+In addition, Doxia Sitetools processes files with extra `.vm` extension with [Velocity](http://velocity.apache.org/).
- <section name="Doxia Sitetools">
-
- <p>Doxia Sitetools is an extension of <a href="../doxia">base Doxia component</a> that generates:
- <b>HTML sites</b>, adding site (header, footer, navigation bar, menu, ...) to content that was generated by Doxia:
- a site is defined in a <b>site skin</b>.</p>
- <p>In addition, Doxia Sitetools processes files with extra <code>.vm</code> extension with <a href="http://velocity.apache.org/">Velocity</a>.</p>
-
- <p>
- <img src="images/doxia-sitetools-deps.png" border="0" usemap="#Doxia_sitetools_dependencies" alt="Doxia Sitetools Dependencies"/>
- <map name="Doxia_sitetools_dependencies" id="Doxia_sitetools_dependencies">
+<img src="images/doxia-sitetools-deps.png" border="0" usemap="#Doxia_sitetools_dependencies" alt="Doxia Sitetools Dependencies"/>
+<map name="Doxia_sitetools_dependencies" id="Doxia_sitetools_dependencies">
<area shape="rect" coords="133,63,274,97" href="doxia-site-renderer/index.html" alt="Doxia Site Renderer"/>
<area shape="rect" coords="2,119,162,153" href="doxia-integration-tools/index.html" alt="Doxia Integration Tools"/>
<area shape="rect" coords="32,232,199,267" href="doxia-site-model/index.html" alt="Doxia Site Model"/>
@@ -48,11 +39,5 @@
<area shape="rect" coords="318,180,414,214" href="http://velocity.apache.org" alt="Velocity"/>
<area shape="rect" coords="134,301,274,337" href="/doxia/doxia/doxia-modules/doxia-module-xhtml5/index.html" alt="Doxia Module XHTML5"/>
<area shape="rect" coords="114,288,252,353" href="/doxia/doxia/doxia-modules/index.html" alt="Doxia Modules"/>
- </map>
- </p>
-
- </section>
-
- </body>
+ </map>
-</document>