admin/freealberta
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit: Changemaker Lite project

Browse Source
This commit is contained in:
admin 2025-05-28 10:01:22 -06:00
parent ab81a74ed8
commit 3b091eb57a
9 changed files with 37 additions and 289 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
README.md
View File

@ -12,7 +12,6 @@ Changemaker Lite is a streamlined documentation and development platform featuri
- **PostgreSQL**: Reliable database backend
- **n8n**: Workflow automation and service integration
- **NocoDB**: No-code database platform and smart spreadsheet interface
- **Silex**: Visual website editor for drag-and-drop web design
## Quick Start
@ -36,7 +35,6 @@ After starting, access services at:
- **Documentation (Dev)**: http://localhost:4000
- **Documentation (Built)**: http://localhost:4001
- **Code Server**: http://localhost:8888
- **Silex Editor**: http://localhost:6805
- **Listmonk**: http://localhost:9000
- **n8n**: http://localhost:5678
- **NocoDB**: http://localhost:8090

7
mkdocs/docs/services/index.md
View File

@ -39,13 +39,6 @@ Changemaker Lite includes several powerful services that work together to provid
- Caching and compression
- Security headers
### [Silex](silex.md)
**Port: 6805** | Visual website editor
- Drag-and-drop web design
- Filesystem-based storage
- Template editing for MkDocs
- No-code HTML creation
### [n8n](n8n.md)
**Port: 5678** | Workflow automation tool
- Visual workflow editor

112
mkdocs/docs/services/silex.md
View File

