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: https://github.com/twidi/django-include-strip-tag

When installed, just add include_strip_tag to your INSTALLED_APPS in the settings.py 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.

Source Distribution

django-include-strip-tag-0.1.0.tar.gz (3.6 kB view details)

Uploaded Source

File details

Details for the file django-include-strip-tag-0.1.0.tar.gz.

File metadata

File hashes

Hashes for django-include-strip-tag-0.1.0.tar.gz
Algorithm Hash digest
SHA256 b2fd04428277f675f7205773e6792f529af0cedb23bcf4fb67f42268147de50a
MD5 c2a8175e0ece5d736509f7717957f1fe
BLAKE2b-256 16182a76285ade12775dfa1584947103f5cd338c17418d319cb2e9d4ddd5d97b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page