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:44 UTC
(maven-doxia-sitetools) 02/02: Convert the index page from xdoc to Markdown
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>