You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by or...@apache.org on 2022/12/05 18:15:06 UTC

[camel-website] 01/03: CAMEL-18786: support better organization for the Camel Core documentation

This is an automated email from the ASF dual-hosted git repository.

orpiske pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel-website.git

commit bacf788adda5c9393865307ba57203ab33d6fb33
Author: Otavio Rodolfo Piske <an...@gmail.com>
AuthorDate: Wed Nov 30 17:59:01 2022 +0100

    CAMEL-18786: support better organization for the Camel Core
    documentation
    
    These changes allow the Camel Core project to create a new page to
    reorganize, categorize and separate the project documentation according
    to the audience.
    
    The behavior of a few of the static pages is changed to accommodate
    that.
---
 antora-playbook-snippets/antora-playbook.yml |  4 +++-
 content/docs/_index.md                       |  6 +++++-
 layouts/index.html                           |  6 +++---
 static/camel-core/index.html                 | 13 +++++++++++++
 4 files changed, 24 insertions(+), 5 deletions(-)

diff --git a/antora-playbook-snippets/antora-playbook.yml b/antora-playbook-snippets/antora-playbook.yml
index be46430c..e272e61d 100644
--- a/antora-playbook-snippets/antora-playbook.yml
+++ b/antora-playbook-snippets/antora-playbook.yml
@@ -11,6 +11,8 @@ content:
       start_paths:
         # manual
         - docs/user-manual
+        # main website for camel core
+        - docs/main
 
     - url: https://github.com/apache/camel.git
       branches:
@@ -145,7 +147,7 @@ runtime:
     level: warn
     failure_level: warn
 #    format: json
-    
+
 antora:
   extensions:
     - require: '@djencks/antora-aggregate-collector'
diff --git a/content/docs/_index.md b/content/docs/_index.md
index 20aaf938..637463aa 100644
--- a/content/docs/_index.md
+++ b/content/docs/_index.md
@@ -9,10 +9,14 @@ Title: "Documentation"
 
 ## Camel Core
 
+
+The foundation for all other projects. Ideal for experienced Java developers or achitects willing to innovate and build upon a lower level integration framework.
+
 The [User Manual](/manual/) is a comprehensive guide meant to help you with the key concepts of Apache Camel and software integration, from how to [get started](/manual/getting-started.html) with Apache Camel, how to [upgrade to Camel 3.x](/manual/camel-3x-upgrade-guide.html), to [architecture](/manual/architecture.html) or [integration patterns](/components/latest/eips/enterprise-integration-patterns.html).
 
 <p>
-<a class="button dark" href="/manual/">Documentation</a>
+<a class="button dark" href="/camel-core/">Documentation</a>
+<a class="button light" href="/manual/">Old Documentation</a>
 <a class="button light" href="https://github.com/apache/camel/">Source</a>
 <a class="button light" href="https://github.com/apache/camel-examples">Examples</a>
 </p>
diff --git a/layouts/index.html b/layouts/index.html
index 7befeae5..6c669941 100644
--- a/layouts/index.html
+++ b/layouts/index.html
@@ -8,11 +8,11 @@
       to quickly and easily integrate various systems consuming or producing data.
     </p>
     <p>
-    <a class="button dark" href="/manual/getting-started.html">Get Started</a> <a class="button light" href="/manual/faq/what-is-camel.html">What is Camel?</a>
+    <a class="button dark" href="/docs/index.html">Get Started</a> <a class="button light" href="/manual/faq/what-is-camel.html">What is Camel?</a>
     </p>
   </div>
   <img alt="Computer with gears depicting data processing" src="./img/camel-gears.svg" />
-</header>  
+</header>
 
 <div class="frontpage news">
   <h2>What's New?</h2>
@@ -29,7 +29,7 @@
               {{ dateFormat "2" .PublishDate }}
           </data>
           <data class="month">
-              {{ dateFormat "Jan" .PublishDate }} 
+              {{ dateFormat "Jan" .PublishDate }}
               {{ dateFormat "2006" .PublishDate }}
           </data>
         </time>
diff --git a/static/camel-core/index.html b/static/camel-core/index.html
new file mode 100644
index 00000000..405104be
--- /dev/null
+++ b/static/camel-core/index.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <title>Link checker workaround</title>
+</head>
+<body>
+<article>
+    <p>This file exists solely to defeat the limitations of the link checker, that is unaware of the .htaccess redirect from this page to the latest released version.</p>
+    <p>If you see this, you are not viewing the site through httpd or there is something wrong with the .htaccess file: in the latter case please let the camel developers know.</p>
+</article>
+</body>
+</html>
+