@ -1,112 +0,0 @@
# Silex - Visual Website Editor
Silex is a streamlined visual website editor that allows you to create and edit HTML pages with a drag-and-drop interface.
## Overview
This Changemaker setup uses the minimal `silexlabs/silex` image, which provides a focused, single-site editing experience. It's particularly useful for editing the `home.html` and `main.html` templates in your MkDocs overrides.
## Access
- **Default Port**: 6805
- **URL**: `http://localhost:6805`
- **Container**: `silex-changemaker`
## Configuration
### Environment Variables
- `SILEX_PORT`: External port mapping (default: 6805)
- `SILEX_HOST`: Hostname for Silex (default: `silex.${DOMAIN}`)
### Volume Mounts
Silex uses the following directories for persistence:
- **Storage**: `./silex/storage` - Site data and configurations
- **Hosting**: `./silex/hosting` - Published files
- **HTML Files**: `./mkdocs/docs/overrides` - Direct access to edit `home.html` and `main.html`
## Usage
### Getting Started
1. Access Silex at `http://localhost:6805`
2. Create a new site or open an existing project
3. Use the visual editor to design your pages
4. Save your work to the mounted directories
### Editing MkDocs Templates
Silex is configured to have access to your MkDocs override templates:
- `home.html` - Custom home page template
- `main.html` - Main template overrides
You can edit these files directly through Silex's visual interface.
### Features
- **Drag-and-Drop Interface**: Visual page building
- **Filesystem Storage**: Simple file-based persistence
- **Single Site Focus**: Streamlined for focused editing
- **Responsive Design**: Mobile-friendly editing
## File Structure
```
silex/
├── storage/ # Site configurations and data
├── hosting/ # Published website files
└── html/ # Direct access to MkDocs overrides
├── home.html
└── main.html
```
## Tips
1. **Backup Important Files**: Always backup your templates before making changes
2. **Test Changes**: Preview your changes in MkDocs before publishing
3. **Use Version Control**: Commit your changes to git regularly
4. **Responsive Design**: Test your designs on different screen sizes
## Troubleshooting
### Port Conflicts
If port 6805 is already in use, you can change it in your `.env` file:
```bash
SILEX_PORT=8080
```
### File Permissions
If you encounter permission issues, ensure the mounted directories have the correct ownership:
```bash
sudo chown -R 1000:1000 ./silex/
```
### Container Issues
To restart the Silex container:
```bash
docker-compose restart silex
```
## Integration with MkDocs
Silex is particularly useful for editing MkDocs template overrides. After making changes in Silex:
1. Check your changes in the MkDocs live preview (`http://localhost:4000`)
2. Build the static site if everything looks good
3. Commit your changes to version control
## Resources
- [Silex Official Website](https://www.silex.me/)
- [Silex Documentation](https://docs.silex.me/)
- [Silex GitHub Repository (minimal version)](https://github.com/silexlabs/silex-lib)
- [Docker Hub - Silex Minimal](https://hub.docker.com/r/silexlabs/silex)

23
mkdocs/site/getting-started/index.html
View File

@ -479,6 +479,15 @@ Changemaker Archive. <a href="https://docs.bnkops.com">Learn more</a>
<nav class="md-nav" aria-label="First Steps">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#access-the-dashboard" class="md-nav__link">
<span class="md-ellipsis">
Access the Dashboard
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#access-documentation" class="md-nav__link">
<span class="md-ellipsis">
@ -1064,6 +1073,15 @@ Changemaker Archive. <a href="https://docs.bnkops.com">Learn more</a>
<nav class="md-nav" aria-label="First Steps">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#access-the-dashboard" class="md-nav__link">
<span class="md-ellipsis">
Access the Dashboard
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#access-documentation" class="md-nav__link">
<span class="md-ellipsis">
@ -1309,6 +1327,11 @@ Changemaker Archive. <a href="https://docs.bnkops.com">Learn more</a>
</code></pre></div>
<p>All services should show as "Up" status.</p>
<h2 id="first-steps">First Steps<a class="headerlink" href="#first-steps" title="Permanent link">&para;</a></h2>
<h3 id="access-the-dashboard">Access the Dashboard<a class="headerlink" href="#access-the-dashboard" title="Permanent link">&para;</a></h3>
<p>Start with the <strong>Homepage Dashboard</strong>: http://localhost:3010
- Central hub for all services
- Live status monitoring
- Quick access to all applications</p>
<h3 id="access-documentation">Access Documentation<a class="headerlink" href="#access-documentation" title="Permanent link">&para;</a></h3>
<ol>
<li><strong>Development Server</strong>: http://localhost:4000</li>

1
mkdocs/site/index.html
View File

@ -855,6 +855,7 @@ Changemaker Archive. <a href="https://docs.bnkops.com">Learn more</a>
<li><strong><a href="services/code-server/">Code Server</a></strong> (Port 8888) - VS Code in your browser</li>
<li><strong><a href="services/mkdocs/">MkDocs</a></strong> (Port 4000) - Documentation with live preview </li>
<li><strong><a href="services/static-server/">Static Server</a></strong> (Port 4001) - Built site hosting</li>
<li><strong><a href="services/waypoint-editor.md">Waypoint Editor</a></strong> (Port 3020) - Visual page editor</li>
<li><strong><a href="services/listmonk/">Listmonk</a></strong> (Port 9000) - Newsletter management</li>
<li><strong><a href="services/postgresql/">PostgreSQL</a></strong> (Port 5432) - Database backend</li>
<li><strong><a href="services/n8n/">n8n</a></strong> (Port 5678) - Workflow automation</li>

155
mkdocs/site/overrides/home.html
View File

@ -1,155 +0,0 @@
{% extends "main.html" %}
{% block content %}
<div class="setup-guide-banner" style="background-color: #f5f5f5; padding: 20px; margin-bottom: 20px; border-radius: 8px; text-align: center; border-left: 5px solid #2196f3;">
<h2 style="margin-top: 0; color: #333;">Need help with setup?</h2>
<p>For the most up-to-date installation instructions and documentation, please visit our official guide:</p>
<div style="margin-top: 15px;">
<a href="https://docs.bnkops.com/cm" class="cta-button" style="display: inline-block; font-size: 1.1em; font-weight: bold; background-color: #2196f3; color: white; padding: 12px 24px; text-decoration: none; border-radius: 4px; margin-right: 10px;">Visit Official Setup Guide</a>
<a href="https://gitea.bnkops.com/admin/Changemaker" class="cta-button" style="display: inline-block; font-size: 1.1em; font-weight: bold; background-color: #333; color: white; padding: 12px 24px; text-decoration: none; border-radius: 4px;"><span class="material-icons" style="vertical-align: middle; font-size: 1.1em; margin-right: 5px;">source</span>View Source Code</a>
</div>
</div>
<div style="position: relative; padding-top: 56.25%;">
<iframe
src="https://customer-1ebw5tv06sxrrq32.cloudflarestream.com/e98f453daee6e89c3a1632465806d0d5/iframe?muted=true&preload=true&loop=true&autoplay=true&poster=https%3A%2F%2Fcustomer-1ebw5tv06sxrrq32.cloudflarestream.com%2Fe98f453daee6e89c3a1632465806d0d5%2Fthumbnails%2Fthumbnail.jpg%3Ftime%3D%26height%3D600"
loading="lazy"
style="border: none; position: absolute; top: 0; left: 0; height: 100%; width: 100%;"
allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture;"
allowfullscreen="true"
></iframe>
</div>
<div class="hero-section">
<h1>Welcome to Changemaker Lite</h1>
<p class="description">A streamlined, self-hosted platform for documentation and development.</p>
<p class="description">Changemaker Lite is a lightweight, self-hosted productivity suite that empowers you to build secure websites, blogs, newsletters, and automation workflows. With locally hosted tools and services, it helps you manage documentation and development projects—granting you complete control and security for your content.</p>
<p class="subtitle">Build your power, don't rent it.</p>
<a href="#apps-showcase" class="cta-button">Explore Applications</a>
<a href="https://gitea.bnkops.com/admin/Changemaker" class="git-code-button">
<span class="material-icons">code</span> Code
</a>
</div>
<div class="quick-start-section">
<h2>Quick Start</h2>
<p>Familiar with the terminal, git, and <a href="https://docs.docker.com/get-docker/" target="_blank">Docker</a>? Get Changemaker up and running in minutes:</p>
<div class="code-container">
<pre><code># Clone the repository
git clone https://gitea.bnkops.com/admin/Changemaker.git
cd changemaker.lite</code></pre>
</div>
<div class="code-container">
<pre><code># Run the config.sh script
./config.sh</code></pre>
</div>
<div class="code-container">
<pre><code># Start all services
docker compose up -d</code></pre>
</div>
<p class="quick-note">That's it! After services start (which may take a few minutes on first run), visit the individual service ports to get started.</p>
<p class="quick-note"><a href="http://localhost:4000" class="button">Access MkDocs (Documentation)</a></p>
<a href="https://gitea.bnkhome.org/bnkops/Changemaker/src/branch/main/README.md" class="button">Detailed Installation Guide</a>
</div>
<div class="info-section">
<h2>What is Changemaker Lite?</h2>
<p>Changemaker Lite is a streamlined version focused on documentation and development tools. It provides essential services for creating and managing content, including documentation sites, newsletters, automation workflows, and development environments.</p>
</div>
<div class="info-section">
<h2>Why Changemaker Lite?</h2>
<p>Changemaker Lite offers a minimal but powerful self-hosted solution for individuals and small teams who need reliable documentation and development tools without the complexity of larger platforms. Perfect for personal projects, small campaigns, or development workflows.</p>
</div>
<div class="apps-grid-container" id="apps-showcase">
<h2>Core Applications & Services</h2>
<p style="text-align: center; max-width: 700px; margin: 0 auto 2rem auto;">Changemaker Lite comes with essential self-hosted tools for documentation, development, and automation. Click on any app to learn more about its features and how to use it.</p>
<div class="apps-grid">
<div class="app-card">
<div>
<h3><span class="material-icons" style="vertical-align: bottom; margin-right: 8px;">dashboard</span>Homepage</h3>
<p>Modern dashboard for accessing and monitoring all your self-hosted services from one place.</p>
</div>
<a href="{{ 'services/homepage/' | url }}" class="button">Learn More</a>
</div>
<div class="app-card">
<div>
<h3><span class="material-icons" style="vertical-align: bottom; margin-right: 8px;">code</span>Code Server</h3>
<p>Visual Studio Code in your browser. Develop and edit code from any device with full IDE features.</p>
</div>
<a href="{{ 'services/code-server/' | url }}" class="button">Learn More</a>
</div>
<div class="app-card">
<div>
<h3><span class="material-icons" style="vertical-align: bottom; margin-right: 8px;">mail</span>Listmonk</h3>
<p>Self-hosted newsletter and mailing list manager for full control over email campaigns.</p>
</div>
<a href="{{ 'services/listmonk/' | url }}" class="button">Learn More</a>
</div>
<div class="app-card">
<div>
<h3><span class="material-icons" style="vertical-align: bottom; margin-right: 8px;">storage</span>PostgreSQL</h3>
<p>Reliable database backend for Listmonk and other applications requiring persistent data storage.</p>
</div>
<a href="{{ 'services/postgresql/' | url }}" class="button">Learn More</a>
</div>
<div class="app-card">
<div>
<h3><span class="material-icons" style="vertical-align: bottom; margin-right: 8px;">description</span>MkDocs Material</h3>
<p>Modern documentation site generator with live preview and beautiful Material Design theme.</p>
</div>
<a href="{{ 'services/mkdocs/' | url }}" class="button">Learn More</a>
</div>
<div class="app-card">
<div>
<h3><span class="material-icons" style="vertical-align: bottom; margin-right: 8px;">web</span>Static Site Server</h3>
<p>Nginx-powered static site server for hosting your built documentation and websites.</p>
</div>
<a href="{{ 'services/static-server/' | url }}" class="button">Learn More</a>
</div>
<div class="app-card">
<div>
<h3><span class="material-icons" style="vertical-align: bottom; margin-right: 8px;">hub</span>n8n</h3>
<p>Workflow automation tool for connecting services and automating repetitive tasks.</p>
</div>
<a href="{{ 'services/n8n/' | url }}" class="button">Learn More</a>
</div>
<div class="app-card">
<div>
<h3><span class="material-icons" style="vertical-align: bottom; margin-right: 8px;">grid_view</span>NocoDB</h3>
<p>No-code database platform that turns any database into a smart spreadsheet interface.</p>
</div>
<a href="{{ 'services/nocodb/' | url }}" class="button">Learn More</a>
</div>
</div>
</div>
<div class="info-section">
<h2>Development Pathway</h2>
<p>Changemaker Lite is continuously evolving. Here are some identified goals for development:</p>
<ul>
<li>Enhanced service integrations and documentation.</li>
<li>Improved automation workflows with n8n examples.</li>
<li>Better asset management across services.</li>
<li>Comprehensive training materials and guides.</li>
</ul>
<p>Stay tuned for updates and new features!</p>
</div>
{% endblock %}
{% block tabs %}
{{ super() }}
{% endblock %}

2
mkdocs/site/search/search_index.json
View File

File diff suppressed because one or more lines are too long

24
mkdocs/site/sitemap.xml
View File

@ -2,50 +2,50 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://changeme.org/</loc>
<lastmod>2025-05-26</lastmod>
<lastmod>2025-05-28</lastmod>
</url>
<url>
<loc>https://changeme.org/getting-started/</loc>
<lastmod>2025-05-26</lastmod>
<lastmod>2025-05-28</lastmod>
</url>
<url>
<loc>https://changeme.org/blog/</loc>
<lastmod>2025-05-26</lastmod>
<lastmod>2025-05-28</lastmod>
</url>
<url>
<loc>https://changeme.org/services/</loc>
<lastmod>2025-05-26</lastmod>
<lastmod>2025-05-28</lastmod>
</url>
<url>
<loc>https://changeme.org/services/code-server/</loc>
<lastmod>2025-05-26</lastmod>
<lastmod>2025-05-28</lastmod>
</url>
<url>
<loc>https://changeme.org/services/homepage/</loc>
<lastmod>2025-05-26</lastmod>
<lastmod>2025-05-28</lastmod>
</url>
<url>
<loc>https://changeme.org/services/listmonk/</loc>
<lastmod>2025-05-26</lastmod>
<lastmod>2025-05-28</lastmod>
</url>
<url>
<loc>https://changeme.org/services/mkdocs/</loc>
<lastmod>2025-05-26</lastmod>
<lastmod>2025-05-28</lastmod>
</url>
<url>
<loc>https://changeme.org/services/n8n/</loc>
<lastmod>2025-05-26</lastmod>
<lastmod>2025-05-28</lastmod>
</url>
<url>
<loc>https://changeme.org/services/nocodb/</loc>
<lastmod>2025-05-26</lastmod>
<lastmod>2025-05-28</lastmod>
</url>
<url>
<loc>https://changeme.org/services/postgresql/</loc>
<lastmod>2025-05-26</lastmod>
<lastmod>2025-05-28</lastmod>
</url>
<url>
<loc>https://changeme.org/services/static-server/</loc>
<lastmod>2025-05-26</lastmod>
<lastmod>2025-05-28</lastmod>
</url>
</urlset>

BIN
mkdocs/site/sitemap.xml.gz
View File

Binary file not shown.