@superflycss/pli
Version:
Standard directory layout for all SuperflyCSS modules
63 lines (47 loc) • 3.53 kB
Markdown
# SuperflyCSS Project Layout Instance (PLI)
The PLI (Project Layout Instance) is a javascript object model of the standard directory layout that all [SuperflyCSS](https://github.com/superfly-css/superfly-css/) modules use. The standard layout enables users to instantly feel at home in any one of the [SuperflyCSS](https://github.com/superfly-css/superfly-css/) modules.
The PLI is inspired by the [Apache Maven Standard Directory Layout](https://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html).
## Directory Descriptions
The following directories are modeled by the PLI.
### Source Directories
| Directory | Summary |
|:------------------|:----------------------------------------------------------|
| src/main/css | Entry level CSS module(s) are contained in this directory |
| src/main/sss | Entry level SSS module(s) are contained in this directory |
| src/main/js | Javascript supporting dynamic demoes |
| src/main/html | Dynamic demonstrations |
| src/main/nunjucks | Nunjucks Templates |
| src/test/css | CSS test utilities |
| src/test/sss | SSS test utilities |
| src/test/js | Javascript supporting CSS unit tests |
| src/test/html | Html pages for loading the unit tests |
| src/test/nunjucks | Nunjucks Template unit tests |
### Target Directories
| Directory | Summary |
|:---------------------|:-----------------------------------|
| target/main/css | Built CSS modules |
| target/main/js | Built javascript |
| target/main/html | Built dynamic demo html pages |
| target/main/nunjucks | Precompiled Nunjucks Templates |
| target/test/css | Built test CSS utilities |
| target/test/js | Built test Javascript |
| target/test/html | Built test html |
| target/test/nunjucks | Built Nunjucks Template unit tests |
### Deploy Directories
Resources that are contained in the `deploy` directory are intended to be served by `gh-pages` for all superfly-css repositories. Resources placed in these directories are optimized by [superfly-css-task-deploy](https://github.com/superfly-css/superfly-css-task-deploy).
| Directory | Summary |
|:---------------------|:----------------------------------------|
| deploy/main/css | Deployable CSS modules |
| deploy/main/js | Deployable javascript |
| deploy/main/html | Deployable dynamic demo html pages |
| deploy/main/nunjucks | Deployable Nunjucks Templates |
| deploy/test/css | Deployable test CSS utilities |
| deploy/test/js | Deployable test Javascript |
| deploy/test/html | Deployable test html |
| deploy/test/nunjucks | Deployable Nunjucks Template unit tests |
## Extension
More directories can easily be added, and will naturally fit with the build methodology. For example:
| Directory | Summary |
|:---------------------|:---------------|
| src/main/coffescript | Coffescript |
| src/main/jade | Jade templates |