diff --git a/.all-contributorsrc b/.all-contributorsrc index bc6a910..1e358e5 100644 --- a/.all-contributorsrc +++ b/.all-contributorsrc @@ -1,7 +1,5 @@ { - "files": [ - "README.md" - ], + "files": ["README.md"], "imageSize": 100, "commit": false, "contributorsPerLine": 7, @@ -17,29 +15,30 @@ "login": "alshedivat", "name": "Maruan", "avatar_url": "https://avatars.githubusercontent.com/u/2126561?v=4", - "profile": "http://maruan.alshedivat.com", - "contributions": [ - "design", - "code" - ] + "profile": "https://maruan.alshedivat.com", + "contributions": ["design", "code"] }, { "login": "rohandebsarkar", "name": "Rohan Deb Sarkar", "avatar_url": "https://avatars.githubusercontent.com/u/50144004?v=4", - "profile": "http://rohandebsarkar.github.io", - "contributions": [ - "code" - ] + "profile": "https://rohandebsarkar.github.io", + "contributions": ["code"] }, { "login": "pourmand1376", "name": "Amir Pourmand", "avatar_url": "https://avatars.githubusercontent.com/u/32064808?v=4", "profile": "https://amirpourmand.ir", - "contributions": [ - "code" - ] + "contributions": ["code"] + }, + { + "login": "george-gca", + "name": "George", + "avatar_url": "https://avatars.githubusercontent.com/u/31376482?v=4", + "profile": "https://george-gca.github.io/", + "contributions": ["code"] } - ] + ], + "commitConvention": "angular" } diff --git a/.devcontainer/Dockerfile b/.devcontainer/Dockerfile new file mode 100644 index 0000000..e511a1b --- /dev/null +++ b/.devcontainer/Dockerfile @@ -0,0 +1,7 @@ +FROM mcr.microsoft.com/devcontainers/jekyll + +# Fix: Remove the broken Yarn repository from the apt sources. +# This prevents 'apt-get update' from failing due to the missing GPG key. +# (Yarn is already provided by the dev container features/nvm, so this system repo is unnecessary) +# See issue #3487 +RUN rm -f /etc/apt/sources.list.d/yarn.list diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json new file mode 100644 index 0000000..041b0e9 --- /dev/null +++ b/.devcontainer/devcontainer.json @@ -0,0 +1,34 @@ +// For format details, see https://aka.ms/devcontainer.json. For config options, see the +// README at: https://github.com/devcontainers/templates/tree/main/src/jekyll +{ + "name": "Jekyll", + // Using a Dockerfile to fix the broken Yarn repository. See issue #3487. + "build": { + "dockerfile": "Dockerfile" + }, + + // Features to add to the dev container. More info: https://containers.dev/features. + "features": { + "ghcr.io/rocker-org/devcontainer-features/apt-packages:1": { + "packages": "build-essential,imagemagick,inotify-tools,jupyter-nbconvert,procps,ruby-full,zlib1g-dev" + }, + "ghcr.io/devcontainers-extra/features/prettier:1.0.2": {} + }, + + // Optionally: run jekyll serve automatically on container entering using the Docker entrypoint + "postAttachCommand": "./bin/entry_point.sh", + + "customizations": { + "vscode": { + "extensions": ["esbenp.prettier-vscode", "sissel.shopify-liquid", "yzhang.markdown-all-in-one"], + "settings": { + // use prettier code formatter as default formatter + "editor.defaultFormatter": "esbenp.prettier-vscode", + "prettier.configPath": ".prettierrc", + "editor.formatOnSave": true + } + } + }, + + "remoteUser": "vscode" +} diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..7e82674 --- /dev/null +++ b/.dockerignore @@ -0,0 +1,3 @@ +_site/ +.git/ +assets/ diff --git a/.gemini/settings.json b/.gemini/settings.json new file mode 100644 index 0000000..7f3c26c --- /dev/null +++ b/.gemini/settings.json @@ -0,0 +1,15 @@ +{ + "context": { + "fileName": [ + "AGENTS.md", + ".github/copilot-instructions.md", + ".github/agents/customize.agent.md", + ".github/agents/docs.agent.md", + ".github/instructions/**/*.md", + "CUSTOMIZE.md", + "INSTALL.md", + "TROUBLESHOOTING.md", + "QUICKSTART.md" + ] + } +} diff --git a/.git-blame-ignore-revs b/.git-blame-ignore-revs new file mode 100644 index 0000000..691dff4 --- /dev/null +++ b/.git-blame-ignore-revs @@ -0,0 +1,24 @@ +# Template taken from https://github.com/v8/v8/blob/master/.git-blame-ignore-revs. +# +# This file contains a list of git hashes of revisions to be ignored by git blame. These +# revisions are considered "unimportant" in that they are unlikely to be what you are +# interested in when blaming. Most of these will probably be commits related to linting +# and code formatting. +# +# Instructions: +# - Only large (generally automated) reformatting or renaming CLs should be +# added to this list. Do not put things here just because you feel they are +# trivial or unimportant. If in doubt, do not put it on this list. +# - Precede each revision with a comment containing the PR title and number. +# For bulk work over many commits, place all commits in a block with a single +# comment at the top describing the work done in those commits. +# - Only put full 40-character hashes on this list (not short hashes or any +# other revision reference). +# - Append to the bottom of the file (revisions should be in chronological order +# from oldest to newest). +# - Because you must use a hash, you need to append to this list in a follow-up +# PR to the actual reformatting PR that you are trying to ignore. + +# Format all the code using prettier.io. (#2048, #2062) +beb6f27d596e753014cb9bff1939e5f78d66431c +2d34024961c3a3d27d6fd18ce06a551657983234 diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..e785898 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,2 @@ +# Force LF line endings, needed for Docker to work on Windows +*.sh text eol=lf \ No newline at end of file diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml deleted file mode 100644 index c78502f..0000000 --- a/.github/FUNDING.yml +++ /dev/null @@ -1,12 +0,0 @@ -# These are supported funding model platforms - -github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2] -patreon: # Replace with a single Patreon username -open_collective: # Replace with a single Open Collective username -ko_fi: alshedivat -tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel -community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry -liberapay: # Replace with a single Liberapay username -issuehunt: # Replace with a single IssueHunt username -otechie: # Replace with a single Otechie username -custom: # ['https://www.buymeacoffee.com/TkFxuKo'] diff --git a/.github/GIT_WORKFLOW.md b/.github/GIT_WORKFLOW.md new file mode 100644 index 0000000..674db4a --- /dev/null +++ b/.github/GIT_WORKFLOW.md @@ -0,0 +1,47 @@ +# Git Workflow + +This document outlines the conventions for using Git and writing commit messages in this project. + +## Commit Message Format + +All commit messages should follow this format: + +``` +: + + +``` + +**Types:** + +- `feat`: A new feature +- `fix`: A bug fix +- `docs`: Documentation only changes +- `style`: Changes that do not affect the meaning of the code (white-space, formatting, etc.) +- `config`: Changes to configuration files +- `chore`: Changes to the build process or auxiliary tools and libraries + +**Examples:** + +``` +feat: Add dark mode toggle button to header +fix: Correct baseurl in project site configuration +docs: Update INSTALL.md with Docker troubleshooting +style: Format all Liquid templates with Prettier +config: Enable blog section in _config.yml +chore: Update Jekyll dependencies with bundle update --all +``` + +## Staging Changes + +**Always `git add` files explicitly.** Do not stage everything with `git add .` unless you are certain of what's being committed. Check `git status` first to review your changes. + +## What NOT to Commit + +**Always obey the project's [`.gitignore`](../.gitignore) file.** It prevents the accidental commit of: + +- Build outputs (`_site/`, `.jekyll-cache/`) +- Dependencies (`node_modules/`, `vendor/`) +- OS-specific files (`.DS_store`) +- Editor temporary files (`.idea/`, `.swp`, `.swo`) +- Secrets and API keys (never commit credentials) diff --git a/.github/ISSUE_TEMPLATE/1_bug_report.yml b/.github/ISSUE_TEMPLATE/1_bug_report.yml new file mode 100644 index 0000000..f9c461f --- /dev/null +++ b/.github/ISSUE_TEMPLATE/1_bug_report.yml @@ -0,0 +1,102 @@ +name: πŸ› Report a bug +description: Any errors. +labels: ["needs triage", "bug"] +body: + - type: markdown + attributes: + value: > + Before you go any further. Is this really a **πŸ› bug**? + + If it's a question about how al-folio works, have a look at our [documentation](https://github.com/alshedivat/al-folio/blob/main/README.md), + [frequently asked questions](https://github.com/alshedivat/al-folio/blob/main/FAQ.md), + [past questions](https://github.com/alshedivat/al-folio/discussions/categories/q-a), + or [ask a question](https://github.com/alshedivat/al-folio/discussions/new?category=q-a). + + - type: checkboxes + id: requirements + attributes: + label: Have you checked that your issue isn't already filed? + description: > + Please check if somebody else has already filed the same issue. + If you find a similar issue, please add a πŸ‘ reaction or comment on the original post. + options: + - label: I read through [FAQ](https://github.com/alshedivat/al-folio/blob/main/FAQ.md) and searched through the [past issues](https://github.com/alshedivat/al-folio/issues), none of which addressed my issue. + required: true + - label: Yes, I have checked that this issue isn't already filed. + required: true + + - type: input + attributes: + label: Bug description + description: A description of the πŸ› bug. + placeholder: A clear and concise description of what the bug is. + validations: + required: true + + - type: textarea + attributes: + label: How to reproduce the bug + description: Provide steps to reproduce the πŸ› bug. + placeholder: | + Include steps to reproduce, the expected behaviour, and the actual behaviour. + + 1. Go to '...' + 2. Click on '....' + 3. Scroll down to '....' + 4. See error + validations: + required: true + + - type: textarea + attributes: + label: Error messages and logs + description: > + Provide any error messages and/or logs + placeholder: "Copy the complete error messages and logs" + value: | + ``` + The error message you got, with the full traceback if available. Please paste it between these triple backticks. + ``` + validations: + required: false + + - type: dropdown + id: os + attributes: + label: What operating system are you using? + description: select all OSs where you have experienced this issue + multiple: true + options: + - Linux + - Mac + - Windows + - Not applicable (e.g. you're using GitHub Pages or other hosting) + validations: + required: true + + - type: dropdown + id: environment + attributes: + label: Where are you seeing the problem on? + description: select all environments where you have experienced this issue + multiple: true + options: + - "Running locally with Docker (docker compose)" + - "Running locally with Docker (devcontainer)" + - "Running locally without Docker" + - "Deployed site" + validations: + required: true + + - type: textarea + attributes: + label: More info + description: Add any other info about the issue here. + placeholder: | + Add any other context about the problem here, such as versions of the libraries if running without docker, screenshots, links to the deployed site, etc. + validations: + required: false + + - type: markdown + attributes: + value: "**Happy coding!**" diff --git a/.github/ISSUE_TEMPLATE/2_feature_request.yml b/.github/ISSUE_TEMPLATE/2_feature_request.yml new file mode 100644 index 0000000..6934f60 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/2_feature_request.yml @@ -0,0 +1,56 @@ +name: πŸš€ Feature request +description: Propose a feature for this project +labels: ["needs triage", "enhancement"] +body: + - type: markdown + attributes: + value: > + Before you go any further, are you sure that this feature is not already implemented? + + If it's a question about how al-folio works, have a look at our [documentation](https://github.com/alshedivat/al-folio/blob/main/README.md), + [frequently asked questions](https://github.com/alshedivat/al-folio/blob/main/FAQ.md), + [past questions](https://github.com/alshedivat/al-folio/discussions/categories/q-a), + or [ask a question](https://github.com/alshedivat/al-folio/discussions/new?category=q-a). + + - type: checkboxes + id: requirements + attributes: + label: Have you checked that your feature request isn't already filed? + description: > + Please check if somebody else has already filed the same πŸš€ feature request. + If you find a similar feature request, please add a πŸ‘ reaction or comment on the original post. + options: + - label: I read through [FAQ](https://github.com/alshedivat/al-folio/blob/main/FAQ.md) and searched through the [past issues](https://github.com/alshedivat/al-folio/issues), none of which addressed my feature request. + required: true + - label: Yes, I have checked that this feature request isn't already filed. + required: true + + - type: textarea + attributes: + label: Description & Motivation + description: A clear and concise description of the πŸš€ feature proposal + placeholder: | + Please outline the motivation for the proposal. + Is your feature request related to a problem? e.g., I'm always frustrated when [...]. + If this is related to another GitHub issue, please link it here + + - type: textarea + attributes: + label: Pitch + description: A clear and concise description of what you want to happen. + validations: + required: false + + - type: textarea + attributes: + label: Alternatives + description: A clear and concise description of any alternative solutions or features you've considered, if any. + validations: + required: false + + - type: textarea + attributes: + label: Additional context + description: Add any other context or screenshots about the feature request here. + validations: + required: false diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md deleted file mode 100644 index 511f585..0000000 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -name: Bug report -about: Create a report to help us improve -title: '' -labels: bug -assignees: '' - ---- - -**Acknowledge the following** -- [ ] I carefully read and followed the [Getting Started](https://github.com/alshedivat/al-folio#getting-started) guide. -- [ ] I read through [FAQ](https://github.com/alshedivat/al-folio#faq) and searched through the [past issues](https://github.com/alshedivat/al-folio/issues), none of which addressed my issue. -- [ ] The issue I am raising is a potential bug in al-folio and not just a usage question.
[For usage questions, please post in the [Discussions](https://github.com/alshedivat/al-folio/discussions) instead of raising an issue.] - -**Describe the bug** -A clear and concise description of what the bug is. - -**To Reproduce** -Steps to reproduce the behavior: -1. Go to '...' -2. Click on '....' -3. Scroll down to '....' -4. See error - -**Expected behavior** -A clear and concise description of what you expected to happen. - -**Screenshots** -If applicable, add screenshots to help explain your problem. - -**System (please complete the following information):** - - OS: [e.g. iOS] - - Browser (and its version) [e.g. chrome, safari] - - Jekyll version [e.g. 3.8.7] -- Ruby version [e.g. 2.6.5] - -**Additional context** -Add any other context about the problem here. diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..e851001 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: false +contact_links: + - name: ❓ Ask a Question + url: https://github.com/alshedivat/al-folio/discussions/categories/q-a + about: Ask and answer al-folio related questions. + - name: πŸ“– Read the documentation + url: https://github.com/alshedivat/al-folio/blob/main/README.md + about: Please consult the documentation before opening any issues! diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md deleted file mode 100644 index 11fc491..0000000 --- a/.github/ISSUE_TEMPLATE/feature_request.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -name: Feature request -about: Suggest an idea for this project -title: '' -labels: enhancement -assignees: '' - ---- - -**Is your feature request related to a problem? Please describe.** -A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] - -**Describe the solution you'd like** -A clear and concise description of what you want to happen. - -**Describe alternatives you've considered** -A clear and concise description of any alternative solutions or features you've considered. - -**Additional context** -Add any other context or screenshots about the feature request here. diff --git a/.github/agents/customize.agent.md b/.github/agents/customize.agent.md new file mode 100644 index 0000000..f35396d --- /dev/null +++ b/.github/agents/customize.agent.md @@ -0,0 +1,596 @@ +--- +name: customization_agent +description: Expert customization assistant for the al-folio Jekyll academic website template +--- + +You are an expert customization assistant for the al-folio Jekyll academic website template. + +## Your Role + +- You specialize in helping users customize their al-folio academic website +- You have deep knowledge of Jekyll, Liquid templating, YAML configuration, and the al-folio project structure +- **Many users are academics without coding experience** – you explain technical concepts in plain language +- You guide users through customizations step-by-step and apply changes directly to their repository +- Your task: help users personalize their academic website by modifying configuration files, adding content, and customizing the theme +- You translate technical requirements into clear, actionable instructions that anyone can follow + +## Project Knowledge + +- **Tech Stack:** Jekyll 4.x, Liquid templating, Ruby, YAML, Markdown, SCSS/SASS, JavaScript +- **Build System:** Jekyll with Bundler for dependency management +- **Deployment:** GitHub Pages (automated via GitHub Actions) +- **File Structure:** + - `_config.yml` – Main site configuration (URL, metadata, theme colors, enabled features) + - `_data/` – YAML data files: + - `cv.yml` – CV/resume in RenderCV format + - `socials.yml` – Social media links and configuration + - `repositories.yml` – GitHub repositories to display + - `coauthors.yml` – Coauthor information and links + - `venues.yml` – Publication venue abbreviations + - `citations.yml` – Citation counts and metrics + - `_pages/` – Site pages (About, Blog, Projects, Publications, CV, Teaching, Profiles, etc.) + - `_posts/` – Blog posts in Markdown (format: `YYYY-MM-DD-title.md`) + - `_projects/` – Project pages in Markdown + - `_news/` – News/announcement items + - `_books/` – Book review pages + - `_teachings/` – Teaching/course pages + - `_bibliography/papers.bib` – Publications in BibTeX format + - `_sass/` – SCSS/SASS stylesheets (colors, themes, layout) + - `_scripts/` – Helper scripts for development and utilities + - `_plugins/` – Custom Jekyll plugins for extended functionality + - `_includes/` – Liquid template components: + - `_includes/cv/` – Unified CV component renderers (awards, education, experience, skills, languages, certificates, references, projects, interests, etc.) + - `_includes/repository/` – Repository display components + - Core components: header, footer, navigation, metadata, scripts, etc. + - `assets/` – Static assets: + - `assets/img/` – Images and profile pictures + - `assets/pdf/` – PDF files (papers, posters, slides, etc.) + - `assets/json/` – JSON files (resume.json in JSONResume format, table_data.json) + - `assets/rendercv/` – RenderCV configuration and generated PDFs + - `assets/css/`, `assets/js/` – Custom stylesheets and scripts + - `assets/bibliography/` – BibTeX-related assets + - `assets/fonts/`, `assets/webfonts/` – Font files + - `assets/libs/` – Third-party JavaScript libraries + - `assets/audio/`, `assets/video/`, `assets/jupyter/`, `assets/plotly/`, `assets/html/` – Multimedia and embedded content + - `.devcontainer/` – Development container configuration for VS Code + - `.github/` – GitHub-specific configuration: + - `.github/workflows/` – GitHub Actions for deployment, CI/CD, CV PDF generation, link checking, code quality, and Copilot environment setup + - `.github/agents/` – AI agent configuration files + - `.github/instructions/` – Path-specific Copilot custom instructions for different file types + - `.github/ISSUE_TEMPLATE/` – GitHub issue templates + - `.pre-commit-config.yaml` – Pre-commit hooks configuration + - `bin/` – Executable scripts and utilities + - `package.json`, `purgecss.config.js` – Node.js dependencies and build tools + - `Gemfile`, `Gemfile.lock`, `.ruby-version` – Ruby dependencies and version + - Documentation files: `README.md`, `INSTALL.md`, `CUSTOMIZE.md`, `FAQ.md`, `CONTRIBUTING.md`, `QUICKSTART.md`, `ANALYTICS.md`, `SEO.md`, `TROUBLESHOOTING.md` + - `robots.txt` – SEO and crawler configuration + - `Dockerfile`, `docker-compose.yml`, `docker-compose-slim.yml` – Docker configuration + +## Community Context & Issue/Discussion References + +Users may reference community discussions, issues, or past questions from the **al-folio repository** (https://github.com/alshedivat/al-folio): + +- **GitHub Issues** – Issues (#123) provide context about reported problems or feature requests in the al-folio project +- **Discussions** – Discussion threads contain relevant customization questions from the al-folio community +- **Pull Requests** – PRs may demonstrate similar customizations to the al-folio template + +**Important considerations when using this context:** + +- Users may or may not provide links – accept descriptions or issue numbers without requiring explicit links +- **Always assume references are to the al-folio repository** – when checking for issue/discussion information online, search within https://github.com/alshedivat/al-folio, not other repositories +- **Always check the date** when considering information from issues or discussions – the al-folio codebase evolves, and solutions posted months or years ago may be outdated +- If a user references an old discussion/issue, verify the suggestion against the current code and documentation before recommending it +- Use this information to understand patterns and common questions, but prioritize current best practices +- If a customization request matches a pattern from previous discussions in al-folio, acknowledge it while ensuring your solution reflects the current state of the project + +## Essential Documentation References + +You have access to the complete documentation for al-folio: + +1. **README.md** – Overview, features, community examples, installation basics +2. **QUICKSTART.md** – Quick start guide for getting up and running +3. **INSTALL.md** – Installation, deployment, and Docker setup instructions +4. **CUSTOMIZE.md** – Comprehensive customization guide covering: + - Configuration in `_config.yml` + - CV information (RenderCV and JSONResume formats) + - Creating pages, blog posts, projects, news items, and teaching pages + - Publications and BibTeX management + - Theme colors and styling + - Social media setup + - Search and analytics configuration + - Removing unwanted content + - Font and spacing customization + - Newsletter setup + - Google Calendar integration +5. **FAQ.md** – Frequently asked questions and common solutions +6. **TROUBLESHOOTING.md** – Troubleshooting guide for common issues +7. **CONTRIBUTING.md** – Guidelines for contributing to the project + +8. **ANALYTICS.md** – Analytics and tracking configuration +9. **SEO.md** – Search engine optimization guide + +## Custom Instructions Context + +This repository maintains custom instruction files (in `.github/instructions/` and `.github/copilot-instructions.md`) to guide Copilot agents when working with specific file types. These instructions provide: + +- **Build process and requirements** – Docker setup, Ruby/Python versions, dependency management +- **Project-specific conventions** – File naming, frontmatter specifications, directory organization +- **Validation procedures** – Prettier formatting, Jekyll build testing, syntax checking +- **Common patterns and examples** – How to modify configuration, create content, and implement features +- **Common pitfalls and workarounds** – Solutions to frequent issues like YAML syntax errors, CSS/JS not loading, broken links + +When helping users, reference these instructions to ensure recommendations align with project conventions and best practices. You have access to these files and should use them as authoritative guidance for accurate, consistent advice. + +## Commands You Can Use + +**Development (local testing):** + +```bash +# Using Docker (recommended) +docker compose pull +docker compose up +# Site available at http://localhost:8080 + +# Legacy method (requires Ruby, Bundler, Python) +bundle install +bundle exec jekyll serve +# Site available at http://localhost:4000 +``` + +**Build and deployment:** + +```bash +# Using Docker (recommended) +docker compose pull +docker compose up --build +# Output automatically served at http://localhost:8080 + +# Legacy method (requires Ruby, Bundler) +bundle exec jekyll build +# Output in _site/ directory + +# Deploy happens automatically via GitHub Actions on push to main branch +``` + +**Code formatting:** + +```bash +# Format code with Prettier +npx prettier . --write +``` + +## Common Customization Tasks + +### 1. Basic Site Information + +**Files:** `_config.yml`, `_pages/about.md` + +- Change site title, author name, description +- Set URL and baseurl for deployment +- Update contact information +- Modify footer text + +### 2. Social Media & Contact + +**Files:** `_data/socials.yml`, `_config.yml` + +- Add/update social media links (GitHub, Twitter/X, LinkedIn, Google Scholar, etc.) +- Configure email display with obfuscation +- Enable/disable social links in navbar vs. footer + +### 3. About Page Content + +**Files:** `_pages/about.md`, `assets/img/prof_pic.jpg` + +- Update biography and profile picture +- Customize news section visibility +- Configure selected publications display + +### 4. CV/Resume + +**Files:** `_data/cv.yml` (RenderCV format), `assets/json/resume.json` (JSONResume format), `assets/rendercv/` (configuration) + +- **Choose your format:** Users can maintain either RenderCV (`_data/cv.yml`) or JSONResume (`assets/json/resume.json`), or both simultaneously +- **RenderCV (recommended):** Human-readable YAML format with automatic PDF generation via GitHub Actions, customizable styling via `assets/rendercv/` config files (`design.yaml`, `locale.yaml`, `settings.yaml`) +- **JSONResume:** Standard JSON format compatible with other tools and services +- **Using both formats:** Users can keep both files and switch which one displays using the `cv_format` frontmatter variable in `_pages/cv.md` (options: `rendercv` or `jsonresume`) +- **Single format:** To use only one format, optionally delete the unused file (both are supported equally well) + +### 5. Publications + +**Files:** `_bibliography/papers.bib`, `_data/venues.yml`, `_data/coauthors.yml` + +- Add publications in BibTeX format to `papers.bib` +- Configure author highlighting in `_config.yml` (`scholar:last_name`, `scholar:first_name`) +- Add venue abbreviations and coauthor links +- Include PDFs in `assets/pdf/` +- Add custom fields: `abstract`, `pdf`, `code`, `website`, `slides`, `poster`, etc. + +### 6. Blog Posts + +**Files:** `_posts/YYYY-MM-DD-title.md` + +- Create new posts with naming pattern: `YYYY-MM-DD-title.md` +- Add frontmatter: layout, title, date, description, tags, categories +- Use Markdown for content +- Support for math (MathJax), code highlighting, images, videos + +### 7. Projects + +**Files:** `_projects/*.md` + +- Create project pages in `_projects/` directory +- Add frontmatter: layout, title, description, img, importance +- Support for categories and horizontal/grid display + +### 8. News/Announcements + +**Files:** `_news/*.md` + +- Add inline announcements or news with links +- Automatically displayed on home page + +### 9. Teaching Pages + +**Files:** `_teachings/*.md` + +- Create course and teaching pages in `_teachings/` directory +- Add frontmatter: layout, title, description, academic_year, type +- Support for course schedules and materials + +### 10. Theme Colors + +**Files:** `_sass/_themes.scss`, `_sass/_variables.scss` + +- Change `--global-theme-color` variable in `_sass/_themes.scss` +- Available theme colors defined in `_sass/_variables.scss` +- Enable/disable dark mode in `_config.yml` (`enable_darkmode`) + +### 11. GitHub Repositories Display + +**Files:** `_data/repositories.yml`, `_pages/repositories.md` + +- Add GitHub usernames and repository names +- Displayed with stats and trophies on repositories page + +### 12. Enable/Disable Features + +**File:** `_config.yml` + +- Toggle features: Google Analytics, comments (Giscus), related posts, tooltips, medium zoom, search +- Enable/disable pages: blog, projects, publications, repositories, teaching, books +- Configure navbar, footer, and navigation +- Configure analytics services (Google Analytics, Cronitor, Pirsch, OpenPanel) +- Configure newsletter and contact options + +## Code Style Standards + +**YAML formatting (in `_config.yml` and `_data/*.yml`):** + +```yaml +# βœ… Good - proper indentation, clear structure +first_name: Jane +middle_name: Marie +last_name: Doe +email: jane@example.com +``` + +**Markdown frontmatter (for posts, pages, projects):** + +```markdown +--- +layout: post +title: My Research Project +date: 2024-11-21 +description: A fascinating study on machine learning +tags: ml ai research +categories: research +--- + +Your content here in Markdown format. +``` + +**BibTeX entries (in `_bibliography/papers.bib`):** + +```bibtex +@article{einstein1905, + title={Zur Elektrodynamik bewegter K{\"o}rper}, + author={Einstein, Albert}, + journal={Annalen der Physik}, + volume={322}, + number={10}, + pages={891--921}, + year={1905}, + publisher={Wiley Online Library}, + pdf={relativity.pdf}, + abstract={This paper introduces the theory of special relativity.}, + selected={true} +} +``` + +**Directory and file naming:** + +- Blog posts: `YYYY-MM-DD-descriptive-title.md` (e.g., `2024-11-21-new-research.md`) +- Projects: `descriptive-name.md` (e.g., `quantum-computing-project.md`) +- Images: `descriptive-name.jpg/png` in `assets/img/` +- PDFs: `descriptive-name.pdf` in `assets/pdf/` + +## Customization Examples + +**Example 1: Changing site title and author** + +```yaml +# In _config.yml +title: My Academic Website +first_name: Jane +middle_name: Marie +last_name: Doe +email: jane.doe@university.edu +``` + +**Example 2: Adding a new blog post** +Create `_posts/2024-11-21-my-first-post.md`: + +```markdown +--- +layout: post +title: My First Research Blog Post +date: 2024-11-21 14:00:00 +description: Sharing insights from my latest research +tags: research machine-learning +categories: research +--- + +This is my first blog post discussing my research in machine learning... +``` + +**Example 3: Customizing theme color** +In `_sass/_themes.scss`: + +```scss +// Change from purple to blue +:root { + --global-theme-color: #{$blue-color}; + --global-theme-color-dark: #{$blue-color-dark}; +} +``` + +**Example 4: Adding social media links** +In `_data/socials.yml`: + +```yaml +- name: Twitter + link: https://twitter.com/username + icon: fa-brands fa-twitter + enabled: true + +- name: GitHub + link: https://github.com/username + icon: fa-brands fa-github + enabled: true + +- name: LinkedIn + link: https://linkedin.com/in/username + icon: fa-brands fa-linkedin + enabled: true +``` + +## Step-by-Step Workflow + +When helping users customize their site: + +1. **Understand the request** – Ask clarifying questions if needed; never assume technical knowledge + - If the user mentions a relevant issue, discussion, or past question, listen for context but don't require them to provide a link +2. **Review related issues/discussions** – If a user references or describes a related issue/discussion, acknowledge the context but verify currency + - Example: "I see this relates to discussion #123. Let me verify the current approach and address your specific needs." + - Caveat: "That discussion is from 2021; let me check if the approach still applies with our current codebase." +3. **Identify affected files** – Determine which files need modification +4. **Explain the change clearly** – Describe what you'll do, where the file is located, and why this change matters +5. **Apply changes** – Use file editing tools to make modifications +6. **Verify syntax** – Ensure YAML/Markdown/BibTeX syntax is correct +7. **Provide clear next steps** – Explain how to preview changes in beginner-friendly terms (e.g., "After I make this change, you can see it by...") +8. **Anticipate questions** – Address potential confusion before users encounter it; reference related discussions if applicable +9. **Use plain language** – Avoid or explain technical jargon; prioritize clarity over verbosity + +## Testing Before Deployment + +Always guide users to test changes locally before pushing to GitHub: + +**Local Testing Steps:** + +1. **Run locally with Docker** (recommended): + + ```bash + docker compose pull + docker compose up + ``` + + Then open `http://localhost:8080` in your browser + +2. **Wait for rebuild** – After making changes to files, wait 5-10 seconds for Jekyll to rebuild the site. You'll see output in the terminal indicating the rebuild is complete. + +3. **Check for errors** – Look at the terminal output for any error messages (YAML syntax errors, missing files, BibTeX parsing issues, etc.). + +4. **Verify visually** – Manually navigate through your site: + - Check that pages load without errors + - Verify text displays correctly + - Ensure images are visible + - Test navigation links + - Check that your changes appear as expected + +5. **Test on different pages** – If you modified: + - `_config.yml` – Check the entire site (affects global settings) + - Blog posts – Check the blog page and individual post + - Publications – Check the publications page + - CV/Resume – Check the about page + - Social links – Check header and footer + +6. **Only then push to GitHub** – Once everything looks good locally, commit and push: + ```bash + git add . + git commit -m "Describe your changes" + git push + ``` + +**Why this matters:** Catching errors locally saves time and prevents broken content from going live. Most issues are easy to spot in the local preview. + +## Common Mistakes to Avoid + +Help users avoid these frequent errors: + +### YAML Configuration Errors + +- **Deleting `baseurl:` instead of leaving it empty** – For personal sites, the line must exist but be empty: + ```yaml + baseurl: # βœ… Correct - empty value + # ❌ Wrong - deleted entirely + ``` +- **Incorrect indentation in `_config.yml`** – YAML is very sensitive to spacing. Use spaces, not tabs. Each nested item should be indented by exactly 2 spaces. +- **Unquoted special characters** – Some characters need quotes: + ```yaml + description: "My site: Research & Teaching" # βœ… Correct + description: My site: Research & Teaching # ❌ May cause errors + ``` + +### Blog Posts & Content + +- **Wrong filename format** – Must be `YYYY-MM-DD-title.md` (e.g., `2024-01-15-my-post.md`). If the format is wrong, the post won't appear. +- **Missing required frontmatter** – Every post needs: + ```markdown + --- + layout: post + title: My Post Title + date: 2024-01-15 + --- + ``` +- **Incorrect date format** – Use `YYYY-MM-DD` in filename and `YYYY-MM-DD HH:MM:SS` (or just `YYYY-MM-DD`) in frontmatter. + +### Publications & BibTeX + +- **BibTeX syntax errors** – Common mistakes: + - Missing commas between fields + - Unmatched braces `{}` + - Invalid characters in entry keys + - Check existing entries in `_bibliography/papers.bib` as examples +- **Author names not matching** – If you set `scholar:last_name: [Einstein]` but your BibTeX has "A. Einstein", it won't highlight. Names must match exactly (considering variations defined in `_data/coauthors.yml`) + +### Media & Assets + +- **Incorrect file paths** – Use consistent paths: + - Images: `assets/img/my-image.jpg` + - PDFs: `assets/pdf/my-paper.pdf` + - Test that links work by opening them in the browser during local preview +- **Large unoptimized images** – Compress images before adding them (tools: TinyPNG, ImageOptim). Large images slow down your site. + +### Deployment Issues + +- **Not checking GitHub Actions status** – After pushing, wait 4-5 minutes and check the **Actions** tab in your repository. If the build failed, you'll see error messages there. +- **Modifying the `gh-pages` branch directly** – Never edit this branch. It's auto-generated by GitHub Actions. All changes go to `main`. +- **Not refreshing your browser cache** – If you pushed changes but don't see them, try: + - Hard refresh: `Ctrl+Shift+R` (Windows/Linux) or `Cmd+Shift+R` (Mac) + - Clear browser cache + - Wait a few more minutes for deployment to complete + +### Configuration Mismatches + +- **`url` and `baseurl` not matching your site type**: + - Personal site: `url: https://username.github.io`, `baseurl:` (empty) + - Project site: `url: https://username.github.io`, `baseurl: /repo-name/` + - External domain: Set `url` to your actual domain +- **Inconsistent settings in `_config.yml`** – If you change author name in one place, update it everywhere it appears + +## Boundaries + +- βœ… **Always do:** + - Modify configuration files (`_config.yml`, `_data/*.yml`) + - Create/edit content files (posts, pages, projects, news) + - Update BibTeX bibliography + - Customize SCSS/SASS theme files + - Add images and PDFs to appropriate directories + - Explain changes and their impact + - Reference official documentation when helpful + +- ⚠️ **Ask first:** + - Major structural changes to the template + - Removing core functionality or pages + - Modifying GitHub Actions workflows + - Changes that might break deployment + - Adding external dependencies or plugins + +- 🚫 **Never do:** + - Delete `.github/workflows/` files without explicit request + - Modify `Gemfile` or `package.json` without understanding implications + - Add sensitive information (API keys, passwords, personal data) + - Edit auto-generated files in `_site/` or `gh-pages` branch + - Make changes that violate the MIT license terms + - Modify Docker configuration without Docker expertise + +## Important Notes + +- All changes should be made to the **main** (or **source**) branch, NEVER to `gh-pages` +- The `gh-pages` branch is auto-generated by GitHub Actions +- Changes take ~4-5 minutes to deploy via GitHub Actions after pushing to main +- Local preview with Docker runs on `http://localhost:8080` +- The site auto-rebuilds locally when files change (may take a few seconds) +- Always ensure `url` and `baseurl` are correctly set in `_config.yml` for deployment +- For personal sites: `url: https://username.github.io` and `baseurl:` (empty) +- For project sites: `url: https://username.github.io` and `baseurl: /repo-name/` + +## Quick Reference Map + +| User wants to... | Files to modify | Key documentation | +| ----------------------- | ------------------------------------------------------------------- | ---------------------------------- | +| Change personal info | `_config.yml`, `_pages/about.md` | CUSTOMIZE.md Β§ Configuration | +| Add profile picture | `assets/img/prof_pic.jpg` | CUSTOMIZE.md Β§ About page | +| Update CV | `_data/cv.yml` (RenderCV) or `assets/json/resume.json` (JSONResume) | CUSTOMIZE.md Β§ Modifying CV | +| Add publications | `_bibliography/papers.bib` | CUSTOMIZE.md Β§ Adding publications | +| Add blog post | `_posts/YYYY-MM-DD-title.md` | CUSTOMIZE.md Β§ Blog posts | +| Create project | `_projects/name.md` | CUSTOMIZE.md Β§ Projects | +| Add news item | `_news/announcement.md` | CUSTOMIZE.md Β§ Adding news | +| Add teaching page | `_teachings/course.md` | CUSTOMIZE.md Β§ Teaching collection | +| Change theme color | `_sass/_themes.scss` | CUSTOMIZE.md Β§ Theme color | +| Add social links | `_data/socials.yml` | CUSTOMIZE.md Β§ Social media | +| Set up analytics | `_config.yml` | CUSTOMIZE.md & ANALYTICS.md | +| Enable/disable features | `_config.yml` | CUSTOMIZE.md Β§ Configuration | +| Remove pages | Delete from `_pages/`, update nav | CUSTOMIZE.md Β§ Removing content | +| Fix deployment issues | `_config.yml` (url/baseurl) | FAQ.md, INSTALL.md | +| Test changes locally | Docker setup | INSTALL.md Β§ Docker | +| Debug broken site | Check GitHub Actions, local preview output | TROUBLESHOOTING.md, FAQ.md | +| Add custom page | Create `_pages/name.md`, update nav | CUSTOMIZE.md Β§ Creating pages | +| Customize fonts/spacing | `_sass/_variables.scss` | CUSTOMIZE.md Β§ Customization | +| Improve SEO | `_config.yml`, `robots.txt` | SEO.md | +| Ensure accessibility | Check markup, alt text, contrast | TROUBLESHOOTING.md | + +## Using Community Context in Your Responses + +When users reference issues or discussions: + +1. **Accept information without requiring links** – Don't demand that users track down and share issue/discussion URLs + - ❌ Avoid: "Please provide the link to the discussion so I can help you." + - βœ… Do this: "Let me help based on what you've described. If you remember any details from the discussion, that would be helpful." + +2. **Verify information against current code** – Assume advice from older discussions might be outdated + - Example: "You mentioned a solution from an older discussion. Let me check if that still applies with the current version..." + - Be prepared to offer updated guidance if the codebase has changed + +3. **Acknowledge patterns while providing current guidance** – Show you understand the context but prioritize current best practices + - Example: "I see why that approach was suggested before. With our current code, here's the recommended way to do this..." + +4. **Mention when discussions are particularly relevant** – If a recent discussion is very relevant, you can mention it + - Example: "This is similar to what was discussed in #67 (from December 2024), which is still the best approach." + +5. **Suggest sharing solutions** – If a user's question or your solution would help the community, encourage them to update or create discussions + - Example: "If this solution works for you, consider sharing it in the discussionsβ€”it might help others with similar customizations." + +## Response Style + +- Be direct, patient, and actionable – assume the user may be unfamiliar with coding concepts +- Show the exact file path and changes needed, explaining where to find files in plain language +- Provide code snippets ready to copy-paste, with clear instructions on what to change +- Always explain the "why" in simple terms – help users understand what they're doing, not just follow steps blindly +- When using technical terms (like "YAML", "Markdown", "frontmatter", "repository"), briefly explain what they mean +- Break complex tasks into small, numbered steps that are easy to follow +- Reference documentation sections when they provide additional useful detail +- Reference related issues or discussions when they provide relevant context or solutions +- After making changes, clearly explain how to preview (local) or deploy (push to GitHub) in beginner-friendly terms +- Anticipate common questions or confusion points and address them proactively diff --git a/.github/agents/docs.agent.md b/.github/agents/docs.agent.md new file mode 100644 index 0000000..e333452 --- /dev/null +++ b/.github/agents/docs.agent.md @@ -0,0 +1,215 @@ +--- +name: docs_agent +description: Documentation specialist for al-folio Jekyll theme +--- + +You are a documentation specialist for the al-folio Jekyll theme project. + +## Your role + +- You maintain clear, concise documentation for this Jekyll-based academic portfolio theme +- You write for academics and researchers who may not have a coding background +- You explain technical concepts in plain language, avoiding jargon whenever possible +- Your primary task: update and maintain documentation in root-level markdown files that anyone can understand + +## Project knowledge + +- **Tech Stack:** Jekyll 4.x (Ruby-based static site generator), Liquid templating, YAML configuration, SCSS/CSS, JavaScript, Docker +- **Key Dependencies:** jekyll-scholar, jekyll-archives-v2, jekyll-paginate-v2, MathJax, Bootstrap, Prettier, pre-commit hooks +- **File Structure:** + - `_config.yml` – Main Jekyll configuration file + - `*.md` (root) – Documentation files: `README.md`, `INSTALL.md`, `CUSTOMIZE.md`, `FAQ.md`, `CONTRIBUTING.md`, `QUICKSTART.md`, `ANALYTICS.md`, `SEO.md`, `TROUBLESHOOTING.md` + - `_pages/` – Website pages (Markdown with frontmatter) + - `_posts/` – Blog posts + - `_projects/`, `_news/`, `_books/`, `_teachings/` – Jekyll collections + - `_layouts/` – Liquid layouts for different page types + - `_includes/` – Liquid template components: + - `_includes/cv/` – Unified CV component renderers (awards, education, experience, skills, languages, certificates, references, projects, interests, publications, etc.) + - `_includes/repository/` – Repository display components + - Core includes: header, footer, metadata, scripts, etc. + - `_sass/` – SCSS stylesheets + - `_data/` – YAML data files: + - `cv.yml` – CV/resume in RenderCV format + - `socials.yml` – Social media links + - `repositories.yml` – GitHub repositories + - `coauthors.yml` – Coauthor information + - `venues.yml` – Publication venue abbreviations + - `citations.yml` – Citation metrics + - `_plugins/` – Custom Jekyll plugins for extended functionality + - `_bibliography/` – BibTeX files for publications + - `assets/` – Static assets: + - `assets/json/` – JSON files (resume.json in JSONResume format, table_data.json) + - `assets/rendercv/` – RenderCV configuration files and generated PDFs + - `assets/img/`, `assets/pdf/` – Images and PDFs + - `assets/css/`, `assets/js/` – Custom stylesheets and scripts + - `assets/fonts/`, `assets/webfonts/` – Font files + - `assets/bibliography/`, `assets/libs/` – Support files + - `assets/audio/`, `assets/video/`, `assets/jupyter/`, `assets/plotly/`, `assets/html/` – Multimedia and embedded content + - `.github/` – GitHub configuration: + - `.github/workflows/` – GitHub Actions (deployment, CI/CD, CV PDF generation, link checking, code quality, Copilot environment setup) + - `.github/agents/` – AI agent configuration files (customize.agent.md, docs.agent.md) + - `.github/instructions/` – Path-specific Copilot custom instructions for different file types + - `.github/ISSUE_TEMPLATE/` – GitHub issue templates + - `_scripts/` – Helper scripts and utilities + - `bin/` – Executable scripts + - `.devcontainer/` – Development container configuration + - `.pre-commit-config.yaml` – Pre-commit hooks for code quality + - `Dockerfile`, `docker-compose.yml`, `docker-compose-slim.yml` – Docker configuration + - `Gemfile`, `Gemfile.lock`, `.ruby-version` – Ruby dependencies + - `package.json` – Node.js dependencies + +## Documentation standards + +**Keep it simple:** + +- Be direct and concise; avoid unnecessary examples unless they clarify significantly different use cases +- Each section should answer: "What is this?" and "How do I use it?" +- Use bullet points for unordered lists; use numbered lists for sequential steps or when order matters + +**Prefer references over repetition:** + +- Link to existing files instead of duplicating content + - Good: "See the configuration options in `_config.yml`" + - Bad: Copying the entire YAML structure into docs +- Link to official library documentation for third-party tools + - Example: "For Jekyll basics, see [Jekyll documentation](https://jekyllrb.com/docs/)" +- When referencing code files, use inline code formatting with backticks: `_config.yml`, `_pages/about.md` + +**Point users to source code:** + +- Reference well-documented configuration files rather than repeating their content +- Example: "Configure your deployment settings in `_config.yml`. For Docker deployment, see `docker-compose.yml`" +- When explaining CV features, point to both data sources: "The CV page is generated from `_data/cv.yml` (RenderCV format) or `assets/json/resume.json` (JSONResume format), which are kept in sync. A GitHub Actions workflow automatically generates a PDF from the RenderCV data." + +**Avoid UI descriptions:** + +- Don't draw or describe visual UI elements with Markdown +- Don't document button locations, menu items, or visual layouts that may change +- Focus on conceptual understanding and file-based configuration +- Good: "Enable dark mode by setting `enable_darkmode: true` in `_config.yml`" +- Bad: "Click the moon icon in the top right corner to toggle dark mode" + +**Code style:** + +- Use triple backticks with language identifiers for code blocks: `bash`, `yaml`, `ruby`, `liquid`, `html` +- For file paths, use inline code: `` `_config.yml` `` +- Keep code examples minimal and focused on the specific feature being explained + +**Structure:** + +- Use clear section headers with `##` or `###` +- Include a table of contents for longer documents (use `` and `` markers for auto-generation) +- Group related information together +- Put important warnings or notes in blockquotes: `> Note: ...` or `> Warning: ...` + +## Documentation file purposes + +- `ANALYTICS.md` – Analytics and tracking configuration options +- `CONTRIBUTING.md` – Guidelines for contributors and development +- `CUSTOMIZE.md` – Comprehensive customization guide (configuration, adding content, styling, CV management, publications) +- `FAQ.md` – Frequently asked questions and common issues +- `INSTALL.md` – Installation and deployment instructions (Docker, GitHub Pages, local setup, upgrading) +- `QUICKSTART.md` – Get started in 5 minutes (repository setup, personalization, deployment) +- `README.md` – Project overview, features showcase, community examples, quick start links +- `SEO.md` – Search engine optimization guide +- `TROUBLESHOOTING.md` – Detailed troubleshooting guide for deployment, build, styling, and feature issues + +## GitHub Copilot Custom Instructions + +This repository includes custom instruction files to enhance GitHub Copilot's effectiveness when working with specific file types. These files are located in `.github/instructions/` and `.github/copilot-instructions.md`: + +**Main Instructions:** + +- `.github/copilot-instructions.md` – Repository-wide guidance including tech stack versions, Docker build process, project layout, CI/CD pipelines, common pitfalls, and file format specifications + +**Path-Specific Instructions (applies to files matching specific patterns):** + +- `.github/instructions/liquid-templates.instructions.md` (applies to `**/*.liquid`) – Guidance for Liquid templating, common patterns, validation, and testing +- `.github/instructions/yaml-configuration.instructions.md` (applies to `_config.yml,_data/**/*.yml`) – Guidance for YAML syntax, feature flags, BibTeX keywords, and configuration best practices +- `.github/instructions/bibtex-bibliography.instructions.md` (applies to `**/*.bib,_bibliography/**`) – Guidance for BibTeX entry syntax, custom keywords, field specifications, and publication frontmatter +- `.github/instructions/markdown-content.instructions.md` (applies to content collections) – Guidance for creating content in `_books/`, `_news/`, `_pages/`, `_posts/`, `_projects/`, and `_teachings/` with appropriate frontmatter and formatting +- `.github/instructions/javascript-scripts.instructions.md` (applies to `_scripts/**/*.js`) – Guidance for JavaScript and Liquid+JavaScript hybrid files, ES6 patterns, and script debugging + +**Environment Setup:** + +- `.github/workflows/copilot-setup-steps.yml` – GitHub Actions workflow that pre-configures the Copilot environment with Ruby 3.3.5, Python 3.13, Node.js, ImageMagick, and nbconvert before agent execution + +These instruction files help Copilot agents understand project-specific conventions, build requirements, validation procedures, and common patterns without requiring them to explore the codebase. + +## Writing style + +- **Audience:** Many users are academics without coding experience; explain technical terms when you must use them +- **Tone:** Patient, encouraging, and straightforward; treat every reader as intelligent but possibly unfamiliar with web development +- **Clarity:** One concept per paragraph; use numbered lists for multi-step processes to make them easy to follow +- **Examples:** Provide real, concrete examples from the repository; show exactly what to type or where to click +- **Accessibility:** When mentioning technical terms (e.g., "YAML", "frontmatter", "repository"), briefly explain what they mean in context + +## Typical tasks + +1. **Update configuration documentation** when `_config.yml` changes +2. **Document new features** added to the theme (new layouts, plugins, customization options) +3. **Document CV workflow** – Explain how users choose between RenderCV and JSONResume formats, how to switch formats using frontmatter, and how optional automatic PDF generation works via GitHub Actions +4. **Clarify installation steps** when deployment methods or dependencies change +5. **Update troubleshooting** in FAQ when common issues arise +6. **Maintain consistency** across all documentation files + +## Common Technical Terms & Explanations + +For academics and non-technical readers, explain these terms briefly on first use: + +**Web/Jekyll Terms:** + +- **Jekyll** – A "static site generator" that converts your Markdown files and templates into a complete website. Think of it as a tool that takes your content and automatically formats it into web pages. +- **Frontmatter** – Metadata at the top of a file (between `---` lines) that tells Jekyll how to process the file. Example: title, date, author. +- **Liquid** – A templating language that Jekyll uses to dynamically generate pages. You'll see it in `_layouts/` and `_includes/` files with `{% %}` syntax. +- **Markdown** – A simple text format for writing content. Much easier than HTML. Files use `.md` extension. + +**Configuration Terms:** + +- **YAML** – A human-readable format for storing configuration data. Uses colons and indentation. Examples in `_config.yml`, `_data/` files. +- **Configuration file** – `_config.yml` contains all the settings that control how your site looks and behaves (like site title, author name, theme color). + +**Content Organization:** + +- **Collection** – A group of similar content items. al-folio uses collections for `_posts/` (blog posts), `_projects/`, `_news/`, etc. +- **Repository** – The folder containing all your website code and content. Stored on GitHub for version control and deployment. +- **Deployment** – The process of publishing your site so it's accessible on the internet (via GitHub Pages or other hosting). + +**Publication-Related:** + +- **BibTeX** – A standardized format for storing publication metadata (title, authors, year, etc.). Used in `_bibliography/papers.bib`. +- **Publication frontmatter** – Custom fields you add to BibTeX entries (like `pdf:`, `code:`, `slides:`) to add extra links and features to your publications page. + +**When to explain:** If a document uses a technical term that readers might not know, briefly explain it in parentheses or a footnote the first time it appears: + +```markdown +Jekyll uses **Liquid** (a templating language that generates dynamic content) +to process your files located in `_layouts/` and `_includes/`. +``` + +## Boundaries + +- βœ… **Always do:** + - Update documentation files (`*.md` in root directory) + - Keep documentation in sync with actual code and configuration + - Use existing documentation style and structure (or improve it with patterns from this agent) + - Link to source files and official documentation + - Test commands and instructions before documenting them + - Explain technical terms using the common terms reference provided + - Preserve existing table of contents markers (`` and `` + +- ⚠️ **Ask first:** + - Major restructuring of documentation organization + - Adding entirely new documentation files + - Changing the documentation format or style guide + - Removing sections that may still be relevant + +- 🚫 **Never do:** + - Modify source code files (`_layouts/`, `_includes/`, `_sass/`, etc.) + - Edit `_config.yml` or other configuration files + - Change GitHub Actions workflows in `.github/workflows/` + - Modify Jekyll plugins in `_plugins/` + - Commit without testing documentation examples + - Delete existing documentation without replacement + - Add executable code that runs automatically + - Include placeholder text like "TODO" or "Coming soon" without an issue tracking it diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md new file mode 100644 index 0000000..3609656 --- /dev/null +++ b/.github/copilot-instructions.md @@ -0,0 +1,253 @@ +# Copilot Coding Agent Instructions + +## Repository Overview + +**al-folio** is a simple, clean, and responsive [Jekyll](https://jekyllrb.com/) theme for academics and researchers. It enables users to create professional portfolio and blog websites with minimal configuration. The repository serves both as a template and as a reference implementation. + +- **Type:** Jekyll static site generator template +- **Target Users:** Academics, researchers, and professionals +- **Key Features:** CV display, publication bibliography, blog posts, projects, news/announcements, course listings + +## Tech Stack & Versions + +**Core Technologies:** + +- **Jekyll:** v4.x (Ruby static site generator) +- **Ruby:** 3.3.5 (primary CI/CD version), 3.2.2 (some workflows) +- **Python:** 3.13 (for nbconvert, jupyter notebook support) +- **Node.js:** Latest (for purgecss and prettier) +- **Docker:** Uses prebuilt image `amirpourmand/al-folio:v0.16.3` (Ruby slim-based) + +**Build Dependencies (from Gemfile):** + +- `classifier-reborn` – Related posts calculation +- `jekyll-archives-v2` – Archive page generation +- `jekyll-jupyter-notebook` – Jupyter notebook embedding +- `jekyll-minifier` – CSS/JS minification +- `jekyll-paginate-v2` – Pagination +- `jekyll-scholar` – Bibliography management +- `jekyll-tabs` – Tab UI components +- `jekyll-toc` – Table of contents generation +- `jemoji` – Emoji support +- Multiple other specialized jekyll plugins + +**Code Quality Tools:** + +- **Prettier:** v3.8.0+ with `@shopify/prettier-plugin-liquid` – Code formatter (mandatory for PRs) +- **Purgecss:** CSS purification for production builds + +## Building & Local Development + +### Docker (Recommended Approach) + +**Always use Docker for local development.** This ensures consistency with CI/CD and avoids Ruby/Python environment issues. + +**Initial Setup:** + +```bash +docker compose pull # Pull prebuilt image +docker compose up # Start development server +# Site runs at http://localhost:8080 +``` + +**Rebuilding with Updated Dependencies:** + +```bash +docker compose up --build # Rebuilds Docker image from Dockerfile +docker compose up --force-recreate # Forces complete rebuild +``` + +**For slim Docker image (if image size is critical):** + +```bash +docker compose -f docker-compose-slim.yml up +``` + +**If Docker build fails:** + +- Check disk space and available RAM +- Kill any existing jekyll processes: `docker compose down` +- For M1/M2 Mac: Ensure Docker Desktop is up-to-date +- Linux users may need Docker group permissions: `sudo usermod -aG docker $USER` (then logout/login) + +### Bundle/Jekyll (Legacy, Use Docker Instead) + +```bash +bundle install # Install Ruby gems +pip install jupyter # Install Python dependencies +bundle exec jekyll serve --port 4000 # Run at http://localhost:4000 +``` + +### Important Build Requirements + +- **ImageMagick must be installed** – Required for image processing plugins + - Docker: Installed automatically + - Local: `sudo apt-get install imagemagick` (Linux) or `brew install imagemagick` (Mac) +- **nbconvert must be upgraded before build** – `pip3 install --upgrade nbconvert` +- **Always set JEKYLL_ENV=production for production builds** – Required for CSS/JS minification + +## Project Layout & Key Files + +### Root Directory Structure + +- `_bibliography/papers.bib` – BibTeX bibliography for publications +- `_config.yml` – **Primary configuration file** (title, author, URLs, baseurl, feature flags) +- `_data/` – YAML data files (socials.yml, coauthors.yml, cv.yml, citations.yml, venues.yml, repositories.yml) +- `_includes/` – Reusable Liquid template components +- `_layouts/` – Page layout templates (about.liquid, post.liquid, bib.liquid, distill.liquid, cv.liquid, etc.) +- `_news/` – News/announcement entries +- `_pages/` – Static pages (about.md, cv.md, publications.md, projects.md, teaching.md, etc.) +- `_posts/` – Blog posts (format: YYYY-MM-DD-title.md) +- `_projects/` – Project showcase entries +- `_sass/` – SCSS stylesheets +- `_scripts/` – JavaScript files for functionality +- `_teachings/` – Course and teaching entries +- `assets/img/` – Images, profile pictures +- `docker-compose.yml` – Docker compose configuration +- `Dockerfile` – Docker image definition +- `Gemfile` & `Gemfile.lock` – Ruby dependency specifications +- `package.json` – Node.js dependencies (prettier only) +- `purgecss.config.js` – PurgeCSS configuration for production CSS optimization + +### Configuration Priority + +When making changes: + +1. **Always start with `_config.yml`** for site-wide settings +2. **Feature flags are in `_config.yml`** – Look for `enabled: true/false` options +3. **Social media links:** `_data/socials.yml` +4. **Content data:** Respective `_data/*.yml` files +5. **Styling:** `_sass/` directory (uses SCSS) + +## CI/CD Pipeline & Validation + +### GitHub Workflows (in `.github/workflows/`) + +- **deploy.yml** – Main deployment workflow (runs on push/PR to main/master) + - Sets up Ruby 3.3.5, Python 3.13 + - Installs imagemagick, nbconvert + - Runs `bundle exec jekyll build` with JEKYLL_ENV=production + - Runs purgecss for CSS optimization + - Commits built site to gh-pages branch + - **Triggers on:** Changes to site files, assets, config (NOT documentation files alone) +- **prettier.yml** – Code formatting validation (mandatory) + - Runs prettier on all files + - **Fails PRs if code is not properly formatted** + - Generates HTML diff artifact on failure + - Must install prettier locally to avoid failures: `npm install prettier @shopify/prettier-plugin-liquid` +- **broken-links.yml, broken-links-site.yml** – Link validation +- **axe.yml** – Accessibility testing +- **codeql.yml** – Security scanning +- **update-citations.yml** – Automatic citation updates +- **render-cv.yml** – CV rendering from RenderCV format + +### Pre-commit Requirements + +**You must run these locally before pushing:** + +1. **Prettier formatting (mandatory):** + +```bash +npm install --save-dev prettier @shopify/prettier-plugin-liquid +npx prettier . --write +``` + +2. **Local build test with Jekyll:** + +```bash +docker compose pull && docker compose up +# Let it build (wait 30-60 seconds) +# Visit http://localhost:8080 and verify site renders correctly +# Exit with Ctrl+C +``` + +3. **Or run full build simulation:** + +```bash +docker compose up --build +bundle exec jekyll build +# Check for errors in output +``` + +## Common Pitfalls & Workarounds + +### YAML Syntax Errors in \_config.yml + +- **Problem:** Special characters (`:`, `&`, `#`) in values cause parse errors +- **Solution:** Quote string values: `title: "My: Cool Site"` +- **Debug:** Run locally to see detailed error: `bundle exec jekyll build` + +### "Unknown tag 'toc'" Error on Deployment + +- **Problem:** Deploy succeeds locally but fails on GitHub Actions +- **Cause:** Jekyll plugins don't load properly +- **Solution:** Verify gh-pages branch is set as deployment source in Settings β†’ Pages + +### CSS/JS Not Loading After Deploy + +- **Problem:** Site loads but has no styling +- **Cause:** Incorrect `url` and `baseurl` in `_config.yml` +- **Fix:** + - Personal site: `url: https://username.github.io`, `baseurl:` (empty) + - Project site: `url: https://username.github.io`, `baseurl: /repo-name/` + - Clear browser cache (Ctrl+Shift+Del or private browsing) + +### Prettier Formatting Failures + +- **Problem:** PR fails prettier check after local builds passed +- **Solution:** Run prettier before committing: + ```bash + npx prettier . --write + git add . && git commit -m "Format code with prettier" + ``` + +### Port 8080 or 4000 Already in Use + +- **Docker:** `docker compose down` then `docker compose up` +- **Ruby:** Kill process: `lsof -i :4000 | grep LISTEN | awk '{print $2}' | xargs kill` + +### Related Posts Errors ("Zero vectors cannot be normalized") + +- **Cause:** Empty blog posts or posts with only stop words confuse classifier-reborn +- **Solution:** Add meaningful content to posts, or set `related_posts: false` in post frontmatter + +## File Format Specifications + +### Blog Post Frontmatter (\_posts/) + +```yaml +--- +layout: post +title: Post Title +date: YYYY-MM-DD +categories: category-name +--- +``` + +### Project Frontmatter (\_projects/) + +```yaml +--- +layout: page +title: Project Name +description: Short description +img: /assets/img/project-image.jpg +importance: 1 +--- +``` + +### BibTeX Format (papers.bib) + +- Standard BibTeX format +- al-folio supports custom keywords: `pdf`, `code`, `preview`, `doi`, etc. +- Check CUSTOMIZE.md for custom bibtex keyword documentation + +## Trust These Instructions + +This guidance documents the tested, working build process and project structure. **Trust these instructions and only perform additional searches if:** + +1. Specific information contradicts what you observe in the codebase +2. You need implementation details beyond what's documented +3. Error messages reference features or files not mentioned here + +The instructions are designed to reduce unnecessary exploration and allow you to focus on code changes. diff --git a/.github/instructions/bibtex-bibliography.instructions.md b/.github/instructions/bibtex-bibliography.instructions.md new file mode 100644 index 0000000..c059643 --- /dev/null +++ b/.github/instructions/bibtex-bibliography.instructions.md @@ -0,0 +1,174 @@ +--- +applyTo: "**/*.bib,_bibliography/**" +excludeAgent: "code-review" +--- + +# BibTeX Bibliography Instructions + +## BibTeX Format Basics + +The al-folio repository uses BibTeX for managing publications. All entries are stored in `_bibliography/papers.bib`. + +### Standard BibTeX Entry Types + +```bibtex +@article{key, + title={Title}, + author={Author, A. and Author, B.}, + journal={Journal Name}, + volume={10}, + pages={1--20}, + year={2023}, + publisher={Publisher Name} +} + +@inproceedings{key, + title={Title}, + author={Author, A.}, + booktitle={Proceedings of Conference}, + year={2023} +} + +@book{key, + title={Book Title}, + author={Author, A.}, + publisher={Publisher Name}, + year={2023} +} +``` + +## al-folio Custom BibTeX Keywords + +Beyond standard BibTeX fields, al-folio supports custom keywords for rich publications display: + +### Available Custom Keywords + +- **abstract:** Full abstract text (multi-line text in curly braces) +- **award:** Award or distinction (`award: Best Paper Award`) +- **code:** URL to source code repository (`code: https://github.com/user/repo`) +- **dimensions:** Dimensions badge ID for citation metrics +- **doi:** Digital Object Identifier (`doi: 10.1234/example`) +- **html:** URL to full text or project page (`html: https://example.com`) +- **pdf:** URL or path to PDF file (`pdf: /assets/papers/2023-paper.pdf`) +- **poster:** URL to conference poster (`poster: /assets/posters/poster.pdf`) +- **preview:** URL to preview image (`preview: /assets/img/papers/paper-preview.jpg`) +- **selected:** Boolean to feature on publications page (`selected: true`) +- **slides:** URL to presentation slides (`slides: /assets/slides/2023.pdf`) + +### Example Entry with Custom Keywords + +```bibtex +@article{smith2023important, + title={Important Research}, + author={Smith, John and Doe, Jane}, + journal={Nature}, + volume={100}, + pages={1--10}, + year={2023}, + publisher={Nature Publishing Group}, + abstract={This is the full abstract text. It can span multiple lines.}, + pdf={smith2023.pdf}, + code={https://github.com/example/repo}, + preview={smith2023.jpg}, + doi={10.1234/nature.12345}, + selected={true} +} +``` + +## Formatting Rules + +### Key Considerations + +1. **Unique keys:** Each entry must have a unique key (first parameter) +2. **Author names:** Separate multiple authors with `and` +3. **Curly braces:** Protect capitalized words in titles with `{Curly Braces}` to preserve capitalization +4. **Special characters:** Use LaTeX escape sequences (`{\`e}`for Γ©,`{\~n}` for Γ±) +5. **URLs:** Place URLs in `{curly braces}` to prevent issues +6. **Alphabetical order:** Keep entries alphabetically sorted by key + +### Common Mistakes to Avoid + +- ❌ `author=Smith, John` β†’ βœ… `author={Smith, John}` +- ❌ `journal=Science` β†’ βœ… `journal={Science}` or `journal = "Science"` +- ❌ `title=Deep Learning` (loses capitalization) β†’ βœ… `title={Deep Learning}` or `title={{D}eep {L}earning}` +- ❌ `pdf=http://...` β†’ βœ… `pdf={http://...}` + +## Jekyll-Scholar Integration + +The `jekyll-scholar` plugin processes BibTeX and generates bibliography pages. + +### How it Works + +1. Entries in `_bibliography/papers.bib` are read +2. Pages marked with `layout: bib` render the bibliography +3. Posts/pages can reference entries using `{% cite key %}` +4. Custom keywords control what displays on publication entries + +### Displaying Publications + +In pages/posts, use: + +- `{% cite key %}` – Cite an entry inline +- `{% bibliography %}` – Display full bibliography + +## File Paths in BibTeX + +When using `pdf`, `poster`, `preview`, or similar fields: + +- **PDF files:** Use just the filename (automatically resolved to `assets/pdf/`) + - Example: `pdf={smith2023.pdf}` β†’ resolves to `assets/pdf/smith2023.pdf` +- **Preview images:** Use just the filename (automatically resolved to `assets/img/publication_preview/`) + - Example: `preview={smith2023.jpg}` β†’ resolves to `assets/img/publication_preview/smith2023.jpg` +- **Absolute URLs:** Include full URL for external resources + - Example: `code={https://github.com/user/repo}` + - Example: `html={https://example.com/paper}` + +## Validation + +### Before Committing BibTeX Changes + +1. **Syntax check:** Verify no unclosed braces or quotes +2. **Build test:** + ```bash + docker compose down + docker compose up + # Check output for "ERROR" or "Invalid bibtex" + # Publications should render at http://localhost:8080/publications/ + ``` +3. **Publication page:** Open publications page and verify entries display correctly + +### Common BibTeX Build Errors + +- `Invalid bibtex reference 'key'` – Key doesn't exist in papers.bib +- `Unmatched braces` – Missing closing brace in entry +- `Unknown entry type` – Entry type (after @) is misspelled +- `PDF not found` – Path in pdf field is incorrect + +## Editing and Maintenance + +### Adding New Entries + +1. Add entry to `_bibliography/papers.bib` +2. Use consistent key naming (e.g., `LastnameYear` or `Lastname2023details`) +3. Ensure all required fields are present +4. Test build: `docker compose up` + +### Modifying Existing Entries + +- Can change any BibTeX field without breaking Jekyll +- Adding custom keywords (pdf, code, etc.) enriches display +- Test build after modifications to verify display + +### Removing Entries + +- Delete or comment out (prefix with `%`) the entire entry +- No broken reference check needed; Jekyll-Scholar handles missing keys gracefully + +## Trust These Instructions + +When working with BibTeX: + +- Follow the standard format shown in examples above +- Always test locally with `docker compose up` after changes +- Check the publications page at http://localhost:8080/publications to verify display +- Only search for additional details if encountering error messages not mentioned here diff --git a/.github/instructions/javascript-scripts.instructions.md b/.github/instructions/javascript-scripts.instructions.md new file mode 100644 index 0000000..2e2fd34 --- /dev/null +++ b/.github/instructions/javascript-scripts.instructions.md @@ -0,0 +1,248 @@ +--- +applyTo: "_scripts/**/*.js" +--- + +# JavaScript Scripts Instructions + +## Overview + +The `_scripts/` directory contains JavaScript files that provide frontend functionality for the al-folio website. These scripts handle: + +- **Search functionality** – Ninja-keys integration for search bar +- **Analytics setup** – Google Analytics, Cronitor, Open Panel integrations +- **Gallery functionality** – PhotoSwipe lightbox initialization +- **Liquid template processing** – Files with `.liquid.js` extension process Jekyll Liquid syntax + +## Key Script Files + +### `search.liquid.js` + +- **Purpose:** Generates searchable navigation data for the Ninja-keys search component +- **Type:** Liquid + JavaScript hybrid (Jekyll processes `.liquid.js` files) +- **Output:** Compiled to `/assets/js/search-data.js` via permalink frontmatter +- **Content:** Builds `ninja.data` array from site pages, posts, and navigation structure +- **Usage:** Included in `_includes/scripts.liquid` and loaded in layouts + +### `photoswipe-setup.js` + +- **Purpose:** Initializes PhotoSwipe lightbox for image galleries +- **Type:** Pure JavaScript with ES6 imports +- **Output:** Compiled to `/assets/js/photoswipe-setup.js` +- **Dependencies:** PhotoSwipe library (referenced via `site.third_party_libraries`) +- **Functionality:** Automatically converts `.pswp-gallery` elements into interactive lightbox galleries + +### `google-analytics-setup.js`, `cronitor-analytics-setup.js`, `open-panel-analytics-setup.js` + +- **Purpose:** Initialize third-party analytics services +- **Type:** Conditional setup scripts (may be excluded from production builds) +- **Usage:** Loaded conditionally based on `_config.yml` feature flags +- **Integration:** Each sets up tracking code for respective analytics platforms + +## File Structure & Frontmatter + +All scripts in `_scripts/` may include Jekyll frontmatter: + +```javascript +--- +permalink: /assets/js/filename.js +--- +// JavaScript code here +``` + +**Key frontmatter fields:** + +- `permalink:` – Specifies output path in compiled site (e.g., `/assets/js/search-data.js`) +- Comments/empty – Files with only JavaScript and no frontmatter are processed as-is + +**Processing:** + +- `.liquid.js` files – Processed by Jekyll's Liquid engine before JavaScript compilation +- `.js` files – Processed normally, passed through to assets directory +- **Note:** Files in `_scripts/` are ignored by Prettier (see `.prettierignore`) because `.liquid.js` files mix Liquid template syntax with JavaScript, which Prettier doesn't support + +## JavaScript Patterns in al-folio + +### Liquid + JavaScript Mixing (in `.liquid.js` files) + +Example from `search.liquid.js`: + +```javascript +--- +permalink: /assets/js/search-data.js +--- +// Regular JavaScript +const ninja = document.querySelector('ninja-keys'); + +// Liquid processing - Jekyll loops and variables +ninja.data = [ + {%- for page in site.pages -%} + { + id: "nav-{{ page.title | slugify }}", + title: "{{ page.title }}", + handler: () => { + window.location.href = "{{ page.url | relative_url }}"; + }, + }, + {%- endfor -%} +]; +``` + +**Important:** + +- Use Liquid filters (`| slugify`, `| relative_url`, `| escape`) to process Jekyll variables +- Curly braces `{{ }}` output variables +- Use `{%- -%}` (with hyphens) to control whitespace in generated output +- Keep JSON structures valid after Liquid processing + +### ES6 Modules & Imports + +Scripts use modern JavaScript with ES6 imports: + +```javascript +import PhotoSwipeLightbox from "{{ site.third_party_libraries.photoswipe-lightbox.url.js }}"; +import PhotoSwipe from "{{ site.third_party_libraries.photoswipe.url.js }}"; +``` + +- Import third-party libraries via `site.third_party_libraries` configuration +- Libraries resolved from `_config.yml` CDN or local paths + +### DOM Manipulation & Event Handlers + +Scripts attach to specific DOM elements: + +```javascript +const element = document.querySelector(".selector"); +element.addEventListener("click", (event) => { + // Handle event +}); +``` + +## Common Modification Patterns + +### Adding a New Analytics Service + +1. Create new file `_scripts/myservice-setup.js`: + +```javascript +--- +permalink: /assets/js/myservice-setup.js +--- +(function() { + // Initialize your service + if (window.myService) { + console.log('MyService loaded'); + } +})(); +``` + +2. Add conditional loading to `_includes/scripts.liquid`: + +```liquid +{% if site.myservice_enabled %} + +{% endif %} +``` + +3. Add feature flag to `_config.yml`: + +```yaml +myservice_enabled: false +``` + +### Modifying Search Data Structure + +In `search.liquid.js`: + +1. Identify the Liquid loop building `ninja.data` array +2. Add new properties to each object: + +```javascript +{ + id: "nav-{{ title | slugify }}", + title: "{{ title }}", + newField: "{{ page.new_property }}", // Add new field + handler: () => { ... } +} +``` + +3. Rebuild: `docker compose up` will regenerate `/assets/js/search-data.js` + +### Updating Gallery Functionality + +In `photoswipe-setup.js`: + +1. Modify gallery selector or initialization options +2. Reference [PhotoSwipe documentation](https://photoswipe.com/) for available options +3. Update any CSS classes used in gallery markup + +## Code Style Notes + +**Prettier and \_scripts/:** + +Files in `_scripts/` are **excluded from Prettier formatting** (defined in `.prettierignore`) because: + +- `.liquid.js` files contain mixed Liquid template syntax and JavaScript +- Prettier doesn't understand or support this hybrid format +- Manual formatting consistency is required for these files + +**When modifying \_scripts/ files:** + +- Follow existing code style in the file (indentation, spacing, quotes) +- Maintain readability for Liquid + JavaScript mixed code +- Do NOT run Prettier on the `_scripts/` directory +- **DO run Prettier on the rest of the project** when making other changes: `npx prettier . --write` + +## Validation & Testing + +### Local Build Test + +```bash +docker compose up +# Wait 30 seconds for Jekyll to build +# Check for errors in terminal output +# Visit http://localhost:8080 and verify functionality +``` + +### Checking Generated Output + +After `docker compose up`, verify scripts compiled correctly: + +```bash +# Check if script files exist in _site/assets/js/ +ls _site/assets/js/ + +# Verify no Liquid syntax in generated output (should be pure JavaScript) +cat _site/assets/js/search-data.js | head -20 +``` + +### Debugging Script Issues + +**Script not loading:** + +- Check browser DevTools Console for HTTP 404 errors +- Verify `permalink:` frontmatter matches script inclusion paths +- Check that script is actually in `_site/assets/js/` after build + +**Liquid syntax errors:** + +- Jekyll build will fail with "Liquid Exception" messages +- Check file for unclosed `{% %}` or `{{ }}` tags +- Ensure Liquid filters exist (`| relative_url`, `| slugify`, etc.) + +**JavaScript errors:** + +- Check browser console for runtime errors +- Verify all imported libraries are defined in `site.third_party_libraries` in `_config.yml` +- Test in both Chrome and Firefox for compatibility + +## Trust These Instructions + +When modifying JavaScript scripts: + +- `.liquid.js` files must have valid Liquid syntax AND valid JavaScript that remains valid after Jekyll processes the Liquid +- Do NOT run Prettier on `_scripts/` files (they are in `.prettierignore` because of Liquid + JavaScript mixing) +- Test locally with `docker compose up` to verify build succeeds and scripts work +- For site-wide script inclusion, modify `_includes/scripts.liquid` +- For configuration (feature flags, third-party URLs), see yaml-configuration.instructions.md +- Reference the actual script files in `_scripts/` as examples when adding new functionality +- Only search for additional details if errors occur during build or testing diff --git a/.github/instructions/liquid-templates.instructions.md b/.github/instructions/liquid-templates.instructions.md new file mode 100644 index 0000000..04d3d35 --- /dev/null +++ b/.github/instructions/liquid-templates.instructions.md @@ -0,0 +1,100 @@ +--- +applyTo: "**/*.liquid" +--- + +# Liquid Templates Instructions + +## Liquid Template Basics + +This al-folio repository uses Liquid templating extensively. When modifying `.liquid` files: + +### Key Directories + +- `_includes/` – Reusable template components (imported with `{% include %}`) +- `_layouts/` – Page layout templates (specified in frontmatter with `layout: name`) + +### Common Liquid Tags in al-folio + +- `{% include filename.liquid %}` – Includes template component +- `{% for item in collection %}...{% endfor %}` – Loops +- `{% if condition %}...{% endif %}` – Conditionals +- `{{ variable }}` – Output variable +- `{% assign var = value %}` – Assign variable +- `{% capture %}...{% endcapture %}` – Capture output to variable +- `| date: format` – Date filtering +- `| where: "key", "value"` – Collection filtering + +### Important al-folio Liquid Components + +- `_includes/citation.liquid` – Bibliography entry rendering +- `_includes/distill_scripts.liquid` – Distill.pub specific scripts +- `_includes/footer.liquid` – Site footer +- `_includes/head.liquid` – Page section +- `_includes/header.liquid` – Site header/navigation +- `_includes/projects.liquid` – Project display +- `_includes/scripts.liquid` – Global scripts +- `_includes/selected_papers.liquid` – Featured publications display + +### Prettier Formatting for Liquid + +Prettier with `@shopify/prettier-plugin-liquid` enforces formatting: + +- Single quotes around strings in Liquid tags +- Consistent spacing +- Indentation with 2 spaces +- Run `npx prettier . --write` before committing + +## Common Modification Patterns + +### Modifying Site Header/Navigation + +- Edit `_includes/header.liquid` +- Add links to navigation array in `_config.yml` (see yaml-configuration.instructions.md) +- Test by viewing site in browser: `docker compose up` β†’ http://localhost:8080 + +### Adding a New Component Include + +1. Create new file in `_includes/mycomponent.liquid` +2. Use Liquid syntax for conditionals, loops, and variable output +3. Call it from templates: `{% include mycomponent.liquid %}` +4. Test: `docker compose up` + +### Adjusting Styling with Liquid + +- Some SCSS variables can be controlled via Liquid logic +- Avoid mixing complex Liquid with CSS; keep templates focused + +## Validation Before Committing + +**Always run these checks:** + +1. **Prettier format check:** + + ```bash + npx prettier _includes/ _layouts/ --check + npx prettier . --write # Fix formatting + ``` + +2. **Build test:** + + ```bash + docker compose down + docker compose up + # Wait 30 seconds, check for errors in output + # No "Unknown tag" messages should appear + ``` + +3. **Visual verification:** + - Open http://localhost:8080 + - Check that your changes rendered correctly + - Verify no broken layout or missing content + +## Trust These Instructions + +When working with Liquid templates: + +- Use `_includes/` and `_layouts/` as reference for syntax patterns +- Follow existing formatting in files (Prettier will enforce consistency) +- Always test locally before pushing (build must succeed) +- For configuration changes, see yaml-configuration.instructions.md +- Only search for additional details if error messages reference unfamiliar Liquid tags or Jekyll concepts diff --git a/.github/instructions/markdown-content.instructions.md b/.github/instructions/markdown-content.instructions.md new file mode 100644 index 0000000..cce3769 --- /dev/null +++ b/.github/instructions/markdown-content.instructions.md @@ -0,0 +1,277 @@ +--- +applyTo: "_books/**/*.md,_news/**/*.md,_pages/**/*.md,_posts/**/*.md,_projects/**/*.md,_teachings/**/*.md" +--- + +# Content Files (Markdown) Instructions + +## File Organization + +Content in al-folio is organized by type: + +- **\_books/** – Book reviews and summaries +- **\_news/** – News/announcements +- **\_pages/** – Static pages (about, CV, publications, projects, etc.) +- **\_posts/** – Blog posts (format: `YYYY-MM-DD-title.md`) +- **\_projects/** – Project showcase entries +- **\_teachings/** – Course and teaching information + +## Frontmatter Structure + +Every markdown file requires YAML frontmatter at the top. The structure varies by content type. + +### Book Frontmatter (\_books/) + +```yaml +--- +layout: book-review +title: Book Title +author: Book Author Name +publisher: Publisher Name +year: 2023 +rating: 8/10 +img: /assets/img/book-cover.jpg +--- +``` + +### News Frontmatter (\_news/) + +```yaml +--- +layout: post +title: News Title +date: YYYY-MM-DD +--- +``` + +### Page Frontmatter (\_pages/) + +```yaml +--- +layout: page +title: Page Title +permalink: /pathname/ +description: Brief description for metadata +--- +``` + +### Blog Post Frontmatter (\_posts/) + +```yaml +--- +layout: post +title: Post Title +date: YYYY-MM-DD +categories: category-name +description: Brief description +--- +``` + +**Important:** Post filenames MUST follow format: `YYYY-MM-DD-title.md` (hyphen-separated words) + +### Project Frontmatter (\_projects/) + +```yaml +--- +layout: page +title: Project Name +description: Short description +img: /assets/img/project-image.jpg +importance: 1 +--- +``` + +### Teaching/Course Frontmatter (\_teachings/) + +```yaml +--- +layout: page +title: Course Title +description: Course description +--- +``` + +## Special Frontmatter Fields + +### For Books + +- **author:** Author name or comma-separated list +- **publisher:** Publisher name +- **year:** Publication year +- **rating:** Personal rating (e.g., `8/10`) +- **img:** Path to book cover image (`/assets/img/...`) + +### For Blog Posts + +- **categories:** Tag for post organization (single word, no spaces) +- **related_posts:** Set to `false` to disable related posts display (useful for short posts) + +### For Projects + +- **importance:** Integer (1, 2, 3...) – higher = featured first +- **img:** Path to thumbnail image (`/assets/img/...`) +- **featured:** Set to `true` to display on main projects section + +### Date Format + +Always use ISO 8601: `YYYY-MM-DD` (e.g., `2023-12-25`) + +## Markdown Content + +### Basic Markdown Syntax + +```markdown +# Heading 1 + +## Heading 2 + +### Heading 3 + +**bold text** +_italic text_ +`inline code` + +- List item 1 +- List item 2 + +[Link text](https://url.com) + +![Image alt text](/path/to/image.jpg) +``` + +### al-folio-Specific Features + +#### Includes/Shortcodes + +- `{% include figure.liquid ... %}` – Responsive images with captions +- `{% include audio.liquid ... %}` – Audio player +- `{% include video.liquid ... %}` – Video player +- `{% include bib_search.liquid ... %}` – Bibliography search +- `{% include calendar.liquid ... %}` – Event calendar + +#### Math Support + +```markdown +Inline: $E = mc^2$ + +Display mode: +$$\int_0^1 f(x) dx$$ +``` + +#### Code Blocks + +````markdown +```python +def hello(): + print("Hello, world!") +``` +```` + +#### Blockquotes + +```markdown +> This is a quote +> +> > Nested quote +``` + +### Jekyll Features Available + +- **Liquid variables:** `{{ site.title }}`, `{{ page.title }}` +- **Collections:** `{{ site.posts }}`, `{{ site.projects }}` +- **Filters:** `| date: format`, `| where: key value` +- **Tags:** `{% if condition %} ... {% endif %}` + +## Common Content Patterns + +### Creating a Blog Post + +1. Create file: `_posts/YYYY-MM-DD-my-post.md` +2. Add frontmatter with `layout: post`, `title`, `date`, `categories` +3. Write markdown content +4. Test: `docker compose up` β†’ http://localhost:8080/blog +5. Post will appear in reverse chronological order + +### Creating a Project Entry + +1. Create file: `_projects/project-name.md` +2. Add frontmatter with `layout: page`, `title`, `description`, `img`, `importance` +3. Write markdown content describing the project +4. Test: `docker compose up` β†’ http://localhost:8080/projects + +### Adding Images + +```markdown +{% include figure.liquid path="/assets/img/example.jpg" title="Image caption" %} +``` + +### Linking to Other Pages + +```markdown +[About Me](/about/) +[My CV](/cv/) +[Blog Post]({% link _posts/2023-01-15-my-post.md %}) +``` + +## Testing & Validation + +### Before Committing + +1. **Frontmatter syntax:** Verify YAML is valid (no unclosed quotes, proper indentation) +2. **Date format:** Check `YYYY-MM-DD` format is correct +3. **Build test:** + ```bash + docker compose down + docker compose up + # Wait for "Server running" message + # Navigate to your content in browser + # Verify formatting, images, and links work + ``` + +### Common Issues + +- **Post not appearing:** Check `date` is today or earlier, filename format is correct +- **Images not loading:** Verify path starts with `/assets/`, file exists +- **Related posts error:** Content has no meaningful words; add more text or set `related_posts: false` + +## File Naming Conventions + +### Blog Posts + +- Format: `YYYY-MM-DD-title-with-hyphens.md` +- Example: `2023-12-25-christmas-post.md` +- Words separated by hyphens, no spaces + +### Projects + +- Format: `project-name.md` +- Example: `my-research-project.md` +- Use hyphens for readability + +### Pages + +- Format: `descriptive-name.md` +- Example: `about.md`, `teaching.md`, `cv.md` + +## Markdown Linting & Formatting + +The Prettier formatter applies to markdown files: + +- **Line length:** Soft wrap at 88 characters +- **Lists:** Consistent bullet formatting +- **Code blocks:** Proper fence syntax +- **Spacing:** Consistent blank lines + +**Always run before committing:** + +```bash +npx prettier --write . +``` + +## Trust These Instructions + +When creating or editing content: + +- Follow the frontmatter structure for your content type +- Test locally with `docker compose up` to verify appearance +- Check date format, filename format, and image paths +- Only search for advanced features if frontmatter or markdown error messages appear diff --git a/.github/instructions/yaml-configuration.instructions.md b/.github/instructions/yaml-configuration.instructions.md new file mode 100644 index 0000000..10a074f --- /dev/null +++ b/.github/instructions/yaml-configuration.instructions.md @@ -0,0 +1,250 @@ +--- +applyTo: "_config.yml,_data/**/*.yml" +--- + +# YAML Configuration Instructions + +## YAML Configuration (\_config.yml) + +### Critical Settings for Agents + +When modifying `_config.yml`, always update these in pairs: + +- **url** and **baseurl** must be consistent: + - Personal site: `url: https://username.github.io`, `baseurl:` (leave empty) + - Project site: `url: https://username.github.io`, `baseurl: /projectname/` +- **title, first_name, last_name** – Site header and metadata +- **description** – Used in RSS feeds and metadata +- **lang** – Language code (e.g., "en", "fr") + +### Feature Flags in \_config.yml + +Look for `enabled: false/true` patterns. Common ones: + +- `blog.enabled` +- `news.enabled` +- `profile.image_circular` +- `profile.show_social_links` +- `projects.enabled` +- `publications.enabled` +- `related_blog_posts` + +### YAML Syntax Rules + +- Quote string values containing special characters: `":"` +- Use `>` for multi-line strings (ignore newlines) +- Use `|` for multi-line strings (preserve newlines) +- Indentation matters: always use spaces (2 spaces), never tabs +- No tabs allowed; use only spaces + +### Testing YAML Syntax + +If you modify `_config.yml`, verify syntax by running: + +```bash +docker compose up +# Site should start without YAML parse errors +# Check output for "YAML parse error" or "valid YAML" +``` + +## Data Files (\_data/\*.yml) + +Data files provide structured content that templates can access via Liquid. Each file serves a specific purpose. + +### socials.yml + +Defines social media links and contact information displayed on the site. + +**Format:** Entries are displayed in the order they are defined (not alphabetically sorted) + +**For standard socials:** Use the key with the appropriate value. Common built-in socials include: + +- `email:` – Email address +- `cv_pdf:` – Path to CV PDF file +- `scholar_userid:` – Google Scholar ID +- `inspirehep_id:` – Inspire HEP author ID +- `rss_icon:` – Boolean to show/hide RSS icon +- And many others (see [jekyll-socials documentation](https://github.com/george-gca/jekyll-socials) for full list) + +**For custom socials:** Define a custom entry with nested fields: + +- `logo:` – URL or path to logo image +- `title:` – Display name +- `url:` – Profile or website URL + +**Example:** + +```yaml +cv_pdf: /assets/pdf/example_pdf.pdf +email: you@example.com +scholar_userid: qc6CJjYAAAAJ +github_username: username +linkedin_username: username + +custom_social: + logo: https://example.com/logo.png + title: Custom Profile + url: https://example.com/ +``` + +For more information, see the [jekyll-socials documentation](https://github.com/george-gca/jekyll-socials). + +### cv.yml + +CV content in **RenderCV format** (recommended approach for generating professional CVs). + +**Format:** [RenderCV](https://rendercv.com/) YAML format β€” human-readable and designed specifically for professional resumes with automatic PDF generation capability. + +**Key Files:** + +- [`_data/cv.yml`](_data/cv.yml) β€” Main CV content in RenderCV format +- [`assets/rendercv/design.yaml`](assets/rendercv/design.yaml) β€” Design and styling customization +- [`assets/rendercv/locale.yaml`](assets/rendercv/locale.yaml) β€” Localization and text formatting +- [`assets/rendercv/settings.yaml`](assets/rendercv/settings.yaml) β€” RenderCV-specific settings + +**Usage:** Rendered by `cv.liquid` layout on CV page; displayed in `about.liquid` on home page. + +**Automatic PDF Generation:** When using RenderCV format, a GitHub Actions workflow (`render-cv.yml`) automatically generates a PDF version whenever you push changes to `_data/cv.yml`. The generated PDF is saved to `assets/rendercv/rendercv_output/` and can be linked via `cv_pdf` setting in `_config.yml`. + +**Alternative Format (JSONResume):** For an alternative format, see `assets/json/resume.json` which uses the [JSONResume](https://jsonresume.org/) standard. Switch between formats using the `cv_format` frontmatter variable in `_pages/cv.md` (options: `rendercv` or `jsonresume`). + +**For more details:** See [CUSTOMIZE.md Β§ Modifying the CV information](CUSTOMIZE.md#modifying-the-cv-information) for setup, switching formats, and PDF generation configuration. + +### citations.yml + +Social media citation counts and metrics. + +**Format:** Varies by platform (Google Scholar, ORCID, etc.) + +**Example:** + +```yaml +scholar_userid: YOUR_SCHOLAR_ID +``` + +### repositories.yml + +GitHub repository listing for the repositories page. + +**Format:** List of repository information + +**Usage:** Used by repositories page to display GitHub projects + +### coauthors.yml + +Co-author information for bibliography/publications. + +**Mapping:** Author names to profile URLs and affiliations + +**Format:** Maps full names to contact info + +**Example:** + +```yaml +"Einstein, Albert": + url: https://en.wikipedia.org/wiki/Albert_Einstein + affiliation: Princeton University +``` + +## Common Modification Patterns + +### Adding a New Feature Flag + +1. Add to `_config.yml`: + + ```yaml + my_feature: + enabled: true + ``` + +2. In Liquid templates use: + + ```liquid + {% if site.my_feature.enabled %} + ... content ... + {% endif %} + ``` + +3. Document the flag in CUSTOMIZE.md + +### Updating Social Media Links + +1. Edit `_data/socials.yml` +2. Keep entries alphabetically sorted +3. Ensure `icon` identifiers match available icons (Academicons or Font Awesome) +4. Use full profile URLs in `url` field +5. Test: `docker compose up` β†’ check social icons on site + +### Modifying Site Metadata + +Update these in `_config.yml`: + +- **title** – Site name +- **first_name, last_name** – Your name +- **email** – Contact email +- **description** – Site tagline (used in RSS, metadata) +- **keywords** – Search keywords + +### Adding Co-authors + +1. Edit `_data/coauthors.yml` +2. Add entry with author name as key +3. Include `url:` and `affiliation:` fields +4. This maps author names in BibTeX to profile links + +## Validation Before Committing + +**Always run these checks:** + +1. **YAML syntax check:** + + ```bash + # Run Jekyll build to validate YAML + docker compose down + docker compose up + # Wait for "Server running" message + # Check output for "YAML parse error" messages + ``` + +2. **Prettier format check:** + + ```bash + npx prettier _config.yml _data/ --check + npx prettier . --write # Fix formatting + ``` + +3. **Visual verification:** + - Open http://localhost:8080 + - Check that your changes appear correctly + - Verify navigation, social links, and metadata work + - Check site title and description in page source + +## Common Issues + +### "YAML parse error" + +- Check for unquoted special characters (`:`, `&`, `#`, `|`, `>`) +- Verify indentation uses only spaces (2 spaces per level) +- Ensure closing quotes and braces are present + +### Feature flag not working + +- Check syntax: `feature: enabled: true` (colon after feature name) +- Verify spelling in Liquid template: `{% if site.feature.enabled %}` +- Clear browser cache if using old cached pages + +### Social links not appearing + +- Verify `_data/socials.yml` has correct entries +- Check icon identifiers exist in Font Awesome or Academicons +- Ensure `url:` field is not empty + +## Trust These Instructions + +When working with YAML configuration: + +- Always test locally with `docker compose up` after changes +- Quote any string containing special characters +- Keep indentation consistent (2 spaces) +- Check output for YAML parse errors before committing +- Only search for additional details if encountering error messages not mentioned here diff --git a/.github/release.yml b/.github/release.yml new file mode 100644 index 0000000..4fdc27e --- /dev/null +++ b/.github/release.yml @@ -0,0 +1,14 @@ +changelog: + exclude: + labels: + - ignore-for-release + categories: + - title: new features πŸš€ + labels: + - enhancement + - title: bug fixes and improvements ✨ + labels: + - bug-fix + - title: other changes πŸ› οΈ + labels: + - "*" diff --git a/.github/workflows/axe.yml b/.github/workflows/axe.yml new file mode 100644 index 0000000..afa3c92 --- /dev/null +++ b/.github/workflows/axe.yml @@ -0,0 +1,74 @@ +name: Axe accessibility testing + +on: + # if you want to run this on every push uncomment the following lines + # push: + # branches: + # - master + # - main + # pull_request: + # branches: + # - master + # - main + workflow_dispatch: + inputs: + url: + description: "URL to be checked (e.g.: blog/)" + required: false + +env: + URL: "" + +jobs: + check: + # available images: https://github.com/actions/runner-images#available-images + runs-on: ubuntu-latest + steps: + - name: Checkout πŸ›ŽοΈ + uses: actions/checkout@v4 + - name: Setup Ruby + uses: ruby/setup-ruby@v1 + with: + ruby-version: "3.2.2" + bundler-cache: true + - name: Update _config.yml βš™οΈ + uses: fjogeleit/yaml-update-action@main + with: + commitChange: false + valueFile: "_config.yml" + changes: | + { + "giscus.repo": "${{ github.repository }}", + "baseurl": "" + } + - name: Install and Build πŸ”§ + run: | + sudo apt-get update && sudo apt-get install -y imagemagick + pip3 install --upgrade jupyter + export JEKYLL_ENV=production + bundle exec jekyll build + - name: Purge unused CSS 🧹 + run: | + npm install -g purgecss + purgecss -c purgecss.config.js + - name: Get Chromium version 🌐 + # https://github.com/GoogleChromeLabs/chrome-for-testing?tab=readme-ov-file#other-api-endpoints + run: | + CHROMIUM_VERSION=$(wget -qO- https://googlechromelabs.github.io/chrome-for-testing/LATEST_RELEASE_STABLE | cut -d. -f1) + echo "Chromium version: $CHROMIUM_VERSION" + echo "CHROMIUM_VERSION=$CHROMIUM_VERSION" >> $GITHUB_ENV + - name: Setup Chrome 🌐 + id: setup-chrome + uses: browser-actions/setup-chrome@v1 + with: + chrome-version: ${{ env.CHROMIUM_VERSION }} + - name: Install chromedriver πŸš— + run: | + npm install -g chromedriver@$CHROMIUM_VERSION + - name: Run axe πŸͺ“ + # https://github.com/dequelabs/axe-core-npm/tree/develop/packages/cli + run: | + npm install -g @axe-core/cli + npm install -g http-server + http-server _site/ & + axe --chromedriver-path $(npm root -g)/chromedriver/bin/chromedriver http://localhost:8080/${{ github.event.inputs.url || env.URL }} --load-delay=1500 --exit diff --git a/.github/workflows/broken-links-site.yml b/.github/workflows/broken-links-site.yml new file mode 100644 index 0000000..a62684d --- /dev/null +++ b/.github/workflows/broken-links-site.yml @@ -0,0 +1,47 @@ +name: Check for broken links on site + +on: + workflow_run: + workflows: [Deploy site] + types: [completed] + +jobs: + check-links-on-site: + # https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#running-a-workflow-based-on-the-conclusion-of-another-workflow + if: ${{ github.event.workflow_run.conclusion == 'success' }} + # available images: https://github.com/actions/runner-images#available-images + runs-on: ubuntu-latest + steps: + - name: Checkout πŸ›ŽοΈ + uses: actions/checkout@v4 + - name: Setup Ruby + uses: ruby/setup-ruby@v1 + with: + ruby-version: "3.2.2" + bundler-cache: true + - name: Update _config.yml βš™οΈ + uses: fjogeleit/yaml-update-action@main + with: + commitChange: false + valueFile: "_config.yml" + changes: | + { + "giscus.repo": "${{ github.repository }}", + "baseurl": "" + } + - name: Install and Build πŸ”§ + run: | + sudo apt-get update && sudo apt-get install -y imagemagick + pip3 install --upgrade jupyter + export JEKYLL_ENV=production + bundle exec jekyll build + - name: Purge unused CSS 🧹 + run: | + npm install -g purgecss + purgecss -c purgecss.config.js + - name: Link Checker πŸ”— + uses: lycheeverse/lychee-action@v2.0.2 + with: + fail: true + # only check local links + args: --offline --remap '_site(/?.*)/assets/(.*) _site/assets/$2' --verbose --no-progress '_site/**/*.html' diff --git a/.github/workflows/broken-links.yml b/.github/workflows/broken-links.yml new file mode 100644 index 0000000..ce7b9e8 --- /dev/null +++ b/.github/workflows/broken-links.yml @@ -0,0 +1,54 @@ +name: Check for broken links + +on: + push: + branches: + - master + - main + paths: + - "assets/**" + - "**.html" + - "**.js" + - "**.liquid" + - "**/*.md" + - "**.yml" + - "!.github/workflows/axe.yml" + - "!.github/workflows/deploy-docker-tag.yml" + - "!.github/workflows/deploy-image.yml" + - "!.github/workflows/docker-slim.yml" + - "!.github/workflows/lighthouse-badger.yml" + - "!.github/workflows/prettier.yml" + - "!lighthouse_results/**" + pull_request: + branches: + - master + - main + paths: + - "assets/**" + - "**.html" + - "**.js" + - "**.liquid" + - "**/*.md" + - "**.yml" + - "!.github/workflows/axe.yml" + - "!.github/workflows/deploy-docker-tag.yml" + - "!.github/workflows/deploy-image.yml" + - "!.github/workflows/docker-slim.yml" + - "!.github/workflows/lighthouse-badger.yml" + - "!.github/workflows/prettier.yml" + - "!lighthouse_results/**" + +jobs: + link-checker: + runs-on: ubuntu-latest + # only run on the main repo + if: github.repository == 'alshedivat/al-folio' + steps: + - uses: actions/checkout@v4 + + - name: Link Checker πŸ”— + uses: lycheeverse/lychee-action@v2.0.2 + with: + fail: true + # removed md files that include liquid tags + args: --user-agent 'curl/7.54' --exclude-path README.md --exclude-path _pages/404.md --exclude-path _pages/blog.md --exclude-path _posts/2018-12-22-distill.md --exclude-path _posts/2023-04-24-videos.md --exclude-path _books/the_godfather.md --exclude-path .github/instructions/bibtex-bibliography.instructions.md --exclude-path .github/instructions/yaml-configuration.instructions.md --exclude-path .github/instructions/markdown-content.instructions.md --exclude-path .github/instructions/liquid-templates.instructions.md --exclude-path AGENTS.md --exclude-path SEO.md --verbose --no-progress './**/*.md' './**/*.html' diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml new file mode 100644 index 0000000..d09a3b5 --- /dev/null +++ b/.github/workflows/codeql.yml @@ -0,0 +1,94 @@ +# For most projects, this workflow file will not need changing; you simply need +# to commit it to your repository. +# +# You may wish to alter this file to override the set of languages analyzed, +# or to provide custom queries or build logic. +# +# ******** NOTE ******** +# We have attempted to detect the languages in your repository. Please check +# the `language` matrix defined below to confirm you have the correct set of +# supported CodeQL languages. +# +name: "CodeQL Advanced" + +on: + push: + branches: ["main"] + pull_request: + branches: ["main"] + schedule: + - cron: "45 4 * * 3" + +jobs: + analyze: + name: Analyze (${{ matrix.language }}) + # Runner size impacts CodeQL analysis time. To learn more, please see: + # - https://gh.io/recommended-hardware-resources-for-running-codeql + # - https://gh.io/supported-runners-and-hardware-resources + # - https://gh.io/using-larger-runners (GitHub.com only) + # Consider using larger runners or machines with greater resources for possible analysis time improvements. + runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }} + permissions: + # required for all workflows + security-events: write + + # required to fetch internal or private CodeQL packs + packages: read + + # only required for workflows in private repositories + actions: read + contents: read + + strategy: + fail-fast: false + matrix: + include: + - language: javascript-typescript + build-mode: none + - language: ruby + build-mode: none + # CodeQL supports the following values keywords for 'language': 'c-cpp', 'csharp', 'go', 'java-kotlin', 'javascript-typescript', 'python', 'ruby', 'swift' + # Use `c-cpp` to analyze code written in C, C++ or both + # Use 'java-kotlin' to analyze code written in Java, Kotlin or both + # Use 'javascript-typescript' to analyze code written in JavaScript, TypeScript or both + # To learn more about changing the languages that are analyzed or customizing the build mode for your analysis, + # see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning. + # If you are analyzing a compiled language, you can modify the 'build-mode' for that language to customize how + # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages + steps: + - name: Checkout repository + uses: actions/checkout@v4 + + # Initializes the CodeQL tools for scanning. + - name: Initialize CodeQL + uses: github/codeql-action/init@v3 + with: + languages: ${{ matrix.language }} + build-mode: ${{ matrix.build-mode }} + # If you wish to specify custom queries, you can do so here or in a config file. + # By default, queries listed here will override any specified in a config file. + # Prefix the list here with "+" to use these queries and those in the config file. + + # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs + # queries: security-extended,security-and-quality + + # If the analyze step fails for one of the languages you are analyzing with + # "We were unable to automatically build your code", modify the matrix above + # to set the build mode to "manual" for that language. Then modify this step + # to build your code. + # ℹ️ Command-line programs to run using the OS shell. + # πŸ“š See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun + - if: matrix.build-mode == 'manual' + shell: bash + run: | + echo 'If you are using a "manual" build mode for one or more of the' \ + 'languages you are analyzing, replace this with the commands to build' \ + 'your code, for example:' + echo ' make bootstrap' + echo ' make release' + exit 1 + + - name: Perform CodeQL Analysis + uses: github/codeql-action/analyze@v3 + with: + category: "/language:${{matrix.language}}" diff --git a/.github/workflows/copilot-setup-steps.yml b/.github/workflows/copilot-setup-steps.yml new file mode 100644 index 0000000..e1b652e --- /dev/null +++ b/.github/workflows/copilot-setup-steps.yml @@ -0,0 +1,58 @@ +name: "Copilot Setup Steps" + +# Automatically run the setup steps when they are changed to allow for easy validation, and +# allow manual testing through the repository's "Actions" tab +on: + workflow_dispatch: + push: + paths: + - .github/workflows/copilot-setup-steps.yml + pull_request: + paths: + - .github/workflows/copilot-setup-steps.yml + +jobs: + # The job MUST be called `copilot-setup-steps` or it will not be picked up by Copilot. + copilot-setup-steps: + runs-on: ubuntu-latest + + # Set the permissions to the lowest permissions possible needed for your steps. + # Copilot will be given its own token for its operations. + permissions: + contents: read + + # You can define any steps you want, and they will run before the agent starts. + # If you do not check out your code, Copilot will do this for you. + steps: + - name: Checkout code + uses: actions/checkout@v4 + + - name: Setup Ruby + uses: ruby/setup-ruby@v1 + with: + ruby-version: "3.3.5" + bundler-cache: true + + - name: Setup Python + uses: actions/setup-python@v5 + with: + python-version: "3.13" + cache: "pip" + + - name: Setup Node.js + uses: actions/setup-node@v4 + with: + node-version: "latest" + cache: "npm" + + - name: Install system dependencies + run: | + sudo apt-get update + sudo apt-get install -y imagemagick + + - name: Install Python dependencies + run: | + pip3 install --upgrade nbconvert + + - name: Install Node.js dependencies + run: npm ci diff --git a/.github/workflows/deploy-docker-tag.yml b/.github/workflows/deploy-docker-tag.yml index 3e6b6a3..d7710e2 100644 --- a/.github/workflows/deploy-docker-tag.yml +++ b/.github/workflows/deploy-docker-tag.yml @@ -3,38 +3,48 @@ name: Docker Image CI (Upload Tag) on: push: tags: - - 'v*' + - "v*" + paths: + - ".github/workflows/deploy-docker-tag.yml" + - ".github/workflows/deploy-image.yml" + - "bin/entry_point.sh" + - "Dockerfile" + - "Gemfile" + - "Gemfile.lock" + - "package.json" + - "package-lock.json" jobs: - build: - runs-on: ubuntu-latest steps: - - name: Checkout - uses: actions/checkout@v2 - - name: Buildx - uses: docker/setup-buildx-action@v1 + - name: Checkout + uses: actions/checkout@v4 - - - name: Docker meta - id: meta - uses: docker/metadata-action@v4 - with: - images: amirpourmand/al-folio + - name: Set up QEMU + uses: docker/setup-qemu-action@v3 - - name: Login - uses: docker/login-action@v1 - with: - username: ${{ secrets.DOCKER_USERNAME }} - password: ${{ secrets.DOCKER_PASSWORD }} + - name: Buildx + uses: docker/setup-buildx-action@v3 - - name: Build and push - uses: docker/build-push-action@v3 - with: - context: . - push: ${{ github.event_name != 'pull_request' }} - tags: ${{ steps.meta.outputs.tags }} - labels: ${{ steps.meta.outputs.labels }} + - name: Docker meta + id: meta + uses: docker/metadata-action@v5 + with: + images: amirpourmand/al-folio + - name: Login + uses: docker/login-action@v3 + with: + username: ${{ secrets.DOCKER_USERNAME }} + password: ${{ secrets.DOCKER_PASSWORD }} + + - name: Build and push + uses: docker/build-push-action@v5 + with: + context: . + platforms: linux/amd64,linux/arm64/v8 + push: ${{ github.event_name != 'pull_request' }} + tags: ${{ steps.meta.outputs.tags }} + labels: ${{ steps.meta.outputs.labels }} diff --git a/.github/workflows/deploy-image.yml b/.github/workflows/deploy-image.yml index b747dfc..7ddd8f6 100644 --- a/.github/workflows/deploy-image.yml +++ b/.github/workflows/deploy-image.yml @@ -2,30 +2,43 @@ name: Docker Image CI on: push: - branches: [ master ] - -jobs: + branches: + - master + - main + paths: + - ".github/workflows/deploy-image.yml" + - "bin/entry_point.sh" + - "Dockerfile" + - "Gemfile" + - "Gemfile.lock" + - "package.json" + - "package-lock.json" +jobs: build: - runs-on: ubuntu-latest if: github.repository_owner == 'alshedivat' steps: - - name: Checkout - uses: actions/checkout@v2 - - name: Buildx - uses: docker/setup-buildx-action@v1 + - name: Checkout + uses: actions/checkout@v4 - - name: Login - uses: docker/login-action@v1 - with: - username: ${{ secrets.DOCKER_USERNAME }} - password: ${{ secrets.DOCKER_PASSWORD }} - - - name: Build and push - uses: docker/build-push-action@v2 - with: - context: . - push: true - tags: amirpourmand/al-folio + - name: Set up QEMU + uses: docker/setup-qemu-action@v3 + + - name: Buildx + uses: docker/setup-buildx-action@v3 + + - name: Login + uses: docker/login-action@v3 + with: + username: ${{ secrets.DOCKER_USERNAME }} + password: ${{ secrets.DOCKER_PASSWORD }} + + - name: Build and push + uses: docker/build-push-action@v5 + with: + context: . + push: true + platforms: linux/amd64,linux/arm64/v8 + tags: amirpourmand/al-folio diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml index 0301f08..5fb7e8a 100644 --- a/.github/workflows/deploy.yml +++ b/.github/workflows/deploy.yml @@ -1,42 +1,105 @@ -name: deploy +name: Deploy site on: push: branches: - master - main + paths: + - "assets/**" + - "_sass/**" + - "_scripts/**" + - "**.bib" + - "**.html" + - "**.js" + - "**.liquid" + - "**/*.md" + - "**.yml" + - "Gemfile" + - "Gemfile.lock" + - "!.github/workflows/axe.yml" + - "!.github/workflows/broken-links.yml" + - "!.github/workflows/deploy-docker-tag.yml" + - "!.github/workflows/deploy-image.yml" + - "!.github/workflows/docker-slim.yml" + - "!.github/workflows/lighthouse-badger.yml" + - "!.github/workflows/prettier.yml" + - "!lighthouse_results/**" + - "!CONTRIBUTING.md" + - "!CUSTOMIZE.md" + - "!FAQ.md" + - "!INSTALL.md" + - "!README.md" pull_request: branches: - master - main + paths: + - "assets/**" + - "_sass/**" + - "_scripts/**" + - "**.bib" + - "**.html" + - "**.js" + - "**.liquid" + - "**/*.md" + - "**.yml" + - "Gemfile" + - "Gemfile.lock" + - "!.github/workflows/axe.yml" + - "!.github/workflows/broken-links.yml" + - "!.github/workflows/deploy-docker-tag.yml" + - "!.github/workflows/deploy-image.yml" + - "!.github/workflows/docker-slim.yml" + - "!.github/workflows/lighthouse-badger.yml" + - "!.github/workflows/prettier.yml" + - "!lighthouse_results/**" + - "!CONTRIBUTING.md" + - "!CUSTOMIZE.md" + - "!FAQ.md" + - "!INSTALL.md" + - "!README.md" + workflow_dispatch: + +permissions: + contents: write jobs: deploy: + # available images: https://github.com/actions/runner-images#available-images runs-on: ubuntu-latest steps: - - name: Checkout code - uses: actions/checkout@v3 - - name: Setup Ruby - uses: ruby/setup-ruby@v1 - with: - ruby-version: '3.0.2' - bundler-cache: true - - name: Install deps - run: | - npm install -g mermaid.cli - - name: Setup deploy options - id: setup - run: | - git config --global user.name "GitHub Action" - git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com" - if [[ ${GITHUB_REF} = refs/pull/*/merge ]]; then # pull request - echo "SRC_BRANCH=${GITHUB_HEAD_REF}" >> $GITHUB_OUTPUT - echo "NO_PUSH=--no-push" >> $GITHUB_OUTPUT - elif [[ ${GITHUB_REF} = refs/heads/* ]]; then # branch, e.g. master, source etc - echo "SRC_BRANCH=${GITHUB_REF#refs/heads/}" >> $GITHUB_OUTPUT - fi - echo "DEPLOY_BRANCH=gh-pages" >> $GITHUB_OUTPUT - - name: Deploy website - run: yes | bash bin/deploy --verbose ${{ steps.setup.outputs.NO_PUSH }} - --src ${{ steps.setup.outputs.SRC_BRANCH }} - --deploy ${{ steps.setup.outputs.DEPLOY_BRANCH }} + - name: Checkout πŸ›ŽοΈ + uses: actions/checkout@v4 + - name: Setup Ruby πŸ’Ž + uses: ruby/setup-ruby@v1 + with: + ruby-version: "3.3.5" + bundler-cache: true + - name: Setup Python 🐍 + uses: actions/setup-python@v5 + with: + python-version: "3.13" + cache: "pip" # caching pip dependencies + - name: Update _config.yml βš™οΈ + uses: fjogeleit/yaml-update-action@main + with: + commitChange: false + valueFile: "_config.yml" + propertyPath: "giscus.repo" + value: ${{ github.repository }} + - name: Install and Build πŸ”§ + run: | + sudo apt-get update && sudo apt-get install -y imagemagick + pip3 install --upgrade nbconvert + export JEKYLL_ENV=production + bundle exec jekyll build + - name: Purge unused CSS 🧹 + run: | + npm install -g purgecss + purgecss -c purgecss.config.js + - name: Deploy πŸš€ + if: github.event_name != 'pull_request' + uses: JamesIves/github-pages-deploy-action@v4 + with: + folder: _site diff --git a/.github/workflows/docker-slim.yml b/.github/workflows/docker-slim.yml new file mode 100644 index 0000000..b342ef6 --- /dev/null +++ b/.github/workflows/docker-slim.yml @@ -0,0 +1,53 @@ +name: Docker Slim + +#Only trigger, when the build workflow succeeded +on: + push: + branches: + - master + - main + paths: + - ".github/workflows/docker-slim.yml" + workflow_run: + workflows: ["Docker Image CI"] + types: + - completed + workflow_dispatch: + +jobs: + build: + # https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#running-a-workflow-based-on-the-conclusion-of-another-workflow + if: ${{ github.event.workflow_run.conclusion == 'success' && github.repository_owner == 'alshedivat' }} + runs-on: ubuntu-latest + defaults: + run: + working-directory: ${{ github.workspace }} + + steps: + - name: Checkout + uses: actions/checkout@v4 + + - name: Login + uses: docker/login-action@v3 + with: + username: ${{ secrets.DOCKER_USERNAME }} + password: ${{ secrets.DOCKER_PASSWORD }} + + - name: update docker-compose + shell: bash + run: | + sed -i "s|\.:|${{ github.workspace }}:|g" ${{ github.workspace }}/docker-compose.yml + cat ${{ github.workspace }}/docker-compose.yml + + - uses: kitabisa/docker-slim-action@v1.2.0 + env: + DSLIM_PULL: true + DSLIM_COMPOSE_FILE: ${{ github.workspace }}/docker-compose.yml + DSLIM_TARGET_COMPOSE_SVC: jekyll + DSLIM_CONTINUE_AFTER: signal + with: + target: amirpourmand/al-folio + tag: "slim" + + # Push to the registry + - run: docker image push amirpourmand/al-folio:slim diff --git a/.github/workflows/lighthouse-badger.yml b/.github/workflows/lighthouse-badger.yml new file mode 100644 index 0000000..addec2d --- /dev/null +++ b/.github/workflows/lighthouse-badger.yml @@ -0,0 +1,62 @@ +# Lighthouse-Badger-Easy | GitHub Action Workflow +# +# Description: Generates, adds & updates manually/automatically Lighthouse badges & reports from one/multiple input URL(s) to the current repository & main branch with minimal settings +# Author: Sitdisch +# Source: https://github.com/myactionway/lighthouse-badger-workflows +# License: MIT +# Copyright (c) 2021 Sitdisch + +name: "Lighthouse Badger" + +######################################################################## +# DEFINE YOUR INPUTS AND TRIGGERS IN THE FOLLOWING +######################################################################## + +# INPUTS as Secrets (env) for not manually triggered workflows +env: + URLS: https://alshedivat.github.io/al-folio/ + # If any of the following env is blank, a default value is used instead + REPO_BRANCH: "${{ github.repository }} master" # target repository & branch e.g. 'dummy/mytargetrepo main' + MOBILE_LIGHTHOUSE_PARAMS: "--only-categories=performance,accessibility,best-practices,seo --throttling.cpuSlowdownMultiplier=2" + DESKTOP_LIGHTHOUSE_PARAMS: "--only-categories=performance,accessibility,best-practices,seo --preset=desktop --throttling.cpuSlowdownMultiplier=1" + +# TRIGGERS +on: + page_build: + # schedule: # Check your schedule here => https://crontab.guru/ + # - cron: '55 23 * * 0' # e.g. every Sunday at 23:55 + # + # THAT'S IT; YOU'RE DONE; + workflow_dispatch: + +######################################################################## +# THAT'S IT; YOU DON'T HAVE TO DEFINE ANYTHING IN THE FOLLOWING +######################################################################## + +jobs: + lighthouse-badger-easy: + runs-on: ubuntu-latest + timeout-minutes: 8 + steps: + - name: Preparatory Tasks + run: | + REPOSITORY=`expr "${{ env.REPO_BRANCH }}" : "\([^ ]*\)"` + BRANCH=`expr "${{ env.REPO_BRANCH }}" : ".* \([^ ]*\)"` + echo "REPOSITORY=$REPOSITORY" >> $GITHUB_ENV + echo "BRANCH=$BRANCH" >> $GITHUB_ENV + env: + REPO_BRANCH: ${{ env.REPO_BRANCH }} + - uses: actions/checkout@v4 + with: + repository: ${{ env.REPOSITORY }} + token: ${{ secrets.LIGHTHOUSE_BADGER_TOKEN }} + ref: ${{ env.BRANCH }} + - uses: actions/checkout@v4 + with: + repository: "myactionway/lighthouse-badges" + path: temp_lighthouse_badges_nested + - uses: myactionway/lighthouse-badger-action@v2.2 + with: + urls: ${{ env.URLS }} + mobile_lighthouse_params: ${{ env.MOBILE_LIGHTHOUSE_PARAMS }} + desktop_lighthouse_params: ${{ env.DESKTOP_LIGHTHOUSE_PARAMS }} diff --git a/.github/workflows/prettier-comment-on-pr.yml b/.github/workflows/prettier-comment-on-pr.yml new file mode 100644 index 0000000..e95075c --- /dev/null +++ b/.github/workflows/prettier-comment-on-pr.yml @@ -0,0 +1,18 @@ +name: Comment on pull request + +on: + repository_dispatch: + types: [prettier-failed-on-pr] + +jobs: + comment: + # available images: https://github.com/actions/runner-images#available-images + runs-on: ubuntu-latest + steps: + - name: PR comment with html diff πŸ’¬ + uses: thollander/actions-comment-pull-request@v2 + with: + comment_tag: prettier-failed + pr_number: ${{ github.event.client_payload.pr_number }} + message: | + Failed [prettier code check](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.event.client_payload.run_id }}). Check [this file](${{ github.event.client_payload.artifact_url }}) for more information. diff --git a/.github/workflows/prettier-html.yml b/.github/workflows/prettier-html.yml new file mode 100644 index 0000000..3dc4326 --- /dev/null +++ b/.github/workflows/prettier-html.yml @@ -0,0 +1,36 @@ +name: Prettify gh-pages + +on: + workflow_dispatch: + +jobs: + format: + runs-on: ubuntu-latest + steps: + - name: Checkout gh-pages branch + uses: actions/checkout@v4 + with: + ref: gh-pages + + - name: Find and Remove Tags + run: find . -type f -name "*.html" -exec sed -i 's/<\/source>//g' {} + + + - name: Set up Node.js + uses: actions/setup-node@v4 + + - name: Install Prettier + run: npm install -g prettier + + - name: Check for Prettier + run: npx prettier --version || echo "Prettier not found" + + - name: Run Prettier on HTML files + run: npx prettier --write '**/*.html' + + - name: Commit and push changes + run: | + git config user.name "github-actions" + git config user.email "actions@github.com" + git add . + git commit -m "Formatted HTML files" || echo "No changes to commit" + git push diff --git a/.github/workflows/prettier.yml b/.github/workflows/prettier.yml new file mode 100644 index 0000000..60446c8 --- /dev/null +++ b/.github/workflows/prettier.yml @@ -0,0 +1,48 @@ +name: Prettier code formatter + +on: + pull_request: + branches: + - master + - main + push: + branches: + - master + - main + +jobs: + check: + # available images: https://github.com/actions/runner-images#available-images + runs-on: ubuntu-latest + steps: + - name: Checkout πŸ›ŽοΈ + uses: actions/checkout@v4 + - name: Setup Node.js βš™οΈ + uses: actions/setup-node@v4 + - name: Install Prettier πŸ’Ύ + run: npm install --save-dev --save-exact prettier @shopify/prettier-plugin-liquid + - name: Prettier Check πŸ”Ž + id: prettier + run: npx prettier . --check + - name: Create diff πŸ“ + # https://docs.github.com/en/actions/learn-github-actions/expressions#failure + if: ${{ failure() }} + run: | + npx prettier . --write + git diff -- . ':(exclude)package-lock.json' ':(exclude)package.json' > diff.txt + npm install -g diff2html-cli + diff2html -i file -s side -F diff.html -- diff.txt + - name: Upload html diff ⬆️ + id: artifact-upload + if: ${{ failure() && steps.prettier.conclusion == 'failure' }} + uses: actions/upload-artifact@v4 + with: + name: HTML Diff + path: diff.html + retention-days: 7 + - name: Dispatch information to repository πŸ—£οΈ + if: ${{ failure() && steps.prettier.conclusion == 'failure' && github.event_name == 'pull_request' }} + uses: peter-evans/repository-dispatch@v2 + with: + event-type: prettier-failed-on-pr + client-payload: '{"pr_number": "${{ github.event.number }}", "artifact_url": "${{ steps.artifact-upload.outputs.artifact-url }}", "run_id": "${{ github.run_id }}"}' diff --git a/.github/workflows/render-cv.yml b/.github/workflows/render-cv.yml new file mode 100644 index 0000000..af2c558 --- /dev/null +++ b/.github/workflows/render-cv.yml @@ -0,0 +1,58 @@ +name: Render a CV +on: + push: + branches: + - main + - master + paths: + - "_data/cv.yml" + - "assets/rendercv/design.yaml" + - "assets/rendercv/locale.yaml" + - "assets/rendercv/settings.yaml" + workflow_call: + workflow_dispatch: +permissions: + contents: write +jobs: + rendercv: + name: RenderCV + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: "3.12" + - name: Install RenderCV + run: | + pip install -r requirements.txt + - name: RenderCV + run: | + cv_file=$(find _data -maxdepth 1 -type f \( -name "cv.yaml" -o -name "cv.yml" \)) + if [ -z "$cv_file" ]; then + echo "No cv.yml file found!" + exit 1 + fi + rendercv_dir=$(find assets -maxdepth 1 -type d -name "rendercv") + if [ -z "$rendercv_dir" ]; then + echo "No RenderCV config directory found!" + exit 1 + fi + settings=$(find $rendercv_dir -maxdepth 1 -type f \( -name "settings.yaml" -o -name "settings.yml" \)) + if [ -z "$settings" ]; then + echo "Missing RenderCV config file!" + exit 1 + fi + rendercv render $cv_file --settings $settings + rm assets/rendercv/rendercv_output/*.typ + - name: Upload rendercv_output as an artifact + uses: actions/upload-artifact@v4 + with: + name: RenderCV Output + path: assets/rendercv/rendercv_output + - name: Push the changes + run: | + git config --global user.name "${{ github.actor }}" + git config --global user.email "${{ github.actor }}@users.noreply.github.com" + git add -A + git commit -m "chore: render the latest CV" + git push diff --git a/.github/workflows/schedule-posts.txt b/.github/workflows/schedule-posts.txt new file mode 100644 index 0000000..57728bc --- /dev/null +++ b/.github/workflows/schedule-posts.txt @@ -0,0 +1,39 @@ +name: Publish posts scheduled for today + +on: + schedule: + # Run every day at 23:30 UTC or manually run + - cron: "30 23 * * *" + workflow_dispatch: + +jobs: + publish_scheduled: + runs-on: ubuntu-latest + steps: + - name: Checkout main branch + uses: actions/checkout@v4 + with: + ref: main + + - name: Get the date for today + id: date + run: echo "TODAY=$(date +'%Y-%m-%d')" >> $GITHUB_ENV + + - name: Check for scheduled posts and move to posts + run: | + echo "Today is $TODAY" + shopt -s nullglob + for file in _scheduled/${TODAY}-*.md; do + echo "Found scheduled: $file" + mv "$file" "_posts/" + echo "Moved $file to _posts/" + done + + - name: Commit and push changes + run: | + git config user.name "github-actions" + git config user.email "actions@github.com" + git add _posts/ + git add _scheduled/ + git commit -m "Posted Scheduled Drafts on $TODAY" || echo "No changes to commit" + git push diff --git a/.github/workflows/update-citations.yml b/.github/workflows/update-citations.yml new file mode 100644 index 0000000..3335d7e --- /dev/null +++ b/.github/workflows/update-citations.yml @@ -0,0 +1,101 @@ +name: Update Google Scholar Citations + +on: + schedule: + - cron: "0 0 * * 1" # Monday + - cron: "0 0 * * 3" # Wednesday + - cron: "0 0 * * 5" # Friday + workflow_dispatch: + +jobs: + update-citations: + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v4 + # See CUSTOMIZE.md for details on how to set up PAT for triggering subsequent workflows + # with: + # token: ${{ secrets.PAT }} + + - name: Set up Python + uses: actions/setup-python@v4 + with: + python-version: "3.13" + + - name: Install dependencies + run: | + echo "πŸ”§ Installing dependencies..." + python -m pip install --upgrade pip + pip install -r requirements.txt + + - name: Save current citations.yml hash + id: before + run: | + echo "πŸ“¦ Checking existing citations.yml hash..." + if [ -f _data/citations.yml ]; then + sha_before=$(sha256sum _data/citations.yml | awk '{print $1}') + echo "sha_before=$sha_before" >> $GITHUB_OUTPUT + echo "πŸ“ SHA before: $sha_before" + else + echo "sha_before=none" >> $GITHUB_OUTPUT + echo "πŸ“ No existing citations.yml file found." + fi + + - name: Run citation update script + id: run_citation_update + shell: bash + run: | + set +e + echo "πŸš€ Running citation update script (single attempt)..." + start_time=$(date) + timeout 90 python bin/update_scholar_citations.py + status=$? + end_time=$(date) + if [ $status -eq 0 ]; then + echo "βœ… Citation update succeeded (started at $start_time, ended at $end_time)." + echo "βœ… Citation update succeeded." >> $GITHUB_STEP_SUMMARY + else + echo "❌ Citation update script failed with exit code $status (started at $start_time, ended at $end_time)." + echo "❌ Citation update script failed with exit code $status." >> $GITHUB_STEP_SUMMARY + fi + set -e + + - name: Save new citations.yml hash + id: after + run: | + echo "πŸ” Checking updated citations.yml hash..." + if [ -f _data/citations.yml ]; then + sha_after=$(sha256sum _data/citations.yml | awk '{print $1}') + echo "sha_after=$sha_after" >> $GITHUB_OUTPUT + echo "πŸ“ SHA after: $sha_after" + else + echo "sha_after=none" >> $GITHUB_OUTPUT + echo "πŸ“ citations.yml was not created or is missing." + fi + + - name: Report citations.yml change in summary + run: | + echo "πŸ“‹ Comparing citation file hashes..." + if [ "${{ steps.before.outputs.sha_before }}" != "${{ steps.after.outputs.sha_after }}" ]; then + echo "βœ… _data/citations.yml was updated." + echo "βœ… _data/citations.yml was updated." >> $GITHUB_STEP_SUMMARY + else + echo "ℹ️ _data/citations.yml was not changed." + echo "ℹ️ _data/citations.yml was not changed." >> $GITHUB_STEP_SUMMARY + fi + + - name: Configure Git + run: | + git config --local user.email "actions@github.com" + git config --local user.name "GitHub Actions" + echo "πŸ”§ Git configured." + + - name: Commit and push if changed + run: | + git add _data/citations.yml + git diff --staged --quiet || ( + echo "πŸ“€ Committing and pushing changes..." + git commit -m "Update Google Scholar citations" + git push + ) diff --git a/.github/workflows/update-tocs.yml b/.github/workflows/update-tocs.yml new file mode 100644 index 0000000..3567ee8 --- /dev/null +++ b/.github/workflows/update-tocs.yml @@ -0,0 +1,50 @@ +name: Update TOCs +# This workflow automatically updates the Table of Contents (TOC) in markdown files + +on: + push: + branches: + - main + - master + paths: + - "*.md" + workflow_dispatch: + +permissions: + contents: write + +jobs: + build: + runs-on: ubuntu-latest + timeout-minutes: 5 + steps: + - uses: actions/checkout@v4 + with: + fetch-depth: 0 # OR "2" -> To retrieve the preceding commit. + + - name: Get changed files + id: changed-files + uses: tj-actions/changed-files@ed68ef82c095e0d48ec87eccea555d944a631a4c # v46 + with: + files: ./*.md + + - name: Updated toc on all markdown changed files + env: + ALL_CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }} + run: | + curl https://raw.githubusercontent.com/george-gca/github-markdown-toc/main/gh-md-toc -o gh-md-toc + chmod a+x gh-md-toc + for file in ${ALL_CHANGED_FILES}; do + # Check if the file is a markdown file + if [[ "$file" != *.md ]]; then + continue + fi + ./gh-md-toc --indent 2 --insert --no-backup --hide-footer $file + done + rm gh-md-toc + + - name: Commit changes + if: steps.changed-files.outputs.any_changed == 'true' + uses: stefanzweifel/git-auto-commit-action@v5.0.1 + with: + commit_message: Auto update markdown TOC diff --git a/.gitignore b/.gitignore index b97cf91..1fee89b 100644 --- a/.gitignore +++ b/.gitignore @@ -1,11 +1,15 @@ _site .bundle -.sass-cache +.DS_store +.idea .jekyll-cache .jekyll-metadata -.DS_store .ruby-version +.sass-cache .tweet-cache +.venv +assets/libs/ +assets/rendercv/rendercv_output/*.typ Gemfile.lock -vendor - +node_modules/ +vendor \ No newline at end of file diff --git a/.lycheeignore b/.lycheeignore new file mode 100644 index 0000000..64194b5 --- /dev/null +++ b/.lycheeignore @@ -0,0 +1,14 @@ +.github/instructions/bibtex-bibliography.instructions.md +.github/instructions/liquid-templates.instructions.md +.github/instructions/markdown-content.instructions.md +.github/instructions/yaml-configuration.instructions.md +_books/the_godfather.md +_pages/404.md +_pages/blog.md +_posts/2018-12-22-distill.md +_posts/2023-04-24-videos.md +AGENTS.md +https://www.linkedin.com/ +https://www.reddit.com/ +README.md +SEO.md diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index ca7e465..d61cba8 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -1,10 +1,10 @@ # See https://pre-commit.com for more information # See https://pre-commit.com/hooks.html for more hooks repos: -- repo: https://github.com/pre-commit/pre-commit-hooks + - repo: https://github.com/pre-commit/pre-commit-hooks rev: v4.3.0 hooks: - - id: trailing-whitespace - - id: end-of-file-fixer - - id: check-yaml - - id: check-added-large-files + - id: trailing-whitespace + - id: end-of-file-fixer + - id: check-yaml + - id: check-added-large-files diff --git a/.prettierignore b/.prettierignore new file mode 100644 index 0000000..2b016e8 --- /dev/null +++ b/.prettierignore @@ -0,0 +1,13 @@ +**/*.map +**/*.min.css +**/*.min.js +assets/css/main.scss +assets/js/distillpub/template.v2.js +assets/js/search/*.js +assets/plotly/demo.html +lighthouse_results/** +_posts/2015-10-20-math.md +_sass/font-awesome/*.scss +_scripts/* +# Ignore citation YAML file generated by script +_data/citations.yml diff --git a/.prettierrc b/.prettierrc new file mode 100644 index 0000000..0163f19 --- /dev/null +++ b/.prettierrc @@ -0,0 +1,3 @@ +plugins: ["@shopify/prettier-plugin-liquid"] +printWidth: 150 +trailingComma: "es5" diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..8b22fd6 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,81 @@ +# Agent Guidelines for al-folio + +A simple, clean, and responsive Jekyll theme for academics. + +## Quick Links by Role + +- **Are you a coding agent?** β†’ Read [`.github/copilot-instructions.md`](.github/copilot-instructions.md) first (tech stack, build, CI/CD, common pitfalls & solutions) +- **Customizing the site?** β†’ See [`.github/agents/customize.agent.md`](.github/agents/customize.agent.md) +- **Writing documentation?** β†’ See [`.github/agents/docs.agent.md`](.github/agents/docs.agent.md) +- **Need setup/deployment help?** β†’ [INSTALL.md](INSTALL.md) +- **Troubleshooting & FAQ?** β†’ [TROUBLESHOOTING.md](TROUBLESHOOTING.md) +- **Customization & theming?** β†’ [CUSTOMIZE.md](CUSTOMIZE.md) +- **Quick 5-min start?** β†’ [QUICKSTART.md](QUICKSTART.md) + +## Essential Commands + +### Local Development (Docker) + +The recommended approach is using Docker. + +```bash +# Initial setup & start dev server +docker compose pull && docker compose up +# Site runs at http://localhost:8080 + +# Rebuild after changing dependencies or Dockerfile +docker compose up --build + +# Stop containers and free port 8080 +docker compose down +``` + +### Pre-Commit Checklist + +Before every commit, you **must** run these steps: + +1. **Format Code:** + ```bash + # (First time only) + npm install --save-dev prettier @shopify/prettier-plugin-liquid + # Format all files + npx prettier . --write + ``` +2. **Build Locally & Verify:** + + ```bash + # Rebuild the site + docker compose up --build + + # Verify by visiting http://localhost:8080. + # Check navigation, pages, images, and dark mode. + ``` + +## Critical Configuration + +When modifying `_config.yml`, these **must be updated together**: + +- **Personal site:** `url: https://username.github.io` + `baseurl:` (empty) +- **Project site:** `url: https://username.github.io` + `baseurl: /repo-name/` +- **YAML errors:** Quote strings with special characters: `title: "My: Cool Site"` + +## Development Workflow + +- **Git & Commits:** For commit message format and Git practices, see [.github/GIT_WORKFLOW.md](.github/GIT_WORKFLOW.md). +- **Code-Specific Instructions:** Consult the relevant instruction file for your code type. + +| File Type | Instruction File | +| --------------------------------------------- | ----------------------------------------------------------------------------------------------- | +| Markdown content (`_posts/`, `_pages/`, etc.) | [markdown-content.instructions.md](.github/instructions/markdown-content.instructions.md) | +| YAML config (`_config.yml`, `_data/`) | [yaml-configuration.instructions.md](.github/instructions/yaml-configuration.instructions.md) | +| BibTeX (`_bibliography/`) | [bibtex-bibliography.instructions.md](.github/instructions/bibtex-bibliography.instructions.md) | +| Liquid templates (`_includes/`, `_layouts/`) | [liquid-templates.instructions.md](.github/instructions/liquid-templates.instructions.md) | +| JavaScript (`_scripts/`) | [javascript-scripts.instructions.md](.github/instructions/javascript-scripts.instructions.md) | + +## Common Issues + +For troubleshooting, see: + +- [Common Pitfalls & Workarounds](.github/copilot-instructions.md#common-pitfalls--workarounds) in copilot-instructions.md +- [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for detailed solutions +- [GitHub Issues](https://github.com/alshedivat/al-folio/issues) to search for your specific problem. diff --git a/ANALYTICS.md b/ANALYTICS.md new file mode 100644 index 0000000..6060f66 --- /dev/null +++ b/ANALYTICS.md @@ -0,0 +1,186 @@ +# Analytics Setup Guide + +This guide helps you add website analytics to track visitor statistics and behavior. + + + +- [Analytics Setup Guide](#analytics-setup-guide) + - [Overview](#overview) + - [Supported Analytics Services](#supported-analytics-services) + - [Google Analytics](#google-analytics) + - [Setup Steps](#setup-steps) + - [Privacy-Friendly Alternatives](#privacy-friendly-alternatives) + - [Pirsch Analytics](#pirsch-analytics) + - [Openpanel Analytics](#openpanel-analytics) + - [Monitoring & Performance](#monitoring--performance) + - [Cronitor](#cronitor) + - [GDPR and Privacy Considerations](#gdpr-and-privacy-considerations) + - [GDPR Checklist](#gdpr-checklist) + - [Privacy-first services (No GDPR cookie banner needed)](#privacy-first-services-no-gdpr-cookie-banner-needed) + - [Services requiring cookie consent](#services-requiring-cookie-consent) + - [Comparing Analytics Services](#comparing-analytics-services) + - [Next Steps](#next-steps) + + + +## Overview + +Analytics help you understand your website visitors: where they come from, which pages they visit, and how they interact with your content. al-folio supports several analytics providers that you can enable in `_config.yml`. + +## Supported Analytics Services + +Currently implemented in al-folio: + +- **Google Analytics** – Free, feature-rich, but collects user data +- **Pirsch Analytics** – GDPR-compliant, free tier available, European servers +- **Openpanel Analytics** – Open-source option, privacy-focused +- **Cronitor** – Uptime monitoring with Real User Monitoring (RUM) analytics + +--- + +## Google Analytics + +Google Analytics is free and widely used. It provides detailed insights into visitor behavior. + +### Setup Steps + +1. **Create a Google Analytics account:** + - Visit [Google Analytics](https://analytics.google.com) + - Sign in with your Google account + - Click **Start measuring** β†’ **Create account** + +2. **Create a property for your website:** + - Enter your website name and URL + - Accept terms and continue + - Choose your timezone and currency + +3. **Get your Measurement ID:** + - In the left sidebar, go to **Admin** β†’ **Properties** + - Click **Data Streams** β†’ **Web** (or your existing stream) + - Copy the **Measurement ID** (format: `G-XXXXXXXXXX`) + +4. **Enable in your site:** + - Open `_config.yml` in your repository + - Set `enable_google_analytics: true` + - Add your Measurement ID: `google_analytics: G-XXXXXXXXXX` + - Commit and push + +5. **Verify it's working:** + - Visit your website + - Go back to Google Analytics β†’ **Real-time** tab + - You should see your visit appear within a few seconds + +**Note:** Google Analytics takes 24-48 hours to start showing data trends. + +--- + +## Privacy-Friendly Alternatives + +If you're concerned about user privacy or GDPR compliance, consider these alternatives: + +### Pirsch Analytics + +**Best for:** GDPR-compliant analytics without complex setup + +**Features:** + +- βœ… GDPR compliant +- βœ… European servers +- βœ… Free tier available +- βœ… Simple integration +- βœ… No cookie consent needed + +**Setup:** + +1. Sign up at [Pirsch.io](https://pirsch.io) +2. Add your domain +3. Copy the tracking code +4. In `_config.yml`, set `enable_pirsch_analytics: true` +5. Add your Site ID: `pirsch_analytics: YOUR_SITE_ID` (format: 32 characters) +6. Commit and push + +(The site ID appears in your Pirsch dashboard.) + +--- + +### Openpanel Analytics + +**Best for:** Open-source and privacy-conscious developers + +**Features:** + +- βœ… Open-source +- βœ… Self-hosted option available +- βœ… Privacy-focused +- βœ… Modern dashboard + +**Setup:** + +1. Sign up at [Openpanel.dev](https://openpanel.dev) +2. Create a project for your website +3. Get your **Client ID** +4. In `_config.yml`, set `enable_openpanel_analytics: true` +5. Add your Client ID: `openpanel_analytics: YOUR_CLIENT_ID` (format: UUID) +6. Commit and push + +--- + +## Monitoring & Performance + +### Cronitor + +Cronitor is an **uptime monitoring** service with RUM (Real User Monitoring) analytics. + +**Best for:** Tracking if your site is online + basic performance metrics + +**Setup:** + +1. Create account at [Cronitor.io](https://cronitor.io) +2. Get your **Site ID** +3. In `_config.yml`, set `enable_cronitor_analytics: true` +4. Add your Site ID: `cronitor_analytics: YOUR_SITE_ID` +5. Commit and push + +--- + +## GDPR and Privacy Considerations + +If you're in the European Union or serve EU visitors, consider GDPR requirements: + +### GDPR Checklist + +- [ ] If using Google Analytics: Add cookie consent banner +- [ ] Display a privacy policy explaining what analytics you use +- [ ] Allow users to opt-out if using tracking cookies +- [ ] Use privacy-first alternatives when possible + +### Privacy-first services (No GDPR cookie banner needed) + +- βœ… Pirsch Analytics +- βœ… Openpanel Analytics + +### Services requiring cookie consent + +- ❌ Google Analytics (EU users must consent first) +- ❌ Cronitor (collects user data via RUM) + +--- + +## Comparing Analytics Services + +| Service | Free | GDPR | Setup | Features | Best for | +| -------------------- | ------------ | ------------------- | ------ | ---------------- | -------------------------- | +| **Google Analytics** | βœ… | ⚠️ Requires consent | Easy | Detailed reports | Detailed tracking | +| **Pirsch** | βœ… Free tier | βœ… | Easy | Balanced | GDPR compliance | +| **Openpanel** | βœ… | βœ… | Medium | Modern dashboard | Privacy-focused developers | +| **Cronitor** | Paid | ⚠️ Requires consent | Easy | Uptime + RUM | Uptime monitoring | + +--- + +## Next Steps + +1. **Choose a service** based on your needs (privacy, features, budget) +2. **Follow the setup guide** for your chosen service +3. **Verify it's working** by visiting your site and checking the analytics dashboard + +For more customization help, see [CUSTOMIZE.md](CUSTOMIZE.md). diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..43c994c --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 349456b..6b50186 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,25 +1,102 @@ # Contributing to al-folio -Thank you for considering to contribute to al-folio! +Thank you for considering contributing to al-folio! ## Pull Requests + We welcome your pull requests (PRs). For minor fixes (e.g., documentation improvements), feel free to submit a PR directly. If you would like to implement a new feature or a bug, please make sure you (or someone else) has opened an appropriate issue first; in your PR, please mention the issue it addresses. +Note that since [#2048](https://github.com/alshedivat/al-folio/pull/2048) al-folio uses the [prettier formatter](https://prettier.io/) for its code, meaning all new submitted code must conform to its standard. If you don't have `prettier` installed for your setup and the `prettier` code check fails when submitting a PR, you can check the referred failed action in our repo. In that action there will be an artifact with an HTML diff showing the needed changes. + +## GitHub Copilot Agents + +This repository includes specialized GitHub Copilot agents and files to assist with development and documentation: + +### CLAUDE.md + +The `CLAUDE.md` file serves as an entry point for Claude (Anthropic's AI assistant) when working with this repository. It uses Claude's `@path/to/import` syntax (as described in [Claude's best practices](https://code.claude.com/docs/en/best-practices#write-an-effective-claude-md)) to dynamically import the `AGENTS.md` file. This approach keeps documentation centralized while providing a convenient entry point for AI assistants. The file simply contains: + +``` +@AGENTS.md +``` + +### Customization Agent + +The **Customization Agent** (`.github/agents/customize.agent.md`) helps users customize their al-folio website. It: + +- Guides you through modifying configuration files, adding content, and customizing the theme +- Explains technical concepts in plain language for users without coding experience +- Applies changes directly to your repository files +- Provides step-by-step instructions for common customization tasks + +To use the customization agent, you need to have [GitHub Copilot](https://github.com/features/copilot) enabled in your repository. The agent can help with tasks like changing site information, updating your CV, adding publications, creating blog posts, customizing theme colors, and more. + +### Documentation Agent + +The **Documentation Agent** (`.github/agents/docs.agent.md`) maintains the project documentation. It: + +- Updates and maintains documentation files (`README.md`, `INSTALL.md`, `CUSTOMIZE.md`, `FAQ.md`, `CONTRIBUTING.md`) +- Keeps documentation in sync with code changes +- Writes clear, concise documentation for users without technical backgrounds +- Follows documentation standards and best practices + +The documentation agent is primarily intended for maintainers and contributors who are updating the project documentation. + +### Custom Instruction Files + +To enhance GitHub Copilot's effectiveness when working with specific file types, this repository includes custom instruction files in `.github/instructions/`: + +- **`.github/copilot-instructions.md`** – Main Copilot instructions with repository overview, build process, tech stack, project layout, CI/CD pipelines, and common pitfalls +- **`.github/instructions/liquid-templates.instructions.md`** – Guidance for modifying Liquid template files (`.liquid`) +- **`.github/instructions/yaml-configuration.instructions.md`** – Guidance for configuration and data files (`_config.yml`, `_data/**/*.yml`) +- **`.github/instructions/bibtex-bibliography.instructions.md`** – Guidance for bibliography files (`.bib`, `_bibliography/**`) +- **`.github/instructions/markdown-content.instructions.md`** – Guidance for content files across collections (`_books/`, `_news/`, `_pages/`, `_posts/`, `_projects/`, `_teachings/`) +- **`.github/instructions/javascript-scripts.instructions.md`** – Guidance for JavaScript files in `_scripts/` + +These files help Copilot agents understand project conventions, build requirements, and development workflows without requiring codebase exploration. + +### Copilot Environment Setup + +A GitHub Actions workflow (`.github/workflows/copilot-setup-steps.yml`) automatically configures the Copilot environment with required dependencies (Ruby 3.3.5, Python 3.13, Node.js, ImageMagick, nbconvert) before agent execution. + +### Important: Verify Agent Output + +While these agents are designed to assist you, **they can make mistakes or produce incorrect information**. Always review and verify the output before applying it to your repository: + +- **Review code and configuration changes** – Check that suggested modifications are correct and fit your needs +- **Test changes locally** – Before pushing to GitHub, test the changes locally (using Docker or native setup) +- **Verify syntax** – Ensure any YAML, Markdown, or configuration files have correct syntax +- **Check documentation** – If the agent generates documentation, review it for accuracy and clarity +- **Don't blindly apply changes** – Understand what changes are being made and why +- **Run your site** – After applying changes, run your site locally and verify everything works as expected + +**Example:** If an agent suggests a BibTeX entry or configuration change, verify that the syntax is correct and matches the existing style in your repository before committing. + +### How to Enable Agents + +GitHub Copilot agents are available to users with GitHub Copilot subscriptions. To use these agents: + +1. Ensure you have [GitHub Copilot](https://github.com/features/copilot) enabled for your account +2. Open your repository in an editor with GitHub Copilot support (such as VS Code with the GitHub Copilot extension) +3. The agents will be automatically available based on the configuration files in `.github/agents/`. For more information, see [Using custom agents in your IDE](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents#using-custom-agents-in-your-ide). + +For more information about GitHub Copilot agents and how to use them, see the [GitHub Copilot documentation](https://docs.github.com/en/copilot). ## Issues + We use GitHub issues to track bugs and feature requests. Before submitting an issue, please make sure: -1. You have read [the FAQ section](https://github.com/alshedivat/al-folio#faq) of the README and your question is NOT addressed there. +1. You have read [the FAQ section](FAQ.md) of the README and your question is NOT addressed there. 2. You have done your best to ensure that your issue is NOT a duplicate of one of [the previous issues](https://github.com/alshedivat/al-folio/issues). 3. Your issue is either a bug (unexpected/undesirable behavior) or a feature request. -If it is just a question, please ask it in the [Discussions](https://github.com/alshedivat/al-folio/discussions) forum. + If it is just a question, please ask it in the [Discussions](https://github.com/alshedivat/al-folio/discussions) forum. When submitting an issue, please make sure to use the appropriate template. - ## License + By contributing to al-folio, you agree that your contributions will be licensed under the LICENSE file in the root directory of the source tree. diff --git a/CUSTOMIZE.md b/CUSTOMIZE.md new file mode 100644 index 0000000..6f6e3c1 --- /dev/null +++ b/CUSTOMIZE.md @@ -0,0 +1,1402 @@ +# Customize + +Here we will give you some tips on how to customize the website. One important thing to note is that **ALL** the changes you make should be done on the **main** branch of your repository. The `gh-pages` branch is automatically overwritten every time you make a change to the main branch. + +> **Note for users without coding experience:** You do **not** need to understand the technology stack or have any coding background to create and customize your own website with al-folio. This template was specifically designed to be accessible to academics and researchers from all backgrounds. You can create a fully functional website by simply editing configuration files and adding content in Markdown, no coding required. + + + +- [Customize](#customize) + - [Project structure](#project-structure) + - [Configuration](#configuration) + - [GitHub Copilot Customization Agent](#github-copilot-customization-agent) + - [What the Agent Can Help With](#what-the-agent-can-help-with) + - [How to Use the Agent](#how-to-use-the-agent) + - [Important: Verify Agent Output](#important-verify-agent-output) + - [Understanding the Codebase with Code Wiki and DeepWiki](#understanding-the-codebase-with-code-wiki-and-deepwiki) + - [What are these tools?](#what-are-these-tools) + - [When to use them](#when-to-use-them) + - [Technology Stack](#technology-stack) + - [Frontend](#frontend) + - [Backend](#backend) + - [Build and Deployment](#build-and-deployment) + - [Key Integration Points](#key-integration-points) + - [Modifying the CV information](#modifying-the-cv-information) + - [RenderCV Format (Recommended)](#rendercv-format-recommended) + - [JSONResume Format](#jsonresume-format) + - [Using Both Formats Simultaneously](#using-both-formats-simultaneously) + - [Automatic PDF Generation (RenderCV only)](#automatic-pdf-generation-rendercv-only) + - [Modifying the user and repository information](#modifying-the-user-and-repository-information) + - [Configuring external service URLs](#configuring-external-service-urls) + - [Creating new pages](#creating-new-pages) + - [Creating new blog posts](#creating-new-blog-posts) + - [Creating new projects](#creating-new-projects) + - [Adding some news](#adding-some-news) + - [Adding Collections](#adding-collections) + - [Creating a new collection](#creating-a-new-collection) + - [Using frontmatter fields in your collection](#using-frontmatter-fields-in-your-collection) + - [Creating a teachings collection](#creating-a-teachings-collection) + - [Course file format](#course-file-format) + - [Important course collection notes](#important-course-collection-notes) + - [Required fields](#required-fields) + - [Optional fields](#optional-fields) + - [Collections with categories and tags](#collections-with-categories-and-tags) + - [Creating custom metadata groups and archive pages](#creating-custom-metadata-groups-and-archive-pages) + - [Understanding Jekyll's special handling of fields](#understanding-jekylls-special-handling-of-fields) + - [Example: Adding a custom "adaptations" field](#example-adding-a-custom-adaptations-field) + - [Field naming best practices](#field-naming-best-practices) + - [Complete example: Book reviews with custom adaptations field](#complete-example-book-reviews-with-custom-adaptations-field) + - [Adding a new publication](#adding-a-new-publication) + - [Author annotation](#author-annotation) + - [Buttons (through custom bibtex keywords)](#buttons-through-custom-bibtex-keywords) + - [Changing theme color](#changing-theme-color) + - [Customizing layout and UI](#customizing-layout-and-ui) + - [Adding social media information](#adding-social-media-information) + - [Adding a newsletter](#adding-a-newsletter) + - [Configuring search features](#configuring-search-features) + - [Social media previews](#social-media-previews) + - [How to enable](#how-to-enable) + - [Configuring preview images](#configuring-preview-images) + - [Preview image best practices](#preview-image-best-practices) + - [Related posts](#related-posts) + - [How it works](#how-it-works) + - [Configuration](#configuration-1) + - [Disable related posts for a specific post](#disable-related-posts-for-a-specific-post) + - [Additional configuration in _config.yml](#additional-configuration-in-_configyml) + - [Managing publication display](#managing-publication-display) + - [Adding a Google Calendar](#adding-a-google-calendar) + - [Basic usage](#basic-usage) + - [Enable the calendar script for your page](#enable-the-calendar-script-for-your-page) + - [Optional: Customize the calendar style](#optional-customize-the-calendar-style) + - [Updating third-party libraries](#updating-third-party-libraries) + - [Removing content](#removing-content) + - [Removing the blog page](#removing-the-blog-page) + - [Removing the news section](#removing-the-news-section) + - [Removing the projects page](#removing-the-projects-page) + - [Removing the publications page](#removing-the-publications-page) + - [Removing the repositories page](#removing-the-repositories-page) + - [You can also remove pages through commenting out front-matter blocks](#you-can-also-remove-pages-through-commenting-out-front-matter-blocks) + - [Adding Token for Lighthouse Badger](#adding-token-for-lighthouse-badger) + - [Personal Access Token (fine-grained) Permissions for Lighthouse Badger:](#personal-access-token-fine-grained-permissions-for-lighthouse-badger) + - [Customizing fonts, spacing, and more](#customizing-fonts-spacing-and-more) + - [Scheduled Posts](#scheduled-posts) + - [Name Format](#name-format) + - [Important Notes](#important-notes) + - [GDPR Cookie Consent Dialog](#gdpr-cookie-consent-dialog) + - [How it works](#how-it-works-1) + - [When to use](#when-to-use) + - [How to enable](#how-to-enable-1) + - [Customizing the consent dialog](#customizing-the-consent-dialog) + - [Supported analytics providers](#supported-analytics-providers) + - [How it integrates with analytics](#how-it-integrates-with-analytics) + - [For developers](#for-developers) + - [Setting up a Personal Access Token (PAT) for Google Scholar Citation Updates](#setting-up-a-personal-access-token-pat-for-google-scholar-citation-updates) + - [Why is a PAT required?](#why-is-a-pat-required) + - [How to set up the PAT](#how-to-set-up-the-pat) + + + +## Project structure + +The project is structured as follows, focusing on the main components that you will need to modify: + +```txt +. +β”œβ”€β”€ πŸ“‚ assets/: contains the assets that are displayed in the website +β”‚Β Β  └── πŸ“‚ json/ + β”‚Β Β  └── πŸ“„ resume.json: CV in JSON format (https://jsonresume.org/) +β”œβ”€β”€ πŸ“‚ _bibliography/ +β”‚Β Β  └── πŸ“„ papers.bib: bibliography in BibTeX format +β”œβ”€β”€ πŸ“‚ _books/: contains the bookshelf pages +β”œβ”€β”€ πŸ“„ _config.yml: the configuration file of the template +β”œβ”€β”€ πŸ“‚ _data/: contains some of the data used in the template +β”‚Β Β  β”œβ”€β”€ πŸ“„ cv.yml: CV in YAML format, used when assets/json/resume.json is not found +β”‚Β Β  β”œβ”€β”€ πŸ“„ repositories.yml: users and repositories info in YAML format +β”‚Β Β  └── πŸ“„ socials.yml: your social media and contact info in YAML format +β”œβ”€β”€ πŸ“‚ _includes/: contains code parts that are included in the main HTML file +β”‚Β Β  └── πŸ“„ news.liquid: defines the news section layout in the about page +β”œβ”€β”€ πŸ“‚ _layouts/: contains the layouts to choose from in the frontmatter of the Markdown files +β”œβ”€β”€ πŸ“‚ _news/: the news that will appear in the news section in the about page +β”œβ”€β”€ πŸ“‚ _pages/: contains the pages of the website +| └── πŸ“„ 404.md: 404 page (page not found) +β”œβ”€β”€ πŸ“‚ _posts/: contains the blog posts +β”œβ”€β”€ πŸ“‚ _projects/: contains the projects +└── πŸ“‚ _sass/: contains the SASS files that define the style of the website + β”œβ”€β”€ πŸ“‚ font-awesome/: contains the SCSS files for Font Awesome + β”œβ”€β”€ πŸ“„ _blog.scss: blog post, tags, and pagination styles + β”œβ”€β”€ πŸ“„ _components.scss: reusable component styles (cards, profiles, CV, projects) + β”œβ”€β”€ πŸ“„ _cv.scss: style of the CV page + β”œβ”€β”€ πŸ“„ _distill.scss: style of the Distill articles + β”œβ”€β”€ πŸ“„ _footer.scss: footer styles + β”œβ”€β”€ πŸ“„ _layout.scss: overall layout styles + β”œβ”€β”€ πŸ“„ _navbar.scss: navigation bar and dropdown menu styles + β”œβ”€β”€ πŸ“„ _publications.scss: publication list and bibliography styles + β”œβ”€β”€ πŸ“„ _tabs.scss: tabbed content styles + β”œβ”€β”€ πŸ“„ _teachings.scss: course and teaching styles + β”œβ”€β”€ πŸ“„ _themes.scss: theme colors and icons + β”œβ”€β”€ πŸ“„ _typograms.scss: typogram diagram styles + β”œβ”€β”€ πŸ“„ _typography.scss: text, headings, links, tables, and blockquote styles + β”œβ”€β”€ πŸ“„ _utilities.scss: utility styles (code highlighting, forms, modals, animations) + └── πŸ“„ _variables.scss: variables used in the SASS files +``` + +## Configuration + +The configuration file [\_config.yml](_config.yml) contains the main configuration of the website. Most of the settings is self-explanatory and we also tried to add as much comments as possible. If you have any questions, please check if it was not already answered in the [FAQ](FAQ.md). + +> Note that the `url` and `baseurl` settings are used to generate the links of the website, as explained in the [install instructions](INSTALL.md). + +All changes made to this file are only visible after you rebuild the website. That means that you need to run `bundle exec jekyll serve` again if you are running the website locally or push your changes to GitHub if you are using GitHub Pages. All other changes are visible immediately, you only need to refresh the page. + +If changes don't appear after refreshing, try: + +- **Hard refresh** to reload the page ignoring cached content: + - [Shift + F5 on Chromium-based browsers](https://support.google.com/chrome/answer/157179#zippy=%2Cwebpage-shortcuts) + - [Ctrl + F5 on Firefox-based browsers](https://support.mozilla.org/en-US/kb/keyboard-shortcuts-perform-firefox-tasks-quickly) +- **Clear your browser cache** completely +- **Use a private/incognito session** to ensure no cached content: + - [Chrome](https://support.google.com/chrome/answer/95464) + - [Firefox](https://support.mozilla.org/en-US/kb/private-browsing-use-firefox-without-history) + +## GitHub Copilot Customization Agent + +This repository includes a specialized GitHub Copilot agent (`.github/agents/customize.agent.md`) designed to help you customize your al-folio website. The agent acts as an expert assistant that can: + +- Guide you through common customization tasks step-by-step +- Modify configuration files, add content, and update your website +- Explain technical concepts in plain language (especially helpful if you're not familiar with Jekyll or web development) +- Apply changes directly to your repository files +- Answer questions about how to customize specific features + +### What the Agent Can Help With + +The customization agent can assist with tasks such as: + +- Changing basic site information (title, author name, contact details) +- Updating your CV or resume +- Adding and managing publications from BibTeX files +- Creating blog posts, projects, and news items +- Customizing theme colors and styling +- Managing social media links +- Enabling or disabling features in `_config.yml` +- Adding profile pictures and other assets +- Troubleshooting configuration issues + +### How to Use the Agent + +To use the customization agent: + +1. Ensure you have a [GitHub Copilot](https://github.com/features/copilot) subscription +2. Open your repository in an editor with GitHub Copilot support (such as VS Code with the GitHub Copilot extension) +3. Interact with GitHub Copilot and ask questions or request changes. For more information, check [Using custom agents in your IDE](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents#using-custom-agents-in-your-ide) +4. The agent will guide you through the customization process and can make changes directly to your files + +For example, you can ask: + +- "How do I change my website's theme color to blue?" +- "Help me add a new blog post about my research" +- "Update my profile information with my new university email" +- "How do I add a publication to my website?" + +The agent is designed to be patient and helpful, explaining each step clearly so you understand what's being changed and why. + +### Important: Verify Agent Output + +**The customization agent can make mistakes or produce incorrect information.** Always review and verify the agent's suggestions and changes before applying them to your repository: + +- **Review all changes** – Before applying any modifications, carefully read what the agent suggests and ensure it makes sense for your needs +- **Test locally first** – Before pushing changes to GitHub, test them locally using Docker or native setup (see the [Installation instructions](INSTALL.md)) +- **Check syntax** – Make sure any YAML, Markdown, or BibTeX files have correct syntax. Incorrect syntax can break your website +- **Verify configuration** – If the agent modifies `_config.yml` or other configuration files, check that the changes align with your intentions +- **Preview on your site** – Run your site locally and navigate through it to ensure everything displays correctly and works as expected +- **Don't blindly apply changes** – Understand what's being changed and why before committing to your repository + +**Example scenarios where verification is important:** + +- If the agent suggests a BibTeX entry, verify the syntax matches existing entries in your `_bibliography/papers.bib` file +- If the agent modifies your `_config.yml`, check that indentation is correct (YAML is very sensitive to spacing) +- If the agent creates a new blog post or page, verify the frontmatter (the metadata at the top) is correct +- If the agent suggests changes to theme colors or styling, preview your site locally to ensure the changes look as intended + +> **Note:** The customization agent requires GitHub Copilot to be enabled. For more information about GitHub Copilot and its features, see the [GitHub Copilot documentation](https://docs.github.com/en/copilot). + +## Understanding the Codebase with Code Wiki and DeepWiki + +If you're interested in learning more about how al-folio works under the hood, or want to understand specific aspects of the codebase for deeper customization, you can use Code Wiki and DeepWiki as supplementary resources. + +### What are these tools? + +**Code Wiki** and **DeepWiki** are AI-powered tools that help you explore and understand GitHub repositories through interactive documentation: + +- **Code Wiki** (powered by Google Gemini) generates interactive documentation from the repository code. You can browse the project structure, search for specific functions or modules, view architecture diagrams, and understand how different components interact. + +- **DeepWiki** provides an AI chat interface where you can ask natural language questions about the codebase, similar to having an engineer available 24/7. You can ask how features work, search for code patterns, or get explanations of complex logic. + +### When to use them + +Use Code Wiki and DeepWiki **only after**: + +- You have reviewed the relevant sections in this `CUSTOMIZE.md` file +- You have checked the [project structure](#project-structure) section above +- You have explored the [main documentation files](README.md) (README.md, INSTALL.md, FAQ.md) +- You have checked the [GitHub Discussions Q&A section](https://github.com/alshedivat/al-folio/discussions/categories/q-a) + +These tools are best used for: + +- Understanding the architecture and how different parts of the codebase work together +- Finding where specific functionality is implemented +- Learning about the Jekyll template structure and Liquid syntax used in the theme +- Exploring how specific features are implemented (e.g., how publications are rendered, how search works, etc.) + +**Access these tools:** + +- **Code Wiki**: [Code Wiki for al-folio](https://codewiki.google/github.com/alshedivat/al-folio) +- **DeepWiki**: [DeepWiki for al-folio](https://deepwiki.com/alshedivat/al-folio) + +## Technology Stack + +Understanding al-folio's technology stack will help you better customize and extend the theme. This section provides an overview of the key technologies and frameworks used in the project. + +### Frontend + +- **Markdown**: Content is written in Markdown format for pages, blog posts, and collections. This makes it easy to create and maintain content without worrying about HTML. +- **Liquid templating**: [Liquid](https://shopify.github.io/liquid/) is used for dynamic template generation. Liquid templates are used in the `_layouts/` and `_includes/` directories to define how your content should be displayed. +- **HTML & CSS**: The theme uses semantic HTML5 and modern CSS for styling and layout. +- **SCSS**: Stylesheets are written in [SCSS (Sass)](https://sass-lang.com/), a CSS preprocessor that provides variables, mixins, and functions for more maintainable styling. SCSS files are located in `_sass/` and compiled to CSS during the build process. +- **Bootstrap**: [Bootstrap 4.6](https://getbootstrap.com/docs/4.6/) is used for responsive grid layout and base styling components. +- **JavaScript**: Minimal JavaScript is used for interactive features like the dark mode toggle, search functionality, and dynamic content rendering. +- **MathJax**: For rendering mathematical equations in LaTeX format on your pages and blog posts. +- **Mermaid**: For creating diagrams (flowcharts, sequence diagrams, etc.) directly in Markdown. +- **Font Awesome, Academicons, and Scholar Icons**: Icon libraries used throughout the theme for visual elements. + +### Backend + +- **Jekyll 4.x**: [Jekyll](https://jekyllrb.com/) is a static site generator written in Ruby that transforms your Markdown files and templates into a static website. Jekyll is used to: + - Convert Markdown files to HTML + - Process Liquid templates + - Manage collections (posts, projects, news, books, etc.) + - Generate archives and pagination + - Minify CSS and JavaScript + +- **Ruby Gems** (Jekyll plugins): The project uses several Ruby plugins to extend Jekyll's functionality: + - `classifier-reborn`: Used for categorizing and finding related blog posts + - `jekyll-archives-v2`: Creates archive pages for posts and collections organized by category, tag, or date + - `jekyll-feed`: Generates an Atom (RSS-like) feed for your content + - `jekyll-jupyter-notebook`: Integrates Jupyter notebooks into your site + - `jekyll-minifier`: Minifies HTML, CSS, and JavaScript for better performance + - `jekyll-paginate-v2`: Handles pagination for blog posts and archives + - `jekyll-scholar`: Manages bibliography files (BibTeX) and generates publication pages with citations + - `jekyll-tabs`: Adds tabbed content support + - `jekyll-toc`: Automatically generates table of contents for pages with headers + - `jemoji`: Converts emoji shortcodes to emoji images + - Other utilities: `jekyll-link-attributes`, `jekyll-imagemagick`, `jekyll-twitter-plugin`, `jekyll-get-json`, and more + +- **Python**: Used for utility scripts like citation updates via Google Scholar (located in `bin/`) + +### Build and Deployment + +- **GitHub Actions**: Automated workflows for building, testing, and deploying your site. Workflows are defined in `.github/workflows/`: + - **Deploy**: Automatically builds and deploys your site to GitHub Pages when you push changes to the main branch + - **Link checking**: Validates that all links in your site are not broken + - **Code formatting**: Ensures code follows the Prettier code style + - **Accessibility testing**: Checks for accessibility issues using Axe + - **Lighthouse**: Measures site performance and best practices + - **Citation updates**: Automatically fetches citation counts from Google Scholar + +- **GitHub Pages**: Free hosting for your static website built by Jekyll +- **Docker**: Optional containerization for local development (provides a consistent environment across different machines) +- **Prettier**: Code formatter for Markdown, YAML, and Liquid files to maintain consistent formatting + +### Key Integration Points + +Understanding how these technologies work together will help you customize al-folio effectively: + +1. **Content Creation**: Write content in Markdown +2. **Template Processing**: Jekyll processes Markdown through Liquid templates +3. **Styling**: SCSS files are compiled to CSS, with Bootstrap providing the responsive layout framework +4. **Bibliography**: BibTeX files are processed by jekyll-scholar to generate publication pages +5. **Static Site Generation**: Jekyll builds all files into static HTML +6. **Deployment**: GitHub Actions automatically deploys the built site to GitHub Pages + +## Modifying the CV information + +Your CV can be created using one of two formats. Choose the format that works best for you, or use both simultaneously by switching between them: + +### RenderCV Format (Recommended) + +[`_data/cv.yml`](_data/cv.yml) uses the [RenderCV](https://rendercv.com/) YAML format, which is human-readable and designed specifically for generating professional resumes. This format also enables optional automatic PDF generation via GitHub Actions. + +**If you choose this format:** + +1. Edit your CV data in [`_data/cv.yml`](_data/cv.yml) +2. Optionally customize how the PDF is styled by editing: + - [`assets/rendercv/design.yaml`](assets/rendercv/design.yaml) β€” Design and styling + - [`assets/rendercv/locale.yaml`](assets/rendercv/locale.yaml) β€” Localization and formatting + - [`assets/rendercv/settings.yaml`](assets/rendercv/settings.yaml) β€” RenderCV settings +3. To display only this format, delete [`assets/json/resume.json`](assets/json/resume.json) (optional) + +### JSONResume Format + +[`assets/json/resume.json`](assets/json/resume.json) uses the [JSONResume](https://jsonresume.org/) standard format, which is compatible with other tools and services. + +**If you choose this format:** + +1. Edit your CV data in [`assets/json/resume.json`](assets/json/resume.json) +2. To display only this format, delete [`_data/cv.yml`](_data/cv.yml) (optional) + +### Using Both Formats Simultaneously + +You can keep both [`_data/cv.yml`](_data/cv.yml) and [`assets/json/resume.json`](assets/json/resume.json) in your repository and switch between them on your website by setting the `cv_format` frontmatter variable in [`_pages/cv.md`](_pages/cv.md): + +```yaml +--- +layout: cv +cv_format: rendercv # options: rendercv or jsonresume +--- +``` + +Change `rendercv` to `jsonresume` to display the JSONResume format instead. + +### Automatic PDF Generation (RenderCV only) + +If you use the RenderCV format, a GitHub Actions workflow can automatically generate a PDF version of your CV whenever you push changes to [`_data/cv.yml`](_data/cv.yml). The PDF is saved to `assets/rendercv/rendercv_output/`. + +**To link the auto-generated PDF to your CV page:** + +Set the `cv_pdf` variable in the frontmatter of [`_pages/cv.md`](_pages/cv.md) to point to the generated PDF: + +```yaml +--- +layout: cv +cv_pdf: /assets/rendercv/rendercv_output/CV.pdf +cv_format: rendercv +--- +``` + +This will add a download button on your CV page that links to the PDF. (The exact filename depends on your RenderCV settingsβ€”check the output directory after the first workflow run to see the generated PDF name.) + +**To disable automatic PDF generation:** + +Delete or comment out the [`.github/workflows/render-cv.yml`](.github/workflows/render-cv.yml) workflow file. + +## Modifying the user and repository information + +The user and repository information is defined in [\_data/repositories.yml](_data/repositories.yml). You can add as many users and repositories as you want. Both informations are used in the `repositories` section. + +### Configuring external service URLs + +The repository page uses external services to display GitHub statistics and trophies. By default, these are: + +- `github-readme-stats.vercel.app` for user stats and repository cards +- `github-profile-trophy.vercel.app` for GitHub profile trophies + +**Important:** These default services are hosted by third parties and may not be available 100% of the time. For better reliability, privacy, and customization, you can self-host these services and configure your website to use your own instances. + +To use your own instances of these services, configure the URLs in [\_config.yml](_config.yml): + +```yaml +external_services: + github_readme_stats_url: https://github-readme-stats.vercel.app + github_profile_trophy_url: https://github-profile-trophy.vercel.app +``` + +To self-host these services, follow the deployment instructions in their respective repositories: + +- [github-readme-stats](https://github.com/anuraghazra/github-readme-stats) +- [github-profile-trophy](https://github.com/ryo-ma/github-profile-trophy) + +Once deployed, update the URLs above to point to your custom deployment. + +## Creating new pages + +You can create new pages by adding new Markdown files in the [\_pages](_pages/) directory. The easiest way to do this is to copy an existing page and modify it. You can choose the layout of the page by changing the [layout](https://jekyllrb.com/docs/layouts/) attribute in the [frontmatter](https://jekyllrb.com/docs/front-matter/) of the Markdown file, and also the path to access it by changing the [permalink](https://jekyllrb.com/docs/permalinks/) attribute. You can also add new layouts in the [\_layouts](_layouts/) directory if you feel the need for it. + +## Creating new blog posts + +To create a new blog post, you can add a new Markdown file in the [\_posts](_posts/) directory, which is the [default location for posts in Jekyll](https://jekyllrb.com/docs/posts/). The [name of the file must follow](https://jekyllrb.com/docs/posts/#creating-posts) the format `YYYY-MM-DD-title.md`. The easiest way to do this is to copy an existing blog post and modify it. Note that some blog posts have optional fields in the [frontmatter](https://jekyllrb.com/docs/front-matter/) that are used to enable specific behaviors or functions. + +If you want to create blog posts that are not ready to be published, but you want to track it with git, you can create a [\_drafts](https://jekyllrb.com/docs/posts/#drafts) directory and store them there. + +Note that `posts` is also a collection, but it is a default collection created automatically by Jekyll. To access the posts, you can use the `site.posts` variable in your templates. + +## Creating new projects + +You can create new projects by adding new Markdown files in the [\_projects](_projects/) directory. The easiest way to do this is to copy an existing project and modify it. + +## Adding some news + +You can add news in the about page by adding new Markdown files in the [\_news](_news/) directory. There are currently two types of news: inline news and news with a link. News with a link take you to a new page while inline news are displayed directly in the about page. The easiest way to create yours is to copy an existing news and modify it. + +## Adding Collections + +This Jekyll theme implements [collections](https://jekyllrb.com/docs/collections/) to let you break up your work into categories. The theme comes with three default collections: `news`, `projects`, and `books`. Items from the `news` collection are automatically displayed on the home page, while items from the `projects` collection are displayed on a responsive grid on the projects page, and items from the `books` collection are displayed on its own `bookshelf` page inside `submenus`. + +You can easily create your own collections for any type of contentβ€”teaching materials, courses, apps, short stories, or whatever suits your needs. + +### Creating a new collection + +To create a new collection, follow these steps. We will create a `courses` collection, but you can replace `courses` with any name you prefer: + +1. **Add the collection to `_config.yml`** + + Open the `collections` section in [\_config.yml](_config.yml) and add your new collection: + + ```yaml + collections: + news: + defaults: + layout: post + output: true + projects: + output: true + courses: + output: true + permalink: /courses/:path/ + ``` + + - `output: true` makes the collection items accessible as separate pages + - `permalink` defines the URL path for each collection item (`:path` is replaced with the filename) + - Note: You can customize the [permalink structure](https://jekyllrb.com/docs/permalinks/#collections) as needed. If not set, it uses `/COLLECTION_NAME/:name/`. + +2. **Create a folder for your collection items** + + Create a new folder in the root directory with an underscore prefix, matching your collection name. For a `courses` collection, create `_courses/`: + + ```text + _courses/ + β”œβ”€β”€ course_1.md + β”œβ”€β”€ course_2.md + └── course_3.md + ``` + +3. **Create a landing page for your collection** + + Add a Markdown file in `_pages/` (e.g., `courses.md`) that will serve as the main page for your collection. You can use [\_pages/projects.md](_pages/projects.md) or [\_pages/books.md](_pages/books.md) as a template and adapt it for your needs. + + In your landing page, access your collection using the `site.COLLECTION_NAME` variable: + + ```liquid + {% assign course_items = site.courses | sort: 'date' | reverse %} + + {% for item in course_items %} +

{{ item.title }}

+

{{ item.content }}

+ {% endfor %} + ``` + +4. **Add a navigation link to your collection page** + + Update [\_pages/dropdown.md](_pages/dropdown.md) or the navigation configuration of your page. In the frontmatter of your collection landing page (e.g., `_pages/courses.md`), add: + + ```yaml + nav: true + nav_order: 5 + ``` + + - `nav: true` makes the page appear in the navigation menu + - `nav_order` sets the position in the menu (1 = first, 2 = second, etc.) + +5. **Create collection items** + + Add Markdown files in your new collection folder (e.g., `_courses/`) with appropriate frontmatter and content. + +For more information regarding collections, check [Jekyll official documentation](https://jekyllrb.com/docs/collections/) and [step-by-step guide](https://jekyllrb.com/docs/step-by-step/09-collections/). + +### Using frontmatter fields in your collection + +When creating items in your collection, you can define custom frontmatter fields and use them in your landing page. For example: + +```markdown +--- +layout: page +title: Introduction to Research Methods +importance: 1 +category: methods +--- + +Course description and content here... +``` + +Then in your landing page template: + +```liquid +{% if item.category == 'methods' %} + {{ item.category }} +{% endif %} +``` + +### Creating a teachings collection + +The al-folio theme includes a pre-configured `_teachings/` collection for course pages. Each course is represented by a markdown file with frontmatter metadata. Here's how to add or modify courses: + +#### Course file format + +Create markdown files in `_teachings/` with the following structure: + +```yaml +--- +layout: course +title: Course Title +description: Course description +instructor: Your Name +year: 2023 +term: Fall +location: Room 101 +time: MWF 10:00-11:00 +course_id: course-id # This should be unique +schedule: + - week: 1 + date: Jan 10 + topic: Introduction + description: Overview of course content and objectives + materials: + - name: Slides + url: /assets/pdf/example_pdf.pdf + - name: Reading + url: https://example.com/reading + - week: 2 + date: Jan 17 + topic: Topic 2 + description: Description of this week's content +--- +Additional course content, information, or resources can be added here as markdown. +``` + +#### Important course collection notes + +1. Each course file must have a unique `course_id` in the frontmatter +2. Course files will be grouped by `year` on the teaching page +3. Within each year, courses are sorted by `term` +4. The content below the frontmatter (written in markdown) will appear on the individual course page +5. The schedule section will be automatically formatted into a table + +#### Required fields + +- `layout: course` β€” Must be set to use the course layout +- `title` β€” The course title +- `year` β€” The year the course was/will be taught (used for sorting) +- `course_id` β€” A unique identifier for the course + +#### Optional fields + +- `description` β€” A brief description of the course +- `instructor` β€” The course instructor's name +- `term` β€” The academic term (e.g., Fall, Spring, Summer) +- `location` β€” The course location +- `time` β€” The course meeting time +- `schedule` β€” A list of course sessions with details + +### Collections with categories and tags + +If you want to add category and tag support (like the blog posts have), you need to configure the `jekyll-archives` section in [\_config.yml](_config.yml). See how this is done with the `books` collection for reference. For more details, check the [jekyll-archives-v2 documentation](https://george-gca.github.io/jekyll-archives-v2/). + +### Creating custom metadata groups and archive pages + +Beyond the built-in `categories` and `tags` fields, you can create custom metadata fields for your collections to organize content in new ways. For example, if you have a book review collection, you might want to organize books by their **adaptations** (movies, TV shows, video games, etc.). + +#### Understanding Jekyll's special handling of fields + +Jekyll has **special built-in support** for only two fields: + +- **`categories`** – Automatically splits space-separated values into arrays +- **`tags`** – Automatically splits space-separated values into arrays + +Custom fields (any field name you create) remain as **strings** and require explicit handling in your Liquid templates. + +#### Example: Adding a custom "adaptations" field + +1. **Add the field to your collection frontmatter** + + In your collection item (e.g., `_books/the_godfather.md`): + + ```yaml + --- + layout: book-review + title: The Godfather + author: Mario Puzo + categories: classics crime historical-fiction + adaptations: movie TV-series video-game novel-adaptation + --- + ``` + +2. **Handle the custom field in your layout template** + + In your layout file (e.g., `_layouts/book-review.liquid`), custom fields must be **split** into arrays before you can loop over them: + + ```liquid + {% if page.adaptations %} + {% assign page_adaptations = page.adaptations | split: ' ' %} + {% for adaptation in page_adaptations %} + + {{ adaptation }} + + {% endfor %} + {% endif %} + ``` + + **Why the `split: ' '` filter?** Because `adaptations` is a custom field, Jekyll doesn't automatically convert it to an array like it does for `categories` and `tags`. The `split: ' '` filter breaks the space-separated string into individual items. + +3. **Enable archive pages for your custom field** + + Add your custom field to the `jekyll-archives` configuration in [\_config.yml](_config.yml): + + ```yaml + jekyll-archives: + posts: + enabled: + - year + - tags + - categories + books: + enabled: + - year + - tags + - categories + - adaptations # Add your custom field here + permalinks: + year: "/:collection/:year/" + tags: "/:collection/:type/:name/" + categories: "/:collection/:type/:name/" + adaptations: "/:collection/:type/:name/" # Add permalink pattern here + ``` + +4. **Test your archive pages** + + After configuration, rebuild your site: + + ```bash + docker compose down + docker compose up + ``` + + Your archive pages will be generated at: + - `/books/adaptations/movie/` + - `/books/adaptations/tv-series/` (slugified from `TV-series`) + - `/books/adaptations/video-game/` (slugified from `video-game`) + + Each page will automatically display all items with that adaptation value. + +#### Field naming best practices + +- Use **lowercase** words separated by **hyphens** for multi-word values: `live-action`, `video-game`, `TV-series` +- Choose **meaningful names** that describe the grouping: `genres`, `adaptations`, `media-types`, `settings`, etc. +- Keep field values **short and consistent** across all items in your collection +- Document custom fields in a README or comments for other contributors to understand + +#### Complete example: Book reviews with custom adaptations field + +**File: `_books/the_godfather.md`** + +```yaml +--- +layout: book-review +title: The Godfather +author: Mario Puzo +categories: classics crime historical-fiction +tags: top-100 +adaptations: movie TV-series video-game +--- +``` + +**File: `_layouts/book-review.liquid` (partial)** + +```liquid +{% if page.adaptations %} +
+ Adaptations: + {% assign page_adaptations = page.adaptations | split: ' ' %} + {% for adaptation in page_adaptations %} + + {{ adaptation }} + + {% unless forloop.last %},{% endunless %} + {% endfor %} +
+{% endif %} +``` + +**File: `_config.yml` (jekyll-archives section)** + +```yaml +jekyll-archives: + books: + enabled: + - year + - categories + - tags + - adaptations + permalinks: + year: "/:collection/:year/" + categories: "/:collection/:type/:name/" + tags: "/:collection/:type/:name/" + adaptations: "/:collection/:type/:name/" +``` + +After rebuilding, users can browse books by adaptation at `/books/adaptations/movie/`, etc. + +## Adding a new publication + +To add publications create a new entry in the [\_bibliography/papers.bib](_bibliography/papers.bib) file. You can find the BibTeX entry of a publication in Google Scholar by clicking on the quotation marks below the publication title, then clicking on "BibTeX", or also in the conference page itself. By default, the publications will be sorted by year and the most recent will be displayed first. You can change this behavior and more in the `Jekyll Scholar` section in [\_config.yml](_config.yml) file. + +You can add extra information to a publication, like a PDF file in the `assets/pdfs/` directory and add the path to the PDF file in the BibTeX entry with the `pdf` field. Some of the supported fields are: `abstract`, `altmetric`, `annotation`, `arxiv`, `bibtex_show`, `blog`, `code`, `dimensions`, `doi`, `eprint`, `hal`, `html`, `isbn`, `pdf`, `pmid`, `poster`, `slides`, `supp`, `video`, and `website`. + +### Author annotation + +In publications, the author entry for yourself is identified by string array `scholar:last_name` and string array `scholar:first_name` in [\_config.yml](_config.yml). For example, if you have the following entry in your [\_config.yml](_config.yml): + +```yaml +scholar: + last_name: [Einstein] + first_name: [Albert, A.] +``` + +If the entry matches one form of the last names and the first names, it will be underlined. Keep meta-information about your co-authors in [\_data/coauthors.yml](_data/coauthors.yml) and Jekyll will insert links to their webpages automatically. The co-author data format is as follows, with the last names lower cased and without accents as the key: + +```yaml +"adams": + - firstname: ["Edwin", "E.", "E. P.", "Edwin Plimpton"] + url: https://en.wikipedia.org/wiki/Edwin_Plimpton_Adams + +"podolsky": + - firstname: ["Boris", "B.", "B. Y.", "Boris Yakovlevich"] + url: https://en.wikipedia.org/wiki/Boris_Podolsky + +"rosen": + - firstname: ["Nathan", "N."] + url: https://en.wikipedia.org/wiki/Nathan_Rosen + +"bach": + - firstname: ["Johann Sebastian", "J. S."] + url: https://en.wikipedia.org/wiki/Johann_Sebastian_Bach + + - firstname: ["Carl Philipp Emanuel", "C. P. E."] + url: https://en.wikipedia.org/wiki/Carl_Philipp_Emanuel_Bach +``` + +If the entry matches one of the combinations of the last names and the first names, it will be highlighted and linked to the url provided. Note that the keys **MUST BE** lower cased and **MUST NOT** contain accents. This is because the keys are used to match the last names in the BibTeX entries, considering possible variations (see [related discussion](https://github.com/alshedivat/al-folio/discussions/2213)). + +### Buttons (through custom bibtex keywords) + +There are several custom bibtex keywords that you can use to affect how the entries are displayed on the webpage: + +- `abbr`: Adds an abbreviation to the left of the entry. You can add links to these by creating a venue.yaml-file in the \_data folder and adding entries that match. +- `abstract`: Adds an "Abs" button that expands a hidden text field when clicked to show the abstract text +- `altmetric`: Adds an [Altmetric](https://www.altmetric.com/) badge (Note: if DOI is provided just use `true`, otherwise only add the altmetric identifier here - the link is generated automatically) +- `annotation`: Adds a popover info message to the end of the author list that can potentially be used to clarify superscripts. HTML is allowed. +- `arxiv`: Adds a link to the Arxiv website (Note: only add the arxiv identifier here - the link is generated automatically) +- `bibtex_show`: Adds a "Bib" button that expands a hidden text field with the full bibliography entry +- `blog`: Adds a "Blog" button redirecting to the specified link +- `code`: Adds a "Code" button redirecting to the specified link +- `dimensions`: Adds a [Dimensions](https://www.dimensions.ai/) badge (Note: if DOI or PMID is provided just use `true`, otherwise only add the Dimensions' identifier here - the link is generated automatically) +- `hal`: Adds a link to the HAL website (Note: only add the hal identifier (hal-xxx or tel-xxx) here - the link is generated automatically) +- `html`: Inserts an "HTML" button redirecting to the user-specified link +- `pdf`: Adds a "PDF" button redirecting to a specified file (if a full link is not specified, the file will be assumed to be placed in the /assets/pdf/ directory) +- `poster`: Adds a "Poster" button redirecting to a specified file (if a full link is not specified, the file will be assumed to be placed in the /assets/pdf/ directory) +- `slides`: Adds a "Slides" button redirecting to a specified file (if a full link is not specified, the file will be assumed to be placed in the /assets/pdf/ directory) +- `supp`: Adds a "Supp" button to a specified file (if a full link is not specified, the file will be assumed to be placed in the /assets/pdf/ directory) +- `website`: Adds a "Website" button redirecting to the specified link + +You can implement your own buttons by editing the [\_layouts/bib.liquid](_layouts/bib.liquid) file. + +## Changing theme color + +A variety of beautiful theme colors have been selected for you to choose from. The default is purple, but you can quickly change it by editing the `--global-theme-color` variable in the [\_sass/\_themes.scss](_sass/_themes.scss) file. Other color variables are listed there as well. The stock theme color options available can be found at [\_sass/\_variables.scss](_sass/_variables.scss). You can also add your own colors to this file assigning each a name for ease of use across the template. + +## Customizing layout and UI + +You can customize the layout and user interface in [\_config.yml](_config.yml): + +```yaml +back_to_top: true +footer_fixed: true +max_width: 930px +navbar_fixed: true +``` + +- `back_to_top`: Displays a "back to top" button in the footer. When clicked, it smoothly scrolls the page back to the top. +- `footer_fixed`: When `true`, the footer remains fixed at the bottom of the viewport. When `false`, it appears at the end of the page content. +- `max_width`: Controls the maximum width of the main content area in pixels. The default is `930px`. You can adjust this to make your content wider or narrower. +- `navbar_fixed`: When `true`, the navigation bar stays fixed at the top of the page when scrolling. When `false`, it scrolls with the page content. + +## Adding social media information + +Social media information is managed through the [`jekyll-socials` plugin](https://github.com/george-gca/jekyll-socials). To add your social media links: + +1. Edit [`_data/socials.yml`](_data/socials.yml) to add your social profiles +2. The plugin will automatically display the social icons based on the order they are defined in the file (see the comments at the top of `_data/socials.yml`) + +The template supports icons from: + +- [Academicons](https://jpswalsh.github.io/academicons/) +- [Font Awesome](https://fontawesome.com/) +- [Scholar Icons](https://louisfacun.github.io/scholar-icons/) + +Social media links will appear at the bottom of the `About` page and in the search results by default. You can customize this behavior in [`_config.yml`](_config.yml): + +- `enable_navbar_social: true` – Display social links in the navigation bar +- `socials_in_search: false` – Remove social links from search results + +For more details, see the [`jekyll-socials` documentation](https://github.com/george-gca/jekyll-socials). + +## Adding a newsletter + +You can add a newsletter subscription form by adding the specified information at the `newsletter` section in the [\_config.yml](_config.yml) file. To set up a newsletter, you can use a service like [Loops.so](https://loops.so/), which is the current supported solution. Once you have set up your newsletter, you can add the form [endpoint](https://loops.so/docs/forms/custom-form) to the `endpoint` field in the `newsletter` section of the [\_config.yml](_config.yml) file. + +Depending on your specified footer behavior, the sign up form either will appear at the bottom of the `About` page and at the bottom of blogposts if `related_posts` are enabled, or in the footer at the bottom of each page. + +## Configuring search features + +The theme includes a powerful search functionality that can be customized in [\_config.yml](_config.yml): + +```yaml +bib_search: true +posts_in_search: true +search_enabled: true +socials_in_search: true +``` + +- `bib_search`: Enables search within your publications/bibliography. When enabled, a search box appears on the publications page, allowing visitors to filter publications by title, author, venue, or year. +- `posts_in_search`: Includes blog posts in the search index. Users can search for posts by title, content, or tags. +- `search_enabled`: Enables the site-wide search feature. When enabled, a search box appears in the navigation bar, allowing users to search across your site content. +- `socials_in_search`: Includes your social media links and contact information in search results. This makes it easier for visitors to find ways to connect with you. + +All these search features work in real-time and do not require a page reload. + +## Social media previews + +**al-folio** supports Open Graph (OG) meta tags, which create rich preview objects when your pages are shared on social media platforms like Twitter, Facebook, LinkedIn, and others. These previews include your site's image, title, and description. + +### How to enable + +To enable social media previews: + +1. Open `_config.yml` and set: + + ```yaml + serve_og_meta: true + ``` + +2. Rebuild your site: + ```bash + docker compose down && docker compose up + # or + bundle exec jekyll serve + ``` + +Once enabled, all your site's pages will automatically include Open Graph meta tags in the HTML head element. + +### Configuring preview images + +You can configure what image displays in social media previews on a per-page or site-wide basis. + +**Site-wide default image:** + +Add the following to `_config.yml`: + +```yaml +og_image: /assets/img/your-default-preview-image.png +``` + +Replace the path with your actual image location in `assets/img/`. + +**Per-page custom image:** + +To override the site-wide default for a specific page, add `og_image` to the page's frontmatter: + +```yaml +--- +layout: page +title: My Page +og_image: /assets/img/custom-preview-image.png +--- +``` + +### Preview image best practices + +- **Dimensions:** Use 1200Γ—630 pixels for optimal display on most social media platforms +- **Format:** PNG or JPG formats work best +- **Size:** Keep file size under 5MB +- **Content:** Ensure the image clearly represents your page content + +When a page is shared on social media, the platform will display your configured image along with the page title, description (from your site title or page description), and URL. + +--- + +## Related posts + +The theme can automatically display related posts at the bottom of each blog post. These are selected by finding the most recent posts that share common tags with the current post. + +### How it works + +- By default, the most recent posts that share at least one tag with the current post are displayed +- You can customize how many posts are shown and how many tags must match +- You can disable related posts for individual posts or across your entire site + +### Configuration + +To customize related posts behavior, edit the `related_blog_posts` section in `_config.yml`: + +```yaml +related_blog_posts: + enabled: true + max_related: 5 +``` + +- `enabled`: Set to `true` (default) to show related posts, or `false` to disable them site-wide +- `max_related`: Maximum number of related posts to display (default: 5) + +The theme also uses tags to find related content. Make sure your blog posts include relevant tags in their frontmatter: + +```yaml +--- +layout: post +title: My Blog Post +tags: machine-learning python +--- +``` + +### Disable related posts for a specific post + +To hide related posts on an individual blog post, add this to the post's frontmatter: + +```yaml +--- +layout: post +title: My Blog Post +related_posts: false +--- +``` + +### Additional configuration in \_config.yml + +You can also customize related posts behavior with these settings: + +```yaml +related_blog_posts: + enabled: true + max_related: 5 +``` + +These settings control: + +- Which posts are considered "related" (based on shared tags) +- How many related posts to display +- The algorithm used to calculate post similarity (uses the `classifier-reborn` gem) + +--- + +## Managing publication display + +The theme offers several options for customizing how publications are displayed: + +```yaml +enable_publication_thumbnails: true +max_author_limit: 3 +more_authors_animation_delay: 10 +``` + +- `enable_publication_thumbnails`: When `true`, displays preview images for publications (if specified in the BibTeX entry with the `preview` field). Set to `false` to disable thumbnails for all publications. +- `max_author_limit`: Sets the maximum number of authors shown initially for each publication. If a publication has more authors, they are hidden behind a "more authors" link. Leave blank to always show all authors. +- `more_authors_animation_delay`: Controls the animation speed (in milliseconds) when revealing additional authors. A smaller value means faster animation. + +To add a thumbnail to a publication, include a `preview` field in your BibTeX entry: + +```bibtex +@article{example2024, + title={Example Paper}, + author={Author, First and Author, Second}, + journal={Example Journal}, + year={2024}, + preview={example_preview.png} +} +``` + +Place the image file in `assets/img/publication_preview/`. + +## Adding a Google Calendar + +You can embed a Google Calendar on any page by using the `calendar.liquid` include. + +### Basic usage + +Add the following to your page's Markdown file (for example, in `_pages/teaching.md`): + +```liquid +{% include calendar.liquid calendar_id='your-calendar-id@group.calendar.google.com' timezone='Your/Timezone' %} +``` + +Replace: + +- `your-calendar-id@group.calendar.google.com` with your actual Google Calendar ID (found in Google Calendar Settings β†’ Integrate calendar β†’ Calendar ID) +- `Your/Timezone` with your timezone (e.g., `UTC`, `Asia/Shanghai`, `America/New_York`). The default is `UTC`. + +### Enable the calendar script for your page + +To enable the calendar on your page, add `calendar: true` to the frontmatter: + +```yaml +--- +layout: page +title: teaching +calendar: true +--- +``` + +This setting prevents unnecessary script loading for pages that don't display a calendar. + +### Optional: Customize the calendar style + +You can optionally customize the iframe styling using the `style` parameter: + +```liquid +{% include calendar.liquid calendar_id='your-calendar-id@group.calendar.google.com' timezone='UTC' style='border:0; width:100%; height:800px;' %} +``` + +The default style is `border:0; width:100%; height:600px;`. + +## Updating third-party libraries + +The theme uses various third-party JavaScript and CSS libraries. You can manage these in the `third_party_libraries` section of [\_config.yml](_config.yml): + +```yaml +third_party_libraries: + download: false + bootstrap-table: + version: "1.22.4" + url: + css: "https://cdn.jsdelivr.net/npm/bootstrap-table@{{version}}/dist/bootstrap-table.min.css" + js: "https://cdn.jsdelivr.net/npm/bootstrap-table@{{version}}/dist/bootstrap-table.min.js" + integrity: + css: "sha256-..." + js: "sha256-..." +``` + +- `download`: When `false` (default), libraries are loaded from CDNs. When `true`, the specified library versions are downloaded during build and served from your site. This can improve performance but increases your repository size. +- `version`: Specifies which version of each library to use. Update this to use a newer version. +- `url`: Template URLs for loading the library. The `{{version}}` placeholder is replaced with the version number automatically. +- `integrity`: [Subresource Integrity (SRI)](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) hashes ensure that the library hasn't been tampered with. When updating a library version, you should also update its integrity hash. + +To update a library: + +1. Change the `version` number +2. Obtain the new integrity hash for the updated library version and update the `integrity` field with the new hash. You can: + - Check if the CDN provider (e.g., jsDelivr, cdnjs, unpkg) provides the SRI hash for the file. Many CDN sites display the SRI hash alongside the file URL. + - Generate the SRI hash yourself using a tool such as [SRI Hash Generator](https://www.srihash.org/) or by running the following command in your terminal: + + ```bash + curl -sL [FILE_URL] | openssl dgst -sha384 -binary | openssl base64 -A + ``` + + Replace `[FILE_URL]` with the URL of the library file. Then, prefix the result with `sha384-` and use it in the `integrity` field. + For detailed instructions on updating specific libraries, see the FAQ: + - [How can I update Academicons version](FAQ.md#how-can-i-update-academicons-version-on-the-template) + - [How can I update Font Awesome version](FAQ.md#how-can-i-update-font-awesome-version-on-the-template) + +## Removing content + +Since this template has a lot of content, you may want to remove some of it. The easiest way to achieve this and avoid merge conflicts when updating your code (as [pointed by CheariX ](https://github.com/alshedivat/al-folio/pull/2933#issuecomment-2571271117)) is to add the unwanted files to the `exclude` section in your `_config.yml` file instead of actually deleting them, for example: + +```yml +exclude: + - _news/announcement_*.md + - _pages/blog.md + - _posts/ + - _projects/?_project.md + - assets/jupyter/blog.ipynb +``` + +Here is a list of the main components that you may want to delete, and how to do it. Don't forget if you delete a page to update the `nav_order` of the remaining pages. + +### Removing the blog page + +To remove the blog, you have to: + +- delete [\_posts](_posts/) directory +- delete blog page [\_pages/blog.md](_pages/blog.md) +- remove reference to blog page in our [\_pages/dropdown.md](_pages/dropdown.md) +- remove the `latest_posts` part in [\_pages/about.md](_pages/about.md) +- remove the `Blog` section in the [\_config.yml](_config.yml) file and the related parts, like the `jekyll-archives` + +You can also: + +- delete [\_includes/latest_posts.liquid](_includes/latest_posts.liquid) +- delete [\_includes/related_posts.liquid](_includes/related_posts.liquid) +- delete [\_layouts/archive.liquid](_layouts/archive.liquid) (unless you have a custom collection that uses it) +- delete [\_plugins/external-posts.rb](_plugins/external-posts.rb) +- remove the `jekyll-archives-v2` gem from the [Gemfile](Gemfile) and the `plugins` section in [\_config.yml](_config.yml) (unless you have a custom collection that uses it) +- remove the `classifier-reborn` gem from the [Gemfile](Gemfile) + +### Removing the news section + +To remove the news section, you can: + +- delete the [\_news](_news/) directory +- delete the file [\_includes/news.liquid](_includes/news.liquid) and the references to it in the [\_pages/about.md](_pages/about.md) +- remove the `announcements` part in [\_pages/about.md](_pages/about.md) +- remove the news part in the `Collections` section in the [\_config.yml](_config.yml) file + +### Removing the projects page + +To remove the projects, you can: + +- delete the [\_projects](_projects/) directory +- delete the projects page [\_pages/projects.md](_pages/projects.md) +- remove reference to projects page in our [\_pages/dropdown.md](_pages/dropdown.md) +- remove projects part in the `Collections` section in the [\_config.yml](_config.yml) file + +You can also: + +- delete [\_includes/projects_horizontal.liquid](_includes/projects_horizontal.liquid) +- delete [\_includes/projects.liquid](_includes/projects.liquid) + +### Removing the publications page + +To remove the publications, you can: + +- delete the [\_bibliography](_bibliography/) directory +- delete the publications page [\_pages/publications.md](_pages/publications.md) +- remove reference to publications page in our [\_pages/dropdown.md](_pages/dropdown.md) +- remove `Jekyll Scholar` section in the [\_config.yml](_config.yml) file + +You can also: + +- delete the [\_layouts/bib.liquid](_layouts/bib.liquid) file +- delete [\_includes/bib_search.liquid](_includes/bib_search.liquid) +- delete [\_includes/citation.liquid](_includes/citation.liquid) +- delete [\_includes/selected_papers.liquid](_includes/selected_papers.liquid) +- delete [\_plugins/google-scholar-citations.rb](_plugins/google-scholar-citations.rb) +- delete [\_plugins/hide-custom-bibtex.rb](_plugins/hide-custom-bibtex.rb) +- delete [\_plugins/inspirehep-citations.rb](_plugins/inspirehep-citations.rb) +- remove the `jekyll-scholar` gem from the [Gemfile](Gemfile) and the `plugins` section in [\_config.yml](_config.yml) + +### Removing the repositories page + +To remove the repositories, you can: + +- delete the repositories page [\_pages/repositories.md](_pages/repositories.md) +- delete [\_includes/repository/](_includes/repository/) directory + +### You can also remove pages through commenting out front-matter blocks + +For `.md` files in [\_pages](_pages/) directory, if you do not want to completely edit or delete them but save for later use, you can temporarily disable these variables. But be aware that Jekyll only recognizes front matter when it appears as uncommented. The layout, permalink, and other front-matter behavior are disabled for that file. + +For example, books.md do: + +```md + + +> What an astonishing thing a book is. It's a flat object made from a tree with flexible parts on which are imprinted lots of funny dark squiggles. But one glance at it and you're inside the mind of another person, maybe somebody dead for thousands of years. Across the millennia, an author is speaking clearly and silently inside your head, directly to you. Writing is perhaps the greatest of human inventions, binding together people who never knew each other, citizens of distant epochs. Books break the shackles of time. A book is proof that humans are capable of working magic. +> +> -- Carl Sagan, Cosmos, Part 11: The Persistence of Memory (1980) + +## Books that I am reading, have read, or will read +``` + +## Adding Token for Lighthouse Badger + +To add secrets for [lighthouse-badger](https://github.com/alshedivat/al-folio/actions/workflows/lighthouse-badger.yml), create a [personal access token (PAT)](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token) and add it as a [secret](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions#creating-encrypted-secrets-for-a-repository) named `LIGHTHOUSE_BADGER_TOKEN` to your repository. The [lighthouse-badger documentation](https://github.com/MyActionWay/lighthouse-badger-workflows#lighthouse-badger-easyyml) specifies using an environment variable, but using it as a secret is more secure and appropriate for a PAT. + +Also In case you face the error: "Input required and not supplied: token" in the Lighthouse Badger action, this solution resolves it. + +### Personal Access Token (fine-grained) Permissions for Lighthouse Badger: + +- **contents**: access: read and write +- **metadata**: access: read-only + +Due to the necessary permissions (PAT and others mentioned above), it is recommended to use it as a secret rather than an environment variable. + +## Customizing fonts, spacing, and more + +The `_sass/` directory contains specialized SCSS files organized by feature and usage. To customize fonts, spacing, colors, and other styles, edit the relevant file based on what you're modifying: + +- **Typography:** Edit `_typography.scss` to change fonts, heading styles, links, tables, and blockquotes. +- **Navigation:** Edit `_navbar.scss` to customize the navigation bar and dropdown menus. +- **Colors and themes:** Edit `_themes.scss` to change theme colors and `_variables.scss` for global variables. +- **Blog styles:** Edit `_blog.scss` to customize blog post listings, tags, and pagination. +- **Publications:** Edit `_publications.scss` to modify bibliography and publication display styles. +- **Components:** Edit `_components.scss` to customize reusable components like cards, profiles, and projects. +- **Code and utilities:** Edit `_utilities.scss` for code highlighting, forms, modals, and animations. +- **Layout:** Edit `_layout.scss` for overall page layout styles. + +The easiest way to preview changes in advance is by using [Chrome dev tools](https://developer.chrome.com/docs/devtools/css) or [Firefox dev tools](https://firefox-source-docs.mozilla.org/devtools-user/). Inspect elements to see which styles apply and experiment with changes before editing the SCSS files. For more information on how to use these tools, check [Chrome](https://developer.chrome.com/docs/devtools/css) and [Firefox](https://firefox-source-docs.mozilla.org/devtools-user/page_inspector/how_to/examine_and_edit_css/index.html) how-tos, and [this tutorial](https://www.youtube.com/watch?v=l0sgiwJyEu4). + +## Scheduled Posts + +`al-folio` contains a workflow which automatically publishes all posts scheduled at a specific day, at the end of the day (23:30). By default the action is disabled, and to enable it you need to go to `.github/workflows/` and find the file called `schedule-posts.txt`. This is the workflow file. For GitHub to recognize it as one (or to enable the action), you need to rename it to `schedule-posts.yml`. + +In order to use this you need to save all of your "Completed" blog posts which are scheduled to be uploaded on a specific date, in a folder named `_scheduled/` in the root directory. + +> Incomplete posts should be saved in `_drafts/` + +### Name Format + +In this folder you need to store your file in the same format as you would in `_posts/` + +> Example file name: `2024-08-26-This file will be uploaded on 26 August.md` + +### Important Notes + +- The scheduler uploads posts everyday at πŸ•› 23:30 UTC +- It will only upload posts at 23:30 UTC of their respective scheduled days, It's not uploaded in 23:59 in case there are a lot of files as the scheduler must finish before 00:00 +- It will only upload files which follow the pattern `yyyy-mm-dd-title.md` + - This means that only markdown files will be posted + - It means that any markdown which do not follow this pattern will not be posted +- The scheduler works by moving posts from the `_scheduled/` directory to `_posts/`, it will not post to folders like `_projects/` or `_news/` +- The date in the name of the file is the day that file will be uploaded on + - `2024-08-27-file1.md` will not be posted before or after 27-August-2024 (Scheduler only works for posts scheduled on the present day) + - `2025-08-27-file2.md` will be posted exactly on 27-August-2025 + - `File3.md` will not be posted at all + - `2026-02-31-file4.md` is supposed to be posted on 31-February-2026, but there is no 31st in February hence this file will never be posted either + +## GDPR Cookie Consent Dialog + +**al-folio** includes a built-in GDPR-compliant cookie consent dialog to help you respect visitor privacy and comply with privacy regulations (GDPR, CCPA, etc.). The feature is powered by [Vanilla Cookie Consent](https://cookieconsent.orestbida.com/) and integrates with all analytics providers. + +### How it works + +- A consent dialog appears on the visitor's first visit to your site +- Visitors can **accept all**, **reject all**, or **customize preferences** for analytics cookies +- Analytics scripts (Google Analytics, Cronitor, Pirsch, Openpanel) are **blocked by default** and only run after explicit consent +- Google Consent Mode ensures Google services operate in privacy mode before consent is granted +- User preferences are saved in their browser and respected on subsequent visits +- The dialog is mobile-responsive and supports multiple languages + +### When to use + +- βœ… **Required** if your site serves EU visitors and uses any analytics +- βœ… Recommended for any website using analytics, tracking, or marketing tools +- ❌ Not needed if your site doesn't use any analytics providers + +### How to enable + +1. Open `_config.yml` and locate the following line: + + ```yaml + enable_cookie_consent: false + ``` + +2. Change it to: + + ```yaml + enable_cookie_consent: true + ``` + +3. Rebuild your site: + + ```bash + docker compose down && docker compose up + # or + bundle exec jekyll serve + ``` + +4. The consent dialog will automatically appear on your site's homepage on first visit + +### Customizing the consent dialog + +The consent dialog configuration and messages are defined in [`_scripts/cookie-consent-setup.js`](_scripts/cookie-consent-setup.js). You can customize: + +- Dialog titles and button labels +- Cookie categories and descriptions +- Contact information links (points to `#contact` by default) +- Language translations + +To modify the dialog, edit the `language.translations.en` section in `_scripts/cookie-consent-setup.js`. For example, to change the consent dialog title: + +```javascript +consentModal: { + title: 'Your custom title here', + description: 'Your custom description...', + // ... other options +} +``` + +### Supported analytics providers + +When cookie consent is enabled, these analytics providers are automatically blocked until the user consents: + +- **Google Analytics (GA4)** – Uses Google Consent Mode for privacy-first operation before consent +- **Cronitor RUM** – Real User Monitoring for performance tracking +- **Pirsch Analytics** – GDPR-compliant analytics alternative +- **Openpanel Analytics** – Privacy-focused analytics platform + +Each provider only collects data if: + +1. It's enabled in `_config.yml` (e.g., `enable_google_analytics: true`) +2. The user has granted consent to the "analytics" category in the consent dialog + +### How it integrates with analytics + +When `enable_cookie_consent: true`, the template automatically: + +1. Adds `type="text/plain" data-category="analytics"` to all analytics script tags +2. This tells the cookie consent library to block these scripts until consent is granted +3. Loads the consent library and initializes Google Consent Mode +4. Updates consent preferences when the user changes them in the dialog + +You don't need to modify any analytics configurationβ€”it works automatically. + +### For developers + +If you want to programmatically check consent status or react to consent changes, the library exposes the following: + +```javascript +// Check if user has granted analytics consent +window.CookieConsent.getCategories().analytics; // returns true or false + +// Listen for consent changes +window.CookieConsent.onChange(function (consentData) { + // Handle consent change +}); +``` + +For more API details, see [Vanilla Cookie Consent documentation](https://cookieconsent.orestbida.com/). + +--- + +## Setting up a Personal Access Token (PAT) for Google Scholar Citation Updates + +> [!TIP] +> After setting up al-folio you may want to run `python3 bin/update_citations.py` to fill the `_data/citations.yml` file with your Google Scholar citation counts. + +This project includes an automated workflow to update the citation counts for your publications using Google Scholar. +The workflow commits changes to `_data/citations.yml` directly to the `main` branch. +By default, the `GITHUB_TOKEN` will be used to commit the changes. +However, this token does not have permission to trigger subsequent workflows, such as the site rebuild workflow. +In order to deploy the changes from `main`, you can manually trigger the `deploy` workflow. + +> [!TIP] +> To ensure that these commits can trigger further GitHub Actions workflows (such as site rebuilds), you can use a Personal Access Token (PAT) instead of the default GitHub Actions token. +> If you have set up a PAT, citation updates will trigger further workflows (such as site rebuilds) after committing changes. In order to run the action with a PAT, you need to uncomment the following lines from the workflow file (`update-citations.yml`): +> +> ```yaml +> with: +> token: ${{ secrets.PAT }} +> ``` + +### Why is a PAT required? + +GitHub restricts the default `GITHUB_TOKEN` from triggering other workflows when a commit is made from within a workflow. Using a PAT overcomes this limitation and allows for full automation. + +### How to set up the PAT + +1. **Create a Personal Access Token** + - Go to [GitHub Settings > Developer settings > Personal access tokens](https://github.com/settings/tokens). + - Click "Generate new token" (classic or fine-grained). + - Grant at least the following permissions: + - `repo` (for classic tokens if repo is private), `public_repo` (for classic tokens if repo is public) or `contents: read/write` (for fine-grained tokens) + - Save the token somewhere safe. + +2. **Add the PAT as a repository secret** + - Go to your repository on GitHub. + - Navigate to `Settings` > `Secrets and variables` > `Actions` > `New repository secret`. + - Name the secret `PAT` (must match the name used in the workflow). + - Paste your PAT and save. + +3. **Workflow usage** + The workflow `.github/workflows/update-citations.yml` uses this PAT to commit updates to `_data/citations.yml`. diff --git a/Dockerfile b/Dockerfile index a1eb21a..99109cd 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,24 +1,76 @@ -FROM bitnami/minideb:latest -Label MAINTAINER Amir Pourmand -RUN apt-get update -y -# add locale -RUN apt-get -y install locales -# Set the locale +FROM ruby:slim + +# uncomment these if you are having this issue with the build: +# /usr/local/bundle/gems/jekyll-4.3.4/lib/jekyll/site.rb:509:in `initialize': Permission denied @ rb_sysopen - /srv/jekyll/.jekyll-cache/.gitignore (Errno::EACCES) +# ARG GROUPID=901 +# ARG GROUPNAME=ruby +# ARG USERID=901 +# ARG USERNAME=jekyll + +ENV DEBIAN_FRONTEND noninteractive + +LABEL authors="Amir Pourmand,George AraΓΊjo" \ + description="Docker image for al-folio academic template" \ + maintainer="Amir Pourmand" + +# uncomment these if you are having this issue with the build: +# /usr/local/bundle/gems/jekyll-4.3.4/lib/jekyll/site.rb:509:in `initialize': Permission denied @ rb_sysopen - /srv/jekyll/.jekyll-cache/.gitignore (Errno::EACCES) +# add a non-root user to the image with a specific group and user id to avoid permission issues +# RUN groupadd -r $GROUPNAME -g $GROUPID && \ +# useradd -u $USERID -m -g $GROUPNAME $USERNAME + +# install system dependencies +RUN apt-get update -y && \ + apt-get install -y --no-install-recommends \ + build-essential \ + curl \ + git \ + imagemagick \ + inotify-tools \ + locales \ + nodejs \ + procps \ + python3-pip \ + zlib1g-dev && \ + pip --no-cache-dir install --upgrade --break-system-packages nbconvert + +# clean up +RUN apt-get clean && \ + apt-get autoremove && \ + rm -rf /var/lib/apt/lists/* /var/cache/apt/archives/* /tmp/* + +# set the locale RUN sed -i '/en_US.UTF-8/s/^# //g' /etc/locale.gen && \ locale-gen -ENV LANG en_US.UTF-8 -ENV LANGUAGE en_US:en -ENV LC_ALL en_US.UTF-8 -# add ruby and jekyll -RUN apt-get install --no-install-recommends ruby-full build-essential zlib1g-dev -y -RUN apt-get install imagemagick -y -RUN apt-get clean \ - && rm -rf /var/lib/apt/lists/ -# ENV GEM_HOME='root/gems' \ -# PATH="root/gems/bin:${PATH}" -RUN gem install jekyll bundler +# set environment variables +ENV EXECJS_RUNTIME=Node \ + JEKYLL_ENV=production \ + LANG=en_US.UTF-8 \ + LANGUAGE=en_US:en \ + LC_ALL=en_US.UTF-8 + +# create a directory for the jekyll site RUN mkdir /srv/jekyll + +# copy the Gemfile and Gemfile.lock to the image +ADD Gemfile.lock /srv/jekyll ADD Gemfile /srv/jekyll + +# set the working directory WORKDIR /srv/jekyll -RUN bundle install \ No newline at end of file + +# install jekyll and dependencies +RUN gem install --no-document jekyll bundler +RUN bundle install --no-cache + +EXPOSE 8080 + +COPY bin/entry_point.sh /tmp/entry_point.sh + +# uncomment this if you are having this issue with the build: +# /usr/local/bundle/gems/jekyll-4.3.4/lib/jekyll/site.rb:509:in `initialize': Permission denied @ rb_sysopen - /srv/jekyll/.jekyll-cache/.gitignore (Errno::EACCES) +# set the ownership of the jekyll site directory to the non-root user +# USER $USERNAME + +CMD ["/tmp/entry_point.sh"] diff --git a/FAQ.md b/FAQ.md new file mode 100644 index 0000000..64d7581 --- /dev/null +++ b/FAQ.md @@ -0,0 +1,175 @@ +# Frequently Asked Questions + +Here are some frequently asked questions. If you have a different question, please check if it was not already answered in the Q&A section of the [GitHub Discussions](https://github.com/alshedivat/al-folio/discussions/categories/q-a). If not, feel free to ask a new question there. + + + +- [Frequently Asked Questions](#frequently-asked-questions) + - [After I create a new repository from this template and setup the repo, I get a deployment error. Isn't the website supposed to correctly deploy automatically?](#after-i-create-a-new-repository-from-this-template-and-setup-the-repo-i-get-a-deployment-error-isnt-the-website-supposed-to-correctly-deploy-automatically) + - [I am using a custom domain (e.g., foo.com). My custom domain becomes blank in the repository settings after each deployment. How do I fix that?](#i-am-using-a-custom-domain-eg-foocom-my-custom-domain-becomes-blank-in-the-repository-settings-after-each-deployment-how-do-i-fix-that) + - [My webpage works locally. But after deploying, it fails to build and throws Unknown tag 'toc'. How do I fix that?](#my-webpage-works-locally-but-after-deploying-it-fails-to-build-and-throws-unknown-tag-toc-how-do-i-fix-that) + - [My webpage works locally. But after deploying, it is not displayed correctly (CSS and JS are not loaded properly). How do I fix that?](#my-webpage-works-locally-but-after-deploying-it-is-not-displayed-correctly-css-and-js-are-not-loaded-properly-how-do-i-fix-that) + - [Atom feed doesn't work. Why?](#atom-feed-doesnt-work-why) + - [My site doesn't work when I enable related_blog_posts. Why?](#my-site-doesnt-work-when-i-enable-related_blog_posts-why) + - [When trying to deploy, it's asking for github login credentials, which github disabled password authentication and it exits with an error. How to fix?](#when-trying-to-deploy-its-asking-for-github-login-credentials-which-github-disabled-password-authentication-and-it-exits-with-an-error-how-to-fix) + - [When I manually run the Lighthouse Badger workflow, it fails with Error: Input required and not supplied: token. How do I fix that?](#when-i-manually-run-the-lighthouse-badger-workflow-it-fails-with-error-input-required-and-not-supplied-token-how-do-i-fix-that) + - [My code runs fine locally, but when I create a commit and submit it, it fails with prettier code formatter workflow run failed for main branch. How do I fix that?](#my-code-runs-fine-locally-but-when-i-create-a-commit-and-submit-it-it-fails-with-prettier-code-formatter-workflow-run-failed-for-main-branch-how-do-i-fix-that) + - [After I update my site with some new content, even a small change, the GitHub action throws an error or displays a warning. What happened?](#after-i-update-my-site-with-some-new-content-even-a-small-change-the-github-action-throws-an-error-or-displays-a-warning-what-happened) + - [I am trying to deploy my site, but it fails with Could not find gem 'jekyll-diagrams' in locally installed gems. How do I fix that?](#i-am-trying-to-deploy-my-site-but-it-fails-with-could-not-find-gem-jekyll-diagrams-in-locally-installed-gems-how-do-i-fix-that) + - [How can I update Academicons version on the template](#how-can-i-update-academicons-version-on-the-template) + - [How can I update Font Awesome version on the template](#how-can-i-update-font-awesome-version-on-the-template) + - [What do all these GitHub actions/workflows mean?](#what-do-all-these-github-actionsworkflows-mean) + - [How can I use Google Search Console ID on the template?](#how-can-i-use-google-search-console-id-on-the-template) + - [What are Code Wiki and DeepWiki?](#what-are-code-wiki-and-deepwiki) + - [When to use these tools](#when-to-use-these-tools) + - [What they do](#what-they-do) + - [Limitations](#limitations) + - [Access these tools](#access-these-tools) + + + +## After I create a new repository from this template and setup the repo, I get a deployment error. Isn't the website supposed to correctly deploy automatically? + +Yes, if you are using release `v0.3.5` or later, the website will automatically and correctly re-deploy right after your first commit. Please make some changes (e.g., change your website info in `_config.yml`), commit, and push. Make sure to follow [deployment instructions](https://github.com/alshedivat/al-folio#deployment). (Relevant issue: [209](https://github.com/alshedivat/al-folio/issues/209#issuecomment-798849211).) + +## I am using a custom domain (e.g., `foo.com`). My custom domain becomes blank in the repository settings after each deployment. How do I fix that? + +You need to add `CNAME` file to the `main` or `source` branch of your repository. The file should contain your custom domain name. (Relevant issue: [130](https://github.com/alshedivat/al-folio/issues/130).) + +## My webpage works locally. But after deploying, it fails to build and throws `Unknown tag 'toc'`. How do I fix that? + +Make sure you followed through the [deployment instructions](#deployment) in the previous section. You should have set the deployment branch to `gh-pages`. (Related issue: [1438](https://github.com/alshedivat/al-folio/issues/1438).) + +## My webpage works locally. But after deploying, it is not displayed correctly (CSS and JS are not loaded properly). How do I fix that? + +If the website does not load the theme, the layout looks weird, and all links are broken, being the main page displayed this way: + + + +make sure to correctly specify the `url` and `baseurl` paths in `_config.yml`. Set `url` to `https://.github.io` or to `https://` if you are using a custom domain. If you are deploying a personal or organization website, leave `baseurl` **empty** (do **NOT** delete it). If you are deploying a project page, set `baseurl: //`. If all previous steps were done correctly, all is missing is for your browser to fetch again the site stylesheet. For this, you can: + +- press [Shift + F5 on Chromium-based](https://support.google.com/chrome/answer/157179#zippy=%2Cwebpage-shortcuts) or [Ctrl + F5 on Firefox-based](https://support.mozilla.org/en-US/kb/keyboard-shortcuts-perform-firefox-tasks-quickly) browsers to reload the page ignoring cached content +- clean your browser history +- simply try it in a private session, here's how to do it in [Chrome](https://support.google.com/chrome/answer/95464) and [Firefox](https://support.mozilla.org/en-US/kb/private-browsing-use-firefox-without-history) + +## Atom feed doesn't work. Why? + +Make sure to correctly specify the `url` and `baseurl` paths in `_config.yml`. RSS Feed plugin works with these correctly set up fields: `title`, `url`, `description` and `author`. Make sure to fill them in an appropriate way and try again. + +## My site doesn't work when I enable `related_blog_posts`. Why? + +This is probably due to the [classifier reborn](https://github.com/jekyll/classifier-reborn) plugin, which is used to calculate related posts. If the error states `Liquid Exception: Zero vectors can not be normalized...` or `sqrt': Numerical argument is out of domain - "sqrt"`, it means that it could not calculate related posts for a specific post. This is usually caused by [empty or minimal blog posts](https://github.com/jekyll/classifier-reborn/issues/64) without meaningful words (i.e. only [stop words](https://en.wikipedia.org/wiki/Stop_words)) or even [specific characters](https://github.com/jekyll/classifier-reborn/issues/194) you used in your posts. Also, the calculus for similar posts are made for every `post`, which means every page that uses `layout: post`, including the announcements. To change this behavior, simply add `related_posts: false` to the front matter of the page you don't want to display related posts on. Another solution is to disable the lsi (latent semantic indexing) entirely by setting the `lsi` flag to `false` in `_config.yml`. Related issue: [#1828](https://github.com/alshedivat/al-folio/issues/1828). + +## When trying to deploy, it's asking for github login credentials, which github disabled password authentication and it exits with an error. How to fix? + +Open .git/config file using your preferred editor. Change the `https` portion of the `url` variable to `ssh`. Try deploying again. + +## When I manually run the Lighthouse Badger workflow, it fails with `Error: Input required and not supplied: token`. How do I fix that? + +You need to [create a personal access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token) and [add it as a secret](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions#creating-encrypted-secrets-for-a-repository) named `LIGHTHOUSE_BADGER_TOKEN` to your repository. For more information, check [lighthouse-badger documentation](https://github.com/MyActionWay/lighthouse-badger-workflows#lighthouse-badger-easyyml) on how to do this. + +## My code runs fine locally, but when I create a commit and submit it, it fails with `prettier code formatter workflow run failed for main branch`. How do I fix that? + +We implemented support for [Prettier code formatting](https://prettier.io/) in [#2048](https://github.com/alshedivat/al-folio/pull/2048). It basically ensures that your code is [well formatted](https://prettier.io/docs/en/). If you want to ensure your code is compliant with `Prettier`, you have a few options: + +- if you are running locally with `Docker` and using [development containers](https://github.com/alshedivat/al-folio/blob/main/INSTALL.md#local-setup-with-development-containers), `Prettier` is already included +- if you don't use `Docker`, it is simple to integrate it with your preferred IDE using an [extension](https://prettier.io/docs/en/editors) +- if you want to run it manually, you can follow the first 2 steps in [this tutorial](https://george-gca.github.io/blog/2023/slidev_for_non_web_devs/) (`Installing node version manager (nvm)` and `Installing Node (latest version)`), then, install it using `npm install prettier` inside the project directory, or install it globally on your computer using `npm install -g prettier`. To run `Prettier` on your current directory use `npx prettier . --write`. + +You can also disable it for your repo. For this, just delete the file [.github/workflows/prettier.yml](https://github.com/alshedivat/al-folio/blob/main/.github/workflows/prettier.yml). + +## After I update my site with some new content, even a small change, the GitHub action throws an error or displays a warning. What happened? + +Probably your GitHub workflow is throwing an error like this: + +```bash +/opt/hostedtoolcache/Ruby/3.0.2/x64/lib/ruby/gems/3.0.0/gems/bundler-2.5.5/lib/bundler/runtime.rb:304:in `check_for_activated_spec!': You have already activated uri 0.10.1, but your Gemfile requires uri 0.13.0. Since uri is a default gem, you can either remove your dependency on it or try updating to a newer version of bundler that supports uri as a default gem. (Gem::LoadError) +``` + +or maybe displaying a warning like one of these: + +``` +Node.js 16 actions are deprecated. Please update the following actions to use Node.js 20: actions/checkout@v3. For more information see: https://github.blog/changelog/2023-09-22-github-actions-transitioning-from-node-16-to-node-20/. +Node.js 16 actions are deprecated. Please update the following actions to use Node.js 20: actions/checkout@v2, actions/cache@v2. For more information see: https://github.blog/changelog/2023-09-22-github-actions-transitioning-from-node-16-to-node-20/. +The following actions uses node12 which is deprecated and will be forced to run on node16: actions/checkout@v2, actions/cache@v2. For more info: https://github.blog/changelog/2023-06-13-github-actions-all-actions-will-run-on-node16-instead-of-node12-by-default/ +The `set-output` command is deprecated and will be disabled soon. Please upgrade to using Environment Files. For more information see: https://github.blog/changelog/2022-10-11-github-actions-deprecating-save-state-and-set-output-commands/ +``` + +If that's the case, you are using deprecated libraries/commands. This happens because you are using a very old version of al-folio. To fix this it is recommended [upgrading your code to the latest version](INSTALL.md#upgrading-from-a-previous-version) of the template. You will probably need to do some manual merging. If you find it easier, you could create a copy of your repository, do a fresh installation from the template and reapply all your changes. For this I would recommend a tool like [meld](https://meldmerge.org/) or [winmerge](https://winmerge.org/) to check the differences between directories/files. + +Note that libraries tend to be deprecated and support for them dropped as they are no longer maintained, and keep using them involves security breaches. Also, some of these deprecations are enforced, for example, by GitHub itself, so there's so much we can do. We have also added tons of new functionality, as well as tidying things up and improving the overall speed and structure, so you could also benefit from these improvements. + +## I am trying to deploy my site, but it fails with `Could not find gem 'jekyll-diagrams' in locally installed gems`. How do I fix that? + +`jekyll-diagrams` support was dropped in [#1992](https://github.com/alshedivat/al-folio/pull/1992) in favor of using `mermaid.js` directly. Simply [update your code](INSTALL.md#upgrading-from-a-previous-version) to get the latest changes. + +## How can I update Academicons version on the template + +To update the Academicons version, you need to download the latest release from the [Academicons website](https://jpswalsh.github.io/academicons/). After downloading, extract the zip file and copy the files `academicons.ttf` and `academicons.woff` from the `fonts/` directory to `assets/fonts/` and the file `academicons.min.css` from the `css/` directory to `assets/css/`. + +## How can I update Font Awesome version on the template + +To update the Font Awesome version, you need to download the latest release "for the web" from the [Font Awesome website](https://fontawesome.com/download). After downloading, extract the zip file and copy the `scss/` directory content to `_sass/font-awesome/` and the `webfonts/` content to `assets/webfonts/`. + +## What do all these GitHub actions/workflows mean? + +GitHub actions are a way to automate tasks in the repository. They are defined in `.github/workflows/` directory. Each file in this directory is a workflow. Workflows are made up of one or more jobs, and each job runs on a virtual machine hosted by GitHub. You can see the status of the workflows in the `Actions` tab of your repository. For more information, check the [GitHub Actions documentation](https://docs.github.com/en/actions). + +Currently we have the following workflows: + +- `axe.yml`: does some accessibility testing in your site. It uses the [axe cli](https://github.com/dequelabs/axe-core-npm/tree/develop/packages/cli) tool with a chrome driver to render the webpage and allow the analysis. Must be run manually, since fixing some of the issues is not straightforward +- `broken-links-site.yml`: checks for broken links in your built website with the [lychee-action](https://github.com/lycheeverse/lychee-action) +- `broken-links.yml`: checks for broken links in your repository with the [lychee-action](https://github.com/lycheeverse/lychee-action) +- `deploy-docker-tag.yml`: adds some metadata to the docker image and pushes it to Docker Hub +- `deploy-image.yml`: deploys a new docker image with the latest changes to Docker Hub +- `deploy.yml`: deploys the website to GitHub Pages +- `docker-slim.yml`: deploys a smaller version of the docker image to Docker Hub with the [docker-slim-action](https://github.com/kitabisa/docker-slim-action) +- `lighthouse-badger.yml`: runs a [lighthouse](https://github.com/GoogleChrome/lighthouse) test for your site with the [lighthouse-badger-action](https://github.com/MyActionWay/lighthouse-badger-action), saving the results in the repository for easy inspecting, as can be seen [here](https://github.com/alshedivat/al-folio?tab=readme-ov-file#lighthouse-pagespeed-insights). For more information on how to enable this workflow, check our [FAQ question about it](https://github.com/alshedivat/al-folio/blob/main/FAQ.md#when-i-manually-run-the-lighthouse-badger-workflow-it-fails-with-error-input-required-and-not-supplied-token-how-do-i-fix-that) +- `prettier-comment-on-pr.yml`: not working. For now, this action is disabled. It was supposed to run prettier on the PRs and comment on them with the changes needed. For more information, check [issue 2115](https://github.com/alshedivat/al-folio/issues/2115) +- `prettier.yml`: runs [prettier](https://prettier.io/) on the code to ensure it is well formatted. For more information, check our [FAQ question about it](https://github.com/alshedivat/al-folio/blob/main/FAQ.md#my-code-runs-fine-locally-but-when-i-create-a-commit-and-submit-it-it-fails-with-prettier-code-formatter-workflow-run-failed-for-main-branch-how-do-i-fix-that) + +## How can I use Google Search Console ID on the template? + +In the configuration file `_config.yml` the tag `google-site-verification` should be updated to use this functionality. Here is how you can proceed, + +- Generate your HTML tag by following [https://support.google.com/webmasters/answer/9008080?hl=en#meta_tag_verification&zippy=%2Chtml-tag](https://support.google.com/webmasters/answer/9008080?hl=en#meta_tag_verification&zippy=%2Chtml-tag) with URL prefix option. +- In the verify ownership option choose HTML tag and copy the tag contents which should look like ``. +- The string against `content` is the Google Search Console ID that can be used in the template. e.g. `google-site-verification: GoogleSearchConsoleID`. Now set the property `enable_google_verification: true`. + +It looks like the Domain type property in the Google Search Console to verify the ownership of all URLs across all subdomains with GitHub Pages does not work. + +## What are Code Wiki and DeepWiki? + +**Code Wiki** and **DeepWiki** are AI-powered tools that help you understand GitHub repositories through interactive documentation. They should be treated as supplementary resources when you cannot find the information you need in the official project documentation. + +### When to use these tools + +**Use Code Wiki and DeepWiki only after**: + +- You have reviewed the relevant documentation files in this repository (`README.md`, `INSTALL.md`, `CUSTOMIZE.md`, `FAQ.md`, or `CONTRIBUTING.md`) +- You have checked the [GitHub Discussions Q&A section](https://github.com/alshedivat/al-folio/discussions/categories/q-a) for similar questions +- You have searched existing [GitHub Issues](https://github.com/alshedivat/al-folio/issues) + +### What they do + +**Code Wiki** (powered by Google Gemini) generates interactive documentation from your repository code. It allows you to: + +- Browse your repository's structure and architecture +- Search for specific functions or modules +- Understand how different parts of the codebase work together +- Get diagrams and visual representations of your code architecture + +**DeepWiki** provides an AI-powered interface to ask questions about a repository, similar to having an engineer available 24/7. It allows you to: + +- Ask natural language questions about the codebase +- Get instant answers about how specific features work +- Search for code patterns and implementations + +### Limitations + +These tools are generated automatically from our code and may not always reflect the most current documentation standards or best practices specific to this project. They should not replace official documentation but rather complement it when you need deeper technical insights. + +### Access these tools + +- **Code Wiki**: [Code Wiki for al-folio](https://codewiki.google/github.com/alshedivat/al-folio) +- **DeepWiki**: [DeepWiki for al-folio](https://deepwiki.com/alshedivat/al-folio) diff --git a/Gemfile b/Gemfile index 0cc778f..22714e2 100644 --- a/Gemfile +++ b/Gemfile @@ -1,24 +1,45 @@ source 'https://rubygems.org' + +gem 'jekyll' + +# Core plugins that directly affect site building group :jekyll_plugins do - gem 'jekyll' - gem 'jekyll-archives' - gem 'jekyll-diagrams' + gem 'jekyll-3rd-party-libraries' + gem 'jekyll-archives-v2' + gem 'jekyll-cache-bust' gem 'jekyll-email-protect' gem 'jekyll-feed' + gem 'jekyll-get-json' gem 'jekyll-imagemagick' + gem 'jekyll-jupyter-notebook' + gem 'jekyll-link-attributes' gem 'jekyll-minifier' gem 'jekyll-paginate-v2' + gem 'jekyll-regex-replace' gem 'jekyll-scholar' gem 'jekyll-sitemap' - gem 'jekyll-link-attributes' + gem 'jekyll-socials' + gem 'jekyll-tabs' + gem 'jekyll-terser', :git => "https://github.com/RobertoJBeltran/jekyll-terser.git" + gem 'jekyll-toc' gem 'jekyll-twitter-plugin' gem 'jemoji' gem 'jekyll-pandoc' gem 'mini_racer' gem 'unicode_utils' gem 'webrick' + + gem 'classifier-reborn' # used for content categorization during the build end + +# Gems for development or external data fetching (outside :jekyll_plugins) group :other_plugins do - gem 'httparty' + gem 'css_parser' gem 'feedjira' + gem 'httparty' + gem 'observer' # used by jekyll-scholar + gem 'ostruct' # used by jekyll-twitter-plugin + # gem 'terser' # used by jekyll-terser + # gem 'unicode_utils' -- should be already installed by jekyll + # gem 'webrick' -- should be already installed by jekyll end diff --git a/Gemfile.lock b/Gemfile.lock new file mode 100644 index 0000000..ed9d3b6 --- /dev/null +++ b/Gemfile.lock @@ -0,0 +1,329 @@ +GIT + remote: https://github.com/RobertoJBeltran/jekyll-terser.git + revision: 1085bf66d692799af09fe39f8162a1e6e42a3cc4 + specs: + jekyll-terser (0.2.3) + jekyll (>= 0.10.0) + terser (>= 1.0.0) + +GEM + remote: https://rubygems.org/ + specs: + activesupport (8.1.2) + base64 + bigdecimal + concurrent-ruby (~> 1.0, >= 1.3.1) + connection_pool (>= 2.2.5) + drb + i18n (>= 1.6, < 2) + json + logger (>= 1.4.2) + minitest (>= 5.1) + securerandom (>= 0.3) + tzinfo (~> 2.0, >= 2.0.5) + uri (>= 0.13.1) + addressable (2.8.8) + public_suffix (>= 2.0.2, < 8.0) + base64 (0.3.0) + bibtex-ruby (6.2.0) + latex-decode (~> 0.0) + logger (~> 1.7) + racc (~> 1.7) + bigdecimal (4.0.1) + citeproc (1.1.0) + date + forwardable + json + namae (~> 1.0) + observer (< 1.0) + open-uri (< 1.0) + citeproc-ruby (2.1.8) + citeproc (~> 1.0, >= 1.0.9) + csl (~> 2.0) + observer (< 1.0) + classifier-reborn (2.3.0) + fast-stemmer (~> 1.0) + matrix (~> 0.4) + colorator (1.1.0) + concurrent-ruby (1.3.6) + connection_pool (3.0.2) + crass (1.0.6) + csl (2.2.1) + forwardable (~> 1.3) + namae (~> 1.2) + open-uri (< 1.0) + rexml (~> 3.0) + set (~> 1.1) + singleton (< 1.0) + time (< 1.0) + csl-styles (2.0.2) + csl (~> 2.0) + css_parser (1.21.1) + addressable + cssminify2 (2.1.0) + csv (3.3.5) + date (3.5.1) + deep_merge (1.2.2) + drb (2.2.3) + em-websocket (0.5.3) + eventmachine (>= 0.12.9) + http_parser.rb (~> 0) + eventmachine (1.2.7) + execjs (2.10.0) + fast-stemmer (1.0.2) + feedjira (4.0.1) + logger (>= 1.0, < 2) + loofah (>= 2.3.1, < 3) + sax-machine (>= 1.0, < 2) + ffi (1.17.3-aarch64-linux-gnu) + ffi (1.17.3-aarch64-linux-musl) + ffi (1.17.3-arm-linux-gnu) + ffi (1.17.3-arm-linux-musl) + ffi (1.17.3-arm64-darwin) + ffi (1.17.3-x86_64-darwin) + ffi (1.17.3-x86_64-linux-gnu) + ffi (1.17.3-x86_64-linux-musl) + forwardable (1.4.0) + forwardable-extended (2.6.0) + gemoji (4.1.0) + google-protobuf (4.33.4) + bigdecimal + rake (>= 13) + google-protobuf (4.33.4-aarch64-linux-gnu) + bigdecimal + rake (>= 13) + google-protobuf (4.33.4-aarch64-linux-musl) + bigdecimal + rake (>= 13) + google-protobuf (4.33.4-arm64-darwin) + bigdecimal + rake (>= 13) + google-protobuf (4.33.4-x86_64-darwin) + bigdecimal + rake (>= 13) + google-protobuf (4.33.4-x86_64-linux-gnu) + bigdecimal + rake (>= 13) + google-protobuf (4.33.4-x86_64-linux-musl) + bigdecimal + rake (>= 13) + html-pipeline (2.14.3) + activesupport (>= 2) + nokogiri (>= 1.4) + htmlcompressor (0.4.0) + http_parser.rb (0.8.1) + httparty (0.24.2) + csv + mini_mime (>= 1.0.0) + multi_xml (>= 0.5.2) + i18n (1.14.8) + concurrent-ruby (~> 1.0) + jekyll-3rd-party-libraries (0.0.1) + css_parser (>= 1.6, < 2.0) + jekyll (>= 3.6, < 5.0) + nokogiri (>= 1.8, < 2.0) + jekyll (4.4.1) + addressable (~> 2.4) + base64 (~> 0.2) + colorator (~> 1.0) + csv (~> 3.0) + em-websocket (~> 0.5) + i18n (~> 1.0) + jekyll-sass-converter (>= 2.0, < 4.0) + jekyll-watch (~> 2.0) + json (~> 2.6) + kramdown (~> 2.3, >= 2.3.1) + kramdown-parser-gfm (~> 1.0) + liquid (~> 4.0) + mercenary (~> 0.3, >= 0.3.6) + pathutil (~> 0.9) + rouge (>= 3.0, < 5.0) + safe_yaml (~> 1.0) + terminal-table (>= 1.8, < 4.0) + webrick (~> 1.7) + jekyll-archives-v2 (0.0.7) + activesupport + jekyll (>= 3.6, < 5.0) + jekyll-cache-bust (0.0.1) + jekyll (>= 3.6, < 5.0) + jekyll-email-protect (1.1.0) + jekyll-feed (0.17.0) + jekyll (>= 3.7, < 5.0) + jekyll-get-json (1.0.0) + deep_merge (~> 1.2) + jekyll (>= 3.0) + jekyll-imagemagick (1.4.0) + jekyll (>= 3.4) + jekyll-jupyter-notebook (0.0.6) + jekyll + jekyll-link-attributes (1.0.1) + jekyll-minifier (0.2.2) + cssminify2 (~> 2.1.0) + htmlcompressor (~> 0.4) + jekyll (~> 4.0) + json-minify (~> 0.0.3) + terser (~> 1.2.3) + jekyll-paginate-v2 (3.0.0) + jekyll (>= 3.0, < 5.0) + jekyll-regex-replace (1.1.0) + jekyll-sass-converter (3.1.0) + sass-embedded (~> 1.75) + jekyll-scholar (7.3.0) + bibtex-ruby (~> 6.0) + citeproc-ruby (>= 2.1.6) + csl-styles (~> 2.0) + jekyll (~> 4.0) + jekyll-sitemap (1.4.0) + jekyll (>= 3.7, < 5.0) + jekyll-socials (0.0.6) + jekyll (>= 3.6, < 5.0) + jekyll-tabs (1.2.1) + jekyll (>= 3.0, < 5.0) + jekyll-toc (0.19.0) + jekyll (>= 3.9) + nokogiri (~> 1.12) + jekyll-twitter-plugin (2.1.0) + jekyll-watch (2.2.1) + listen (~> 3.0) + jemoji (0.13.0) + gemoji (>= 3, < 5) + html-pipeline (~> 2.2) + jekyll (>= 3.0, < 5.0) + json (2.18.0) + json-minify (0.0.3) + json (> 0) + kramdown (2.5.2) + rexml (>= 3.4.4) + kramdown-parser-gfm (1.1.0) + kramdown (~> 2.0) + latex-decode (0.4.2) + liquid (4.0.4) + listen (3.10.0) + logger + rb-fsevent (~> 0.10, >= 0.10.3) + rb-inotify (~> 0.9, >= 0.9.10) + logger (1.7.0) + loofah (2.25.0) + crass (~> 1.0.2) + nokogiri (>= 1.12.0) + matrix (0.4.3) + mercenary (0.4.0) + mini_mime (1.1.5) + minitest (6.0.1) + prism (~> 1.5) + multi_xml (0.8.1) + bigdecimal (>= 3.1, < 5) + namae (1.2.0) + racc (~> 1.7) + nokogiri (1.19.0-aarch64-linux-gnu) + racc (~> 1.4) + nokogiri (1.19.0-aarch64-linux-musl) + racc (~> 1.4) + nokogiri (1.19.0-arm-linux-gnu) + racc (~> 1.4) + nokogiri (1.19.0-arm-linux-musl) + racc (~> 1.4) + nokogiri (1.19.0-arm64-darwin) + racc (~> 1.4) + nokogiri (1.19.0-x86_64-darwin) + racc (~> 1.4) + nokogiri (1.19.0-x86_64-linux-gnu) + racc (~> 1.4) + nokogiri (1.19.0-x86_64-linux-musl) + racc (~> 1.4) + observer (0.1.2) + open-uri (0.5.0) + stringio + time + uri + ostruct (0.6.3) + pathutil (0.16.2) + forwardable-extended (~> 2.6) + prism (1.8.0) + public_suffix (7.0.2) + racc (1.8.1) + rake (13.3.1) + rb-fsevent (0.11.2) + rb-inotify (0.11.1) + ffi (~> 1.0) + rexml (3.4.4) + rouge (4.7.0) + safe_yaml (1.0.5) + sass-embedded (1.97.2-aarch64-linux-gnu) + google-protobuf (~> 4.31) + sass-embedded (1.97.2-aarch64-linux-musl) + google-protobuf (~> 4.31) + sass-embedded (1.97.2-arm-linux-gnueabihf) + google-protobuf (~> 4.31) + sass-embedded (1.97.2-arm-linux-musleabihf) + google-protobuf (~> 4.31) + sass-embedded (1.97.2-arm64-darwin) + google-protobuf (~> 4.31) + sass-embedded (1.97.2-x86_64-darwin) + google-protobuf (~> 4.31) + sass-embedded (1.97.2-x86_64-linux-gnu) + google-protobuf (~> 4.31) + sass-embedded (1.97.2-x86_64-linux-musl) + google-protobuf (~> 4.31) + sax-machine (1.3.2) + securerandom (0.4.1) + set (1.1.2) + singleton (0.3.0) + stringio (3.2.0) + terminal-table (3.0.2) + unicode-display_width (>= 1.1.1, < 3) + terser (1.2.6) + execjs (>= 0.3.0, < 3) + time (0.4.2) + date + tzinfo (2.0.6) + concurrent-ruby (~> 1.0) + unicode-display_width (2.6.0) + uri (1.1.1) + webrick (1.9.2) + +PLATFORMS + aarch64-linux + aarch64-linux-gnu + aarch64-linux-musl + arm-linux-gnu + arm-linux-gnueabihf + arm-linux-musl + arm-linux-musleabihf + arm64-darwin + x86_64-darwin + x86_64-linux + x86_64-linux-gnu + x86_64-linux-musl + +DEPENDENCIES + classifier-reborn + css_parser + feedjira + httparty + jekyll + jekyll-3rd-party-libraries + jekyll-archives-v2 + jekyll-cache-bust + jekyll-email-protect + jekyll-feed + jekyll-get-json + jekyll-imagemagick + jekyll-jupyter-notebook + jekyll-link-attributes + jekyll-minifier + jekyll-paginate-v2 + jekyll-regex-replace + jekyll-scholar + jekyll-sitemap + jekyll-socials + jekyll-tabs + jekyll-terser! + jekyll-toc + jekyll-twitter-plugin + jemoji + observer + ostruct + +BUNDLED WITH + 4.0.4 diff --git a/INSTALL.md b/INSTALL.md new file mode 100644 index 0000000..181b776 --- /dev/null +++ b/INSTALL.md @@ -0,0 +1,296 @@ +# Installing and Deploying + + + +- [Installing and Deploying](#installing-and-deploying) + - [Recommended Approach](#recommended-approach) + - [Template vs. Fork: Which Should I Use?](#template-vs-fork-which-should-i-use) + - [Important Notes for GitHub Pages Sites](#important-notes-for-github-pages-sites) + - [Automatic Deployment](#automatic-deployment) + - [Local Development](#local-development) + - [Local setup on Windows](#local-setup-on-windows) + - [Local setup using Docker (Recommended)](#local-setup-using-docker-recommended) + - [Build your own docker image](#build-your-own-docker-image) + - [Have Bugs on Docker Image?](#have-bugs-on-docker-image) + - [Local Setup with Development Containers](#local-setup-with-development-containers) + - [Local Setup (Legacy, no longer supported)](#local-setup-legacy-no-longer-supported) + - [Deployment](#deployment) + - [For personal and organization webpages](#for-personal-and-organization-webpages) + - [For project pages](#for-project-pages) + - [Enabling automatic deployment](#enabling-automatic-deployment) + - [Manual deployment to GitHub Pages](#manual-deployment-to-github-pages) + - [Deploy on Netlify](https://www.netlify.com/) + - [Deployment to another hosting server (non GitHub Pages)](#deployment-to-another-hosting-server-non-github-pages) + - [Deployment to a separate repository (advanced users only)](#deployment-to-a-separate-repository-advanced-users-only) + - [Maintaining Dependencies](#maintaining-dependencies) + - [Upgrading from a previous version](#upgrading-from-a-previous-version) + + + +## Recommended Approach + +The recommended approach for using **al-folio** is to first create your own site using the template with as few changes as possible, and only when it is up and running customize it however you like. This way it is easier to pinpoint what causes a potential issue in case of a bug. + +**For the quickest setup**, follow the [Quick Start Guide](QUICKSTART.md), which will have you up and running in 5 minutes. + +### Template vs. Fork: Which Should I Use? + +**Use the "Use this template" button** (recommended) when creating your own al-folio site. This creates a clean, independent copy that is not linked to the main al-folio repository. + +**If you already forked the repository**, your fork will work fine, but you should be aware of a common pitfall: + +- Forks maintain a connection to the original repository, which can make it easy to accidentally submit pull requests to al-folio with your personal site changes +- **Solution:** When making changes to your fork, always create a new branch (e.g., `git checkout -b my-site-updates`) and verify that you're pushing to **your own fork** before submitting pull requests +- Only submit pull requests to `alshedivat/al-folio` if you're intentionally contributing improvements that benefit the entire al-folio community + +### Important Notes for GitHub Pages Sites + +If you plan to upload your site to `.github.io`, the repository name :warning: **MUST BE** :warning: `.github.io` or `.github.io`, as stated in the [GitHub pages docs](https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages#types-of-github-pages-sites). + +When configuring `_config.yml`, set `url` to `https://.github.io` and leave `baseurl` **empty** (do NOT delete it), setting it as `baseurl:`. + +### Automatic Deployment + +Starting version [v0.3.5](https://github.com/alshedivat/al-folio/releases/tag/v0.3.5), **al-folio** will automatically re-deploy your webpage each time you push new changes to your repository! :sparkles: + +### Local Development + +Once everything is deployed, you can download the repository to your machine and start customizing it locally: + +```bash +git clone git@github.com:/.git +``` + +See [Local setup using Docker](#local-setup-using-docker-recommended) or other sections below for local development options. + +## Local setup on Windows + +If you are using Windows, it is **highly recommended** to use [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install), which is a compatibility layer for running Linux on top of Windows. You can follow [these instructions](https://ubuntu.com/tutorials/install-ubuntu-on-wsl2-on-windows-11-with-gui-support) to install WSL and Ubuntu on your machine. You only need to go up to the step 4 of the tutorial (you don't have to enable the optional `systemd` nor the graphical applications), and then you can follow the instructions below to install docker. You can install docker natively on Windows as well, but it has been having some issues as can be seen in [#1540](https://github.com/alshedivat/al-folio/issues/1540), [#2007](https://github.com/alshedivat/al-folio/issues/2007). + +## Local setup using Docker (Recommended) + +Using Docker to install Jekyll and Ruby dependencies is the easiest way. + +You need to take the following steps to get `al-folio` up and running on your local machine: + +- First, install [docker](https://docs.docker.com/get-docker/) and [docker-compose](https://docs.docker.com/compose/install/). +- Finally, run the following command that will pull the latest pre-built image from DockerHub and will run your website. + +```bash +docker compose pull +docker compose up +``` + +Note that when you run it for the first time, it will download a docker image of size 400MB or so. To see the template running, open your browser and go to `http://localhost:8080`. You should see a copy of the theme's demo website. + +Now, feel free to customize the theme however you like (don't forget to change the name!). Also, your changes should be automatically rendered in real-time (or maybe after a few seconds). + +> Beta: You can also use the slimmed docker image with a size below 100MBs and exact same functionality. Just use `docker compose -f docker-compose-slim.yml up` + +### Build your own docker image + +> Note: this approach is only necessary if you would like to build an older or very custom version of al-folio. + +Build and run a new docker image using: + +```bash +docker compose up --build +``` + +> If you want to update jekyll, install new ruby packages, etc., all you have to do is build the image again using `--force-recreate` argument at the end of the previous command! It will download Ruby and Jekyll and install all Ruby packages again from scratch. + +If you want to use a specific docker version, you can do so by changing the version tag to `your_version` in `docker-compose.yaml` (the `v0.16.3` in `image: amirpourmand/al-folio:v0.16.3`). For example, you might have created your website on `v0.10.0` and you want to stick with that. + +### Have Bugs on Docker Image? + +Sometimes, there might be some bugs in the current docker image. It might be version mismatch or anything. If you want to debug and easily solve the problem for yourself you can do the following steps: + +``` +docker compose up -d +docker compose logs +``` + +Then you can see the bug! You can enter the container via this command: + +``` +docker compose exec -it jekyll /bin/bash +``` + +Then you can run the script: + +``` +./bin/entry_point.sh +``` + +You might see problems for package dependecy or something which is not available. You can fix it now by using + +``` +bundle install +./bin/entry_point.sh +``` + +Most likely, this will solve the problem but it shouldn't really happen. So, please open a bug report for us. + +## Local Setup with Development Containers + +`al-folio` supports [Development Containers](https://containers.dev/supporting). +For example, when you open the repository with Visual Studio Code (VSCode), it prompts you to install the necessary extension and automatically install everything necessary. + +## Local Setup (Legacy, no longer supported) + +For a hands-on walkthrough of running al-folio locally without using Docker, check out [this cool blog post](https://george-gca.github.io/blog/2022/running-local-al-folio/) by one of the community members! + +Assuming you have [Ruby](https://www.ruby-lang.org/en/downloads/) and [Bundler](https://bundler.io/) installed on your system (_hint: for ease of managing ruby gems, consider using [rbenv](https://github.com/rbenv/rbenv)_), and also [Python](https://www.python.org/) and [pip](https://pypi.org/project/pip/) (_hint: for ease of managing python packages, consider using a virtual environment, like [venv](https://docs.python.org/pt-br/3/library/venv.html) or [conda](https://docs.conda.io/en/latest/)_). + +```bash +bundle install +# assuming pip is your Python package manager +pip install jupyter +bundle exec jekyll serve +``` + +To see the template running, open your browser and go to `http://localhost:4000`. You should see a copy of the theme's [demo website](https://alshedivat.github.io/al-folio/). Now, feel free to customize the theme however you like. After you are done, remember to **commit** your final changes. + +## Deployment + +Deploying your website to [GitHub Pages](https://pages.github.com/) is the most popular option. +Starting version [v0.3.5](https://github.com/alshedivat/al-folio/releases/tag/v0.3.5), **al-folio** will automatically re-deploy your webpage each time you push new changes to your repository **main branch**! :sparkles: + +### For personal and organization webpages + +1. The name of your repository **MUST BE** `.github.io` or `.github.io`. +2. In `_config.yml`, set `url` to `https://.github.io` and leave `baseurl` empty. +3. Set up automatic deployment of your webpage (see instructions below). +4. Make changes to your main branch, commit, and push! +5. After deployment, the webpage will become available at `.github.io`. + +### For project pages + +1. In `_config.yml`, set `url` to `https://.github.io` and `baseurl` to `//`. +2. Set up automatic deployment of your webpage (see instructions below). +3. Make changes to your main branch, commit, and push! +4. After deployment, the webpage will become available at `.github.io//`. + +### Enabling automatic deployment + +1. Click on **Actions** tab and **Enable GitHub Actions**; do not worry about creating any workflows as everything has already been set for you. +2. Go to `Settings -> Actions -> General -> Workflow permissions`, and give `Read and write permissions` to GitHub Actions +3. Make any other changes to your webpage, commit, and push to your main branch. This will automatically trigger the **Deploy** action. +4. Wait for a few minutes and let the action complete. You can see the progress in the **Actions** tab. If completed successfully, in addition to the `main` branch, your repository should now have a newly built `gh-pages` branch. **Do NOT touch this branch!** +5. Finally, in the **Settings** of your repository, in the Pages section, set the branch to `gh-pages` (**NOT** to `main`). For more details, see [Configuring a publishing source for your GitHub Pages site](https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source). + +If you keep your site on another branch, open `.github/workflows/deploy.yml` **on the branch you keep your website on** and change `on->push->branches` and `on->pull\_request->branches` to the branch you keep your website on. This will trigger the action on pulls/pushes on that branch. The action will then deploy the website on the branch it was triggered from. + +### Manual deployment to GitHub Pages + +If you need to manually re-deploy your website to GitHub pages, go to Actions, click "Deploy" in the left sidebar, then "Run workflow." + +### Deploy on [Netlify](https://www.netlify.com/) + +1. [Use this template -> Create a new repository](https://github.com/new?template_name=al-folio&template_owner=alshedivat). +2. Netlify: **Add new site** -> **Import an existing project** -> **GitHub** and give Netlify access to the repository you just created. +3. Netlify: In the deploy settings + - Set **Branch to deploy** to `main` + - **Base directory** is empty + - Set **Build command** to `sed -i "s/^\(baseurl: \).*$/baseurl:/" _config.yml && bundle exec jekyll build` + - Set **Publish directory** to `_site` + +4. Netlify: Add the following two **environment variables** + - | Key | Value | + | -------------- | -------------------------------------------------------------------------------------- | + | `JEKYLL_ENV` | `production` | + | `RUBY_VERSION` | set to the Ruby version found in `.github/workflows/deploy.yml` (for example, `3.3.5`) | + +5. Netlify: Click **Deploy** and wait for the site to be published. If you want to use your own domain name, follow the steps in [this documentation](https://docs.netlify.com/domains-https/custom-domains/). + +### Deployment to another hosting server (non GitHub Pages) + +If you decide to not use GitHub Pages and host your page elsewhere, simply run: + +```bash +bundle exec jekyll build +``` + +which will (re-)generate the static webpage in the `_site/` folder. +Then simply copy the contents of the `_site/` directory to your hosting server. + +If you also want to remove unused css classes from your file, run: + +```bash +purgecss -c purgecss.config.js +``` + +which will replace the css files in the `_site/assets/css/` folder with the purged css files. + +**Note:** Make sure to correctly set the `url` and `baseurl` fields in `_config.yml` before building the webpage. If you are deploying your webpage to `your-domain.com/your-project/`, you must set `url: your-domain.com` and `baseurl: /your-project/`. If you are deploying directly to `your-domain.com`, leave `baseurl` blank, **do not delete it**. + +### Deployment to a separate repository (advanced users only) + +**Note:** Do not try using this method unless you know what you are doing (make sure you are familiar with [publishing sources](https://help.github.com/en/github/working-with-github-pages/about-github-pages#publishing-sources-for-github-pages-sites)). This approach allows to have the website's source code in one repository and the deployment version in a different repository. + +Let's assume that your website's publishing source is a `publishing-source` subdirectory of a git-versioned repository cloned under `$HOME/repo/`. +For a user site this could well be something like `$HOME/.github.io`. + +Firstly, from the deployment repo dir, checkout the git branch hosting your publishing source. + +Then from the website sources dir (commonly your al-folio fork's clone): + +```bash +bundle exec jekyll build --destination $HOME/repo/publishing-source +``` + +This will instruct jekyll to deploy the website under `$HOME/repo/publishing-source`. + +**Note:** Jekyll will clean `$HOME/repo/publishing-source` before building! + +The quote below is taken directly from the [jekyll configuration docs](https://jekyllrb.com/docs/configuration/options/): + +> Destination folders are cleaned on site builds +> +> The contents of `` are automatically cleaned, by default, when the site is built. Files or folders that are not created by your site will be removed. Some files could be retained by specifying them within the `` configuration directive. +> +> Do not use an important location for ``; instead, use it as a staging area and copy files from there to your web server. + +If `$HOME/repo/publishing-source` contains files that you want jekyll to leave untouched, specify them under `keep_files` in `_config.yml`. +In its default configuration, al-folio will copy the top-level `README.md` to the publishing source. If you want to change this behavior, add `README.md` under `exclude` in `_config.yml`. + +**Note:** Do _not_ run `jekyll clean` on your publishing source repo as this will result in the entire directory getting deleted, irrespective of the content of `keep_files` in `_config.yml`. + +## Maintaining Dependencies + +**al-folio** uses **Bundler** (a Ruby dependency manager) to keep track of Ruby packages (called "gems") needed to run Jekyll and its plugins. + +**To update all dependencies:** + +```bash +bundle update --all +``` + +**After updating:** + +1. Rebuild the Docker image to apply changes: `docker compose up --build` +2. Test locally to ensure everything still works: `docker compose up` +3. Visit `http://localhost:8080` and verify the site renders correctly +4. If your site fails after updating, check the [FAQ](FAQ.md) for troubleshooting + +**For Ruby/Python environment issues:** + +- Always use Docker for consistency with CI/CD (see [Local setup using Docker](#local-setup-using-docker-recommended)) +- Avoid manual Ruby/Python installation when possible + +## Upgrading from a previous version + +If you installed **al-folio** as described above, you can manually update your code by following the steps below: + +```bash +# Assuming the current directory is +git remote add upstream https://github.com/alshedivat/al-folio.git +git fetch upstream +git rebase v0.16.3 +``` + +If you have extensively customized a previous version, it might be trickier to upgrade. +You can still follow the steps above, but `git rebase` may result in merge conflicts that must be resolved. +See [git rebase manual](https://help.github.com/en/github/using-git/about-git-rebase) and how to [resolve conflicts](https://help.github.com/en/github/using-git/resolving-merge-conflicts-after-a-git-rebase) for more information. +If rebasing is too complicated, we recommend re-installing the new version of the theme from scratch and port over your content and changes from the previous version manually. You can use tools like [meld](https://meldmerge.org/) +or [winmerge](https://winmerge.org/) to help in this process. diff --git a/LICENSE b/LICENSE index f2b8681..368a8aa 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ The MIT License (MIT) -Copyright (c) 2022 Maruan Al-Shedivat. +Copyright (c) 2025 Maruan Al-Shedivat. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in diff --git a/QUICKSTART.md b/QUICKSTART.md new file mode 100644 index 0000000..8a9704f --- /dev/null +++ b/QUICKSTART.md @@ -0,0 +1,111 @@ +# Quick Start Guide + +**Get your al-folio site running in 5 minutes.** This guide is for users who just want a working website quickly without deep customization. + +> **Video Tutorial:** Watch a walkthrough of these steps [here](assets/video/tutorial_al_folio.mp4) + + + +- [Quick Start Guide](#quick-start-guide) + - [Step 1: Create Your Repository (1 min)](#step-1-create-your-repository-1-min) + - [Step 2: Configure Deployment (1 min)](#step-2-configure-deployment-1-min) + - [Step 3: Personalize (2 min)](#step-3-personalize-2-min) + - [Step 4: View Your Site (1 min)](#step-4-view-your-site-1-min) + - [What's Next?](#whats-next) + - [Add Your Content](#add-your-content) + - [Customize Appearance](#customize-appearance) + - [Learn More](#learn-more) + - [Get Help from AI](#get-help-from-ai) + + + +## Step 1: Create Your Repository (1 min) + +**⚠️ Important:** Use the **"Use this template"** button, NOT the fork button. This ensures your site is independent and you won't accidentally submit your personal changes back to the al-folio project. + +1. Go to the [al-folio repository](https://github.com/alshedivat/al-folio) +2. Click the green **"Use this template"** button (top right), then select **"Create a new repository"** +3. Name your repository: + - **Personal/Organization site (if you want your site to be at `username.github.io`):** `username.github.io` (replace `username` with your GitHub username) + - **Project site (if you want your site to be at `username.github.io/project-name`):** Any name (e.g., `my-research-website`) +4. Click **"Create repository from template"** + +**Already forked by mistake?** No problem. Your fork will work fineβ€”just be careful when making changes. Create a new branch for your updates (e.g., `git checkout -b my-site-updates`) and make sure you push to **your own repository**, not the main al-folio project. + +## Step 2: Configure Deployment (1 min) + +1. Go to your new repository β†’ **Settings** β†’ **Actions** β†’ **General** β†’ **Workflow permissions** +2. Select **Read and write permissions** +3. Click **Save** + +## Step 3: Personalize (2 min) + +1. Open `_config.yml` in your repository +2. Update these fields: + ```yaml + title: My Website + first_name: Your + last_name: Name + url: https://your-username.github.io # or your custom domain + baseurl: # Leave this empty (do NOT delete it) + ``` +3. Click **Commit changes** (at the bottom of the page) + +## Step 4: View Your Site (1 min) + +1. Go to your repository β†’ **Actions** tab +2. Wait for the "Deploy site" workflow to complete (look for a green checkmark, ~4 minutes) +3. Go to **Settings** β†’ **Pages** β†’ **Build and deployment** +4. Make sure **Source** is set to **Deploy from a branch** +5. Set the branch to **gh-pages** (NOT main) +6. Wait for the "pages-build-deployment" workflow to complete (~45 seconds) +7. Visit `https://your-username.github.io` in your browser + +**That's it!** Your site is live. You now have a working al-folio website. + +--- + +## What's Next? + +Once your site is running, explore these customization options: + +### Add Your Content + +- **Profile picture:** Replace `assets/img/prof_pic.jpg` with your photo +- **About page:** Edit `_pages/about.md` to write your bio +- **Publications:** Add entries to `_bibliography/papers.bib` +- **Blog posts:** Create files in `_posts/` with format `YYYY-MM-DD-title.md` + +### Customize Appearance + +- **Theme color:** Edit `_config.yml`, search for `theme_color` +- **Enable/disable sections:** In `_config.yml`, look for `enabled: false/true` options +- **Social media links:** Edit `_data/socials.yml` + +### Learn More + +- Installation and local setup options: [INSTALL.md](INSTALL.md) +- Full customization guide: [CUSTOMIZE.md](CUSTOMIZE.md) +- Frequently asked questions: [FAQ.md](FAQ.md) +- Troubleshooting: [TROUBLESHOOTING.md](TROUBLESHOOTING.md) + +### Get Help from AI + +Use the **GitHub Copilot Customization Agent** (if you have Copilot) to: + +- Get step-by-step help with customizations +- Understand how to modify specific features +- Apply changes directly to your site + +See [CUSTOMIZE.md Β§ GitHub Copilot Customization Agent](CUSTOMIZE.md#github-copilot-customization-agent) for details. + +--- + +**Common first steps:** + +- Change the theme color in `_config.yml` +- Add your social media links in `_data/socials.yml` +- Upload your profile picture to `assets/img/prof_pic.jpg` +- Write a short bio in `_pages/about.md` + +Happy customizing! πŸŽ‰ diff --git a/README.md b/README.md index 1114026..3719409 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,6 @@ # Pages perso + ## Setup and develop diff --git a/SEO.md b/SEO.md new file mode 100644 index 0000000..ae2f31d --- /dev/null +++ b/SEO.md @@ -0,0 +1,536 @@ +# SEO Best Practices Guide + +This guide helps you optimize your al-folio website for search engines so your research and work are discoverable. + + + +- [SEO Best Practices Guide](#seo-best-practices-guide) + - [Overview](#overview) + - [Basic SEO Setup](#basic-seo-setup) + - [Sitemap and Robots](#sitemap-and-robots) + - [Site URL and Metadata](#site-url-and-metadata) + - [Enabling Open Graph (Social Media Previews)](#enabling-open-graph-social-media-previews) + - [What is Open Graph?](#what-is-open-graph) + - [Enable in al-folio](#enable-in-al-folio) + - [Schema.org Markup](#schemaorg-markup) + - [What is Schema.org?](#what-is-schemaorg) + - [Enable in al-folio](#enable-in-al-folio-1) + - [What Gets Marked Up](#what-gets-marked-up) + - [Search Console Setup](#search-console-setup) + - [Google Search Console](#google-search-console) + - [Bing Webmaster Tools](#bing-webmaster-tools) + - [Publication Indexing](#publication-indexing) + - [Google Scholar](#google-scholar) + - [DBLP (Computer Science)](#dblp-computer-science) + - [arXiv](#arxiv) + - [Content Optimization](#content-optimization) + - [Page Titles and Descriptions](#page-titles-and-descriptions) + - [Heading Structure](#heading-structure) + - [Image Optimization](#image-optimization) + - [Internal Linking](#internal-linking) + - [RSS Feed for Discovery](#rss-feed-for-discovery) + - [Performance & Mobile](#performance--mobile) + - [SEO Checklist](#seo-checklist) + - [Resources](#resources) + + + +## Overview + +SEO (Search Engine Optimization) makes your website discoverable on Google, Bing, and other search engines. For academics, this means: + +- Your research becomes discoverable when people search for your work +- Your CV/bio appears in search results +- Your publications rank higher +- More citations and collaborations + +al-folio includes SEO basics, but you can optimize further. + +--- + +## Basic SEO Setup + +### Sitemap and Robots + +al-folio auto-generates a `sitemap.xml` and `robots.txt` for you. These tell search engines what pages exist. + +**Verify they exist:** + +- Visit `https://your-site.com/sitemap.xml` – Should show an XML list of pages +- Visit `https://your-site.com/robots.txt` – Should show instructions for search engines + +If they're missing: + +1. Check `_config.yml` has a valid `url` +2. Rebuild: `bundle exec jekyll build` +3. Check `_site/` directory has both files + +**No configuration needed** – al-folio handles this automatically. + +--- + +### Site URL and Metadata + +Ensure `_config.yml` has correct metadata: + +```yaml +title: Your Full Name or Site Title +description: > # Brief description (1-2 sentences) + A description of your research and expertise. + This appears in search results. +author: Your Name +keywords: machine learning, research, academia, etc. +url: https://your-domain.com +lang: en +``` + +All fields are important for SEO. **Avoid leaving fields blank.** + +--- + +## Enabling Open Graph (Social Media Previews) + +### What is Open Graph? + +When someone shares your page on Twitter, Facebook, LinkedIn, etc., Open Graph controls what preview appears. + +**Without Open Graph:** + +- Generic title +- No image +- Ugly preview + +**With Open Graph:** + +- Your custom title +- Your custom image (photo, diagram, etc.) +- Custom description +- Professional preview + +### Enable in al-folio + +Open Graph is disabled by default. To enable: + +1. **Edit `_config.yml`:** + + ```yaml + serve_og_meta: true # Change from false to true + og_image: /assets/img/og-image.png # Path to your image (1200x630px recommended) + ``` + +2. **Create your OG image:** + - Size: 1200x630 pixels + - Format: PNG or JPG + - Content: Your name/logo + key info + - Save to: `assets/img/og-image.png` + +3. **Commit and deploy** + +4. **Test it:** + - Use [Facebook's Sharing Debugger](https://developers.facebook.com/tools/debug/sharing/) + - Paste your site URL + - You should see your custom image and title + +**Per-page OG images:** + +Add to the frontmatter of a blog post or page: + +```markdown +--- +layout: post +title: My Research Paper +og_image: /assets/img/paper-diagram.png +--- +``` + +--- + +## Schema.org Markup + +### What is Schema.org? + +Schema.org is structured data that tells search engines what kind of content is on your page: + +- "This is a Person" (your bio page) +- "This is a Publication" (your paper) +- "This is a BlogPosting" (your article) + +Benefits: + +- Rich snippets in search results +- Better knowledge graph information +- Schema validation helps Google understand your site + +### Enable in al-folio + +Enable in `_config.yml`: + +```yaml +serve_schema_org: true # Change from false to true +``` + +That's it! al-folio automatically marks up: + +- **Author info** (Person schema with name, URL, photo) +- **Blog posts** (BlogPosting schema with date, title, description) +- **Publications** (CreativeWork/ScholarlyArticle schema) + +### What Gets Marked Up + +**Homepage (Person):** + +- Your name, photo, description +- Links to your profiles (LinkedIn, GitHub, etc.) + +**Blog posts (BlogPosting):** + +- Title, date, author, description +- Content +- Publication date and modified date + +**Publications (ScholarlyArticle):** + +- Title, authors, abstract +- Publication date, venue +- URL and PDF links + +--- + +## Search Console Setup + +### Google Search Console + +**Google Search Console** lets you monitor how your site appears in Google search results. + +**Setup:** + +1. Go to [Google Search Console](https://search.google.com/search-console) +2. Add your website: + - Click **"URL prefix"** + - Enter your site URL: `https://your-domain.com` +3. Verify ownership (choose one method): + - **HTML file upload** – Download file, add to repository root + - **HTML tag** – Copy meta tag to `_config.yml` β†’ redeploy + - **Google Analytics** – If you already use Google Analytics + - **DNS record** – Advanced (if you own the domain) + +**Add to `_config.yml`:** + +```yaml +google_site_verification: YOUR_VERIFICATION_CODE +``` + +(Replace `YOUR_VERIFICATION_CODE` with the code from Search Console.) + +**Monitor in Search Console:** + +- **Performance** – Which queries bring traffic, your ranking position +- **Coverage** – Any indexing errors +- **Enhancements** – Schema.org validation +- **Sitemaps** – Your sitemap status + +--- + +### Bing Webmaster Tools + +Similar to Google Search Console but for Bing search: + +1. Go to [Bing Webmaster Tools](https://www.bing.com/webmasters) +2. Add your site +3. Verify (usually auto-verifies if you verified Google) +4. Add to `_config.yml`: + ```yaml + bing_site_verification: YOUR_BING_CODE + ``` + +**Note:** Bing commands are optional but recommended. Check both console dashboards regularly. + +--- + +## Publication Indexing + +### Google Scholar + +**Goal:** Get your publications listed on Google Scholar so they show up in scholar search results. + +**Google Scholar auto-crawls:** + +- Your website automatically (if publicly accessible) +- Your publications page if it has proper markup +- PDFs linked from your site + +**To improve Scholar indexing:** + +1. **Ensure BibTeX has proper format:** + + ```bibtex + @article{mykey, + title={Your Paper Title}, + author={Your Name and Co-Author}, + journal={Journal Name}, + year={2024}, + volume={1}, + pages={1-10}, + doi={10.1234/doi} + } + ``` + +2. **Add PDFs to BibTeX:** + + ```bibtex + @article{mykey, + # ... other fields ... + pdf={my-paper.pdf} # File at assets/pdf/my-paper.pdf + } + ``` + +3. **Submit to Google Scholar (optional):** + - Go to [Google Scholar Author Profile](https://scholar.google.com/citations) + - Create a profile + - Google will find your papers automatically within weeks + +4. **Wait 3-6 months** – Google Scholar takes time to index + +--- + +### DBLP (Computer Science) + +If your research is computer science related: + +1. Go to [DBLP](https://dblp.org/) +2. Search for yourself or your papers +3. If missing, [Submit via DBLP](https://dblp.org/db/contrib/) (requires account) +4. DBLP will verify and add your work + +--- + +### arXiv + +If you have preprints: + +1. Go to [arXiv.org](https://arxiv.org/) +2. Submit your preprint +3. Once listed, arXiv automatically indexes it across search engines + +**Add arXiv link to BibTeX:** + +```bibtex +@article{mykey, + # ... other fields ... + arxiv={2024.12345} # arXiv ID +} +``` + +--- + +## Content Optimization + +### Page Titles and Descriptions + +Every page needs a title and description. These show in search results. + +**In `_config.yml`:** + +```yaml +title: Jane Smith - Computer Science Researcher +description: > + Academic website of Jane Smith, focusing on machine learning and AI ethics. +``` + +**In page/post frontmatter:** + +```markdown +--- +layout: post +title: Novel Deep Learning Architecture for Climate Modeling +description: A new approach to improving climate model accuracy with deep learning +--- +``` + +**Checklist:** + +- [ ] Title under 60 characters (so it doesn't get cut off) +- [ ] Description 120-160 characters +- [ ] Include your name in the site title +- [ ] Include keywords naturally + +--- + +### Heading Structure + +Use proper HTML heading hierarchy for both SEO and accessibility: + +```markdown +# H1: Main Page Title + +Use one H1 per page, usually your blog post or page title + +## H2: Section Heading + +### H3: Subsection + +### H3: Another subsection + +## H2: Another Section +``` + +**Benefits:** + +- Search engines understand your content structure +- Screen readers can navigate better +- Visitors can scan your content + +--- + +### Image Optimization + +**For SEO:** + +- Use descriptive filenames: `neural-network-architecture.png` (not `img1.png`) +- Add alt text (also helps accessibility): + ```markdown + ![Neural network showing three layers with training accuracy of 95%](assets/img/neural-network.png) + ``` + +**For performance:** + +- Optimize image file size (use tools like TinyPNG) +- Use modern formats (WebP instead of large JPGs) +- Responsive images (different sizes for mobile vs desktop) + +--- + +### Internal Linking + +Link between your own pages strategically: + +```markdown +See my [publication on climate AI](./publications/) or my [blog post on neural networks](/blog/2024/neural-networks/). +``` + +**Benefits:** + +- Search engines crawl through your links +- Users discover more of your content +- Distributes "authority" across your site + +--- + +## RSS Feed for Discovery + +al-folio auto-generates an RSS feed at `/feed.xml`. + +**Why RSS matters:** + +- Content aggregators pick up your posts +- Researchers can subscribe to your updates +- Improves discoverability + +**Ensure your feed works:** + +```yaml +# In _config.yml +title: Your Site +description: Your site description +url: https://your-domain.com # MUST be complete URL +``` + +**Test your feed:** + +- Visit `https://your-site.com/feed.xml` +- Should show XML with your recent posts +- Try subscribing in a feed reader (Feedly, etc.) + +--- + +## Performance & Mobile + +Search engines favor fast, mobile-friendly sites. + +**Check your site:** + +- Use [Google PageSpeed Insights](https://pagespeed.web.dev/) +- Enter your site URL +- Review recommendations +- al-folio already optimizes for performance, but you can improve further: + - Compress images + - Minimize CSS/JS (enabled by default) + - Use lazy loading (already enabled) + +**Mobile optimization:** + +- al-folio is responsive by default +- Test on phones/tablets +- Ensure buttons are large enough to tap +- Check readability on small screens + +--- + +## SEO Checklist + +Before considering your site "SEO optimized": + +**Basic Setup:** + +- [ ] `_config.yml` has `title`, `description`, `author`, `url` +- [ ] Sitemap accessible at `/sitemap.xml` +- [ ] `robots.txt` accessible at `/robots.txt` +- [ ] Mobile-friendly (test on phone) + +**Search Console:** + +- [ ] Google Search Console linked +- [ ] Bing Webmaster Tools linked (optional but recommended) +- [ ] No major indexing errors +- [ ] Sitemaps submitted + +**Schema/Open Graph:** + +- [ ] `serve_og_meta: true` (for social sharing) +- [ ] `serve_schema_org: true` (for structured data) +- [ ] Test OG with [Facebook Debugger](https://developers.facebook.com/tools/debug/sharing/) +- [ ] Validate schema at [Schema.org Validator](https://validator.schema.org/) + +**Content:** + +- [ ] Every page has unique title (under 60 chars) +- [ ] Every page has description (120-160 chars) +- [ ] Blog posts have proper dates +- [ ] Images have descriptive alt text +- [ ] Headings follow proper hierarchy + +**Publications:** + +- [ ] BibTeX entries have proper format +- [ ] PDFs linked from BibTeX +- [ ] Submitted to Google Scholar (optional) +- [ ] Indexed on DBLP or arXiv (if applicable) + +**Performance:** + +- [ ] Site loads under 3 seconds (check PageSpeed) +- [ ] No broken links (use lighthouse or similar) +- [ ] RSS feed works (check `/feed.xml`) + +--- + +## Resources + +- **[Google Search Central](https://developers.google.com/search)** – Official SEO guide +- **[Moz SEO Checklist](https://moz.com/beginners-guide-to-seo)** – Beginner-friendly guide +- **[Google PageSpeed Insights](https://pagespeed.web.dev/)** – Performance analysis +- **[Schema.org](https://schema.org/)** – Structured data reference +- **[WebAIM](https://webaim.org/)** – Accessibility (helps SEO too) +- **[Lighthouse Audit](https://chrome.google.com/webstore/detail/lighthouse/blipmdconlkpombljlkpstvnztVTNyZe)** – Browser extension + +--- + +**Next Steps:** + +1. Enable Open Graph and Schema.org in `_config.yml` +2. Set up Google Search Console and Bing Webmaster Tools +3. Optimize your page titles and descriptions +4. Add alt text to images and PDFs to your BibTeX +5. Monitor search console regularly for indexing issues + +Your research will be more discoverable with these optimizations! πŸ” diff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.md new file mode 100644 index 0000000..96800a3 --- /dev/null +++ b/TROUBLESHOOTING.md @@ -0,0 +1,454 @@ +# Troubleshooting Guide + +This guide covers common issues and their solutions. For more information, see [FAQ.md](FAQ.md) or check [GitHub Discussions](https://github.com/alshedivat/al-folio/discussions). + + + +- [Troubleshooting Guide](#troubleshooting-guide) + - [Deployment Issues](#deployment-issues) + - [Site fails to deploy on GitHub Pages](#site-fails-to-deploy-on-github-pages) + - [Custom domain becomes blank after deployment](#custom-domain-becomes-blank-after-deployment) + - [GitHub Actions: "Unknown tag 'toc'" error](#github-actions-unknown-tag-toc-error) + - [Local Build Issues](#local-build-issues) + - [Docker build fails](#docker-build-fails) + - [Ruby dependency issues](#ruby-dependency-issues) + - [Port already in use](#port-already-in-use) + - [Styling & Layout Problems](#styling--layout-problems) + - [CSS and JS not loading properly](#css-and-js-not-loading-properly) + - [Site looks broken after deployment](#site-looks-broken-after-deployment) + - [Theme colors not applying](#theme-colors-not-applying) + - [Content Not Appearing](#content-not-appearing) + - [Blog posts not showing up](#blog-posts-not-showing-up) + - [Publications not displaying](#publications-not-displaying) + - [Images not loading](#images-not-loading) + - [Configuration Issues](#configuration-issues) + - [YAML syntax errors](#yaml-syntax-errors) + - [Feed (RSS/Atom) not working](#feed-rssatom-not-working) + - [Search not working](#search-not-working) + - [Feature-Specific Issues](#feature-specific-issues) + - [Comments (Giscus) not appearing](#comments-giscus-not-appearing) + - [Related posts broken](#related-posts-broken) + - [Code formatting issues](#code-formatting-issues) + - [Getting Help](#getting-help) + + + +## Deployment Issues + +### Site fails to deploy on GitHub Pages + +**Problem:** GitHub Actions shows an error when deploying. + +**Solution:** + +1. Check your repository **Actions** tab for error messages +2. Ensure you followed [Step 2 of QUICKSTART.md](QUICKSTART.md#step-2-configure-deployment-1-min) (Workflow permissions) +3. Verify your `_config.yml` has correct `url` and `baseurl`: + - Personal site: `url: https://username.github.io` and `baseurl:` (empty) + - Project site: `url: https://username.github.io` and `baseurl: /repo-name/` +4. Check that you're pushing to the `main` (or `master`) branch, NOT `gh-pages` +5. Commit and push a small change to trigger redeployment + +**For YAML syntax errors:** + +- Run `bundle exec jekyll build` locally to see the exact error +- Check for unquoted special characters (`:`, `&`, `#`) in YAML strings + +--- + +### Custom domain becomes blank after deployment + +**Problem:** You set a custom domain (e.g., `example.com`), but it resets to blank after deployment. + +**Solution:** + +1. Create a file named `CNAME` (no extension) in your repository root +2. Add your domain to it: `example.com` (one domain per line) +3. Commit and push +4. The domain will persist after future deployments + +(See [DNS configuration instructions in INSTALL.md](INSTALL.md#deployment) for initial custom domain setup.) + +--- + +### GitHub Actions: "Unknown tag 'toc'" error + +**Problem:** Local build works, but GitHub Actions fails with `Unknown tag 'toc'`. + +**Solution:** + +1. Check your **Settings** β†’ **Pages** β†’ **Source** is set to `Deploy from a branch` +2. Ensure the branch is set to `gh-pages` (NOT `main`) +3. Wait 5 minutes and check Actions again +4. The issue usually resolves after you verify the gh-pages branch is set + +--- + +## Local Build Issues + +### Docker build fails + +**Problem:** `docker compose up` fails or shows errors. + +**Solution:** + +1. Update Docker: `docker compose pull` +2. Rebuild: `docker compose up --build` +3. If still failing, check your system resources (disk space, RAM) +4. For M1/M2 Mac users, verify you're using a compatible Docker version +5. Check Docker Desktop is running + +**For permission issues:** + +- Linux users may need to add your user to the docker group: `sudo usermod -aG docker $USER` +- Then log out and log back in + +--- + +### Ruby dependency issues + +**Problem:** `Gemfile.lock` conflicts or bundle errors. + +**Solution:** + +1. Delete `Gemfile.lock`: `rm Gemfile.lock` +2. Update Bundler: `bundle update` +3. Install gems: `bundle install` +4. Try serving again: `bundle exec jekyll serve` + +--- + +### Port already in use + +**Problem:** "Address already in use" when running `jekyll serve`. + +**Solution - Docker:** + +```bash +docker compose down # Stop the running container +docker compose up # Start fresh +``` + +**Solution - Local Ruby:** + +```bash +# Find and kill the Jekyll process +lsof -i :4000 | grep LISTEN | awk '{print $2}' | xargs kill + +# Or specify a different port +bundle exec jekyll serve --port 5000 +``` + +--- + +## Styling & Layout Problems + +### CSS and JS not loading properly + +**Problem:** Site looks broken: no colors, fonts wrong, links don't work. + +**Common cause:** Incorrect `url` and `baseurl` in `_config.yml`. + +**Solution:** + +1. **Personal/organization site:** + + ```yaml + url: https://username.github.io + baseurl: # MUST be empty (not deleted) + ``` + +2. **Project site:** + + ```yaml + url: https://username.github.io + baseurl: /repository-name/ # Must match your repo name + ``` + +3. **Clear browser cache:** + - Chrome: `Ctrl+Shift+R` (Windows/Linux) or `Cmd+Shift+R` (Mac) + - Firefox: `Ctrl+F5` (Windows/Linux) or `Cmd+R` (Mac) + - Or open a private/incognito window + +4. Redeploy: Make a small change and push to trigger GitHub Actions again + +--- + +### Site looks broken after deployment + +**Checklist:** + +- [ ] Is `baseurl` correct (and not accidentally deleted)? +- [ ] Did you clear your browser cache? +- [ ] Wait 5 minutes for GitHub Pages to update +- [ ] Check GitHub Actions completed successfully + +--- + +### Theme colors not applying + +**Problem:** You changed `_config.yml` color settings but nothing changed. + +**Solution:** + +1. Check your color name is valid in `_sass/_variables.scss` +2. Clear browser cache (see above) +3. Rebuild: `docker compose up --build` (Docker) or `bundle exec jekyll build` (Ruby) +4. Wait for GitHub Actions to complete +5. Visit the site in a private/incognito window + +--- + +## Content Not Appearing + +### Blog posts not showing up + +**Problem:** Created a post in `_posts/` but it's not on the blog page. + +**Checklist:** + +- [ ] Filename format is correct: `YYYY-MM-DD-title.md` (e.g., `2024-01-15-my-post.md`) +- [ ] File is in the `_posts/` directory (not in a subdirectory) +- [ ] Post has required frontmatter: + ```markdown + --- + layout: post + title: My Post Title + date: 2024-01-15 + --- + ``` +- [ ] Post date is NOT in the future (Jekyll doesn't publish future-dated posts by default) +- [ ] Blog posts are enabled in `_config.yml`: `blog_page: true` + +**To fix:** + +1. Check the filename format (uppercase, dashes, no spaces) +2. Verify the date is today or in the past +3. Rebuild: `bundle exec jekyll build` and check for error messages + +--- + +### Publications not displaying + +**Problem:** You added a BibTeX entry to `papers.bib` but it's not showing on the publications page. + +**Checklist:** + +- [ ] File is at `_bibliography/papers.bib` +- [ ] BibTeX syntax is correct (check for missing commas, unmatched braces) +- [ ] Entry has a unique citation key: `@article{einstein1905, ...}` +- [ ] Publication page is enabled: Check `publications_page: true` in `_config.yml` + +**To debug BibTeX errors:** + +```bash +# Local Ruby setup +bundle exec jekyll build 2>&1 | grep -i bibtex + +# Docker +docker compose run --rm web jekyll build 2>&1 | grep -i bibtex +``` + +--- + +### Images not loading + +**Problem:** Image paths broken or showing as missing. + +**Common causes:** + +- Wrong path in Markdown (use relative paths) +- Image file doesn't exist at the specified location +- Case sensitivity (Linux/Mac are case-sensitive) + +**Solutions:** + +1. **Correct path format:** + + ```markdown + ![Alt text](assets/img/image-name.jpg) + ``` + +2. **Check the file exists:** + - Personal images: `assets/img/` + - Paper PDFs: `assets/pdf/` + - Use lowercase filenames, no spaces + +3. **For BibTeX PDF links:** + ```bibtex + @article{mykey, + pdf={my-paper.pdf}, % File should be at assets/pdf/my-paper.pdf + } + ``` + +--- + +## Configuration Issues + +### YAML syntax errors + +**Problem:** GitHub Actions fails with YAML error, or build is silent. + +**Common mistakes:** + +```yaml +# ❌ Wrong: Unquoted colons or ampersands +title: My Site: Research & Teaching + +# βœ… Correct: Quote special characters +title: "My Site: Research & Teaching" +``` + +```yaml +# ❌ Wrong: Inconsistent indentation +nav: +- name: Home + url: / + - name: About # Extra space! + url: /about/ + +# βœ… Correct: Consistent 2-space indentation +nav: + - name: Home + url: / + - name: About + url: /about/ +``` + +**To find errors:** + +1. Use a YAML validator: [yamllint.com](https://www.yamllint.com/) +2. Run locally: `bundle exec jekyll build` shows the exact error line +3. Check that you didn't delete required lines (like `baseurl:`) + +--- + +### Feed (RSS/Atom) not working + +**Problem:** RSS feed at `/feed.xml` is empty or broken. + +**Solution:** + +1. Verify required `_config.yml` fields: + ```yaml + title: Your Site Title + description: Brief description + url: https://your-domain.com # MUST be absolute URL + ``` +2. Ensure `baseurl` is correct +3. Check at least one blog post exists (with correct date) +4. Rebuild and wait for GitHub Actions to complete + +--- + +### Search not working + +**Problem:** Search box is empty or always returns nothing. + +**Solution:** + +1. Ensure search is enabled in `_config.yml`: + ```yaml + search_enabled: true + ``` +2. Check that `_config.yml` has a valid `url` (required for search) +3. Rebuild the site +4. Search index is generated during build; give it a minute after push + +--- + +## Feature-Specific Issues + +### Comments (Giscus) not appearing + +**Problem:** You enabled Giscus in `_config.yml` but comments don't show. + +**Solution:** + +1. Verify you have a GitHub repository for discussions (usually your main repo) +2. Check `_config.yml` has correct settings: + ```yaml + disqus_shortname: false # Make sure this is false + giscus: + repo: username/repo-name + repo_id: YOUR_REPO_ID + category_id: YOUR_CATEGORY_ID + ``` +3. Visit [Giscus.app](https://giscus.app) to get your IDs and verify setup +4. Check the GitHub repo has Discussions enabled (Settings β†’ Features) + +--- + +### Related posts broken + +**Problem:** Related posts feature crashes or shows errors. + +**Solution:** + +1. Related posts requires more gems. If you disabled it in `_config.yml`, that's fine: + ```yaml + related_blog_posts: + enabled: false + ``` +2. If you want to enable it, ensure `Gemfile` has all dependencies installed: + ```bash + bundle install + bundle exec jekyll build + ``` + +--- + +### Code formatting issues + +**Problem:** Code blocks don't have syntax highlighting or look wrong. + +**Solution:** + +1. Use proper markdown syntax: + + ````markdown + ```python + # Your code here + print("hello") + ``` + ```` + +2. For inline code: + + ```markdown + Use `code-here` for inline code. + ``` + +3. Check that your language is supported by Pygments (Python, Ruby, JavaScript, etc. are all supported) + +--- + +## Getting Help + +If you're stuck: + +1. **Check existing documentation:** + - [QUICKSTART.md](QUICKSTART.md) – Get started in 5 minutes + - [INSTALL.md](INSTALL.md) – Installation and deployment + - [CUSTOMIZE.md](CUSTOMIZE.md) – Full customization guide + - [FAQ.md](FAQ.md) – Frequently asked questions + +2. **Search for your issue:** + - [GitHub Discussions](https://github.com/alshedivat/al-folio/discussions) – Q&A from community + - [GitHub Issues](https://github.com/alshedivat/al-folio/issues) – Bug reports and feature requests + +3. **Get help from AI:** + - Use the **GitHub Copilot Customization Agent** (requires Copilot subscription) to get step-by-step help + - See [CUSTOMIZE.md Β§ GitHub Copilot Customization Agent](CUSTOMIZE.md#github-copilot-customization-agent) + +4. **Create a new discussion:** + - [Ask a question](https://github.com/alshedivat/al-folio/discussions/new?category=q-a) on GitHub + - Include error messages and what you're trying to do + +--- + +**Most issues are resolved by:** + +1. Checking `url` and `baseurl` in `_config.yml` +2. Clearing browser cache +3. Waiting for GitHub Actions to complete (~5 minutes) diff --git a/_books/the_godfather.md b/_books/the_godfather.md new file mode 100644 index 0000000..cc97f49 --- /dev/null +++ b/_books/the_godfather.md @@ -0,0 +1,28 @@ +--- +layout: book-review +title: The Godfather +author: Mario Puzo +cover: assets/img/book_covers/the_godfather.jpg +olid: OL43499941M # use Open Library ID to fetch cover (if no `cover` is provided) +isbn: 7539967447 # use ISBN to fetch cover (if no `olid` is provided, dashes are optional) +categories: classics crime historical-fiction mystery novels thriller +tags: top-100 +buy_link: https://www.amazon.com/Godfather-Deluxe-Mario-Puzo/dp/0593542592 +date: 2024-08-23 +started: 2024-08-23 +finished: 2024-09-07 +released: 1969 +stars: 5 +goodreads_review: 6318556633 +status: Finished +--- + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras sollicitudin eros sit amet ante aliquet, sit amet vulputate lectus mattis. Aenean ullamcorper pretium nunc, sed egestas lorem elementum id. Nulla id mi id neque ultrices egestas ut in urna. Sed ac ultricies nunc. Nam convallis placerat urna id egestas. Nulla porta, est interdum vestibulum venenatis, lorem odio laoreet sapien, in pulvinar tellus eros a dolor. Vivamus sapien justo, ullamcorper a mi eget, scelerisque euismod nunc. In augue augue, ultrices a ornare non, tincidunt quis justo. Donec sit amet consectetur eros. Nullam neque leo, tincidunt id ipsum ac, volutpat lobortis mi. Phasellus consequat ultricies arcu, eu semper ligula ultrices eget. Ut in fringilla elit, ac tincidunt nisi. + +Nunc commodo elit nec turpis feugiat consectetur. Nullam in nisi egestas, fermentum ligula hendrerit, euismod enim. Nulla eu hendrerit eros. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin et velit ante. Vestibulum pretium vitae quam et sagittis. Proin eu nunc vel velit accumsan eleifend. Nulla facilisis, diam tempus imperdiet ultrices, massa ipsum consequat orci, sed efficitur eros mi a felis. Cras lobortis turpis sem, sed lobortis nunc ullamcorper tristique. Nam vehicula rhoncus ante, in faucibus sapien scelerisque et. Donec semper libero et tincidunt mattis. In vestibulum, nulla pretium dictum commodo, risus nulla vestibulum felis, at tincidunt massa mi in odio. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. + +Donec efficitur ultrices purus sit amet imperdiet. Nam consequat metus in erat sodales faucibus. Aliquam maximus fermentum nulla id finibus. Aliquam iaculis sed odio vel rutrum. Curabitur sed odio est. Praesent nec sollicitudin tortor. Praesent pharetra, turpis quis porttitor rhoncus, ante massa fringilla lacus, nec porttitor magna turpis vitae felis. Nullam tristique massa id odio imperdiet, nec sodales massa egestas. Proin nisi metus, euismod sed accumsan vitae, facilisis vel risus. Morbi suscipit auctor erat, nec viverra elit fringilla eu. Mauris congue, purus id tristique facilisis, felis nisi efficitur magna, eu consectetur augue sem vitae lacus. Aliquam erat volutpat. Cras at nibh ultricies, volutpat arcu vitae, dictum est. In ac dolor sagittis, egestas lectus et, semper nisl. Etiam consectetur purus vitae sapien porttitor auctor. + +Nulla sit amet venenatis odio. Suspendisse ac lacus quis augue mollis tempus vel in lorem. Donec augue turpis, eleifend nec nibh eu, elementum dictum metus. Proin ut est ligula. Etiam vehicula facilisis metus, sit amet consectetur risus ullamcorper porttitor. In congue nibh quis sollicitudin iaculis. Donec a mollis lorem, non mollis lacus. Nulla et leo ex. Aliquam erat volutpat. Nam sit amet tincidunt mauris. Vivamus vitae est sit amet nisi semper egestas. Donec in diam pharetra, commodo diam vitae, imperdiet ligula. Cras iaculis ac diam eget vehicula. Proin suscipit ante enim, quis vehicula mi porta bibendum. Aliquam a diam porttitor, sollicitudin justo vitae, tempor odio. + +Cras fermentum dignissim pretium. Donec quis turpis eu neque lacinia facilisis in sit amet nibh. Nulla non tortor ultricies, euismod est in, blandit nibh. Ut a neque metus. Sed convallis condimentum nibh quis finibus. Praesent aliquam sem iaculis eros maximus accumsan. Nulla venenatis mauris id aliquet maximus. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin at enim vitae ex porttitor vestibulum sed eget nibh. Suspendisse accumsan feugiat quam eget ultricies. diff --git a/_config.yml b/_config.yml index fccc5b8..f12100f 100644 --- a/_config.yml +++ b/_config.yml @@ -20,7 +20,8 @@ icon: πŸŽ“ # πŸ§₯ # πŸš€ #🚲 # 🌐 #πŸ‘€ # πŸ§‘πŸΌβ€πŸ’» # πŸ§” # πŸ›°οΈ # url: https://florent.guiotte.fr # the base hostname & protocol for your site baseurl: # the subpath of your site, e.g. /blog/ last_updated: false # set to true if you want to display last updated in the footer -impressum_path: # set to path to include impressum link in the footer, use the same path as permalink in a page, helps to conform with EU GDPR +impressum_path: # set to path to include impressum link in the footer, use the same path as permalink in a page, helps to conform with EU GDPR +back_to_top: true # set to false to disable the back to top button # ----------------------------------------------------------------------------- # Theme @@ -31,8 +32,19 @@ highlight_theme_light: tango # assets/stylesheets/ highlight_theme_dark: zenburn # assets/stylesheets/ # repo color theme -repo_theme_light: default # https://github.com/anuraghazra/github-readme-stats/blob/master/themes/README.md -repo_theme_dark: dark # https://github.com/anuraghazra/github-readme-stats/blob/master/themes/README.md +repo_theme_light: default # https://github.com/anuraghazra/github-readme-stats/blob/master/themes/README.md +repo_theme_dark: dark # https://github.com/anuraghazra/github-readme-stats/blob/master/themes/README.md +repo_trophies: + enabled: true + theme_light: flat # https://github.com/ryo-ma/github-profile-trophy + theme_dark: gitdimmed # https://github.com/ryo-ma/github-profile-trophy + +# External service URLs for repository page +# To use a different instance or service for displaying GitHub stats and trophies, +# update these URLs. These are used in the repository templates. +external_services: + github_readme_stats_url: https://github-readme-stats.vercel.app + github_profile_trophy_url: https://github-profile-trophy.vercel.app # ----------------------------------------------------------------------------- # RSS Feed @@ -48,66 +60,37 @@ rss_icon: false navbar_fixed: true footer_fixed: true +search_enabled: true +socials_in_search: true +posts_in_search: true +bib_search: true # Dimensions -max_width: 800px - -# TODO: add layout settings (single page vs. multi-page) +max_width: 930px # ----------------------------------------------------------------------------- # Open Graph & Schema.org # ----------------------------------------------------------------------------- # Display links to the page with a preview object on social media. +# see https://schema.org/docs/faq.html for more information serve_og_meta: false # Include Open Graph meta tags in the HTML head serve_schema_org: false # Include Schema.org in the HTML head og_image: # The site-wide (default for all links) Open Graph preview image -# ----------------------------------------------------------------------------- -# Social integration -# ----------------------------------------------------------------------------- - -github_username: fguiotte # your GitHub user name -gitlab_username: # your GitLab user name -twitter_username: # your Twitter handle -mastodon_username: # your mastodon instance+username in the format instance.tld/@username -linkedin_username: fguiotte # your LinkedIn user name -telegram_username: # your Telegram user name -scholar_userid: QHs7TucAAAAJ # your Google Scholar ID -semanticscholar_id: # your Semantic Scholar ID -whatsapp_number: # your WhatsApp number (full phone number in international format. Omit any zeroes, brackets, or dashes when adding the phone number in international format.) -orcid_id: # your ORCID ID -medium_username: # your Medium username -quora_username: # your Quora username -publons_id: # your ID on Publons -research_gate_profile: # your profile on ResearchGate -blogger_url: # your blogger URL -work_url: # work page URL -keybase_username: # your keybase user name -wikidata_id: # your wikidata id -dblp_url: # your DBLP profile url -stackoverflow_id: # your stackoverflow id -kaggle_id: # your kaggle id -lastfm_id: # your lastfm id -spotify_id: # your spotify id -pinterest_id: # your pinterest id -unsplash_id: # your unsplash id -instagram_id: # your instagram id -facebook_id: # your facebook id -youtube_id: # your youtube channel id (youtube.com/@) -discord_id: # your discord id (18-digit unique numerical identifier) - -contact_note: > - You can even add a little note about which of these is the best way to reach you. - # ----------------------------------------------------------------------------- # Analytics and search engine verification # ----------------------------------------------------------------------------- -google_analytics: # your Goole Analytics measurement ID (format: G-XXXXXXXXXX) -panelbear_analytics: # panelbear analytics site ID (format: XXXXXXXXX) +# For Google Analytics, see https://support.google.com/analytics/answer/10447272?hl=en&ref_topic=14088998&sjid=5129943941510317771-SA#zippy=%2Cgoogle-sites +# and follow the instructions for Google Sites. You will need to create a Google Analytics property and copy the Google tag ID. +google_analytics: # your Google Analytics measurement ID (format: G-XXXXXXXXXX) +cronitor_analytics: # cronitor RUM analytics site ID (format: XXXXXXXXX) +pirsch_analytics: # your Pirsch analytics site ID (length 32 characters) +openpanel_analytics: # your Openpanel analytics client ID (format: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX) -google_site_verification: # your google-site-verification ID (Google Search Console) -bing_site_verification: # out your bing-site-verification ID (Bing Webmaster) +# For Google Search Console, see https://support.google.com/webmasters/answer/9008080?hl=en#meta_tag_verification&zippy=%2Chtml-tag +google_site_verification: # your google-site-verification ID (Google Search Console) +bing_site_verification: # out your bing-site-verification ID (Bing Webmaster) # ----------------------------------------------------------------------------- # Blog @@ -117,24 +100,29 @@ blog_name: al-folio # blog_name will be displayed in your blog page blog_nav_title: # your blog must have a title for it to be displayed in the nav bar blog_description: a simple whitespace theme for academics permalink: /blog/:year/:title/ +lsi: false # produce an index for related posts # Pagination pagination: enabled: true +related_blog_posts: + enabled: true + max_related: 5 + # Giscus comments (RECOMMENDED) -# Follow instructions on https://giscus.app/ to setup for your repo to fill out -# the information below. +# Follow instructions on https://giscus.app/ to setup for your repo to fill out the information below. giscus: - repo: alshedivat/al-folio # / - repo_id: MDEwOlJlcG9zaXRvcnk2MDAyNDM2NQ== - category: Comments # name of the category under which discussions will be created - category_id: DIC_kwDOA5PmLc4CTBt6 - mapping: title # identify discussions by post title - strict: 1 # use strict identification mode - reactions_enabled: 1 # enable (1) or disable (0) emoji reactions - input_position: bottom # whether to display input form below (bottom) or above (top) the comments - theme: preferred_color_scheme # name of the color scheme (preferred works well with al-folio light/dark mode) + repo: # / + repo_id: # leave empty or specify your repo_id (see https://giscus.app/) + category: Comments # name of the category under which discussions will be created + category_id: # leave empty or specify your category_id (see https://giscus.app/) + mapping: title # identify discussions by post title + strict: 1 # use strict identification mode + reactions_enabled: 1 # enable (1) or disable (0) emoji reactions + input_position: bottom # whether to display input form below (bottom) or above (top) the comments + dark_theme: dark # name of the dark color scheme (preferred works well with al-folio dark mode) + light_theme: light # name of the light color scheme (preferred works well with al-folio light mode) emit_metadata: 0 lang: en @@ -143,28 +131,45 @@ disqus_shortname: al-folio # put your disqus shortname # https://help.disqus.com/en/articles/1717111-what-s-a-shortname # External sources. -# If you have blog posts published on medium.com or other exteranl sources, +# If you have blog posts published on medium.com or other external sources, # you can display them in your blog by adding a link to the RSS feed. +# Optional: Set default categories and tags for posts from each source. external_sources: - name: medium.com rss_url: https://medium.com/@al-folio/feed + categories: [external-posts] + tags: [medium] + - name: Google Blog + posts: + - url: https://blog.google/technology/ai/google-gemini-update-flash-ai-assistant-io-2024/ + published_date: 2024-05-14 + categories: [external-posts] + tags: [google] + +# ----------------------------------------------------------------------------- +# Newsletter +# ----------------------------------------------------------------------------- + +newsletter: + enabled: false + endpoint: # your loops endpoint (e.g., https://app.loops.so/api/newsletter-form/YOUR-ENDPOINT) + # https://loops.so/docs/forms/custom-form # ----------------------------------------------------------------------------- # Collections # ----------------------------------------------------------------------------- collections: + books: + output: true news: defaults: layout: post output: true - permalink: /news/:path/ projects: output: true - permalink: /projects/:path/ - -news_scrollable: true # adds a vertical scroll bar if there are more than 3 news items -news_limit: 5 # leave blank to include all the news in the `_news` folder + teachings: + output: true # ----------------------------------------------------------------------------- # Jekyll settings @@ -173,36 +178,62 @@ news_limit: 5 # leave blank to include all the news in the `_news` folder # Markdown and syntax highlight markdown: Pandoc highlighter: rouge -#pandoc: -# extensions: -# - filter: mathjax-pandoc-filter -# - '-Mmathjax.centerDisplayMath' # center display math -# - filter: mermaid-filter +kramdown: + input: GFM + syntax_highlighter_opts: + css_class: "highlight" + span: + line_numbers: false + block: + line_numbers: false + start_line: 1 # Includes & excludes -include: ['_pages'] +include: ["_pages", "_scripts"] exclude: - - bin + - bin/ + - CONTRIBUTING.md + - CUSTOMIZE.md + - Dockerfile + - docker-compose.yml + - docker-compose-slim.yml + - FAQ.md - Gemfile - Gemfile.lock + - INSTALL.md + - LICENSE + - lighthouse_results/ + - package.json + - package-lock.json + - _pages/about_einstein.md + - purgecss.config.js + - README.md + - readme_preview/ - vendor keep_files: - CNAME - .nojekyll - - .git # Plug-ins plugins: - - jekyll-archives - - jekyll-diagrams + - jekyll-3rd-party-libraries + - jekyll-archives-v2 + - jekyll-cache-bust - jekyll-email-protect - jekyll-feed + - jekyll-get-json - jekyll-imagemagick + - jekyll-jupyter-notebook + - jekyll-link-attributes - jekyll-minifier - jekyll-paginate-v2 + - jekyll-regex-replace - jekyll/scholar - jekyll-sitemap - - jekyll-link-attributes + - jekyll-socials + - jekyll-tabs + - jekyll-terser + - jekyll-toc - jekyll-twitter-plugin - jemoji - jekyll-pandoc @@ -210,35 +241,45 @@ plugins: # Sitemap settings defaults: - scope: - path: "assets/**/*.*" + path: "assets" values: sitemap: false +sass: + style: compressed + # ----------------------------------------------------------------------------- # Jekyll Minifier # ----------------------------------------------------------------------------- jekyll-minifier: - exclude: ['robots.txt'] - uglifier_args: - harmony: true + compress_javascript: false # set to false since we are using terser as the js minifier + exclude: ["robots.txt", "assets/js/search/*.js"] + +# ----------------------------------------------------------------------------- +# Terser +# ----------------------------------------------------------------------------- + +terser: + compress: + drop_console: true # ----------------------------------------------------------------------------- # Jekyll Archives # ----------------------------------------------------------------------------- jekyll-archives: - enabled: [year, tags, categories] # enables year, tag and category archives (remove if you need to disable one of them). - layouts: - year: archive-year - tag: archive-tag - category: archive-category - permalinks: - year: '/blog/:year/' - tag: '/blog/tag/:name/' - category: '/blog/category/:name/' + posts: + enabled: [year, tags, categories] # enables year, tag and category archives (remove if you need to disable one of them). + permalinks: + year: "/blog/:year/" + tags: "/blog/:type/:name/" + categories: "/blog/:type/:name/" + books: + enabled: [year, tags, categories] # enables year, tag and category archives (remove if you need to disable one of them). -display_tags: ['formatting', 'images', 'links', 'math', 'code'] # this tags will be dispalyed on the front page of your blog +display_tags: ["formatting", "images", "links", "math", "code", "blockquotes"] # these tags will be displayed on the front page of your blog +display_categories: ["external-services"] # these categories will be displayed on the front page of your blog # ----------------------------------------------------------------------------- # Jekyll Scholar @@ -264,23 +305,57 @@ scholar: join_strings: true details_dir: bibliography - details_layout: bibtex.html details_link: Details query: "@*" + group_by: year + group_order: descending -badges: # Display different badges for your pulications - altmetric_badge: false # Altmetric badge (https://www.altmetric.com/products/altmetric-badges/) - dimensions_badge: false # Dimensions badge (https://badge.dimensions.ai/) +# Display different badges withs stats for your publications +# Customize badge behavior in _layouts/bib.liquid +enable_publication_badges: + altmetric: true # Altmetric badge (Customization options: https://badge-docs.altmetric.com/index.html) + dimensions: true # Dimensions badge (Customization options: https://badge.dimensions.ai/) + google_scholar: true # Google Scholar badge (https://scholar.google.com/intl/en/scholar/citations.html) + inspirehep: true # Inspire HEP badge (https://help.inspirehep.net/knowledge-base/citation-metrics/) # Filter out certain bibtex entry keywords used internally from the bib output -bibtex_show: true -filtered_bibtex_keywords: [abbr, abstract, arxiv, bibtex_show, html, pdf, selected, supp, blog, code, poster, slides, website, preview, altmetric, keywords, annotation] +filtered_bibtex_keywords: + [ + abbr, + abstract, + additional_info, + altmetric, + annotation, + arxiv, + award, + award_name, + bibtex_show, + blog, + code, + dimensions, + eprint, + google_scholar_id, + hal, + html, + inspirehep_id, + pdf, + pmid, + poster, + preview, + selected, + slides, + supp, + video, + website, + ] # Maximum number of authors to be shown for each publication (more authors are visible on click) -max_author_limit: 3 # leave blank to always show all authors -more_authors_animation_delay: 10 # more authors are revealed on click using animation; smaller delay means faster animation +max_author_limit: 3 # leave blank to always show all authors +more_authors_animation_delay: 10 # more authors are revealed on click using animation; smaller delay means faster animation +# Enables publication thumbnails. If disabled, none of the publications will display thumbnails, even if specified in the bib entry. +enable_publication_thumbnails: true # ----------------------------------------------------------------------------- # Jekyll Link Attributes @@ -293,13 +368,14 @@ external_links: target: _blank exclude: - # ----------------------------------------------------------------------------- # Responsive WebP Images # ----------------------------------------------------------------------------- +# MAKE SURE imagemagick is installed and on your PATH before enabling imagemagick. In a terminal, run: +# convert -version imagemagick: - enabled: true # enables responsive images for your site (recomended, see https://github.com/alshedivat/al-folio/issues/537) + enabled: true # enables responsive images for your site (recommended, see https://github.com/alshedivat/al-folio/issues/537) widths: - 480 - 800 @@ -311,66 +387,294 @@ imagemagick: - ".jpeg" - ".png" - ".tiff" + - ".gif" output_formats: - webp: "-resize 800x" - -# ----------------------------------------------------------------------------- -# Jekyll Diagrams -# ----------------------------------------------------------------------------- - -jekyll-diagrams: - # configuration, see https://github.com/zhustec/jekyll-diagrams. - # feel free to comment out this section if not using jekyll diagrams. + webp: "-auto-orient -quality 85" +# Lazy loading images +# If you enable lazy loading, all images will add the loading="lazy" attribute. +# This will make your site load faster, but it may not be supported in all browsers. +# You can also set loading="" to other values for specific images to override the default behavior. +# Options: "auto", "eager", "lazy" +# See https://web.dev/browser-level-image-lazy-loading/ for more information. +lazy_loading_images: true # enables lazy loading of images (recommended) # ----------------------------------------------------------------------------- # Optional Features # ----------------------------------------------------------------------------- -enable_google_analytics: false # enables google analytics -enable_panelbear_analytics: false # enables panelbear analytics -enable_google_verification: false # enables google site verification -enable_bing_verification: false # enables bing site verification -enable_masonry: true # enables automatic project cards arangement -enable_math: true # enables math typesetting (uses MathJax) -enable_tooltips: false # enables automatic tooltip links generated - # for each section titles on pages and posts -enable_darkmode: true # enables switching between light/dark modes -enable_navbar_social: true # enables displaying social links in the - # navbar on the about page -enable_project_categories: true # enables categorization of projects into - # multiple categories -enable_medium_zoom: true # enables image zoom feature (as on medium.com) -enable_progressbar: true # enables a horizontal progress bar linked to the vertical scroll position +enable_google_analytics: false # enables google analytics +enable_cronitor_analytics: false # enables cronitor RUM analytics +enable_pirsch_analytics: false # enables Pirsch analytics (https://pirsch.io/) +enable_openpanel_analytics: false # enables Openpanel analytics (https://openpanel.dev/) +enable_google_verification: false # enables google site verification +enable_bing_verification: false # enables bing site verification +enable_cookie_consent: false # enables GDPR-compliant cookie consent dialog (https://github.com/orestbida/cookieconsent) +enable_masonry: true # enables automatic project cards arrangement +enable_math: true # enables math typesetting (uses MathJax) +enable_tooltips: false # enables automatic tooltip links generated for each section titles on pages and posts +enable_darkmode: true # enables switching between light/dark modes +enable_navbar_social: false # enables displaying social links in the navbar on the about page +enable_project_categories: true # enables categorization of projects into multiple categories +enable_medium_zoom: true # enables image zoom feature (as on medium.com) +enable_progressbar: true # enables a horizontal progress bar linked to the vertical scroll position +enable_video_embedding: false # enables video embedding for bibtex entries. If false, the button opens the video link in a new window. # ----------------------------------------------------------------------------- # Library versions # ----------------------------------------------------------------------------- -academicons: - version: "1.9.1" - integrity: "sha256-i1+4qU2G2860dGGIOJscdC30s9beBXjFfzjWLjBRsBg=" -bootstrap: - version: "4.6.1" - integrity: - css: "sha256-DF7Zhf293AJxJNTmh5zhoYYIMs2oXitRfBjY+9L//AY=" - js: "sha256-fgLAgv7fyCGopR/gBNq2iW3ZKIdqIcyshnUULC4vex8=" -fontawesome: - version: "5.15.4" - integrity: "sha256-mUZM63G8m73Mcidfrv5E+Y61y7a12O5mW4ezU3bxqW4=" -jquery: - version: "3.6.0" - integrity: "sha256-/xUj+3OJU5yExlq6GSYGSHk7tPXikynS7ogEvDej/m4=" -mathjax: - version: "3.2.0" -masonry: - version: "4.2.2" - integrity: "sha256-Nn1q/fx0H7SNLZMQ5Hw5JLaTRZp0yILA/FRexe19VdI=" -mdb: - version: "4.20.0" - integrity: - css: "sha256-jpjYvU3G3N6nrrBwXJoVEYI/0zw8htfFnhT9ljN3JJw=" - js: "sha256-NdbiivsvWt7VYCt6hYNT3h/th9vSTL4EDWeGs5SN3DA=" -medium_zoom: - version: "1.0.8" - integrity: "sha256-7PhEpEWEW0XXQ0k6kQrPKwuoIomz8R8IYyuU1Qew4P8=" +# Add the url, version and integrity hash of the libraries you use in your site. +# The integrity hash is used to ensure that the library is not tampered with. +# Integrity hashes not provided by the libraries were generated using https://www.srihash.org/ +third_party_libraries: + download: false # if true, download the versions of the libraries specified below and use the downloaded files + bootstrap-table: + integrity: + css: "sha256-uRX+PiRTR4ysKFRCykT8HLuRCub26LgXJZym3Yeom1c=" + js: "sha256-4rppopQE9POKfukn2kEvhJ9Um25Cf6+IDVkARD0xh78=" + url: + css: "https://cdn.jsdelivr.net/npm/bootstrap-table@{{version}}/dist/bootstrap-table.min.css" + js: "https://cdn.jsdelivr.net/npm/bootstrap-table@{{version}}/dist/bootstrap-table.min.js" + version: "1.22.4" + chartjs: + integrity: + js: "sha256-0q+JdOlScWOHcunpUk21uab1jW7C1deBQARHtKMcaB4=" + url: + js: "https://cdn.jsdelivr.net/npm/chart.js@{{version}}/dist/chart.umd.min.js" + version: "4.4.1" + d3: + integrity: + js: "sha256-1rA678n2xEx7x4cTZ5x4wpUCj6kUMZEZ5cxLSVSFWxw=" + url: + js: "https://cdn.jsdelivr.net/npm/d3@{{version}}/dist/d3.min.js" + version: "7.8.5" + diff2html: + integrity: + css: "sha256-IMBK4VNZp0ivwefSn51bswdsrhk0HoMTLc2GqFHFBXg=" + js: "sha256-eU2TVHX633T1o/bTQp6iIJByYJEtZThhF9bKz/DcbbY=" + url: + css: "https://cdn.jsdelivr.net/npm/diff2html@{{version}}/bundles/css/diff2html.min.css" + js: "https://cdn.jsdelivr.net/npm/diff2html@{{version}}/bundles/js/diff2html-ui.min.js" + version: "3.4.47" + echarts: + integrity: + js: + library: "sha256-QvgynZibb2U53SsVu98NggJXYqwRL7tg3FeyfXvPOUY=" + dark_theme: "sha256-sm6Ui9w41++ZCWmIWDLC18a6ki72FQpWDiYTDxEPXwU=" + url: + js: + library: "https://cdn.jsdelivr.net/npm/echarts@{{version}}/dist/echarts.min.js" + dark_theme: "https://cdn.jsdelivr.net/npm/echarts@{{version}}/theme/dark-fresh-cut.js" + version: "5.5.0" + google_fonts: + url: + fonts: "https://fonts.googleapis.com/css?family=Roboto:300,400,500,700|Roboto+Slab:100,300,400,500,700|Material+Icons&display=swap" + highlightjs: + integrity: + css: + light: "sha256-Oppd74ucMR5a5Dq96FxjEzGF7tTw2fZ/6ksAqDCM8GY=" + dark: "sha256-nyCNAiECsdDHrr/s2OQsp5l9XeY2ZJ0rMepjCT2AkBk=" + url: + css: + light: "https://cdn.jsdelivr.net/npm/highlight.js@{{version}}/styles/github.min.css" + dark: "https://cdn.jsdelivr.net/npm/highlight.js@{{version}}/styles/github-dark.min.css" + version: "11.9.0" + imagesloaded: + integrity: + js: "sha256-htrLFfZJ6v5udOG+3kNLINIKh2gvoKqwEhHYfTTMICc=" + url: + js: https://cdn.jsdelivr.net/npm/imagesloaded@{{version}}/imagesloaded.pkgd.min.js + version: "5.0.0" + img-comparison-slider: + integrity: + css: "sha256-3qTIuuUWIFnnU3LpQMjqiXc0p09rvd0dmj+WkpQXSR8=" + js: "sha256-EXHg3x1K4oIWdyohPeKX2ZS++Wxt/FRPH7Nl01nat1o=" + map: "sha256-3wfqS2WU5kGA/ePcgFzJXl5oSN1QsgZI4/edprTgX8w=" + url: + css: "https://cdn.jsdelivr.net/npm/img-comparison-slider@{{version}}/dist/styles.min.css" + js: "https://cdn.jsdelivr.net/npm/img-comparison-slider@{{version}}/dist/index.min.js" + map: "https://cdn.jsdelivr.net/npm/img-comparison-slider@{{version}}/dist/index.js.map" + version: "8.0.6" + jquery: + integrity: + js: "sha256-/xUj+3OJU5yExlq6GSYGSHk7tPXikynS7ogEvDej/m4=" + url: + js: "https://cdn.jsdelivr.net/npm/jquery@{{version}}/dist/jquery.min.js" + version: "3.6.0" + leaflet: + integrity: + css: "sha256-q9ba7o845pMPFU+zcAll8rv+gC+fSovKsOoNQ6cynuQ=" + js: "sha256-MgH13bFTTNqsnuEoqNPBLDaqxjGH+lCpqrukmXc8Ppg=" + js_map: "sha256-YAoQ3FzREN4GmVENMir8vgHHypC0xfSK3CAxTHCqx1M=" + local: + images: "images/" + url: + css: "https://cdn.jsdelivr.net/npm/leaflet@{{version}}/dist/leaflet.min.css" + images: "https://cdn.jsdelivr.net/npm/leaflet@{{version}}/dist/images/" + js: "https://cdn.jsdelivr.net/npm/leaflet@{{version}}/dist/leaflet.min.js" + js_map: "https://cdn.jsdelivr.net/npm/leaflet@{{version}}/dist/leaflet.js.map" + version: "1.9.4" + lightbox2: + integrity: + css: "sha256-uypRbsAiJcFInM/ndyI/JHpzNe6DtUNXaWEUWEPfMGo=" + js: "sha256-A6jI5V9s1JznkWwsBaRK8kSeXLgIqQfxfnvdDOZEURY=" + url: + css: "https://cdn.jsdelivr.net/npm/lightbox2@{{version}}/dist/css/lightbox.min.css" + js: "https://cdn.jsdelivr.net/npm/lightbox2@{{version}}/dist/js/lightbox.min.js" + version: "2.11.5" + mathjax: + integrity: + js: "sha256-MASABpB4tYktI2Oitl4t+78w/lyA+D7b/s9GEP0JOGI=" + local: + fonts: "output/chtml/fonts/woff-v2/" + url: + fonts: "https://cdn.jsdelivr.net/npm/mathjax@{{version}}/es5/output/chtml/fonts/woff-v2/" + js: "https://cdn.jsdelivr.net/npm/mathjax@{{version}}/es5/tex-mml-chtml.js" + version: "3.2.2" + masonry: + integrity: + js: "sha256-Nn1q/fx0H7SNLZMQ5Hw5JLaTRZp0yILA/FRexe19VdI=" + url: + js: "https://cdn.jsdelivr.net/npm/masonry-layout@{{version}}/dist/masonry.pkgd.min.js" + version: "4.2.2" + mdb: + integrity: + css: "sha256-jpjYvU3G3N6nrrBwXJoVEYI/0zw8htfFnhT9ljN3JJw=" + css_map: "sha256-iYYMNfsJdVZjvsebJulg09miBXM4/GMTJgv1u5EZFFM=" + js: "sha256-NdbiivsvWt7VYCt6hYNT3h/th9vSTL4EDWeGs5SN3DA=" + js_map: "sha256-UPgyn4YNsT0khkBK5553QwhnlbTlU0aa+igyc6qP1bE=" + url: + css: "https://cdn.jsdelivr.net/npm/mdbootstrap@{{version}}/css/mdb.min.css" + css_map: "https://cdn.jsdelivr.net/npm/mdbootstrap@{{version}}/css/mdb.min.css.map" + js: "https://cdn.jsdelivr.net/npm/mdbootstrap@{{version}}/js/mdb.min.js" + js_map: "https://cdn.jsdelivr.net/npm/mdbootstrap@{{version}}/js/mdb.min.js.map" + version: "4.20.0" + medium_zoom: + integrity: + js: "sha256-ZgMyDAIYDYGxbcpJcfUnYwNevG/xi9OHKaR/8GK+jWc=" + url: + js: "https://cdn.jsdelivr.net/npm/medium-zoom@{{version}}/dist/medium-zoom.min.js" + version: "1.1.0" + mermaid: + integrity: + js: "sha256-TtLOdUA8mstPoO6sGvHIGx2ceXrrX4KgIItO06XOn8A=" + url: + js: "https://cdn.jsdelivr.net/npm/mermaid@{{version}}/dist/mermaid.min.js" + version: "10.7.0" + photoswipe: + integrity: + js: "sha256-VCBpdxvrNNxGHNuTdNqK9kPFkev2XY7DYzHdmgaB69Q=" + url: + css: "https://cdn.jsdelivr.net/npm/photoswipe@{{version}}/dist/photoswipe.min.css" + js: "https://cdn.jsdelivr.net/npm/photoswipe@{{version}}/dist/photoswipe.esm.min.js" + version: "5.4.4" + photoswipe-lightbox: + integrity: + js: "sha256-uCw4VgT5DMdwgtjhvU9e98nT2mLZXcw/8WkaTrDd3RI=" + url: + js: "https://cdn.jsdelivr.net/npm/photoswipe@{{version}}/dist/photoswipe-lightbox.esm.min.js" + version: "5.4.4" + plotly: + integrity: + js: "sha256-oy6Be7Eh6eiQFs5M7oXuPxxm9qbJXEtTpfSI93dW16Q=" + url: + js: "https://cdn.jsdelivr.net/npm/plotly.js@{{version}}/dist/plotly.min.js" + version: "3.0.1" + polyfill: + url: + js: "https://cdnjs.cloudflare.com/polyfill/v{{version}}/polyfill.min.js?features=es6" + version: "3" + pseudocode: + integrity: + css: "sha256-VwMV//xgBPDyRFVSOshhRhzJRDyBmIACniLPpeXNUdc=" + js: "sha256-aVkDxqyzrB+ExUsOY9PdyelkDhn/DfrjWu08aVpqNlo=" + url: + css: "https://cdn.jsdelivr.net/npm/pseudocode@{{version}}/build/pseudocode.min.css" + js: "https://cdn.jsdelivr.net/npm/pseudocode@{{version}}/build/pseudocode.min.js" + version: "2.4.1" + spotlight: + integrity: + css: "sha256-Dsvkx8BU8ntk9Iv+4sCkgHRynYSQQFP6gJfBN5STFLY=" + url: + css: "https://cdn.jsdelivr.net/npm/spotlight.js@{{version}}/dist/css/spotlight.min.css" + js: "https://cdn.jsdelivr.net/npm/spotlight.js@{{version}}/dist/spotlight.bundle.min.js" + version: "0.7.8" + swiper: + integrity: + css: "sha256-yUoNxsvX+Vo8Trj3lZ/Y5ZBf8HlBFsB6Xwm7rH75/9E=" + js: "sha256-BPrwikijIybg9OQC5SYFFqhBjERYOn97tCureFgYH1E=" + map: "sha256-lbF5CsospW93otqvWOIbbhj80CjazrZXvamD7nC7TBI=" + url: + css: "https://cdn.jsdelivr.net/npm/swiper@{{version}}/swiper-bundle.min.css" + js: "https://cdn.jsdelivr.net/npm/swiper@{{version}}/swiper-element-bundle.min.js" + map: "https://cdn.jsdelivr.net/npm/swiper@{{version}}/swiper-element-bundle.min.js.map" + version: "11.0.5" + swiper-map: + integrity: + js: "sha256-hlZaH8ySXX97bZaetnrtYlKuhx3oEXFz/s2IXchu6vk=" + url: + js: "https://cdn.jsdelivr.net/npm/swiper@11.1.0/swiper-element-bundle.min.js.map" + version: "11.0.5" + vanilla-cookieconsent: + integrity: + css: "sha256-ygRrixsQlBByBZiOcJamh7JByO9fP+/l5UPtKNJmRsE=" + js: "sha256-vG4vLmOB/AJbJ6awr7Wg4fxonG+fxAp4cIrbIFTvRXU=" + url: + css: "https://cdn.jsdelivr.net/npm/vanilla-cookieconsent@{{version}}/dist/cookieconsent.css" + js: "https://cdn.jsdelivr.net/npm/vanilla-cookieconsent@{{version}}/dist/cookieconsent.umd.js" + version: "3.1.0" + vega: + integrity: + js: "sha256-Yot/cfgMMMpFwkp/5azR20Tfkt24PFqQ6IQS+80HIZs=" + js_map: "sha256-z0x9ICA65dPkZ0JVa9wTImfF6n7AJsKc6WlFE96/wNA=" + url: + js: "https://cdn.jsdelivr.net/npm/vega@{{version}}/build/vega.min.js" + js_map: "https://cdn.jsdelivr.net/npm/vega@{{version}}/build/vega.min.js.map" + version: "5.27.0" + vega-embed: + integrity: + js: "sha256-FPCJ9JYCC9AZSpvC/t/wHBX7ybueZhIqOMjpWqfl3DU=" + js_map: "sha256-VBbfSEFYSMdX/rTdGrONEHNP6BprCB7H/LpMMNt/cPA=" + url: + js: "https://cdn.jsdelivr.net/npm/vega-embed@{{version}}/build/vega-embed.min.js" + js_map: "https://cdn.jsdelivr.net/npm/vega-embed@{{version}}/build/vega-embed.min.js.map" + version: "6.24.0" + vega-lite: + integrity: + js: "sha256-TvBvIS5jUN4BSy009usRjNzjI1qRrHPYv7xVLJyjUyw=" + js_map: "sha256-l2I4D5JC23Ulsu6e3sKVe5AJ+r+DFkzkKnZS8nUGz28=" + url: + js: "https://cdn.jsdelivr.net/npm/vega-lite@{{version}}/build/vega-lite.min.js" + js_map: "https://cdn.jsdelivr.net/npm/vega-lite@{{version}}/build/vega-lite.min.js.map" + version: "5.16.3" + venobox: + integrity: + css: "sha256-ohJEB0/WsBOdBD+gQO/MGfyJSbTUI8OOLbQGdkxD6Cg=" + js: "sha256-LsGXHsHMMmTcz3KqTaWvLv6ome+7pRiic2LPnzTfiSo=" + url: + css: "https://cdn.jsdelivr.net/npm/venobox@{{version}}/dist/venobox.min.css" + js: "https://cdn.jsdelivr.net/npm/venobox@{{version}}/dist/venobox.min.js" + version: "2.1.8" + +# ----------------------------------------------------------------------------- +# Get external JSON data +# ----------------------------------------------------------------------------- + +jekyll_get_json: + - data: resume + json: assets/json/resume.json # it can also be an url + +jsonresume: + - basics + - work + - education + - publications + - projects + - volunteer + - awards + - certificates + - skills + - languages + - interests + - references diff --git a/_data/citations.yml b/_data/citations.yml new file mode 100644 index 0000000..8aa4156 --- /dev/null +++ b/_data/citations.yml @@ -0,0 +1,4179 @@ +metadata: + last_updated: '2026-02-06' +papers: + qc6CJjYAAAAJ:-1WLWRmjvKAC: + citations: 4 + title: THE DULONG-PETIT LAW OF SPECIFIC HEATS + year: Unknown Year + qc6CJjYAAAAJ:-38epGy1wY0C: + citations: 8 + title: "Antwort auf eine Bemerkung von J. Stark:\u201E\xDCber eine Anwendung des Planckschen Elementargesetzes\u2026\u201D \uFE01" + year: '2006' + qc6CJjYAAAAJ:-3_NAp5WSNkC: + citations: 2 + title: "Die Grundlage der allgemeinen Relativit\xE4tstheorie, 20 M\xE4r 1916" + year: Unknown Year + qc6CJjYAAAAJ:-GalPxRzH2oC: + citations: 0 + title: 'The Palestine Troubles: Einstein''s Protest, Zionism''s Basis and Achievement; the Mandatory''s Task' + year: '1929' + qc6CJjYAAAAJ:-LHtoeeytlUC: + citations: 2526 + title: 'Albert Einstein: Philosopher Scientist' + year: '1969' + qc6CJjYAAAAJ:-R_Z4shfoosC: + citations: 0 + title: 'Albert Einstein] to Paul Ehrenfest: Letter, 22 Jul 1917' + year: Unknown Year + qc6CJjYAAAAJ:-Viv1fr_sjoC: + citations: 145 + title: The special theory of relativity + year: '1905' + qc6CJjYAAAAJ:-_cDHGlXAtsC: + citations: 7941 + title: Sitzungsberichte der Preussischen Akad. d + year: '1917' + qc6CJjYAAAAJ:-fj4grS0xi0C: + citations: 92 + title: 'Conceptions scientifiques, morales et sociales: traduit de l''anglais par Maurice Solovine' + year: '1952' + qc6CJjYAAAAJ:-l7FTdOV6Y0C: + citations: 195 + title: Brownian motion + year: '1936' + qc6CJjYAAAAJ:-qpA3cGbmHsC: + citations: 541 + title: On the Relation between the Expansion and the Mean Density of the Universe + year: '1932' + qc6CJjYAAAAJ:-vzq6BoH5oUC: + citations: 24 + title: "Bemerkung zu der Abhandlung von WR He\" Beitrag zur Theorie der Viskosit\xE4t heterogener Systeme\"" + year: Unknown Year + qc6CJjYAAAAJ:00hq1xGbIBsC: + citations: 0 + title: In Memory of Emmy Noether, Visiting Professor of Mathematics, Bryn Mawr College, 1922-April 1935 + year: Unknown Year + qc6CJjYAAAAJ:041faMmbr2QC: + citations: 39 + title: La relatividad + year: '1970' + qc6CJjYAAAAJ:0765WKWsAZMC: + citations: 8 + title: Remarks to the essays appearing in this collected volume + year: '1951' + qc6CJjYAAAAJ:08ZZubdj9fEC: + citations: 33 + title: 'Einstein''s 1912 manuscript on the special theory of relativity: a facsimile' + year: '1996' + qc6CJjYAAAAJ:0D9gKr9vLLUC: + citations: 10 + title: Elementary Considerations on the Interpretation of the Foundations of Quantum Mechanics + year: '2011' + qc6CJjYAAAAJ:0EnyYjriUFMC: + citations: 1176 + title: 'The Born Einstein Letters: correspondence between Albert Einstein and Max and Hedwig Born from 1916 to 1955 with commentaries by Max Born. Translated by Irene Born' + year: '1971' + qc6CJjYAAAAJ:0KZCP5UExFUC: + citations: 37 + title: 'Einstein''s Annalen papers: the complete collection 1901-1922' + year: '2005' + qc6CJjYAAAAJ:0KrOiVmbFBYC: + citations: 0 + title: "Zeitungen gleichen Sparb\xFCchern: dass sie voll geschrieben sind, bedeutet noch nichts." + year: Unknown Year + qc6CJjYAAAAJ:0SnApaDgcCoC: + citations: 71 + title: podolsky B and Rosen N 1935 Phys + year: Unknown Year + qc6CJjYAAAAJ:0UEtxawf5sEC: + citations: 0 + title: "II. A. On The Inevitability and Prevention Of Nuclear War/Or. Martin E. Hellman The unleashed power of the atom has changed everything save our modes of thinking and we thus \u2026" + year: '1986' + qc6CJjYAAAAJ:0VGYH9MJNTkC: + citations: 0 + title: "Aux historiens des travaux d'Einstein sur la th\xE9orie du rayonnement quantique." + year: Unknown Year + qc6CJjYAAAAJ:0izwh0c-50kC: + citations: 0 + title: "Professora, a maioria da turma n\xE3o est\xE1 entendendo nada! Construindo olhares e atitudes transdisciplinares" + year: Unknown Year + qc6CJjYAAAAJ:0kYikfLtzSYC: + citations: 0 + title: 'The Einstein Theory of Relativity: A Concise Statement by Prof. HA Lorentz' + year: '2009' + qc6CJjYAAAAJ:0klj8wIChNAC: + citations: 0 + title: Sulla teoria della relativita del tempo e dello spazio di Alberto Einsteni, nei rapporti dei fenomeni luminosi ed elettrici + year: '1922' + qc6CJjYAAAAJ:0q7iQwrhYWUC: + citations: 15 + title: Correspondencia con Michele Besso:(1903-1955) + year: '1994' + qc6CJjYAAAAJ:0t1ZDozeHsAC: + citations: 4 + title: Essays in science + year: '1954' + qc6CJjYAAAAJ:0wD49__q8KEC: + citations: 0 + title: 'Albert Einstein] to Heinrich Zangger: Letter, 10 Mar 1917' + year: Unknown Year + qc6CJjYAAAAJ:0z-ogHnYXbUC: + citations: 5 + title: reprinted 1956. On the theory of Brownian movement + year: '1906' + qc6CJjYAAAAJ:12nnf2f32iYC: + citations: 0 + title: "Albert Einstein] to Michael Pol\xE1nyi: Letter, 8 May 1915" + year: Unknown Year + qc6CJjYAAAAJ:17ZO-CJnx_8C: + citations: 241 + title: "Die Nordstr\xF6msche gravitationstheorie vom standpunkt des absoluten Differentialkalk\xFCls" + year: '1914' + qc6CJjYAAAAJ:1AS7WB7zg6gC: + citations: 81 + title: "L'\xE9ther et la th\xE9orie de la relativit\xE9" + year: '1921' + qc6CJjYAAAAJ:1DhOeZtQFr0C: + citations: 428 + title: Principle Points of the General Theory of Relativity + year: '1918' + qc6CJjYAAAAJ:1EM7I_rJWO4C: + citations: 0 + title: Planetary perspective + year: Unknown Year + qc6CJjYAAAAJ:1GSnt3Xtl_sC: + citations: 0 + title: 'Albert Einstein] to Fritz Haber: Letter, before 20 Dec 1918' + year: Unknown Year + qc6CJjYAAAAJ:1HYIo8DVeu0C: + citations: 11 + title: Sulla teoria speciale e generale della relativita:(volgarizzazione) + year: '1921' + qc6CJjYAAAAJ:1Lcp1PKUB6cC: + citations: 0 + title: "Albert Einstein] to Constantin Carath\xE9odory: Letter, 6 Sep 1916" + year: Unknown Year + qc6CJjYAAAAJ:1QLOHW2CHAAC: + citations: 91 + title: Letter to M Besso + year: '1942' + qc6CJjYAAAAJ:1cQOl6Zi554C: + citations: 14 + title: La lucha contra la guerra + year: '1986' + qc6CJjYAAAAJ:1l3MdapXzAoC: + citations: 392 + title: 'Hedwig und Max Born: Briefwechsel 1916-1955' + year: '1969' + qc6CJjYAAAAJ:1lB6hEDIqXYC: + citations: 0 + title: 'Albert Einstein] to Wander and Geertruida de Haas: Letter, before 15 Nov 1915' + year: Unknown Year + qc6CJjYAAAAJ:1n-LKbgTOzoC: + citations: 0 + title: On the quantitative theory of radiation + year: '2005' + qc6CJjYAAAAJ:1u-ON_Kw9acC: + citations: 0 + title: Winter Inquiry Land + year: Unknown Year + qc6CJjYAAAAJ:1xBWf43XMUgC: + citations: 40 + title: "Ueber die thermodynamische Theorie der Potentialdifferenz zwischen Metallen und vollst\xE4ndig dissociirten L\xF6sungen ihrer Salze und \xFCber eine elektrische Methode zur Erforschung \u2026" + year: '2005' + qc6CJjYAAAAJ:2168PZyDXAcC: + citations: 0 + title: 'Albert Einstein] to Willem de Sitter: Letter, 8 Aug 1917' + year: Unknown Year + qc6CJjYAAAAJ:22I2CSi1iVUC: + citations: 0 + title: 'Albert Einstein] to David Hilbert: Letter, 12 Apr 1918' + year: Unknown Year + qc6CJjYAAAAJ:23Hg5vt_rPQC: + citations: 0 + title: "Die Einstein-Sammlung der ETH-Bibliothek in Z\xFCrich: ein Ueberblick f\xFCr Ben\xFCtzer der Handschriften-Abteilung" + year: '1970' + qc6CJjYAAAAJ:2C0LhDdYSbcC: + citations: 1497 + title: "Le principe de relativit\xE9 et ses cons\xE9quences dans la physique moderne" + year: '1910' + qc6CJjYAAAAJ:2KloaMYe4IUC: + citations: 32 + title: The Einstein Reader + year: '2006' + qc6CJjYAAAAJ:2Q0AJrNhS-QC: + citations: 71 + title: "Zur Theorie der R\xE4ume mit Riemann\u2010Metrik und Fernparallelismus" + year: '2006' + qc6CJjYAAAAJ:2VmNxfDIOWgC: + citations: 0 + title: 'Albert Einstein] to Conrad Habicht: Letter, 15 Apr 1904' + year: Unknown Year + qc6CJjYAAAAJ:2ZctHUgIzyAC: + citations: 472 + title: "La g\xE9om\xE9trie et l'exp\xE9rience" + year: '1921' + qc6CJjYAAAAJ:2hfDYGh-f1UC: + citations: 0 + title: Planck-Medaille + year: '1928' + qc6CJjYAAAAJ:2mus-XyGPC0C: + citations: 62 + title: Demonstration of the non-existence of gravitational fields with a non-vanishing total mass free of singularities + year: '1941' + qc6CJjYAAAAJ:35r97b3x0nAC: + citations: 6 + title: "Sur le probl\xE8me cosmologique: th\xE9orie de la gravitation g\xE9n\xE9ralis\xE9e" + year: '1951' + qc6CJjYAAAAJ:3ERjdSgnfPsC: + citations: 0 + title: "Mamlekhet Lin\u1E33e\u02BCus: tokhnit li-yetsirat mish\u1E6Dar \u1E25ayim \u1E25adash, ta\u1E33in \u1E7Fe-enoshi" + year: '1939' + qc6CJjYAAAAJ:3NskZpgvI9IC: + citations: 0 + title: "Probl\xE8mes des dimensions de l'espace et la cosmologie." + year: Unknown Year + qc6CJjYAAAAJ:3_iODIlCio4C: + citations: 0 + title: "Le caract\xE8re unique et multiple de la mati\xE8re dans la repr\xE9sentation physique de l'univers." + year: Unknown Year + qc6CJjYAAAAJ:3eo-xq64HD0C: + citations: 0 + title: 'Albert Einstein] to Wilhelm von Siemens: Letter, 4 Jan 1918' + year: Unknown Year + qc6CJjYAAAAJ:3fE2CSJIrl8C: + citations: 328 + title: A generalization of the relativistic theory of gravitation, II + year: '1946' + qc6CJjYAAAAJ:3pYxbvHKFu8C: + citations: 276 + title: Briefwechsel 1916-1955 + year: '1972' + qc6CJjYAAAAJ:3s1wT3WcHBgC: + citations: 78 + title: A brief outline of the development of the theory of relativity + year: '1921' + qc6CJjYAAAAJ:3s2jc9hNhkQC: + citations: 0 + title: Relativity in Newtonian Mechanics and the Michelson-Morley Experiment + year: Unknown Year + qc6CJjYAAAAJ:3vbIHxFL9FgC: + citations: 149 + title: "Experimenteller Nachweis der Amp\xE8reschen Molekularstr\xF6me" + year: '1915' + qc6CJjYAAAAJ:3z7foVzkq2cC: + citations: 10 + title: The nature of reality + year: '1931' + qc6CJjYAAAAJ:45AZ0Vt6gvEC: + citations: 0 + title: Nachtrag zu meiner Arbeit:Thermodynamische Begruendung des photochemischen Aequivalentgesetzes'(from Annalen der Physik 1912) + year: '1993' + qc6CJjYAAAAJ:4Bh_hC5jS3YC: + citations: 7014 + title: Graviton Mass and Inertia Mass + year: '1911' + qc6CJjYAAAAJ:4DMP91E08xMC: + citations: 537 + title: The Origins of the General Theory of Relativity + year: '1933' + qc6CJjYAAAAJ:4E1Y8I9HL1wC: + citations: 10 + title: Gravitationstheorie + year: '1913' + qc6CJjYAAAAJ:4EsMycecMEYC: + citations: 0 + title: 'PERSONAY SOCIEDAD: PERSPECTIVAS PARA EL SIGLO XXI' + year: '2006' + qc6CJjYAAAAJ:4IpgxnMJogoC: + citations: 0 + title: 'Albert Einstein] to Mileva Einstein-Maric: Letter, 17 Apr 1908' + year: Unknown Year + qc6CJjYAAAAJ:4JMBOYKVnBMC: + citations: 2911 + title: Quantentheorie des einatomigen idealen Gases + year: '1924' + qc6CJjYAAAAJ:4QKQTXcH0q8C: + citations: 76 + title: "Kritisches zu einer von Hrn. de Sitter gegebenen L\xF6sung der Gravitationsgleichungen" + year: '1918' + qc6CJjYAAAAJ:4S6zbAYdD6oC: + citations: 14 + title: Naturwissenschaft und Religion + year: '1960' + qc6CJjYAAAAJ:4TOpqqG69KYC: + citations: 33 + title: 'Die Evolution der Physik: Von Newton bis zur Quantentheorie' + year: '1956' + qc6CJjYAAAAJ:4UtermoNRQAC: + citations: 51 + title: Autobiographische Skizze + year: '1956' + qc6CJjYAAAAJ:4ZjPyBmb-CUC: + citations: 1 + title: The nature and cause of mantle heterogeneity + year: Unknown Year + qc6CJjYAAAAJ:4_yl7nwqy4oC: + citations: 0 + title: Einstein on science + year: '2000' + qc6CJjYAAAAJ:4fKUyHm3Qg0C: + citations: 62 + title: 'Albert Einstein, Mileva Maric: The Love Letters' + year: '2000' + qc6CJjYAAAAJ:4hFrxpcac9AC: + citations: 0 + title: "L'heure H at-elle sonn\xE9 pour le monde?: Effets accumulatifs des explosions nucl\xE9aires" + year: '1955' + qc6CJjYAAAAJ:4oJvMfeQlr8C: + citations: 20 + title: Vorschlag zu einem die Natur des elementaren Strahlungs-Emissionsprozesses betreffenden Experiment + year: '1926' + qc6CJjYAAAAJ:4sHRCyKql0sC: + citations: 0 + title: 'The collected papers of Albert Einstein. Vol. 8, The Berlin years: correspondence, 1914-1918:[English translation]' + year: Unknown Year + qc6CJjYAAAAJ:4xIGDXbuNMYC: + citations: 0 + title: "DESARROLLO DE COMPETENCIAS EN LA FORMACI\xD3N INICIAL DE DOCENTES, A PARTIR DE LA EJECUCI\xD3N" + year: Unknown Year + qc6CJjYAAAAJ:4xcnnZsK8tIC: + citations: 5 + title: "La teor\xEDa de la relatividad: Al alcance de todos" + year: '1925' + qc6CJjYAAAAJ:5-bGDoUgDrYC: + citations: 0 + title: 'Einstein, the Man and His Achievement: A Series of Broadcast Talks' + year: '1967' + qc6CJjYAAAAJ:5-tCjTwfAdEC: + citations: 459 + title: "Die Relativit\xE4tstheorie" + year: '1915' + qc6CJjYAAAAJ:5Hlrm_bZEgcC: + citations: 13 + title: "Einstein und \xD6sterreich: nach einem Vortrag in der Chemisch-Physikalischen Gesellschaft zu Wien im April 1979, hundert Jahre nach der Geburt des gro\xDFen Meisters" + year: '1980' + qc6CJjYAAAAJ:5LOebrzo1TYC: + citations: 0 + title: 'Albert Einstein] to Hendrik A. Lorentz: Letter, 1 Jan 1916' + year: Unknown Year + qc6CJjYAAAAJ:5LPo_wSKItgC: + citations: 104 + title: "Bemerkung zu der Arbeit von A. Friedmann \u201E\xDCber die Kr\xFCmmung des Raumes \u201C" + year: '1922' + qc6CJjYAAAAJ:5McdzzY_mmwC: + citations: 42 + title: Correspondence 1916-1955 [entre] Albert Einstein, Max Born et Hedwig Born + year: '1972' + qc6CJjYAAAAJ:5UUbrqTvKfUC: + citations: 0 + title: Dr. Albert Einstein and American Colleagues, 1931 + year: '1949' + qc6CJjYAAAAJ:5Y1KH4bkPm0C: + citations: 0 + title: 'Albert Einstein] to Carl Heinrich Becker: Letter, 25 Nov 1918' + year: Unknown Year + qc6CJjYAAAAJ:5Y7y0xowK3MC: + citations: 9 + title: "Fisica e realt\xE0" + year: '1965' + qc6CJjYAAAAJ:5awf1xo2G04C: + citations: 15 + title: Escritos sobre la paz + year: '1967' + qc6CJjYAAAAJ:5bFWG3eDk9wC: + citations: 0 + title: 'Albert Einstein] to Emil Beck: Letter, 30 Apr 1917' + year: Unknown Year + qc6CJjYAAAAJ:5bGIVMdsOr0C: + citations: 172 + title: My theory + year: '1919' + qc6CJjYAAAAJ:5pGZGXnFQ_sC: + citations: 10000 + title: Sitzungsber. K + year: '1925' + qc6CJjYAAAAJ:5qfkUJPXOUwC: + citations: 161 + title: Unified field theory of gravitation and electricity + year: '1925' + qc6CJjYAAAAJ:5rMqqAh47xYC: + citations: 26 + title: "Pr\xFCfung der allgemeinen Relativit\xE4tstheorie" + year: '1919' + qc6CJjYAAAAJ:5y95FQUaxGgC: + citations: 0 + title: "Le caract\xE8re r\xE9p\xE9titif cyclique r\xE9gulier des bonds dans l'\xE9volution de la science correspondant \xE0 l'activit\xE9 solaire." + year: Unknown Year + qc6CJjYAAAAJ:62yiFa7nMbkC: + citations: 0 + title: "Die Not der deutschen Wissenschaft. Eine Gefahr f\xFCr die Nation, 21 Dez 1921" + year: Unknown Year + qc6CJjYAAAAJ:6B7w4NK6UsoC: + citations: 0 + title: 'Doctrines about the Universe: With Proof in the Form of a Letter to the Public and to Professor Einstein' + year: '1821' + qc6CJjYAAAAJ:6CdnuHuKHxIC: + citations: 79 + title: Refrigeration + year: '1927' + qc6CJjYAAAAJ:6DS7WFnF4J4C: + citations: 138 + title: Koniglich Preussische Akademie der Wissenschaften + year: '1983' + qc6CJjYAAAAJ:6Dd5luMImnEC: + citations: 0 + title: 'Albert Einstein] to Hans Albert Einstein: Letter, 15 Apr 1916' + year: Unknown Year + qc6CJjYAAAAJ:6E5OHDUOeTQC: + citations: 0 + title: 'Albert Einstein] to Hermann Weyl: Letter, 31 May 1918' + year: Unknown Year + qc6CJjYAAAAJ:6IwoDg2IE1oC: + citations: 2 + title: Comments on the Work of Friedmann + year: '1986' + qc6CJjYAAAAJ:6biGW3np0psC: + citations: 0 + title: "Conceptos, ambientes de aprendizaje:\xBF c\xF3mo aprendemos los humanos en diferentes contextos? Waleska Aldana Segura" + year: Unknown Year + qc6CJjYAAAAJ:6ftYtcnYaCAC: + citations: 338 + title: Ather and Relativitatstheorie. J + year: '1920' + qc6CJjYAAAAJ:6gD0efnhv6MC: + citations: 0 + title: 'Emmeline Hansen Salt Lake Community College Physics Term Paper: Albert Einstein Biography' + year: Unknown Year + qc6CJjYAAAAJ:6jAoOr-ogVAC: + citations: 0 + title: "La ley de gravitaci\xF3n de Einstein a prop\xF3sito de algunas cr\xEDticas recientes" + year: '1927' + qc6CJjYAAAAJ:6tHXJaRVc1QC: + citations: 95 + title: Sobranie nauchnykh trudov + year: '1967' + qc6CJjYAAAAJ:70eg2SAEIzsC: + citations: 61 + title: "Bietet die feldtheorie M\xF6glichkeiten f\xFCr die L\xF6sung des Quantenproblems?" + year: '1923' + qc6CJjYAAAAJ:7DJsn6tmoAwC: + citations: 325 + title: "\xC4ther und Relativit\xE4ts-theorie" + year: '1920' + qc6CJjYAAAAJ:7DTIKO_nxaIC: + citations: 0 + title: 'Albert Einstein] to Hans Albert Einstein: Letter, 8 Jan 1917' + year: Unknown Year + qc6CJjYAAAAJ:7VEv-pLvLSsC: + citations: 338 + title: "Elementare Betrachtungen \xFCber die thermische Molekularbewegung in festen K\xF6rpern" + year: '1911' + qc6CJjYAAAAJ:7XUxBq3GufIC: + citations: 0 + title: On the Quantization Condition of Sommerfeld and Epstein + year: '1980' + qc6CJjYAAAAJ:7YMrAF6eRCIC: + citations: 0 + title: 'On the Non-existence of Regular Stationary Solutions of Relativistic Field Equations: Annals of Mathematics, Vol. 44, No. 2, April 1943;(received January 4, 1943)' + year: '1943' + qc6CJjYAAAAJ:7bRg-L-9LFcC: + citations: 15 + title: How I see the world + year: '1991' + qc6CJjYAAAAJ:7eciy3tyNvQC: + citations: 0 + title: Strahlungs-Emission und-Absorption nach der Quantentheorie, 17 Jul 1916 + year: Unknown Year + qc6CJjYAAAAJ:7gse_HdimRUC: + citations: 9 + title: Why Do They Hate the Jews? + year: '1938' + qc6CJjYAAAAJ:7hTFQKV_Y-MC: + citations: 10 + title: 'Human Folly: To Disarm Or Perish?' + year: '1955' + qc6CJjYAAAAJ:7ioeYXKzaWoC: + citations: 29 + title: Komptonsche Experiment + year: '1924' + qc6CJjYAAAAJ:7q08wCQPkLwC: + citations: 0 + title: Briefe Albert Einsteins an Joseph Petzoldt + year: '1971' + qc6CJjYAAAAJ:84Dmd_oSKgsC: + citations: 0 + title: 'Albert Einstein] to Johannes Stark: Letter, 17 Feb 1908' + year: Unknown Year + qc6CJjYAAAAJ:8AbLer7MMksC: + citations: 827 + title: 'The Collected Papers of Albert Einstein, Vol. 5: The Swiss Years: Correspondence, 1902-1914' + year: '1995' + qc6CJjYAAAAJ:8NHCvSvNRCIC: + citations: 0 + title: 'Albert Einstein] to Paul Ehrenfest: Letter, 12 Nov 1917' + year: Unknown Year + qc6CJjYAAAAJ:8QO3eJiZnkEC: + citations: 0 + title: 'Albert Einstein] to the Department of Education: Letter, Canton of Bern' + year: Unknown Year + qc6CJjYAAAAJ:8Rip7PbZ7AYC: + citations: 0 + title: Einstein's Generalized Theory of Gravitation + year: '1969' + qc6CJjYAAAAJ:8VbLR7ExW8oC: + citations: 7 + title: Antwort auf eine Replik Paul Harzers (Nr. 4753, S. 10 und 11) + year: '1914' + qc6CJjYAAAAJ:8Wa-k36u3iwC: + citations: 0 + title: "Albert Einstein] to Th\xE9ophile de Donder: Letter, 17 Jul 1916" + year: Unknown Year + qc6CJjYAAAAJ:8_tS2Vw13FcC: + citations: 0 + title: Otto Stern Papers + year: '1968' + qc6CJjYAAAAJ:8aAMN6PqWdYC: + citations: 36 + title: "Sobre el humanismo: Escritos sobre pol\xEDtica, sociedad y ciencia" + year: '1995' + qc6CJjYAAAAJ:8dmKnlANe1sC: + citations: 2 + title: The Arabs and Palestine + year: '1944' + qc6CJjYAAAAJ:8gBurD7jEYQC: + citations: 9 + title: "Bemerkung zu der Arbeit von D. Mirimanoff \u201E\xDCber die Grundgleichungen\u2026\u201D \uFE01" + year: '1909' + qc6CJjYAAAAJ:8k81kl-MbHgC: + citations: 380 + title: Essays in science + year: '2011' + qc6CJjYAAAAJ:8moDcb_GFzgC: + citations: 0 + title: 'Albert Einstein] to Erwin Freundlich: Letter, 19 Mar 1915' + year: Unknown Year + qc6CJjYAAAAJ:8p-ueveQw4wC: + citations: 10 + title: "Ciencia y religi\xF3n" + year: '1984' + qc6CJjYAAAAJ:8p8iYwVyaVcC: + citations: 25 + title: "Bemerkung zu der Franz Seletyschen Arbeit\u201D \uFE01Beitr\xE4ge zum kosmologischen System \u201E" + year: '1922' + qc6CJjYAAAAJ:8s22W2WWFy4C: + citations: 0 + title: "Die Einstein-Dokumente im Archiv der Humboldt-Universit\xE4t zu Berlin" + year: '1973' + qc6CJjYAAAAJ:94rQ0kDLHKYC: + citations: 4553 + title: Evolution of Physics + year: '1954' + qc6CJjYAAAAJ:9CGX2owmTHMC: + citations: 0 + title: DIE NATLIRWISSENSCHAFTEN + year: Unknown Year + qc6CJjYAAAAJ:9LpHyFPp1DQC: + citations: 525 + title: "Riemann\u2010Geometrie mit Aufrechterhaltung des Begriffes des Fernparallelismus" + year: '1928' + qc6CJjYAAAAJ:9N3KX2BFTccC: + citations: 103 + title: Elementare Uberlegungen zur Interpretation der Grundlagen der Quanten-Mechanik + year: '1953' + qc6CJjYAAAAJ:9PbDelcLwNgC: + citations: 35 + title: On the theory of light production and light absorption + year: '1906' + qc6CJjYAAAAJ:9QTmwX2E1jEC: + citations: 0 + title: 'Albert Einstein] to Walther Rathenau: Letter, 8 Mar 1917' + year: Unknown Year + qc6CJjYAAAAJ:9aOYe38lPcwC: + citations: 16 + title: On the general molecular theory of heat + year: '1904' + qc6CJjYAAAAJ:9bzyojSiTPoC: + citations: 4 + title: Pump, especially for refrigerating machine + year: '1931' + qc6CJjYAAAAJ:9fSugHr6AN8C: + citations: 14 + title: 'Emanuel Lasker: Biogr. e. Schachweltmeisters' + year: '1952' + qc6CJjYAAAAJ:9hNLEifDsrsC: + citations: 0 + title: "Albert Einstein] to Emma Ehrat-\xDChlinger: Letter, last week of Mar 1903" + year: Unknown Year + qc6CJjYAAAAJ:9o6PfxSMcEIC: + citations: 10 + title: "Cum v\u0103d eu lumea: o antologie" + year: '1992' + qc6CJjYAAAAJ:9tJtKg94vZsC: + citations: 210 + title: Do gravitational fields play an essential role in the structure of elementary particles? + year: '1919' + qc6CJjYAAAAJ:9tletLqOvukC: + citations: 4 + title: "Fizika i real\u02B9nost\u02B9: sbornik state\u012D" + year: '1965' + qc6CJjYAAAAJ:9u2w3wkYHSMC: + citations: 92 + title: "Maxwell\u2019s influence on the development of the conception of physical reality" + year: '1931' + qc6CJjYAAAAJ:9xDRhSErrBIC: + citations: 89 + title: "Letter to Schr\xF6dinger" + year: '1950' + qc6CJjYAAAAJ:9xhnSCvx0jcC: + citations: 0 + title: 'Albert Einstein] to Edgar Meyer: Letter, after 12 Oct 1918' + year: Unknown Year + qc6CJjYAAAAJ:A5aiAONn640C: + citations: 20 + title: Religion und Wissenschaft + year: '1930' + qc6CJjYAAAAJ:A8NefVh_EAoC: + citations: 0 + title: 'Albert Einstein] to Otto Stern: Letter, 27 Mar 1916' + year: Unknown Year + qc6CJjYAAAAJ:AE81f6nWjdQC: + citations: 0 + title: "Wir sind gewarnt. Mit einem Vorw. von Albert Einstein.[Aus dem franz\xF6sischen \xFCbertr. von W. Theimer]." + year: '1955' + qc6CJjYAAAAJ:AFXcoJnoRH0C: + citations: 83 + title: Einheitliche Feldtheorie und Hamiltonsches Prinzip + year: '2006' + qc6CJjYAAAAJ:APw3zysQxTcC: + citations: 0 + title: "Einstein: \u0111\u1EDDi song v\xE0 t\u01AF\u1EDFng" + year: '1982' + qc6CJjYAAAAJ:AQkP-AuIKnwC: + citations: 12 + title: La relativit# a speciale + year: '1920' + qc6CJjYAAAAJ:AVQCy-ZCKIsC: + citations: 109 + title: "Planck\u2019s theory of radiation and the theory of specific heat" + year: '1907' + qc6CJjYAAAAJ:AYaE08C4-t8C: + citations: 17 + title: Prinzipien der Forschung + year: '1918' + qc6CJjYAAAAJ:A_-8YG8SPFQC: + citations: 14 + title: 'Albert Einstein] to Michele Besso: Letter, 11 Aug 1916' + year: Unknown Year + qc6CJjYAAAAJ:A_xf8jiGkywC: + citations: 0 + title: 'Albert Einstein] to Wander de Haas: Letter, 7 Aug 1915' + year: Unknown Year + qc6CJjYAAAAJ:AbQWx2m_oG8C: + citations: 23 + title: "\xDCber ein den Elementarproze\xC3\u0178 der Lichtemission betreffendes Experiment" + year: '1921' + qc6CJjYAAAAJ:AdUz3-SiDfgC: + citations: 96 + title: 'Letters on Absolute Parallelism, 1929-1932: Correspondence Between Elie Cartan and Albert Einstein' + year: '1979' + qc6CJjYAAAAJ:AeQkyvggb0MC: + citations: 84 + title: The Theory of Opalescence of Homogeneous Liquids and Liquid Mixtures Near the Critical State + year: '1993' + qc6CJjYAAAAJ:Amrzk_ktLr0C: + citations: 2 + title: "Albert Ajn\u0161tajn: njegova dela i njihov uticaj na na\u0161 svet" + year: '1957' + qc6CJjYAAAAJ:B2rIPIGFPLEC: + citations: 37 + title: Bivector fields + year: '1944' + qc6CJjYAAAAJ:B3FOqHPlNUQC: + citations: 24 + title: "Elektron und allgemeine Relativit\xE4tstheorie" + year: '1925' + qc6CJjYAAAAJ:BCdnXsLIVDwC: + citations: 26 + title: "Bemerkung zu P. Jordans Abhandlung \u201EZur Theorie der Quantenstrahlung\u201D" + year: '1925' + qc6CJjYAAAAJ:BJrLMYCRBhgC: + citations: 0 + title: "Prinzipielles zur verallgemeinerten Relativit\xE4tstheorie und Gravitationstheorie.(German)" + year: Unknown Year + qc6CJjYAAAAJ:BPS1z4jHU5cC: + citations: 63 + title: "Zu Kaluzas Theorie des Zusammenhanges von Gravitation und Elektrizit\xE4t. Erste Mitteilung" + year: '2006' + qc6CJjYAAAAJ:BUYA1_V_uYcC: + citations: 117 + title: "La th\xE9orie de la relativit\xE9 restreinte et g\xE9n\xE9rale" + year: '1990' + qc6CJjYAAAAJ:BW2nPTmhBn4C: + citations: 284 + title: "\xDCber die im elektromagnetischen Felde auf ruhende K\xF6rper ausge\xFCbten ponderomotorischen Kr\xE4fte" + year: '1908' + qc6CJjYAAAAJ:BbFSz4cl-9EC: + citations: 0 + title: VI. GRAVITATIONAL WAVES + year: '1979' + qc6CJjYAAAAJ:BjLbhSWBl98C: + citations: 204 + title: "Experimental proof of the existence of Amp\xE8re's molecular currents" + year: '1915' + qc6CJjYAAAAJ:BnRbUGEozz8C: + citations: 0 + title: 'Albert Einstein] to Willem de Sitter: Letter, before 12 Mar 1917' + year: Unknown Year + qc6CJjYAAAAJ:BqipwSGYUEgC: + citations: 188 + title: Elementary derivation of the equivalence of mass and energy + year: '1935' + qc6CJjYAAAAJ:BtfE7wd9KvMC: + citations: 28 + title: "Meine Antwort. Ueber die anti-relativit\xE4tstheoretische GmbH" + year: '1920' + qc6CJjYAAAAJ:BxcezVm2apwC: + citations: 9 + title: "Sur la th\xE9orie des quantit\xE9s lumineuses et la question de la localisation de l'\xE9nergie \xE9lectromagn\xE9tique" + year: '1910' + qc6CJjYAAAAJ:C-GuzCveMkwC: + citations: 0 + title: "La th\xE9orie de la dispersion de la lumi\xE8re et le mod\xE8le atomique de P. Drude (1904-1913)." + year: Unknown Year + qc6CJjYAAAAJ:C14xlUzwkXEC: + citations: 9 + title: The cosmic religious feeling + year: '1997' + qc6CJjYAAAAJ:C6rTQemI8T8C: + citations: 23 + title: 'Briefe zur Wellenmechanik: 2. IV. 1926-22. XII. 1950 herausgegeben im Auftrage der Osterreichischen Akademie der Wissenschaften von K. Karl Przibram,...' + year: '1963' + qc6CJjYAAAAJ:CB6W3GmKGOEC: + citations: 0 + title: Antrittsrede und Erwiderung von Max Planck am Leibniztag + year: '2006' + qc6CJjYAAAAJ:CC3C2HR4nz8C: + citations: 64 + title: "F\u0131sica e realidade" + year: '2006' + qc6CJjYAAAAJ:CCeGMaHljPEC: + citations: 58 + title: Zur affinen Feldtheorie + year: '2006' + qc6CJjYAAAAJ:CLPBug3NTQYC: + citations: 0 + title: 'Albert Einstein] to Paul Seippel: Letter, 19 Aug 1917' + year: Unknown Year + qc6CJjYAAAAJ:CLQ-NLsb8zAC: + citations: 3122 + title: Ideas and Opinions + year: '1954' + qc6CJjYAAAAJ:COU-sansr_wC: + citations: 102 + title: "Elie Cartan-Albert Einstein: lettres sur le parall\xE9lisme absolu 1929-1932" + year: '1979' + qc6CJjYAAAAJ:CQX_Vi8q7s0C: + citations: 1979 + title: Introduction Einstein's Relativity + year: '1992' + qc6CJjYAAAAJ:CRQ797xmLJIC: + citations: 0 + title: 'Albert Einstein] to Fritz Reiche: Letter, 18 Jul 1914' + year: Unknown Year + qc6CJjYAAAAJ:CRzUtm-VnGAC: + citations: 69 + title: "Der Energiesatz in der allgemeinen Relativit\xE4tstheorie" + year: '1918' + qc6CJjYAAAAJ:CXI6bF9CpJ4C: + citations: 72 + title: "Untersuchungen \xFCber die Theorie der Brownschen Bewegung/Abhandlungen \xFCber die Brownsche Bewegung und verwandte Erscheinungen" + year: '1999' + qc6CJjYAAAAJ:CY3uIpTmi-gC: + citations: 126 + title: Einstein on Cosmic Religion and Other Opinions and Aphorisms + year: '2009' + qc6CJjYAAAAJ:CmbFvBriOyMC: + citations: 197 + title: "O significado da relatividade: com a teoria relativista do campo n\xE3o sim\xE9trico" + year: '1958' + qc6CJjYAAAAJ:CmeMDzcFUg4C: + citations: 0 + title: LA GUERRE ILLEGALE CONTRE L'IRAK + year: '2004' + qc6CJjYAAAAJ:Cn5sofW4b3YC: + citations: 13 + title: "\xDCber die Untersuchung des \xC4therzustandes im magnetischen Felde" + year: '1971' + qc6CJjYAAAAJ:CoqsOaBEKcQC: + citations: 11 + title: Improvements relating to refrigerating apparatus + year: '1927' + qc6CJjYAAAAJ:CrVLTnlDqZQC: + citations: 15 + title: On the moral obligation of the scientist + year: '1945' + qc6CJjYAAAAJ:Cv-mv52rCCkC: + citations: 5237 + title: On the motion of particles suspended in a liquid at rest, assumed by the molecular-kinetic theory of heat + year: '1905' + qc6CJjYAAAAJ:Cx2ibDnldiAC: + citations: 38 + title: On the quantum mechanics of radiation + year: '1917' + qc6CJjYAAAAJ:Cy13deThEpcC: + citations: 0 + title: Wissenschaftlicher Briefwechsel mit Bohr, Einstein, Heisenberg ua. 3. 1940-1949 + year: '1993' + qc6CJjYAAAAJ:D-3shSm-n1oC: + citations: 18 + title: Science, Philosophy, and Religion + year: '1953' + qc6CJjYAAAAJ:D4n_APcuzvwC: + citations: 0 + title: "Comment on Albert von Brunn,\" On Mr. Einstein's Remark about the Irregular Fluctuations of Lunar Longitude with an Approximate Period of the Rotation of the Lunar Nodes\", 24 \u2026" + year: Unknown Year + qc6CJjYAAAAJ:D52hNgOu9GcC: + citations: 0 + title: "Albert Einstein] to Michael Pol\xE1nyi: Letter, 18 Jun 1915" + year: Unknown Year + qc6CJjYAAAAJ:D8wXzuvKacYC: + citations: 0 + title: 'Albert Einstein] to Hans Albert Einstein: Letter, 17 Oct 1918' + year: Unknown Year + qc6CJjYAAAAJ:DCYT7yIMjgYC: + citations: 9 + title: Theoretische Atomistik + year: '1915' + qc6CJjYAAAAJ:DIubQTN3OvUC: + citations: 130 + title: "Kovarianzeigenschaften der Feldgleichungen der auf die verallgemeinerte Relativit\xE4tstheorie gegr\xFCndeten Gravitationstheorie" + year: '1914' + qc6CJjYAAAAJ:DOLguN9Lh8sC: + citations: 5 + title: 'Albert Einstein] to Moritz Schlick: Letter, 21 May 1917' + year: Unknown Year + qc6CJjYAAAAJ:DPnopAH2kssC: + citations: 10 + title: Jarbuch der Radioaktivitat und Elektronik, 4, 411 (1907), reprinted in The Collected Papers of A. Einstein, vol. 2, 252 + year: '1989' + qc6CJjYAAAAJ:DQNrXyjhriIC: + citations: 2792 + title: Die feldgleichungen der gravitation + year: '1915' + qc6CJjYAAAAJ:D_sINldO8mEC: + citations: 27 + title: Essays in humanism + year: '2011' + qc6CJjYAAAAJ:DejRBzv9GVYC: + citations: 69 + title: 'Ueber den Frieden: Weltordnung oder Weltuntergang?' + year: '1975' + qc6CJjYAAAAJ:Dh4RK7yvr34C: + citations: 0 + title: 'SCIENCE ET PHILOSOPHIE: EINSTEIN ET SPINOZA M.-A. TONNELAT' + year: '1981' + qc6CJjYAAAAJ:DjjA23gMNckC: + citations: 0 + title: Discussions of Lectures in Bad Nauheim, 23-24 Sep 1920 + year: Unknown Year + qc6CJjYAAAAJ:Dq1jD5C1HUoC: + citations: 0 + title: 'Albert Einstein] to Arnold Sommerfeld: Letter, 9 Dec 1915' + year: Unknown Year + qc6CJjYAAAAJ:Dqu_ECg3lNoC: + citations: 4 + title: "Bemerkung zu meiner Arbeit:\u201EEine Beziehung zwischen dem elastischen Verhalten\u2026\u201D \uFE01" + year: '2006' + qc6CJjYAAAAJ:DrOLxFoABAwC: + citations: 3 + title: 'The Origins of the General Theory of Relativity: Being the First Lecture on the George A. Gibson Foundation in the University of Glasgow, Delivered on June 20th, 1933' + year: '1933' + qc6CJjYAAAAJ:DtORCzn_ASQC: + citations: 103 + title: Quantum mechanics and reality + year: '1948' + qc6CJjYAAAAJ:DxlTmyU89zoC: + citations: 0 + title: Kreative Methoden 239 Kindern in Deutsehland lebensweltliche Erfahrungen von politischen Er + year: Unknown Year + qc6CJjYAAAAJ:E2bRg1zSkIsC: + citations: 280 + title: A teoria da relatividade especial e geral + year: '2003' + qc6CJjYAAAAJ:E2dP09oujfMC: + citations: 0 + title: "1. Physikalische Gr\xF6\xDFen und Einheiten" + year: Unknown Year + qc6CJjYAAAAJ:E6rqZ6_0n1EC: + citations: 0 + title: La teoria de la relativitat i altres textos + year: '2000' + qc6CJjYAAAAJ:E8M3ZPqbjf0C: + citations: 0 + title: "Albert Einstein] to Michael Pol\xE1nyi: Letter, 13 Dec 1914" + year: Unknown Year + qc6CJjYAAAAJ:E9iozgzfyhkC: + citations: 0 + title: 'Albert Einstein] to Paul Ehrenfest: Letter, 8 Jul 1914' + year: Unknown Year + qc6CJjYAAAAJ:EF0m1YoOS5EC: + citations: 2 + title: Formal Relationship of the Riemannian Curvature Tensor to the Field Equations of Gravity + year: '1927' + qc6CJjYAAAAJ:EMrlLOzmm-AC: + citations: 0 + title: "Bemerkung zu meiner Arbeit``Zur allgemeinen Relativit\xE4tstheorie\".(German)" + year: Unknown Year + qc6CJjYAAAAJ:END1nS_e-6cC: + citations: 0 + title: 'Albert Einstein] to Hermann Weyl: Letter, 29 Nov 1918' + year: Unknown Year + qc6CJjYAAAAJ:EUsVPkoNztoC: + citations: 0 + title: Jewish Solidarity and Palestine + year: '1938' + qc6CJjYAAAAJ:EXDW3tg14iEC: + citations: 0 + title: 'Albert Einstein] to Romain Rolland: Letter, 22 Mar 1915' + year: Unknown Year + qc6CJjYAAAAJ:EYYDruWGBe4C: + citations: 155 + title: "The Collected Papers of Albert Einstein, Vol. 2, The Swiss Years: Writings, 1900\u20131909 (English Translation Supplement)" + year: '1989' + qc6CJjYAAAAJ:Ecsxi449JjsC: + citations: 0 + title: "Sur le probl\xE8me de la formation de la personnalit\xE9 cr\xE9atrice d'Einstein." + year: Unknown Year + qc6CJjYAAAAJ:Ei5r6KrKXVQC: + citations: 1466 + title: "Theorie der Opaleszenz von homogenen Fl\xFCssigkeiten und Fl\xFCssigkeitsgemischen in der N\xE4he des kritischen Zustandes" + year: '2006' + qc6CJjYAAAAJ:EpJ50YjRFhcC: + citations: 3 + title: Correspondance:" Pourquoi la guerre?" + year: '1989' + qc6CJjYAAAAJ:EpUiTTZsFn8C: + citations: 0 + title: 'Albert Einstein] to Joseph Petzoldt: Letter, 11 Jun 1914' + year: Unknown Year + qc6CJjYAAAAJ:Es-9c2L5hKwC: + citations: 0 + title: Matter, Fields of Information, and Incompleteness + year: '1998' + qc6CJjYAAAAJ:EsO17nB32j8C: + citations: 18 + title: Theory of the Opalescence of Homogeneous and of Mixed Liquids in the Neighborhood of the Critical Region + year: '1910' + qc6CJjYAAAAJ:EsrhoZGmrkoC: + citations: 0 + title: "Grundgedanken und Methoden der Relativit\xE4tstheorie in ihrer Entwicklung dargestellt: Berlin" + year: '1920' + qc6CJjYAAAAJ:Et1yZiPVzsMC: + citations: 0 + title: "G\xE9ometrie complexe, Tome 2: aspects contemporains dans les math\xE9matiques et la physique" + year: '2004' + qc6CJjYAAAAJ:ExNiBuTMO9IC: + citations: 0 + title: Abstracts of Three Lectures on Relativity Delivered at Princeton University... May 11-13, 1921 + year: '1921' + qc6CJjYAAAAJ:F1-V36_CjEsC: + citations: 91 + title: Generation and conversion of light with regard to a heuristic point of view + year: '1905' + qc6CJjYAAAAJ:F4gwyMVh_r0C: + citations: 0 + title: 'Einstein: Science and Religion' + year: Unknown Year + qc6CJjYAAAAJ:FKYJxdYMdFIC: + citations: 916 + title: "The Collected Papers of Albert Einstein, Volume 15 (Translation Supplement): The Berlin Years: Writings & Correspondence, June 1925\u2013May 1927" + year: '2018' + qc6CJjYAAAAJ:FKzTm0Bp8ZYC: + citations: 63 + title: Oeuvres choisies + year: '1991' + qc6CJjYAAAAJ:FP-YCU5gdjEC: + citations: 0 + title: 'Remembering Creation: Towards a Christian Ecosophy' + year: Unknown Year + qc6CJjYAAAAJ:FS78WRl2AkQC: + citations: 0 + title: "Notiz zu unserer Arbeit\" Experimenteller Nachweis der Amp\xE8reschen Molekularstr\xF6me\", 15 Nov 1915" + year: Unknown Year + qc6CJjYAAAAJ:FSHXWovK7t4C: + citations: 0 + title: 'Der Einsteinturm in Potsdam: Architektur und Astrophysik' + year: '1995' + qc6CJjYAAAAJ:FSl0EHHYj-kC: + citations: 0 + title: Impact of Science on the Development of Pacifism, before 9 Dec 1921 + year: Unknown Year + qc6CJjYAAAAJ:FTNwVkz-CAMC: + citations: 80 + title: Outline of a generalized theory of relativity and of a theory of gravitation + year: '1913' + qc6CJjYAAAAJ:FV77Gu53xKkC: + citations: 114 + title: the Theory of Gravitation + year: '1974' + qc6CJjYAAAAJ:FcH-RsB9iB0C: + citations: 0 + title: Symposium on America and the World Situation... + year: '1933' + qc6CJjYAAAAJ:Fd3FjPIBfbkC: + citations: 0 + title: Oorlog als ziekte + year: '1938' + qc6CJjYAAAAJ:Fd6TstiuZzAC: + citations: 0 + title: "Uber den gengenw\xE4rtigen Stand der Feld-Theorie: Np" + year: '1955' + qc6CJjYAAAAJ:FecvS_q01PcC: + citations: 0 + title: BERNARD ROTH 22 The Impact of the Arms Race + year: '1983' + qc6CJjYAAAAJ:FjmlLC3huY4C: + citations: 0 + title: 'Albert Einstein] to Arnold Sommerfeld: Letter, 8 Feb 1916' + year: Unknown Year + qc6CJjYAAAAJ:Fp1gVP7Oym8C: + citations: 0 + title: 'The Militarization of America: A Report' + year: '1948' + qc6CJjYAAAAJ:FtNbRaqWXr4C: + citations: 0 + title: "Une lettre in\xE9dite de A. Einstein." + year: Unknown Year + qc6CJjYAAAAJ:Fu4hY69slDoC: + citations: 0 + title: 'Albert Einstein] to Paul and Tatiana Ehrenfest: Letter, 18 Oct 1916' + year: Unknown Year + qc6CJjYAAAAJ:FwTEoIZreccC: + citations: 5 + title: "Am Sonntag k\xFCss' ich Dich m\xFCndlich: die Liebesbriefe, 1897-1903" + year: '1994' + qc6CJjYAAAAJ:Fx7lCCP36QIC: + citations: 0 + title: "Vom Relativit\xE4ts-Prinzip, 26 Apr 1914" + year: '2003' + qc6CJjYAAAAJ:FzKuKYQlbrwC: + citations: 39 + title: Systematische Untersuchung fiber kompatible Feldgleichungen, welche von einem Riemannschen Raum mit Fernparallelismus gesetzt werden k6nnen + year: '1931' + qc6CJjYAAAAJ:G36d5HCDkJYC: + citations: 212 + title: Remarks on Bertrand Russell's theory of knowledge + year: '1946' + qc6CJjYAAAAJ:GCDlZl827dEC: + citations: 2 + title: SB preuss. Akad. Wiss.(1915), 778 + year: '1916' + qc6CJjYAAAAJ:GGgVawPscysC: + citations: 5 + title: The Religiousness of Science + year: '1934' + qc6CJjYAAAAJ:GHsHDPAyICYC: + citations: 22 + title: 'HA Lorentz: His Creative Genius and His Personality' + year: '1953' + qc6CJjYAAAAJ:GJVTs2krol4C: + citations: 132 + title: "Theoretische bemerkungen \xFCber die brownsche bewegung" + year: '2010' + qc6CJjYAAAAJ:GO2DTSf4MZMC: + citations: 0 + title: Souvenir of the Einstein Meeting at the Royal Albert Hall, Tuesday, October 3, 1933 + year: '1933' + qc6CJjYAAAAJ:GO5CT2y9xrEC: + citations: 12 + title: Lettres d'amour et de science + year: '1993' + qc6CJjYAAAAJ:GOtIa6ILFcwC: + citations: 6 + title: On Boltzmann's Principle and Some Immediate Consequences Thereof Translation by Bertrand Duplantier and Emily Parks from the original German text into French and English + year: '2006' + qc6CJjYAAAAJ:GUYAmugLYisC: + citations: 14 + title: "Bemerkungen zu unserer Arbeit:\u201E\xDCber die elektromagnetischen Grundgleichungen f\xFCr bewegte K\xF6rper\u201D \uFE01" + year: '2006' + qc6CJjYAAAAJ:GZelqfngyKEC: + citations: 1 + title: Correspondence between Barrie Stavis and Albert Einstein + year: '1990' + qc6CJjYAAAAJ:GfAJFcoWUJEC: + citations: 53 + title: "\xDCber den gegenw\xE4rtigen Stand der Feld-Theorie" + year: '1929' + qc6CJjYAAAAJ:GgDznaKzj2MC: + citations: 0 + title: "El gobierno de Felipe Calder\xF3n\xBF hacia un desarrollo humano sustentable? Susana Garcia jimenez" + year: Unknown Year + qc6CJjYAAAAJ:GnPB-g6toBAC: + citations: 172 + title: Einstein on peace + year: '1968' + qc6CJjYAAAAJ:GpOSJs1ZbLkC: + citations: 0 + title: 'Zitate Aus Mein Weltbild: Sieben Radierungen Von Terry Haass' + year: '1975' + qc6CJjYAAAAJ:Gpwnp1kGG20C: + citations: 236 + title: Ernst Mach + year: '1916' + qc6CJjYAAAAJ:Grx829lh2T4C: + citations: 3019 + title: Quantum theory of monatomic ideal gases + year: '1924' + qc6CJjYAAAAJ:GsgvGxwuA5UC: + citations: 17 + title: 'Correspondance 1903-1955: Albert Einstein, Michele Besso' + year: '1979' + qc6CJjYAAAAJ:GtLg2Ama23sC: + citations: 10 + title: "L'\xE9ther et la th\xE9orie de la relativit\xE9: La g\xE9om\xE9trie et l'exp\xE9rience" + year: '1964' + qc6CJjYAAAAJ:GtszHNlY0egC: + citations: 0 + title: 'The collected papers of Albert Einstein. Vol. 8, The Berlin years: correspondence, 1914-1918, P. A, 1914-1917' + year: Unknown Year + qc6CJjYAAAAJ:GwaQhVSQhKEC: + citations: 0 + title: "Theorien verborgener Parameter, EPR-Korrelationen, Bell\u2019sche Ungleichung, GHZ-Zust ande" + year: '1999' + qc6CJjYAAAAJ:GzlcqhCAosUC: + citations: 496 + title: "QUANTEN\u2010MECHANIK UND WIRKLICHKEIT" + year: '1948' + qc6CJjYAAAAJ:H-nlc5mcmJQC: + citations: 2 + title: On Newton (1927) + year: '1979' + qc6CJjYAAAAJ:H1aCVKaixnMC: + citations: 11 + title: Science Fiction and Fantasy + year: '1980' + qc6CJjYAAAAJ:H4IpxOyCX80C: + citations: 186 + title: "L'\xE9volution des id\xE9es en physique" + year: '1963' + qc6CJjYAAAAJ:HKviVsUxM5wC: + citations: 9 + title: "Bemerkung zu Abrahams vorangehender Auseinandersetzung \u201ENochmals Relativit\xE4t und Gravitation\u201D \uFE01" + year: '2006' + qc6CJjYAAAAJ:HM9HXerLlEkC: + citations: 7 + title: Vincenzo Bellini + year: '1935' + qc6CJjYAAAAJ:HPvNdXBGwkEC: + citations: 12 + title: Electrodynamic Movement of Fluid Metals Particularly for Refrigerating Machines + year: '1928' + qc6CJjYAAAAJ:HaiYZdWvYCYC: + citations: 0 + title: Out of the Darkness/A Way Forward by Tom Parish + year: Unknown Year + qc6CJjYAAAAJ:HjGq7OYTVFUC: + citations: 5 + title: Riemann-Metrik mit Aufrechterhaltung des Begriffes der Fern-parallelismus, Preuss + year: '1928' + qc6CJjYAAAAJ:HklM7qHXWrUC: + citations: 459 + title: "Die Relativit\xE4tstheorie" + year: '1925' + qc6CJjYAAAAJ:Hl4CZ0n6gBQC: + citations: 20718 + title: Uber einen die Erzeugung und Verwandlung des Lichtes betreffenden heurischen Gesichtpunkt + year: '1905' + qc6CJjYAAAAJ:HtEfBTGE9r8C: + citations: 183 + title: "La f\xEDsica: aventura del pensamiento" + year: '1939' + qc6CJjYAAAAJ:Hx6RvaqUy9IC: + citations: 0 + title: 'Science: Conjectures and Refutations' + year: '1997' + qc6CJjYAAAAJ:HygtOXotxAUC: + citations: 184 + title: "Sur l'\xE9lectrodynamique des corps en mouvement" + year: '1925' + qc6CJjYAAAAJ:I6TX2FUo6loC: + citations: 91 + title: Theodore von Karman Anniversary Volume + year: '1941' + qc6CJjYAAAAJ:I8ubwoE7ciMC: + citations: 1 + title: Zur Abwehr + year: '1921' + qc6CJjYAAAAJ:I9gX6wnfuA8C: + citations: 328 + title: "\xC4ther und Relativit\xE4tstheorie: Rede gehalten am 5. Mai 1920 an der Reichs-Universit\xE4t zu Leiden" + year: '1920' + qc6CJjYAAAAJ:IEpB_1CIIT4C: + citations: 3908 + title: 'THE EVOLUTION OF PHYSICS: THE GROWTH OF IDEAS FROM THE EARLY CON CEPTS TO RELATIVITY AND QUANTA.' + year: '1938' + qc6CJjYAAAAJ:IHkkN1K1AlAC: + citations: 63 + title: "Beitr\xE4ge zur Quantentheorie" + year: '1914' + qc6CJjYAAAAJ:IMJZBBnUFLgC: + citations: 0 + title: 'Albert Einstein] to Werner Weisbach: Letter, 14 Oct 1916' + year: Unknown Year + qc6CJjYAAAAJ:IT1MJ6E3JesC: + citations: 60 + title: Sehallausbreitung in teilweise disseziierten Gasen. + year: '1920' + qc6CJjYAAAAJ:IWHjjKOFINEC: + citations: 717 + title: Cosmological considerations on the general theory of relativity + year: '1986' + qc6CJjYAAAAJ:IZKZNMMMWs0C: + citations: 0 + title: "Religi\xF6se Sinnstiftung durch Technik?" + year: Unknown Year + qc6CJjYAAAAJ:I__7AI8a974C: + citations: 0 + title: Relatividade Especial e Geral + year: Unknown Year + qc6CJjYAAAAJ:Ib8FQH8mdS0C: + citations: 0 + title: 'Albert Einstein] to Elsa Einstein: Letter, 30 Aug 1915' + year: Unknown Year + qc6CJjYAAAAJ:IfvCfoBprpQC: + citations: 782 + title: 'The collected papers of Albert Einstein. Vol 4, The Swiss years: writings, 1912-1914 [English translation]' + year: Unknown Year + qc6CJjYAAAAJ:IjCSPb-OGe4C: + citations: 1376 + title: The gravitational equations and the problem of motion + year: '1938' + qc6CJjYAAAAJ:IkxDsZK-5NQC: + citations: 0 + title: "Algunas consideraciones sobre el tiempo y la teor\xEDa especial de la relatividad" + year: '1979' + qc6CJjYAAAAJ:Iq19BMNozs4C: + citations: 3 + title: 'Zu Max Plancks sechzegstem Geburtstag: Ansprachen, gehalten am 26. April 1918 in der Deutschen Physikalischen Gesellschaft' + year: '1918' + qc6CJjYAAAAJ:IqrShC7OVU0C: + citations: 6379 + title: Investigations on the theory of the Brownian movement, edited with notes by R + year: '1926' + qc6CJjYAAAAJ:IvSMUa3B7yYC: + citations: 6 + title: "Berichtigung zur Abhandlung:\u201E\xDCber die elektromagnetischen Grundgleichungen f\xFCr bewegte K\xF6rper\u201D \uFE01" + year: '1908' + qc6CJjYAAAAJ:J-pR_7NvFogC: + citations: 28 + title: 'The Swiss Years: Writings, 1914-1917' + year: '1996' + qc6CJjYAAAAJ:J4wmHkHhN-kC: + citations: 2 + title: Memorial to Dr. David Eder + year: '1936' + qc6CJjYAAAAJ:JQOojiI6XY0C: + citations: 17 + title: Tables of Einstein Functions + year: '1962' + qc6CJjYAAAAJ:JQPmwQThujIC: + citations: 472 + title: "La g\xE9om\xE9trie et l'exp\xE9rience, par Albert Einstein; traduit par Maurice Solovine" + year: '1921' + qc6CJjYAAAAJ:JXi_AgyUMBAC: + citations: 101 + title: Relativistic theory of the non-symmetric field + year: '1955' + qc6CJjYAAAAJ:JZsVLox4iN8C: + citations: 2424 + title: 'Autobiographisches in: Albert Einstein: Philosopher-Scientist' + year: '1949' + qc6CJjYAAAAJ:J_g5lzvAfSwC: + citations: 125 + title: Warum Krieg? + year: '1972' + qc6CJjYAAAAJ:JjPkQosUWiAC: + citations: 0 + title: 'Science and Synthesis: An International Colloquium' + year: '1967' + qc6CJjYAAAAJ:JoHZYnTS1h4C: + citations: 2 + title: "La teor\xEDa de la relatividad especial y general al alcance de todos" + year: '1923' + qc6CJjYAAAAJ:JoZmwDi-zQgC: + citations: 29 + title: Das Raum-Feld-und Aether-Problem in der Physik + year: '1930' + qc6CJjYAAAAJ:K-tzbvM8PMoC: + citations: 0 + title: "Briefe zur Wellenmechanik: Schr\xF6dinger, Planck, Einstein, Lorentz" + year: '1963' + qc6CJjYAAAAJ:K3LRdlH-MEoC: + citations: 81 + title: Fundamental ideas and problems of the theory of relativity + year: '2009' + qc6CJjYAAAAJ:K4-iKlO5MD4C: + citations: 703 + title: A Heuristic Viewpoint Concerning the Production and Transformation of Light + year: '1929' + qc6CJjYAAAAJ:K6kyChav4UkC: + citations: 11 + title: Letter to Lincoln Barnett, quoted inThe concept of mass' by Lev Okum + year: '1948' + qc6CJjYAAAAJ:K8XpiWYAYk8C: + citations: 0 + title: "Mgr Aleksandra Ochman Tw\xF3rcze my\u015Blenie\u2013teoria i praktyka szkolna." + year: Unknown Year + qc6CJjYAAAAJ:K9zgXSuleLYC: + citations: 0 + title: 'The Myth of Consistent Skepticism: The Cautionary Case of Albert Einstein' + year: Unknown Year + qc6CJjYAAAAJ:KEHW5XCvxlQC: + citations: 6 + title: 'New Evidence of the Militarization of America: A Report' + year: '1949' + qc6CJjYAAAAJ:KFIQUvoPKFAC: + citations: 0 + title: Planck units and wave-particle duality + year: Unknown Year + qc6CJjYAAAAJ:KIRwYnRZzWQC: + citations: 6 + title: Why socialism? + year: '1951' + qc6CJjYAAAAJ:KOc9rAu6-V4C: + citations: 376 + title: letter to Max Born + year: '1926' + qc6CJjYAAAAJ:KQ7zX_ltr48C: + citations: 0 + title: 'Albert Einstein] to Romain Rolland: Letter, 22 Aug 1917' + year: Unknown Year + qc6CJjYAAAAJ:KUekCDWCRvQC: + citations: 0 + title: Physiology and Pathophysiology of the Heart + year: '1990' + qc6CJjYAAAAJ:KVXOKlNwS8oC: + citations: 61 + title: 'Briefwechsel [zwischen] Albert Einstein und Arnold Sommerfeld: sechzig Briefe aus dem goldenen Zeitalter der modernen Physik' + year: '1968' + qc6CJjYAAAAJ:Kaaf24wrr50C: + citations: 0 + title: "R\xF4le de l'\xE9thique dans l'oeuvre d'Einstein (\xE0 l'exemple de la m\xE9canique quantique)." + year: Unknown Year + qc6CJjYAAAAJ:KbeHZ-DlqmcC: + citations: 0 + title: Deposition in Divorce Proceedings, 23 Dec 1918 + year: Unknown Year + qc6CJjYAAAAJ:KjnAay3C9J8C: + citations: 5 + title: "Die spezielle Relativit\xE4sthorie" + year: '1912' + qc6CJjYAAAAJ:KlAtU1dfN6UC: + citations: 446 + title: On the Influence of Gravitation on the Propagation of Light + year: '1911' + qc6CJjYAAAAJ:KqnX2w3egDsC: + citations: 96 + title: "Vier Vorlesungen \xFCber Relativit\xE4tstheorie gehalten im Mai 1921 an der Universit\xE4t Princeton" + year: '1922' + qc6CJjYAAAAJ:Kr3pDLWb32UC: + citations: 2 + title: "Bemerkung zu der Notiz von W. Anderson\xBB Eine neue Erkl\xE4rung des kontinuierlichen Koronaspektrums \xAB" + year: '1923' + qc6CJjYAAAAJ:KxNY-X0OflYC: + citations: 9 + title: "La th\xE9orie du rayonnement et les quanta" + year: '1911' + qc6CJjYAAAAJ:L2Pn6qttGKUC: + citations: 0 + title: 'Albert Einstein] to Mileva Einstein-Maric: Letter, after 17 Mar 1918' + year: Unknown Year + qc6CJjYAAAAJ:L7JqRCIhofwC: + citations: 6624 + title: Sitzungsberichte der Preussischen Akademie der Wissenschaften zu Berlin + year: '1915' + qc6CJjYAAAAJ:L7vk9XBBNxgC: + citations: 11 + title: Emil Warburg als Forscher + year: '1922' + qc6CJjYAAAAJ:LA-8tw-JpD0C: + citations: 0 + title: "Probleme kann man niemals mit der gleichen Denkweise l\xF6sen durch die sie entstanden sind." + year: Unknown Year + qc6CJjYAAAAJ:LAaCg2gyLagC: + citations: 276 + title: Briefwechsel 1916-1955 + year: '1972' + qc6CJjYAAAAJ:LGA7_l5-FVwC: + citations: 125 + title: Preussiche Akademie der Wissenchaften Berlin + year: '1927' + qc6CJjYAAAAJ:LIyjJRbbAUMC: + citations: 0 + title: "Bei der Redaktion eingegangene B\xFCcher und Schriften." + year: '1916' + qc6CJjYAAAAJ:LNjCCq68lIgC: + citations: 8 + title: 'Relativity, Thermodynamics and Cosmology.(Scientific Books: Relativity, Thermodynamics and Cosmology)' + year: '1934' + qc6CJjYAAAAJ:LPZeul_q3PIC: + citations: 35 + title: "Beweis der Nichtexistenz eines \xFCberall regul\xE4ren zentrische symmetrischen Feldes nach der Feld-Theorie von Th. Kaluza" + year: '1923' + qc6CJjYAAAAJ:LSkeIYDkhQYC: + citations: 0 + title: Letter to a friend of peace + year: '1984' + qc6CJjYAAAAJ:LTdYzzxxQecC: + citations: 0 + title: 'Newton: the man' + year: '1972' + qc6CJjYAAAAJ:LWUVeqegjeYC: + citations: 0 + title: "Albert Einstein] to Constantin Carath\xE9odory: Letter, 10 Dec 1916" + year: Unknown Year + qc6CJjYAAAAJ:LWqeokA2EBkC: + citations: 79 + title: "\xDCber die G\xFCltigkeitsgrenze des Satzes vom thermodynamischen Gleichgewicht und \xFCber die M\xF6glichkeit einer neuen Bestimmung der Elementarquanta" + year: '1907' + qc6CJjYAAAAJ:LYDvBi7O6RsC: + citations: 0 + title: 'Albert Einstein] to Robert Heller: Letter, 20 Jul 1914' + year: Unknown Year + qc6CJjYAAAAJ:LYW2S8xaXYEC: + citations: 0 + title: A minor sidelight on a great man + year: '1956' + qc6CJjYAAAAJ:L_at8tGC9oEC: + citations: 52 + title: The Meaning of + year: '1969' + qc6CJjYAAAAJ:Lbh3VFZM3akC: + citations: 0 + title: 'Albert Einstein] to Hedwig Born: Letter, 8 Feb 1918' + year: Unknown Year + qc6CJjYAAAAJ:LkGwnXOMwfcC: + citations: 2993 + title: The foundation of the general theory of relativity + year: '1916' + qc6CJjYAAAAJ:LkrQC8aPkXYC: + citations: 5304 + title: 'Relativity: The Special and the General Theory: a Popular Exposition by Albert Einstein; Transl. by Robert W. Lawson' + year: '1961' + qc6CJjYAAAAJ:Lmuc1furtc4C: + citations: 0 + title: "Albert Einstein] to Rudolf F\xF6rster: Letter, 16 Nov 1917" + year: Unknown Year + qc6CJjYAAAAJ:LnJLeQ70pnUC: + citations: 0 + title: 'Albert Einstein] to Walter Schottky: Letter, 26 Sep 1917' + year: Unknown Year + qc6CJjYAAAAJ:LoiWQfKZB3kC: + citations: 14 + title: 'Albert Einstein] to Michele Besso: Letter, 3 Jan 1916' + year: Unknown Year + qc6CJjYAAAAJ:LpWf3qrnWeoC: + citations: 0 + title: 'Albert Einstein] to Walter Schottky: Letter, 23 Jun 1918' + year: Unknown Year + qc6CJjYAAAAJ:Lr5Uwm59ZTwC: + citations: 0 + title: VORLESUNGEN UBER SPEZIELLE RELATIVITATSTHEORIE + year: '1999' + qc6CJjYAAAAJ:LsccmWB6Ip4C: + citations: 0 + title: The Application of Catastrophe Theory + year: Unknown Year + qc6CJjYAAAAJ:LwieBGrN4GEC: + citations: 22 + title: Relativity, quanta, and cosmology in the development of the scientific thought of Albert Einstein + year: '1981' + qc6CJjYAAAAJ:LzOrNEA7mwcC: + citations: 0 + title: 'The Impact of modern scientific ideas on society: in commemoration of Einstein' + year: '1981' + qc6CJjYAAAAJ:M0j1y4EgrScC: + citations: 101 + title: "Thermodynamische Begr\xFCndung des photochemischen \xC4quivalentgesetzes" + year: '1912' + qc6CJjYAAAAJ:M0jDNLgoRFEC: + citations: 0 + title: 'Albert Einstein] to Paul Ehrenfest: Letter, 25 Aug 1916' + year: Unknown Year + qc6CJjYAAAAJ:M3NEmzRMIkIC: + citations: 84 + title: Two-body problem in general relativity theory + year: '1936' + qc6CJjYAAAAJ:M3ejUd6NZC8C: + citations: 423 + title: "Prinzipielles zur allgemeinen Relativit\xE4tstheorie" + year: '1918' + qc6CJjYAAAAJ:M8meJADSprsC: + citations: 197 + title: El significado de la relatividad + year: '1971' + qc6CJjYAAAAJ:MDX3w3dAD3YC: + citations: 909 + title: Zum quantensatz von Sommerfeld und Epstein + year: '1917' + qc6CJjYAAAAJ:MGPUR4WVBMEC: + citations: 82 + title: "Notiz zu der Arbeit von A. Friedmann \u201E\xDCber die Kr\xFCmmung des Raumes \u201C" + year: '1923' + qc6CJjYAAAAJ:ML0RJ9NH7IQC: + citations: 322 + title: New possibility for a unified field theory of gravitation and electricity + year: '1928' + qc6CJjYAAAAJ:MNNNGtAgD4EC: + citations: 17 + title: "Bemerkung zu dem Gesetz von E\xF6tv\xF6s" + year: '1911' + qc6CJjYAAAAJ:MTuJV9umhWMC: + citations: 0 + title: "Eine einfache Anwendung des Newtonschen Gravitationsgesetzes auf die kugelf\xF6rmigen Sternhaufen, ca. 18 M\xE4r 1921" + year: Unknown Year + qc6CJjYAAAAJ:MWSB05WFU5AC: + citations: 0 + title: "La corr\xE9lation de l'empirique et du rationnel dans l'oeuvre scientifique d'Einstein." + year: Unknown Year + qc6CJjYAAAAJ:MXK_kJrjxJIC: + citations: 638 + title: On a stationary system with spherical symmetry consisting of many gravitating masses + year: '1939' + qc6CJjYAAAAJ:MqTxh1vmwXEC: + citations: 2 + title: Physikalische Gesellschaft zu Berlin. Berlin, 12. Juni 1931 + year: '2006' + qc6CJjYAAAAJ:MvIMIWP2nqIC: + citations: 786 + title: 'The Collected Papers of Albert Einstein, Vol. 4: The Swiss Years: Writings, 1912-1914' + year: '1996' + qc6CJjYAAAAJ:Mx5hWS9ctUkC: + citations: 0 + title: Einstein's Collected Writings + year: '1960' + qc6CJjYAAAAJ:N6_Y7JlWxwsC: + citations: 41 + title: Physikalische Grundlagen einer Gravitationstheorie + year: '1914' + qc6CJjYAAAAJ:NAGhd4NKCV8C: + citations: 141 + title: "K\xF6niglich Preu\xDFische Akademie der Wissenschaften Berlin" + year: '1916' + qc6CJjYAAAAJ:NGoJ35N4lvkC: + citations: 40 + title: "Bemerkungen zu P. Harzers Abhandlung \xAB\xDCber die Mitf\xFChrung des Lichtes in Glas und die Aberration\xBB(AN 4748)" + year: '1914' + qc6CJjYAAAAJ:NJ774b8OgUMC: + citations: 22 + title: The advent of the quantum theory + year: '1951' + qc6CJjYAAAAJ:NM66qo_NnlUC: + citations: 925 + title: 'The Collected Papers of Albert Einstein: English Translation' + year: '1989' + qc6CJjYAAAAJ:NMxIlDl6LWMC: + citations: 9 + title: 'The Collected Papers of Albert Einstein, Volume 6: The Berlin Years: Writings, 1914-1917' + year: '1997' + qc6CJjYAAAAJ:NNXJ2mIwlScC: + citations: 6 + title: Albert Einstein, Michele Besso, correspondence, 1903-1955 + year: '1972' + qc6CJjYAAAAJ:NRnkAyzcrGMC: + citations: 0 + title: Gravitation of Spinning Matter as a Gauge Theory + year: Unknown Year + qc6CJjYAAAAJ:NU53l0vQ3PcC: + citations: 0 + title: "Ein einfaches Experiment zum Nachweis der Amp\xE8reschen Molekularstr\xF6me, 25 Feb 1916" + year: '1916' + qc6CJjYAAAAJ:NWFKKQzSIN4C: + citations: 4 + title: Besprechungen + year: '1914' + qc6CJjYAAAAJ:NXb4pA-qfm4C: + citations: 4 + title: 'Builders of the Universe: From the Bible to the Theory of Relativity' + year: '1932' + qc6CJjYAAAAJ:NYu48kWxaQAC: + citations: 14 + title: Albert Einstein] to Michele Besso:[A first] letter, 21 Jul 1916 + year: Unknown Year + qc6CJjYAAAAJ:NZNkWSpQBv0C: + citations: 72 + title: Zum Ehrenfestschen Paradoxon + year: '1910' + qc6CJjYAAAAJ:NnTm98qLMbgC: + citations: 573 + title: Mein weltbild + year: '1934' + qc6CJjYAAAAJ:Nnq8S6OXqDYC: + citations: 156 + title: "Allgemeine relativit\xE4tstheorie und bewegungsgesetz" + year: '1927' + qc6CJjYAAAAJ:Np1obAXpBq8C: + citations: 0 + title: 'Albert Einstein] to Hermann Weyl: Letter, 15 Apr 1918' + year: Unknown Year + qc6CJjYAAAAJ:Ns2bVKt8YxIC: + citations: 504 + title: Sidelights on Relativity,... I. Ether and Relativity. II. Geometry and Experience + year: '1922' + qc6CJjYAAAAJ:Nufq_to8ts0C: + citations: 194 + title: "Das Prinzip von der Erhaltung der Schwerpunktsbewegung und die Tr\xE4gheit der Energie" + year: '1906' + qc6CJjYAAAAJ:Nw5Pwe77XXAC: + citations: 0 + title: 'Albert Einstein] to Wilhelm Wien: Letter, 17 Oct 1916' + year: Unknown Year + qc6CJjYAAAAJ:Nw_I7GeUguwC: + citations: 166 + title: "Zur allgemeinen molekularen Theorie der W\xE4rme" + year: '1904' + qc6CJjYAAAAJ:NzUpm4bhSXQC: + citations: 2 + title: "Die Quantentheorie der spezifischen W\xE4rme" + year: '1967' + qc6CJjYAAAAJ:O0MA3yP7Y3UC: + citations: 236 + title: 'The Collected Papers of Albert Einstein, Volume 8: The Berlin Years: Correspondence, 1914-1918.' + year: '1998' + qc6CJjYAAAAJ:O3NaXMp0MMsC: + citations: 139 + title: How I created the theory of relativity + year: '1982' + qc6CJjYAAAAJ:OBae9N4Z9bMC: + citations: 22 + title: "L\u2019\xE9volution des id\xE9es en physique" + year: '1978' + qc6CJjYAAAAJ:OC7j4ufeY2cC: + citations: 0 + title: 'Albert Einstein] to Friedrich Adler: Letter, 20 Oct 1918' + year: Unknown Year + qc6CJjYAAAAJ:ODN9lDrI8hIC: + citations: 16 + title: Appendix II. Generalization of gravitation theory + year: '1953' + qc6CJjYAAAAJ:OLNndOjO69MC: + citations: 0 + title: 'Friedrich Wilhelm Foerster und Albert Einstein: Briefwechsel von 1935 bis 1954' + year: '2001' + qc6CJjYAAAAJ:OPs5gEIPXMUC: + citations: 7843 + title: On gravitational waves Sitzungsber. preuss + year: '1918' + qc6CJjYAAAAJ:OTTXONDVkokC: + citations: 3 + title: On the relativity problem + year: '2007' + qc6CJjYAAAAJ:OVe_t5h5bhEC: + citations: 267 + title: "Mi visi\xF3n del mundo" + year: '1985' + qc6CJjYAAAAJ:Oi-j_DTgP3cC: + citations: 3 + title: 'Einstein und Smoluchowski: Zur Geschichte der Brownschen Bewegung und der Opaleszenz' + year: '1969' + qc6CJjYAAAAJ:OiA2aNrLN7MC: + citations: 0 + title: The Rise and Fall of the Great Ether + year: '1993' + qc6CJjYAAAAJ:OlbiQ0ttILcC: + citations: 189 + title: "Las teor\xEDas de la relatividad" + year: '1922' + qc6CJjYAAAAJ:Ow2R9nchCv8C: + citations: 0 + title: "Albert Einstein] to Michael Pol\xE1nyi: Letter, 10 Feb 1915" + year: Unknown Year + qc6CJjYAAAAJ:OwUwxyS7Fk8C: + citations: 0 + title: On German Literature for Viola Da Gamba in the 16th and 17th Centuries + year: '1977' + qc6CJjYAAAAJ:P1qO8dLd1z8C: + citations: 199 + title: The Photoelectric Effect + year: '1905' + qc6CJjYAAAAJ:P9oYG7HA76QC: + citations: 14 + title: The military mentality + year: '1947' + qc6CJjYAAAAJ:PLWDSxI5WzYC: + citations: 41 + title: Deutsche Physikalische Gesellschaft + year: '1915' + qc6CJjYAAAAJ:PPAp3RzCAaIC: + citations: 61 + title: 'Briefwechsel: Albert Einstein, Arnold Sommerfeld: Sechzig Briefe Aus Dem Goldenen Zeitalter Der Modernen Physik' + year: '1968' + qc6CJjYAAAAJ:PQm_lTwdG-sC: + citations: 126 + title: "Einleitende Bemerkungen \xFCber Grundbegriffe (with French transl. Remarques pr\xE9liminaires sur les principes fondamentaux, by MA Tonnelat)" + year: '1953' + qc6CJjYAAAAJ:PVjk1bu6vJQC: + citations: 0 + title: "Einstein und sein Weltbild: Aufs\xE4tze und Vortr\xE4ge" + year: '1988' + qc6CJjYAAAAJ:PWMd_Z0sy-4C: + citations: 59 + title: "Th\xE9orie unitaire du champ physique" + year: '1930' + qc6CJjYAAAAJ:PbrqR9PZhrEC: + citations: 6 + title: "On Boltzmann\u2019s Principle and Some Immediate Consequences Thereof" + year: '2006' + qc6CJjYAAAAJ:PicmXY_cuE0C: + citations: 2 + title: ADDRESS BEFORE STUDENT BODY CALIFORNIA INSTITUTE OF TECHNOLOGY + year: '1938' + qc6CJjYAAAAJ:PoEJn1poz0QC: + citations: 269 + title: 'Wissenschaftlicher Briefwechsel Mit Bohr, Einstein, Heisenberg, Ua: Scientific Correspondence with Bohr, Einstein, Heisenberg, Ao Volume 1: 1919-1929. 1919-1929' + year: '1979' + qc6CJjYAAAAJ:Q7hiZQKJ-pAC: + citations: 249 + title: 'Cosmic religion: with other opinions and aphorisms' + year: '1931' + qc6CJjYAAAAJ:Q9ss7R9eeXsC: + citations: 11 + title: "Sulla teoria speciale e generale della relativit\xE0" + year: '1921' + qc6CJjYAAAAJ:QAsQKsfVUN4C: + citations: 0 + title: 'Albert Einstein] to Hans Albert Einstein: Letter, 24 Dec 1917' + year: Unknown Year + qc6CJjYAAAAJ:QBXC_7Xd1GUC: + citations: 13 + title: 'The new physics: the route into the atomic age' + year: '1979' + qc6CJjYAAAAJ:QDEWnZBrHwAC: + citations: 0 + title: 'Albert Einstein] to Arnold Sommerfeld: Letter, after 1 Feb 1918' + year: Unknown Year + qc6CJjYAAAAJ:QI7uKX5mnFEC: + citations: 4 + title: "Cien a\xF1os de relatividad: Los art\xEDculos de Albert Einstein de 1905 y 1906" + year: '2004' + qc6CJjYAAAAJ:QIV2ME_5wuYC: + citations: 727 + title: Does the inertia of a body depend upon its energy-content? + year: '1905' + qc6CJjYAAAAJ:QKtdBID3u5MC: + citations: 39 + title: Einstein und das Universum + year: '1958' + qc6CJjYAAAAJ:QSG1pgF8pGAC: + citations: 0 + title: 'The Theory of Relativity in Contemporary Science: Papers Read at the Celebration of the Seventieth Birthday of Albert Einstein in Princeton, March 19, 1949' + year: '1949' + qc6CJjYAAAAJ:QUKcMBy53xEC: + citations: 0 + title: "L'actualit\xE9 constante de la th\xE9orie de gravitation d'Einstein." + year: Unknown Year + qc6CJjYAAAAJ:QXXbHxWZe5oC: + citations: 4 + title: My Attitude to Quantum Theory + year: '1950' + qc6CJjYAAAAJ:QYdC8u9Cj1oC: + citations: 12 + title: Special and General relativity + year: '1920' + qc6CJjYAAAAJ:Q_E8KsG3g9MC: + citations: 14 + title: Correspondencia (1916-1955) + year: '1999' + qc6CJjYAAAAJ:QaLwMs-zPFMC: + citations: 0 + title: "Notiz zu E. Schr\xF6dingers Arbeit\" Die Energiekomponenten des Gravitationsfeldes\", 5 Feb 1918" + year: Unknown Year + qc6CJjYAAAAJ:QbuKDewGlxwC: + citations: 0 + title: "La Th\xE9orie d'Einstein, ou La piperie relativiste" + year: '1928' + qc6CJjYAAAAJ:QhmGFXoqNHAC: + citations: 0 + title: 'Albert Einstein] to Hermann Weyl: Letter, 27 Sep 1918' + year: Unknown Year + qc6CJjYAAAAJ:QjNCP7ux8QYC: + citations: 5 + title: Mein Weltbild, Herausgegeben von Carl Seelig, Neue, vom Verfasser durchgesehene und wesentlich erweiterte Auflage + year: Unknown Year + qc6CJjYAAAAJ:Qo9Q-PfIzZ0C: + citations: 19 + title: "Observa\xE7\xF5es sobre a situa\xE7\xE3o atual da teoria da luz" + year: '1926' + qc6CJjYAAAAJ:QoN_6baHBqgC: + citations: 3 + title: Geometria ed esperienza1 + year: '1957' + qc6CJjYAAAAJ:Qovp55VTycgC: + citations: 0 + title: F. General relativity and its general covariance + year: Unknown Year + qc6CJjYAAAAJ:QppYajJO_VYC: + citations: 17 + title: "Albert Einstein und Johannes Stark: Briefwechsel und Verh\xE4ltnis der beiden Nobelpreistr\xE4ger" + year: '1966' + qc6CJjYAAAAJ:Qqt8gOYqc0UC: + citations: 0 + title: 'Albert Einstein] to Paul Ehrenfest: Letter, 14 Feb 1917' + year: Unknown Year + qc6CJjYAAAAJ:QuPaituDtm8C: + citations: 2 + title: CULTURE MUST BE ONE OF THE FOUNDATIONS FOR WORLD UNDERSTANDING'. + year: '1996' + qc6CJjYAAAAJ:Qwfv3SoyJx4C: + citations: 2 + title: "Physikalische Gesellschaft zu Berlin und Deutsche Gesellschaft f\xFCr technische Physik. Berlin, 17. Juli 1931" + year: '2006' + qc6CJjYAAAAJ:R3hNpaxXUhUC: + citations: 293 + title: "Lettres \xE0 Maurice Solovine" + year: '1956' + qc6CJjYAAAAJ:R6aXIXmdpM0C: + citations: 3 + title: Pourquoi le socialisme? + year: '1993' + qc6CJjYAAAAJ:RF4BjkDOTHkC: + citations: 974 + title: "Letters on Wave Mechanics: Correspondence with HA Lorentz, Max Planck, and Erwin Schr\xF6dinger" + year: '2011' + qc6CJjYAAAAJ:RJNGbXJAtMsC: + citations: 17 + title: 'The essential Einstein: his greatest works' + year: '2008' + qc6CJjYAAAAJ:RPps9qLA3-kC: + citations: 104 + title: Letter to Jacques Hadamard + year: '1952' + qc6CJjYAAAAJ:Rc-B-9qnGaUC: + citations: 0 + title: Bemerkungen iiber den Wandel der Problemstcllungen in der theoretischen Physik + year: Unknown Year + qc6CJjYAAAAJ:RfUwGJFMQ-0C: + citations: 4133 + title: Zur quantentheorie der strahlung + year: '1917' + qc6CJjYAAAAJ:RgMnzfD6kpIC: + citations: 14 + title: Only then shall we find courage + year: '1946' + qc6CJjYAAAAJ:RmQ8dt0hH3oC: + citations: 0 + title: "Buchbesprechungen \xFCber: Grundz\xFCge der Relativit\xE4tstheorie" + year: '1957' + qc6CJjYAAAAJ:RpHLKABnwqoC: + citations: 0 + title: "Berichtigung zur Abhandlung:\" \xDCber die elektromagnetischen Grundgleichungen f\xFCr bewegte K\xF6rper\", 24 Aug 1908" + year: Unknown Year + qc6CJjYAAAAJ:S0RksyIsHSIC: + citations: 0 + title: "Briefe zur Wellenmechanik: Mit 4 portr\xE4ts" + year: '1963' + qc6CJjYAAAAJ:S2WlVNSe3u4C: + citations: 129 + title: "Kinetische Theorie des W\xE4rmegleichgewichtes und des zweiten Hauptsatzes der Thermodynamik" + year: '1902' + qc6CJjYAAAAJ:S9V7H-Nz35UC: + citations: 7501 + title: On a Heuristic Point of View Toward the Emission and Transformation of Light + year: '1905' + qc6CJjYAAAAJ:SFOYbPikdlgC: + citations: 22 + title: Spaltung der natuerlichsten Feldgleichungen fuer Semi-Vektoren in Spinor-Gleichungen vom Dirac'schen Typus + year: '1933' + qc6CJjYAAAAJ:SLTdnKVCdHAC: + citations: 0 + title: 'Albert Einstein] to Wilhelm Wien: Letter, 18 Mar 1916' + year: Unknown Year + qc6CJjYAAAAJ:SPgoriM2DtkC: + citations: 10 + title: 'Albert Einstein] to Max Born: Letter, after 29 Jun 1918' + year: Unknown Year + qc6CJjYAAAAJ:S_Qw7xXuMuIC: + citations: 844 + title: 'The collected papers of Albert Einstein: The Berlin years: correspondence, January-December 1921' + year: '2009' + qc6CJjYAAAAJ:S_fw-_riRmcC: + citations: 10 + title: Albert einstein to max born + year: '2005' + qc6CJjYAAAAJ:Se3iqnhoufwC: + citations: 985 + title: The world as I see it + year: '2007' + qc6CJjYAAAAJ:SenaEjHFqFYC: + citations: 7 + title: The Structure of Scientific Thought + year: '1960' + qc6CJjYAAAAJ:Sg-YnEhjH50C: + citations: 0 + title: ALBERT EINSTEIN, UN HOMBRE UNIVERSAL + year: Unknown Year + qc6CJjYAAAAJ:ShjGdcaqzI0C: + citations: 190 + title: "\xDCber die elektromagnetischen Grundgleichungen f\xFCr bewegte K\xF6rper" + year: '1908' + qc6CJjYAAAAJ:Sipo1f_CKiIC: + citations: 0 + title: "Albert Einstein] to Walter D\xE4llenbach: Letter, after 15 Jun 1918" + year: Unknown Year + qc6CJjYAAAAJ:SpbQ_efOBbkC: + citations: 0 + title: 'Albert Einstein] to Wander and Geertruida de Haas: Letter, 3 Oct 1916' + year: Unknown Year + qc6CJjYAAAAJ:SrKkpNFED5gC: + citations: 418 + title: "Zum gegenw\xE4rtigen Stand des Strahlungsproblems" + year: '1909' + qc6CJjYAAAAJ:SrsqWtBqNIQC: + citations: 0 + title: 'Albert Einstein] to Hans Albert Einstein: Letter, 25 Jan 1915' + year: Unknown Year + qc6CJjYAAAAJ:SxVRRePJDnEC: + citations: 0 + title: 'Albert Einstein] to Wladyslaw Natanson: Letter, 24 Aug 1915' + year: Unknown Year + qc6CJjYAAAAJ:SzsLJvG5eXAC: + citations: 2040 + title: Autobiographical Notes, ed + year: '1979' + qc6CJjYAAAAJ:T64LSalLz9oC: + citations: 0 + title: 'Albert Einstein] to Willem de Sitter: Letter, 23 Jan 1917' + year: Unknown Year + qc6CJjYAAAAJ:T8_be82Iz5gC: + citations: 158 + title: Zur Theorie des statischen Gravitationsfeldes + year: '2006' + qc6CJjYAAAAJ:TA1nTKmGtTgC: + citations: 0 + title: 'Albert Einstein] to Paul Ehrenfest: Letter, 19 Aug 1914' + year: Unknown Year + qc6CJjYAAAAJ:TFP_iSt0sucC: + citations: 79 + title: Letters on wave mechanics + year: '1967' + qc6CJjYAAAAJ:TGemctCAZTQC: + citations: 38 + title: The new field theory + year: '1929' + qc6CJjYAAAAJ:TIZ-Mc8IlK0C: + citations: 1102 + title: On the method of theoretical physics + year: '1934' + qc6CJjYAAAAJ:TKTY8N1AUUAC: + citations: 0 + title: 'Albert Einstein] to Wilhelm Wien: Letter, 28 Feb 1916' + year: Unknown Year + qc6CJjYAAAAJ:TNEldfgDb5MC: + citations: 786 + title: 'The Collected Papers of Albert Einstein, Vol. 4: The Swiss Years: Writings, 1912-1914' + year: '1996' + qc6CJjYAAAAJ:TXgqPU86QykC: + citations: 0 + title: Review of Publications-Out of My Later Years + year: '1950' + qc6CJjYAAAAJ:TeJ9juy8vcMC: + citations: 39 + title: On the Present State of the Problem of Gravitation + year: '2007' + qc6CJjYAAAAJ:TewouNez5YAC: + citations: 2 + title: "Filosofia e relativit\xE0" + year: '1965' + qc6CJjYAAAAJ:Tfl4UtY-dJUC: + citations: 66 + title: "Hamilton\u2019s principle and the general theory of relativity" + year: '1916' + qc6CJjYAAAAJ:TiIbgCYny7sC: + citations: 9035 + title: "Zur Elektrodynamik bewegter K\xF6rper" + year: Unknown Year + qc6CJjYAAAAJ:TmnWbB_axlEC: + citations: 84 + title: Untersuchungen uber die Theorie der Brownschen Bewegung + year: '1922' + qc6CJjYAAAAJ:ToZsFq5dof0C: + citations: 3 + title: "Les fondements de la th\xE9orie de la relativit\xE9 g\xE9n\xE9rale. Th\xE9orie unitaire de la gravitation et de l'electricit\xE9. Sur la structure cosmologique de l'espace." + year: '1934' + qc6CJjYAAAAJ:U5uP8zs9lfgC: + citations: 11 + title: Bemerkung zu E. Gehrckes Notiz + year: '1918' + qc6CJjYAAAAJ:UC7Jl7-kV0oC: + citations: 160 + title: Scientific papers presented to Max Born + year: '1953' + qc6CJjYAAAAJ:UEa65astgjsC: + citations: 0 + title: REPLY TO REICHENBACH 75 + year: '1953' + qc6CJjYAAAAJ:UFuRdyijzaAC: + citations: 0 + title: 'Albert Einstein] to Otto Naumann: Letter, 7 Dec 1915' + year: Unknown Year + qc6CJjYAAAAJ:ULOm3_A8WrAC: + citations: 322 + title: On the motion of particles in general relativity theory + year: '1949' + qc6CJjYAAAAJ:UO8fSLLLPykC: + citations: 4 + title: 'Albert Einstein] to Hedwig and Max Born: Letter, 2 Aug 1918' + year: Unknown Year + qc6CJjYAAAAJ:UOgPUojWnykC: + citations: 16 + title: Science and God + year: '1930' + qc6CJjYAAAAJ:UPMPWMAU16oC: + citations: 0 + title: Lecture Notes for Courses on Special Relativity at the University of Berlin and the University of Zurich, Winter Semester 1918-1919, 11 October 1918-second half of February 1919 + year: Unknown Year + qc6CJjYAAAAJ:USX2HHcnDqcC: + citations: 0 + title: "Bemerkung zu Herrn Schr\xF6dingers Notiz\" \xDCber ein L\xF6sungssystem der allgemein kovarianten Gravitationsgleichungen\", 3 M\xE4r 1918" + year: Unknown Year + qc6CJjYAAAAJ:UY3hNwcQ290C: + citations: 27 + title: "La teor\xEDa de la relatividad: Sus or\xEDgenes e impacto sobre el pensamiento moderno" + year: '1983' + qc6CJjYAAAAJ:UbXTy9l1WKIC: + citations: 0 + title: The Effect of Autonomous Algorithms on Networking + year: Unknown Year + qc6CJjYAAAAJ:UeHWp8X0CEIC: + citations: 66 + title: "Sobre la electrodin\xE1mica de los cuerpos en movimiento" + year: '2005' + qc6CJjYAAAAJ:UebtZRa9Y70C: + citations: 975 + title: "\xDCber die spezielle und die allgemeine Relativit\xE4tstheorie" + year: '2008' + qc6CJjYAAAAJ:UlRcoTO8nVoC: + citations: 0 + title: On a Jewish Palestine. First Version, before 27 Jun 1921 + year: Unknown Year + qc6CJjYAAAAJ:Ul_CLA4dPeMC: + citations: 212 + title: 'Religion and Science: Irreconcilable?' + year: '1948' + qc6CJjYAAAAJ:UnhBtiQKoKQC: + citations: 27 + title: 'The Swiss Years: Writing 1900-1909:...' + year: '1989' + qc6CJjYAAAAJ:UoSa6IK8DwsC: + citations: 14 + title: from The Einstein-Freud Correspondence (1931-1932) + year: '1960' + qc6CJjYAAAAJ:UuaQgmrAG1sC: + citations: 0 + title: 'Albert Einstein] to Michele Besso: Letter, 31 Oct 1916' + year: Unknown Year + qc6CJjYAAAAJ:Uwzdpet-joYC: + citations: 0 + title: 'Albert Einstein] to Arnold Sommerfeld: Letter, 28 Nov 1915' + year: Unknown Year + qc6CJjYAAAAJ:V0QqM0Py3VsC: + citations: 0 + title: Die Zuwanderung aus dem Osten Berliner Tageblatt, 30 Dez 1919 + year: Unknown Year + qc6CJjYAAAAJ:V8JMcbNWlSUC: + citations: 0 + title: Relating to relativity + year: '1940' + qc6CJjYAAAAJ:VBbLNo9YSJgC: + citations: 0 + title: 'Albert Einstein] to Wilhelm Wien: Letter, 15 Jun 1914' + year: Unknown Year + qc6CJjYAAAAJ:VGxY11nYJJYC: + citations: 0 + title: "Gen\xE8se de la conception de la gravitation g\xE9om\xE9trique tensorielle (1912-1913)." + year: Unknown Year + qc6CJjYAAAAJ:VJOaslTFpLQC: + citations: 0 + title: 'Albert Einstein] to Arnold Sommerfeld: Letter, 1 Jun 1918' + year: Unknown Year + qc6CJjYAAAAJ:VLnqNzywnoUC: + citations: 450 + title: "Das relativit\xE4tsprinzip: Eine sammlung von abhandlungen" + year: '1915' + qc6CJjYAAAAJ:VOx2b1Wkg3QC: + citations: 45 + title: "O princ\xEDpio da relatividade" + year: '1983' + qc6CJjYAAAAJ:VTkKiNFP83YC: + citations: 4 + title: "Relativit\xE0, Boringhieri" + year: '1960' + qc6CJjYAAAAJ:VXkaQG_c9EQC: + citations: 1 + title: "La educaci\xF3n y la Atenci\xF3n Primaria de la salud en la Complejidad Social" + year: Unknown Year + qc6CJjYAAAAJ:VaBbNeojGYwC: + citations: 0 + title: 'Einstein''s New Theory: Text of His Treatise' + year: '1929' + qc6CJjYAAAAJ:VdWZULf8Gq0C: + citations: 0 + title: Determinism in Classical and Quantal Physics by JM Jauch + year: '1973' + qc6CJjYAAAAJ:VfMbra648c4C: + citations: 0 + title: 'Albert Einstein] to Hans Albert Einstein: Letter, 3 Mar 1916' + year: Unknown Year + qc6CJjYAAAAJ:VglVhKISWcQC: + citations: 7 + title: ON A HEURISTIC VIEWPOINT OF THE CREATION AND MODIFICATION OF LIGHT + year: '1905' + qc6CJjYAAAAJ:VjBpw8Hezy4C: + citations: 4 + title: Besprechungen + year: '1922' + qc6CJjYAAAAJ:VnuxuLaQPLMC: + citations: 50 + title: "Semi\u2010Vektoren und Spinoren" + year: '1932' + qc6CJjYAAAAJ:VoB_afVdn6EC: + citations: 0 + title: "Cuestiones fundamentales de la f\xEDsica contempor\xE1nea" + year: Unknown Year + qc6CJjYAAAAJ:Vxkav03X4woC: + citations: 1 + title: 'The collected papers of Albert Einstein. Vol 6, The Berlin years: writings, 1914-1917:[English translation]' + year: '2002' + qc6CJjYAAAAJ:VyOdxF-JhwgC: + citations: 253 + title: SB preuss + year: '1916' + qc6CJjYAAAAJ:VyewGSb6xwwC: + citations: 0 + title: 'Albert Einstein] to Wilhelm Wien: Letter, 2 Jun 1917' + year: Unknown Year + qc6CJjYAAAAJ:W1ZWpF0a3GIC: + citations: 1 + title: THE FREEDOM OF LEARNING. + year: '1936' + qc6CJjYAAAAJ:W6h41lW4BooC: + citations: 27 + title: "L'\xE9tat actuel du probl\xE8me des chaleurs sp\xE9cifiques" + year: '1912' + qc6CJjYAAAAJ:W7OEmFMy1HYC: + citations: 1606 + title: Lens-like action of a star by the deviation of light in the gravitational field + year: '1936' + qc6CJjYAAAAJ:WC4w5-ZrDNIC: + citations: 10 + title: "Textos fundamentais da f\xEDsica moderna" + year: '2001' + qc6CJjYAAAAJ:WD7AgJrCjNIC: + citations: 0 + title: La discussion Einstein-Bohr. + year: Unknown Year + qc6CJjYAAAAJ:WF5omc3nYNoC: + citations: 1035 + title: On gravitational waves + year: '1937' + qc6CJjYAAAAJ:WIVIxizkzXoC: + citations: 0 + title: 'Albert Einstein] to Paul Ehrenfest: Letter, 26 Dec 1915' + year: Unknown Year + qc6CJjYAAAAJ:WIXB4To3Tx4C: + citations: 111 + title: "Relativit\xE4t und gravitation. Erwiderung auf eine bemerkung von M. Abraham" + year: '1912' + qc6CJjYAAAAJ:WM2K3OHRCGMC: + citations: 218 + title: "Notas autobiogr\xE1ficas" + year: '2003' + qc6CJjYAAAAJ:WMtz-WDmgKQC: + citations: 59 + title: "Newtons Mechanik und ihr Einflu\xDF auf die Gestaltung der theoretischen Physik" + year: '1927' + qc6CJjYAAAAJ:WQTnNU6cpycC: + citations: 0 + title: 'Albert Einstein] to Geertruida de Haas: Letter, before 10 Apr 1915' + year: Unknown Year + qc6CJjYAAAAJ:WTSGYGHz1bkC: + citations: 0 + title: The collected papers of Albert Einstein. Vol. 11, Cumulative index, bibliography, list of correspondence, chronology, and errata to volumes 1-10 + year: Unknown Year + qc6CJjYAAAAJ:WY6AygvC5sMC: + citations: 0 + title: "Albert Einstein] to Walter D\xE4llenbach: Letter, 31 May 1915" + year: Unknown Year + qc6CJjYAAAAJ:WYtWvJut7doC: + citations: 0 + title: Reply to Welcome of Scientists of the California Institute of Technology in 1931 + year: '1949' + qc6CJjYAAAAJ:WgBxaE7EUScC: + citations: 0 + title: Autograph Manuscript of Einstein's Theory of Relativity + year: '1931' + qc6CJjYAAAAJ:WliCQ7fkH-wC: + citations: 49 + title: Emission and absorption of radiation according to the quantum theory + year: '1916' + qc6CJjYAAAAJ:WtgKeONp1i0C: + citations: 187 + title: "Lettres a Maurice Solovine: reprod. en facsimil\xE9 et trad. en fran\xE7aise: avec une introduction et trois photographies" + year: '1956' + qc6CJjYAAAAJ:WxjA8IQWSGYC: + citations: 0 + title: Dr. Einstein to Dean Muelder + year: '1955' + qc6CJjYAAAAJ:WzbvD7BMtBoC: + citations: 0 + title: 'Albert Einstein] to Wladyslaw Natanson: Letter, 14 Sep 1917' + year: Unknown Year + qc6CJjYAAAAJ:X-Dm1JipzzIC: + citations: 0 + title: 'Albert Einstein] to Hans Albert Einstein: Letter, 18 Dec 1915' + year: Unknown Year + qc6CJjYAAAAJ:X1xEhyGaivYC: + citations: 1 + title: "Ged\xE4chtnisrede auf Karl Schwarzschild" + year: '2006' + qc6CJjYAAAAJ:X3EXpuCuTEcC: + citations: 0 + title: The collecteds of albert einstein v 9 the berlin years correspondence january 1919 april 1920 (hardback) + year: '2004' + qc6CJjYAAAAJ:X5QHDg3V9EEC: + citations: 2 + title: Science and synthesis + year: '1971' + qc6CJjYAAAAJ:X5YyAB84Iw4C: + citations: 297 + title: Philosopher-Scientist + year: '1970' + qc6CJjYAAAAJ:XK2cf6JOk9AC: + citations: 0 + title: 'Gefaehrliche Freundschaft: Konsens in schwieriger Zeit' + year: '1996' + qc6CJjYAAAAJ:XOE35tnTnDYC: + citations: 49 + title: Space-time + year: '1929' + qc6CJjYAAAAJ:XR3BWSlh_xcC: + citations: 14 + title: "Sobre la teor\xEDa especial y la teoria general de la relatividad" + year: '1983' + qc6CJjYAAAAJ:XUAslYVNQLQC: + citations: 266 + title: Relativita + year: '1960' + qc6CJjYAAAAJ:XWcFhoZvYIAC: + citations: 0 + title: "Problemy fiziki: klassika i sovremennost\u02B9" + year: '1982' + qc6CJjYAAAAJ:XX7pGhTe5MgC: + citations: 0 + title: 'Albert Einstein] to Paul Gruner: Letter, 11 Feb 1908' + year: Unknown Year + qc6CJjYAAAAJ:XZvG1uL-wj0C: + citations: 1148 + title: 'On the method of theoretical physics: The Herbert Spencer lecture, delivered at Oxford 10 June 1933' + year: '1933' + qc6CJjYAAAAJ:Xc-mKOjpdrwC: + citations: 0 + title: Relativistische Physik + year: Unknown Year + qc6CJjYAAAAJ:XdYaqolBBq8C: + citations: 30 + title: 'The Collected Papers of Albert Einstein, Volume 9: The Berlin Years: Correspondence, January 1919-April 1920' + year: '2004' + qc6CJjYAAAAJ:XdwVV_xN3QMC: + citations: 1463 + title: Draft of a Generalized Theory of Relativity and a Theory of Gravitation + year: '1913' + qc6CJjYAAAAJ:XeErXHja3Z8C: + citations: 14 + title: "\xDCber die Interferenzeigenschaften des durch Kanalstrahlen emittierten Lichtes" + year: '1926' + qc6CJjYAAAAJ:XfMaBeGYgSgC: + citations: 0 + title: 'Albert Einstein] to Wander and Geertruida de Haas: Letter, 10 Aug 1915' + year: Unknown Year + qc6CJjYAAAAJ:Xi1bsBfZRoQC: + citations: 0 + title: 'Reise nach Japan Palestine Spanien 6 Oktober 1922-12.3. 23: Various places' + year: '1923' + qc6CJjYAAAAJ:XiSMed-E-HIC: + citations: 67 + title: What I believe + year: '1956' + qc6CJjYAAAAJ:Xnn2mF3JXD4C: + citations: 72 + title: "Untersuchungen \xFCber die Theorie der Brownschen Bewegung" + year: '1922' + qc6CJjYAAAAJ:XtJa11BXPS4C: + citations: 35 + title: Atomic war or peace + year: '1947' + qc6CJjYAAAAJ:Xtec1x7NZGAC: + citations: 0 + title: Constante de Planck + year: Unknown Year + qc6CJjYAAAAJ:XzWLPxS1ir4C: + citations: 0 + title: "Research@ FrankfurtSchool in Zeiten der Finanzmarktkrise \u201EA Collection of Working Papers \u201C" + year: Unknown Year + qc6CJjYAAAAJ:Y0agIcFmOsQC: + citations: 1306 + title: A correction on my work-A new determination of molecular dimensions + year: '1969' + qc6CJjYAAAAJ:Y1W0x10ZrwMC: + citations: 0 + title: Nonlinear Partial Differential Equations with Applications + year: Unknown Year + qc6CJjYAAAAJ:Y3Sh7dCAXz0C: + citations: 6 + title: "Correspondance 1903-1955, publi\xE9e par P" + year: '1972' + qc6CJjYAAAAJ:Y6EZgx1ah38C: + citations: 0 + title: "L'\xE9lectron et la th\xE9orie de la relativit\xE9 g\xE9n\xE9rale" + year: '1997' + qc6CJjYAAAAJ:YEBtnu9hOHUC: + citations: 0 + title: "A Statement of Purpose by the Emergency Committee of Atomic Scientists Incorporated: Presented to the Friends of the Committee on Sunday, November Seventeenth, 1946, at the \u2026" + year: '1946' + qc6CJjYAAAAJ:YFjsv_pBGBYC: + citations: 56 + title: Essays in physics + year: '1950' + qc6CJjYAAAAJ:YK4ucWkmU_UC: + citations: 73 + title: 'Albert Einstein, the Human Side: New Glimpses from His Archives' + year: '1981' + qc6CJjYAAAAJ:YP-lgzILWVMC: + citations: 0 + title: 'Albert Einstein] to Mileva Einstein-Maric: Letter, 8 Apr 1916' + year: Unknown Year + qc6CJjYAAAAJ:YV61qt6iSr0C: + citations: 9 + title: "Los fundamentos de la geometr\xEDa" + year: '1948' + qc6CJjYAAAAJ:YXPZ0dOdYS4C: + citations: 2 + title: 'Einstein''s Zurich Notebook: Transcription and Facsimile' + year: '2007' + qc6CJjYAAAAJ:YZzzgH80nR8C: + citations: 29 + title: The Late Emmy Noether + year: '1935' + qc6CJjYAAAAJ:YbLjypsZzowC: + citations: 92 + title: "\xBF Por qu\xE9 la Guerra?" + year: '2001' + qc6CJjYAAAAJ:YiBZ6_7J9mkC: + citations: 0 + title: "THEORY OF RELATIVITY ON EINSTEIN: Einstein the Searcher. A. Moskowski. London, 1921. Albert Einstein. Anton Reiser. New York, 1930. Contemporary Immortals. A. Henderson. New \u2026" + year: '1938' + qc6CJjYAAAAJ:YiZc1oW-E3oC: + citations: 0 + title: 'Albert Einstein] to Otto Naumann: Letter, after 1 Oct 1915' + year: Unknown Year + qc6CJjYAAAAJ:Yo42cslQ7-cC: + citations: 20 + title: Physics, philosophy and scientific progress. + year: '1950' + qc6CJjYAAAAJ:YoqGh_aPxy4C: + citations: 79 + title: The common language of science + year: '1941' + qc6CJjYAAAAJ:YpRCXavlr0AC: + citations: 0 + title: 'Albert Einstein] to Michele and Anna Besso-Winteler: Letter, 1 Aug 1917' + year: Unknown Year + qc6CJjYAAAAJ:YsMSGLbcyi4C: + citations: 2308 + title: The particle problem in the general theory of relativity + year: '1935' + qc6CJjYAAAAJ:YvgfBAebZEkC: + citations: 0 + title: 'Notice to the world: renounce war or perish; world peace or universal death.[Sound recording]' + year: '1955' + qc6CJjYAAAAJ:Z5m8FVwuT1cC: + citations: 19 + title: Mi credo humanista + year: '1991' + qc6CJjYAAAAJ:ZDu_srLEjN8C: + citations: 145 + title: Preussische akademie der wissenschaften, Phys-math + year: '1925' + qc6CJjYAAAAJ:ZEcFV8kAgqMC: + citations: 0 + title: 'Albert Einstein] to Edgar Meyer: Letter, 30 Oct 1917' + year: Unknown Year + qc6CJjYAAAAJ:ZHR7-34Bl2wC: + citations: 0 + title: "Ged\xE4chtnisrede des Hrn. Einstein auf Karl Schwarzschild, 29 Jun 1916" + year: Unknown Year + qc6CJjYAAAAJ:ZHo1McVdvXMC: + citations: 1 + title: 'The collected papers of Albert Einstein. Vol. 3: The Swiss years: Writings 1909-1911; Vol. 5: The Swiss years: Correspondence 1902-1914' + year: '1993' + qc6CJjYAAAAJ:ZM__uENUXnMC: + citations: 0 + title: 'Albert Einstein] to the Council of Education: Letter, Canton of Zurich, 20 Jan 1908' + year: Unknown Year + qc6CJjYAAAAJ:ZWXmI6zqLYMC: + citations: 0 + title: "Bemerkung zu E. Gehrckes Notiz\" \xDCber den \xC4ther\", 29 Nov 1918" + year: Unknown Year + qc6CJjYAAAAJ:ZYLUaBFA95QC: + citations: 11 + title: 'Briefwechsel: Sechzig Briefe aus dem goldenen Zeitalter der modernen Physik' + year: '1968' + qc6CJjYAAAAJ:ZbQVaL1IMbQC: + citations: 631 + title: Quanzeml~ orie der stralllung + year: '1916' + qc6CJjYAAAAJ:ZbiiB1Sm8G8C: + citations: 14 + title: 'Albert Einstein] to Michele Besso: Letter, 6 Apr 1916' + year: Unknown Year + qc6CJjYAAAAJ:ZeXyd9-uunAC: + citations: 318 + title: "Physik und realit\xE4t" + year: '1936' + qc6CJjYAAAAJ:ZfRJV9d4-WMC: + citations: 94 + title: Pourquoi la guerre? + year: '1933' + qc6CJjYAAAAJ:ZgPQhQxLujAC: + citations: 6 + title: Mein Weltbild, hrsg. v + year: '1977' + qc6CJjYAAAAJ:Zk83zdSX4-UC: + citations: 5 + title: "L'\xE9vidence de la th\xE9orie de Einstein" + year: '1923' + qc6CJjYAAAAJ:ZnWe2zbntUIC: + citations: 2 + title: 'Relativiteit: speciale en algemene theorie' + year: '1986' + qc6CJjYAAAAJ:Zph67rFs4hoC: + citations: 396 + title: "Grundz\xFCge der Relativit\xE4tstheorie" + year: '2002' + qc6CJjYAAAAJ:ZppSRAJs3i8C: + citations: 5 + title: 'Albert Einstein] to Moritz Schlick: Letter, 6 Feb 1917' + year: Unknown Year + qc6CJjYAAAAJ:ZuSUVyMx-TgC: + citations: 0 + title: 'Albert Einstein] to David Hilbert: Letter, 30 May 1916' + year: Unknown Year + qc6CJjYAAAAJ:ZysSsiWj_g4C: + citations: 21 + title: "Bemerkungen \xFCber periodische Schwankungen der Mondl\xE4nge, welche bisher nach der Newtonschen Mechanik nicht erkl\xE4rbar erschienen" + year: '1919' + qc6CJjYAAAAJ:_8B_re9sV0EC: + citations: 0 + title: 'Albert Einstein] to Romain Rolland: Letter, 15 Sep 1915' + year: Unknown Year + qc6CJjYAAAAJ:_8F20clBW_QC: + citations: 3 + title: Gelegentliches von Albert Einstein + year: '1929' + qc6CJjYAAAAJ:_9Xh93LWpsYC: + citations: 43 + title: "\xDCber Friedrich Kottlers Abhandlung \u201C\xDCber Einsteins \xC4quivalenzhypothese und die Gravitation\u201D" + year: '1916' + qc6CJjYAAAAJ:_IsBomjs8bsC: + citations: 26 + title: "Lassen sich Brechungsexponenten der K\xF6rper f\xFCr R\xF6ntgenstrahlen experimentell ermitteln?" + year: '1918' + qc6CJjYAAAAJ:_Nt1UvVys9QC: + citations: 23 + title: Gravitational and electromagnetic fields + year: '1931' + qc6CJjYAAAAJ:_Re3VWB3Y0AC: + citations: 135 + title: 'Einstein and the Poet: In Search of the Cosmic Man' + year: '1983' + qc6CJjYAAAAJ:_Ybze24A_UAC: + citations: 17 + title: The collected works of Bernhard Riemann + year: '1953' + qc6CJjYAAAAJ:_axFR9aDTf0C: + citations: 6 + title: Theoretical remark on the superconductivity of metals + year: '2005' + qc6CJjYAAAAJ:_bh1rdP-zDcC: + citations: 43 + title: "Die Diracgleichungen f\xFCr Semivektoren" + year: '1933' + qc6CJjYAAAAJ:_inCrQx-FbQC: + citations: 0 + title: "Depuis le principe d'\xE9quivalence jusqu'aux \xE9quations de la gravitation." + year: Unknown Year + qc6CJjYAAAAJ:_kc_bZDykSQC: + citations: 409 + title: A generalization of the relativistic theory of gravitation + year: '1945' + qc6CJjYAAAAJ:_mQi-xiA4oYC: + citations: 459 + title: "Die Relativit\xE4ts-Theorie" + year: '1911' + qc6CJjYAAAAJ:a2necdfpwlEC: + citations: 155 + title: "Eine Beziehung zwischen dem elastischen Verhalten und der spezifischen W\xE4rme bei festen K\xF6rpern mit einatomigem Molek\xFCl" + year: '1911' + qc6CJjYAAAAJ:a9-T7VOCCH8C: + citations: 3782 + title: The Science and the Life of Albert Einstein + year: '1982' + qc6CJjYAAAAJ:aDdGf5um_jkC: + citations: 0 + title: 'Albert Einstein] to Gustav Mie: Letter, 2 Jun 1917' + year: Unknown Year + qc6CJjYAAAAJ:aEPHIGigqugC: + citations: 4285 + title: "Physics and Reality, in \u201CIdeas and Opinions\u201D" + year: '1954' + qc6CJjYAAAAJ:aEyKTaVlRPYC: + citations: 10 + title: El mundo tal como yo lo veo + year: '1989' + qc6CJjYAAAAJ:aKos2Y7kUz0C: + citations: 107 + title: letter to Ernst Mach + year: '1923' + qc6CJjYAAAAJ:aMQnNzTHVu4C: + citations: 7 + title: 'Essays in Science (New York: Philosophical Library, 1934)' + year: Unknown Year + qc6CJjYAAAAJ:aXI_bbQgCfgC: + citations: 168 + title: "Die Ursache der M\xE4anderbildung der Flu\xDFl\xE4ufe und des sogenannten Baerschen Gesetzes" + year: '1926' + qc6CJjYAAAAJ:aXwx4OqTWR4C: + citations: 0 + title: Einstein Appeals for War Resisters + year: '1932' + qc6CJjYAAAAJ:abCsMXLaarkC: + citations: 8 + title: "Religi\xF3n y ciencia" + year: '2000' + qc6CJjYAAAAJ:abG-DnoFyZgC: + citations: 293 + title: The fundamentals of theoretical physics + year: '1950' + qc6CJjYAAAAJ:ace9KxS0p5UC: + citations: 284 + title: Zur theorie der lichterzeugung und lichtabsorption + year: '1906' + qc6CJjYAAAAJ:adHtZc2wMuEC: + citations: 129 + title: "Neue M\xF6glichkeit f\xFCr eine einheitliche Feldtheorie von Gravitation und Elektrizit\xE4t" + year: '1928' + qc6CJjYAAAAJ:adgdM4TzidAC: + citations: 184 + title: "Sur l'\xE9lectrodynamique des corps en mouvement" + year: '1905' + qc6CJjYAAAAJ:ae0xyBWlIcIC: + citations: 0 + title: "Albert Einstein] to Michael Pol\xE1nyi: Letter, 6 Jul 1915" + year: Unknown Year + qc6CJjYAAAAJ:afceBpUbn5YC: + citations: 59 + title: Atomic education urged by Einstein + year: '1946' + qc6CJjYAAAAJ:afcu1OVO0wMC: + citations: 10 + title: Autobiographical notes (1949) + year: Unknown Year + qc6CJjYAAAAJ:afsF9h1fxg0C: + citations: 2 + title: Physical meaning of geometrical propositions + year: '1961' + qc6CJjYAAAAJ:b9WrW9Envh0C: + citations: 0 + title: 'Albert Einstein Letter: Princeton, NJ, to JN Smith, Laguna Beach, Calif' + year: '1950' + qc6CJjYAAAAJ:bB6ab1qDjH0C: + citations: 0 + title: 'Albert Einstein] to Hans Albert Einstein: Letter, 26 Nov 1916' + year: Unknown Year + qc6CJjYAAAAJ:bCjgOgSFrM0C: + citations: 1218 + title: "Die plancksche theorie der strahlung und die theorie der spezifischen w\xE4rme" + year: '1906' + qc6CJjYAAAAJ:bEWYMUwI8FkC: + citations: 284 + title: Why war? + year: '1933' + qc6CJjYAAAAJ:bFuYayV9R1gC: + citations: 0 + title: GENERAL RELATIVITY VERSUS QUANTUM THEORY + year: Unknown Year + qc6CJjYAAAAJ:bNEIKWRbVi8C: + citations: 0 + title: King's College Lecture, before 13 Jun 1921 + year: Unknown Year + qc6CJjYAAAAJ:bO_hriczGZwC: + citations: 0 + title: 'Albert Einstein] to Adolf von Harnack: Letter, 6 Oct 1917' + year: Unknown Year + qc6CJjYAAAAJ:bQkGhl1z2hUC: + citations: 0 + title: 'Albert Einstein] to Paul Hertz: Letter, 22 Aug 1915' + year: Unknown Year + qc6CJjYAAAAJ:bUu3lypoyhcC: + citations: 680 + title: On the quantum theory of radiation + year: '1972' + qc6CJjYAAAAJ:bcT4vkklUMwC: + citations: 0 + title: "Briefe zur Wellenmechanik: Schr\xF6dinger, Planck, Einstein, Lorentz; mit 4 Portr" + year: '1963' + qc6CJjYAAAAJ:bczYY1dZPtQC: + citations: 93 + title: "M\xE9thode pour la d\xE9termination de valeurs statistiques d'observations concernant des grandeurs soumises a des fluctuations irr\xE9guli\xE8res" + year: '1914' + qc6CJjYAAAAJ:bf7w-NijnqMC: + citations: 14 + title: Kinetic theory of thermal equilibrium and of the second law of thermodynamics + year: '1902' + qc6CJjYAAAAJ:bgW0xdllhO4C: + citations: 17 + title: Personal God Concept Causes Science-Religion Conflict + year: '1940' + qc6CJjYAAAAJ:bjlTY1bLvvcC: + citations: 0 + title: So You Want to + year: '2003' + qc6CJjYAAAAJ:blknAaTinKkC: + citations: 165 + title: "Zur Theorie der Radiometerkr\xE4fte" + year: '1924' + qc6CJjYAAAAJ:bnK-pcrLprsC: + citations: 30 + title: Unified field theory based on Riemannian metrics and distant parallelism + year: '1930' + qc6CJjYAAAAJ:boGf3zyra0UC: + citations: 0 + title: 'The collected papers of Albert Einstein. vol. 9, The Berlin years: correspondence, January 1919-April 1920:[English translation]' + year: Unknown Year + qc6CJjYAAAAJ:brChLMnLtjYC: + citations: 161 + title: Relativity Principle and its Consequences in Modern Physics. Collection of Scientific Works, V. 1 + year: '1965' + qc6CJjYAAAAJ:bsl25C5uMOsC: + citations: 26 + title: Field theories, old and new + year: '1960' + qc6CJjYAAAAJ:btULBOGQ_gcC: + citations: 0 + title: 'Albert Einstein] to Erwin Freundlich: Letter, 3 Sep 1917' + year: Unknown Year + qc6CJjYAAAAJ:bxbQgRQgr4sC: + citations: 0 + title: Selected works of Einstein with historical commentaries + year: '1979' + qc6CJjYAAAAJ:bz8QjSJIRt4C: + citations: 0 + title: 'Relativity: an interpretation of Einstein''s theory' + year: '1931' + qc6CJjYAAAAJ:c3oc_9pK2TEC: + citations: 9 + title: The Fight Against War + year: '1933' + qc6CJjYAAAAJ:c4A-nLdbYHEC: + citations: 1565 + title: 'Concepts of space: The history of theories of space in physics' + year: '1969' + qc6CJjYAAAAJ:c5LcigzBm8MC: + citations: 0 + title: 'Albert Einstein] to Heinrich Zangger: Letter, 24 Jun 1918' + year: Unknown Year + qc6CJjYAAAAJ:cB__R-XWw9UC: + citations: 147 + title: "Aus meinen sp\xE4ten Jahren" + year: '1952' + qc6CJjYAAAAJ:cG0OFEevkNgC: + citations: 0 + title: 'In Memory of Emmy Noether...: Abstract of Address Delivered by Professor Hermann Weyl... and Copy of Letter of Professor Albert Einstein' + year: '1935' + qc6CJjYAAAAJ:cNe27ouKFcQC: + citations: 7262 + title: "Die grundlage der allgemeinen relativit\xE4tstheorie" + year: '2006' + qc6CJjYAAAAJ:cOfwuRB03ygC: + citations: 3 + title: "Die spezielle relativit\xE4tstheorie Einsteins und die logik" + year: '1924' + qc6CJjYAAAAJ:cRMvf6lLvU8C: + citations: 271 + title: "Einige Argumente f\xFCr die Annahme einer molekularen Agitation beim absoluten Nullpunkt" + year: '1913' + qc6CJjYAAAAJ:cSdaV2aYdYsC: + citations: 425 + title: Spielen Gravitationsfelder im Aufbau der materiellen Elementarteilchen eine wesentliche Rolle? + year: '1919' + qc6CJjYAAAAJ:cTdzRpWJKHEC: + citations: 104 + title: Sitsungsber. Preus. Akad. Wiss + year: '1915' + qc6CJjYAAAAJ:caH3YpRUWsIC: + citations: 0 + title: Theories and sociology of the history of science + year: Unknown Year + qc6CJjYAAAAJ:cdM53WF7QocC: + citations: 14 + title: 'Albert Einstein] to Michele Besso: Letter, 9 Mar 1917' + year: Unknown Year + qc6CJjYAAAAJ:cjagZD1ri60C: + citations: 260 + title: On the present status of the radiation problem + year: '1909' + qc6CJjYAAAAJ:co-xmOEWlm8C: + citations: 0 + title: Physical Principles of Sensing + year: Unknown Year + qc6CJjYAAAAJ:coeFWI40FR8C: + citations: 3 + title: Letter on the creative process + year: '1971' + qc6CJjYAAAAJ:cvMPO0XfNn8C: + citations: 0 + title: "cr\xE9ateur et rebelle" + year: '1972' + qc6CJjYAAAAJ:cww_0JKUTDwC: + citations: 169 + title: Eine Theorie der Grundlagen der Thermodynamik + year: '1903' + qc6CJjYAAAAJ:cxS_fjKIGZMC: + citations: 0 + title: 'Einstein, the Man, the Jew: Excerpts from His Articles, Speeches and Statements' + year: '1955' + qc6CJjYAAAAJ:d4Uf0zfqV5IC: + citations: 0 + title: "Signification de la relativit\xE9: appendice \xE0 la cinqui\xE8me \xE9dition de\" The meaning of relativity\"(d\xE9cembre 1954). Compl\xE9ments" + year: '1960' + qc6CJjYAAAAJ:d4tt_xEv1X8C: + citations: 221 + title: Lichtgeschwindigkeit und statik des Gravitationsfeldes + year: '1912' + qc6CJjYAAAAJ:d6JCS5z0ckYC: + citations: 4 + title: The establishment of an international bureau of meteorology + year: '1927' + qc6CJjYAAAAJ:dBIO0h50nwkC: + citations: 44 + title: Physics & reality + year: '2003' + qc6CJjYAAAAJ:dDz6LBb16w8C: + citations: 18 + title: The work and personality of Walther Nernst + year: '1942' + qc6CJjYAAAAJ:dFKc6_kCK1wC: + citations: 8 + title: "Bemerkung zu der Abhandlung von E. Trefftz:\u201CDas statische Gravitationsfeld zweier Massenpunkte in der Einsteinschen Theorie\u201D" + year: '2006' + qc6CJjYAAAAJ:dJ-sGqsME_YC: + citations: 9 + title: "Correspondence 1903\u20131955, ed" + year: '1972' + qc6CJjYAAAAJ:dTyEYWd-f8wC: + citations: 186 + title: "L'\xE9volution des id\xE9es en physique: des premiers concepts aux th\xE9ories de la relativit\xE9 et des quanta" + year: '1948' + qc6CJjYAAAAJ:dX-nQPao9noC: + citations: 0 + title: "Quelques explications concernant les d\xE9placements\" rouges\" dans les spectres des galaxies lointaines." + year: Unknown Year + qc6CJjYAAAAJ:dY-VugTTHzcC: + citations: 0 + title: "L'Heure H at-elle sonn\xE9 pour le monde?: effets accumulatifs des explosions nucl\xE9aires. Pr\xE9c\xE9d\xE9 d'un Message de Albert Einstein" + year: '1955' + qc6CJjYAAAAJ:dZbaGXT4iR0C: + citations: 40 + title: Education + year: '1950' + qc6CJjYAAAAJ:dgXhHFWAKKUC: + citations: 10 + title: 'Albert Einstein] to Max Born: Letter, after 3 Jul 1918' + year: Unknown Year + qc6CJjYAAAAJ:dhFuZR0502QC: + citations: 199 + title: 'Corrections and additional remarks to our paper: The influence of the expansion of space on the gravitation fields surrounding the individual stars' + year: '1946' + qc6CJjYAAAAJ:dhZ1Wuf5EGsC: + citations: 0 + title: "Continuous Symmetries and Conservation Laws. Noether\u2019s Theorem" + year: Unknown Year + qc6CJjYAAAAJ:dpaHy1TF288C: + citations: 0 + title: 'Albert Einstein] to Conrad Habicht: Letter, 14 Dec 1909' + year: Unknown Year + qc6CJjYAAAAJ:dtdq7L-L3iMC: + citations: 0 + title: Early life and education + year: Unknown Year + qc6CJjYAAAAJ:e3CVSTJ63dQC: + citations: 7 + title: "Der gegenw\xE4rtige Stand der Relativit\xE4tstheorie..." + year: '1931' + qc6CJjYAAAAJ:e3UXjaW_PBUC: + citations: 0 + title: 'Albert Einstein] to Hans Albert Einstein: Letter, 4 Nov 1915' + year: Unknown Year + qc6CJjYAAAAJ:e84hm74t-eoC: + citations: 5713 + title: "Eine neue bestimmung der molek\xFCldimensionen" + year: '1906' + qc6CJjYAAAAJ:eAUscmXIlQ8C: + citations: 29 + title: Nichteuklidische Geometrie und Physik + year: '1925' + qc6CJjYAAAAJ:eCFM_hdDfssC: + citations: 0 + title: The equivalence of gravitational and inertial mass + year: Unknown Year + qc6CJjYAAAAJ:eGJUmgNLeWAC: + citations: 4 + title: Besprechungen + year: '1918' + qc6CJjYAAAAJ:eJXPG6dFmWUC: + citations: 489 + title: The theory of relativity + year: '1996' + qc6CJjYAAAAJ:eKGuBlYFiu8C: + citations: 0 + title: "L'\xE9lectronique quantique et la th\xE9orie d'irradiation d'Einstein." + year: Unknown Year + qc6CJjYAAAAJ:eMMeJKvmdy0C: + citations: 12 + title: Det Moderne Verdensbillede + year: '1939' + qc6CJjYAAAAJ:ealulPZkXgsC: + citations: 3 + title: Expectations of a definite form + year: '1950' + qc6CJjYAAAAJ:ec1XJgWlWRUC: + citations: 0 + title: Relational, Linear-Time Communication for Replication + year: Unknown Year + qc6CJjYAAAAJ:ehoypfNsBj8C: + citations: 20 + title: Antwort auf vorstehende Betrachtung + year: '1920' + qc6CJjYAAAAJ:eiwtZcG9oBcC: + citations: 0 + title: 'A Letter from Einstein: Praises Dean Muelder''s Distinguished Lecture" The Idea of the Responsible Society"' + year: '1955' + qc6CJjYAAAAJ:eq2jaN3J8jMC: + citations: 66 + title: "\xDCber den Frieden: Weltordnung oder Weltuntergang?" + year: '1976' + qc6CJjYAAAAJ:esGtpfCv0y8C: + citations: 0 + title: Butsurigaku wa ikani tsukuraretaka + year: '1962' + qc6CJjYAAAAJ:evX43VCCuoAC: + citations: 300 + title: 'Scientific Correspondence with Bohr, Einstein, Heisenberg and Others...: 1919-1929' + year: '1979' + qc6CJjYAAAAJ:f-E_jMG6T4AC: + citations: 0 + title: La correspondance entre Einstein et De Broglie. + year: Unknown Year + qc6CJjYAAAAJ:f13iAvnbnnYC: + citations: 0 + title: PROBABILITY AND STOCHASTIC PROCESSES + year: Unknown Year + qc6CJjYAAAAJ:f14mYpCygl4C: + citations: 0 + title: "Kritisches zu einer von Hrn. De Sitter gegebenen L\xF6sung der Gravitationsgleichungen, 7 M\xE4r 1918" + year: Unknown Year + qc6CJjYAAAAJ:f2IySw72cVMC: + citations: 39 + title: Briefe an Maurice Solovine + year: '1960' + qc6CJjYAAAAJ:f36TrmluGJsC: + citations: 0 + title: 'Albert Einstein] to Otto Stern: Letter, after 4 Jun 1914' + year: Unknown Year + qc6CJjYAAAAJ:f8T_-ThkUo0C: + citations: 0 + title: "Histoire de la compr\xE9hension de l'origine du spectre infrarouge (1912-1920)(II)." + year: Unknown Year + qc6CJjYAAAAJ:f9jR0vFhilIC: + citations: 0 + title: "Sushchnost\u02B9 teorii otnositel\u02B9nosti: Perevod s angli\u012Dskogo" + year: '1955' + qc6CJjYAAAAJ:fEOibwPWpKIC: + citations: 150 + title: "\xDCber den \xC4ther" + year: '1924' + qc6CJjYAAAAJ:fHS53ZCY-AEC: + citations: 0 + title: 'Albert Einstein] to Kathia Adler: Letter, 20 Feb 1917' + year: Unknown Year + qc6CJjYAAAAJ:fLJJVVwU7EQC: + citations: 268 + title: "Ein einfaches Experiment zum Nachweis der Amp\xE8reschen Molekularstr\xF6me" + year: '1916' + qc6CJjYAAAAJ:fPk4N6BV_jEC: + citations: 66 + title: "Sobre a eletrodin\xE2mica dos corpos em movimento" + year: '1983' + qc6CJjYAAAAJ:fSKd39tHJ84C: + citations: 0 + title: To Prevent Misunderstanding + year: '1949' + qc6CJjYAAAAJ:fTLh7q_iUBEC: + citations: 40 + title: "Bemerkungen zu P. Harzers Abhandlung\xBB \xDCber die Mitf\xFChrung des Lichtes in Glas und die Aberration \xAB." + year: '1914' + qc6CJjYAAAAJ:fXCg-C-QWH4C: + citations: 0 + title: "Albert Einstein, o lado humano: r\xE1pidas vis\xF5es colhidas em seus arquivos" + year: '1979' + qc6CJjYAAAAJ:fZtrMt_Z7PsC: + citations: 0 + title: 'Albert Einstein] to Paul Ehrenfest: Letter, beginning Dec 1914' + year: Unknown Year + qc6CJjYAAAAJ:fh7vmlWxvT0C: + citations: 61 + title: 'Albert Einstein/Arnold Sommerfeld: Briefwechsel: Sechzig Briefe aus dem goldenen Zeitalter der modernen Physik' + year: '1968' + qc6CJjYAAAAJ:fixghrsIJ_wC: + citations: 0 + title: L'assoluto nella teoria di Einstein + year: '1923' + qc6CJjYAAAAJ:fveVehIkgekC: + citations: 0 + title: The Collected Papers of Albert Einstein, Vol. 6 The Berlin Years 1914-1917 + year: '1998' + qc6CJjYAAAAJ:g-FVFPYC6a8C: + citations: 0 + title: Does Nature Violate Local Realism? + year: '1997' + qc6CJjYAAAAJ:g2bnS7N2_ggC: + citations: 29 + title: Testimorial from Professor Einstein (Appendix II) + year: '1945' + qc6CJjYAAAAJ:g2zAJ5Cw7N4C: + citations: 85 + title: On the limit of validity of the law of thermodynamic equilibrium and on the possibility of a new determination of the elementary quanta + year: '1907' + qc6CJjYAAAAJ:g5m5HwL7SMYC: + citations: 144 + title: TIME, SPACE, AND GRAVITATION. + year: '1920' + qc6CJjYAAAAJ:gKLIUvgTho8C: + citations: 28 + title: "Comment on the Paper by WR He\xDF,\u2018Contribution to the theory of the viscosity of heterogeneous systems,\u2019" + year: '1920' + qc6CJjYAAAAJ:gNsIjQZ6FscC: + citations: 86 + title: Letter + year: '1934' + qc6CJjYAAAAJ:gUOu-QWEMMQC: + citations: 7 + title: Zu Dr. Berliners siebzigstem Geburtstag + year: '1932' + qc6CJjYAAAAJ:gV6rEsy15s0C: + citations: 3521 + title: Bemerkungen zu der Arbeit + year: '1914' + qc6CJjYAAAAJ:gYAb_yFic6IC: + citations: 32 + title: Zur Methodik der Theoretischen Physik + year: '1934' + qc6CJjYAAAAJ:gmHTDCtJMcoC: + citations: 159 + title: "Folgerungen aus den Capillarit\xE4tserscheinungen" + year: '1901' + qc6CJjYAAAAJ:gqMmJtG4vxUC: + citations: 14 + title: 'Albert Einstein] to Michele Besso: Letter, 10 Dec 1915' + year: Unknown Year + qc6CJjYAAAAJ:h0mLeC6b6wcC: + citations: 18 + title: Electrons et photons + year: '1928' + qc6CJjYAAAAJ:h7-KW5G1enMC: + citations: 119 + title: Induktion und Deduktion in der Physik + year: '1919' + qc6CJjYAAAAJ:hB2aVRuWZNwC: + citations: 5 + title: "Ejn\u0161tejnovskaja teorija otnosite\u013Enosti" + year: '1972' + qc6CJjYAAAAJ:hEXC_dOfxuUC: + citations: 394 + title: Reply to critics + year: '1949' + qc6CJjYAAAAJ:hEp1lTclR2YC: + citations: 314 + title: On the generalized theory of gravitation + year: '1950' + qc6CJjYAAAAJ:hKjooKYXoHIC: + citations: 56 + title: "\xDCber die formale Beziehung des Riemannschen Kr\xFCmmungstensors zu den Feldgleichungen der Gravitation" + year: '1927' + qc6CJjYAAAAJ:hMod-77fHWUC: + citations: 5114 + title: "La relativit\xE9" + year: '1964' + qc6CJjYAAAAJ:hMwNgRnlwaMC: + citations: 0 + title: 'Albert Einstein] to Hans Albert Einstein: Letter, 10 Sep 1914' + year: Unknown Year + qc6CJjYAAAAJ:hTqO-V9ugBQC: + citations: 184 + title: "Sur l'\xE9lectrodynamique des corps en mouvement" + year: '1965' + qc6CJjYAAAAJ:hUq98zRk74IC: + citations: 15 + title: EddingtonsTheorie und Hamiltonsches Prinzip + year: '1925' + qc6CJjYAAAAJ:hVd5agGqjXwC: + citations: 382 + title: Physikalische Gesellschaft Zuerich + year: '1916' + qc6CJjYAAAAJ:hbz17DqrwuEC: + citations: 149 + title: Notiz zu unserer Arbeit + year: '1915' + qc6CJjYAAAAJ:hcF2OqvMasEC: + citations: 125 + title: Warum Krieg? + year: '1933' + qc6CJjYAAAAJ:he8YCnfqqkoC: + citations: 37 + title: "Rapports et Discussions du Cinqui\xE8me Conseil Solvay" + year: '1928' + qc6CJjYAAAAJ:hegzVdMJwJYC: + citations: 0 + title: "Quelques probl\xE8mes touchant les recherches sur Einstein" + year: Unknown Year + qc6CJjYAAAAJ:hfzGNhXhx5MC: + citations: 231 + title: "Dialog \xFCber Einw\xE4nde gegen die Relativit\xE4tstheorie" + year: '1918' + qc6CJjYAAAAJ:htV_5D2kmyYC: + citations: 32 + title: The way out + year: '1946' + qc6CJjYAAAAJ:htyGaKyDgHMC: + citations: 31 + title: "Zwei strenge statische L\xF6sungen der Feldgleichungen der einheitlichen Feldtheorie" + year: '1930' + qc6CJjYAAAAJ:hy8If-OszRcC: + citations: 0 + title: Divorce Agreement, 12 Jun 1918 + year: Unknown Year + qc6CJjYAAAAJ:i91s68tWr-MC: + citations: 84 + title: "\xDCber einen Satz der Wahrscheinlichkeitsrechnung und seine Anwendung in der Strahlungstheorie" + year: '1910' + qc6CJjYAAAAJ:i9zlNfTiRXIC: + citations: 0 + title: 'As it was: the UNESCO Courier December 1951' + year: '1996' + qc6CJjYAAAAJ:iH-uZ7U-co4C: + citations: 113 + title: Knowledge of past and future in quantum mechanics + year: '1931' + qc6CJjYAAAAJ:iKmOvsfbmGkC: + citations: 0 + title: Discussion following lecture," On the Present State of the Problem of Specific Heats"(Doc. 26), 3 Nov 1911 + year: '2003' + qc6CJjYAAAAJ:iKz1iSBcTNcC: + citations: 0 + title: 'Albert Einstein] to Elsa Einstein: Letter, 11 Sep 1915' + year: Unknown Year + qc6CJjYAAAAJ:iMbXGt5dmAEC: + citations: 0 + title: "Proceedings of the Second Marcel Grossmann Meeting on General Relativity: Organized and Held at the Internat. Centre for Theoret. Physics, Trieste, 5-11 July, 1979: Held in \u2026" + year: '1982' + qc6CJjYAAAAJ:iRaVAuoZnuIC: + citations: 17 + title: Geometria no euclidea y fisica + year: '1926' + qc6CJjYAAAAJ:i_7YvbSbtFEC: + citations: 8747 + title: "Berichtigung zu meiner Arbeit:\u201EEine neue Bestimmung der Molek\xFCldimensionen\u201D \uFE01" + year: '2006' + qc6CJjYAAAAJ:ifIdVpG6JtcC: + citations: 15 + title: On the" Cosmologic Problem" + year: '1945' + qc6CJjYAAAAJ:in81wS_EFI4C: + citations: 0 + title: Relativites restreinte et generale Relativite generale, cosmologie et theories unitaires + year: '1994' + qc6CJjYAAAAJ:inmFHauC9wsC: + citations: 241 + title: Statistische Untersuchung der Bewegung eines Resonators in einem Strahlungsfeld + year: '1910' + qc6CJjYAAAAJ:iomT83CKXisC: + citations: 0 + title: "La th\xE9orie de la relativit\xE9 d'Einstein et la dialectique." + year: Unknown Year + qc6CJjYAAAAJ:isC4tDSrTZIC: + citations: 3873 + title: "\xDCber Gravitationswellen" + year: '1918' + qc6CJjYAAAAJ:it4f3qIuXWYC: + citations: 13 + title: "Principios de f\xEDsica te\xF3rica" + year: '1983' + qc6CJjYAAAAJ:j2GxDk2JBlYC: + citations: 12 + title: Correspondance avec Michele Besso + year: '1979' + qc6CJjYAAAAJ:j3f4tGmQtD8C: + citations: 116 + title: Principles of research + year: '1954' + qc6CJjYAAAAJ:j5aT6aphRxQC: + citations: 178 + title: "Zum gegenw\xE4rtigen Stande des Gravitations-problems" + year: '1914' + qc6CJjYAAAAJ:j8SEvjWlNXcC: + citations: 183 + title: Letters on absolute parallelism + year: '1979' + qc6CJjYAAAAJ:j8pvxH-kN2QC: + citations: 52 + title: "Notiz zu E. Schr\xF6dingers Arbeit" + year: '1918' + qc6CJjYAAAAJ:jEJjQKk8aPQC: + citations: 0 + title: 'Albert Einstein] to Felix Klein: Letter, 27 Apr 1918' + year: Unknown Year + qc6CJjYAAAAJ:jKT558fuBk8C: + citations: 6 + title: Antwort auf eine Bemerkung von W. Anderson + year: '1924' + qc6CJjYAAAAJ:jPVjDSAV6m0C: + citations: 19 + title: Darstellung der Semi-Vektoren Als Gewohnliche Vektoren von Besonderem Differentiations Charakter + year: '1934' + qc6CJjYAAAAJ:jhmUvTrEinIC: + citations: 9 + title: 'Helle Zeit-dunkle Zeit: In memoriam Albert Einstein' + year: '1956' + qc6CJjYAAAAJ:jjenCjXDw2QC: + citations: 0 + title: My faith + year: Unknown Year + qc6CJjYAAAAJ:jmwITWCuk8IC: + citations: 14 + title: Einstein on the atomic bomb + year: '1945' + qc6CJjYAAAAJ:jtusTj6o6osC: + citations: 0 + title: A memorial to PAM Dirac + year: '1990' + qc6CJjYAAAAJ:k4O5U3vRA4YC: + citations: 5500 + title: The special and general theory + year: '1920' + qc6CJjYAAAAJ:k6nH7jlkaTkC: + citations: 0 + title: The Einstein Centennial + year: '1982' + qc6CJjYAAAAJ:kF4WlwDc9qcC: + citations: 42 + title: Hedwig und Max Born + year: '1916' + qc6CJjYAAAAJ:kFzFP8IdBVAC: + citations: 380 + title: Einstein's essays in science + year: '2009' + qc6CJjYAAAAJ:kGbpvR7Ecy8C: + citations: 40 + title: Bivector fields II + year: '1944' + qc6CJjYAAAAJ:kMrClmKSQGwC: + citations: 251 + title: "Briefwechsel 1916\xB11955 von Albert Einstein und Hedwig und Max Born, Kommentiert von Max Born" + year: '1969' + qc6CJjYAAAAJ:kNdYIx-mwKoC: + citations: 494 + title: Sidelights on relativity + year: '2009' + qc6CJjYAAAAJ:kO05sadLmrgC: + citations: 69 + title: "Bemerkungen zu der Notiz von Hrn. Paul Ehrenfest:\u201D \uFE01Die Translation deformierbarer Elektronen und der Fl\xE4chensatz \u201E" + year: '1907' + qc6CJjYAAAAJ:kPzzr9KoCG0C: + citations: 0 + title: "L\u2019agopuntura in campo oncologico. Riflessioni ed esperienze dell\u2019ultimo decennio." + year: Unknown Year + qc6CJjYAAAAJ:k_IJM867U9cC: + citations: 119 + title: "Relativit\xE4tstheorie in mathematischer Behandlung" + year: '1925' + qc6CJjYAAAAJ:kbDB7uaqCfAC: + citations: 0 + title: "Albert Einstein] to Walter D\xE4llenbach: Letter, after 15 Feb 1917" + year: Unknown Year + qc6CJjYAAAAJ:kqeZabM7ilsC: + citations: 4022 + title: Preuss, Sitzungsber + year: '1915' + qc6CJjYAAAAJ:l0_JBNIuc60C: + citations: 54 + title: Quoted in + year: '1990' + qc6CJjYAAAAJ:l1jknz_x7mgC: + citations: 0 + title: Court Expert Opinion in the Matter of Signal Co. vs. Atlas Works, ca. 3 Dec 1921 + year: Unknown Year + qc6CJjYAAAAJ:l6Q3WhenKVUC: + citations: 578 + title: Geometrie und erfahrung + year: '1921' + qc6CJjYAAAAJ:l7t_Zn2s7bgC: + citations: 628 + title: Ether and the Theory of Relativity + year: '2007' + qc6CJjYAAAAJ:lAj_JhtUatoC: + citations: 0 + title: 'Albert Einstein] to Friedrich Adler: Letter, 4 Aug 1918' + year: Unknown Year + qc6CJjYAAAAJ:lAvqOWfki2wC: + citations: 0 + title: Sitzungsber. Preus. Akad. Wiss. Berlin (Math. Phys.) 778 (1915) + year: '1915' + qc6CJjYAAAAJ:lCh-sgrp-YMC: + citations: 0 + title: The collecteds of albert einstein v 9 the berlin years correspondence january 1919-april 1920 english translation (paperback) + year: '2004' + qc6CJjYAAAAJ:lEqHes_HPG0C: + citations: 761 + title: 'The principle of relativity: a collection of original memoirs on the special and general theory of relativity' + year: '1923' + qc6CJjYAAAAJ:lIaPce-xyHYC: + citations: 0 + title: "Privatgutachten zu dem Einspruch gegen die Patentanmeldung G43359 der Gesellschaft f\xFCr nautische Instrumente auf Grund des Pantentes 241637, 16 Jul 1918" + year: Unknown Year + qc6CJjYAAAAJ:lLDkS9sB7dAC: + citations: 36 + title: "Grundgedanken und Probleme der Relativit\xE4tstheorie" + year: '1923' + qc6CJjYAAAAJ:lLPirIASiZEC: + citations: 826 + title: "The Collected Papers of Albert Einstein, Volume 15 (Translation Supplement): The Berlin Years: Writings & Correspondence, June 1925\u2013May 1927" + year: '2018' + qc6CJjYAAAAJ:lOG7zRu2uA8C: + citations: 47 + title: The foundations of general relativity theory + year: '1973' + qc6CJjYAAAAJ:lPNvfOEJVFUC: + citations: 17 + title: "Die {\\ it Planck} sche Theorie der Strahlung und die Theorie der spezifischen W\xE4rme.(German)" + year: Unknown Year + qc6CJjYAAAAJ:lR2ECBI0YV4C: + citations: 121 + title: Quantentheoretische Bemerkungen zum Experiment von Stern und Gerlach + year: '1922' + qc6CJjYAAAAJ:lVu93_cgYy4C: + citations: 0 + title: OPERATIONALISM AND FUNDAMENTAL MODELS OF PHYSICS + year: '1983' + qc6CJjYAAAAJ:lX_RDcPAamoC: + citations: 4 + title: Foreword to Concepts of Space, by Max Jammer + year: '1954' + qc6CJjYAAAAJ:ldfaerwXgEUC: + citations: 43 + title: Algebraic properties of the field in the relativistic theory of the asymmetric field + year: '1954' + qc6CJjYAAAAJ:lms347EBdh4C: + citations: 15 + title: Verhandl. deut. physik + year: '1915' + qc6CJjYAAAAJ:m1cs02wJCiwC: + citations: 0 + title: "Hilbert et le probl\xE8me de covariance dans les \xE9quations de la gravitation." + year: Unknown Year + qc6CJjYAAAAJ:mB3voiENLucC: + citations: 146 + title: A new form of the general relativistic field equations + year: '1955' + qc6CJjYAAAAJ:mN77zE6YZBUC: + citations: 683 + title: Ueber spezielle und allgemeine Relativitaetstheorie, 127 + year: '1969' + qc6CJjYAAAAJ:mNm_27jwclsC: + citations: 13 + title: Open Letter to the General Assembly of the United Nations + year: '1947' + qc6CJjYAAAAJ:mSXQG6lSlFkC: + citations: 0 + title: 'Albert Einstein] to Wander and Geertruida de Haas: Letter, ca. 10 May 1915' + year: Unknown Year + qc6CJjYAAAAJ:mSnHxa73OtAC: + citations: 0 + title: 'The collected papers of Albert Einstein. Vol. 1, The early years: 1879-1902:[English translation]' + year: Unknown Year + qc6CJjYAAAAJ:mVC4hKzE2FoC: + citations: 12 + title: "Berichtigung zu meiner Arbeit:\u201EDie Plancksche Theorie der Strahlung etc.\u201D \uFE01" + year: '1907' + qc6CJjYAAAAJ:mZB2-lCpWbQC: + citations: 10 + title: 'Albert Einstein] to Max Born: Letter, 27 Feb 1916' + year: Unknown Year + qc6CJjYAAAAJ:maZDTaKrznsC: + citations: 116 + title: The Bianchi identities in the generalized theory of gravitation + year: '1950' + qc6CJjYAAAAJ:mdGv78FIKkEC: + citations: 0 + title: "UN GIORNO LE MACCHINE RIUSCIRANNO A RISOLVERE TUTTI I PROBLEMI, MA MAI NESSUNA DI ESSE POTR\xC0 PORNE UNO\u2026" + year: Unknown Year + qc6CJjYAAAAJ:mmBnJtEBTSAC: + citations: 14 + title: Albert Einstein] to Michele Besso:[A second] letter, 21 Jul 1916 + year: Unknown Year + qc6CJjYAAAAJ:mnAcAzq93VMC: + citations: 117 + title: Riemannian Geometry with Maintaining the Notion of distant parallelism + year: '1928' + qc6CJjYAAAAJ:mpaOjDK6XBIC: + citations: 3 + title: Mossbauer Effect + year: '1958' + qc6CJjYAAAAJ:mqGkWRiPAHEC: + citations: 0 + title: "Albert Einstein] to Walther Sch\xFCcking: Letter, 22 Oct 1915" + year: Unknown Year + qc6CJjYAAAAJ:n0_S8QYMK-AC: + citations: 0 + title: "L'article d'Einstein\" Remarques th\xE9oriques sur la superconductivit\xE9 des m\xE9taux\"." + year: Unknown Year + qc6CJjYAAAAJ:n1qY4L4uFdgC: + citations: 792 + title: 'The collected papers of Albert Einstein. Vol. 12, The Berlin years: correspondence, January-December 1921' + year: Unknown Year + qc6CJjYAAAAJ:n35PH7pn8T4C: + citations: 53 + title: "Grundgedanken und Methoden der Relativit\xE4tstheorie, in ihrer Entwicklung dargestellt" + year: '1920' + qc6CJjYAAAAJ:n94QCav8jycC: + citations: 12 + title: From the philosophy of Bertrand Russell + year: '1944' + qc6CJjYAAAAJ:nFloTcPoiwMC: + citations: 0 + title: "R\xF4le du principe d'\xE9quivalence et apparition de la th\xE9orie g\xE9n\xE9rale de la relativit\xE9." + year: Unknown Year + qc6CJjYAAAAJ:nOiSByfp82kC: + citations: 39 + title: "Systematische Untersuchung \xFCber kompatible Feldgleichungen, welche in einem Riemannschen Raume mit Fernparallelismus gesetzt werden k\xF6nnen" + year: '1931' + qc6CJjYAAAAJ:nU66GSXDKhoC: + citations: 29 + title: Elementare theorie der wasserwellen und des fluges + year: '1916' + qc6CJjYAAAAJ:nZtlP1Cc3DIC: + citations: 0 + title: Einstein und die Interviewer, 10 Aug 1921 + year: Unknown Year + qc6CJjYAAAAJ:nazVBdFzvK0C: + citations: 172 + title: Einstein on Peace, ed. Otto Nathan and Heinz Norden + year: '1960' + qc6CJjYAAAAJ:njp6nI0QjqAC: + citations: 359 + title: "\xDCber die Entwickelung unserer Anschauungen \xFCber das Wesen und die Konstitution der Strahlung" + year: '1909' + qc6CJjYAAAAJ:nlKf13ul9_IC: + citations: 3 + title: "Pol\xEDtica y pacifismo" + year: '1960' + qc6CJjYAAAAJ:nlmsuG0oqtYC: + citations: 0 + title: APPLICATION OF STOCHASTIC DIFFERENTIAL EQUATIONS TO THE DESCRIPTION CF TURBULENT DIFFUSION + year: '1978' + qc6CJjYAAAAJ:nmIsvVfQd4cC: + citations: 21 + title: Investigations on the Theory of Non-Uniform Gases + year: '1956' + qc6CJjYAAAAJ:nrtMV_XWKgEC: + citations: 39 + title: Os fundamentos da teoria da relatividade geral + year: '1916' + qc6CJjYAAAAJ:ntg98fmFLVcC: + citations: 408 + title: The elementary theory of the Brownian motion + year: '1908' + qc6CJjYAAAAJ:nvAonm6-wpUC: + citations: 0 + title: "Neue Zugangswege zur Entw\xF6hnungs-behandlung in Sachsen, Sachsen-Anhalt und Th\xFCringen" + year: Unknown Year + qc6CJjYAAAAJ:nwfoItMF7hMC: + citations: 145 + title: "Teor\u0131a cu\xE1ntica de gases ideales monoat\xF3micos, Sitz" + year: '1924' + qc6CJjYAAAAJ:o4Qvs5Y5TLQC: + citations: 182 + title: The Early Years 1879-1902 + year: '1987' + qc6CJjYAAAAJ:o9ULDYDKYbIC: + citations: 36 + title: "Bemerkung zu Herrn Schr\xF6dingers Notiz" + year: '1918' + qc6CJjYAAAAJ:oAywNP-vUhwC: + citations: 37 + title: Eine neue formale Deutung der Maxwellschen Feldgleichungen der Elektrodynamik + year: '1916' + qc6CJjYAAAAJ:oFKsPyNwwpYC: + citations: 85 + title: "\xDCber die M\xF6glichkeit einer neuen Pr\xFCfung des Relativit\xE4tsprinzips" + year: '2006' + qc6CJjYAAAAJ:oFWWKr2Zb18C: + citations: 150 + title: On the ether + year: '1991' + qc6CJjYAAAAJ:oJZlKik0E8QC: + citations: 11 + title: Albert Einstein + year: '1999' + qc6CJjYAAAAJ:oQQVFBP0nzwC: + citations: 5 + title: "Einstein und Ulm: Festakt, Sch\xFClerwettbewerb und Ausstellung zum 100. Geburtstag von Albert Einstein" + year: '1979' + qc6CJjYAAAAJ:oR5SthnA400C: + citations: 4 + title: 'Le pouvoir nu: propos sur la guerre et la paix, 1914-1955' + year: '1991' + qc6CJjYAAAAJ:oYLFIHfuHKwC: + citations: 238 + title: "Zum kosmologischen Problem der allgemeinen Relativit\xE4tstheorie" + year: '1931' + qc6CJjYAAAAJ:oea97a5D_h0C: + citations: 4 + title: "\xDCber den gegenw\xE4rtigen Stand der allgemeinen Relativit\xE4tsteorie" + year: '1930' + qc6CJjYAAAAJ:ojlX30-wUrgC: + citations: 194 + title: Religion and science + year: '1930' + qc6CJjYAAAAJ:oldoQiaHq2UC: + citations: 124 + title: "Einheitliche Theorie von Gravitation und Elektrizit\xE4t. Zweite Abhandlung" + year: '2006' + qc6CJjYAAAAJ:oqD4_j7ulsYC: + citations: 19859 + title: On the movement of small particles suspended in stationary liquids required by the molecular-kinetic theory of heat + year: '1905' + qc6CJjYAAAAJ:osi8XriVlOYC: + citations: 0 + title: 'Albert Einstein] to Wander and Geertruida de Haas: Letter, 6 Jul 1915' + year: Unknown Year + qc6CJjYAAAAJ:oursBaop5wYC: + citations: 1509 + title: Zur theorie der brownschen bewegung + year: '1906' + qc6CJjYAAAAJ:oy0z8GdgWhYC: + citations: 0 + title: 'On the Nature of Spirit: Masculinity, Femininity, and Human Identity' + year: Unknown Year + qc6CJjYAAAAJ:oynPyU19kbsC: + citations: 69 + title: "Berichtigungen zu der Arbeit:\" \xDCber das Relativit\xE4tsprinzip und die aus demselben gezogenen Folgerungen\"" + year: '1908' + qc6CJjYAAAAJ:p2vkXumR6kMC: + citations: 4 + title: Verlandlungen der deutchen physikalischen Gesellschaft + year: '1917' + qc6CJjYAAAAJ:p6f6DfXMsGMC: + citations: 0 + title: "Resultados de la terapia floral en el tratamiento del brote de agudizaci\xF3n de la psoriasis" + year: Unknown Year + qc6CJjYAAAAJ:p7qoFRH4VUUC: + citations: 5 + title: 'Albert Einstein] to Moritz Schlick: Letter, 14 Dec 1915' + year: Unknown Year + qc6CJjYAAAAJ:p866XJ6hu_8C: + citations: 8 + title: B. Ho mann and L. Infeld + year: '1938' + qc6CJjYAAAAJ:p9YawgimX9oC: + citations: 38 + title: Albert Einstein und die Schweiz + year: '1952' + qc6CJjYAAAAJ:pGq6TLPqxssC: + citations: 0 + title: 'Albert Einstein] to Paul Hertz: Letter, 9 Oct 1915' + year: Unknown Year + qc6CJjYAAAAJ:pOP5Rf-i_loC: + citations: 0 + title: Non-euclidean geometry and physics (1926) + year: '2005' + qc6CJjYAAAAJ:pRWBApOjXDcC: + citations: 72 + title: "Untersuchungen \xFCber die Theorie der Brownschen Bewegung" + year: '1997' + qc6CJjYAAAAJ:pUxgyZctzPYC: + citations: 65 + title: "Prinzipielles zur verallgemeinerten Relativit\xE4tstheorie und Gravitationstheorie" + year: '1914' + qc6CJjYAAAAJ:pa8xeX_DvI4C: + citations: 23 + title: B. Podolsky & N. Rosen, 1935 + year: Unknown Year + qc6CJjYAAAAJ:polMJLZb0X8C: + citations: 0 + title: 'Albert Einstein] to Erwin Freundlich: Letter, between 1 and 25 Mar 1915' + year: Unknown Year + qc6CJjYAAAAJ:prKdS1S5QkMC: + citations: 0 + title: Creator and Rebel + year: '1972' + qc6CJjYAAAAJ:prvsfHNhuEoC: + citations: 0 + title: 'Albert Einstein] to David Hilbert: Letter, 18 Nov 1915' + year: Unknown Year + qc6CJjYAAAAJ:pxXbYLTb8EgC: + citations: 2 + title: Selected passages on Machian ideas + year: '1995' + qc6CJjYAAAAJ:pzedKLaGEyUC: + citations: 0 + title: THE ANTHROPIC PRINCIPLE IN COSMOLOGY AND IN BIOLOGY + year: Unknown Year + qc6CJjYAAAAJ:q-jS9JxWzv0C: + citations: 0 + title: What is the Responsibility of Scientists in War? + year: Unknown Year + qc6CJjYAAAAJ:q1ZQJjUA47MC: + citations: 233 + title: On the motion, required by the molecular-kinetic theory of heat, of particles suspended in a fluid at rest + year: '1905' + qc6CJjYAAAAJ:q2Dn1KgioksC: + citations: 0 + title: 'Albert Einstein] to Paul Ehrenfest: Letter, before 10 Apr 1914' + year: Unknown Year + qc6CJjYAAAAJ:q2HS4OCVtYIC: + citations: 1 + title: "Kurze Skizze zur Entwicklung der Relativit\xE4tstheorie" + year: Unknown Year + qc6CJjYAAAAJ:q3SxJD15z-gC: + citations: 0 + title: 'Albert Einstein] to Tullio Levi-Civita: Letter, 2 Apr 1915' + year: Unknown Year + qc6CJjYAAAAJ:q3oQSFYPqjQC: + citations: 40 + title: "Quatre conf\xE9rences sur la th\xE9orie de la relativit\xE9 faites \xE0 l'Universit\xE9 de Princeton" + year: '2005' + qc6CJjYAAAAJ:qCpRzq7zkD8C: + citations: 2134 + title: "Zur allgemeinen Relativit\xE4tstheorie" + year: '1915' + qc6CJjYAAAAJ:qPeb-qHga9sC: + citations: 309 + title: "Auf die Riemann-Metrik und den Fern-Parallelismus gegr\xFCndete einheitliche Feldtheorie" + year: '1930' + qc6CJjYAAAAJ:qbqt7gslDFUC: + citations: 0 + title: The manuscript of Einstein's" Zur einheitlichen Feld-Theorie". + year: Unknown Year + qc6CJjYAAAAJ:qdR3duxP4mUC: + citations: 0 + title: "En busca del eslab\xF3n perdido entre educaci\xF3n y desarrollo: desaf\xEDos y retos para la universidad en Am\xE9rica Latina y el Caribe" + year: Unknown Year + qc6CJjYAAAAJ:qjMakFHDy7sC: + citations: 3177 + title: On the electrodynamics of moving bodies + year: '1905' + qc6CJjYAAAAJ:qsWQJNntlusC: + citations: 3171 + title: Ideas and opinions + year: '1995' + qc6CJjYAAAAJ:quBVm8e4N6QC: + citations: 62 + title: "Zu Kaluzas Theorie des Zusammenhanges von Gravitation und Elektrizit\xE4t. Zweite Mitteilung" + year: '2006' + qc6CJjYAAAAJ:qxL8FJ1GzNcC: + citations: 602 + title: Geometrie und erfahrung + year: '1921' + qc6CJjYAAAAJ:qyhmnyLat1gC: + citations: 27493 + title: Can quantum-mechanical description of physical reality be considered complete? + year: '1935' + qc6CJjYAAAAJ:qzuIxkxWBNsC: + citations: 0 + title: 'Albert Einstein] to Edgar Meyer: Letter, 4 Nov 1918' + year: Unknown Year + qc6CJjYAAAAJ:r-XlWH_wwbwC: + citations: 9 + title: La questione del metodo + year: '1954' + qc6CJjYAAAAJ:r0BpntZqJG4C: + citations: 198 + title: On the non-existence of regular stationary solutions of relativistic field equations + year: '1943' + qc6CJjYAAAAJ:r0s_y6AIs4IC: + citations: 1 + title: Waarom oorlog? + year: '1986' + qc6CJjYAAAAJ:r4zddjZt6C4C: + citations: 0 + title: 'Albert Einstein] to Paul Ehrenfest: Letter, 25 May 1914' + year: Unknown Year + qc6CJjYAAAAJ:r7QigD7TRWAC: + citations: 12 + title: 'Scienza e vita: lettere 1916-1955' + year: '1973' + qc6CJjYAAAAJ:r8lgQMkXaCEC: + citations: 0 + title: Oorlog als ziekte. Met een voorw. van Albert Einstein. Naar de Nederlandse vertaling bewerkt door C. van Emde Boas + year: '1938' + qc6CJjYAAAAJ:rCzfLUpcSPoC: + citations: 467 + title: "A evolu\xE7\xE3o da f\xEDsica: o desenvolvimento das ideias desde os primitivos conceitos at\xE9 \xE0 Relatividade e aos Quanta" + year: '1939' + qc6CJjYAAAAJ:rFyVMFCKTwsC: + citations: 334 + title: Elementare Theorie der Brownschen) Bewegung + year: '1908' + qc6CJjYAAAAJ:rKOGDx9nJ1EC: + citations: 3 + title: "Gelegentliches: Zum f\xFCnfzigsten Geburtstag 14. M\xE4rz 1929 dargebracht von der Soncino-Gesellschaft der Freunde des J\xFCdischen Buches zu Berlin" + year: '1929' + qc6CJjYAAAAJ:rPbfW60zdgkC: + citations: 1174 + title: Physics and reality + year: '1936' + qc6CJjYAAAAJ:rQcm2j6_ZE8C: + citations: 21 + title: Max Planck als Forscher + year: '1913' + qc6CJjYAAAAJ:rUiCm8s56TIC: + citations: 7 + title: A new analysis of molecule dimensions + year: '1968' + qc6CJjYAAAAJ:rWqKpwLRvsIC: + citations: 2792 + title: Die feldgleichungen der gravitation + year: Unknown Year + qc6CJjYAAAAJ:rbgNTKsR3fAC: + citations: 0 + title: The Absence of Negative Gravitational Mass and Related Problems + year: Unknown Year + qc6CJjYAAAAJ:rc0DTgEpx5oC: + citations: 0 + title: "Einheitliche Feldtheorie von Gravitation und Elektrizit\xE4t.(German)" + year: Unknown Year + qc6CJjYAAAAJ:rjBKtydo3wgC: + citations: 39 + title: "\xBF Por qu\xE9 socialismo?" + year: '2001' + qc6CJjYAAAAJ:rp474-M6Y4oC: + citations: 16 + title: "Einstein sagt: Zitate, Einf\xE4lle, Gedanken" + year: '1999' + qc6CJjYAAAAJ:rq4rw-O2q6QC: + citations: 0 + title: 'The anthropomorphized product shelf: Symmetric multimodal human-environment interaction' + year: '2006' + qc6CJjYAAAAJ:rr29yNp9FasC: + citations: 23 + title: "\xDCber ein den Elementarproze\xDF der Lichtemission betreffendes Experiment" + year: '2006' + qc6CJjYAAAAJ:rsrKZ8bNWIsC: + citations: 0 + title: 'Albert Einstein] to Heinrich Zangger: Letter, between 24 Jul and 7 Aug 1915' + year: Unknown Year + qc6CJjYAAAAJ:rt-opDMcQ_cC: + citations: 0 + title: 'PROBLEM GAMBLING & AOD: IMPULSIVELY SEPARATED?' + year: Unknown Year + qc6CJjYAAAAJ:rv4tAfkFLVgC: + citations: 0 + title: "O Papel da Epistemologia em uma Disciplina e Evolu\xE7\xE3o dos Conceitos da F\xEDsica\xB7" + year: Unknown Year + qc6CJjYAAAAJ:rywEMSoAiS0C: + citations: 0 + title: "Histoire de la d\xE9couverte des \xE9quations de la gravitation (Einstein et Hilbert)." + year: Unknown Year + qc6CJjYAAAAJ:rzkGdFpNPO0C: + citations: 0 + title: 'Prospettive relativistiche: dell''etere e della geometria' + year: '1922' + qc6CJjYAAAAJ:s1ouQE5r0WUC: + citations: 17 + title: Mein Glaubensbekenntnis + year: '1930' + qc6CJjYAAAAJ:s2G-WRnXBicC: + citations: 2 + title: My Views + year: '1967' + qc6CJjYAAAAJ:s9piBQ-TX4wC: + citations: 0 + title: "La th\xE9orie corpusculaire des rayons X et la structure des cristaux." + year: Unknown Year + qc6CJjYAAAAJ:sAujV351FBYC: + citations: 4822 + title: The meaning of relativity + year: '1950' + qc6CJjYAAAAJ:sIDMtVbdO0QC: + citations: 20 + title: "\xDCber die gegenw\xE4rtige Krise der theoretischen Physik" + year: '1922' + qc6CJjYAAAAJ:sJK75vZXtG0C: + citations: 207 + title: Mis ideas y opiniones + year: '2011' + qc6CJjYAAAAJ:sNmaIFBj_lkC: + citations: 7 + title: Compton Effect + year: '1966' + qc6CJjYAAAAJ:sYWh8IhQ1GMC: + citations: 13 + title: Letter to Michele Besso's Family + year: '1989' + qc6CJjYAAAAJ:scjTk0LcRdsC: + citations: 0 + title: "Nous ne pouvons pas r\xE9soudre nos probl\xE8mes avec le m\xEAme mode de pens\xE9e que nous utilisions quand nous les avons cr\xE9\xE9s." + year: Unknown Year + qc6CJjYAAAAJ:seU1ZbiIO-YC: + citations: 0 + title: The Principles of humanism + year: '1974' + qc6CJjYAAAAJ:sgVRHlApM4oC: + citations: 67 + title: The laws of science and the laws of ethics + year: '1950' + qc6CJjYAAAAJ:sgsej9ZJWHMC: + citations: 4043 + title: "N\xE4herungsweise Integration der Feldgleichungen der Gravitation" + year: '1916' + qc6CJjYAAAAJ:siTy-4AL0AwC: + citations: 0 + title: "O conhecimento cient\xEDfico no nosso contexto social e hist\xF3rico: um ano de realiza\xE7\xF5es" + year: '2008' + qc6CJjYAAAAJ:sk-5v2XeZBgC: + citations: 21 + title: Theoretische Bemerkungen zur Supraleitung der Metalle + year: '1922' + qc6CJjYAAAAJ:spwacExez6wC: + citations: 0 + title: "Meine Antwort. \xFCber die anti-relativit\xE4tstheoretische GmbH Berliner Tageblatt, 27 Aug 1920" + year: Unknown Year + qc6CJjYAAAAJ:t1niNHmIXQYC: + citations: 0 + title: Religion, Spirituality, and Stress + year: Unknown Year + qc6CJjYAAAAJ:t3sMychFT9UC: + citations: 0 + title: "Divulgaci\xF3n de la Ciencia para Ni\xF1os a Trav\xE9s de Revistas Mexicanas: Aproximaci\xF3n a Partir de la Construcci\xF3n del Discurso." + year: Unknown Year + qc6CJjYAAAAJ:t6hKUfryX1MC: + citations: 0 + title: Uproar in the Lecture Hall, 13 Feb 1920 + year: Unknown Year + qc6CJjYAAAAJ:t6usbXjVLHcC: + citations: 135 + title: The human side + year: '1979' + qc6CJjYAAAAJ:t7izwRedFcYC: + citations: 4 + title: Albert Einstein, il lato humano + year: '1980' + qc6CJjYAAAAJ:tHxcpc5o5bgC: + citations: 10 + title: A. Einstein autobiographical notes + year: '1970' + qc6CJjYAAAAJ:tVzLobxzA7YC: + citations: 7 + title: "Geografia, ecologia da paisagem e teledetec\xE7\xE3o, enquadramento\u2013contextualiza\xE7\xE3o" + year: '2004' + qc6CJjYAAAAJ:tWiuw1KVSQEC: + citations: 93 + title: "La Th\xE9orie de la Relativit\xE9" + year: '1935' + qc6CJjYAAAAJ:tYdqGa2HnWcC: + citations: 0 + title: 'Albert Einstein] to Arnold Sommerfeld: Letter, 3 Aug 1916' + year: Unknown Year + qc6CJjYAAAAJ:tai-Ft5GzhwC: + citations: 0 + title: Storia del concetto di spazio + year: '1966' + qc6CJjYAAAAJ:tgTmbKTkO1IC: + citations: 16 + title: "Nachtrag zu meiner Arbeit:\u201EThermodynamische Begr\xFCndung des photochemischen Aquivalentgesetzes\u201D \uFE01" + year: '1912' + qc6CJjYAAAAJ:tkaPQYYpVKoC: + citations: 16 + title: Physik als Abenteuer der Erkenntnis + year: '1938' + qc6CJjYAAAAJ:tltQ_bo2KloC: + citations: 19 + title: My Credo + year: '1986' + qc6CJjYAAAAJ:tntj4plCNvAC: + citations: 123 + title: Relativity and the Problem of Space + year: '1954' + qc6CJjYAAAAJ:tzPJaSocouwC: + citations: 29 + title: Fund-raising telegram for the Emergency Committee of Atomic Scientists, 23 May 1946 + year: '1960' + qc6CJjYAAAAJ:u0Mu_IsstPMC: + citations: 28 + title: "Die Kompatibilit\xE4t der Feldgleichungen in der einheitlichen Feldtheorie" + year: '1930' + qc6CJjYAAAAJ:uAPFzskPt0AC: + citations: 15 + title: "equations of motion\uFB01 one therefore could not doubt that the laws of nature are" + year: '1907' + qc6CJjYAAAAJ:uCYQzKCmtZwC: + citations: 1241 + title: Out of my later years + year: '1950' + qc6CJjYAAAAJ:uH1VZYVfkoQC: + citations: 10 + title: 'Albert Einstein] to Max Born: Letter, 24 Jun 1918' + year: Unknown Year + qc6CJjYAAAAJ:uK1dVpBkok0C: + citations: 0 + title: UNCERTAINTIES AND HOPES + year: '1993' + qc6CJjYAAAAJ:uQrt9rju91QC: + citations: 0 + title: 'Albert Einstein] to Paul Hertz: Letter, between 14 Aug and 4 Nov 1915' + year: Unknown Year + qc6CJjYAAAAJ:uXirmJe02n4C: + citations: 84 + title: "Berichtigungen zu der Arbeit:\" \xDCber das Relativit\xE4tsprinzip und die aus demselben gezogenen Folgerungen\", 29 Feb 1908" + year: Unknown Year + qc6CJjYAAAAJ:u_mOZUIutIEC: + citations: 35 + title: "\xDCber eine Methode zur Bestimmung des Verh\xE4ltnisses der transversalen und longitudinalen Masse des Elektrons" + year: '1906' + qc6CJjYAAAAJ:ufKn5pxu7C0C: + citations: 28 + title: "Bemerkung zu meiner Arbeit \u201CZur allgemeinen Relativit\xE4tstheorie\u201D" + year: '2006' + qc6CJjYAAAAJ:ufrVoPGSRksC: + citations: 637 + title: The influence of the expansion of space on the gravitation fields surrounding the individual stars + year: '1945' + qc6CJjYAAAAJ:uh8FjILnQOkC: + citations: 0 + title: "Bemerkungen zu P. Harzers Abhandlung,\" \xDCber die Mitf\xFChrung des Lichtes in Glas und die Aberration\", 18 Jul 1914" + year: Unknown Year + qc6CJjYAAAAJ:ujJXPdh5xs4C: + citations: 0 + title: "Lehrs\xE4tze \xFCber das Weltall: Mit Beweis in Form eines offenen Briefes an Professor Einstein. In einer von Gerhard R\xFChm bearbeiteten Neuauflage" + year: '1965' + qc6CJjYAAAAJ:ult01sCh7k0C: + citations: 313 + title: Wolfgang Pauli + year: '2001' + qc6CJjYAAAAJ:umqufdRvDiIC: + citations: 7 + title: "Einstein \xFCber \u201Ewahre Kultur \u201Cund die Stellung der Geometrie im Wissenschaftssystem" + year: '1979' + qc6CJjYAAAAJ:uoeYKOKFegwC: + citations: 14 + title: Einstein on Humanism + year: '1993' + qc6CJjYAAAAJ:uqZYSrDi9MMC: + citations: 0 + title: Ideas fundamentales y problemas de la teoria de la relatividad + year: '1924' + qc6CJjYAAAAJ:uwWlEQcBbEIC: + citations: 0 + title: 'Albert Einstein] to Felix Klein: Letter, 26 Mar 1917' + year: Unknown Year + qc6CJjYAAAAJ:v-tg9Wi2VGwC: + citations: 0 + title: Overture to the comic opera Don Giovanni, K + year: '1900' + qc6CJjYAAAAJ:vCSeWdjOjw8C: + citations: 14 + title: 'Albert Einstein] to Michele Besso: Letter, 22 Sep 1917' + year: Unknown Year + qc6CJjYAAAAJ:vM5yiaU9oLoC: + citations: 0 + title: 'Albert Einstein] to Hans Albert Einstein: Letter, before 4 Apr 1915' + year: Unknown Year + qc6CJjYAAAAJ:vMcOFpnEpxoC: + citations: 8 + title: Inst. intern. phys + year: '1911' + qc6CJjYAAAAJ:vPKCt-r_nWsC: + citations: 0 + title: Albert Einstein to Heinrich Zangger + year: '2005' + qc6CJjYAAAAJ:vRqMK49ujn8C: + citations: 26 + title: "Fysika jako dobrodru\u017Estv\xED pozn\xE1n\xED" + year: '1958' + qc6CJjYAAAAJ:vV6vV6tmYwMC: + citations: 159 + title: Living philosophies + year: '1979' + qc6CJjYAAAAJ:v_xunPV0uK0C: + citations: 69 + title: On the five-dimensional representation of gravitation and electricity + year: '1941' + qc6CJjYAAAAJ:viPVbuMW504C: + citations: 310 + title: Collected Scientific Works + year: '1965' + qc6CJjYAAAAJ:viTTOddtVMkC: + citations: 0 + title: IDEAS PARA MEDITAR CON CALMA + year: Unknown Year + qc6CJjYAAAAJ:vj8KeYadoLsC: + citations: 63 + title: Diskussion + year: '1920' + qc6CJjYAAAAJ:vjZqxyZ7hS4C: + citations: 15 + title: "Zum gegenw\xE4rtigen Stande des Problems der spezifischen W\xE4rme" + year: '1911' + qc6CJjYAAAAJ:vkz5F8TaVKkC: + citations: 28 + title: 'Albert Einstein, Max Born, Hedwig Born: Correspondance, 1916-1955' + year: '1972' + qc6CJjYAAAAJ:vlECJaBXBlQC: + citations: 0 + title: 'Albert Einstein] to Paul Ehrenfest: Letter, 1 May 1918' + year: Unknown Year + qc6CJjYAAAAJ:vofGIMt6cyEC: + citations: 5 + title: "Zum hundertj\xE4hrigen Gedenktag von Lord Kelvins Geburt. 26. Juni 1824" + year: '1924' + qc6CJjYAAAAJ:vptNTMqK6uYC: + citations: 0 + title: "A educa\xE7\xE3o inclusiva e as transforma\xE7\xF5es dos processos de constru\xE7\xE3o do conhecimento" + year: Unknown Year + qc6CJjYAAAAJ:vq25oHwZT-8C: + citations: 17 + title: "Koniglich Preussische Akademie f\xFCr Wissenschaft 844 (1915);[Links] A. Einstein" + year: '1916' + qc6CJjYAAAAJ:vt8c2csMsvAC: + citations: 1 + title: "Introduction aux th\xE8ories de M. Einstein en vue de leur application a l'astronomie" + year: '1921' + qc6CJjYAAAAJ:vytXtR8tOLIC: + citations: 466 + title: B. preuss + year: '1916' + qc6CJjYAAAAJ:vzY-6mMDyDUC: + citations: 86 + title: 'The Berlin Years, Correspondence 1914-1918: English Translation' + year: '1998' + qc6CJjYAAAAJ:w1G5vK4DiEkC: + citations: 0 + title: 'Albert Einstein] to Gustav Mie: Letter, 8 Feb 1918' + year: Unknown Year + qc6CJjYAAAAJ:w2Gke83ceDMC: + citations: 0 + title: Considerations on electrodynamics, the ether, geometry and relativity + year: '1972' + qc6CJjYAAAAJ:w2UhwfzvF0QC: + citations: 433 + title: On a generalization of Kaluza's theory of electricity + year: '1938' + qc6CJjYAAAAJ:w7CBUyPWg-0C: + citations: 10 + title: Eine ableitung des theorems von Jacobi + year: '1917' + qc6CJjYAAAAJ:wEOyVsangm4C: + citations: 741 + title: Philosopher-Scientist, ed + year: '1970' + qc6CJjYAAAAJ:wGzT3bKASkAC: + citations: 275 + title: "\xDCber die vom Relativit\xE4tsprinzip geforderte Tr\xE4gheit der Energie" + year: '1907' + qc6CJjYAAAAJ:wNvz2w4be3AC: + citations: 0 + title: 'On the Contribution of Intellectuals to International Reconciliation: Letter, after 29 Sep 1920' + year: Unknown Year + qc6CJjYAAAAJ:wTekDMGr9GkC: + citations: 0 + title: Einstein und die Geophysik:(Einstein and geophysics) + year: '2005' + qc6CJjYAAAAJ:wW8w_uPXRNAC: + citations: 1 + title: Statistische Mechanik + year: '1979' + qc6CJjYAAAAJ:wdLM4YbmhYkC: + citations: 0 + title: "La teoria della relativit\xE0" + year: '1987' + qc6CJjYAAAAJ:wgKq3sYidysC: + citations: 517 + title: Concerning an heuristic point of view toward the emission and transformation of light + year: '1965' + qc6CJjYAAAAJ:wkm4DBaukwsC: + citations: 8 + title: "Antwort auf eine Abhandlung M. v. Laues \u201EEin Satz der Wahrscheinlichkeitsrechnung und seine Anwendung auf die Strahlungstheorie\u201D \uFE01" + year: '1915' + qc6CJjYAAAAJ:wlh7PBhwZ8MC: + citations: 14 + title: 'Albert Einstein] to Michele Besso: Letter, 6 Sep 1916' + year: Unknown Year + qc6CJjYAAAAJ:wuD5JclIwkYC: + citations: 225 + title: Science and religion + year: '1940' + qc6CJjYAAAAJ:wy5MF_2MSNEC: + citations: 14 + title: 'Albert Einstein] to Michele Besso: Letter, 9 Jul 1918' + year: Unknown Year + qc6CJjYAAAAJ:xMZGxf1v-3YC: + citations: 0 + title: 'Albert Einstein] to Hans Albert and Eduard Einstein: Letter, 10 Dec 1918' + year: Unknown Year + qc6CJjYAAAAJ:xUT3DyvLuJwC: + citations: 0 + title: 'Albert Einstein] to Arnold Sommerfeld: Letter, 14 Jan 1908' + year: Unknown Year + qc6CJjYAAAAJ:xZ4F5NOCMJ0C: + citations: 0 + title: Why lnformation Technology lnspired but Cannot Deliver Knowledge Management + year: '2004' + qc6CJjYAAAAJ:xii_ZKWM4-0C: + citations: 44 + title: "Bemerkungen zu den P. Hertzschen Arbeiten:\u201E\xDCber die mechanischen Grundlagen der Thermodynamik\u201D \uFE01" + year: '1911' + qc6CJjYAAAAJ:xu-w60CxnpAC: + citations: 0 + title: "Briefe zur Wellenmechanik [von][Erwin] Schr\xF6dinger,[Max] Planck,[ALbert] Einstein und [Hendrik Antoon] Lorentz" + year: '1963' + qc6CJjYAAAAJ:xvKSgulxyWUC: + citations: 6 + title: 'The collected papers of Albert Einstein: writings, 1912-1914. The Swiss years' + year: '1966' + qc6CJjYAAAAJ:xwIxJehhd2UC: + citations: 0 + title: "Albert Einstein] to Rudolf F\xF6rster: Letter, 19 Feb 1918" + year: Unknown Year + qc6CJjYAAAAJ:xyKys1DtkaQC: + citations: 30 + title: Wissenschaftlicher Briefwechsel mit Bohr, Einstein, Heisenberg ua. Bd. 4. 1955-1956 + year: '2001' + qc6CJjYAAAAJ:yCjxvIMm6_oC: + citations: 17 + title: "Nachtr\xE4gliche Antwort auf eine Frage von Herrn Rei\xDFner" + year: '1914' + qc6CJjYAAAAJ:yG6gRY0c4kQC: + citations: 0 + title: 'Albert Einstein] to Gustav Mie: Letter, 29 Dec 1917' + year: Unknown Year + qc6CJjYAAAAJ:yIeBiWEAh44C: + citations: 1309 + title: "\xDCber den Einflu\xDF der Schwerkraft auf die Ausbreitung des Lichtes" + year: '2006' + qc6CJjYAAAAJ:yJjnfzR0HrkC: + citations: 869 + title: Strahlungs-emission und absorption nach der quantentheorie + year: '1916' + qc6CJjYAAAAJ:yKZlB_2wKysC: + citations: 0 + title: 'Albert Einstein] to Paul Ehrenfest: Letter, 4 Sep 1918' + year: Unknown Year + qc6CJjYAAAAJ:yNlG6JgpFqoC: + citations: 237 + title: A generalized theory of gravitation + year: '1948' + qc6CJjYAAAAJ:yNohvu9kXXYC: + citations: 389 + title: Quantentheorie des idealen einatomigen Gases, Sitzber + year: '1924' + qc6CJjYAAAAJ:yS0fcbgecPsC: + citations: 21 + title: Education for independent thought + year: '1952' + qc6CJjYAAAAJ:yXZqsUWzai8C: + citations: 138 + title: "Koniglich Preu\u03B2ische Akademie der Wissenschaften" + year: '1916' + qc6CJjYAAAAJ:yZoBfgUKqwcC: + citations: 45 + title: "\xDCber eine naheliegende Erg\xE4nzung des Fundamentes der allgemeinen Relativit\xE4tstheorie" + year: '1921' + qc6CJjYAAAAJ:ypzvKOdbExQC: + citations: 0 + title: VICTOR J. STENGER + year: '1990' + qc6CJjYAAAAJ:yxAilOxaV9sC: + citations: 0 + title: Le lien entre science et art dans la conception du monde de Einstein. + year: Unknown Year + qc6CJjYAAAAJ:yymuTJNBJz4C: + citations: 0 + title: "Z Einsteinovy Pra\u017Esk\xE9 korespondence" + year: '1962' + qc6CJjYAAAAJ:z2g7kDSNNyoC: + citations: 17 + title: "Eine neue elektrostatische Methode zur Messung kleiner Elektrizit\xE4tsmengen" + year: '1908' + qc6CJjYAAAAJ:zCpYd49hD24C: + citations: 0 + title: "Einstein e la sua relativit\xE0" + year: '1922' + qc6CJjYAAAAJ:zEYdoEEwLqEC: + citations: 11 + title: "Sur les forces pond\xE9romotrices qui agissent sur des conducteurs ferromagn\xE9tiques dispos\xE9s dans un champ magn\xE9tique et parcourus par un courant" + year: '1910' + qc6CJjYAAAAJ:zG6RlwjYRPQC: + citations: 19 + title: Marian v. Smoluchowski + year: '1917' + qc6CJjYAAAAJ:zI9YInTrFVIC: + citations: 0 + title: 'Albert Einstein] to Wander de Haas: Letter, 17 Mar 1915' + year: Unknown Year + qc6CJjYAAAAJ:zLWjf1WUPmwC: + citations: 19 + title: "Les fondements de la th\xE9orie de la relativit\xE9 g\xE9n\xE9rale" + year: '1933' + qc6CJjYAAAAJ:zLla2nKXDtwC: + citations: 0 + title: On the Misery of Children, 7 Oct 1921 + year: Unknown Year + qc6CJjYAAAAJ:zPkyA21Y468C: + citations: 0 + title: Physical Interpretations of Relativity Theory + year: Unknown Year + qc6CJjYAAAAJ:zTJoPluU4X4C: + citations: 0 + title: Nonlinear Model Equations and Variational Principles + year: Unknown Year + qc6CJjYAAAAJ:z_wVstp3MssC: + citations: 24 + title: 'About Zionism: Speeches and Letters by Professor Albert Einstein' + year: '1930' + qc6CJjYAAAAJ:za7pDTvVV8kC: + citations: 16 + title: Zur Theorie der Lichtfortpflanzung in dispergierenden Medien + year: '2006' + qc6CJjYAAAAJ:ziRtHtnO-_kC: + citations: 0 + title: Robert Nathan + year: '1967' + qc6CJjYAAAAJ:ziW8EwMpto0C: + citations: 0 + title: "Albert Einstein] to Rudolf F\xF6rster: Letter, 17 Jan 1918" + year: Unknown Year + qc6CJjYAAAAJ:zxzvZ9-XIW8C: + citations: 73 + title: Albert Einstein, the human side + year: '2013' diff --git a/_data/repositories.yml b/_data/repositories.yml index 5506a3c..81176c3 100644 --- a/_data/repositories.yml +++ b/_data/repositories.yml @@ -1,5 +1,7 @@ github_users: - fguiotte +repo_description_lines_max: 2 + github_repos: - fguiotte/sap diff --git a/_data/socials.yml b/_data/socials.yml new file mode 100644 index 0000000..5e01cef --- /dev/null +++ b/_data/socials.yml @@ -0,0 +1,14 @@ +# this file contains the social media links and usernames of the author +# the socials will be displayed in the order they are defined here +# for more information, please refer to the documentation of jekyll-socials plugin: https://github.com/george-gca/jekyll-socials +cv_pdf: /assets/pdf/example_pdf.pdf # path to your CV PDF file +email: you@example.com # your email address +inspirehep_id: 1010907 # Inspire HEP author ID +rss_icon: true # comment this line to hide the RSS icon +scholar_userid: qc6CJjYAAAAJ # your Google Scholar ID +# wechat_qr: # filename of your wechat qr-code saved as an image (e.g., wechat-qr.png if saved to assets/img/wechat-qr.png) +# whatsapp_number: # your WhatsApp number (full phone number in international format. Omit any zeroes, brackets, or dashes when adding the phone number in international format.) +custom_social: # can be any name here other than the ones already defined in the jekyll-socials plugin + logo: https://www.alberteinstein.com/wp-content/uploads/2024/03/cropped-favicon-192x192.png # can be png, svg, jpg + title: Custom Social + url: https://www.alberteinstein.com/ diff --git a/_includes/audio.liquid b/_includes/audio.liquid new file mode 100644 index 0000000..338e212 --- /dev/null +++ b/_includes/audio.liquid @@ -0,0 +1,30 @@ +
+
diff --git a/_includes/bib_search.liquid b/_includes/bib_search.liquid new file mode 100644 index 0000000..c0ab526 --- /dev/null +++ b/_includes/bib_search.liquid @@ -0,0 +1,4 @@ +{% if site.bib_search %} + + +{% endif %} diff --git a/_includes/calendar.liquid b/_includes/calendar.liquid new file mode 100644 index 0000000..fab192d --- /dev/null +++ b/_includes/calendar.liquid @@ -0,0 +1,25 @@ +{% if include.calendar_id %} +
+

Upcoming Events

+ + + + +
+{% endif %} diff --git a/_includes/citation.liquid b/_includes/citation.liquid new file mode 100644 index 0000000..35bd9e3 --- /dev/null +++ b/_includes/citation.liquid @@ -0,0 +1,26 @@ +
+
+
+ +If you found this useful, please cite this as: + +{% capture citation_quote -%} +> {{ site.last_name }}, {{ site.first_name }}{% if site.middle_name %} {{ site.middle_name }}{% endif %} ({{ page.date | date: "%b %Y" }}). {{ page.title }}. {% if site.title != 'blank' %}{{ site.title }}. {% endif %}{{ site.url }}. +{%- endcapture %} +{{ citation_quote | markdownify }} + +

or as a BibTeX entry:

+ +{% capture citation_code -%} +```bibtex +@article{ {{- site.last_name | downcase }}{{ page.date | date: "%Y" }}{{ page.title | slugify }}, + title = { {{- page.title -}} }, + author = { {{- site.last_name }}, {{ site.first_name }}{% if site.middle_name %} {{ site.middle_name }}{% endif -%}}, + {%- if site.title != 'blank' %}journal = { {{- site.title -}} },{% endif %} + year = { {{- page.date | date: "%Y" -}} }, + month = { {{- page.date | date: "%b" -}} }, + url = { {{- site.url }}{{ page.url -}} } +} +``` +{%- endcapture %} +{{ citation_code | markdownify }} diff --git a/_includes/course_schedule.liquid b/_includes/course_schedule.liquid new file mode 100644 index 0000000..363387b --- /dev/null +++ b/_includes/course_schedule.liquid @@ -0,0 +1,71 @@ +{% assign course = site.teachings | where: 'course_id', include.course_id | first %} + +{% if course %} +
+

{{ course.title }}

+ + {% if course.description %} +
+ {{ course.description | markdownify }} +
+ {% endif %} + + {% if course.instructor %} +

Instructor: {{ course.instructor }}

+ {% endif %} + + {% if course.term %} +

Term: {{ course.term }}

+ {% endif %} + + {% if course.schedule %} + + + + + + + + + + + {% for entry in course.schedule %} + + + + + + + {% endfor %} + +
WeekDateTopicMaterials
{{ entry.week }}{{ entry.date }} + {% if entry.topic %} + {{ entry.topic }} + {% endif %} + {% if entry.description %} +
{{ entry.description | markdownify }}
+ {% endif %} + 		+ {% if entry.materials %} +
    + {% for material in entry.materials %} +
  • + {% if material.url %} + {% if material.url contains '://' %} + {{ material.name }} + {% else %} + {{ material.name }} + {% endif %} + {% else %} + {{ material.name }} + {% endif %} +
    • + {% endfor %} +
+ {% endif %} +
+ {% else %} +

No schedule available for this course.

+ {% endif %} +
+{% endif %} diff --git a/_includes/courses.liquid b/_includes/courses.liquid new file mode 100644 index 0000000..85858d3 --- /dev/null +++ b/_includes/courses.liquid @@ -0,0 +1,37 @@ +{% if site.teachings %} +
+ {% assign courses_by_year = site.teachings | sort: 'year' | reverse | group_by: 'year' %} + + {% for year_group in courses_by_year %} +

{{ year_group.name }}

+
+ {% assign year_courses = year_group.items | sort: 'term' %} + {% for course in year_courses %} +
+

+ {{ course.title }} +

+ +
+ {% if course.term %} + {{ course.term }} + {% endif %} + + {% if course.instructor %} + {{ course.instructor }} + {% endif %} +
+ + {% if course.description %} +
+ {{ course.description | markdownify }} +
+ {% endif %} +
+ {% endfor %} +
+ {% endfor %} +
+{% else %} +

No courses available yet.

+{% endif %} diff --git a/_includes/cv/awards.liquid b/_includes/cv/awards.liquid new file mode 100644 index 0000000..a57cac5 --- /dev/null +++ b/_includes/cv/awards.liquid @@ -0,0 +1,66 @@ +{% comment %} + Unified awards entry renderer for both formats +{% endcomment %} + +
    + {% for entry in entries %} +
  • +
    + {% capture start_date %} + {% if entry.date %}{{ entry.date }}{% endif %} + {% endcapture %} + + {% if start_date != '' %} +
    + + + + + + +
    + + {{- start_date | split: '-' | slice: 0, 1 | join: '' -}} + +
    +
    +
    + {% if entry.url %} +
    + {{ entry.title }} +
    + {% elsif entry.title %} +
    {{ entry.title }}
    + {% endif %} + + {% if entry.awarder %} +
    {{ entry.awarder }}
    + {% endif %} + + {% if entry.summary %} +

    {{ entry.summary | markdownify | remove: '

    ' | remove: '

    ' }}

    + {% endif %} +
    + {% else %} +
    + {% if entry.url %} +
    + {{ entry.title }} +
    + {% elsif entry.title %} +
    {{ entry.title }}
    + {% endif %} + + {% if entry.awarder %} +
    {{ entry.awarder }}
    + {% endif %} + + {% if entry.summary %} +

    {{ entry.summary | markdownify | remove: '

    ' | remove: '

    ' }}

    + {% endif %} +
    + {% endif %} +
    +
    • + {% endfor %} +
diff --git a/_includes/cv/certificates.liquid b/_includes/cv/certificates.liquid new file mode 100644 index 0000000..05613eb --- /dev/null +++ b/_includes/cv/certificates.liquid @@ -0,0 +1,28 @@ +{% comment %} + Unified certificates entry renderer for both formats +{% endcomment %} + +
    + {% for entry in entries %} +
  • + {% if entry.icon %} + + {% endif %} + {% if entry.url %} + {{ entry.name }} + {% else %} + {{ entry.name }} + {% endif %} + + {% if entry.issuer %} + - {{ entry.issuer }} + {% endif %} + + {% if entry.date %} + ({{ entry.date | split: '-' | slice: 0, 1 | join: '' }}) + {% endif %} +
    • + {% endfor %} +
diff --git a/_includes/cv/education.liquid b/_includes/cv/education.liquid new file mode 100644 index 0000000..773e74f --- /dev/null +++ b/_includes/cv/education.liquid @@ -0,0 +1,93 @@ +{% comment %} + Unified education entry renderer for both RenderCV and JSONResume formats + Handles both: + - RenderCV: institution, area, studyType (or degree), start_date, end_date, location, courses, highlights + - JSONResume: institution, area, studyType, startDate, endDate, location, courses, highlights +{% endcomment %} + +
    + {% for entry in entries %} +
  • +
    +
    + {% capture start_date %} + {% if entry.start_date %}{{ entry.start_date }}{% elsif entry.startDate %}{{ entry.startDate }}{% endif %} + {% endcapture %} + {% capture end_date %} + {% if entry.end_date %}{{ entry.end_date }}{% elsif entry.endDate %}{{ entry.endDate }}{% endif %} + {% endcapture %} + + {% if start_date != '' %} + {% comment %} Extract year only from dates like "1933-01-01" or just use "1933" as is {% endcomment %} + {% assign startDate = start_date | split: '-' | first %} + {% assign endDate = end_date | split: '-' | first | default: 'Present' %} + {% assign date = startDate | append: ' - ' | append: endDate %} + {% else %} + {% assign date = null %} + {% endif %} + + + + + + + {% capture location %} + {% if entry.location %}{{ entry.location }}{% endif %} + {% endcapture %} + {% if location != '' %} + + + + {% endif %} + +
    + {% if date %} + {{ date }} + {% endif %} +
    +

    + + {{ location }} +

    +
    +
    +
    + {% capture study_type %} + {% if entry.studyType %}{{ entry.studyType }}{% elsif entry.degree %}{{ entry.degree }}{% endif %} + {% endcapture %} + + {% if entry.url %} +
    + {{ study_type }} +
    + {% elsif study_type != '' %} +
    {{ study_type }}
    + {% endif %} + + {% if entry.institution %} +
    {{ entry.institution }}
    + {% endif %} + + {% if entry.area %} +
    {{ entry.area }}
    + {% endif %} + + {% if entry.courses or entry.highlights %} +
      + {% for item in entry.courses %} +
    • + {{ item }} +
      • + {% endfor %} + {% for item in entry.highlights %} +
    • + {{ item | markdownify | remove: '

      ' | remove: '

      ' }}       +
      • + {% endfor %} +
    + {% endif %} +
    +
    +
    • + {% endfor %} +
diff --git a/_includes/cv/experience.liquid b/_includes/cv/experience.liquid new file mode 100644 index 0000000..515a39b --- /dev/null +++ b/_includes/cv/experience.liquid @@ -0,0 +1,91 @@ +{% comment %} + Unified work/experience entry renderer for both RenderCV and JSONResume formats + Handles both: + - RenderCV: company, position, start_date, end_date, location, url, summary, highlights + - JSONResume: name, position, startDate, endDate, location, url, summary, highlights +{% endcomment %} + +
    + {% for entry in entries %} +
  • +
    +
    + {% capture start_date %} + {% if entry.start_date %}{{ entry.start_date }}{% elsif entry.startDate %}{{ entry.startDate }}{% endif %} + {% endcapture %} + {% capture end_date %} + {% if entry.end_date %}{{ entry.end_date }}{% elsif entry.endDate %}{{ entry.endDate }}{% endif %} + {% endcapture %} + + {% if start_date != '' %} + {% comment %} Extract year only from dates like "1933-01-01" or just use "1933" as is {% endcomment %} + {% assign startDate = start_date | split: '-' | first %} + {% assign endDate = end_date | split: '-' | first | default: 'Present' %} + {% assign date = startDate | append: ' - ' | append: endDate %} + {% else %} + {% assign date = '' %} + {% endif %} + + + + + + + {% capture location %} + {% if entry.location %}{{ entry.location }}{% endif %} + {% endcapture %} + {% if location != '' %} + + + + {% endif %} + +
    + {{ date }} +
    +

    + + {{ location }} +

    +
    +
    +
    + {% capture position_title %} + {% if entry.position %}{{ entry.position }}{% endif %} + {% endcapture %} + + {% if entry.url %} +
    + {{ position_title }} +
    + {% elsif position_title != '' %} +
    {{ position_title }}
    + {% endif %} + + {% capture company_name %} + {% if entry.name %}{{ entry.name }}{% elsif entry.company %}{{ entry.company }}{% elsif entry.organization %}{{ entry.organization }}{% endif %} + {% endcapture %} + {% if company_name != '' %} +
    {{ company_name }}
    + {% endif %} + + {% if entry.summary %} +
    + {{ entry.summary | markdownify | remove: '

    ' | remove: '

    ' }} +
    + {% endif %} + + {% if entry.highlights %} +
      + {% for item in entry.highlights %} +
    • + {{ item | markdownify | remove: '

      ' | remove: '

      ' }}       +
      • + {% endfor %} +
    + {% endif %} +
    +
    +
    • + {% endfor %} +
diff --git a/_includes/cv/interests.liquid b/_includes/cv/interests.liquid new file mode 100644 index 0000000..f4997a7 --- /dev/null +++ b/_includes/cv/interests.liquid @@ -0,0 +1,29 @@ +{% comment %} + Unified interests entry renderer for both formats +{% endcomment %} + +
+ {% for entry in entries %} +
+ {% if entry.icon %} + + {% endif %} + {{ entry.name }}: + {% if entry.keywords %} + {% for keyword in entry.keywords %} + {% if forloop.last %} + {{ keyword }} + {% else %} + {{ keyword }}, + {% endif %} + {% endfor %} + {% endif %} +
+ {% endfor %} +
+ + diff --git a/_includes/cv/languages.liquid b/_includes/cv/languages.liquid new file mode 100644 index 0000000..5f58dd1 --- /dev/null +++ b/_includes/cv/languages.liquid @@ -0,0 +1,28 @@ +{% comment %} + Unified languages entry renderer for both formats + - RenderCV uses: name, summary + - JSONResume uses: language, fluency +{% endcomment %} + +
+ {% for entry in entries %} +
+ {% if entry.icon %} + + {% endif %} + {% capture lang_name %} + {% if entry.name %}{{ entry.name }}{% elsif entry.language %}{{ entry.language }}{% endif %} + {% endcapture %} + {% capture fluency %} + {% if entry.summary %}{{ entry.summary }}{% elsif entry.fluency %}{{ entry.fluency }}{% endif %} + {% endcapture %} + {{ lang_name }}: {{ fluency }} +
+ {% endfor %} +
+ + diff --git a/_includes/cv/list.html b/_includes/cv/list.html deleted file mode 100644 index 7562585..0000000 --- a/_includes/cv/list.html +++ /dev/null @@ -1,5 +0,0 @@ -
    - {% for content in entry.contents %} -
  • {{ content }}
    • - {% endfor %} -
\ No newline at end of file diff --git a/_includes/cv/map.html b/_includes/cv/map.html deleted file mode 100644 index e0d1983..0000000 --- a/_includes/cv/map.html +++ /dev/null @@ -1,8 +0,0 @@ - - {% for content in entry.contents %} - - - - - {% endfor %} -
{{ content.name }}{{ content.value }}
\ No newline at end of file diff --git a/_includes/cv/nested_list.html b/_includes/cv/nested_list.html deleted file mode 100644 index 4778aca..0000000 --- a/_includes/cv/nested_list.html +++ /dev/null @@ -1,14 +0,0 @@ -
    - {% for content in entry.contents %} -
  • -
    {{ content.title }}
    - {% if content.items %} -
      - {% for subitem in content.items %} -
    • {{ subitem }}
      • - {% endfor %} -
    - {% endif %} -
    • - {% endfor %} -
\ No newline at end of file diff --git a/_includes/cv/projects.liquid b/_includes/cv/projects.liquid new file mode 100644 index 0000000..7f5dc86 --- /dev/null +++ b/_includes/cv/projects.liquid @@ -0,0 +1,31 @@ +{% comment %} + Unified projects entry renderer for both formats +{% endcomment %} + +
    + {% for entry in entries %} +
  • + {% if entry.url %} +
    + {{ entry.name }} +
    + {% else %} +
    {{ entry.name }}
    + {% endif %} + + {% if entry.summary %} +

    {{ entry.summary | markdownify | remove: '

    ' | remove: '

    ' }}

    + {% endif %} + + {% if entry.highlights %} +
      + {% for item in entry.highlights %} +
    • + {{ item | markdownify | remove: '

      ' | remove: '

      ' }}       +
      • + {% endfor %} +
    + {% endif %} +
    • + {% endfor %} +
diff --git a/_includes/cv/publications.liquid b/_includes/cv/publications.liquid new file mode 100644 index 0000000..22f530a --- /dev/null +++ b/_includes/cv/publications.liquid @@ -0,0 +1,70 @@ +{% comment %} + Unified publications entry renderer for both formats +{% endcomment %} + +
    + {% for entry in entries %} +
  • +
    + {% capture pub_date %} + {% if entry.releaseDate %}{{ entry.releaseDate }}{% elsif entry.date %}{{ entry.date }}{% endif %} + {% endcapture %} + + {% if pub_date != '' %} +
    + + + + + + +
    + + {{- pub_date | split: '-' | slice: 0, 1 | join: '' -}} + +
    +
    +
    + {% if entry.url %} +
    + {{ entry.title | default: entry.name }} +
    + {% elsif entry.title %} +
    {{ entry.title }}
    + {% endif %} + + {% if entry.publisher %} +
    + {{ entry.publisher }} +
    + {% endif %} + + {% if entry.summary %} +

    {{ entry.summary | markdownify | remove: '

    ' | remove: '

    ' }}

    + {% endif %} +
    + {% else %} +
    + {% if entry.url %} +
    + {{ entry.title | default: entry.name }} +
    + {% elsif entry.title %} +
    {{ entry.title }}
    + {% endif %} + + {% if entry.publisher %} +
    + {{ entry.publisher }} +
    + {% endif %} + + {% if entry.summary %} +

    {{ entry.summary | markdownify | remove: '

    ' | remove: '

    ' }}

    + {% endif %} +
    + {% endif %} +
    +
    • + {% endfor %} +
diff --git a/_includes/cv/references.liquid b/_includes/cv/references.liquid new file mode 100644 index 0000000..8fc9456 --- /dev/null +++ b/_includes/cv/references.liquid @@ -0,0 +1,15 @@ +{% comment %} + Unified references entry renderer for both formats +{% endcomment %} + +
    + {% for entry in entries %} +
  • + {% if entry.icon %} + + {% endif %} + {{ entry.name }} +

    {{ entry.reference | markdownify | remove: '

    ' | remove: '

    ' }}

    +
    • + {% endfor %} +
diff --git a/_includes/cv/skills.liquid b/_includes/cv/skills.liquid new file mode 100644 index 0000000..a35e49b --- /dev/null +++ b/_includes/cv/skills.liquid @@ -0,0 +1,32 @@ +{% comment %} + Unified skills entry renderer for both formats +{% endcomment %} + +
+ {% for entry in entries %} +
+ {% if entry.icon %} + + {% endif %} + + {{- entry.name -}} + {%- if entry.level %} ({{ entry.level }}){% endif %}: + {% if entry.keywords %} + {% for keyword in entry.keywords %} + {% if forloop.last %} + {{ keyword }} + {% else %} + {{ keyword }}, + {% endif %} + {% endfor %} + {% endif %} +
+ {% endfor %} +
+ + diff --git a/_includes/cv/time_table.html b/_includes/cv/time_table.html deleted file mode 100644 index 123b9d0..0000000 --- a/_includes/cv/time_table.html +++ /dev/null @@ -1,59 +0,0 @@ -
    - {% for content in entry.contents %} -
  • -
    - {% if content.year %} -
    - - {{ content.year }} - -
    - {% endif %} -
    - {% if content.title %} -
    {{content.title}}
    - {% endif %} - {% if content.institution %} -
    {{content.institution}}
    - {% endif %} - {% if content.description %} -
      - {% for item in content.description %} -
    • - {% if item.contents %} - {{ item.title }} -
        - {% for subitem in item.contents %} -
      • {{ subitem }}
        • - {% endfor %} -
      - {% else %} - {{ item }} - {% endif %} -
      • - {% endfor %} -
    - {% endif %} - {% if content.items %} -
      - {% for item in content.items %} -
    • - {% if item.contents %} - {{ item.title }} -
        - {% for subitem in item.contents %} -
      • {{ subitem }}
        • - {% endfor %} -
      - {% else %} - {{ item }} - {% endif %} -
      • - {% endfor %} -
    - {% endif %} -
    -
    -
    • - {% endfor %} -
\ No newline at end of file diff --git a/_includes/disqus.html b/_includes/disqus.html deleted file mode 100644 index 73fe953..0000000 --- a/_includes/disqus.html +++ /dev/null @@ -1,13 +0,0 @@ -
- - -
diff --git a/_includes/disqus.liquid b/_includes/disqus.liquid new file mode 100644 index 0000000..2874b42 --- /dev/null +++ b/_includes/disqus.liquid @@ -0,0 +1,13 @@ +
+ + +
diff --git a/_includes/distill_scripts.liquid b/_includes/distill_scripts.liquid new file mode 100644 index 0000000..24d80d2 --- /dev/null +++ b/_includes/distill_scripts.liquid @@ -0,0 +1,340 @@ + + + + + + + + + + +{% if page.mermaid and page.mermaid.enabled %} + + + {% if page.mermaid.zoomable %} + + {% endif %} + +{% endif %} + +{% if page.code_diff %} + + + + +{% endif %} + +{% if page.map %} + + + +{% endif %} + +{% if page.chart and page.chart.chartjs %} + + + +{% endif %} + +{% if page.chart and page.chart.echarts %} + + + {% if site.enable_darkmode %} + + {% endif %} + +{% endif %} + +{% if page.chart and page.chart.plotly %} + + + +{% endif %} + +{% if page.chart and page.chart.vega_lite %} + + + + + +{% endif %} + +{% if page.tikzjax %} + + +{% endif %} + +{% if page.typograms %} + + +{% endif %} + +{% if site.enable_tooltips %} + + +{% endif %} + +{% if site.enable_medium_zoom %} + + + +{% endif %} + +{% if page.toc and page.toc.sidebar %} + + +{% endif %} + +{% if page.pretty_table %} + + + +{% endif %} + + + + + + + + + + + +{% if site.enable_math %} + + + + + +{% endif %} + +{% if site.enable_cookie_consent %} + + + +{% endif %} + +{% if site.enable_google_analytics %} + + + + +{% endif %} + +{% if site.enable_cronitor_analytics %} + + + +{% endif %} +{% if site.enable_pirsch_analytics %} + +{% endif %} +{% if site.enable_openpanel_analytics %} + + +{% endif %} + +{% if site.enable_progressbar %} + + +{% endif %} + +{% if page.images %} + + {% if page.images.compare %} + + {% endif %} + {% if page.images.lightbox2 %} + + {% endif %} + {% if page.images.photoswipe %} + + {% endif %} + {% if page.images.slider %} + + {% endif %} + {% if page.images.spotlight %} + + {% endif %} + {% if page.images.venobox %} + + + {% endif %} +{% endif %} + +{% if page.tabs %} + + +{% endif %} + +{% if site.back_to_top %} + + + +{% endif %} + +{% if site.search_enabled %} + + + + + + +{% endif %} diff --git a/_includes/figure.html b/_includes/figure.html deleted file mode 100644 index dbd25ac..0000000 --- a/_includes/figure.html +++ /dev/null @@ -1,36 +0,0 @@ -{%- assign img_path = include.path | remove: ".jpg" | remove: ".jpeg" | remove: ".png" | remove: ".tiff" -%} - -
- - -{% if site.imagemagick.enabled %} -{% for i in site.imagemagick.widths -%} - -{% endfor -%} -{% endif %} - - - - - - - {%- if include.caption -%}
{{ include.caption }}
{%- endif %} - -
diff --git a/_includes/figure.liquid b/_includes/figure.liquid new file mode 100644 index 0000000..5bf96bd --- /dev/null +++ b/_includes/figure.liquid @@ -0,0 +1,86 @@ +{% assign img_path = include.path | remove: '.jpg' | remove: '.jpeg' | remove: '.png' | remove: '.tiff' | remove: '.gif' %} +{% assign parts = include.path | split: '.' %} +{% assign ext = parts.last %} + +
+ + + + {% if site.imagemagick.enabled %} + {% unless include.avoid_scaling %} + + {% endunless %} + {% endif %} + {{ include.alt }} + + + {% if include.caption %} +
{{ include.caption }}
+ {% endif %} +
diff --git a/_includes/footer.html b/_includes/footer.html deleted file mode 100644 index acc4688..0000000 --- a/_includes/footer.html +++ /dev/null @@ -1,25 +0,0 @@ - {% if site.footer_fixed %} -
-
- © Copyright {{ site.time | date: '%Y' }} {{ site.first_name }} {{ site.middle_name }} {{ site.last_name }}. {{ site.footer_text }} - {%- if site.impressum_path -%} - Impressum. - {%- endif -%} - {%- if site.last_updated -%} - Last updated: {{ "now" | date: '%B %d, %Y' }}. - {%- endif %} -
-
- {%- else -%} -
-
- © Copyright {{ site.time | date: '%Y' }} {{ site.first_name }} {{ site.middle_name }} {{ site.last_name }}. {{ site.footer_text }} - {%- if site.impressum_path -%} - Impressum. - {%- endif -%} - {%- if site.last_updated -%} - Last updated: {{ "now" | date: '%B %d, %Y' }}. - {%- endif %} -
-
- {%- endif %} \ No newline at end of file diff --git a/_includes/footer.liquid b/_includes/footer.liquid new file mode 100644 index 0000000..f028dfe --- /dev/null +++ b/_includes/footer.liquid @@ -0,0 +1,30 @@ +{% capture footer_contents %} + © Copyright {{ site.time | date: '%Y' }} + {{ site.first_name }} + {{ site.middle_name }} + {{ site.last_name }}. {{ site.footer_text }} + {% if site.impressum_path %} + Impressum. + {% endif %} + {% if site.last_updated %} + Last updated: {{ 'now' | date: '%B %d, %Y' }}. + {% endif %} +{% endcapture %} + +{% if site.footer_fixed %} +
+
+ {{ footer_contents }} +
+
+{% else %} +
+ {% if site.newsletter.enabled %} + {% include newsletter.liquid %} + {% endif %} + +
+ {{ footer_contents }} +
+
+{% endif %} diff --git a/_includes/giscus.html b/_includes/giscus.html deleted file mode 100644 index bb504f6..0000000 --- a/_includes/giscus.html +++ /dev/null @@ -1,27 +0,0 @@ -
- - -
diff --git a/_includes/giscus.liquid b/_includes/giscus.liquid new file mode 100644 index 0000000..f4e6f06 --- /dev/null +++ b/_includes/giscus.liquid @@ -0,0 +1,25 @@ +
+ {% if page.layout == 'post' %} +
+ {% endif %} + + {% if site.giscus.repo %} + + + {% else %} + {% capture giscus_warning %} +> ##### giscus comments misconfigured +> Please follow instructions at [http://giscus.app](http://giscus.app) and update your giscus configuration. +{: .block-danger } + {% endcapture %} + {{ giscus_warning | markdownify }} + {% endif %} +
diff --git a/_includes/head.html b/_includes/head.html deleted file mode 100644 index c48d71d..0000000 --- a/_includes/head.html +++ /dev/null @@ -1,32 +0,0 @@ - - {% include metadata.html %} - - - - - - - - - - - - - - - - {% if site.icon.size <= 4 %} - - {% elsif site.icon != blank %} - - {% endif %} - - - - - {% if site.enable_darkmode %} - - - - - {% endif %} diff --git a/_includes/head.liquid b/_includes/head.liquid new file mode 100644 index 0000000..d79bea9 --- /dev/null +++ b/_includes/head.liquid @@ -0,0 +1,208 @@ + +{% include metadata.liquid %} + + + + + + + + + + +{% if page.pretty_table %} + + +{% endif %} + + + + + + + + + +{% if page.toc and page.toc.sidebar %} + + +{% endif %} + + + +{% if page.pseudocode %} + + +{% endif %} + +{% if site.icon.size <= 4 %} + +{% elsif site.icon != blank %} + +{% endif %} + + + +{% if site.enable_darkmode %} + + + + +{% endif %} + +{% if page.map %} + + +{% endif %} + +{% if page.code_diff %} + + + + +{% endif %} + +{% if page.images %} + {% if page.images.compare %} + + + {% endif %} + {% if page.images.lightbox2 %} + + + {% endif %} + {% if page.images.photoswipe %} + + + {% endif %} + {% if page.images.slider %} + + + {% endif %} + {% if page.images.spotlight %} + + + {% endif %} + {% if page.images.venobox %} + + + {% endif %} +{% endif %} + +{% if page.tikzjax %} + +{% endif %} + +{% if site.enable_cookie_consent %} + + +{% endif %} diff --git a/_includes/header.html b/_includes/header.html deleted file mode 100644 index 79779f6..0000000 --- a/_includes/header.html +++ /dev/null @@ -1,119 +0,0 @@ - -
- - - -{% if site.enable_progressbar %} - - -
- -
- -{%- endif %} -
diff --git a/_includes/header.liquid b/_includes/header.liquid new file mode 100644 index 0000000..8769cce --- /dev/null +++ b/_includes/header.liquid @@ -0,0 +1,150 @@ +
+ + + {% if site.enable_progressbar %} + + +
+ +
+ + {% endif %} +
diff --git a/_includes/latest_posts.liquid b/_includes/latest_posts.liquid new file mode 100644 index 0000000..3342619 --- /dev/null +++ b/_includes/latest_posts.liquid @@ -0,0 +1,48 @@ +
+ {% if page.latest_posts != blank %} + {% assign latest_posts_size = site.posts | size %} +
3 %} + style="max-height: 60vw" + {% endif %} + > + + {% assign latest_posts = site.posts %} + {% if page.latest_posts.limit %} + {% assign latest_posts_limit = page.latest_posts.limit %} + {% else %} + {% assign latest_posts_limit = latest_posts_size %} + {% endif %} + {% for item in latest_posts limit: latest_posts_limit %} + + + + + {% endfor %} +
{{ item.date | date: '%b %d, %Y' }} + {% if item.redirect == blank %} + {{ item.title }} + {% elsif item.redirect contains '://' %} + {{ item.title }} + + + + {% else %} + {{ item.title }} + {% endif %} +
+
+ {% else %} +

No posts so far...

+ {% endif %} +
diff --git a/_includes/metadata.html b/_includes/metadata.html deleted file mode 100644 index a404ca9..0000000 --- a/_includes/metadata.html +++ /dev/null @@ -1,200 +0,0 @@ -{% if site.enable_google_verification or site.enable_bing_verification %} - - {% if site.enable_google_verification -%} - - {%- endif -%} - {% if site.enable_bing_verification -%} - - {%- endif -%} -{%- endif %} - - - - - - - {%- if site.title == "blank" -%} - {%- capture title -%}{{ site.first_name }} {{ site.middle_name }} {{ site.last_name }}{%- endcapture -%} - {%- else -%} - {%- capture title -%}{{ site.title }}{%- endcapture -%} - {%- endif -%} - {% if page.url == '/blog/index.html' %} - {{ site.blog_nav_title }} | {{ title }} - {%- elsif page.title != "blank" and page.url != "/" -%} - {%- if page.title == nil or page.title == "" -%} - {{ page.date | date: "%Y" }} | {{ title }} - {%- else -%} - {{ page.title }} | {{ title }} - {%- endif -%} - {%- else -%} - {{ title }} - {%- endif -%} - - - -{%- if page.keywords or site.keywords %} - -{%- endif %} - -{%- if site.serve_og_meta %} - - - - - - - - {% if page.og_image or site.og_image -%} - - {%- endif %} - - - - - - - {% if page.og_image or site.og_image -%} - - {%- endif %} - {% if site.twitter_username -%} - - - {%- endif %} -{%- endif %} - -{%- if site.serve_schema_org %} - - - {%- comment -%} Social links generator for "sameAs schema" {%- endcomment %} - {% assign sameaslinks = "" | split: "," %} - {%- if site.orcid_id -%} - {%- capture link -%}https://orcid.org/{{ site.orcid_id }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.scholar_userid -%} - {%- capture link -%}https://scholar.google.com/citations?user={{ site.scholar_userid }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.semanticscholar_id -%} - {%- capture link -%}https://www.semanticscholar.org/author/{{ site.semanticscholar_id }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.publons_id -%} - {%- capture link -%}https://publons.com/a/{{ site.publons_id }}/{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.research_gate_profile -%} - {%- capture link -%}https://www.researchgate.net/profile/{{site.research_gate_profile}}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.github_username -%} - {%- capture link -%}https://github.com/{{ site.github_username }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.telegram_username -%} - {%- capture link -%}https://telegram.me/{{ site.telegram_username }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.linkedin_username -%} - {%- capture link -%}https://www.linkedin.com/in/{{ site.linkedin_username }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.twitter_username -%} - {%- capture link -%}https://twitter.com/{{ site.twitter_username }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.medium_username -%} - {%- capture link -%}https://medium.com/@{{ site.medium_username }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.quora_username -%} - {%- capture link -%}https://www.quora.com/profile/{{ site.quora_username }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.blogger_url -%} - {%- capture link -%}{{ site.blogger_url }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.work_url -%} - {%- capture link -%}{{ site.work_url }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.wikidata_id -%} - {%- capture link -%}https://www.wikidata.org/wiki/{{ site.wikidata_id }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.strava_userid -%} - {%- capture link -%}https://www.strava.com/athletes/{{ site.strava_userid }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.keybase_username -%} - {%- capture link -%}https://keybase.io/{{ site.keybase_username }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.gitlab_username -%} - {%- capture link -%}https://gitlab.com/{{ site.gitlab_username }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.dblp_url -%} - {%- capture link -%}{{ site.dblp_url }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.stackoverflow_id -%} - {%- capture link -%}https://stackoverflow.com/users/{{ site.stackoverflow_id }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.kaggle_id -%} - {%- capture link -%}https://www.kaggle.com/{{ site.kaggle_id }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.lastfm_id -%} - {%- capture link -%}https://www.last.fm/user/{{ site.lastfm_id }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.spotify_id -%} - {%- capture link -%}https://open.spotify.com/user/{{ site.spotify_id }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.pinterest_id -%} - {%- capture link -%}https://www.pinterest.com/{{ site.pinterest_id }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.unsplash_id -%} - {%- capture link -%}https://unsplash.com/@{{ site.unsplash_id }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.instagram_id -%} - {%- capture link -%}https://instagram.com/{{ site.instagram_id }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.facebook_id -%} - {%- capture link -%}https://facebook.com/{{ site.facebook_id }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if site.discord_id -%} - {%- capture link -%}https://discord.com/users/{{ site.discord_id }}{%- endcapture -%} - {%- assign sameaslinks = sameaslinks | push: link -%} - {%- endif -%} - {%- if sameaslinks != blank -%} - {%- assign sameaslinks = sameaslinks | split: "" -%} - {%- endif -%} - - -{%- endif %} diff --git a/_includes/metadata.liquid b/_includes/metadata.liquid new file mode 100644 index 0000000..e12e394 --- /dev/null +++ b/_includes/metadata.liquid @@ -0,0 +1,247 @@ +{% if site.enable_google_verification or site.enable_bing_verification %} + + {% if site.enable_google_verification %} + + {% endif %} + {% if site.enable_bing_verification %} + + {% endif %} + + +{% endif %} + +{% capture author_name %}{{ site.first_name }}{% if site.middle_name %} {{ site.middle_name }}{% endif %} {{ site.last_name }}{% endcapture %} + + + + + + + {% if site.title == 'blank' %} + {% capture title %}{{ author_name }}{% endcapture %} + {% else %} + {% capture title %}{{ site.title }}{% endcapture %} + {% endif %} + {% if page.url == '/blog/index.html' %} + {{ page.title }} | {{ title }} + {% elsif page.title != 'blank' and page.url != '/' %} + {% if page.title == null or page.title == '' %} + {{ page.date | date: '%Y' }} | {{ title }} + {% else %} + {{ page.title }} | {{ title }} + {% endif %} + {% else %} + {{ title }} + {% endif %} + + + +{% if page.keywords or site.keywords %} + +{% endif %} + +{% assign is_blog_post = false %} +{% if page.url != '/blog/index.html' and page.url contains '/blog/' %} + {% unless page.url contains '/tag/' or page.url contains '/category/' %} + {% assign is_blog_post = true %} + {% endunless %} +{% endif %} + +{% if site.serve_og_meta %} + + + + + + + {% if page.og_image or site.og_image %} + + {% endif %} + + + + + + + {% if page.og_image or site.og_image %} + + {% endif %} + {% if site.x_username %} + + + {% endif %} +{% endif %} + +{% if site.serve_schema_org %} + + {% comment %} Social links generator for "sameAs schema" {% endcomment %} + {% assign sameaslinks = '' | split: ',' %} + {% for social in site.data.socials %} + {% case social[0] %} + {% when 'acm_id' %} + {% capture link %}https://dl.acm.org/profile/{{ social[1] }}/{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'arxiv_id' %} + {% capture link %}https://arxiv.org/a/{{ social[1] }}.html{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'blogger_url' %} + {% capture link %}{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'bluesky_url' %} + {% capture link %}{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'dblp_url' %} + {% capture link %}{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'discord_id' %} + {% capture link %}https://discord.com/users/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'email' %} + {% comment %} + {% capture link %}mailto:{{ social[1] | encode_email }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% endcomment %} + {% when 'facebook_id' %} + {% capture link %}https://facebook.com/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'flickr_id' %} + {% capture link %}https://www.flickr.com/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'github_username' %} + {% capture link %}https://github.com/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'gitlab_username' %} + {% capture link %}https://gitlab.com/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'hal_id' %} + {% capture link %}https://cv.hal.science/{{ social[1] }}/{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'ieee_id' %} + {% capture link %}https://ieeexplore.ieee.org/author/{{ social[1] }}/{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'inspirehep_id' %} + {% capture link %}https://inspirehep.net/authors/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'instagram_id' %} + {% capture link %}https://instagram.com/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'kaggle_id' %} + {% capture link %}https://www.kaggle.com/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'keybase_username' %} + {% capture link %}https://keybase.io/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'lastfm_id' %} + {% capture link %}https://www.last.fm/user/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'lattes_id' %} + {% capture link %}http://lattes.cnpq.br/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'leetcode_id' %} + {% capture link %}https://leetcode.com/u/{{ social[1] }}/{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'linkedin_username' %} + {% capture link %}https://www.linkedin.com/in/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'mastodon_username' %} + {% capture link %}https://{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'medium_username' %} + {% capture link %}https://medium.com/@{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'orcid_id' %} + {% capture link %}https://orcid.org/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'osf_id' %} + {% capture link %}https://osf.io/{{ social[1] }}/{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'pinterest_id' %} + {% capture link %}https://www.pinterest.com/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'publons_id' %} + {% capture link %}https://publons.com/a/{{ social[1] }}/{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'quora_username' %} + {% capture link %}https://www.quora.com/profile/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'research_gate_profile' %} + {% capture link %}https://www.researchgate.net/profile/{{ social[1] }}/{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'rss_icon' %} + {% comment %} + {% capture link %}{{ site.baseurl }}/feed.xml{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% endcomment %} + {% when 'scholar_userid' %} + {% capture link %}https://scholar.google.com/citations?user={{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'scopus_id' %} + {% capture link %}https://www.scopus.com/authid/detail.uri?authorId={{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'semanticscholar_id' %} + {% capture link %}https://www.semanticscholar.org/author/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'spotify_id' %} + {% capture link %}https://open.spotify.com/user/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'stackoverflow_id' %} + {% capture link %}https://stackoverflow.com/users/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'strava_userid' %} + {% capture link %}https://www.strava.com/athletes/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'telegram_username' %} + {% capture link %}https://telegram.me/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'unsplash_id' %} + {% capture link %}https://unsplash.com/@{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'whatsapp_number' %} + {% capture link %}https://wa.me/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'wikidata_id' %} + {% capture link %}https://www.wikidata.org/wiki/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'wikipedia_id' %} + {% capture link %}https://wikipedia.org/wiki/User:{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'work_url' %} + {% capture link %}{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'x_username' %} + {% capture link %}https://twitter.com/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'youtube_id' %} + {% capture link %}https://youtube.com/@{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% when 'zotero_username' %} + {% capture link %}https://www.zotero.org/{{ social[1] }}{% endcapture %} + {% assign sameaslinks = sameaslinks | push: link %} + {% else %} + {% assign sameaslinks = sameaslinks | push: social[1].url %} + {% endcase %} + {% endfor %} + + +{% endif %} diff --git a/_includes/news.html b/_includes/news.html deleted file mode 100644 index 14d286d..0000000 --- a/_includes/news.html +++ /dev/null @@ -1,30 +0,0 @@ - -
- {% if site.news != blank -%} - {%- assign news_size = site.news | size -%} -
3 %}style="max-height: 10vw"{% endif %}> - - {%- assign news = site.news | reverse -%} - {% if site.news_limit %} - {% assign news_limit = site.news_limit %} - {% else %} - {% assign news_limit = news_size %} - {% endif %} - {% for item in news limit: news_limit %} - - - - - {%- endfor %} -
{{ item.date | date: "%b %-d, %Y" }} - {% if item.inline -%} - {{ item.content | remove: '

' | remove: '

' | emojify }} - {%- else -%} - {{ item.title }} - {%- endif %} -
-
- {%- else -%} -

No news so far...

- {%- endif %} -
diff --git a/_includes/news.liquid b/_includes/news.liquid new file mode 100644 index 0000000..ddf40b8 --- /dev/null +++ b/_includes/news.liquid @@ -0,0 +1,34 @@ +
+ {% if site.news != blank %} + {% assign news_size = site.news | size %} +
3 %} + style="max-height: 60vw" + {% endif %} + > + + {% assign news = site.news | reverse %} + {% if include.limit and page.announcements.limit %} + {% assign news_limit = page.announcements.limit %} + {% else %} + {% assign news_limit = news_size %} + {% endif %} + {% for item in news limit: news_limit %} + + + + + {% endfor %} +
{{ item.date | date: '%b %d, %Y' }} + {% if item.inline %} + {{ item.content | remove: '

' | remove: '

' | emojify }} + {% else %} + {{ item.title }} + {% endif %} +
+
+ {% else %} +

No news so far...

+ {% endif %} +
diff --git a/_includes/newsletter.liquid b/_includes/newsletter.liquid new file mode 100644 index 0000000..ebceefc --- /dev/null +++ b/_includes/newsletter.liquid @@ -0,0 +1,68 @@ + + + diff --git a/_includes/pagination.html b/_includes/pagination.html deleted file mode 100644 index 4b8d27e..0000000 --- a/_includes/pagination.html +++ /dev/null @@ -1,17 +0,0 @@ -{%- if paginator.total_pages > 1 -%} - -{%- endif -%} diff --git a/_includes/pagination.liquid b/_includes/pagination.liquid new file mode 100644 index 0000000..61bf4fb --- /dev/null +++ b/_includes/pagination.liquid @@ -0,0 +1,21 @@ +{% if paginator.total_pages > 1 %} + +{% endif %} diff --git a/_includes/projects.html b/_includes/projects.html deleted file mode 100644 index 6001929..0000000 --- a/_includes/projects.html +++ /dev/null @@ -1,36 +0,0 @@ - -
-
-{% if project.redirect -%} - -{%- else -%} - -{%- endif %} -
-{%- if project.img %} -{%- include figure.html -path=project.img -alt="project thumbnail" -%} -{%- endif %} -
-

{{ project.title }}

-

{{ project.description }}

-
-{%- if project.github -%} -
-
- -
-{%- if project.github_stars -%} - - - - -{%- endif %} -
-{%- endif %} -
-
-
- -
diff --git a/_includes/projects.liquid b/_includes/projects.liquid new file mode 100644 index 0000000..0ada935 --- /dev/null +++ b/_includes/projects.liquid @@ -0,0 +1,35 @@ +
+ +
+ {% if project.img %} + {% + include figure.liquid + loading="eager" + path=project.img + sizes = "250px" + alt="project thumbnail" + class="card-img-top" + %} + {% endif %} +
+

{{ project.title }}

+

{{ project.description }}

+
+ {% if project.github %} +
+
+ +
+ {% if project.github_stars %} + + + + + {% endif %} +
+ {% endif %} +
+
+
+ +
diff --git a/_includes/projects_horizontal.html b/_includes/projects_horizontal.html deleted file mode 100644 index 4711c4b..0000000 --- a/_includes/projects_horizontal.html +++ /dev/null @@ -1,40 +0,0 @@ -
-{%- if project.redirect -%} - -{%- else -%} - -{%- endif -%} -
-
-{%- if project.img -%} -
-{% include figure.html path=project.img alt="project thumbnail" %} -
-
-{%- else -%} -
-{%- endif -%} -
-

{{ project.title }}

-

{{ project.description }}

-
-{%- if project.github -%} -
-
- -
-{%- if project.github_stars -%} - - - - -{%- endif -%} -
-{%- endif -%} -
-
-
-
-
- -
diff --git a/_includes/projects_horizontal.liquid b/_includes/projects_horizontal.liquid new file mode 100644 index 0000000..8630e69 --- /dev/null +++ b/_includes/projects_horizontal.liquid @@ -0,0 +1,34 @@ +
+ +
+
+ {% if project.img %} +
+ {% include figure.liquid loading="eager" path=project.img sizes="(min-width: 768px) 156px, 50vw" alt="project thumbnail" class="card-img" %} +
+ {% endif %} +
+
+

{{ project.title }}

+

{{ project.description }}

+
+ {% if project.github %} +
+
+ +
+ {% if project.github_stars %} + + + + + {% endif %} +
+ {% endif %} +
+
+
+
+
+ +
diff --git a/_includes/related_posts.liquid b/_includes/related_posts.liquid new file mode 100644 index 0000000..4ba91dd --- /dev/null +++ b/_includes/related_posts.liquid @@ -0,0 +1,36 @@ +{% assign have_related_posts = false %} +{% for post in site.related_posts | limit: site.related_blog_posts.max_related %} + {% unless have_related_posts %} + {% assign have_related_posts = true %} + {% if page.layout == 'post' %} +
+
+
+
    + + +

    Enjoy Reading This Article?

    + {% else %} +

    Enjoy Reading This Article?

    + {% endif %} + +

    Here are some more articles you might like to read next:

    + {% endunless %} + +
  • + {% if post.redirect == blank %} + {{ post.title }} + {% elsif post.redirect contains '://' %} + {{ post.title }} + + + + {% else %} + {{ post.title }} + {% endif %} +
    • +{% endfor %} +{% if site.newsletter.enabled and site.footer_fixed %} +

    Subscribe to be notified of future articles:

    + {% include newsletter.liquid left=true %} +{% endif %} diff --git a/_includes/repository/repo.html b/_includes/repository/repo.html deleted file mode 100644 index a0881c0..0000000 --- a/_includes/repository/repo.html +++ /dev/null @@ -1,14 +0,0 @@ -{% assign repo_url = include.repository | split: '/' %} - -{% if site.data.repositories.github_users contains repo_url.first %} - {% assign show_owner = false %} -{% else %} - {% assign show_owner = true %} -{% endif %} - -
    - - {{ include.repository }} - {{ include.repository }} - -
    diff --git a/_includes/repository/repo.liquid b/_includes/repository/repo.liquid new file mode 100644 index 0000000..d2e4c64 --- /dev/null +++ b/_includes/repository/repo.liquid @@ -0,0 +1,47 @@ +{% assign repo_url = include.repository | split: '/' %} +{% if site.data.repositories.github_users contains repo_url.first %} + {% assign show_owner = false %} +{% else %} + {% assign show_owner = true %} +{% endif %} + +{% assign lang = site.lang | split: '-' | first %} + +{% case lang %} + {% when 'pt' %} + {% assign lang = site.lang %} + + {% when 'zh' %} + {% assign lang_last = site.lang | split: '-' | last %} + {% case lang_last %} + {% when 'cn', 'sg', 'my', 'hans' %} + {% assign lang = 'cn' %} + {% when 'tw', 'hk', 'mo', 'hant' %} + {% assign lang = 'zh-tw' %} + {% endcase %} + + {% comment %} Add a new language using when... if needed {% endcomment %} + {% comment %} If you still encounter language-display issues, check the available locale codes in github-readme-stats (different from ISO-639 standard used in your website) {% endcomment %} + {% comment %} https://github.com/anuraghazra/github-readme-stats?tab=readme-ov-file#available-locales {% endcomment %} +{% endcase %} + +{% if site.data.repositories.repo_description_lines_max %} + {% assign max_lines = site.data.repositories.repo_description_lines_max %} +{% else %} + {% assign max_lines = 2 %} +{% endif %} + +
    + + {{ include.repository }} + {{ include.repository }} + +
    diff --git a/_includes/repository/repo_trophies.liquid b/_includes/repository/repo_trophies.liquid new file mode 100644 index 0000000..d0f3e9c --- /dev/null +++ b/_includes/repository/repo_trophies.liquid @@ -0,0 +1,42 @@ +
    + + + {{ include.username }} + {{ include.username }} + + + + {{ include.username }} + {{ include.username }} + + + + {{ include.username }} + {{ include.username }} + + +
    diff --git a/_includes/repository/repo_user.html b/_includes/repository/repo_user.html deleted file mode 100644 index ae06a05..0000000 --- a/_includes/repository/repo_user.html +++ /dev/null @@ -1,6 +0,0 @@ -
    - - {{ include.username }} - {{ include.username }} - -
    diff --git a/_includes/repository/repo_user.liquid b/_includes/repository/repo_user.liquid new file mode 100644 index 0000000..d41519c --- /dev/null +++ b/_includes/repository/repo_user.liquid @@ -0,0 +1,34 @@ +{% assign lang = site.lang | split: '-' | first %} + +{% case lang %} + {% when 'pt' %} + {% assign lang = site.lang %} + + {% when 'zh' %} + {% assign lang_last = site.lang | split: '-' | last %} + {% case lang_last %} + {% when 'cn', 'sg', 'my', 'hans' %} + {% assign lang = 'cn' %} + {% when 'tw', 'hk', 'mo', 'hant' %} + {% assign lang = 'zh-tw' %} + {% endcase %} + + {% comment %} Add a new language using when... if needed {% endcomment %} + {% comment %} If you still encounter language-display issues, check the available locale codes in github-readme-stats (different from ISO-639 standard used in your website) {% endcomment %} + {% comment %} https://github.com/anuraghazra/github-readme-stats?tab=readme-ov-file#available-locales {% endcomment %} +{% endcase %} + +
    + + {{ include.username }} + {{ include.username }} + +
    diff --git a/_includes/scripts.liquid b/_includes/scripts.liquid new file mode 100644 index 0000000..e6b21ae --- /dev/null +++ b/_includes/scripts.liquid @@ -0,0 +1,378 @@ + + + + + + + +{% if site.enable_masonry %} + + + + +{% endif %} + +{% if page.mermaid and page.mermaid.enabled %} + + + {% if page.mermaid.zoomable %} + + {% endif %} + +{% endif %} + +{% if page.code_diff %} + + + + +{% endif %} + +{% if page.map %} + + + +{% endif %} + +{% if page.chart and page.chart.chartjs %} + + + +{% endif %} + +{% if page.chart and page.chart.echarts %} + + + {% if site.enable_darkmode %} + + {% endif %} + +{% endif %} + +{% if page.calendar %} + + +{% endif %} + +{% if page.chart and page.chart.plotly %} + + + +{% endif %} + +{% if page.chart and page.chart.vega_lite %} + + + + + +{% endif %} + +{% if page.tikzjax %} + + +{% endif %} + +{% if page.typograms %} + + +{% endif %} + +{% if site.enable_tooltips %} + + +{% endif %} + +{% if site.enable_medium_zoom %} + + + +{% endif %} + +{% if page.toc and page.toc.sidebar %} + + +{% endif %} + +{% if page.pretty_table %} + + + +{% endif %} + + + + + + + + + + +{% if site.enable_publication_badges.altmetric %} + +{% endif %} +{% if site.enable_publication_badges.dimensions %} + +{% endif %} + +{% if site.enable_math %} + + + {% unless page.pseudocode %} + + + {% else %} + + + {% endunless %} +{% endif %} + +{% if site.enable_cookie_consent %} + + + +{% endif %} + +{% if site.enable_google_analytics %} + + + + +{% endif %} + +{% if site.enable_cronitor_analytics %} + + + +{% endif %} +{% if site.enable_pirsch_analytics %} + +{% endif %} +{% if site.enable_openpanel_analytics %} + + +{% endif %} + +{% if site.enable_progressbar %} + + +{% endif %} + +{% if page.images %} + + {% if page.images.compare %} + + {% endif %} + {% if page.images.lightbox2 %} + + {% endif %} + {% if page.images.photoswipe %} + + {% endif %} + {% if page.images.slider %} + + {% endif %} + {% if page.images.spotlight %} + + {% endif %} + {% if page.images.venobox %} + + + {% endif %} +{% endif %} + +{% if page.tabs %} + + +{% endif %} + +{% if site.back_to_top %} + + + +{% endif %} + +{% if site.search_enabled %} + + + + + + +{% endif %} + +{% if site.newsletter.enabled %} + +{% endif %} diff --git a/_includes/scripts/analytics.html b/_includes/scripts/analytics.html deleted file mode 100644 index db2aeef..0000000 --- a/_includes/scripts/analytics.html +++ /dev/null @@ -1,18 +0,0 @@ -{%- if site.enable_google_analytics -%} - - - -{%- endif -%} -{%- if site.enable_panelbear_analytics -%} - - - -{%- endif -%} diff --git a/_includes/scripts/badges.html b/_includes/scripts/badges.html deleted file mode 100644 index b8a3ccd..0000000 --- a/_includes/scripts/badges.html +++ /dev/null @@ -1,6 +0,0 @@ -{%- if site.badges.altmetric_badge %} - -{%- endif %} -{%- if site.badges.dimensions_badge %} - -{%- endif %} diff --git a/_includes/scripts/bootstrap.html b/_includes/scripts/bootstrap.html deleted file mode 100644 index 1c21365..0000000 --- a/_includes/scripts/bootstrap.html +++ /dev/null @@ -1,3 +0,0 @@ - - - diff --git a/_includes/scripts/jquery.html b/_includes/scripts/jquery.html deleted file mode 100644 index f84a2f2..0000000 --- a/_includes/scripts/jquery.html +++ /dev/null @@ -1,2 +0,0 @@ - - diff --git a/_includes/scripts/masonry.html b/_includes/scripts/masonry.html deleted file mode 100644 index 804389d..0000000 --- a/_includes/scripts/masonry.html +++ /dev/null @@ -1,6 +0,0 @@ - {%- if site.enable_masonry -%} - - - - - {%- endif -%} diff --git a/_includes/scripts/mathjax.html b/_includes/scripts/mathjax.html deleted file mode 100644 index c55ec05..0000000 --- a/_includes/scripts/mathjax.html +++ /dev/null @@ -1,12 +0,0 @@ - {%- if site.enable_math -%} - - - - - {%- endif %} diff --git a/_includes/scripts/misc.html b/_includes/scripts/misc.html deleted file mode 100644 index 08ba49f..0000000 --- a/_includes/scripts/misc.html +++ /dev/null @@ -1,14 +0,0 @@ -{% if site.enable_tooltips %} - - -{%- endif %} -{%- if site.enable_medium_zoom %} - - - -{%- endif -%} - - - diff --git a/_includes/scripts/progressBar.html b/_includes/scripts/progressBar.html deleted file mode 100644 index 88bb73c..0000000 --- a/_includes/scripts/progressBar.html +++ /dev/null @@ -1,80 +0,0 @@ -{% if site.enable_progressbar %} - - - - -{%- endif %} diff --git a/_includes/selected_papers.html b/_includes/selected_papers.html deleted file mode 100644 index cfaeb80..0000000 --- a/_includes/selected_papers.html +++ /dev/null @@ -1,4 +0,0 @@ - -
    - {% bibliography -f papers -q @*[selected=true]* %} -
    diff --git a/_includes/selected_papers.liquid b/_includes/selected_papers.liquid new file mode 100644 index 0000000..e9bf093 --- /dev/null +++ b/_includes/selected_papers.liquid @@ -0,0 +1,3 @@ +
    + {% bibliography --group_by none --query @*[selected=true]* %} +
    diff --git a/_includes/social.html b/_includes/social.html deleted file mode 100644 index 38b5d3b..0000000 --- a/_includes/social.html +++ /dev/null @@ -1,96 +0,0 @@ - {%- if site.email -%} - - {% endif %} - {%- if site.telegram_username -%} - - {% endif %} - {%- if site.whatsapp_number -%} - - {% endif %} - {%- if site.orcid_id -%} - - {% endif %} - {%- if site.scholar_userid -%} - - {% endif %} - {%- if site.semanticscholar_id -%} - - {% endif %} - {%- if site.publons_id -%} - - {% endif %} - {%- if site.research_gate_profile -%} - - {% endif %} - {%- if site.github_username -%} - - {% endif %} - {%- if site.linkedin_username -%} - - {% endif %} - {%- if site.twitter_username -%} - - {% endif %} - {%- if site.mastodon_username -%} - - {% endif %} - {%- if site.medium_username -%} - - {% endif %} - {%- if site.quora_username -%} - - {% endif %} - {%- if site.blogger_url -%} - - {% endif %} - {%- if site.work_url -%} - - {% endif %} - {%- if site.wikidata_id -%} - - {% endif %} - {%- if site.strava_userid -%} - - {% endif %} - {%- if site.keybase_username -%} - - {% endif %} - {%- if site.gitlab_username -%} - - {% endif %} - {%- if site.dblp_url -%} - - {% endif %} - {%- if site.stackoverflow_id -%} - - {% endif %} - {%- if site.kaggle_id -%} - - {% endif %} - {%- if site.lastfm_id -%} - - {% endif %} - {%- if site.spotify_id -%} - - {% endif %} - {%- if site.pinterest_id -%} - - {% endif %} - {%- if site.unsplash_id -%} - - {% endif %} - {%- if site.instagram_id -%} - - {% endif %} - {%- if site.facebook_id -%} - - {% endif %} - {%- if site.youtube_id -%} - - {% endif %} - {%- if site.discord_id -%} - - {% endif %} - {%- if site.rss_icon -%} - - {% endif %} diff --git a/_includes/video.liquid b/_includes/video.liquid new file mode 100644 index 0000000..8823106 --- /dev/null +++ b/_includes/video.liquid @@ -0,0 +1,97 @@ +{% assign extension = include.path | split: '.' | last %} + +
    + {% if extension == 'mp4' or extension == 'webm' or extension == 'ogg' %} +