old_contents: #
  # Django Gems.
  #
  # Copyright (C) 2012 Pier Luigi Fiorini
  #
  # Author(s):
  #   Pier Luigi Fiorini <pierluigi.fiorini@gmail.com>
  #
  # Redistribution and use in source and binary forms, with or without
  # modification, are permitted provided that the following conditions are met:
  #
  #	1. Redistributions of source code must retain the above copyright notice,
  #	   this list of conditions and the following disclaimer.
  #
  #	2. Redistributions in binary form must reproduce the above copyright
  #	   notice, this list of conditions and the following disclaimer in the
  #	   documentation and/or other materials provided with the distribution.
  #
  #	3. Neither the name of the project nor the names of its contributors may
  #	   be used to endorse or promote products derived from this software
  #	   without specific prior written permission.
  #
  # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
  # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  # POSSIBILITY OF SUCH DAMAGE.
  #
  
  from django import template
  
  register = template.Library()
  
  #
  # Safe string formatting that can also be used in translations.
  #
  # For example instead of writing:
  # {% blocktrans with sum=object.sum %}
  # It consts <a href="http://www.mysite.com/offer">{{ sum }}</a> dollars.
  # {% endblocktrans %}
  #
  # one can write:
  #
  # {% blocktrans with sum2="<a href='http://www.mysite.com/offer'>{0}</a>"|safewrap:sum %}
  # It costs {{ sum2 }} dollars.
  # {% endblocktrans %}
  #
  # In the .po file you will have:
  #
  # It costs %(sum2)s dollars.
  #
  @register.filter(name="safewrap")
  def safewrap(val, arg):
  	return val.format(*arg.split(','))
  safewrap.is_safe = True
  
new_contents: #
  # Django Gems.
  #
  # Copyright (C) 2012 Pier Luigi Fiorini
  #
  # Author(s):
  #   Pier Luigi Fiorini <pierluigi.fiorini@gmail.com>
  #
  # Redistribution and use in source and binary forms, with or without
  # modification, are permitted provided that the following conditions are met:
  #
  #	1. Redistributions of source code must retain the above copyright notice,
  #	   this list of conditions and the following disclaimer.
  #
  #	2. Redistributions in binary form must reproduce the above copyright
  #	   notice, this list of conditions and the following disclaimer in the
  #	   documentation and/or other materials provided with the distribution.
  #
  #	3. Neither the name of the project nor the names of its contributors may
  #	   be used to endorse or promote products derived from this software
  #	   without specific prior written permission.
  #
  # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
  # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  # POSSIBILITY OF SUCH DAMAGE.
  #
  
  #
  # From here:
  #   http://stackoverflow.com/questions/9136131/django-localization-how-to-make-po-file-without-html
  #
  
  from django import template
  
  register = template.Library()
  
  #
  # Safe string formatting that can also be used in translations.
  #
  # For example instead of writing:
  # {% blocktrans with sum=object.sum %}
  # It consts <a href="http://www.mysite.com/offer">{{ sum }}</a> dollars.
  # {% endblocktrans %}
  #
  # one can write:
  #
  # {% blocktrans with sum2="<a href='http://www.mysite.com/offer'>{0}</a>"|safewrap:sum %}
  # It costs {{ sum2 }} dollars.
  # {% endblocktrans %}
  #
  # In the .po file you will have:
  #
  # It costs %(sum2)s dollars.
  #
  @register.filter(name="safewrap")
  def safewrap(val, arg):
  	return val.format(*arg.split(','))
  safewrap.is_safe = True
  
subject: Add a note for safewrap.