Home The Basics How to publish a tutorial
How to publish a tutorial

Last update:  12-31-1969

Submitted by Leah

Writing and publishing a tutorial using RetouchPro's tutorial publishing system.

This tutorial is Copyright © Leah, who has sole responsiblity for its content.
Have a question for the author? Or simply want to discuss this topic further? Click "Discuss" up at the top. If you'd like to publish a tutorial of your own, simply click on "Publish" over on the menubar.

 

Overall Recommendation

Fairly

Rating
 

5

 

Expertise     5.6
Utility     4.8
Clarity     4.2
Relevance   5.5

How to publish a tutorial on RetouchPro

NOTE: Some browsers (it's been reported with Firefox, but probably applies to some others too) will have difficulty with uploading images. If that happens to you and you don't have or don't want to use IE, I suggest you work through these instructions to Step 8, then jump to Step 17 and work through saving and publishing the tutorial. Then drop me a PM or email and I'll upload the photos for you and put them in the right places.

1. Work through the example you're planning to use, taking screenshots and versions of your image as you go.

As you save your screenshots/images, keep an eye on the image dimensions (does this feature/image need to be shown at full size?) and file sizes (can you increase the compression on this image without damaging the tutorial as a whole?) -- try not to make the overall tutorial size too big to download easily. As a tip, screenshots of individual Photoshop palettes are generally best saved as GIFs and working versions of the image as JPEGs of between 20 and 50% quality -- but there are always exceptions.

It's a good idea to save all the image files for your tutorial in one folder where you can find them easily, and to name them using a convention that will make it easy for you to remember which file is which.

2. Either as you work (recommended), or afterwards, make a note of the steps you follow in a plain text editor such as Notepad.

It's a good idea to make a note in the text where you intend to include a screenshot or other image -- specify the file name or number. This will help you place the images more easily when you start creating the tutorial online.

3. From the RetouchPro site, click on the "Tutorials" option on the menu (where this is depends on where you are on the site).


4. From the tutorials front page, click on the "Publish" link in the fly-out menu on the left hand side of the screen.

5. You'll get a page of terms and conditions. Read them through and (if you agree with them) click on the "Click here if you have read this and agree to the terms and conditions" link at the bottom of the page.

6. Fill in the tutorial title and description and select the appropriate Tutorial Category (this is important because it's the only thing you can't change later).

7. Copy and paste the text of your tutorial from your text editor into the main tutorial editing window.

8. Adjust the formatting to taste using the buttons in the toolbar at the top of the editing window.

9. Now to upload your images... click on the "Insert Image" button in the toolbar at the top of the editing window.

10. In the "Insert Image" popup window, click on the "Multiple Upload" tab.

11. For each file you want to upload, click on one of the "Browse" buttons and navigate to the file on your local hard drive. You can upload up to nine images at once. Once you have specified them all, click on the "Upload Now" button. There will be a pause (depending on your connection speed) while the files are uploaded. You may get some error messages displayed for any GIF files, but they don't appear to affect the final result.

12. You will be returned to the Image Insert tab of the Insert Image popup window, which will list all the files you have uploaded. If you have more files to upload, repeat steps 10 and 11 until they are all uploaded. When you are done, close the Insert Image popup window.

13. Now to insert the images in the correct places in your tutorial... In the editing window, place your cursor where you want to insert an image, and then click on the "Insert Image" button in the toolbar at the top of the editing window.

14. You will be brought to the "Image Insert" tab of the "Insert Image" popup window. In the list of files on the lefthand side of the window, identify the image you want to insert. Click on the small "INSERT" button under the "Options" heading just to the right of the filename. A preview of the image (distorted to fit the preview pane) will appear on the right-hand side of the window. This allows you to check that it is the image you wanted. If you wish, you can alter the alignment, border, etc. When you are sure you have the right image and the settings you want, click on the main "Insert" button just above the preview pane.

15. You will now be returned to the main editing window with the image inserted where the cursor was.

16. Repeat steps 13-15 for each image you want to insert.

17. If you are confident with HTML and know what you are doing , then you can access the HTML source for the tutorial directly by clicking on the "Toggle HTML Source" button in the toolbar at the top of the editing window. But beware -- this is where it is easiest to mess up the tutorial, so approach with extreme caution.

18. Once everything is done, click on the "Publish this article" button. You will see a message telling you that your article has been submitted successfully, and then will be automatically transferred to the page for the tutorial you have just created.

19. Have a look through the tutorial. You may identify formatting quirks or other issues that you want to change. Here, for example, the alignment of the text and images is not ideal.

20. If you want to make changes, click on the "Edit" link at the top of the screen. That will return you to the tutorial editing screen, where you can make any changes required and then click on the "Publish this article" button to commit your changes. Here I've put in an extra carriage return before each image, which has fixed the formatting problems.

Now you have published your first tutorial -- congratulations! Let's hope it's the first of many.

You can always go back and update or refine your tutorial in response to the queries or comments of other forum members.