comparison docs/pages/_index.md @ 243:26e59f837558

docs: Add embryo of a documentation website.
author Ludovic Chabant <ludovic@chabant.com>
date Thu, 19 Feb 2015 08:09:17 -0800
parents
children 1970e7e3a18e
comparison
equal deleted inserted replaced
242:f130365568ff 243:26e59f837558
1 ---
2 title: PieCrust
3 layout: splash
4 ---
5
6 ---slogan---
7
8 Baking fresh websites & documents since 2006
9
10
11 ---main---
12
13 **PieCrust** is a static website generator and flat-file CMS. No complex setup,
14 databases, or administrative panels -- it's all text files. Simple, beautiful,
15 and yummy.
16
17 *[CMS]: Content Management System
18
19
20 ---simple---
21
22 ### Store in the cellar
23
24 Because all your site's content and configuration is stored in simple text
25 files, it fits nicely in a revision control system like Git or Mercurial. It's
26 not only more practical, but also safer!
27
28
29 ---bake---
30
31 ### Serve on the counter
32
33 Although it can run a flat-file CMS, **PieCrust** is designed as a static
34 website generator. This means it can "bake" your website into simple HTML files
35 that you can publish with a minimum of resources on your server. A sudden spike
36 of visitors can't crash your MySQL database when you don't need one!
37
38
39 ---ingr---
40
41 ### Familiar ingredients
42
43 **PieCrust** uses all the ingredients you already like, such as Markdown and
44 Textile for formatting, or Jinja2 and Mustache for templating.
45
46
47 ---oven---
48
49 ### Fully functioning oven
50
51 **PieCrust** comes out-of-the-box with an asset processing pipeline, capable of
52 handling most of your files -- Less/Sass processing, CSS and JS
53 minification, concatenation, and more.
54
55
56 ---cooks---
57
58 ### Several cooks in the kitchen
59
60 If you're dealing with advanced scenarios, **PieCrust** will gladly interoperate
61 with other tools like Grunt, Compass, Bower, and many more.
62
63
64 ---fast---
65
66 ### Super-fast service
67
68 Because **PieCrust** is also designed as a lightweight (flat-file) CMS, it can
69 render your pages in less than a few milliseconds in most cases. It means that
70 previewing or generating your website is super fast!
71
72
73 ---carte---
74
75 ### A La Carte Content
76
77 **PieCrust** comes with a powerful system of page sources, routes, and taxonomies.
78 This means you can completely customize how you want to author your content, and
79 how it gets exposed.
80
81
82 ---entrees---
83
84 ### Multiple entrées
85
86 Your pages are not limited to one piece of content that you place in the center
87 of your layout. You can define other “text segments” like a page-specific menu
88 or sidebar text that you can insert in different places in the layout.
89
90
91 ---startnow---
92
93 ## Get Started Now
94
95 You can follow the detailed instructions on the [Getting Started][1]
96 page, or, if you're already experienced in the culinary arts:
97
98 virtualenv pcenv
99 <activate pcenv>
100 pip install piecrust
101 chef init mynewwebsite
102 cd mynewwebsite
103 chef prepare post my-first-post
104 chef serve
105 chef bake
106
107
108 [1]: {{pcurl('getting-started')}}
109