Registering a Custom DasBlog Theme#

In a WordPress world, I went with DasBlog. My choice was purely based on language needs – I have a Windows/.NET based website. I needed a blogging platform that seamlessly integrated with it. Enter DasBlog.

My one concern with DasBlog was the limited amount of themes. It was essential that my blog be similar to my Written Designs website and have a professional look-and-feel. On the DasBlog website there are only had handful of themes to choose from. However, the instructions for customizing a theme were readily available. After looking through the themes, I found elements from a couple I liked. Sweet – with these instructions, I’ll be able to create my custom theme in no time!

Well, no time turned into days (a phenomenon many developers are familiar with). While I figured out how to modify the homeTemplate, dayTemplate, and itemTemplate as well as each CSS sheet with ease, I could not figure out how to register my custom theme. The code that the DasBlog site says is in the web.config file is not there. (Grrr!) After doing a few Google searches, I discovered other people had similar issues with customization. “Well, ok,” I thought, “I'll just work around it.”

For the time being I settled with simply overwriting an existing theme to bypass not being able to add my own. The following day, on a whim, I started looking through the code in some of the other theme files. Low and behold, I discovered the problem!

Instead of the registry code being in the web.config file, it is contained within theme.manifest file within each theme folder. While this is noted on the customization page, the explanation is simply that the new version (1.9) now utilizes these new theme manifests. Scrolling down the page, you still find instructions for adding this info to the web.config file. Hmmm, so how does it really work then?

Once you update your specific theme manifest, the code gets referenced from the site.config file. Ta-da you have your theme registered! After thoroughly reading through each page on customizations on the DasBlog site, I found that this information is included, but it takes some looking (you have to read - not skim). So here’s a quick reference to register your new DasBlog theme (for those who are skimmers like me):

  1. Copy an existing theme folder down from your ftp server. Or create each file needed for your new theme.
  2. Copy the site.config file from your ftp server.
  3. Open the theme.manifest file. Update the theme name, title, templatedirectory, and imagedirectory items. Save the file.
  4. Open the site.config file. Update the Theme to the theme name indicated in the theme.manifest file. Save the file.
  5. Upload your new theme folder and the site.config file back to the live ftp server.

Presto! You’ve got your own DasBlog theme registered and ready to use. Now it’s time to start blogging. Go Write Now!

Friday, May 15, 2009 8:54:02 AM (Central Standard Time, UTC-06:00) #    Comments [1]  | 

 

Discovering Your Product's Voice#

Writers often hear about “discovering your voice” when writing fiction. After all, the challenge of fiction writers is to craft a story that is compelling, interesting, and dynamic. Your characters must be likable; your readers must be able to relate to them or else they will simply set your story aside for something more interesting. The voice in fiction is often your character’s or narrator’s voice. It is that voice, the tone, the choice of words, how those words are arranged into sentences, that convey the deeper nuances within good fiction.

I am an avid reader. I revel in delightful, compelling fiction yet my attention can be equally captured by the solid, thought-provoking prose in a non-fiction novel. Good non-fiction has a compelling voice else there would be very few of us who continued to buy non-fiction.

Enter technical writing. Technical writing is non-fiction writing, yet many people (both companies and consumers alike) treat their technical documentation as an afterthought -“We have to document our product because we need to offer online help, user guides, etc. But we know our customers rarely use them.” Why is it that customer’s shy away from the technical documentation offered with products and services?

I think it comes down to voice. Let’s face it, most technical documents are boring. We, as technical writers, try to spice things up, but there are only so many ways you can say “Now, click Next.” Too often, companies are in a rush to get their documentation out with their products. This causes writers to rush – they do their best at getting the information down on paper but have little time to consider the voice of the whole publication. They’re just happy when they meet the ever looming deadline. The documentation gets out, hardly ever gets read, and customer service continues to receive the same types of calls in spite of those issues being thoroughly documented.

Now imagine how things might change if the application or service suddenly became a character. You’d still explain all the technical details about your product. You’d still include all the screen shots, tables and instructions, but the tone would be different. Your product would become the main character and, as such, it would have a distinctive voice. Maybe the voice is more familiar and includes current technology slang if your audience is of a younger generation. Perhaps the voice is more formal, but concise and friendly, for a corporate business audience. Either way, the product takes on its own persona. Your writers have the ability to include more details, tidbit, and side bars about how the application works, its quirks, and, ultimately, its power. The documentation becomes an extension of the product itself instead of simply an afterthought.

Once the documentation becomes an integral part of your product, you’ve opened up a whole new realm of possibilities. High-quality, comprehensive documentation, tutorials, and training materials can then become revenue-generating tools that could set you apart in your industry. Your documentation becomes an integral part of your business, driving sales and providing actual ROI to both you and your clients. Your customer service related calls are reduced. Your clients have more successful implementations and adoptions of your products. In short, you’ve reduced overhead while boosting sales – all because you discovered your product’s voice.

Thursday, May 14, 2009 10:39:04 AM (Central Standard Time, UTC-06:00) #    Comments [0]  | 

 

Write Now is about Communication#

Getting Write Now up and running has been on my white board task list for months! I'm pleased to say, however, that it's done and I'm finally getting to write my first post.

So what's Write Now all about, you ask?

First and foremost, Write Now is a reminder to me to write... now... about the things I'm interested in and passionate about. I spend a lot of time writing for clients, and I absolutely love learning about their technology, products and services. In many ways, it's because of client projects that I have such a diverse set of interests.

Yet, as many professional writers know, when you write for a living, you often don't write for yourself. Write Now is my opportunity to share my thoughts, research, readings, and tidbits with you - my clients, friends and colleagues. I'm seeking to explore and start discussions about trends and topics relating to technical communication, instructional design, and organizational learning and development.

In short, Write Now is about all things related to communication. Are you ready to start reading? Great - let's get started write now!

Wednesday, May 13, 2009 3:53:07 PM (Central Standard Time, UTC-06:00) #    Comments [0]  | 

 

All content © 2010, Libby Craver dba Written Designs
On this Page
Calendar
<May 2009>
SunMonTueWedThuFriSat
262728293012
3456789
10111213141516
17181920212223
24252627282930
31123456
Archives
Topic Categories
This Site
Disclaimer

Powered by: newtelligence dasBlog 2.1.8102.813

The opinions expressed herein are my own personal opinions.

Send mail to the author(s) E-mail

Theme by Libby Craver (Based on Essence theme by Jelle Druyts)

Sign In