Skip to main content

Nib

Nib is a static site generator, written in Python, geared toward creating a simple site or blog. Nib uses a pluggable content pipeline that differentiates between “resources” like CSS or Javascript, and “documents” such as static pages or blog posts. The two pipelines are similar, are executed in parallel, and define multiple hooks where plugins can process a subset of entities, and even remove entities or generate new ones at runtime.

An example site generated from the default wizard and templates is available at http://nib.noswap.com

[![Build Status](https://travis-ci.org/jreese/nib.png?branch=master)](https://travis-ci.org/jreese/nib)

Requirements

  • Python 2.7 or 3.2+

Installation

To install the latest official release:

$ pip3 install nib

or to install the version currently checked out from source:

$ pip install -r requirements.txt $ python3 setup.py install

Getting Started

Once Nib is installed, you can generate basic configuration and site using the built-in wizard:

$ mkdir somesite && cd somesite $ nib wizard …

Once the wizard is complete, you should have a site configuration file, some example documents (a page and two blog posts), and a minimal site theme consisting of resources (favicon, CSS, and robots.txt), and templates:

$ ls config.nib documents/ resources/ templates/

$ ls documents about.md links/ posts/

$ ls resources favicon.ico main.less robots.txt

$ ls templates feed.xml list.html macros.html page.html post.html posts.html

To build the site:

$ nib … Done

The resulting HTML and resources will be in the site/ directory:

$ ls config.nib documents/ resources/ site/ templates/

$ ls site 2012/ about.html archive.html favicon.ico feed.xml index.html links/ main.css posts/ robots.txt tags/

To test the resulting site, Nib can run a simple HTTP server, as well as open the local server in your preferred web browser:

$ nib serve Serving site on port 8000… press Ctrl-C to terminate. ^C Done

or:

$ nib serve –port 9000 –browse Serving site on port 9000… press Ctrl-C to terminate. Opening http://localhost:9000 in web browser… ^C Done

License

Nib is licensed under the MIT license. See the LICENSE file for details.

Credits

Nib is developed by [John Reese](http://noswap.com) as a labor of love. It builds on top of many fine projects from the open source community, such as:

Inspiration for Nib its design is thanks to [Oben Sonne](http://obensonne.bitbucket.org/) and his project [Poole](http://bitbucket.org/obensonne/poole).

Metadata

Release files for Nib 0.5.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Nib 0.5.7
File Size Uploaded Provenance
Nib-0.5.7.tar.gz 31.2 kB Without provenance Details

Release files / Nib-0.5.7.tar.gz

Download URL Nib-0.5.7.tar.gz
Size 31.2 kB
Tags Source
SHA-256 checksum
How to use checksums
242a44c1655bc36bc10fb186aa9b1c36bb687cb20ec91cea58b623f3662ebaef
BLAKE2b-256 checksum
How to use checksums
651468231cb0e0741c10bebab5e748ab8811f83c57f62687b3855bd5f41a9df1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for Nib 0.5.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.5.7 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page