Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dotmpe/node-sitefile

Bootstrap webserver for misc. resources using Sitefile.
https://github.com/dotmpe/node-sitefile

coffeescript expressjs html-css nodejs requirejs sitefile yaml

Last synced: 11 days ago
JSON representation

Bootstrap webserver for misc. resources using Sitefile.

Host: GitHub
URL: https://github.com/dotmpe/node-sitefile
Owner: dotmpe
License: gpl-3.0
Created: 2015-03-28T15:17:48.000Z (over 9 years ago)
Default Branch: master
Last Pushed: 2023-11-30T14:31:49.000Z (12 months ago)
Last Synced: 2024-10-11T04:21:34.252Z (about 1 month ago)
Topics: coffeescript, expressjs, html-css, nodejs, requirejs, sitefile, yaml
Language: CoffeeScript
Homepage:
Size: 6.64 MB
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 21
Metadata Files:
- Readme: ReadMe.rst
- Changelog: Changelog.rst
- License: LICENSE

Awesome Lists containing this project

README

Node Sitefile
=============
:Version: 0.0.6-dev
:Status: Development
:package: Changelog_

.. image:: https://badge.fury.io/js/node-sitefile.png
:target: http://badge.fury.io/js/node-sitefile
:alt: NPM

.. image:: https://gemnasium.com/dotmpe/node-sitefile.png
:target: https://gemnasium.com/dotmpe/node-sitefile
:alt: Dependencies

.. image:: https://snyk.io/package/npm/name/badge.svg
:target: https://snyk.io/package/npm/name
:alt: Vulnerabilities

:project:

.. image:: https://coveralls.io/repos/dotmpe/node-sitefile/badge.png
:target: https://coveralls.io/r/dotmpe/node-sitefile
:alt: Coverage

.. image:: https://secure.travis-ci.org/dotmpe/node-sitefile.png
:target: https://travis-ci.org/dotmpe/node-sitefile
:alt: Build

..
.. image:: https://img.shields.io/github/issues/dotmpe/node-sitefile.svg
:target: http://githubstats.com/dotmpe/node-sitefile/issues
:alt: GitHub issues

:repository:

.. image:: https://badge.fury.io/gh/dotmpe%2Fnode-sitefile.png
:target: http://badge.fury.io/gh/dotmpe%2Fnode-sitefile
:alt: GIT

:autobuild:

.. image:: https://images.microbadger.com/badges/image/bvberkum/node-sitefile.svg
:target: https://microbadger.com/images/bvberkum/node-sitefile
:alt: Data by microbadger.com

.. include:: doc/.defaults.rst

Intro
------
Sitefile is a local website server for (project) documentation or notebooks.
It is targetted at users/authors of plain-text, file-based content. It aims to
add hypertext capabilities to documents of the literal kind, and any other
interpreted language.

.. TODO get some screenshots here, and point to the rest of the docs.

It at as of 0.0.5-dev supports a couple of markup formats, a diagramming
languages, has some initial database support and other Node.JS native languages.

The main documentation is written in reStructuredText format for the Python
Docutils publisher. But as many other formats are available as `routers` can be
written for, currently: Markdown, Stylus, SASS/SCSS, Coffee Script, Graphviz and
others.

Quickstart
----------
Have a ``Sitefile.yaml`` or ``.json`` and fire up `sitefile` from this directory.

E.g. to serve a simple little site::

sitefile: 0.0.5-dev
routes:
_my_markdown_routes: md:**/*.md
_my_stylus_routes: styl:**/*.styl
media: static:media/
ChangeLog: du.rst2html:ChangeLog.rst

That's it! This expands to routes for all ``*.md`` and ``*.styl`` files, serves
anything in media at ``/media/``, and has another static URL path that renders
the changelog with Docutils.

The idea is to leave as much as the aspects of the resources to some
in-filesystem object or other local service, wether a document, metadatafile or
database. That said the ``Sitefile.yml`` can also hold options, and currently
cat gets pretty crammed. But future plans include making it optional, and
parameterize simple Sitefile sessions through command line arguments.

The ``Sitefile.yaml`` with `node-sitefile` and the list of routers in
``lib/sitefile/routers`` for now provides the best starting point for support.

Behind the scenes better documentation and testing is being setup. See the
dev_ docs.

.. important::

The syntax will change for 0.1 and/or 1.0

Installation
------------
For a stale version::

npm install node-sitefile

For the latest version, get the project (clone, download) and inside folder::

npm install -g

Or just make ``bin/sitefile`` available on your path wherever you want.

Testing
-------
::

npm install
npm test

Test specifications are in ``test/mocha/``.

Versions
--------
See changelog_.

Documentation
-------------
- `Docco docs`__

- `Development Docs `_

.. __: /doc/literate