Porting Subfolio Enhancers examples to the main repo.

.gitignore

@@ -2,4 +2,3 @@ engine/application/logs/*
engine/info/disabled.php
.DS_Store
.htaccess
directory/*

directory/.gitignore

@@ -1 +0,0 @@
*

directory/examples/-b-footer.txt

@@ -0,0 +1,3 @@


**Important note:** Enhancer files must be encoded as Unicode (UTF-8) for them to work properly. Enhancer files use YAML, a human friendly data serialization standard stored in plaintext files. Indentation, spacing and text case are super important. Learn more at "yaml.org":http://www.yaml.org.

directory/examples/-hidden/-t-this_file_is_hidden.txt

@@ -0,0 +1,7 @@
h1. Hiding content

h2. Enhancer

Did you know that you can hide any file or folder simply by putting a dash in the name? For example, this folder is called -hidden (look in the URL) and if you didn't notice, it wasn't listed in the file listing.

Of course, you can still get to it via direct URL.

directory/examples/-t-introduction.txt

@@ -0,0 +1,8 @@
h1. Subfolio Enhancers

h2. Demo files

h3. Getting started with Subfolio enhancers

Here is everything you need to take advantage of enhancers... just copy these files and customize. 

directory/examples/00_thumbnails.info

@@ -0,0 +1,4 @@
# YAML NOTE: Indentation, spacing and text case are super important.
# This file must be encoded as Unicode (UTF-8) for it to work properly.

comment: This is a comment on a file or folder

directory/examples/00_thumbnails/-t-readme.txt

@@ -0,0 +1,5 @@
h1. Thumbnails

h2. Enhancer

Thumbnails are automatically created for browser-viewable images (unless they are too big). To create custom thumbnails, see <a href="00_thumbnails/-thumbnails_custom/">-thumbnails_custom</a> folder. 

directory/examples/00_thumbnails/-thumbnails_custom/-t-readme.txt

@@ -0,0 +1,18 @@
h1. Custom Thumbnails

h2. Enhancer

If a -thumbnails-custom/ folder exists, any thumbnails within it will override the auto-generated -thumbnails/ folder content.

To create a custom thumbnail:

1. If it doesn't exist, create a folder called "-thumbnails-custom" within the same folder your images are in.

2. Design your custom thumbnails with any size you desire.

3. Giving your thumbnail the same filename as the image it is referencing.

3. Upload your custom thumbnail(s) to the "-thumbnails-custom" folder.

directory/examples/01_embedding_text_images/-b-bottom-text.txt

@@ -0,0 +1,8 @@
h1. Embedding text and images

h2. Bottom of page


<pre><code>-b-bottom-text.txt</code></pre>

This text will appear at the bottom of the page, *below the file listing*. You can use textile, markdown or html. Set your preference in your settings. 

directory/examples/01_embedding_text_images/-m-middle_text.txt

@@ -0,0 +1,8 @@
h1. Embedding text and images

h2. Middle of page


<pre><code>-m-middle-text.txt</code></pre>

This text will appear on the top of the page, *below any images or features* you may have in the folder, but above the file listing. You can use textile, markdown or html. Set your preference in your settings.

directory/examples/01_embedding_text_images/-t-top-text.txt

@@ -0,0 +1,7 @@
h1. Embedding text and images

h2. Top of page

<pre><code>-t-top-text.txt</code></pre>

This text will appear at the top of the page, *above any images or features* you may have in the folder. You can use textile, markdown or html.  Set your preference in your settings. 

directory/examples/01_embedding_text_images/file-listing-placeholder-01.txt

@@ -0,0 +1 @@
This file is here simply to show the file listing. 

directory/examples/01_embedding_text_images/file-listing-placeholder-02.txt

@@ -0,0 +1 @@
This file is here simply to show the file listing. 

directory/examples/01_embedding_text_images/file-listing-placeholder-03.txt

@@ -0,0 +1 @@
This file is here simply to show the file listing. 

directory/examples/02_popups_links_shortcuts/-t-readme.txt

@@ -0,0 +1,5 @@
h1. Popups, links and shortcuts

h2. Enhancer

File listings are for files. But sometimes you want to show something in a popup window, link to another website or create a shortcut to content in other folders. This is how you do it. 

directory/examples/02_popups_links_shortcuts/area17.com.link

@@ -0,0 +1,6 @@
# YAML NOTE: Indentation, spacing and text case are super important.
# This file must be encoded as Unicode (UTF-8) for it to work properly.

target: _blank
url: http://www.area17.com
comment: Example link to an external website.

directory/examples/02_popups_links_shortcuts/giant_step_jukebox.pop

@@ -0,0 +1,8 @@
# YAML NOTE: Indentation, spacing and text case are super important.
# This file must be encoded as Unicode (UTF-8) for it to work properly.

url: http://jukebox.giantstep.net/player
width: 494
height: 560
style: WINDOW
comment: Example link within a pop-up window.

directory/examples/02_popups_links_shortcuts/internal-shortcut.cut

@@ -0,0 +1,5 @@
# YAML NOTE: Indentation, spacing and text case are super important.
# This file must be encoded as Unicode (UTF-8) for it to work properly.

name: internal shortcut
directory: -hidden

directory/examples/03_featuring_content/-t-readme.txt

@@ -0,0 +1,5 @@
h1. Featuring content

h2. Enhancer

If you are looking to make a portfolio website or you just want to feature certain content, this enhancer is your best friend. You can feature a link to another website, to a file or folder. If you feature a file or folder that is in the same folder, it will magically disappear from the file listing.

directory/examples/03_featuring_content/featured-file.txt

@@ -0,0 +1 @@
You've arrived at your featured file. Notice that featuring a file in the same directory makes it disappear from the listing. 

directory/examples/03_featuring_content/featured-link.ftr

@@ -0,0 +1,27 @@
# YAML NOTE: Indentation, spacing and text case are super important.
# This file must be encoded as Unicode (UTF-8) for it to work properly.

# Note: to hide the title, thumbnail or description, put # in front of that line. 

### Give your feature a title
### Add the a local or offsite link

title: Featured Link
link: http://www.area17.com

### Add path to thumbnail image (standard size 249x159)
### Put your image in a folder called "-thumbnails-custom"

image: -thumbnails-custom/link_thumbnail.png

### Define the size of the entire feature
### Default margin is 15px

width: 250
height: 230

### Add a description
### Make sure there is a space at the beginning of the line.

description:>
 You can feature any local or offsite link. Also good for surfacing files and folders that are deep in your site.

directory/examples/03_featuring_content/featured_file.ftr

@@ -0,0 +1,27 @@
# YAML NOTE: Indentation, spacing and text case are super important.
# This file must be encoded as Unicode (UTF-8) for it to work properly.

# Note: to hide the title, thumbnail or description, put # in front of that line. 

### Give your feature a title
### Add the path to the file

title: Featured File
file: featured-file.txt

### Add path to thumbnail image (standard size 249x159)
### Put your image in a folder called "-thumbnails-custom"

image: -thumbnails-custom/file_thumbnail.png

### Define the size of the entire feature
### Default margin is 15px

width: 250
height: 230

### Add a description
### Make sure there is a space at the beginning of the line.

description:>
 You can feature a file in the same folder. By doing so, the file will not appear in the listing below. 

directory/examples/03_featuring_content/featured_folder.ftr

@@ -0,0 +1,27 @@
# YAML NOTE: Indentation, spacing and text case are super important.
# This file must be encoded as Unicode (UTF-8) for it to work properly.

# Note: to hide the title, thumbnail or description, put # in front of that line. 

### Give your feature a title
### Add the path to the file

title: Featured Folder
folder: featured_folder

### Add path to thumbnail image (standard size 249x159)
### Put your image in a folder called "-thumbnails-custom"

image: -thumbnails-custom/folder_thumbnail.png

### Define the size of the entire feature
### Default margin is 15px

width: 250
height: 230

### Add a description
### Make sure there is a space at the beginning of the line.

description:>
 You can feature a folder in the same folder. By doing so, the folder will not appear in the listing below. 

directory/examples/03_featuring_content/featured_folder/-t-featured-folder.txt

@@ -0,0 +1 @@
You've arrived at your featured folder. Notice that featuring a folder in the same directory makes it disappear from the listing. 

directory/examples/04_html_prototype/-t-readme.txt

@@ -0,0 +1,5 @@
h1. HTML Prototype

h2. Enhancer

Have a prototype that you need to show but don't want it in the Subfolio framework ... just add a .site extension to your folder and you are done. To work properly, an index.html file must exist within the folder.

directory/examples/04_html_prototype/04_html_prototype.site/index.html

@@ -0,0 +1,20 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML Transitional 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  <meta http-equiv="Content-Style-Type" content="text/css">
  <title></title>
  <meta name="Generator" content="Cocoa HTML Writer">
  <meta name="CocoaVersion" content="949.54">
  <style type="text/css">
    p.p1 {margin: 0.0px 0.0px 0.0px 0.0px}
    p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Times; min-height: 14.0px}
    font.f1 {font: 12.0px Times}
  </style>
</head>
<body>
<p class="p1"><font face="Times" size="3" class="f1">This is my lovely HTML prototype.</font></p>
<p class="p2"><br></p>
<p class="p1"><font face="Times" size="3" class="f1">IMPORTANT: To work, index.html must exist within the folder.</font></p>
</body>
</html>

directory/examples/05 display rss feed/-rss-enhancer.rss.cache

@@ -0,0 +1 @@
a:0:{}

directory/examples/05 display rss feed/-t-readme.txt

@@ -0,0 +1,6 @@
h1. RSS

h2. Enhancer

The RSS enhancer allows you to take any RSS feed from anywhere and display it within Subfolio. It could be used as a stand alone file (eg. example.rss) or as an embedded text file (eg. -t-example.rss). 

directory/examples/05 display rss feed/rss-enhancer.rss

@@ -0,0 +1,8 @@
# YAML NOTE: Indentation, spacing and text case are super important.
# This file must be encoded as Unicode (UTF-8) for it to work properly.

# Note: It may take a few minutes to work for the first time. 

feedurl: http://feeds.feedburner.com/area17/news
count: 10  # maxiumum number of items to show
cache: 3600 # number of seconds to cache the feed for

directory/examples/06 slideshow.slide/-t-readme.txt

@@ -0,0 +1,5 @@
h1. Slideshow

h2. Enhancer

Don't want your users to see thumbnails? No problem, simply put a .slide extension to any folder and the user will go directly to the first image (or file) in that folder.

directory/examples/07_protecting_a_folder/-access

@@ -0,0 +1,16 @@
# YAML NOTE: Indentation, spacing and text case are super important.
# This file must be encoded as Unicode (UTF-8) for it to work properly.

# Note: Users and groups have to be created first in your settings before this will work.

allow_users: [username, username, etc]
allow_groups: [groupname, groupname, etc]
deny_users: [username, username, etc]
deny_groups: [groupname, groupname, etc]
Does not apply to sub-folders:

current_folder:
 allow_users: [username, username, etc]
 allow_groups: [groupname, groupname, etc]
 deny_users: [username, username, etc]
 deny_groups: [groupname, groupname, etc]

directory/examples/07_protecting_a_folder/-t-readme.txt

@@ -0,0 +1,6 @@
h1. Protecting a folder

h2. Enhancer

You can deny/allow user/group access to any folder. Users and groups have to be created first in your settings before this will work.

directory/examples/hiding_content.cut

@@ -0,0 +1,5 @@
# YAML NOTE: Indentation, spacing and text case are super important.
# This file must be encoded as Unicode (UTF-8) for it to work properly.

name: hiding content
directory: 02_enhancers/-hidden

directory/examples/textile_cheat_sheet.txt

@@ -0,0 +1,72 @@
h1. Subfolio Enhancers

h2. Textile cheat sheet

h3. Using markup in enhancers

Markup can be used to style text within enhancers files. Subfolio uses Textile by default, however you can change this to Markdown or HTML in your general settings. 

***

h1. Header 1

<pre><code>h1. Header 1</code></pre>

h2. Header 2

<pre><code>h2. Header 2</code></pre>

h3. Header 3

<pre><code>h3. Header 3</code></pre>

This is _italicized_

<pre><code>This is _italicized_</code></pre>

This is *bold*

<pre><code>This is *bold*</code></pre>

* Bulleted item 1
* Bulleted item 2

<pre><code>* Bulleted item 1
* Bulleted item 2</code></pre>

# Numbered item 1
# Numbered item 2

<pre><code># Bulleted item 1
# Bulleted item 2</code></pre>

"text link":http://area17.com

<pre><code>"text link":http://area17.com</code></pre>

_Embed an image:_

<pre><code>!http://www.example.com/image.png!</code></pre>

bq. Blockquoted Text

<pre><code>bq. Blockquoted Text</code></pre>

_Embed Code:_

To get this:

<pre><code>/* Code Block */
#include <stdio.h>
#include <stdlib.h>
  int main()
</code></pre>

Do this: 

<pre><code><pre><code>
/* Code Block */
#include <stdio.h>
#include <stdlib.h>
      int main()</code></pre>
</code></pre>