Adding Content from the Browser
The Yurt CMS browser interface is designed strictly for editing text content on the site, so the only things you'll get to work with in the browser are files and folders. Following the 80/20 rule, 80% of your time is probably going to be spent editing text or managing the overall organization of your site. When it comes to adding images and other types of binary media, there are better ways to add it to the system than through the browser.
Once you've generated a new site (with yurt newsite sitename) and updated your webserver to see the site, you're ready to begin adding content from the browser.
First Impressions: Browsing the Content of Your Site
Assuming that you've set up the site on your machine at the default port of :9878, you can then point your browser at http://localhost:9878/yurt/ to bring up the web UI. This is what it looks like:
The home folder represents the starting point from which you can browse all of the folders and files on your site. Click on the home folder. It brings up a contextual menu, offering you a set of options to choose from.
Select the Open menu to reveal the contents. Now click on the index file. Notice that a different menu pops up.
These are the only two menus you'll ever see when browsing through your directory tree. Let's review the commands they offer.
Folder-Based Commands
Open
We've already used this just a moment ago; the Open command simply reveals the contents of the folder. If nothing appears to happen, that's probably because the directory is empty. You can always verify this by looking in the projectname/content directory in the console.
New Folder
Selecting this item reveals the New Folder dialog. Enter the name of the folder you wish to create.
Please use characters that you would normally expect to be valid for your folder/directory name. We suggest using upper and lower case letters, numbers, and the following punctuation (sans quotes): ".", "_", "-". If you try to type in illegal characters, the application will convert them to underscores.
Once you're done, click the Add button, and you should be rewarded with a message indicating success. When you click the Add button, the folder you just added is actually added in the content/ directory, the htdocs/ directory and the htdocs/includes/content directory.
New File
Selecting New File... from the contextual menu brings up this dialog. Start off by entering the name of the file you wish to create.
If you are adding a file that will be referenced by another file, you should check the Partial? checkbox. What this will do is provide a hint to the HTML file generator that this file isn't a full web page, but a part of a document. Since it's only part of a document, a Title, Description and Keywords aren't required.
Those three fields, by the way, represent the type of metadata found in most pages -- the Title field populates the <title> tag, and the Description and Keywords fields populate <meta> tags of the same type.
New to the Yurt CMS 0.2.0 is the Template dropdown. If you have set up more than one template for your site, you can choose which one you want to use for this file. For more information on how to add templates, please review the tips offered in designing a site.
The content of the file is written using Markdown syntax. Markdown is a simple syntax that also permits the use of inline HTML for maximum flexibility.
Once you're done, click the Add button, and you should be rewarded with a message indicating success. When you click the Add button, the file you just added is saved in the content/ directory, and the HTML version of the file is auto-generated and saved within the htdocs/ directory and the htdocs/includes/content directory. For more information about where new files are being put, consult the Designing a Yurt CMS Site page.
Delete
Selecting this item will delete the folder you clicked on. The delete feature for both files and folders is pretty dumb - it can only delete one file or folder at a time, and folders must be empty.
File Based Commands
Edit File
The Edit file command brings up the same dialog as the Add File command does, save that the contents of the dialog have been filled in with the contents of the file you're editing. Make your edits, and click the Add button.
When you click the Add button, the file you just added is saved in the content/ directory, and the HTML version of the file is auto-generated and saved within the htdocs/ directory and the htdocs/includes/content directory. For more information about where new files are being put, consult the Designing a Yurt CMS Site page.
Delete
Selecting this item will delete the file you clicked on. The delete feature for both files and folders is pretty dumb - it can only delete one file or folder at a time, and, before deleting folders, they must be empty.