{"id":21107333,"url":"https://github.com/ninjascl/chercan","last_synced_at":"2026-04-02T02:59:21.437Z","repository":{"id":119741268,"uuid":"315490456","full_name":"NinjasCL/chercan","owner":"NinjasCL","description":"🐦 A simple static site generator with Wren","archived":false,"fork":false,"pushed_at":"2020-12-26T19:00:23.000Z","size":56,"stargazers_count":14,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-21T03:42:18.288Z","etag":null,"topics":["static-site-generator","wren","wren-language"],"latest_commit_sha":null,"homepage":"https://ninjascl.github.io/chercan/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NinjasCL.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-11-24T01:56:16.000Z","updated_at":"2024-11-29T02:45:41.000Z","dependencies_parsed_at":"2023-07-21T04:31:59.295Z","dependency_job_id":null,"html_url":"https://github.com/NinjasCL/chercan","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NinjasCL%2Fchercan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NinjasCL%2Fchercan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NinjasCL%2Fchercan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NinjasCL%2Fchercan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NinjasCL","download_url":"https://codeload.github.com/NinjasCL/chercan/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243551253,"owners_count":20309300,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["static-site-generator","wren","wren-language"],"created_at":"2024-11-20T00:38:39.044Z","updated_at":"2025-12-28T19:16:10.061Z","avatar_url":"https://github.com/NinjasCL.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":":ext-relative:\n:toc: macro\n:toclevels: 4\n\n# https://en.wikipedia.org/wiki/House_wren[Chercan] Static Site Generator\n\nA simple https://en.wikipedia.org/wiki/Static_web_page[static site generator] using https://wren.io[Wren] programming language.\n\nimage:https://user-images.githubusercontent.com/292738/100270183-730e7980-2f36-11eb-88f6-b2a1929e23b9.png[https://www.avesdechile.cl/074.htm]\n\nhttps://ninjas.cl[image:https://img.shields.io/badge/Ninjas-CL-green.svg?style=flat-square[Ninjas.cl]]\n\ntoc::[]\n\n## Dependencies\n\nJust https://github.com/wren-lang/wren-cli[_Wren CLI_] is needed. (Although _Python3_ is used for local server mode.).\n\n- Installation:\n  - MacOS: `make wren-macos`\n  - Linux: `make wren-linux`\n\n## 👩‍💻 Structure\n\n```sh\n.\n├── LICENSE\n├── Makefile\n├── README.adoc\n├── chercan\n│   ├── build.wren\n│   └── config.wren\n├── content\n│   ├── hello\n│   │   ├── hello.adoc\n│   │   └── hello.html\n│   ├── hello.wren\n│   └── index.wren\n├── docs\n│   ├── hello.html\n│   ├── index.html\n│   ├── normalize.css\n│   └── sakura-vader.css\n├── static\n│   ├── normalize.css\n│   └── sakura-vader.css\n├── themes\n│   └── default\n│       ├── default.wren.html\n│       ├── home.wren.html\n│       └── partials\n│           ├── footer.wren.html\n│           └── header.wren.html\n└── wren\n└── run\n```\n\n## 🚀 Usage\n\nCreate your files inside `content`. Only root level `*.wren` files supported for now (_Wren CLI_ limitations).\n\n- `./run new \u003cname\u003e`: It will create a new _wren_ file inside `content`.\n\n- `./run new:adoc \u003cname\u003e`: It will create a new filename with its _*.wren_ and _*.adoc_ inside `content`.\n\n- `./run build`: It will execute `make build`. (Builds _wren_ files).\n\n- `./run build:adoc`: It would only build _asciidoc_ files. (Requires https://asciidoctor.org/[AsciiDoctor]).\n\n- `./run build:all`: It will execute `make build-all` (Builds _wren_ and _asciidoc_ files).\n\n- `./run serve`: It will execute `make serve`. (Requires _Python3_).\n\n### Asciidoc\n\nYou could also create a _directory_ with https://asciidoctor.org/[Asciidoc] files and use the html output to append it to the file contents. It must have the same name as the _Wren_ file.\n\n- Example _Page_:\n\n```js\n\nclass Page {\n  static title {\"Hello Chercan\"}\n  static content {Asciidoc.read()}\n}\n\nreturn Page\n\n```\n\n### Themes\n\nYou can create your own _themes_. They are just _Wren_ files\nthat uses _Wren tags_ `\u003c?wren ?\u003e`. You have all the _Wren_ power\nin these templates.\n\nName them as `\u003cname\u003e.wren.html`. Configure the default _theme_ in `chercan/config.wren`.\n\n#### Example\n```html\n\u003c!DOCTYPE html\u003e\n\u003chtml\u003e\n  \u003chead\u003e\n    \u003cmeta content=\"text/html; charset=utf-8\" http-equiv=\"content-type\"\u003e\n  \u003c/head\u003e\n  \u003cbody\u003e\n    \u003ch1\u003e\n      \u003c?wren echo.call(page.title) ?\u003e\n      \u003csmall\u003e\u003c?= \"You can also use the shorthand echo tag\" ?\u003e\u003c/small\u003e\n    \u003c/h1\u003e\n  \u003c/body\u003e\n\u003c/html\u003e\n```\n\n### Static\n\nThe `static` directory would contain any files (images, css, etc). They would be copied to the output directory.\n\n## 📘 LICENSE\nMIT\n\n## 🤩 Credits\n\n++++\n\u003cp\u003e\n  Made with \u003ci class=\"fa fa-heart\"\u003e\u0026#9829;\u003c/i\u003e by\n  \u003ca href=\"https://ninjas.cl\"\u003e\n    Ninjas.cl\n  \u003c/a\u003e.\n\u003c/p\u003e\n++++\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fninjascl%2Fchercan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fninjascl%2Fchercan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fninjascl%2Fchercan/lists"}