Archive for the ‘Features’ Category

Tutorial: How can I enable comments to my site?

Thursday, October 29th, 2009

That’s actually a trick question. Comments are already enabled but you need to add a few things to your templates to display the comments and form.

You can do this many ways but these are the steps we recommend.
1) Add a template called ‘Comments’. This will be for displaying existing comments and displaying the form to leave a new one
2) Add a template called ‘Comment’. This will be for displaying an individual comment
3) Add a template called ‘New Comment’. This is the form for leaving a new comment
4) In your article template, include the new ‘Comments’
There’s sample code for each step at the end of this post.
But first, a few technical details. (more…)

Template Data – Part 7: Linking

Thursday, October 29th, 2009

This post will focus on a key task you’ll encounter while working with any website: linking. To make linking as easy as possible, Hot Ink provides a series of Liquid filters that will build links to any Hot Ink page. Hot Ink linking helpers will automatically decide which text to use as the link text unless you’ve provided specific text as an argument. (more…)

Template Data – Part 4: The Issue Drop

Thursday, October 29th, 2009

Issues represent the printed editions of your newspaper. You aren’t obligated to use issues to organize your content, but it does help readers navigate your site, especially those who are looking for an article that appeared in a certain issue of your newspaper. Issues are special; they can have an attached PDF.

Issue are generally accessed through the newspaper.latest_issues array, newspaper.latest_issue or through the “issues” array on an issues index page template.
(more…)

Template Data – Part 3: The Newspaper Drop

Thursday, October 29th, 2009

Of all the data you’ll use to build Hot Ink templates, probably the most important is the data associated with your newspaper itself. The “newspaper drop” is available and contains the same data on all templates and no matter what the context.

To learn more about Liquid, the templating language used by Hot Ink, read the Liquid wiki at http://wiki.github.com/tobi/liquid

Your newspaper’s drop is the main piece of data used for building your template’s structure. If you’re interested in fleshing out your template with a little more data, be sure to take a good look at what’s inside this drop. We’re still adding new features to the site, so look forward to this drop expanding significantly over the next few month.
(more…)

Template Data – Part 1: The Article Drop

Thursday, October 29th, 2009

When working with Liquid, the Hot Ink templating system, each type of object (like an article, a mediafile, an issue or even your newspaper itself) has data associated with it that’s available for use in your templates. Which piece of data is available depends on which template your working in, but perhaps the simplest case is a Hot Ink article page template. On each article template there’s a variable called “article” representing the article requested by the user.

(more…)