diff --git a/content-sample/index.md b/content-sample/index.md index b487ca6..9a85330 100644 --- a/content-sample/index.md +++ b/content-sample/index.md @@ -10,18 +10,24 @@ Congratulations, you have successfully installed [Pico](http://picocms.org/). ## Creating Content -Pico is a flat file CMS, this means there is no administration backend or -database to deal with. You simply create `.md` files in the `content-sample` -folder and that becomes a page. For example, this file is called `index.md` -and is shown as the main landing page. +Pico is a flat file CMS. This means there is no administration backend or +database to deal with. You simply create `.md` files in the `content` folder and +those files become your pages. For example, this file is called `index.md` and +is shown as the main landing page. -If you create a folder within the content folder (e.g. `content-sample/sub`) -and put an `index.md` inside it, you can access that folder at the URL -`http://example.com/pico/?sub`. If you want another page within the sub folder, +When you install Pico, it comes with a `content-sample` folder. Inside this +folder is a sample website that will display until you add your own content. +You should create your own `content` folder in Pico's root directory and place +your files there. No configuration is required, Pico will automatically use the +`content` folder if it exists. + +If you create a folder within the content folder (e.g. `content/sub`) and put an +`index.md` inside it, you can access that folder at the URL +`http://example.com/?sub`. If you want another page within the sub folder, simply create a text file with the corresponding name and you will be able to -access it (e.g. `content-sample/sub/page.md` is accessible from the URL -`http://example.com/pico/?sub/page`). Below we've shown some examples of -locations and their corresponding URLs: +access it (e.g. `content/sub/page.md` is accessible from the URL +`http://example.com/?sub/page`). Below we've shown some examples of locations +and their corresponding URLs:
content-sample/index.md | +content/index.md | / | |
content-sample/sub.md | +content/sub.md | ||
content-sample/sub/index.md | +content/sub/index.md | ?sub (same as above) | |
content-sample/sub/page.md | +content/sub/page.md | ?sub/page | |
content-sample/a/very/long/url.md | -?a/very/long/url (doesn't exist) | +content/a/very/long/url.md | ++ ?a/very/long/url + (doesn't exist) + |
!\[Image Title\](%base_url%/assets/image.png)
+(like images, downloads, etc.). We even deny access to your `content` directory
+by default. If you want to use some assets (e.g. a image) in one of your content
+files, you should create an `assets` folder in Pico's root directory and upload
+your assets there. You can then access them in your markdown using
+%base_url%/assets/
for example:
+!\[Image Title\](%base_url%/assets/image.png)
### Text File Markup
@@ -93,8 +100,8 @@ There are also certain variables that you can use in your text files:
* %base_url%
- The URL to your Pico site; internal links
can be specified using %base_url%?sub/page
* %theme_url%
- The URL to the currently used theme
-* %meta.*%
- Access any meta variable of the current page,
- e.g. %meta.author%
is replaced with `Joe Bloggs`
+* %meta.*%
- Access any meta variable of the current
+page, e.g. %meta.author%
is replaced with `Joe Bloggs`
### Blogging