Initial commit: Changemaker Lite project
This commit is contained in:
@@ -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
|
||||
|
||||
@@ -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)
|
||||
Reference in New Issue
Block a user