GettingStartedWithScriptOGram 2011-12-31.Md

Embed Size (px)

Citation preview

  • 7/30/2019 GettingStartedWithScriptOGram 2011-12-31.Md

    1/2

    Date: 2011-12-31 12:31Title: This is your blog, delivered by scriptogr.am

    Thank you for using scriptogr.am. While were still in early beta development, wethink youll enjoy the app. Its designed to be fast, simple and to get the most creativity out of you.

    scriptogr.am uses [Markdown](http://daringfireball.net/projects/markdown/ "Markdown"), a lightweight markup language, originally created by [John Gruber](http://daringfireball.net/ "Daring Fireball") and [Aaron Swartz](http://www.aaronsw.com/ "Aaron Swartz"). Markdown is a text-to-HTML conversion tool for web writers.Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML). See the [Syntax](http://daringfireball.net/projects/markdown/syntax "Markdown syntax") page for details pertaining to Markdowns formatting syntax. You can try it out, right now, using the online [Dingus](http://daringfireball.net/projects/markdown/dingus "Dingus").

    # Getting started

    After connecting your Dropbox account to scriptogr.am, some necessary files andfolders are added to your Dropbox at `Apps/scriptogram`. First the *GET_STARTED.txt* text file that pretty much explains the exact same as what youre reading now. Next, weve added a `posts` folder. This is where you add your blog *post* (& *p

    age*) files. These files are plain textfiles, but needs to be saved with the .md(markdown) extension like this: *yourfile.md*

    ![](http://dl.dropbox.com/u/35476/_scriptogram/folder.png)

    Please use standard, non foreign filenames. Dropbox sometimes have problem syncing filenames that contains invalid HTML characters.Weve added a post example page (this file) there for you to get familiar with.

    ## The template dataAll files needs to contain "front block". The front block must be the first thing in the file and takes the form of:

    Date: 2012-04-17Title: My first post

    You can set any of the predefined variables (see below for a reference). But, the *Title* is required. Without the title, the system will fail.

    ### Predefined global variables_All the variable names below are case-sensitive:_

    `Required:`

    Title

    The title of your post (or page)

    `Not required, but close to:`

    Date

    The following date format is the correct one to use: *2011-12-31 12:31* or *2011-12-31*.

  • 7/30/2019 GettingStartedWithScriptOGram 2011-12-31.Md

    2/2

    (The *Date* variable can be used to ensure correct sorting of posts.)

    `Optional:`

    Published

    Set to false if you dont want a post to show up when the site is generated.

    Type

    Set to page if you want the post to act as a page instead of a post.

    Slug

    Custom permalink (replaces the auto generated url based on the "Title:" variable), especially useful if titles tend to be long or they change frequently. E.g my-custom-permalink-url

    Link

    Links the "post" or "page" title to an external source. E.g http://google.com

    Tags

    Add tags to your posts and pages. Comma separated words. Once added, scriptogr.am will transform all tags to valid basic HTML characters.

    Excerpt

    Add an excerpt[^1] to your post or page.

    ## Difference between posts and pages

    A `post` is a blog post.

    A `page` is a similar as a *post*, but generates a link visible in the *menu* on

    your site that will lean to a page permalink.

    # Publishing your posts

    This is simple. Just head to your admin panel and hit the Synchronize button. Whenlogged in to scriptogr.am and visiting your own page, youll see the scriptogr.amlogotype symbol on the top right of the browser window. This is the link that leads to your admin panel.

    ## Published vs unpublished

    Total count of published and unpublished posts (& pages) are visible next to theSynchronize button. Unpublished means that you either removed a post text file fro

    your Dropbox or that something went wrong while trying to sync your Dropbox with scriptogr.am. Also, if youve set a post to be published with the `Published: false` variable.

    **Finally,** happy posting. If you have any questions, suggestions or thoughts just drop us an [e-mail](mailto:[email protected]) at any time.

    [^1]: An [excerpt](http://en.wikipedia.org/wiki/Excerpt "Excerpt on Wikipedia")is a relatively small sample passage from a longer work, such as a book or article.