August 4, 2007
This is the first in a series of introductory articles intended to help new contributors become familiar with the Users’ Knowledge Base (UKB) publishing procedures, so that they can quickly move to productive endeavors.
Posts intended for the main body of the UKB need to be written in Hypertext Markup Language (HTML), although contributions can also be made in other ways e.g. by attaching a word processing document to a post.
WordPress, the software behind the UKB, contains a built-in, albeit limited, editor that allows authors to enter their posts ‘online’. This provides, arguably, the quickest and simplest way to write and publish articles. Advanced programmers will have no trouble understanding, using, and extending the capabilities of the WordPress editor. On the other hand, those who are new to programming can quickly learn how to enter basic posts, via WordPress, using the examples provided in this ‘series’.
Note: It is possible to ‘publish’ without the need to learn HTML or other programming languages.
Third party editors can also be used. Authors with an IT, or programming background, will be familiar with third party editors. Authors, with the experience, can use their favorite editing programs to publish to the UKB by pasting code from them into the WordPress editor. At the other end of the scale, most people would be familiar with Notepad, or programs like it, that can be classed as simple third party or text editors. Posts can be written ‘offline’, using text editors, and copy/pasted into the WordPress editor at a later date.
The advantage of third party editors, in general, is that they offer a range of features that make code writing easier and faster for programmers e.g. syntax highlighting, auto-correction or completion of commonly used terms, find and replace ‘text’ etc. Other editors provide authors with a visual writing mode, that facilitates the creation of graphical and interactive web pages in a ‘What You See Is What You Get’ (WYSIWYG) environment.
The UKB is far from a fully featured web-site. It belongs to a special class of web-sites known as Web-logs or Blogs. As a rule of thumb, Blogs have a limited scope compared to a ‘web-site’. In general this reduces the need for their creators, or contributors to the Blog, to learn advanced programming skills. This maxim holds true for the UKB. In addition to that, because the UKB is a Knowledge Base, the emphasis has been placed on content rather than format. Because of the ‘restricted’ nature of the site, advanced editors, are a level above what is required to publish to the UKB.
A special class of third party editors, known as Blog Editors (Weblog Clients), provides software that is suitable for UKB authors who prefer a visual ‘writing’ medium . They are designed to synchronize with popular blogging software, in this case WordPress.
Features of Blog Editors (in general):
- save drafts offline and publish at leisure
- visual editing
- additional formatting options compared to the WordPress editor
- insert and format images using graphical tools
- graphically insert and manage links
- automatic synchronization to the WordPress format
- automatic login to the UKB Administration Center
- bulk uploading of image files (automatic)
- downloading of published posts
- HTML view, including editing capabilities
- offline web preview
Depending on the software used, there are additional features that can be useful to authors:
- copy and paste rich text formats as plain text (suitable for publishing to the UKB)
- copy and paste word documents, including images, directly into the editor
- maintain offline backups
- bulk uploading of file attachments
- save copies as portable HTML files (with contained images)
- insert and format tables
- insertion of custom HTML snippets
- automatic appending of titles to uploaded files
Unfortunately all of those features don’t come in one single software package.
Note: The author of this article has successfully posted to the UKB using BlogDesk, Post2Blog (ByteScout) and Windows Live Writer (Microsoft) as well as the WordPress Code Editor.
CAUTION – AUTHORS WHO ARE GOING TO USE BLOG EDITORS NEED TO BE AWARE OF THE FOLLOWING CAVEATS:
- As a rule of thumb, they are incompatible with the WordPress Visual Editor (the WordPress Visual Editor should be turned off).
- Code written in the WordPress Code Editor might not be compatible with Blog Editors and will not necessarily download correctly into them.
- Code written in some Blog Editors uses different HTML ‘formats’ to the WordPress Code Editor, especially with regard to paragraphs and line breaks (use either a Blog Editor or the WordPress Code Editor; not both).
- Blog Editors can produce code that is not compatible with other Blog Editors (do not mix and match Blog Editors).
- Some Blog Editors provide rich text formatting as an option. This is in conflict with UKB defaults and may introduce unwanted behavior to the UKB server. DO NOT use rich text formatting features.
- Some Blog Editors capture web-pages, or parts of a web-page, for transmission to a Blog site (DO NOT capture or copy and paste any ‘pages’ that contain, or might contain, HTML code as it may introduce unwanted behavior to the UKB server).
Note: All of the Blog Editors tested by the author of this post, have produced ‘exceptions to the rules’ that had to be managed without support (novices should limit Blog editing to the basics and heed the cautions in this post).
- TURN OFF THE WORDPRESS VISUAL EDITOR.
- USE ONE BLOG EDITOR AT A TIME.
- USE A BLOG EDITOR 100% OF THE TIME OR USE THE WORDPRESS CODE EDITOR 100% OF THE TIME.
- LEAVE OUT THE FANCY STUFF (SORRY, I KNOW ITS NOT AS MUCH FUN BUT IT WILL SAVE A LOT OF HEADACHES IF WE KEEP IT SIMPLE_SALLY OR SAM).
Tutorials, covering all of the core skills required to achieve basic competency as a UKB Author, and articles on a variety of publishing topics can be found at: AmiBroker Users’ Knowledge Base >> Contributors
For additional information and links to publishing resources refer to: Wikipedia >> HTML Editor
Please read on!
Note: The posts contained in the Contributors category only cover ‘publishing’ basics, with a limited range of publishing software and utilities provided as examples. Like everything ‘IT’, the programs and procedures are subject to rapid redundancy. They will be maintained into the future, to the best of the ability of the volunteers who ‘help’ out at the site. Visitors to the site are invited to help correct errors, or omissions, and suggest improvements, or alternative ways of going about it, by adding comments to the posts. Where enough new information comes to light, to warrant an extension or a separate article, please become an author and post to the site or email one-off articles to support [at] amibroker.com for uploading to the UKB. Ditto for specialist topics beyond the ken of the average person, or if you are ‘hot to trot’ on a particular topic or program. This will help the authors, and the editor, in their efforts to maintain this as a dynamic site.
Link to a free ‘text’ editor with HTML capabilities (‘NotePad on steroids’): Fookes software >> NoteTab Editors >> NoteTab Light
- Link to information on using WordPress with Weblog Clients (includes a list of links to client software): WordPress >> Weblog Clients
- Link to a donation-ware Blog Editor, compatible with WordPress ,by German developer Johannes Oppermann: BlogDesk.org >> BlogDesk
- Link to a freeware Blog Editor compatible with WordPress: ByteScout Software >> Post2Blog
- Link to a free Blog Editor compatible with WordPress: MicroSoft >> Windows Live Writer
- Link to a commercial Blog Editor compatible with WordPress: Coding Robots >> BlogJet
- Link to a commercial Blog Editor compatible with WordPress: Anconia Inc >> RocketPost
- Version 1 – Aug 04/2007 – by Brian_z – written using Windows Live Writer beta 1
- Version 2 – Aug 13/2007 – by Brian_z – draft rewritten and links section added