=============== Troubleshooting

I created a cookiecutter, but it doesn't work, and I can't figure out why

Try upgrading to Cookiecutter 0.8.0, which prints better error messages and has fixes for several common bugs.

I'm having trouble generating Jinja templates from Jinja templates

Make sure you escape things properly, like this::

{{ "{{" }}

Or this::

{% raw %}
<p>Go <a href="{{ url_for('home') }}">Home</a></p>
{% endraw %}

Or this::

{{ {{ url_for('home') }} }}

See https://jinja.palletsprojects.com/en/latest/templates/#escaping for more info.

You can also use the _copy_without_render_ key in your cookiecutter.json file to escape entire files and directories.

.. __copy_without_render: http://cookiecutter.readthedocs.io/en/latest/advanced/copy_without_render.html

Other common issues

TODO: add a bunch of common new user issues here.

This document is incomplete. If you have knowledge that could help other users, adding a section or filing an issue with details would be greatly appreciated.