Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/snowlaboratory/chione

2024 Blog Kick Starter Markdown
https://github.com/snowlaboratory/chione

11ty bun kickstart markdown starter-kit vite

Last synced: 2 days ago
JSON representation

2024 Blog Kick Starter Markdown

Awesome Lists containing this project

README

        

![img](src/public/img/Chione-2.png)

# Chione - Snow Builds Kickstart

In memory are those who struggle to share. This repo is dedicated to them. You've got this!

## Origin

> In Greek mythology, Chione or Khionê (Ancient Greek: Χιονη from χιών – chiōn, "snow") was the daughter of the Oceanid Callirrhoe and Nilus. She was raped by a local peasant and transformed into a snow cloud by Hermes at the order of Zeus. From the clouds she cast snow (khiôn) upon the desert. The Greek word for snow (χιών chiōn) was thought to have come from her name.
>
> _[The Wikipedia Article](https://en.wikipedia.org/wiki/Chione_(daughter_of_Callirrhoe))_

## Introduction
Chione provides several avenues for generating static content. Authors should start simple. From there, they may wish to continue or combine ideas into something greater.

## Folder Structure
The `src` folder houses your unpublished thoughts. The first level of folders specify the broadest scope. By default, "language" is assumed to be the broadest scope. Just fork the repository. From there, do what you want.

## Getting Started
1. Fork the repository
2. Install dependencies [See bun installation](https://github.com/oven-sh/bun)
3. Build static files `./build.sh`
4. Share `docs` directory with world

## Screenshots
Only because if I were you, I'd want to see what I'm getting into. Food for thought.

![img](src/public/img/screenshot-1.jpg)
![img](src/public/img/screenshot-2.jpg)
![img](src/public/img/screenshot-3.jpg)
![img](src/public/img/screenshot-4.jpg)

## Stack
Oh yes how could this be forgotten. Chione is built on the following technologies:
* Bun
* I18N routing
* Analytics
* 11TY
* Static Site Generation
* Markdown
* Templating (Liquid, Nunjucks, EJS, etc.)
* CSS
* PostCSS
* TailwindCSS

## Advanced
This step is optional and only necessary if you want to rewrite URLs. Doing so means your content depends on a server and will ultimately cost money to publish. Hosting static content for free is possible if you search around, yet "compute" is what you desire.

1. Run `bun index.js`
2. Modify server to fit your needs
3. Publish

## More Advanced
Feel free to deploy using docker. There are many ways to do this. The project contains a simple `Dockerfile` and `docker-compose.yml` file. You may wish to modify these files to fit your needs.

Since data management becomes more complex and expensive with Docker you may wish to backup your data inside a pre-commit hook:
```bash
#!/bin/bash
export APP_DOMAIN="example.com"
export APP_USERNAME="admin"
export APP_PASSWORD="password"

./build.sh

mkdir -p stats
curl -H "Authorization: Basic $(echo -n $APP_USERNAME:$APP_PASSWORD | base64)" https://$APP_DOMAIN/_views > "stats/$(date +'%Y%m%d%H%M%S').json"

git add .
```

## Purpose
This project aims to provide ground for thoughts. Please be mindful.

## Intent
Changes to this repository are not welcome at this time. Please fork and create your own apps.

## Disclaimers
Security, accessibility, performance, etc. are deferred. Chione provides rudimentary I18N. Concerns will not be addressed at this time. Please make your own framework.

## License
MIT

## Credits
Adobe, ChatGPT, Wikipedia, and subject matter are not my own. All rights reserved.