This pull request significantly expands and clarifies the documentation for the al-folio Jekyll theme, focusing on improved file structure explanations, enhanced quick reference guides, and the addition of a comprehensive analytics setup guide. The changes make it easier for users and contributors to understand the project organization, available features, and configuration options, especially regarding CV formats, teaching pages, and analytics integration. **Key documentation and structure improvements:** *Expanded file and collection structure:* - The file structure documentation in `.github/agents/customize.agent.md` and `.github/agents/docs.agent.md` now details all major directories, including new and existing collections such as `_books/`, `_teachings/`, `_scripts/`, `_plugins/`, and expanded `assets/` subdirectories. It also covers new configuration and utility files, making it easier for users to locate and understand the purpose of each file or folder. [[1]](diffhunk://#diff-15864f2655921f50a97689076e3b8feba0da320463750845be6a76eb2e30bfe4L24-R66) [[2]](diffhunk://#diff-961a46180ce568ce43c20bf7129dc5e4926a9aa4e0d7bc19926ca5ee3ff95cd0L17-R58) *Documentation and quick reference enhancements:* - The quick reference table in `.github/agents/customize.agent.md` has been updated to include new actions like adding teaching pages, setting up analytics, improving SEO, and ensuring accessibility, with more precise documentation links. - The documentation map now lists all major guides (e.g., `QUICKSTART.md`, `INSTALL.md`, `TROUBLESHOOTING.md`, `ACCESSIBILITY.md`, `ANALYTICS.md`, `SEO.md`), providing a clearer overview of available resources. [[1]](diffhunk://#diff-15864f2655921f50a97689076e3b8feba0da320463750845be6a76eb2e30bfe4L58-R110) [[2]](diffhunk://#diff-961a46180ce568ce43c20bf7129dc5e4926a9aa4e0d7bc19926ca5ee3ff95cd0L17-R58) **Feature and configuration documentation updates:** *CV/resume format guidance:* - The CV documentation now clarifies that users can maintain both RenderCV and JSONResume formats simultaneously, with clear instructions on switching between them and deleting unused files if desired. [[1]](diffhunk://#diff-15864f2655921f50a97689076e3b8feba0da320463750845be6a76eb2e30bfe4L139-R185) [[2]](diffhunk://#diff-52f2a9488bfe4177d1f1d01120859dad0b3e2d087283ded68f72d47b4f183391L291-R291) *Teaching pages and new collections:* - Adds documentation for the new `_teachings/` collection, including required frontmatter and support for course materials, as well as updates to enable/disable teaching and books pages via `_config.yml`. [[1]](diffhunk://#diff-15864f2655921f50a97689076e3b8feba0da320463750845be6a76eb2e30bfe4L180-R252) [[2]](diffhunk://#diff-15864f2655921f50a97689076e3b8feba0da320463750845be6a76eb2e30bfe4L24-R66) *Analytics integration:* - Introduces a new `ANALYTICS.md` guide with detailed setup instructions for Google Analytics, privacy-friendly alternatives (Plausible, Pirsch, Openpanel, GoAccess), GDPR considerations, and a comparison table to help users choose the right analytics provider. - The configuration documentation now references analytics setup and related configuration options. [[1]](diffhunk://#diff-15864f2655921f50a97689076e3b8feba0da320463750845be6a76eb2e30bfe4L180-R252) [[2]](diffhunk://#diff-15864f2655921f50a97689076e3b8feba0da320463750845be6a76eb2e30bfe4L479-R550) These updates collectively make the documentation more comprehensive, actionable, and user-friendly for both new and advanced users. **References:** [[1]](diffhunk://#diff-15864f2655921f50a97689076e3b8feba0da320463750845be6a76eb2e30bfe4L24-R66) [[2]](diffhunk://#diff-15864f2655921f50a97689076e3b8feba0da320463750845be6a76eb2e30bfe4L58-R110) [[3]](diffhunk://#diff-15864f2655921f50a97689076e3b8feba0da320463750845be6a76eb2e30bfe4L139-R185) [[4]](diffhunk://#diff-15864f2655921f50a97689076e3b8feba0da320463750845be6a76eb2e30bfe4L180-R252) [[5]](diffhunk://#diff-15864f2655921f50a97689076e3b8feba0da320463750845be6a76eb2e30bfe4L479-R550) [[6]](diffhunk://#diff-961a46180ce568ce43c20bf7129dc5e4926a9aa4e0d7bc19926ca5ee3ff95cd0L17-R58) [[7]](diffhunk://#diff-0967e840631a541bb95e057e1c6d4884274cf56d5a217d7fee2eb7223b6b4c0dR1-R268) [[8]](diffhunk://#diff-52f2a9488bfe4177d1f1d01120859dad0b3e2d087283ded68f72d47b4f183391L291-R291) --------- Signed-off-by: George Araújo <george.gcac@gmail.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
198 lines
6.0 KiB
Plaintext
198 lines
6.0 KiB
Plaintext
<!-- Metadata, OpenGraph and Schema.org -->
|
|
{% include metadata.liquid %}
|
|
|
|
<!-- Security: Content Security Policy -->
|
|
<!-- Permissive CSP suitable for academic websites. Allows external images, videos, and common embed services. -->
|
|
<!-- To customize for your needs, see: https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP -->
|
|
<meta
|
|
http-equiv="Content-Security-Policy"
|
|
content="default-src 'self'; script-src 'self' 'unsafe-inline' https:; style-src 'self' 'unsafe-inline' https:; img-src 'self' data: https:; font-src 'self' data: https:; media-src 'self' https:; frame-src 'self' https:; connect-src 'self' https:;"
|
|
>
|
|
|
|
<!-- Bootstrap & MDB -->
|
|
<link rel="stylesheet" href="{{ '/assets/css/bootstrap.min.css' | relative_url | bust_file_cache }}">
|
|
<link
|
|
rel="stylesheet"
|
|
href="{{ site.third_party_libraries.mdb.url.css }}"
|
|
integrity="{{ site.third_party_libraries.mdb.integrity.css }}"
|
|
crossorigin="anonymous"
|
|
>
|
|
|
|
{% if page.pretty_table %}
|
|
<!-- Bootstrap Table -->
|
|
<link
|
|
defer
|
|
rel="stylesheet"
|
|
href="{{ site.third_party_libraries.bootstrap-table.url.css }}"
|
|
integrity="{{ site.third_party_libraries.bootstrap-table.integrity.css }}"
|
|
crossorigin="anonymous"
|
|
>
|
|
{% endif %}
|
|
|
|
<!-- Fonts & Icons -->
|
|
<link defer rel="stylesheet" href="{{ '/assets/css/academicons.min.css' | relative_url | bust_file_cache }}">
|
|
<link defer rel="stylesheet" href="{{ '/assets/css/scholar-icons.css' | relative_url | bust_file_cache }}">
|
|
<link
|
|
defer
|
|
rel="stylesheet"
|
|
type="text/css"
|
|
href="{{ site.third_party_libraries.google_fonts.url.fonts }}"
|
|
>
|
|
|
|
<!-- Code Syntax Highlighting -->
|
|
<link
|
|
defer
|
|
rel="stylesheet"
|
|
href="{{ '/assets/css/jekyll-pygments-themes-github.css' | relative_url | bust_file_cache }}"
|
|
media=""
|
|
id="highlight_theme_light"
|
|
>
|
|
|
|
{% if page.toc and page.toc.sidebar %}
|
|
<!-- Sidebar Table of Contents -->
|
|
<link defer href="{{ '/assets/css/bootstrap-toc.min.css' | relative_url | bust_file_cache }}" rel="stylesheet">
|
|
{% endif %}
|
|
|
|
<!-- Styles -->
|
|
|
|
{% if page.pseudocode %}
|
|
<!-- pseudocode -->
|
|
<link
|
|
defer
|
|
rel="stylesheet"
|
|
href="{{ site.third_party_libraries.pseudocode.url.css }}"
|
|
integrity="{{ site.third_party_libraries.pseudocode.integrity.css }}"
|
|
crossorigin="anonymous"
|
|
>
|
|
{% endif %}
|
|
|
|
{% if site.icon.size <= 4 %}
|
|
<link
|
|
rel="shortcut icon"
|
|
href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>{{ site.icon }}</text></svg>"
|
|
>
|
|
{% elsif site.icon != blank %}
|
|
<link rel="shortcut icon" href="{{ site.icon | prepend: '/assets/img/' | relative_url | bust_file_cache}}">
|
|
{% endif %}
|
|
<link rel="stylesheet" href="{{ '/assets/css/main.css' | relative_url | bust_css_cache }}">
|
|
<link rel="canonical" href="{{ page.url | replace:'index.html','' | absolute_url }}">
|
|
|
|
{% if site.enable_darkmode %}
|
|
<!-- Dark Mode -->
|
|
<script src="{{ '/assets/js/theme.js' | relative_url | bust_file_cache }}"></script>
|
|
<link
|
|
defer
|
|
rel="stylesheet"
|
|
href="{{ '/assets/css/jekyll-pygments-themes-native.css' | relative_url | bust_file_cache }}"
|
|
media="none"
|
|
id="highlight_theme_dark"
|
|
>
|
|
<script>
|
|
initTheme();
|
|
</script>
|
|
{% endif %}
|
|
|
|
{% if page.map %}
|
|
<!-- GeoJSON support via Leaflet -->
|
|
<link
|
|
defer
|
|
rel="stylesheet"
|
|
href="{{ site.third_party_libraries.leaflet.url.css }}"
|
|
integrity="{{ site.third_party_libraries.leaflet.integrity.css }}"
|
|
crossorigin="anonymous"
|
|
>
|
|
{% endif %}
|
|
|
|
{% if page.code_diff %}
|
|
<!-- diff2html -->
|
|
<link
|
|
defer
|
|
rel="stylesheet"
|
|
href="{{ site.third_party_libraries.highlightjs.url.css.light }}"
|
|
integrity="{{ site.third_party_libraries.highlightjs.integrity.css.light }}"
|
|
crossorigin="anonymous"
|
|
media="screen and (prefers-color-scheme: light)"
|
|
>
|
|
<link
|
|
defer
|
|
rel="stylesheet"
|
|
href="{{ site.third_party_libraries.highlightjs.url.css.dark }}"
|
|
integrity="{{ site.third_party_libraries.highlightjs.integrity.css.dark }}"
|
|
crossorigin="anonymous"
|
|
media="screen and (prefers-color-scheme: dark)"
|
|
>
|
|
<link
|
|
defer
|
|
rel="stylesheet"
|
|
href="{{ site.third_party_libraries.diff2html.url.css }}"
|
|
integrity="{{ site.third_party_libraries.diff2html.integrity.css }}"
|
|
crossorigin="anonymous"
|
|
>
|
|
{% endif %}
|
|
|
|
{% if page.images %}
|
|
{% if page.images.compare %}
|
|
<!-- Image comparison slider -->
|
|
<link
|
|
defer
|
|
rel="stylesheet"
|
|
href="{{ site.third_party_libraries.img-comparison-slider.url.css }}"
|
|
integrity="{{ site.third_party_libraries.img-comparison-slider.integrity.css }}"
|
|
crossorigin="anonymous"
|
|
>
|
|
{% endif %}
|
|
{% if page.images.lightbox2 %}
|
|
<!-- Lightbox2 -->
|
|
<link
|
|
defer
|
|
rel="stylesheet"
|
|
href="{{ site.third_party_libraries.lightbox2.url.css }}"
|
|
integrity="{{ site.third_party_libraries.lightbox2.integrity.css }}"
|
|
crossorigin="anonymous"
|
|
>
|
|
{% endif %}
|
|
{% if page.images.photoswipe %}
|
|
<!-- Photoswipe -->
|
|
<link
|
|
defer
|
|
rel="stylesheet"
|
|
href="{{ site.third_party_libraries.photoswipe.url.css }}"
|
|
crossorigin="anonymous"
|
|
>
|
|
{% endif %}
|
|
{% if page.images.slider %}
|
|
<!-- Image slider -->
|
|
<link
|
|
defer
|
|
rel="stylesheet"
|
|
href="{{ site.third_party_libraries.swiper.url.css }}"
|
|
integrity="{{ site.third_party_libraries.swiper.integrity.css }}"
|
|
crossorigin="anonymous"
|
|
>
|
|
{% endif %}
|
|
{% if page.images.spotlight %}
|
|
<!-- Spotlight -->
|
|
<link
|
|
defer
|
|
rel="stylesheet"
|
|
href="{{ site.third_party_libraries.spotlight.url.css }}"
|
|
integrity="{{ site.third_party_libraries.spotlight.integrity.css }}"
|
|
crossorigin="anonymous"
|
|
>
|
|
{% endif %}
|
|
{% if page.images.venobox %}
|
|
<!-- Venobox -->
|
|
<link
|
|
defer
|
|
rel="stylesheet"
|
|
href="{{ site.third_party_libraries.venobox.url.css }}"
|
|
integrity="{{ site.third_party_libraries.venobox.integrity.css }}"
|
|
crossorigin="anonymous"
|
|
>
|
|
{% endif %}
|
|
{% endif %}
|
|
|
|
{% if page.tikzjax %}
|
|
<link defer rel="stylesheet" type="text/css" href="https://tikzjax.com/v1/fonts.css">
|
|
{% endif %}
|