{"id":13550790,"url":"https://github.com/verless/verless","last_synced_at":"2025-04-03T00:34:55.178Z","repository":{"id":37721042,"uuid":"284977580","full_name":"verless/verless","owner":"verless","description":"A Static Site Generator designed for Markdown-based content with a focus on simplicity and performance.","archived":true,"fork":false,"pushed_at":"2023-08-18T13:54:14.000Z","size":1489,"stargazers_count":311,"open_issues_count":23,"forks_count":26,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-01T10:55:19.923Z","etag":null,"topics":["blog","blog-engine","content-management-system","hacktoberfest","markdown","static-site","static-site-generator"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/verless.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-08-04T12:47:56.000Z","updated_at":"2025-03-22T22:58:51.000Z","dependencies_parsed_at":"2024-01-13T22:55:00.780Z","dependency_job_id":"1e8b787c-108b-42a3-ac2c-f9dfc748b664","html_url":"https://github.com/verless/verless","commit_stats":null,"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/verless%2Fverless","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/verless%2Fverless/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/verless%2Fverless/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/verless%2Fverless/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/verless","download_url":"https://codeload.github.com/verless/verless/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246916735,"owners_count":20854511,"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":["blog","blog-engine","content-management-system","hacktoberfest","markdown","static-site","static-site-generator"],"created_at":"2024-08-01T12:01:37.626Z","updated_at":"2025-04-03T00:34:50.142Z","avatar_url":"https://github.com/verless.png","language":"Go","funding_links":[],"categories":["成品项目","Go","Finished Items","markdown"],"sub_categories":["静态网站生成器","Static Site Generator"],"readme":"\u003cp align=\"center\"\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cimg src=\"https://verless.dominikbraun.io/static/img/logo-github-v1.0.0.png\"\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003eA simple and lightweight Static Site Generator.\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://circleci.com/gh/verless/verless\"\u003e\u003cimg src=\"https://circleci.com/gh/verless/verless.svg?style=shield\"\u003e\u003c/a\u003e\n\u003ca href=\"https://www.codefactor.io/repository/github/verless/verless\"\u003e\u003cimg src=\"https://www.codefactor.io/repository/github/verless/verless/badge\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/verless/verless/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/verless/verless?sort=semver\"\u003e\u003c/a\u003e\n\u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-Apache--2.0-brightgreen\"\u003e\u003c/a\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\u003c/p\u003e\n\n---\n\n**verless** (pronounced like _serverless_) is a Static Site Generator designed for Markdown-based content with a focus on\nsimplicity and performance. It reads your Markdown files, applies your HTML templates and renders them as a website.\n\n## \u003cimg src=\"https://verless.dominikbraun.io/static/img/list-icon-v1.0.0.png\"\u003e Features\n\n* **Flexible theming:** Themes define the HTML templates as well as styles and scripts for your frontend. Initializing\na new theme can be done within a single command, and setting it as active requires a single line of configuration. Since\nverless provides pre-defined template variables, themes are interchangeable.\n\n* **Rapid development:** Just like themes, new projects can be created using a single command. Local development\nrequires no third-party webserver as verless comes with a built-in webserver and rebuilds your project when something\nchanges.\n\n* **High performance:** Generating a static site typically is a matter of milliseconds. To keep build times short,\nverless lets you choose and explicitly enable features you need - only generate RSS feeds or overview pages for tags if\nyou want to.\n\n* **Focus on simplicity:** Global information, page types, plugins and other settings are configured in a central\nconfiguration file inside your project. We try to keep things small and simple, and if your project isn't simple,\nverless probably isn't a good fit.\n\n## \u003cimg src=\"https://verless.dominikbraun.io/static/img/list-icon-v1.0.0.png\"\u003e Examples\n\n* Example project structure: [example/](example)\n* Real-world example website: [dominikbraun.io](https://dominikbraun.io)\n\n## \u003cimg src=\"https://verless.dominikbraun.io/static/img/list-icon-v1.0.0.png\"\u003e Installation\n\n### Linux and macOS\n\nDownload the [latest release](https://github.com/verless/verless/releases) for your platform. Extract the\ndownloaded binary into a directory like `/usr/local/bin`. Make sure the directory is in `PATH`.\n\n### Windows\n\nDownload the [latest release](https://github.com/verless/verless/releases), create a directory like\n`C:\\Program Files\\verless` and extract the executable into that directory.\n[Add the directory to `Path`](https://www.computerhope.com/issues/ch000549.htm).\n\n### Docker\n\nAssuming your project directory is `my-blog`, the following command builds your website:\n\n```shell script\n$ docker container run -v $(pwd)/my-blog:/project verless/verless\n```\n\nThe container will build the project mounted at `/project` and you'll find the website in `my-blog/target`. To run\nanother command, just append it to the image name:\n\n```shell script\n$ docker container run verless/verless version\n```\n\n## \u003cimg src=\"https://verless.dominikbraun.io/static/img/list-icon-v1.0.0.png\"\u003e Getting started\n\nThe easiest way to create a new project is to use the verless CLI:\n\n```shell script\n$ verless create project my-blog\n```\n\nThis initializes a project called `my-blog` inside a new directory, containing a small default site. You can either\nbuild the project or serve the static site directly:\n\n```shell script\n$ verless serve -w my-blog\n```\n\nAfter running the command, you can view your new project under [localhost:8080](http://localhost:8080). Building the\nproject works similary and generates a deployable website:\n\n```shell script\n$ verless build my-blog\n```\n\nBy default, verless generates the website into `my-blog/target`. You are now ready to [create your first blog post](docs)!\n\n## \u003cimg src=\"https://verless.dominikbraun.io/static/img/list-icon-v1.0.0.png\"\u003e Documentation\n\nTo find out how a verless project is structured, take a look at the [example project](example). For a detailed\nreference, check out the [documentation](docs).\n\n**:fire: New tutorial:** [Create a website using verless](docs/create-a-website-using-verless.md)\n\n## \u003cimg src=\"https://verless.dominikbraun.io/static/img/list-icon-v1.0.0.png\"\u003e Contributing\n\nAnyone is welcome to contribute to verless. Please refer to our [contribution guidelines](CONTRIBUTING.md).\n\n\u003cp align=\"center\"\u003e\n\u003cbr\u003e\n\u003ca href=\"https://github.com/verless/verless\"\u003e\n\u003cimg src=\"https://verless.dominikbraun.io/static/img/logo-footer-v1.0.0.png\"\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fverless%2Fverless","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fverless%2Fverless","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fverless%2Fverless/lists"}