How do I create pagination links for my entry index page?

Question

So I may be somewhat obtuse here, but I’m trying to discern what I might be doing wrong in this instance. I’m attempting to use a {% paginate %} tag inside my craft.entries loop to return a simple next/previous set of pagination links. I have ensured I have two entries already, so I should be seeing the pagination links, correct?

{% for entry in craft.entries.section('houseRules').limit(1) %}
    <div class="rule-content">
        <article>
            {# Content is Here #}
        </article>
    </div>
    {% paginate craft.entries as entries %}
        {% if paginate.prevUrl %}<a href="{{ paginate.prevUrl }}">Previous Page</a>{% endif %}
        {% if paginate.nextUrl %}<a href="{{ paginate.nextUrl }}">Next Page</a>{% endif %}
    {% endpaginate %}
{% endfor %}

Answer 1

You have your {% for %} and {% paginate %} tags in the reverse order. You need to wrap the loop and the pagination URLs with the {% paginate %} tag pair:

{% paginate craft.entries.section('houseRules').limit(1) as entries %}

    {% for entry in entries %}
        <div class="rule-content">
            <article>
                {# Content is here #}
            </article>
        </div>
    {% endfor %}

    {% if paginate.prevUrl %}<a href="{{ paginate.prevUrl }}">Previous Page</a>{% endif %}
    {% if paginate.nextUrl %}<a href="{{ paginate.nextUrl }}">Next Page</a>{% endif %}

{% endpaginate %}

Notice how we’re actually looping through entries, rather than a new craft.entries call. That entries variable will be an array of the current page’s entries. All we had to do is define what we wanted that variable to be called (e.g. “entries”).

See http://buildwithcraft.com/docs/templating/tags#paginate for more details on what can be done inside the {% paginate %} tag pair.