[PR] Prepare archive output for GitHub Pages (CSS rendering + SEO metadata) [fineract-chat-archive]

["airajena (via GitHub)" <gi...@apache.org>]

airajena opened a new pull request, #12:
URL: https://github.com/apache/fineract-chat-archive/pull/12

   # Summary
   This PR updates archive output so it is better suited for GitHub Pages publishing and search indexing.
   
   Main goals covered:
   - Stop applying visual formatting via Markdown syntax in Java output.
   - Use CSS classes and a stylesheet for presentation.
   - Emit Pages-friendly, extensionless URLs in sitemap entries.
   - Generate crawler metadata files (`robots.txt`, `sitemap.xml`) in `docs/`.
   
   # What Changed
   ## 1) Rendering moved from Markdown presentation to CSS classes
   - Updated daily/index page output to emit class-based HTML blocks for message rows and metadata.
   - Removed Markdown bolding/link-style presentation from Java renderers.
   - Added stable CSS classes (`archive-message`, `archive-user`, `archive-text`, `archive-link`, etc.) for theme/styling control.
   
   Files:
   - `src/main/java/org/apache/fineract/chat/archive/MarkdownRenderer.java`
   - `src/main/java/org/apache/fineract/chat/archive/SlackTextFormatter.java`
   
   ## 2) Added generated stylesheet
   - Added stylesheet renderer and write step to output:
     - `docs/assets/chat-archive.css`
   - Daily and index pages now include stylesheet references.
   
   Files:
   - `src/main/java/org/apache/fineract/chat/archive/SiteMetadataRenderer.java`
   - `src/main/java/org/apache/fineract/chat/archive/ChatArchiveApp.java`
   
   ## 3) Extensionless URL strategy for Pages
   - Added front matter permalinks for generated pages:
     - `/`
     - `/daily/<channel>/`
     - `/daily/<channel>/<date>/`
   - Updated sitemap generation to use extensionless URLs instead of `.md` paths.
   
   Files:
   - `src/main/java/org/apache/fineract/chat/archive/MarkdownRenderer.java`
   - `src/main/java/org/apache/fineract/chat/archive/SiteMetadataRenderer.java`
   
   ## 4) Robots and sitemap generation
   - `robots.txt` is always generated at `docs/robots.txt`.
   - `sitemap.xml` is generated at `docs/sitemap.xml` when `SITE_BASE_URL` is configured.
   - Added `SITE_BASE_URL` configuration support and normalization.
   
   Files:
   - `src/main/java/org/apache/fineract/chat/archive/ArchiveConfig.java`
   - `src/main/java/org/apache/fineract/chat/archive/ChatArchiveApp.java`
   - `update-archive.yml`
   - `Readme.md`
   
   ## 5) Pages workflow template
   - Added `deploy-pages.yml` workflow template for deploying `docs/` to GitHub Pages.
   
   File:
   - `deploy-pages.yml`
   
   # Verification
   Executed locally:
   - `./gradlew test`
   
   All tests passed.
   
   Added/updated tests:
   - `src/test/java/org/apache/fineract/chat/archive/MarkdownRendererTest.java`
   - `src/test/java/org/apache/fineract/chat/archive/SiteMetadataRendererTest.java`
   - `src/test/java/org/apache/fineract/chat/archive/SlackTextFormatterTest.java`
   - `src/test/java/org/apache/fineract/chat/archive/ArchiveConfigTest.java`
   
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@fineract.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

Re: [PR] Prepare archive output for GitHub Pages (CSS rendering + SEO metadata) [fineract-chat-archive]

["meonkeys (via GitHub)" <gi...@apache.org>]

meonkeys merged PR #12:
URL: https://github.com/apache/fineract-chat-archive/pull/12


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@fineract.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

Re: [PR] Prepare archive output for GitHub Pages (CSS rendering + SEO metadata) [fineract-chat-archive]

["meonkeys (via GitHub)" <gi...@apache.org>]

meonkeys commented on PR #12:
URL: https://github.com/apache/fineract-chat-archive/pull/12#issuecomment-3892163178

   LGTM. Thank you!


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@fineract.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org