Git Product home page Git Product logo

sculpin-skeleton's Introduction

Sculpin Skeleton

A minimal, generic skeleton project for the Sculpin static site generator.

Usage

  1. Download the project by running composer create-project opdavies/sculpin-skeleton --no-interaction --no-progress --prefer-dist my-sculpin-site.
  2. Run cd my-sculpin-site to change into the project directory, and composer watch to generate and serve the site.
  3. Start adding content to source/index.md.
  4. Add more content, settings, layouts, includes etc as needed.

Scripts

This project includes some custom Composer scripts that you can use rather than running vendor/bin/sculpin directly, and that include some additional default options.

These are:

  • composer generate and composer dev - These generate the site in the development mode.
  • composer watch - Generates and serves the site in development mode, watching for any changes.
  • composer prod - Generates the site in production mode.

You can still pass additional options by separating the command and options with --. For example, running composer watch -- --port=8002 would run the default watch command but also update the server port:

composer watch -- --port=8002
> composer generate -- --server --watch '--port=8002'
> sculpin generate --clean --no-interaction '--server' '--watch' '--port=8002'
Deleting /Users/opdavies/Code/Personal/sculpin-skeleton/output_dev
Detected new or updated files
Generating: 100% (1 sources / 0.00 seconds)
Converting: 100% (1 sources / 0.20 seconds)
Formatting: 100% (1 sources / 0.00 seconds)
Processing completed in 0.27 seconds
Starting Sculpin server for the dev environment with debug true
Development server is running at http://localhost:8002
Quit the server with CONTROL-C.

Notes

  • The posts content type is disabled by default. Re-enable it if needed by removing enabled: false from app/config/sculpin_kernel.yml.

License

MIT

sculpin-skeleton's People

Contributors

opdavies avatar

Stargazers

Kevin Gustavson avatar Keleti Márton avatar

Watchers

 avatar James Cloos avatar  avatar

sculpin-skeleton's Issues

Add default config

Maybe title: My New Sculpin Site in app/config/sculpin_site.yml and use it in default layout once added in #3.

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.