How to Contribute a Walkthrough

gravatar

Daniel Dersch

Demonstrates how to create a Walkthrough on BimlScript.com

published 09.13.12

last updated 10.02.12


Share

Tags

  • howto
  • walkthrough

Click here to view the video version of this walkthrough.

Start by joining BimlScript.com.

Log in to your account.

alt text here…

Click the Contribute link on the main menu.

alt text here…

You are now on the create walkthrough page.

alt text here…

The first thing you will notice is the Upload photo button. This allows you to upload photos to use in your Walkthrough. This functionality is further explained toward the end of this walkthrough.

Fill in the Title, Tags, Summary, Topics, and Versions fields.

The Title field should be as concise as possible but as descriptive as necessary.

alt text here…

Tags are separated by whitespace. Multiword Tags are to be enclosed in quotations marks.

alt text here…

The Summary field should give the reader a high-level overview of the Walkthrough’s Contents. Keep in mind that part of the summary will be used on your walkthrough’s thumbnail on the Browse page. It may even be featured on the front page of BimlScript.com. You may wish to fill this field in once you have finished writing the walkthrough.

alt text here…

Select all the Topics related to your walkthrough. You should always select at least one Topic.

alt text here…

Fill in the Content Field.

alt text here…

You will notice that BimlScript.com uses a markdown editor for a Walkthrough’s main Content area. I’ll provide a brief description of markdown features here. A full description of available markdown features can be found in the Markdown Syntax Guide.

The content editor provides buttons to automatically insert the most commonly used Markdown syntax features.

alt text here…

Clicking one of those buttons will generate the necessary markdown to get the formatting that you want. The cursor will be put in the correct place. If you click one of these buttons while you have text highlighted in the Content area, then the text will be surrounded with the correct markdown tags.

At the top of the page, you’ll notice that there is an area for uploading photos. To upload a photo, simply drag and drop your photo(s) onto the upload button, or click the upload button to open a file dialog box.

alt text here…

The selected images will immediately begin uploading.

alt text here…

You can cancel the upload if you wish. Once the photos finish uploading, they will appear in a photo slide show area.

alt text here…

You can navigate through the photos by either clicking the Prev and Next buttons, or you can simply click the image to advance to the next photo. Click the Paste button to place the markdown image tag into the Content text area.

alt text here…

The content editor will automatically insert the markdown text to display the image in your walkthrough. Feel free to change the alternative and title text. Use the Code button to put in BimlScript code snippets. The best way to do this is to write all the necessary code, and then highlight the entire thing, and then click the button. It should look like the following when you’re done.

alt text here…

Once the walkthrough is created, the Biml code will look like this.

alt text here…

Once you are finished creating your walkthrough, you can click the Preview button to view your Walkthrough without publishing it. Alternatively, you can click the Publish button to make it immediately available for the world to see. Remember, you can always edit your walkthroughs or unpublish them.

alt text here…

You are not authorized to comment. A verification email has been sent to your email address. Please verify your account.

Comments

There are no comments yet.