Initial blog engine

Author: oleg-nenashev

.devcontainer/requirements.txt

@@ -11,6 +11,7 @@ mkdocs-multirepo-plugin==0.6.3
 mkdocs-redirects==1.2.1
 mkdocs-extra-sass-plugin==0.1.0
 mkdocs-render-swagger-plugin==0.1.1
+mkdocs-rss-plugin-1.15.0
 mkdocs-same-dir==0.1.3
 mkdocs-pdf==0.1.1
 livereload==2.6.3

blog/.authors.yml

@@ -0,0 +1,6 @@
+authors:
+  gradleup:
+    name: GradleUp Team
+    description: >
+      GradleUp organizing team
+    avatar: https://github.com/gradleup.png

blog/images/icon/rss.svg

@@ -0,0 +1,5 @@
+# GradleUp Blog
+
+[RSS feed of created content]({{ config.site_url }}feed_rss_created.xml)
+[RSS feed of updated content]({{ config.site_url }}feed_rss_updated.xml)
+

blog/index.md

@@ -0,0 +1,57 @@
+---
+draft: false
+date: 2024-08-12
+categories:
+  - website
+  - documentation
+  - mkdocs
+authors:
+  - gradleup
+---
+
+# Hello, World!
+
+🐘🎈 GradleUp, a volunteer-driven umbrella GitHub org focused on better Java, Kotlin and Android developer experience with Gradle, got a new website!
+
+<!-- more -->
+
+## What is GradleUp?
+
+GradleUp is a volunteer-driven umbrella GitHub organization
+focusing on simplifying developer experience with [Gradle Build Tool (a.k.a. Gradle)](https://gradle.org/),
+in particular for Java, Kotlin and Android projects.
+We host components and ensure their long-term sustainability.
+
+Our scope includes all things that help to achieve great user and developer experience when working with Gradle.
+It includes but not limited to plugins, developer tools, integrations, documentation or community content.
+
+## So, a Website?
+
+The first release includes:
+
+- Listing of the [GradleUp Projects](../../projects/README.md)
+- Initial [Governance Charter](../../docs/community/governance.md)
+- [Contributing](../../docs/community/participate.md)and
+  [New Component Hosting](../../docs/community/hosting.md) guidelines.
+- And this blog!
+
+## Under the Hood
+
+The site is built with [MkDocs](https://www.mkdocs.org/),
+[MkDocs Multirepo Plugin](https://github.com/jdoiro3/mkdocs-multirepo-plugin/tree/main),
+and [Material for MkDocs](https://squidfunk.github.io/mkdocs-material).
+For development, everything is powered by Dev Containers and GitHub Actions.
+As all other resources, the site is open source and open for contributions and new ideas.
+Check out the [Contributing Guide](../../CONTRIBUTING.md).
+
+We’re looking forward to establishing the public communication channels, and onboarding more plugins, developer tools and other cool Gradle things.
+Adventure is out there!
+
+## Credits
+
+This site is a team effort.
+We embed documentation created by many contributors to
+[GradleUp Projects](../../projects/README.md).
+Also, kudos to [Oleg Nenashev](https://github.com/oleg-nenashev) for working on this website and the community foundations, and welcome to the team!
+
+

blog/posts/2024-08-hello-world.md

@@ -30,6 +30,8 @@ nav:
       - NMCP (New Maven Central Publishing): nmcp/README.md
       - Shadow: shadow/README.md
     - Hosting New Projects: docs/community/hosting.md
+  - Blog:
+    - blog/index.md
   - Participate:
     - Community Channels: docs/community/participate.md
     - GradleUp Team: docs/community/team.md
@@ -45,10 +47,18 @@ nav:
 plugins:
   - search
   - autorefs
+  - blog
   - macros
   - mkdocs-pdf
   - social
   - same-dir
+  - rss:
+      match_path: blog/posts/.* 
+      date_from_meta:
+        as_creation: date
+      categories:
+        - categories
+        - tags
   - group:
       enabled: !ENV [FULL_BUILD, true]
       plugins:
@@ -171,6 +181,9 @@ extra:
     - icon: fontawesome/brands/github
       link: https://github.com/GradleUp
       name: GitHub
+    - icon: /fontawesome/solid/rss
+      link: feed_rss_created.xml
+      name: RSS
 #  analytics:
 #    provider: google
 #    property: TODO

mkdocs.yml

@@ -0,0 +1,7 @@
+{% extends "base.html" %}
+
+{% block extrahead %}
+  <!-- RSS Feed -->
+  <link rel="alternate" type="application/rss+xml" title="RSS feed of created content" href="{{ config.site_url }}feed_rss_created.xml">
+  <link rel="alternate" type="application/rss+xml" title="RSS feed of updated content" href="{{ config.site_url }}feed_rss_updated.xml">
+{% endblock %}