https://github.com/lroolle/qwq
https://github.com/lroolle/qwq
Last synced: 7 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/lroolle/qwq
- Owner: lroolle
- Created: 2025-03-05T02:31:58.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-03-06T08:38:12.000Z (7 months ago)
- Last Synced: 2025-03-06T09:37:33.600Z (7 months ago)
- Language: HTML
- Size: 51.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Static Topic Explorer for Cloudflare Pages
A simple static site project that can serve multiple topic pages with automatic routing. This project is designed to be deployed on Cloudflare Pages.
## Project Structure
```
.
├── index.html # Main entry point with auto-routing
├── public/ # Static assets
│ ├── css/
│ │ └── styles.css # Main stylesheet
│ ├── js/ # JavaScript files (if needed)
│ └── assets/ # Images, fonts, etc.
└── pages/ # Content pages
├── topic1.html # Sample topic page
└── topic2.html # Another sample topic page
```
## Features
- **Auto-routing**: The main index.html file automatically discovers and routes to content pages
- **No Framework Required**: Built with vanilla HTML, CSS, and JavaScript
- **Responsive Design**: Looks great on all devices
- **Easy to Extend**: Just add new HTML files to the pages directory
## How to Use
### Local Development
1. Clone this repository:
```
git clone
cd static-topic-explorer
```
2. Serve the project locally using any static file server. For example:
```
# Using Python
python -m http.server
# Or using Node.js's http-server
npx http-server
```
3. Open your browser and navigate to `http://localhost:8000` (or whatever port your server uses)
### Adding New Topics
To add a new topic page:
1. Create a new HTML file in the `pages` directory
2. Follow the structure of the existing topic pages
3. Your new topic will be automatically discovered by the main index
Example of a minimal topic page:
```html
Your Topic - Topic Explorer
Your Topic Title
Description of your topic.
```
### Deployment to Cloudflare Pages
1. Push your code to a Git repository (GitHub, GitLab, etc.)
2. Log in to the Cloudflare dashboard and navigate to Pages
3. Click "Create a project" and select your repository
4. Configure your build settings:
- Build command: (leave empty for static sites)
- Build output directory: (leave as root or specify `.`)
- Root directory: (leave empty)
5. Click "Save and Deploy"
6. Your site will be deployed to a `*.pages.dev` domain
## Customization
- **Styles**: Edit `public/css/styles.css` to change the appearance
- **Auto-discovery**: For more advanced page discovery in production, consider implementing a build process to generate a manifest file
## Notes for Production Use
In a real production environment, you might want to:
1. Implement a build step to generate a pages manifest
2. Add SEO optimization
3. Implement analytics
4. Add a custom domain
## License
[MIT License](LICENSE)