2025-05-28 09:47:43 -06:00

3.1 KiB

Raw Blame History

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

Access Silex at http://localhost:6805
Create a new site or open an existing project
Use the visual editor to design your pages
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

Backup Important Files: Always backup your templates before making changes
Test Changes: Preview your changes in MkDocs before publishing
Use Version Control: Commit your changes to git regularly
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:

SILEX_PORT=8080

File Permissions

If you encounter permission issues, ensure the mounted directories have the correct ownership:

sudo chown -R 1000:1000 ./silex/

Container Issues

To restart the Silex container:

docker-compose restart silex

Integration with MkDocs

Silex is particularly useful for editing MkDocs template overrides. After making changes in Silex:

Check your changes in the MkDocs live preview (http://localhost:4000)
Build the static site if everything looks good
Commit your changes to version control

3.1 KiB Raw Blame History