Welcome to documentation for the WDS Site!
Details about editing content for the page are directly below.
Developer documentation can be found here
As of WDS 2014, all content on the WDS site is managed right here from GitHub.
You can easily create and edit pages from GitHub's interface, hit save and your changes are instantly sent to the WDS server and made live.
A page is created just by typing normally - text can be styled with either Markdown (super-easy and explained more below) or normal HTML.
Every change you make is tracked so if any problems occur, you can always roll back.
The guide below explains all the details of how this system works.
Here are two screencasts to help you get started - you can see the whole process from start to finish!
A basic guide explaining things slowly:
How to Create and Edit Pages at WDS.com
A realistic run through of creating a hypothetical page:
A Realistic Example of Creating a Page at WDS.com
Let's get started!
To create a file you'll first want to click into the _content folder. This is the folder where all content pages should be. The only other folder you may need is _sidebars - you can ignore all others listed.
Once in the _content directory, click the small page-with-a-plus icon to create a new file there.
Now you're in the GitHub text editor, nice work so far!
The first task is to name your file in the textbox that says "Name your file..."
Important: The name of your file should always end in .md (as in: MarkDown)
Also Important: The name you give your file is what the path will ultimately be. It should be all lowercase and use plain dashes instead of spaces.
So, if you create a file called: dont-stop-believin.md, that will create a page at http://worlddominationsummit.com/dont-stop-believin
Now, all you need to do is add some content into the big text area (more details on formatting that content below) and click the Commit Changes button - think of that as a "Save & Publish" button.
Boom! You just created a page!
To edit an existing page, click on the filename in the _content folder and then click the Edit button.
For the most part, you can just type and all your content will be properly formatted to fit the style of the WDS site but there are a few details to note.
Markdown is an easy way to format text used all over the web - you may be using it without even realizing.
If you've ever used *asterisks* to italicize something - that's Markdown!
With Markdown you can also
Create links: [Link Text](http://link-to-this-site.com)
Add images: 
Every single page should have a main heading and sub-headings are an important part of creating readable pages - so let's take a second to talk about them.
In Markdown, any line starting with a pound sign (#) becomes a heading. A top level heading has just one pound sign and adding additional pound signs decreases the importance.
# This is a top-level heading in Markdown
## This is a second-level heading
### This is a third-level heading
Important: Every single page you create should either start with a first-level or second-level heading.
If you start with a first-level heading, the heading will look like this:
If you start with a second-level heading (Two pound signs), the heading will look like this:
Notice above that once we're in the main body content, we use third-level and below headings (three pound signs!).
Here's what's awesome about this: you don't really have to worry about page styling at all.
Just write normal text with these few simple rules and then the site will automatically turn that into a beautiful page for you.
Want to learn more Markdown to spruce up your pages? Start with this guide.
You shouldn't ever need to use HTML in your page. But you can!
This means that if more complex elements are needed on your page, you or someone on the dev-team can easily make them a reality.
Each page can has some options that you're able to set like which icon should display in the corner or which sidebar should be displayed when that page is shown.
If you want to include settings they should be the very first thing entered in your file. They're set with setting_name: setting_value.
So, your file might look something like this:
icon: suitcase
sidebar: foundation
# The WDS Foundation was created to support people everywhere who want to start project aligned with the values of Community, Service and Adventure
We want you to apply now...
| Name | Available Values |
|---|---|
| icon | globe, parachute, suitcase, pin, theater, moon, chat, namaste, compass, fork, mic, moon, trail, beer, tree, bulb, map, plane, hands, camera, coins |
| sidebar | Any sidebar file-name in _sidebars |
| photo_head | A comma-separated list of image URLs |
As mentioned above, you have total control over the sidebar that appears when your page is displayed.
Sidebars are created exactly as pages are except instead of creating a file in the _content folder, you'll be working in the _sidebars folder.
The filename should end in .md, just like a page, and the name you give the file is the value you'll use in your page settings to connect it.
Normally, your entire sidebar file is just a list of Markdown links, like this example for the foundation.
Those will automatically take on the style of the WDS site.
Of course, you can also use normal HTML in these files if you want something more specific.
The following are snippets of HTML you can copy and paste into your content to add some visual decoration.
| Decoration | HTML |
|---|---|
| Blue zig-zag separator | <div class="zig-zags_blue"></div> |
| Canvas solid-line separator | <div class="line-canvas"></div> |
| Register Button | <a href="/register" class="register-banner"></a> |
We'll be using Wufoo for forms - more coming soon!
I know you'll be needing to upload images to use for your pages - a simple system for this is coming soon!
Coming soon!
Coming soon!