diff --git a/README.md b/README.md index bbe88fd..6a577be 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/mkdocs/docs/services/index.md b/mkdocs/docs/services/index.md index 85135b2..9bfc21b 100644 --- a/mkdocs/docs/services/index.md +++ b/mkdocs/docs/services/index.md @@ -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 diff --git a/mkdocs/docs/services/silex.md b/mkdocs/docs/services/silex.md deleted file mode 100644 index b80c6df..0000000 --- a/mkdocs/docs/services/silex.md +++ /dev/null @@ -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) diff --git a/mkdocs/site/getting-started/index.html b/mkdocs/site/getting-started/index.html index 6d7c895..5a18df2 100644 --- a/mkdocs/site/getting-started/index.html +++ b/mkdocs/site/getting-started/index.html @@ -479,6 +479,15 @@ Changemaker Archive. Learn more