Skip to main content

A 'include_strip' templatetag for django to strip trailing and leading spaces/newlines

Project description

# django-include-strip-tag

A new “include_strip” template tag for Django

## Introduction

This new templatetag, include_strip, works exactly the same as the default include template tag provided by Django.

The only difference is that the strip method is applied to the result, to remove leading and trailing spaces.

The aim is to remove the unwanted space added in text when including a template that just return some text.

## Installation

django-include-strip-tag is available on Pypi:

` pip install django-include-strip-tag `

Or you can find it on github:

When installed, just add include_strip_tag to your INSTALLED_APPS in the file of your django project.

## Usage

Simply add the tags library in your template, and use include_strip instead of include when needed:

`django {% load include_strip %} Hello {% include_strip "user.html %}, how are you today ? `

## Why ?

Considering the “user.html” template:

`django SomeUserName `

In the previous template (in “Usage”), without this new templatetag, the result would be:

` Hello SomeUSerName , how are you today ? `

With include_strip, we have:

` Hello SomeUSerName, how are you today ? `

Notice the difference between the username and the coma… It’s because the newline at the end of the included template is kept when the result is added to the parent template.

So the include_strip apply the strip method (on the result, which is a string) to remove it.

It can also help if your included template starts with a line dedicated to load tags libraries :

`django {% load somelibrary %} add-something-here `

With the first line having no content rendered, but include a newline, we have this newline in the final template

## License

django-include-strip-tag is published under the MIT License (see the LICENSE file)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-include-strip-tag, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size django-include-strip-tag-0.1.0.tar.gz (3.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page