Giter VIP home page Giter VIP logo

staticsitegenerators-list's Introduction

Static Site Generators Listing

Travis CI Build Status NPM version NPM downloads Dependency Status Dev Dependency Status
Patreon donate button Flattr donate button Liberapay donate button Thanks App donate button Boost Lab donate button Buy Me A Coffee donate button Open Collective donate button crypto donate button PayPal donate button Wishlist browse button

A comprehensive, partially automatically generated comparison of static site generators with some minimal meta data about them

Contributing

Requirements

There are generally three types of Content Management Systems:

  1. Dynamic Servers (e.g. WordPress, Ghost, DocPad, Harp) — these allow you to have re-render on every request abilities
  2. Flat File Content Management Systems (e.g. Yellow, Techy) — these allow you to write your content as files
  3. Static Site Generators (e.g. Jekyll, DocPad) — these generate a static website from your input that you can deploy anywhere

Currently, this listing is only for projects that relate to Flat File Content Management Systems and/or Static Site Generators, but not for projects which relate only to Dynamic Servers (such as WordPress and Ghost).

Adding

Entries are stored within the list.json file.

Accepted project fields:

  • name the project's name
  • github the slug of the GitHub repository if applicable
  • gitlab the slug of the GitLab repository if applicable
  • bitbucket the slug of BitBucket repository if applicable
  • website the project's website if they have one, if the automatic website fetch is incorrect you can specify as false
  • language the project's primary programming language if applicable
  • description the project's description
  • created_at the project's date of creation in ISO format
  • updated_at the project's date of last update in ISO format
  • license the project's SPDX license code
    • if license is missing, omit this field
    • if license is not applicable because it is a commercial service, use false
    • if multiple licenses, see the SPDX parser for formatting
  • is should be one of the following:
    • flat file cms a project that takes in local file content, renders it, and exposes the rendered contents via its own web server, without exporting to static files that can be deployment elsewhere, such as Grav and Harp
    • static site generator a project that takes in local file content, renders it, and exports it into a static file content for deployment somewhere, with or without a bundled web server, such as Jekyll and DocPad
    • static site importer a project that takes in local or dynamic content and imports it into a database, such as a file system to Contentful importer
    • static site exporter a project that takes in database content and generates a static website with it, such as a Contentful or Wordpress to static website exporter
    • static site host a project that hosts static site content, such as GitHub Pages or Surge.sh
    • static site editor a project that a custom editing experience for static website content, such as Contentful and Prose.io, or even Grav's admin plugin
    • other if some other type of project that is related to flat-file content management systems or static website generators
  • extensible should be true or false providing whether or not the project provides a way for users to add new features
  • defunct can be true to signal that the project is no longer functioning or receiving support

Dates should be in ISO format which looks like this 2006-08-18T16:00:00.000Z. Conversion can be done with JavaScript using console.log(new Date('19-Aug-2006').toISOString()) or via the command line using Node.js via node -e "console.log(new Date('19-Aug-2006').toISOString())".

At the very least, the following fields are required:

  • name
  • tags
  • github or gitlab or bitbucket or website
  • is will output a warning if missing, but is required for all new entries

If github is specified, the following fields should only be specified if GitHub's data is incorrect:

  • license
  • website
  • language
  • description
  • created_at
  • updated_at

If gitlab is specified, the following fields should only be specified if GitLab's data is incorrect:

  • language
  • description
  • created_at
  • updated_at

The following fields are automatic and only apply to our rendered listing:

  • id
  • stars
  • forks
  • watchers

Testing

When you submit your pull request, your submission will be automatically tested, so no need to test locally, however if you do wish to, you can:

  1. Install Node.js (5-15 minutes)

  2. Fork the project and clone your fork - guide (5 minutes)

  3. Install local dependencies (1 minute)

npm install
  1. Running the tests (1 minute)
npm test
  1. Make any changes that the tests indicate, commit your changes, and submit

Usage

Using the npm package is done like so:

const listing = require('staticsitegenerators')

// get the hydrated data
console.log(listing.hydrated)

// get the raw data
console.log(listing.raw)

History

Discover the release history by heading on over to the HISTORY.md file.

Backers

Maintainers

These amazing people are maintaining this project:

Sponsors

No sponsors yet! Will you be the first?

Patreon donate button Flattr donate button Liberapay donate button Thanks App donate button Boost Lab donate button Buy Me A Coffee donate button Open Collective donate button crypto donate button PayPal donate button Wishlist browse button

Contributors

These amazing people have contributed code to this project:

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

License

Unless stated otherwise all works are:

and licensed under:

staticsitegenerators-list's People

Contributors

arnaudligny avatar balupton avatar coolaj86 avatar datagrok avatar davidsiaw avatar davisonio avatar dbohdan avatar denisdefreyne avatar dertuxmalwieder avatar fiatjaf avatar ipavl avatar japh avatar jaspervdj avatar jevets avatar juanbrujo avatar klml avatar koistya avatar lomiglavnek avatar manvel avatar mblayman avatar minchinweb avatar mixu avatar moox avatar pawandubey avatar surajshukla avatar tak1n avatar vikrantrathore avatar wifiextender avatar wikismith avatar yaph avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.