Ist es eine idiomatische Datei-Erweiterung für Jinja-templates?

Muss ich programmatisch unterscheiden zwischen Jinja template-Dateien, die anderen template-Dateien (z.B. ERB), und template-weniger-nur-text-Dateien.

Laut Jinja-Dokumentation:

Einer Jinja template braucht nicht auf eine bestimmte extension: .html -, .xml, oder eine andere Erweiterung ist auch gut so.

Aber was sollte ich verwenden, wenn eine ausdrückliche Erweiterung ist erforderlich? .py ist irreführend, und alle suchen, in denen die Wörter "jinja" und "Erweiterung" sind schlecht searchwashed durch die Diskussion um Jinja-Erweiterungen.

Konnte ich problemlos diktieren eine Projektweite Konvention (.jnj oder .ja in den Sinn kommen), aber dies ist für open source, so dass ich nicht wollen, gegen den trend, wenn es bereits etablierte Praxis, irgendwo.

EDIT 1: Wieder, ich verstehe, dass die Jinja Projekt — absichtlich — nicht definiert ein Standard-Datei-Erweiterung. Ich bin zu Fragen, ob es irgendwelche inoffizielle Konventionen herausgebildet haben, für die Umstände, in denen eine gewünscht ist einige Projekt-spezifischen Grund.

EDIT 2: Klarstellung: Das ist nicht für HTML-Inhalt.

  • Seite Hinweis für andere, die gefunden wurden diese während der Suche im Kontext von HTML: eine Sache, vorsichtig zu sein über ist, dass Datei-Erweiterungen Folgen so weit als HTML-autoescapes betroffen sind. Wenn Sie be-Makros für die Verwendung in einer HTML-Vorlage, {% import "whatever.html" as foo %} fungieren, wenig überraschend, während {% import "whatever.jinja" as foo %} führen autoescapes wie > immer >. Ich vermute, das ist ein Teil, warum eine Menge von Django und Flask Benutzer am Ende mit .html.
