foldsite/docs/content/support.md

version, date, author, title, description, summary, quick_tips

version	date	author	title	description	summary	quick_tips
1.0	2025-01-15	DWS Foldsite Team	Support & Community	Get help with Foldsite	Find help, report issues, and connect with the Foldsite community.	Check documentation first - most questions are answered here Search existing GitHub issues before opening new ones Share your Foldsite creations with the community

Support & Community

Need help with Foldsite? Here's how to get assistance and connect with others.

Documentation

Start here first! Most questions are answered in the documentation:

• Home - Overview and quick start
• Directory Structure - Understanding the basics
• Templates - Template system guide
• Template Helpers - Complete API reference
• Deployment - Getting your site running
• Recipes - Working examples

Common Issues

Template Not Found

Error: Exception: Base template not found

Solution: Ensure base.html exists in your templates directory:

ls templates/base.html

Module Not Found

Error: ModuleNotFoundError: No module named 'flask'

Solution: Install dependencies:

pip install -r requirements.txt

Port Already in Use

Error: OSError: [Errno 48] Address already in use

Solution: Change port in config.toml:

[server]
listen_port = 8082  # Use different port

Or stop the process using port 8081:

# Find process
lsof -i :8081

# Kill it
kill -9 <PID>

Images Not Loading

Problem: Images show broken links

Solution: Use the /download/ route for serving files:

<!-- Correct -->
<img src="/download/{{ photo.path }}">

<!-- Wrong -->
<img src="/{{ photo.path }}">

Template Changes Not Appearing

Problem: Modified templates don't show changes

Solutions:

1. Check you're editing the correct file
2. Clear browser cache (Cmd/Ctrl + Shift + R)
3. Restart the Foldsite server
4. Check config.toml points to correct templates directory

GitHub Repository

Repository: https://github.com/DWSresearch/foldsite

Reporting Bugs

Found a bug? Please report it on GitHub Issues.

Before reporting:

1. Search existing issues to avoid duplicates
2. Make sure you're using the latest version
3. Try to reproduce with minimal example

Good bug report includes:

• Foldsite version
• Python version
• Operating system
• Clear steps to reproduce
• Expected vs. actual behavior
• Error messages (full stack traces)
• Minimal example code if possible

Example:

## Bug Report

**Foldsite version:** 1.0.0
**Python version:** 3.11.5
**OS:** macOS 14.0

### Steps to Reproduce
1. Create template with `{{ get_recent_posts() }}`
2. Run `python main.py --config config.toml`
3. Visit homepage

### Expected
Should show 5 recent posts

### Actual
Raises `AttributeError: 'NoneType' object has no attribute 'metadata'`

### Stack Trace

[paste full error here]

Feature Requests

Have an idea for improvement? Open a feature request!

Good feature request includes:

• Clear description of the feature
• Use case (why you need it)
• Proposed implementation (if you have ideas)
• Examples from other tools (if applicable)

Pull Requests

Contributions welcome! See Develop Foldsite for guidelines.

Community

Show & Tell

Share what you've built with Foldsite:

• Post in GitHub Discussions
• Tag #foldsite on social media
• Add your site to Explore Foldsites

Discussions

Have questions or want to chat? Use GitHub Discussions:

• Q&A - Ask questions
• Show and Tell - Share your site
• Ideas - Discuss potential features
• General - Everything else

Getting Help

Before Asking

1. Read the docs - Your answer might be here
2. Search issues - Someone might have asked already
3. Check examples - See working code in /example_site
4. Enable debug mode - See what Foldsite is doing:

   [server]
   debug = true
   

How to Ask

Good questions include:

• What you're trying to achieve
• What you've tried
• Relevant code snippets
• Error messages

Example:

I'm trying to show recent posts on my homepage, but get_recent_posts() returns an empty list.

My content structure:

content/
├── index.md
└── blog/
    ├── post1.md
    └── post2.md

My template code:

{% for post in get_recent_posts(limit=5) %}
  {{ post.title }}
{% endfor %}

Posts have frontmatter with title and date fields. What am I missing?

Response Times

Foldsite is maintained by volunteers. Please be patient:

• Bugs - Usually addressed within a few days
• Features - May take longer depending on complexity
• Questions - Community often responds quickly

Contributing

Want to help make Foldsite better?

Ways to Contribute

• Documentation - Fix typos, clarify confusing sections, add examples
• Bug fixes - Fix issues and submit pull requests
• Features - Implement new functionality
• Templates - Create and share themes
• Testing - Test new releases, report issues
• Community - Help others in discussions

See Develop Foldsite for detailed contribution guidelines.

Professional Support

Need dedicated help with Foldsite?

DWS (Dubey Web Services) may offer consulting for complex implementations. Contact through the website for availability and rates.

Security Issues

Found a security vulnerability? Do not open a public issue.

Email security@dws.rip with:

• Description of the vulnerability
• Steps to reproduce
• Potential impact
• Suggested fix (if you have one)

We'll respond as quickly as possible and coordinate disclosure.

Learning Resources

Jinja2 (Template Engine)

Foldsite uses Jinja2 for templates:

• Official Docs - Complete Jinja2 reference
• Template Designer Docs - Template syntax

Markdown

Content is written in Markdown:

• CommonMark - Markdown specification
• Markdown Guide - Beginner-friendly guide

Python (For Development)

If you want to contribute to Foldsite:

• Python Tutorial - Official Python tutorial
• Flask Docs - Web framework used by Foldsite

Acknowledgments

Foldsite is built with:

• Flask - Web framework
• Jinja2 - Template engine
• mistune - Markdown parser
• python-frontmatter - Frontmatter parsing
• Pillow - Image processing
• Gunicorn - WSGI HTTP server

Thank you to all contributors and users!

Stay Updated

• Watch the GitHub repository for updates
• Star the repo if you find Foldsite useful
• Fork to experiment with your own changes

Philosophy

Foldsite is part of the DWS mission: "It's your Internet. Take it back."

We believe in:

• Simple tools that solve real problems
• User ownership of content and presentation
• Open source collaboration
• Privacy and control

Next Steps

• Explore Foldsites - See what others have built
• Develop Foldsite - Contributing guidelines
• Recipes - Working examples to learn from

Still stuck? Don't hesitate to ask for help. The Foldsite community is here to support you!