docs: refine footer branding and improve Javadoc overview
- remove Material for MkDocs generator branding from the site footer - keep footer presentation aligned with the project's professional documentation style - improve Javadoc overview content for the API landing page - align Javadoc introductory text with the main project site messaging - clarify project scope, documentation purpose, and license information
This commit is contained in:
11
build.gradle
11
build.gradle
@@ -309,6 +309,17 @@ javadoc {
|
||||
options.version = true
|
||||
options.windowTitle = 'Radixor - Egothor Stemmer'
|
||||
options.docTitle = 'Radixor - Egothor Stemmer API'
|
||||
options.overview = file('src/main/javadoc/overview.html')
|
||||
options.bottom = """
|
||||
<div class="legal-copy">
|
||||
© 2026 Egothor
|
||||
<br/>
|
||||
Licensed under <a href="https://github.com/leogalambos/Radixor/blob/main/LICENSE">BSD-3-Clause</a>
|
||||
</div>
|
||||
"""
|
||||
options.links('https://docs.oracle.com/en/java/javase/21/docs/api/')
|
||||
options.group('Core Stemming API', 'org.egothor.stemmer')
|
||||
options.group('Trie Infrastructure', 'org.egothor.stemmer.trie')
|
||||
|
||||
source = sourceSets.main.allJava
|
||||
}
|
||||
|
||||
@@ -3,7 +3,7 @@ site_description: High-performance multi-language stemming toolkit for Java
|
||||
site_url: https://leogalambos.github.io/Radixor/
|
||||
repo_url: https://github.com/leogalambos/Radixor
|
||||
repo_name: leogalambos/Radixor
|
||||
copyright: "© ${year} Egothor. Licensed under <a href='https://github.com/leogalambos/Radixor/blob/main/LICENSE'>BSD-3-Clause</a>."
|
||||
copyright: "© 2026 Egothor. Licensed under <a href='https://github.com/leogalambos/Radixor/blob/main/LICENSE'>BSD-3-Clause</a>."
|
||||
|
||||
theme:
|
||||
name: material
|
||||
@@ -20,6 +20,9 @@ theme:
|
||||
primary: indigo
|
||||
accent: indigo
|
||||
|
||||
extra:
|
||||
generator: false
|
||||
|
||||
markdown_extensions:
|
||||
- admonition
|
||||
- attr_list
|
||||
|
||||
53
src/main/javadoc/overview.html
Normal file
53
src/main/javadoc/overview.html
Normal file
@@ -0,0 +1,53 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<title>Radixor Overview</title>
|
||||
</head>
|
||||
<body>
|
||||
<h1>Radixor</h1>
|
||||
|
||||
<p>
|
||||
Radixor is a high-performance Java toolkit for dictionary-driven stemming based on
|
||||
the proven Egothor patch-command trie approach. It is designed for production-grade
|
||||
search and text-processing systems that require deterministic behavior, efficient
|
||||
runtime execution, and maintainable lexical assets.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
In addition to compiling and executing stemming dictionaries, Radixor extends the
|
||||
traditional Egothor model with support for evolving compiled dictionary artifacts
|
||||
through additional transformation layers. This allows existing lexical resources to
|
||||
be refined incrementally without requiring full recompilation from source dictionaries.
|
||||
</p>
|
||||
|
||||
<h2>Project Scope</h2>
|
||||
<ul>
|
||||
<li>Compilation of Egothor-compatible stemming dictionaries</li>
|
||||
<li>Runtime stemming over compact compiled trie artifacts</li>
|
||||
<li>Transformation and reduction infrastructure for lexical processing</li>
|
||||
<li>CLI and programmatic integration for Java 21 and newer</li>
|
||||
</ul>
|
||||
|
||||
<h2>API Documentation</h2>
|
||||
<p>
|
||||
This Javadoc site documents the Java API of the project. For usage guidance,
|
||||
architectural context, benchmarking methodology, published reports, and general
|
||||
project documentation, refer to the main project site:
|
||||
<a href="https://leogalambos.github.io/Radixor/">leogalambos.github.io/Radixor</a>.
|
||||
</p>
|
||||
|
||||
<h2>License</h2>
|
||||
<p>
|
||||
Radixor is distributed under the
|
||||
<a href="https://github.com/leogalambos/Radixor/blob/main/LICENSE">BSD-3-Clause License</a>.
|
||||
</p>
|
||||
|
||||
<h2>Packages</h2>
|
||||
<p>
|
||||
The main API is located in <code>org.egothor.stemmer</code>. Supporting trie-oriented
|
||||
structures and related implementation components are located in
|
||||
<code>org.egothor.stemmer.trie</code>.
|
||||
</p>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user