{% load staticfiles %}

{# Load assets as external files, to cache independently of markup. #}
{% comment %}
FAQ: IF a script or style is better cached with markup, THEN:
  - Such a style belongs inline before relevant markup, not via this block
  - Such a script belongs inline after relevant markup, not via this block
{% endcomment %}

{# NOTE: Fonts may be loaded early via `assets_font` #}



<!-- Custom Site Assets: Favicon. -->
{% with settings.FAVICON as favicon %}
<link rel="icon" href="{% static favicon.img_file_src %}" type="image/x-icon" />
{% endwith %}



{# Do NOT directly load project-specific assets here; see `/taccsite_custom` #}

{# Example #}
{% comment %}
  {% block assets_custom %}
    {{ block.super }}

    {# Example: Custom Site Assets. #}
    <link rel="stylesheet" href="{% static '__PROJECT__/css/build/site.css' %}">
    <script src="{% static '__PROJECT__/js/site.js' %}"></script>

    {# Example: Custom Template-Specific Assets. #}
    <link rel="stylesheet" href="{% static '__PROJECT__/css/build/template.___.css' %}">
    <script src="{% static '__PROJECT__/js/template.___.js' %}"></script>

    {# Example: Page-Specific Assets. #}
    {# WARNING: Undesired use case. Create re-usable code instead. #}
    {# SEE: https://confluence.tacc.utexas.edu/x/54AZCg #}

  {% endblock assets_custom %}
{% endcomment %}