InformationsquelleAutor Chris Tonkinson | 2015-04-12
  1. 11

    Jinja Autoren nicht definiert eine Standard-Erweiterung. Die meisten von Jinja template-Editoren wie Vim-Erweiterung, TextMate-Erweiterung, Emacs-Erweiterung, und PyCharm schweigen keine Standard-Erweiterung zu erzwingen, Jinja hervorheben.

    Django hatte schon eine ähnliche Debatte über die Einstellung des Standard-Erweiterung, und endete als wontfix Problem. Ich zitiere aus der Nachricht schließen:

    Filetype-Erkennung basiert auf der extension ist fehlerhaft für die sehr gut beschriebenen Gründen in diese Kommentare, so dass Sie zu tun haben, einige interne Inspektion, genau wie die MIME-Typ-Erkennung funktioniert.

    Schlage ich vor, dass, sollten Sie Ihre eigenen da es ist kein gewöhnlicher.

    • Du hast Recht, ich kenne Sie nicht, definieren Sie einen Standard - (und diese Entscheidung wurde mit Sorgfalt und überlegung) aber mein Projekt erfordert eine explizite Erweiterung - Frage ich mich, wenn es irgendwelche inoffizielle Konventionen herausgebildet (vorher einfach die Wahl eines willkürlich).
    • soweit ich weiß, gibt es eine. Persönlich benutze ich html.
    • wenn es dort eine gemeinsame extension-Entwickler neigen dazu, Sie zu implementieren, in der Redaktion, da die meisten Editoren entwickelt von community
    • Ich bin nicht an einem web-Projekt. Selbst wenn ich war, html wäre nicht angemessen, so wieder, es unterscheidet nicht zwischen einer HTML-Datei mit Jinja, und einen ohne (das ist, was ich tun muss).
    • also ich schlage vor, verwenden Sie Ihre eigenen da es ist kein gewöhnlicher.
    • Ich benutze .jinja2, haha.
    • gute Wahl

    InformationsquelleAutor BigOther
  2. 31

    Ansible nutzt die .j2 Erweiterung.

    Konnte ich nicht finden eine definitive Dokumentation über diesem genauen Punkt, aber wir sehen Ereignisse des .j2 Erweiterung in vielen Orten von Ihrer Dokumentation :

    Wenn Sie sich für .j2 auf den folgenden Seiten sehen Sie viele Vorkommnisse :

    http://docs.ansible.com/ansible/template_module.html
    http://docs.ansible.com/ansible/playbooks_intro.html

    Dies ist die Konvention, die ich für andere Projekte auch, außer django Vorlagen.

    • Sublime Text Benutzer kann daran interessiert sein, zu erfahren, dass er erkennt .j2-Erweiterung, und können zum Beispiel erkennen, dass *.html-Code.j2 ist eine HTML-jinja template. Sehr cool.
    • Ich benutze die andere Weise Runde wie template.j2.html. So könnte es sein, syntax hervorgehoben, indem alle Redakteure, aber trotzdem markiert es als Vorlage.
    InformationsquelleAutor Johnride
  3. 9

    Nur zur info - Johnride oben erwähnt, über Ansible Verwendung von .j2 als die Konvention für die template-Datei, die korrekt ist, nur darauf aus die "best practices" dokumentiert Sie habe nun aus, die erwähnt:

    Vorlagen Ende in .j2

    InformationsquelleAutor rd2
  4. 5

    IntelliJ ist PyCharm verwendet .jinja2 als Ihre Muster zu erkennen, Jinja2 Vorlagen. Aus diesem Grund verwende ich die gleichen (und zu empfehlen, andere tun dies auch)

    Ist es eine idiomatische Datei-Erweiterung für Jinja-templates?

    • Ich sehe nicht, "Jinja 2-Vorlage" oder"*.jinja2 in meiner Liste der Dateitypen. Ich bin mit 2018.3 Community Edition mit sehr wenigen Erweiterungen/plugins. EDIT: ich Wette, das ist spezifisch auf die Professional Edition: jetbrains.com/help/pycharm/configuring-template-languages.html
    • Möglicherweise, ja. Ich habe die professional edition.
    InformationsquelleAutor Miguel
  5. 4

    Benutze ich .html.jinja2, .js.jinja2, .css.jinja2 etc zu zeigen, dass (a) es ist ein Jinja2 template, und (b) wird die Kompilierung in eine HTML -, JS-oder CSS-Datei. Ich mag die .j2 Wahl in Ansible, aber IMO mit .jinja2 macht es einfacher für einen neuen Beitrag zu erraten, was als Template-Sprache verwendet wird.

    Für Kolben-Nutzer, da auto-escaping ist schön zu haben:

    def _select_jinja_autoescape(filename):
    """
    Returns `True` if autoescaping should be active for the given template name.
    """
    if filename is None:
        return False
    return filename.endswith(('.html', '.htm', '.xml', '.xhtml',
        '.html.jinja', '.html.jinja2', '.xml.jinja', '.xml.jinja2',
        '.xhtml.jinja', '.xhtml.jinja2'))

app.jinja_env.autoescape = _select_jinja_autoescape
    InformationsquelleAutor Kiran Jonnalagadda
  6. 2

    Ich verwenden .jnj-Erweiterung - und für syntax-Hervorhebung und für snippets in vim, die ich nur kopiert, umbenannt und optimiert die Einstellungen für Zweig.

    Wenn ich einige Einstellungen für html (wie kommentieren, tag-balancing, Einrückungen etc) in jinja template, ich habe auch eine Funktion legen Sie eine Zeit für die Arbeit mit PHP-und WordPress - es schaltet auf html und zurück zum vorherigen filetype:

    let g:my_file_type = 0

function! ToggleFileType()
  if g:my_file_type == 0
      set ft=html
      let g:my_file_type = 1
  else
      filetype detect
      let g:my_file_type = 0
  endif
endfunction

    Und es gebunden ist, die F12-Taste mit nmap <silent> <F12> :call ToggleFileType()<CR>

    InformationsquelleAutor elemel21
Schreibe einen Kommentar