diff --git a/.githooks/pre-commit b/.githooks/pre-commit index e5f27c4..a6116ed 100755 --- a/.githooks/pre-commit +++ b/.githooks/pre-commit @@ -148,8 +148,8 @@ fi # Ensure JavaScript files are minified. # ################################################################## -# Get the newly added and modified files. -mapfile -t all_changed_files < <(git diff --cached --name-only) +# Get the newly added and modified files, but not deleted files. +mapfile -t all_changed_files < <(git diff --cached --name-only --diff-filter=d) script_name=$(basename "$0") # Loop through all newly added or modified files. diff --git a/.github/ISSUE_TEMPLATE/2_bug_report.yml b/.github/ISSUE_TEMPLATE/2_bug_report.yml new file mode 100644 index 0000000..95746f9 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/2_bug_report.yml @@ -0,0 +1,62 @@ +name: "🐛 Bug report" +description: "Did you run into an issue while using tabi?" +labels: ["bug"] +body: +- type: textarea + attributes: + label: "System information" + description: | + Please provide the following information: + - Zola version: Run `zola --version` + - tabi version or commit hash + placeholder: | + Zola version: + tabi version or commit: + validations: + required: true + +- type: textarea + attributes: + label: "Expected behaviour" + description: "Tell us what should have happened." + placeholder: "Describe what you expected tabi to do…" + validations: + required: true + +- type: textarea + attributes: + label: "Actual behaviour" + description: "Tell us what happens instead of the expected behavior." + placeholder: "Describe what actually happened…" + validations: + required: true + +- type: textarea + attributes: + label: "Steps to reproduce" + description: "Please provide detailed steps to reproduce the issue." + placeholder: | + 1. Set up `config.toml` with these settings: … + 2. Create content with this structure: … + 3. Run Zola with these arguments: … + 4. See the following error: … + validations: + required: true + +- type: textarea + attributes: + label: "Additional context" + description: > + Please provide any relevant configuration files, error messages, or screenshots that might help us understand the issue. + You can drag and drop files here to attach them. + validations: + required: false + +- type: checkboxes + attributes: + label: "Final checklist" + options: + - label: "I've checked that the issue isn't already reported." + required: true + - label: "I've tested with the latest version of tabi to check if the issue has already been fixed." + required: true diff --git a/.github/ISSUE_TEMPLATE/3_feature_request.yml b/.github/ISSUE_TEMPLATE/3_feature_request.yml new file mode 100644 index 0000000..44509e2 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/3_feature_request.yml @@ -0,0 +1,34 @@ +name: "✨ Feature request" +description: "Suggest an idea for tabi" +labels: ["enhancement"] +body: +- type: textarea + attributes: + label: "Summary and motivation" + description: "Briefly describe the feature and why it would be valuable for tabi users." + placeholder: | + Describe: + - What the feature is + - Why it would be useful + - Any examples from other projects + validations: + required: true + +- type: textarea + attributes: + label: "Implementation details" + description: "Share any ideas you have about how this could be implemented." + placeholder: "Technical suggestions, potential approaches, or specific requirements." + validations: + required: false + +- type: checkboxes + attributes: + label: "Checklist" + options: + - label: "I've searched existing issues to make sure this feature hasn't already been requested." + required: true + - label: "This feature aligns with tabi's philosophy (minimal JS, accessible…)" + required: true + - label: "I'm willing to contribute to the implementation of this feature." + required: false diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md deleted file mode 100644 index ec4cfdf..0000000 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -name: Bug report -about: Did you run into an issue while using tabi? -title: '' -labels: bug -assignees: '' - ---- - -# Bug Report - -## Environment - -Zola version: -tabi version or commit: - -## Expected Behavior -Tell us what should have happened. - -## Current Behavior -Tell us what happens instead of the expected behavior. - -## Step to Reproduce -Please provide the steps to reproduce the issue. diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..48fd57e --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,5 @@ +blank_issues_enabled: false +contact_links: + - name: 💬 tabi discussions + url: https://github.com/welpo/tabi/discussions + about: If you have questions or need help, feel free to ask here~ diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md deleted file mode 100644 index c109080..0000000 --- a/.github/ISSUE_TEMPLATE/feature_request.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -name: Feature request -about: Suggest an idea for this project. -title: '' -labels: enhancement -assignees: '' - ---- - -# Feature Request - -## Summary -Briefly describe what this feature request is about. - -## Motivation -Why should this feature be implemented? How will it benefit the project and its users? - -## Detailed Description -Please provide a detailed description of the proposed feature, including any suggestions you have for how it could be implemented. - -## Additional Context -Add any other context or screenshots about the feature request here. If this feature request is related to a problem, please describe it. diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 24ca7ea..643c368 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -58,6 +58,7 @@ If you need help, please ask! --> - [ ] I have verified the accessibility of my changes - [ ] I have tested all possible scenarios for this change - [ ] I have updated `theme.toml` with a sane default for the feature +- [ ] I have updated `config.toml` in [tabi-start](https://github.com/welpo/tabi-start) - [ ] I have made corresponding changes to the documentation: - [ ] Updated `config.toml` comments - [ ] Updated `theme.toml` comments diff --git a/.github/renovate.json b/.github/renovate.json index a2a9d39..65967b6 100644 --- a/.github/renovate.json +++ b/.github/renovate.json @@ -1,9 +1,13 @@ { "$schema": "https://docs.renovatebot.com/renovate-schema.json", "extends": ["config:recommended", ":automergeMinor", ":disableDependencyDashboard"], - "commitMessageAction": "chore(deps): update", "commitMessagePrefix": "⬆️", + "commitMessageAction": "chore(deps): update", + "commitMessageTopic": "{{{depName}}}", "labels": ["dependencies"], + "git-submodules": { + "enabled": true + }, "packageRules": [ { "updateTypes": ["pin"], @@ -16,6 +20,10 @@ { "updateTypes": ["rollback"], "commitMessagePrefix": "⬇️" + }, + { + "matchFileNames": ["scripts/release/**"], + "automerge": true } ] } diff --git a/.github/workflows/cd.yml b/.github/workflows/cd.yml index 89967a4..d038ece 100644 --- a/.github/workflows/cd.yml +++ b/.github/workflows/cd.yml @@ -8,12 +8,12 @@ on: jobs: deploy: name: Deploy and release - runs-on: ubuntu-22.04 + runs-on: ubuntu-24.04 permissions: contents: write steps: - name: Checkout - uses: actions/checkout@v4 + uses: actions/checkout@v5 with: fetch-depth: 0 diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index f1309c4..0eae0c1 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -15,29 +15,29 @@ jobs: if: github.event_name == 'pull_request' steps: - name: Checkout Code - uses: actions/checkout@v4 + uses: actions/checkout@v5 - name: Zola Build - uses: shalzz/zola-deploy-action@v0.19.2 + uses: shalzz/zola-deploy-action@v0.21.0 env: BUILD_ONLY: true - name: Zola Check - uses: shalzz/zola-deploy-action@v0.19.2 + uses: shalzz/zola-deploy-action@v0.21.0 env: BUILD_ONLY: true CHECK_LINKS: true build_and_deploy: name: Build and Deploy on Main Push - runs-on: ubuntu-22.04 + runs-on: ubuntu-24.04 if: github.event_name == 'push' && github.ref == 'refs/heads/main' steps: - name: Checkout Code - uses: actions/checkout@v4 + uses: actions/checkout@v5 - name: Build and Deploy - uses: shalzz/zola-deploy-action@v0.19.2 + uses: shalzz/zola-deploy-action@v0.21.0 env: PAGES_BRANCH: gh-pages TOKEN: ${{ secrets.TOKEN }} diff --git a/.github/workflows/git-sumi.yml b/.github/workflows/git-sumi.yml index b1af84c..87c68e0 100644 --- a/.github/workflows/git-sumi.yml +++ b/.github/workflows/git-sumi.yml @@ -8,14 +8,21 @@ on: - synchronize - ready_for_review +concurrency: + group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }} + cancel-in-progress: true + permissions: pull-requests: read jobs: main: name: Run git-sumi - runs-on: ubuntu-latest + runs-on: ubuntu-24.04 steps: + - name: Set header length for dependency updates + if: contains(github.event.pull_request.title, 'chore(deps)') + run: echo "GIT_SUMI_MAX_HEADER_LENGTH=80" >> $GITHUB_ENV - uses: welpo/git-sumi-action@main env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} diff --git a/.github/workflows/upgrade-deps.yml b/.github/workflows/upgrade-deps.yml new file mode 100644 index 0000000..776ad9d --- /dev/null +++ b/.github/workflows/upgrade-deps.yml @@ -0,0 +1,89 @@ +name: Dependency upgrade +on: + workflow_dispatch: + inputs: + dependency: + description: 'Dependency to upgrade' + required: true + type: choice + options: + - all + - mermaid + - katex + schedule: + - cron: '32 4 * * *' + +jobs: + upgrade-dependency: + name: Upgrade dependency + runs-on: ubuntu-24.04 + permissions: + contents: write + pull-requests: write + strategy: + matrix: + dependency: ${{ github.event_name == 'schedule' && fromJson('["mermaid", "katex"]') || fromJson(format('["{0}"]', github.event.inputs.dependency)) }} + steps: + - name: Checkout repository + uses: actions/checkout@v5 + with: + fetch-depth: 0 + + - name: Set up environment + run: | + sudo apt-get update + sudo apt-get install -y jq npm curl git + npm install uglify-js -g + uglifyjs --version + + - name: Configure GPG key + run: | + echo -n ${{ secrets.GPG_PRIVATE_KEY }} | base64 --decode | gpg --import + + - name: Configure Git + run: | + git config --global user.signingkey 33EACFE956484C3940BFEEDCE4EC28F8DFB57474 + git config --global commit.gpgsign true + git config --global user.name "welpo" + git config --global user.email "welpo@users.noreply.github.com" + + - name: Check for existing branch + id: check_branch + run: | + if git ls-remote --heads origin deps/upgrade-${{ matrix.dependency }} | grep -q deps/upgrade-${{ matrix.dependency }}; then + echo "branch_exists=true" >> $GITHUB_OUTPUT + else + echo "branch_exists=false" >> $GITHUB_OUTPUT + fi + + - name: Handle existing branch + if: steps.check_branch.outputs.branch_exists == 'true' + run: | + echo "Branch deps/upgrade-${{ matrix.dependency }} already exists." + echo "Skipping upgrade as there's already an open PR" + exit 0 + + - name: Create and switch to new branch + run: | + git checkout -b deps/upgrade-${{ matrix.dependency }} + + - name: Run upgrade script + shell: bash + run: | + if [[ "${{ matrix.dependency }}" == "all" ]]; then + bash scripts/upgrade-deps --all + else + bash scripts/upgrade-deps --${{ matrix.dependency }} + fi + + - name: Push changes and create PR + shell: bash + run: | + if git diff --quiet HEAD origin/main; then + echo "No changes to push for ${{ matrix.dependency }}" + exit 0 + fi + git push -u origin deps/upgrade-${{ matrix.dependency }} + gh pr create --fill --base main --head deps/upgrade-${{ matrix.dependency }} --label "dependencies" + env: + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} diff --git a/.gitmodules b/.gitmodules new file mode 100644 index 0000000..6fc8561 --- /dev/null +++ b/.gitmodules @@ -0,0 +1,3 @@ +[submodule "scripts/release"] + path = scripts/release + url = https://github.com/welpo/release.git diff --git a/CHANGELOG.md b/CHANGELOG.md index 9ca5465..1e90c61 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,271 @@ Welcome to the changelog for tabi. This document aims to provide a comprehensive We use Semantic Versioning (SemVer) for our version numbers, formatted as MAJOR.MINOR.PATCH. Major version changes involve significant (breaking) changes, minor versions introduce features and improvements in a backward compatible manner, and patch versions are for bug fixes and minor tweaks. +## [4.1.0](https://github.com/welpo/tabi/compare/v4.0.0..v4.1.0) - 2025-06-14 + +### ✨ Features + +- *(feed)* Add feed icon tag pages ([#522](https://github.com/welpo/tabi/issues/522)) by [@tzinm](https://github.com/tzinm) and [@welpo](https://github.com/welpo) +- *(i18n)* Add Finnish language ([#505](https://github.com/welpo/tabi/issues/505)) by [@axelkar](https://github.com/axelkar) and [@welpo](https://github.com/welpo) +- *(indieweb)* Add hidden h-card ([#506](https://github.com/welpo/tabi/issues/506)) by [@mmai](https://github.com/mmai) and [@welpo](https://github.com/welpo) +- *(socials)* Add itch.io icon ([#520](https://github.com/welpo/tabi/issues/520)) by [@mystal](https://github.com/mystal) +- *(webmentions)* Add hcard in post page ([#524](https://github.com/welpo/tabi/issues/524)) by [@mmai](https://github.com/mmai) and [@welpo](https://github.com/welpo) +- Add support for webmentions ([#485](https://github.com/welpo/tabi/issues/485)) by [@gortavoher](https://github.com/gortavoher), [@Jeremiah](https://github.com/Jeremiah) Russell, [@Henri](https://github.com/Henri) Bourcereau and [@welpo](https://github.com/welpo) +- Extend tabi `` and `` elements ([#528](https://github.com/welpo/tabi/issues/528)) by [@axis7818](https://github.com/axis7818) and [@welpo](https://github.com/welpo) +- Parse markdown in post summary & description ([#517](https://github.com/welpo/tabi/issues/517)) by [@rktjump](https://github.com/rktjump) and [@welpo](https://github.com/welpo) +- Cache bust images in shortcodes ([#504](https://github.com/welpo/tabi/issues/504)) by [@axelkar](https://github.com/axelkar) + +### 🐛 Bug fixes + +- *(feed)* Prioritise description > summary ([#525](https://github.com/welpo/tabi/issues/525)) by [@tzinm](https://github.com/tzinm) +- Render author HTML on page metadata ([7321fc5](https://github.com/welpo/tabi/commit/7321fc5a43fa50dc24c9fa87714612a2295b904a)) by [@welpo](https://github.com/welpo) +- Allow feed icon to be hidden ([#533](https://github.com/welpo/tabi/issues/533)) by [@bajacc](https://github.com/bajacc) +- Fix hcard html tags ([#508](https://github.com/welpo/tabi/issues/508)) by [@mmai](https://github.com/mmai) +- Fix external link icon breaking word wrapping ([#498](https://github.com/welpo/tabi/issues/498)) by [@welpo](https://github.com/welpo) +- Fix padding hover on links with code (custom font) ([#494](https://github.com/welpo/tabi/issues/494)) by [@clement-escolano](https://github.com/clement-escolano) + +### 💄 Styling + +- Remove extra spacing after author ([2e29782](https://github.com/welpo/tabi/commit/2e29782279d8154cb9c6f1df9a2401612ec77948)) by [@welpo](https://github.com/welpo) + +### ♻️ Refactor + +- Add "target_attribute" macro ([#515](https://github.com/welpo/tabi/issues/515)) by [@tzinm](https://github.com/tzinm) and @Óscar +- Improve error message when title is unset ([a384ac8](https://github.com/welpo/tabi/commit/a384ac80c8e6b8be46d4a335930fba697a523af9)) by [@welpo](https://github.com/welpo) + +### 🔧 Miscellaneous tasks + +- *(CI)* Fix Mermaid version detection ([e11186a](https://github.com/welpo/tabi/commit/e11186a8448f94494b350402f76a2cc5e5a98a97)) by [@welpo](https://github.com/welpo) +- *(README)* Add b1n.io to 'sites using tabi' ([#531](https://github.com/welpo/tabi/issues/531)) by [@b1nhack](https://github.com/b1nhack) +- *(README)* Fix broken link tag ([#516](https://github.com/welpo/tabi/issues/516)) by [@Olexandr88](https://github.com/Olexandr88) +- *(README)* Add tzinm's blog to 'sites using tabi' ([#496](https://github.com/welpo/tabi/issues/496)) by [@tzinm](https://github.com/tzinm) + +### 👥 New contributors + +🫶 [@gortavoher](https://github.com/gortavoher) made their first contribution in [#485](https://github.com/welpo/tabi/pull/485) + +🫶 [@bajacc](https://github.com/bajacc) made their first contribution in [#533](https://github.com/welpo/tabi/pull/533) + +🫶 [@axis7818](https://github.com/axis7818) made their first contribution in [#528](https://github.com/welpo/tabi/pull/528) + +🫶 [@b1nhack](https://github.com/b1nhack) made their first contribution in [#531](https://github.com/welpo/tabi/pull/531) + +🫶 [@tzinm](https://github.com/tzinm) made their first contribution in [#525](https://github.com/welpo/tabi/pull/525) + +🫶 [@mmai](https://github.com/mmai) made their first contribution in [#524](https://github.com/welpo/tabi/pull/524) + +🫶 [@rktjump](https://github.com/rktjump) made their first contribution in [#517](https://github.com/welpo/tabi/pull/517) + +🫶 [@mystal](https://github.com/mystal) made their first contribution in [#520](https://github.com/welpo/tabi/pull/520) + +🫶 [@axelkar](https://github.com/axelkar) made their first contribution in [#504](https://github.com/welpo/tabi/pull/504) + +🫶 [@clement-escolano](https://github.com/clement-escolano) made their first contribution in [#494](https://github.com/welpo/tabi/pull/494) + +## [4.0.0](https://github.com/welpo/tabi/compare/v3.1.0..v4.0.0) - 2025-02-16 + +### 💥 BREAKING CHANGES 💥 + +- *(archive)* Enforce chronological sorting ([#483](https://github.com/welpo/tabi/issues/483)) by [@welpo](https://github.com/welpo) +- Add tag filtering for projects ([#431](https://github.com/welpo/tabi/issues/431)) ([a783329](https://github.com/welpo/tabi/commit/a7833299fff4c753e35fa1f00667d8801f541f9a)) by [@welpo](https://github.com/welpo) + +### ✨ Features + +- *(archive)* [**‼️BREAKING‼️**] Enforce chronological sorting ([#483](https://github.com/welpo/tabi/issues/483)) by [@welpo](https://github.com/welpo) +- *(shortcodes)* Add 'aside' shortcode for side notes ([#452](https://github.com/welpo/tabi/issues/452)) by [@welpo](https://github.com/welpo) +- *(socials)* Add more Fediverse social icons ([89ad44c](https://github.com/welpo/tabi/commit/89ad44ce26d002f2f2c3baa6cf769fb8972551af)) by [@welpo](https://github.com/welpo) +- *(socials)* Add Letterboxd social icon ([0e0a391](https://github.com/welpo/tabi/commit/0e0a391ea84c3ed8b66931158ddef1e4cdd161f4)) by [@welpo](https://github.com/welpo) +- *(socials)* Add ORCID icon ([cf63855](https://github.com/welpo/tabi/commit/cf6385553c779710d1164509f3fc0d480e858ebd)) by [@welpo](https://github.com/welpo) +- Add `hide_from_main_feed` support ([#490](https://github.com/welpo/tabi/issues/490)) by [@welpo](https://github.com/welpo) +- Support Zola's native code block names ([#489](https://github.com/welpo/tabi/issues/489)) by [@welpo](https://github.com/welpo) +- Render markdown in page titles & descriptions ([#486](https://github.com/welpo/tabi/issues/486)) by [@stalkerGH](https://github.com/stalkerGH) and [@welpo](https://github.com/welpo) +- Add indicator to external links ([#443](https://github.com/welpo/tabi/issues/443)) by [@welpo](https://github.com/welpo) +- Allow setting post_listing_date per section ([a3ae897](https://github.com/welpo/tabi/commit/a3ae897c8310ba6a1da72db0fc81f19ca8993d6f)) by [@welpo](https://github.com/welpo) +- Render section content ([#484](https://github.com/welpo/tabi/issues/484)) by [@welpo](https://github.com/welpo) +- Support disabling header font-subset ([#458](https://github.com/welpo/tabi/issues/458)) by [@Nizzlay](https://github.com/Nizzlay) and [@welpo](https://github.com/welpo) +- Support using info-page.html for sections ([#455](https://github.com/welpo/tabi/issues/455)) by [@wischi-chr](https://github.com/wischi-chr) and [@welpo](https://github.com/welpo) +- Add `raw_path` parameter to image shortcodes ([#439](https://github.com/welpo/tabi/issues/439)) by [@welpo](https://github.com/welpo) +- [**‼️BREAKING‼️**] Add tag filtering for projects ([#431](https://github.com/welpo/tabi/issues/431)) ([a783329](https://github.com/welpo/tabi/commit/a7833299fff4c753e35fa1f00667d8801f541f9a)) by [@welpo](https://github.com/welpo) + +### 🐛 Bug fixes + +- *(CSP)* Improve CSP coverage ([#471](https://github.com/welpo/tabi/issues/471)) by [@stekershaw](https://github.com/stekershaw) +- *(analytics)* Update umami domain ([#448](https://github.com/welpo/tabi/issues/448)) by [@arichtman](https://github.com/arichtman) +- *(feed)* Styling now works in all website paths ([45fe170](https://github.com/welpo/tabi/commit/45fe17046704e249be3b5fbb94a3355d21149d4d)) by [@welpo](https://github.com/welpo) +- *(feed)* Load CSS in subfolder setups ([#467](https://github.com/welpo/tabi/issues/467)) by [@welpo](https://github.com/welpo) +- Adapt footnotes styling for zola 0.19.x & 0.20.x ([1c067e7](https://github.com/welpo/tabi/commit/1c067e708eac4282a2191507f046eacd9f18e0f6)) by [@welpo](https://github.com/welpo) +- Improve menu accessibility ([#482](https://github.com/welpo/tabi/issues/482)) by [@welpo](https://github.com/welpo) +- Support external URLs in menu ([#481](https://github.com/welpo/tabi/issues/481)) by [@welpo](https://github.com/welpo) +- Remove `nofollow` robots meta tag ([#465](https://github.com/welpo/tabi/issues/465)) by [@Nizzlay](https://github.com/Nizzlay) +- Show feed icon without socials ([de6fa58](https://github.com/welpo/tabi/commit/de6fa58fe3b276c12f16f9ddc1cf9f93269161f9)) by [@welpo](https://github.com/welpo) +- Add separator between update date & remote changes link ([2cc336d](https://github.com/welpo/tabi/commit/2cc336d9d0f7019015a356242230f0568658a523)) by [@welpo](https://github.com/welpo) +- Support relative paths in inherited social media card ([#432](https://github.com/welpo/tabi/issues/432)) by [@welpo](https://github.com/welpo) + +### 💄 Styling + +- *(admonitions)* Fix external link icon ([2b106b7](https://github.com/welpo/tabi/commit/2b106b7c628e01046495a3add7a9ec4cc00b9fa3)) by [@welpo](https://github.com/welpo) +- Increase emoji favicon size ([d777d5d](https://github.com/welpo/tabi/commit/d777d5d99679ab609bebb89726aef80562b30d87)) by [@welpo](https://github.com/welpo) +- Remove extra whitespace in post metadata ([dbb0e82](https://github.com/welpo/tabi/commit/dbb0e826b6572531d4c44bdb031d68207a906666)) by [@welpo](https://github.com/welpo) +- Use text-colour for hover on `rt` in links ([a6b6c32](https://github.com/welpo/tabi/commit/a6b6c3205096fd718757a6f32ff07d60bcc22808)) by [@welpo](https://github.com/welpo) +- Fix home banner layout for short intro ([#438](https://github.com/welpo/tabi/issues/438)) by [@welpo](https://github.com/welpo) +- Fix numbered code blocks on iOS Safari ([4be8a56](https://github.com/welpo/tabi/commit/4be8a5634fa2990825e9bc785029c4dddb340c39)) by [@welpo](https://github.com/welpo) +- Fix numbered code blocks ([#437](https://github.com/welpo/tabi/issues/437)) by [@welpo](https://github.com/welpo) +- Retain base code block style in admonitions ([557ea77](https://github.com/welpo/tabi/commit/557ea7786ffbad75fafdd69d864d6073fd1dadbc)) by [@welpo](https://github.com/welpo) + +### 📝 Documentation + +- *(README)* Fix typo ([#457](https://github.com/welpo/tabi/issues/457)) by [@Olexandr88](https://github.com/Olexandr88) +- *(README)* Add maintenance badges ([4834a9e](https://github.com/welpo/tabi/commit/4834a9e85ff89f1678374752289116bce6f3a076)) by [@welpo](https://github.com/welpo) +- *(demo)* Basic Arabic translation ([#390](https://github.com/welpo/tabi/issues/390)) by [@TheAwiteb](https://github.com/TheAwiteb) and [@welpo](https://github.com/welpo) +- *(series)* Add tip for custom text permalinks ([4029657](https://github.com/welpo/tabi/commit/402965786beb942aab0922de68cd98952f9a9be0)) by [@welpo](https://github.com/welpo) +- *(shortcodes)* Clarify aside usage ([1dcd615](https://github.com/welpo/tabi/commit/1dcd615615b492dffc00c34bd7e1bbc680cf95fd)) by [@welpo](https://github.com/welpo) +- *(shortcodes)* Clarify `position` parameter usage for "aside" ([da1b6bb](https://github.com/welpo/tabi/commit/da1b6bb0cc7719f3de23a6855d80dc0262d5c025)) by [@welpo](https://github.com/welpo) +- Suggest MathML in lieu of KaTeX for JS-free math ([eb03953](https://github.com/welpo/tabi/commit/eb0395352caffab67f1ad9b81aab51824e9feb54)) by [@welpo](https://github.com/welpo) +- Add tabi-start integration ([#441](https://github.com/welpo/tabi/issues/441)) by [@welpo](https://github.com/welpo) + +### ♻️ Refactor + +- Only show project tag filter with 2 or more tags ([180fc53](https://github.com/welpo/tabi/commit/180fc533844ec3427c447f7040ea837520c4fe5d)) by [@welpo](https://github.com/welpo) + +### 🔧 Miscellaneous tasks + +- *(CI)* Add concurrency control to sumi action ([47ea26d](https://github.com/welpo/tabi/commit/47ea26db97cfbd87518ab00b892fdbb245577535)) by [@welpo](https://github.com/welpo) +- *(CI)* Add dependencies label to upgrade PRs ([551b3d2](https://github.com/welpo/tabi/commit/551b3d28c6852c3a1e7acf3c645e0d7b84e079cb)) by [@welpo](https://github.com/welpo) +- *(CI)* Ignore deleted files in pre-commit ([f93def0](https://github.com/welpo/tabi/commit/f93def0692146a15b63d19406ec1180b9e41ba3d)) by [@welpo](https://github.com/welpo) +- *(README)* Add idle-ti.me blog to sites using tabi ([#479](https://github.com/welpo/tabi/issues/479)) by [@be-next](https://github.com/be-next) +- *(README)* Add zzmzaw's blog to sites using tabi ([#469](https://github.com/welpo/tabi/issues/469)) by [@ZzMzaw](https://github.com/ZzMzaw) +- *(README)* Add nizzlay.com to Sites using tabi ([#464](https://github.com/welpo/tabi/issues/464)) by [@Nizzlay](https://github.com/Nizzlay) +- *(README)* Add szabolcs.me to Sites using tabi ([#451](https://github.com/welpo/tabi/issues/451)) by [@szabolcsf](https://github.com/szabolcsf) +- *(README)* Set original colours for docs|up badge ([69713c9](https://github.com/welpo/tabi/commit/69713c973c11d7646c8fe56476261d96cc1978d8)) by [@welpo](https://github.com/welpo) +- *(deps)* Check for existing branch upgrades ([29bbd2e](https://github.com/welpo/tabi/commit/29bbd2eecc97aaaa95c61f8fb736d1301042aa91)) by [@welpo](https://github.com/welpo) +- *(docs)* Fix Series section headings ([0778212](https://github.com/welpo/tabi/commit/077821208f161e813da90c56db817b743bc211c4)) by [@welpo](https://github.com/welpo) +- *(docs)* Use internal links in home description ([0b10560](https://github.com/welpo/tabi/commit/0b10560a94f4a0a4bcb8536ee0595e8c4f4df800)) by [@welpo](https://github.com/welpo) +- *(projects)* Add nemui project ([11eb774](https://github.com/welpo/tabi/commit/11eb774bd74562a4628f87a130575281aa469918)) by [@welpo](https://github.com/welpo) +- *(upgrade-deps)* Improve version detection ([0688628](https://github.com/welpo/tabi/commit/06886284202f670be2034dcedbf6130446b91436)) by [@welpo](https://github.com/welpo) +- Add "shuku" project ([e1b6054](https://github.com/welpo/tabi/commit/e1b60542dfc3eb9bed39a92d3b7acfae88f32b84)) by [@welpo](https://github.com/welpo) +- Add ずつ (zutsu) project page ([c6d1c3d](https://github.com/welpo/tabi/commit/c6d1c3dff844461c7c774882dec8a87d7d3ea548)) by [@welpo](https://github.com/welpo) +- Fix dōteki docs link ([c15098a](https://github.com/welpo/tabi/commit/c15098a959242765353c7fab0906d1fc596c64c0)) by [@welpo](https://github.com/welpo) +- Update git-sumi & dōteki projects ([6d44320](https://github.com/welpo/tabi/commit/6d44320f45bc381c65e370f8f03bf3525b59e05a)) by [@welpo](https://github.com/welpo) + +### 👥 New contributors + +🫶 [@stalkerGH](https://github.com/stalkerGH) made their first contribution in [#486](https://github.com/welpo/tabi/pull/486) + +🫶 [@stekershaw](https://github.com/stekershaw) made their first contribution in [#471](https://github.com/welpo/tabi/pull/471) + +🫶 [@Nizzlay](https://github.com/Nizzlay) made their first contribution in [#465](https://github.com/welpo/tabi/pull/465) + +🫶 [@Olexandr88](https://github.com/Olexandr88) made their first contribution in [#457](https://github.com/welpo/tabi/pull/457) + +🫶 [@wischi-chr](https://github.com/wischi-chr) made their first contribution in [#455](https://github.com/welpo/tabi/pull/455) + +🫶 [@szabolcsf](https://github.com/szabolcsf) made their first contribution in [#451](https://github.com/welpo/tabi/pull/451) + +## [3.1.0](https://github.com/welpo/tabi/compare/v3.0.0..v3.1.0) - 2024-11-14 + +### ✨ Features + +- *(shortcodes)* Support body admonitions ([#423](https://github.com/welpo/tabi/issues/423)) by [@welpo](https://github.com/welpo) +- Allow pinned posts with pagination ([#428](https://github.com/welpo/tabi/issues/428)) by [@welpo](https://github.com/welpo) +- Add pinned posts functionality ([#424](https://github.com/welpo/tabi/issues/424)) by [@welpo](https://github.com/welpo) +- Add series functionality ([#406](https://github.com/welpo/tabi/issues/406)) by [@ZzMzaw](https://github.com/ZzMzaw) and [@welpo](https://github.com/welpo) + +### 🐛 Bug fixes + +- Link to "All posts" in non-default-language root ([3b7fd3d](https://github.com/welpo/tabi/commit/3b7fd3db9c33fd3ca6114ca00fffa2a91f682a0a)) by [@welpo](https://github.com/welpo) +- Isso comments in multilingual setups ([#427](https://github.com/welpo/tabi/issues/427)) by [@welpo](https://github.com/welpo) + +### 💄 Styling + +- Colour scrollbar to match primary colour ([#430](https://github.com/welpo/tabi/issues/430)) by [@welpo](https://github.com/welpo) +- Set accent color to match theme ([#429](https://github.com/welpo/tabi/issues/429)) by [@welpo](https://github.com/welpo) +- Fix info admonition code color ([5927409](https://github.com/welpo/tabi/commit/5927409c41e71d6943deee426fc75a94037cee36)) by [@welpo](https://github.com/welpo) +- Improve navigation bar & metadata wrapping ([#425](https://github.com/welpo/tabi/issues/425)) by [@welpo](https://github.com/welpo) +- Fix hover color for element in links ([87f1099](https://github.com/welpo/tabi/commit/87f1099caa8741bcacadf2aae2677a529395e454)) by [@welpo](https://github.com/welpo) +- Add styling for keyboard input ([51fee5d](https://github.com/welpo/tabi/commit/51fee5d660232a1eafeb39f439fe5377f3f63406)) by [@welpo](https://github.com/welpo) + +### 📝 Documentation + +- *(README)* Fix typo ([#421](https://github.com/welpo/tabi/issues/421)) by [@ZzMzaw](https://github.com/ZzMzaw) +- Highlight pinned posts feature ([c3c344a](https://github.com/welpo/tabi/commit/c3c344a76fb894ec87fc9896e7a0202788e001c5)) by [@welpo](https://github.com/welpo) +- Clarify instructions for listing recent posts ([#418](https://github.com/welpo/tabi/issues/418)) ([3442fd9](https://github.com/welpo/tabi/commit/3442fd9ff0c0a093f08bb27aaa0d92e5993df29b)) by [@welpo](https://github.com/welpo) + +### ♻️ Refactor + +- *(GitHub)* Update issue templates ([5687f3b](https://github.com/welpo/tabi/commit/5687f3bacb6ed69ffbe4143e93b6c95ce8fb5c59)) by [@welpo](https://github.com/welpo) + +### 🔧 Miscellaneous tasks + +- *(CI)* Allow longer PR titles for dep updates ([e2c5c6e](https://github.com/welpo/tabi/commit/e2c5c6e9b749c3591af6a822eee65c1ee1854c01)) by [@welpo](https://github.com/welpo) +- *(CI)* Allow longer PR titles for dep updates ([fa9f160](https://github.com/welpo/tabi/commit/fa9f16034241ccee6229ef0279b3b9bc65249cfa)) by [@welpo](https://github.com/welpo) +- *(CI)* Allow longer PR titles for dep updates ([bd45a1a](https://github.com/welpo/tabi/commit/bd45a1ae45997b950c703d1ebf1e34b3b82173eb)) by [@welpo](https://github.com/welpo) +- *(deps)* Remove local release script ([2e3cff2](https://github.com/welpo/tabi/commit/2e3cff2ef1ca8396c632de48b21174601d5ff46c)) by [@welpo](https://github.com/welpo) +- *(projects)* Add ラム (ramu) project ([f300129](https://github.com/welpo/tabi/commit/f3001298c24d49d234247c9cce2a6c771778c1c3)) by [@welpo](https://github.com/welpo) +- Change codeblock language from plaintext to txt ([57a0a8e](https://github.com/welpo/tabi/commit/57a0a8e1a09d586acdf5c72464d79328e0c9b27f)) by [@welpo](https://github.com/welpo) + +## [3.0.0](https://github.com/welpo/tabi/compare/v2.17.0..v3.0.0) - 2024-10-18 + +### 💥 BREAKING CHANGES 💥 + +- Force code blocks LTR rendering ([#412](https://github.com/welpo/tabi/issues/412)) ([092ccdd](https://github.com/welpo/tabi/commit/092ccdd1ba8bf08cc738664ba4fbe9e7a0ff282e)) by [@welpo](https://github.com/welpo) + +### ✨ Features + +- Add force_text_direction shortcode ([#414](https://github.com/welpo/tabi/issues/414)) ([c9f8d27](https://github.com/welpo/tabi/commit/c9f8d27b962217ff0fb09b30ec14aee65fe8518d)) by [@welpo](https://github.com/welpo) +- [**‼️BREAKING‼️**] Force code blocks LTR rendering ([#412](https://github.com/welpo/tabi/issues/412)) ([092ccdd](https://github.com/welpo/tabi/commit/092ccdd1ba8bf08cc738664ba4fbe9e7a0ff282e)) by [@welpo](https://github.com/welpo) + +### 🐛 Bug fixes + +- Update CSP for GoatCounter ([#413](https://github.com/welpo/tabi/issues/413)) by [@noeddl](https://github.com/noeddl) + +### 📝 Documentation + +- *(CONTRIBUTING)* Fix broken link to commit message style ([11e246a](https://github.com/welpo/tabi/commit/11e246a876eef846e8c1e26add7331f25beb9c27)) by [@welpo](https://github.com/welpo) +- *(mastering tabi)* Mention social links rel='me' ([5db70b7](https://github.com/welpo/tabi/commit/5db70b7978e7141be9396d3f69375a87b2d44ed2)) by [@welpo](https://github.com/welpo) + +### 🔧 Miscellaneous tasks + +- Update git-cliff variables to `commit.remote` ([0a36ef5](https://github.com/welpo/tabi/commit/0a36ef55ee092fe7bb1f8803c04a4cb8245b2a13)) by [@welpo](https://github.com/welpo) + +### 👥 New contributors + +🫶 [@noeddl](https://github.com/noeddl) made their first contribution in [#413](https://github.com/welpo/tabi/pull/413) + +## [2.17.0](https://github.com/welpo/tabi/compare/v2.16.0..v2.17.0) - 2024-10-10 + +### ✨ Features + +- Add fediverse creator metadata support ([#409](https://github.com/welpo/tabi/issues/409)) by [@arichtman](https://github.com/arichtman), [@Ariel](https://github.com/Ariel) Richtman and [@welpo](https://github.com/welpo) + +### 🐛 Bug fixes + +- *(search)* Restore highlighting functionality ([#401](https://github.com/welpo/tabi/issues/401)) by [@welpo](https://github.com/welpo) +- Set proper URL for self-hosted Umami ([#402](https://github.com/welpo/tabi/issues/402)) by [@soumendrak](https://github.com/soumendrak) + +### 📝 Documentation + +- Add mermaid shortcode usage ([#407](https://github.com/welpo/tabi/issues/407)) by [@ZzMzaw](https://github.com/ZzMzaw) and [@welpo](https://github.com/welpo) +- Update comment in config.toml RE: #402 ([c50edbd](https://github.com/welpo/tabi/commit/c50edbd453eca2f031bc97a5a25caa206644d568)) by [@welpo](https://github.com/welpo) + +### ♻️ Refactor + +- *(search)* Reduce search lag on mobile ([7ceada9](https://github.com/welpo/tabi/commit/7ceada974b7c3f2c52aaa5688af631c806901aed)) by [@welpo](https://github.com/welpo) + +### 🔧 Miscellaneous tasks + +- *(README)* Add jmbhughes.com to showcase ([#404](https://github.com/welpo/tabi/issues/404)) by [@jmbhughes](https://github.com/jmbhughes) +- *(deps)* Replace local release script w/ git submodule ([66239be](https://github.com/welpo/tabi/commit/66239bee016406c87a227b685eb70a464546e199)) by [@welpo](https://github.com/welpo) +- *(deps)* Automate KaTeX/mermaid upgrades ([fc04ab4](https://github.com/welpo/tabi/commit/fc04ab4e40977bafa1b821c77e38554d287f69bc)) by [@welpo](https://github.com/welpo) +- Reformat social card creation tip ([47fcee8](https://github.com/welpo/tabi/commit/47fcee8f81fb10bcd7cc042cc4a80dcada244b6d)) by [@welpo](https://github.com/welpo) + +### 👥 New contributors + +🫶 [@github-actions](https://github.com/github-actions)[bot] made their first contribution in [#405](https://github.com/welpo/tabi/pull/405) + +🫶 [@jmbhughes](https://github.com/jmbhughes) made their first contribution in [#404](https://github.com/welpo/tabi/pull/404) + +🫶 [@soumendrak](https://github.com/soumendrak) made their first contribution in [#402](https://github.com/welpo/tabi/pull/402) + ## [2.16.0](https://github.com/welpo/tabi/compare/v2.15.0..v2.16.0) - 2024-09-22 ### ✨ Features @@ -43,7 +308,7 @@ We use Semantic Versioning (SemVer) for our version numbers, formatted as MAJOR. ### ✨ Features -- *(i18n)* Add Odia language ([#372](https://github.com/welpo/tabi/issues/372)) by [@soumendrak](https://github.com/soumendrak) +- *(i18n)* Add Odia language ([#372](https://github.com/welpo/tabi/issues/372)) - *(i18n)* Add Estonian language ([#365](https://github.com/welpo/tabi/issues/365)) by [@NippleOfAnApe](https://github.com/NippleOfAnApe) - Add Mermaid diagram support ([#370](https://github.com/welpo/tabi/issues/370)) by [@welpo](https://github.com/welpo) @@ -74,7 +339,7 @@ We use Semantic Versioning (SemVer) for our version numbers, formatted as MAJOR. ### 👥 New contributors -🫶 [@soumendrak](https://github.com/soumendrak) made their first contribution in [#372](https://github.com/welpo/tabi/pull/372) +🫶 @ made their first contribution in [#372](https://github.com/welpo/tabi/pull/372) 🫶 [@DataTriny](https://github.com/DataTriny) made their first contribution in [#367](https://github.com/welpo/tabi/pull/367) @@ -114,6 +379,8 @@ We use Semantic Versioning (SemVer) for our version numbers, formatted as MAJOR. 🫶 [@sam9032](https://github.com/sam9032) made their first contribution in [#355](https://github.com/welpo/tabi/pull/355) +🫶 [@renovate](https://github.com/renovate)[bot] made their first contribution in [#345](https://github.com/welpo/tabi/pull/345) + ## [2.12.0](https://github.com/welpo/tabi/compare/v2.11.0..v2.12.0) - 2024-06-29 ### ✨ Features @@ -139,7 +406,7 @@ We use Semantic Versioning (SemVer) for our version numbers, formatted as MAJOR. ### ✨ Features -- *(socials)* Add bluesky icon ([#333](https://github.com/welpo/tabi/issues/333)) by [@gacallea](https://github.com/gacallea) +- *(socials)* Add bluesky icon ([#333](https://github.com/welpo/tabi/issues/333)) by [@andreacfromtheapp](https://github.com/andreacfromtheapp) - Allow HTML tags in multilingual quote author ([be7628a](https://github.com/welpo/tabi/commit/be7628aeaa573b69739a2751e93d77da0b587124)) by [@welpo](https://github.com/welpo) ### 🐛 Bug fixes @@ -163,7 +430,7 @@ We use Semantic Versioning (SemVer) for our version numbers, formatted as MAJOR. ### 👥 New contributors -🫶 [@gacallea](https://github.com/gacallea) made their first contribution in [#333](https://github.com/welpo/tabi/pull/333) +🫶 [@andreacfromtheapp](https://github.com/andreacfromtheapp) made their first contribution in [#333](https://github.com/welpo/tabi/pull/333) ## [2.10.0](https://github.com/welpo/tabi/compare/v2.9.0..v2.10.0) - 2024-05-30 @@ -305,6 +572,10 @@ We use Semantic Versioning (SemVer) for our version numbers, formatted as MAJOR. - *(release)* Replace both pull and issue links ([e951e95](https://github.com/welpo/tabi/commit/e951e951102249707a4c899f0d194b781c3466d2)) by [@welpo](https://github.com/welpo) +### 👥 New contributors + +🫶 [@be-next](https://github.com/be-next) made their first contribution in [#284](https://github.com/welpo/tabi/pull/284) + ## [2.4.0](https://github.com/welpo/tabi/compare/v2.3.0..v2.4.0) - 2024-03-02 ### ✨ Features @@ -397,6 +668,10 @@ We use Semantic Versioning (SemVer) for our version numbers, formatted as MAJOR. - Update changelog sections ([0e6c5c2](https://github.com/welpo/tabi/commit/0e6c5c269177712ae58649fe24662b407315d3f1)) by [@welpo](https://github.com/welpo) - Add continuous deployment workflow ([9b8b139](https://github.com/welpo/tabi/commit/9b8b1396cfaeefd61050cdf49bf81f01977e5899)) by [@welpo](https://github.com/welpo) +### 👥 New contributors + +🫶 [@TheAwiteb](https://github.com/TheAwiteb) made their first contribution in [#264](https://github.com/welpo/tabi/pull/264) + ## [2.1.0](https://github.com/welpo/tabi/compare/v2.0.0..v2.1.0) - 2024-01-29 ### ✨ Features @@ -450,6 +725,10 @@ We use Semantic Versioning (SemVer) for our version numbers, formatted as MAJOR. - *(home-banner)* [**‼️BREAKING‼️**] Force proper header.img path ([#254](https://github.com/welpo/tabi/issues/254)) by [@welpo](https://github.com/welpo) - *(i18n)* [**‼️BREAKING‼️**] Force config.toml copyright translation ([#255](https://github.com/welpo/tabi/issues/255)) ([9f39b7f](https://github.com/welpo/tabi/commit/9f39b7fe47721eb7aaea04d8b9ee66b557b7eabf)) by [@welpo](https://github.com/welpo) +### 👥 New contributors + +🫶 [@arichtman](https://github.com/arichtman) made their first contribution in [#231](https://github.com/welpo/tabi/pull/231) + ## 1.0.0 - 2023-12-29 ### 💥 BREAKING CHANGES 💥 @@ -990,6 +1269,10 @@ We use Semantic Versioning (SemVer) for our version numbers, formatted as MAJOR. ### 👥 New contributors +🫶 [@welpo](https://github.com/welpo) made their first contribution + +🫶 [@ZzMzaw](https://github.com/ZzMzaw) made their first contribution in [#215](https://github.com/welpo/tabi/pull/215) + 🫶 [@joberthrogers18](https://github.com/joberthrogers18) made their first contribution in [#219](https://github.com/welpo/tabi/pull/219) 🫶 [@xvello](https://github.com/xvello) made their first contribution in [#218](https://github.com/welpo/tabi/pull/218) @@ -1004,6 +1287,8 @@ We use Semantic Versioning (SemVer) for our version numbers, formatted as MAJOR. 🫶 [@sandman](https://github.com/sandman) made their first contribution in [#170](https://github.com/welpo/tabi/pull/170) +🫶 [@Smtbook](https://github.com/Smtbook) made their first contribution in [#166](https://github.com/welpo/tabi/pull/166) + 🫶 [@SeaDve](https://github.com/SeaDve) made their first contribution in [#165](https://github.com/welpo/tabi/pull/165) 🫶 [@stevenroose](https://github.com/stevenroose) made their first contribution in [#124](https://github.com/welpo/tabi/pull/124) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 0096eb4..42e6424 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -25,7 +25,7 @@ Working on your first Pull Request? You can learn how from this free video serie Please make sure the following is done when submitting a pull request: 1. **Keep your PR small**. Small pull requests are much easier to review and more likely to get merged. Make sure the PR does only one thing, otherwise please split it. -2. **Use descriptive titles**. It is recommended to follow this [commit message style](#conventional-commit-messages). +2. **Use descriptive titles**. It is recommended to follow this [commit message style](#conventional-commit-messages-with-gitmoji). 3. **Test your changes**. Make sure to test different configurations that might affect your changes. 4. **Fill the PR template**. The template will guide you through the process of submitting a PR. @@ -37,7 +37,7 @@ Format: ` (): ` `` is an emoji from the [gitmoji](https://gitmoji.dev/) list. It makes it easier to visually scan the commit history and quickly grasp the purpose of changes. -`` is optional. If your change affects a specific part of the codebase, consider adding the scope. Scopes should be brief but recognizable, e.g. `config`, `gitmoji`, or `cli`. +`` is optional. If your change affects a specific part of the codebase, consider adding the scope. Scopes should be brief but recognizable, e.g. `config`, `feed`, or `search`. The various types of commits: @@ -47,7 +47,7 @@ The various types of commits: - `docs`: a change to the website or other Markdown documents. - `refactor`: a change to code that doesn't change behaviour, e.g. splitting files, renaming internal variables, improving code style… - `chore`: upgrading dependencies, releasing new versions… Chores that are **regularly done** for maintenance purposes. -- `misc`: anything else that doesn't change production code, yet is not `test` or `chore`. e.g. updating GitHub actions workflow. +- `misc`: anything else that doesn't change production code, yet is not `chore`. e.g. updating GitHub actions workflow. The commits within your PR don't need to follow this convention (we'll [squash them](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/configuring-commit-squashing-for-pull-requests)). However, the PR title should be in this format. If you're not sure about the title, don't worry, we'll help you fix it. Your code is more important than conventions! diff --git a/README.md b/README.md index 812ff15..595f5f6 100644 --- a/README.md +++ b/README.md @@ -5,22 +5,29 @@ Contributors Forks - + Last commit
Latest release - Documentation + Documentation License Clean commits + + Average time to resolve an issue + + Percentage of issues still open

-# tabi +# 🌱 tabi -A fast, lightweight, and modern [Zola](https://www.getzola.org) theme with multi-language support. It aims to be a personal page and home to blog posts. +An accessible [Zola](https://www.getzola.org) theme with [search](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#search), [multi-language support](https://welpo.github.io/tabi/blog/faq-languages/), [optional JavaScript](https://welpo.github.io/tabi/blog/javascript/), a perfect Lighthouse score, and [comprehensive documentation](https://welpo.github.io/tabi). Crafted for personal websites and blogs. + +> [!TIP] +> Want to start blogging right away? Use the [tabi-start template](https://github.com/welpo/tabi-start) to get a complete site up and running in minutes. See a live preview (and the theme's documentation) [here](https://welpo.github.io/tabi). @@ -38,15 +45,18 @@ tabi has a perfect score on Google's Lighthouse audit: - [X] [Set any language as default](https://welpo.github.io/tabi/blog/faq-languages/#how-do-i-set-a-default-language-for-my-site). Set your base site to Chinese, Spanish, French, Hindi… or any [other supported language](/i18n). The theme's interface will be translated accordingly. - [X] [Integration with remote repositories](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#git-repository-integration) on GitHub, GitLab, Gitea & Codeberg for commit history and showing the site source. +- [X] [Series support](https://welpo.github.io/tabi/blog/series/) for creating sequential content like tutorials, courses, and multi-part stories. - [X] Dark and light themes. Defaults to the OS setting, with a switcher in the navigation bar. - [X] Thorough documentation. See [Mastering tabi Settings: A Comprehensive Guide](https://welpo.github.io/tabi/blog/mastering-tabi-settings/). - [X] Perfect Lighthouse score (Performance, Accessibility, Best Practices and SEO). - [X] [Comprehensive multi-language support](https://welpo.github.io/tabi/blog/faq-languages/#how-does-tabi-handle-multilingual-support). Add as many languages as you wish. - [X] Support for [comments using giscus, utterances, Hyvor Talk, or Isso](https://welpo.github.io/tabi/blog/comments/). +- [X] [Indieweb](https://indieweb.org/) ready with microformats, [hcard](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#representative-h-card) and [webmentions](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#webmentions) support. - [X] Code syntax highlighting with colours based on [Catppuccin](https://github.com/catppuccin/catppuccin) Frappé. - [X] [Mermaid support](https://welpo.github.io/tabi/blog/shortcodes/#mermaid-diagrams) to create diagrams and charts with text. - [X] [Local search](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#search) with an accessible, multi-lingual interface. - [X] [Custom Twitter card](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#social-media-cards) and automatic Open Graph tags. +- [X] Anonymous [like buttons](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#iine) powered by [iine](https://iine.to). - [X] [KaTeX](https://katex.org/) support for mathematical notation. - [X] [Stylized and human readable Atom feed](https://welpo.github.io/tabi/atom.xml). - [X] [Stylized and human readable sitemap](https://welpo.github.io/tabi/sitemap.xml). @@ -64,11 +74,17 @@ tabi has a perfect score on Google's Lighthouse audit: - [X] Responsive design. - [X] [Projects page](https://welpo.github.io/tabi/projects/). - [X] [Archive page](https://welpo.github.io/tabi/archive/). +- [X] [Pinned posts](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#pinning-posts). - [X] [Social links](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#social-media-icons). - [X] [Tags](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#tags). ## Installation +> [!NOTE] +> The fastest way to create a new site is to use the [tabi-start template](https://github.com/welpo/tabi-start). This gives you a complete blog setup with all the essential configuration ready to go. + +### Manual installation + To add tabi to you existing Zola site: 0. Initialize a Git repository in your project directory (if you haven't already): @@ -111,24 +127,40 @@ highlight_code = true highlight_theme = "css" ``` -5. Create a `content/_index.md` file with the following content: +5. Create a `content/_index.md` file. This file controls how your home page looks and behaves. Choose one of the following options: -``` -+++ -title = "Home" -paginate_by = 5 # Set the number of posts per page -template = "index.html" -+++ -``` + **Option A: Serve posts from `/`**: -If you want to serve your blog posts from a different path, such as `blog/`, add a `section_path` in the `[extra]` section of `content/_index.md` (this file will need pagination): + ``` + +++ + title = "Home" + paginate_by = 5 # Show 5 posts per page. + +++ + ``` -``` -[extra] -section_path = "blog/_index.md" -``` + - This will display posts in `content/` with pagination. -**Note**: use the full path to the section's `_index.md` file. Simply using `section_path = "blog/"` will not work. + **Option B: Serve posts from a different path (e.g., `blog/`)**: + + ``` + +++ + title = "Home" + # Note we're not setting `paginate_by` here. + + [extra] + section_path = "blog/_index.md" # Where to find your posts. + max_posts = 5 # Show 5 posts on the home page. + +++ + ``` + + - This will display the latest 5 posts from the `blog/` section. + - Do not set `paginate_by` if you choose this option. + - Use the full path to the section's `_index.md` file. Using `section_path = "blog/"` will not work. + +> [!WARNING] +> Do not set both `paginate_by` and `section_path` in `content/_index.md`. +> +> These settings are mutually exclusive and using both may result in no posts being displayed. 6. If you want an introduction section (see screenshot above), add these lines to `content/_index.md`: @@ -175,23 +207,37 @@ git pull | Website | Creator | Description | Site Source | | - | - | - | - | | [osc.garden](https://osc.garden) | Óscar Fernández ([welpo](https://github.com/welpo)) | Data science, psychology, and Zola | [Source](https://github.com/welpo/osc.garden) | -| [sandip.live](https://sandip.live) | Sandip G ([sandman](https://github.com/sandman)) | Startups, tech and the good life | [Source](https://github.com/sandman/sandman.github.io) | | [seadve.github.io](https://seadve.github.io/) | Dave Patrick Caberto ([SeaDve](https://github.com/SeaDve/)) | Personal blog and portfolio with custom CSS | [Source](https://github.com/SeaDve/seadve.github.io) | | [mikufan.page](https://mikufan.page) | [Nadia](https://github.com/nyadiia) | Personal blog | [Source](https://github.com/nyadiia/mikufan.page) | | [tim-boettcher.online](https://tim-boettcher.online/) | [Tim Böttcher](https://codeberg.org/Tim-Boettcher/) | Insights and ramblings of a deafblind programmer | [Source](https://codeberg.org/Tim-Boettcher/tim-boettcher-online/) | | [www.richtman.au](https://www.richtman.au) | [Ariel Richtman](https://github.com/arichtman) | Personal tech blog | [Source](https://github.com/arichtman/www.richtman.au) | | [Ponderosa Games](https://ponderosagames.com/) | John Burak ([JVimes](https://github.com/jvimes)) | A friendly indie game company | — | - +| [jmbhughes.com](https://jmbhughes.com/) | Marcus Hughes ([jmbhughes](https://github.com/jmbhughes)) | Personal blog | [Source](https://github.com/jmbhughes/jmbhughes.github.io) | +| [szabolcs.me](https://szabolcs.me) | Szabolcs Fazekas ([szabolcsf](https://github.com/szabolcsf)) | Personal blog | [Source](https://github.com/szabolcsf/szabolcs.me) | +| [Nizzlay](https://nizzlay.com) | Niels Gouman ([Nizzlay](https://github.com/Nizzlay)) | Personal blog | [Source](https://github.com/Nizzlay/nizzlay.com) | +| [ZzMzaw's blog](https://zzmzaw.github.io/) | ZzMzaw ([ZzMzaw](https://github.com/ZzMzaw)) | Personal blog | [Source](https://github.com/ZzMzaw/zzmzaw.github.io) | +| [idle-ti.me](https://idle-ti.me/) | Jérôme Ramette ([be-next](https://github.com/be-next)) | Personal blog | [Source](https://github.com/be-next/idle-ti.me) | +| [tzinm.me](https://tzinm.me/) | [Tzinm](https://github.com/tzinm) | Personal blog | [Source](https://codeberg.org/tzinm/blog) | +| [b1n.io](https://b1n.io) | [b1nhack](https://github.com/b1nhack) | Linux kernel vulnerability researcher | [Source](https://github.com/b1nhack/blog) | +| [posixlycorrect.com](https://posixlycorrect.com/) | [Fabian Montero](https://git.posixlycorrect.com/fabian) | Personal homepage | [Source](https://git.posixlycorrect.com/fabian/homepage) | Using tabi? Feel free to create a PR and add your site to this list. ## Inspiration This theme was inspired by: -- [shadharon](https://github.com/syedzayyan/shadharon) — tabi started as a fork of [syedzayyan](https://github.com/syedzayyan)'s theme; -- [tailwind-nextjs-starter-blog](https://github.com/timlrx/tailwind-nextjs-starter-blog); -- [abridge](https://github.com/Jieiku/abridge); -- [internetVin's blog](https://internetvin.ghost.io). + +- [shadharon](https://github.com/syedzayyan/shadharon) — tabi started as a fork of [syedzayyan](https://github.com/syedzayyan)'s theme +- [tailwind-nextjs-starter-blog](https://github.com/timlrx/tailwind-nextjs-starter-blog) +- [abridge](https://github.com/Jieiku/abridge) + +## Support + +Something not working? Have an idea? Let us know! + +- Questions? → [Start a discussion](https://github.com/welpo/tabi/discussions) +- Found a bug? → [Report it here](https://github.com/welpo/tabi/issues/new?&labels=bug&template=2_bug_report.yml) +- Feature request? → [Tell us more!](https://github.com/welpo/tabi/issues/new?&labels=feature&template=3_feature_request.yml) ## Contributing diff --git a/cliff.toml b/cliff.toml index 360bd75..9e9dc97 100644 --- a/cliff.toml +++ b/cliff.toml @@ -37,7 +37,7 @@ body = """ {% macro commit(commit, in_breaking_section=false) -%} - {% if commit.scope %}*({{ commit.scope }})* {% endif %}{% if commit.breaking and not in_breaking_section %}[**‼️BREAKING‼️**] {% endif %}\ {{ commit.message | upper_first }}\ - {% if not commit.github.pr_number %} ([{{ commit.id | truncate(length=7, end="") }}]({{ self::remote_url() }}/commit/{{ commit.id }})){%- endif -%}{% if commit.github.username %} by @{{ commit.github.username }} \ + {% if not commit.remote.pr_number %} ([{{ commit.id | truncate(length=7, end="") }}]({{ self::remote_url() }}/commit/{{ commit.id }})){%- endif -%}{% if commit.remote.username %} by @{{ commit.remote.username }} \ {%- set co_authors = commit.footers | filter(attribute="token", value="Co-authored-by") | map(attribute="value") -%} {%- set number_of_co_authors = co_authors | length -%} {%- for co_author in co_authors -%} diff --git a/config.toml b/config.toml index cf0c4e5..a62acbe 100644 --- a/config.toml +++ b/config.toml @@ -1,14 +1,14 @@ base_url = "https://welpo.github.io/tabi" title = "~/tabi" -description = "tabi is a fast, lightweight, and modern Zola theme with multi-language support, optional JavaScript, and a perfect Lighthouse score." +description = "tabi is an accessible Zola theme with search, multi-language support, optional JavaScript, a perfect Lighthouse score, and comprehensive documentation. Crafted for personal websites and blogs." author = "welpo" generate_feeds = true compile_sass = true minify_html = true build_search_index = true -# To translate the entire theme, there must be a file with the same ISO 639-1 -# (or IETF BCP 47) Code in the `i18n` folder of your site or the tabi theme +# To translate the entire theme, there must be a file with the same language code +# in the `i18n` folder of your site or the tabi theme. # For example, "i18n/fr.toml" for French or "i18n/zh-Hans.toml" for Simplified Chinese. # Otherwise the theme will be in English. # See https://welpo.github.io/tabi/blog/faq-languages/ for more details. @@ -28,7 +28,7 @@ include_content = true # At which character to truncate the content to. Useful if you have a lot of pages and the index would # become too big to load on the site. Defaults to not being set. # truncate_content_length = 100 -# Wether to produce the search index as a javascript file or as a JSON file. +# Whether to produce the search index as a javascript file or as a JSON file. # Accepted value "elasticlunr_javascript" or "elasticlunr_json". index_format = "elasticlunr_json" @@ -38,6 +38,8 @@ bottom_footnotes = true # To use a Zola built-in theme, CSP needs to allow unsafe-inline for style-src. highlight_theme = "css" smart_punctuation = true +# Set to 'external' to add an indicator next to external links. +external_links_class = "external" [link_checker] internal_level = "warn" @@ -50,17 +52,24 @@ skip_anchor_prefixes = [ [languages.es] title = "~/tabi" -description = "tabi es un tema de Zola rápido, liviano y moderno con JavaScript opcional y una puntuación perfecta en Lighthouse." +description = "tabi es un tema accesible para Zola con búsqueda, soporte multilingüe, JavaScript opcional, una puntuación perfecta en Lighthouse y documentación exhaustiva. Diseñado para sitios web y blogs personales." generate_feeds = true taxonomies = [{name = "tags", feed = true}] build_search_index = true [languages.ca] title = "~/tabi" -description = "tabi és un tema de Zola ràpid, lleuger i modern amb JavaScript opcional i una puntuació perfecta a Lighthouse." +description = "tabi és un tema accessible per a Zola amb cerca, suport multilingüe, JavaScript opcional, una puntuació perfecta a Lighthouse i documentació exhaustiva. Dissenyat per a llocs web i blogs personals." generate_feeds = true taxonomies = [{name = "tags", feed = true}] +[languages.ar] +title = "~/تابي" +description = "تابي هو قالب Zola سريع وحديث مع دعم متعدد اللغات و JavaScript اختياري ودرجة Lighthouse مثالية." +generate_feeds = true +taxonomies = [{name = "tags", feed = true}] +build_search_index = false + [extra] # Check out the documentation (or the comments below) to learn how to customise tabi: # https://welpo.github.io/tabi/blog/mastering-tabi-settings/ @@ -99,6 +108,9 @@ skin = "" browser_theme_color = "#087e96" # browser_theme_color = ["#ffffff", "#000000"] # Example of light/dark colours. +# For multilingual sites: show current language code on the language switcher. +show_selected_language_code_in_language_switcher = false + # List additional stylesheets to load site-wide. # These stylesheets should be located in your site's `static` directory. # Example: stylesheets = ["extra1.css", "path/extra2.css"] @@ -126,13 +138,18 @@ show_remote_changes = true # Defaults to true. # Show a link to the repository of the site, right next to the "Powered by Zola & tabi" text. show_remote_source = true # Defaults to true. -# Add a "copy" button to codeblocks (loads ~700 bytes of JavaScript). +# Add a "copy" button to code blocks (loads ~700 bytes of JavaScript). # Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy copy_button = true -# Loads the necessary JavaScript (~400 bytes) to use the "Show source or path" shortcode: https://welpo.github.io/tabi/blog/shortcodes/#show-source-or-path +# Make code block names clickable if they are URLs (loads ~400 bytes of JavaScript). # Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy -add_src_to_code_block = false +code_block_name_links = false + +# Force left-to-right (LTR) direction for code blocks. +# Set to false to allow code to follow the document's natural direction. +# Can be set at page or section levels. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy +force_codeblock_ltr = true # Show the author(s) of a page. # Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy @@ -152,6 +169,24 @@ show_date = true # "both" - Show both the original date and the last updated date. post_listing_date = "date" +# Enable iine like buttons on all posts: https://iine.to/ +# Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy +iine = true +iine_icon = "thumbs_up" # See https://iine.to/#customise +# Unify like counts across all language versions of the same page. +# When enabled, likes on /es/blog/hello/ will count towards /blog/hello/ (default language). +iine_unified_languages = true + +# Show "Jump to posts" link next to series' title. +# By default, the link appears automatically when a series description exceeds 2000 characters. +# Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy +# show_jump_to_posts = true + +# Determines if indexes should be increasing (false) or decreasing (true) in series' posts list. +# It has only effect if the section uses indexes metadata (which is only the case for series as of now). +# Can be set at section levels, following the hierarchy: section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy +post_listing_index_reversed = false # Defaults to false. + # DEPRECATED! # Use Zola's built-in `bottom_footnotes = true` in the [markdown] section instead. (Available since v0.19.0) # Adds backlinks to footnotes (loads ~500 bytes of JavaScripts). @@ -203,6 +238,17 @@ long_date_format = "%d %B %Y" # Default is "6th July 2049" in English and "%-d %B %Y" in other languages. short_date_format = "" +# Date format used for the archive page. +# Default is "06 July" in English and "%d %b" in other languages. +archive_date_format = "" + +# Per-language date format overrides. +# Examples: Spanish uses "3 de febrero de 2024", German uses "3. Februar 2024" +date_formats = [ + { lang = "es", long = "%d de %B de %Y", short = "%-d %b %Y" }, + { lang = "de", long = "%d. %B %Y", short = "%d.%m.%Y", archive = "%d. %b" }, +] + # Custom separator used in title tag and posts metadata (between date, time to read, and tags). separator = "•" @@ -216,6 +262,12 @@ compact_tags = false # Default: "name". tag_sorting = "name" +# Show clickable tags above cards.html template (e.g. projects/) to filter the displayed items. +# Loads JS to filter. If JS is disabled, the buttons are links to the tag's page. +# Can be set at the section or config.toml level, following the hierarchy: section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy +# Default: true +enable_cards_tag_filtering = true + # Invert the order of the site title and page title in the browser tab. # Example: true => "Blog • ~/tabi", false => "~/tabi • Blog" invert_title_order = false @@ -231,7 +283,7 @@ favicon_emoji = "🌱" # Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy # Learn how to create these images in batch and automatically: # https://osc.garden/blog/automating-social-media-cards-zola/ -social_media_card = "social_cards/index.jpg" +social_media_card = "index.jpg" menu = [ { name = "blog", url = "blog", trailing_slash = true }, @@ -267,6 +319,11 @@ socials = [ { name = "spotify", url = "https://open.spotify.com/artist/5Hv2bYBhMp1lUHFri06xkE", icon = "spotify" }, ] +# Fediverse profile. +# Adds metadata to feature the author's profile in Mastodon link previews. +# Example: for @username@example.com, use: +# fediverse_creator = { handle = "username", domain = "example.com" } + # Extra menu to show on the footer, below socials section. footer_menu = [ {url = "about", name = "about", trailing_slash = true}, @@ -308,10 +365,14 @@ allowed_domains = [ # Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy enable_csp = true -# Custom subset of characters for the header. -# If set to true, the `static/custom_subset.css` file will be loaded first. -# This avoids a flashing text issue in Firefox. -# Please see https://welpo.github.io/tabi/blog/custom-font-subset/ to learn how to create this file. +# Font subsetting configuration. +# This feature helps prevent text flashing in Firefox when using custom fonts. +# See: https://welpo.github.io/tabi/blog/custom-font-subset/ +# Enable or disable font subsetting completely, both built-in and custom subsets. +enable_subset = true +# Use a custom subset of characters for the header. +# If true, tabi will load the `static/custom_subset.css` file. +# If false, tabi will use the default language-specific subset (English or Spanish). custom_subset = true [extra.analytics] @@ -323,7 +384,7 @@ service = "goatcounter" # For GoatCounter, this is the code you choose during signup. # For Umami, this is the website ID. # For Plausible, this is the domain name (e.g. "example.com"). -# Note: Leave this field empty if you're self-hosting. +# Note: Leave this field empty if you're self-hosting GoatCounter. # id = "yourID" # Optional: Specify the URL for self-hosted analytics instances. @@ -333,6 +394,9 @@ service = "goatcounter" # Leave this field empty if you're using the service's default hosting. self_hosted_url = "https://tabi-stats.osc.garden" +# Optional: For Umami, enable this option to respect users' Do Not Track (DNT) settings. The default is true. +do_not_track = true + # giscus support for comments. https://giscus.app # Setup instructions: https://welpo.github.io/tabi/blog/comments/#setup [extra.giscus] @@ -388,3 +452,69 @@ avatar = true voting = true page_author_hashes = "" # hash (or list of hashes) of the author. lazy_loading = true # Loads when the comments are in the viewport (using the Intersection Observer API). + +[extra.webmentions] +# To disable for a specific section or page, set webmentions = false in that page/section's front matter's [extra] section. +enable = false +# Specify the domain registered with webmention.io. +domain = "" + +# The HTML ID for the object to fill in with the webmention data. +# Defaults to "webmentions" +# id = "webmentions" + +# data configuration for the webmention.min.js script +# The base URL to use for this page. Defaults to window.location +# page_url = + +# Additional URLs to check, separated by |s +# add_urls + +# The maximum number of words to render in reply mentions. +# wordcount = 20 + +# The maximum number of mentions to retrieve. Defaults to 30. +# max_webmentions = 30 + +# By default, Webmentions render using the mf2 'url' element, which plays +# nicely with webmention bridges (such as brid.gy and telegraph) +# but allows certain spoofing attacks. If you would like to prevent +# spoofing, set this to a non-empty string (e.g. "true"). +# prevent_spoofing + +# What to order the responses by; defaults to 'published'. See +# https://github.com/aaronpk/webmention.io#api +# sort_by + +# The order to sort the responses by; defaults to 'up' (i.e. oldest +# first). See https://github.com/aaronpk/webmention.io#api +# sort_dir + +# If set to a non-empty string (e.g. "true"), will display comment-type responses +# (replies/mentions/etc.) as being part of the reactions +# (favorites/bookmarks/etc.) instead of in a separate comment list. +# comments_are_reactions = "true" + +# h-card configuration +# Will identify you on the indieweb (see https://microformats.org/wiki/h-card) +[extra.hcard] +# Enable home page h-card. +# enable = true +# Add your email to the card if extra.email is set and not encoded. +# with_mail = true +# Add your social links ('socials' config) to the card. +# with_social_links = true +# Homepage url. Defaults to the value of 'base_url'. +# homepage = "https://myhomepage.net" +# avatar = "img/profile.webp" +# Display name, default to the value of 'author'. +# full_name = "John Doe" +# Small bio, as shown on social media profiles. +# biography = "Fond of the indieweb" +# +# You can add any property from https://microformats.org/wiki/h-card#Properties +# Make sure to replace all '-' characters by '_' +# Examples: +# p_nickname = "nickname" +# p_locality = "Bordeaux" +# p_country_name = "France" diff --git a/content/_index.ar.md b/content/_index.ar.md new file mode 100644 index 0000000..4f8b6a4 --- /dev/null +++ b/content/_index.ar.md @@ -0,0 +1,18 @@ ++++ +title = "أخر التدوينات" +sort_by = "date" +template = "section.html" + +[extra] +header = {title = "اهلاً انا تابي~", img = "img/main.webp", img_alt = "أوسكار فرنانديز, كاتب السمة" } +section_path = "blog/_index.ar.md" +max_posts = 4 +projects_path = "projects/_index.ar.md" +max_projects = 3 +show_projects_first = false +social_media_card = "ar.jpg" ++++ + +تابي هو قالب Zola سريع وعصري. يهدف ليكون صفحة ومدونة شخصية. يتميز بتقييم مثالي في Lighthouse، وتصميم متجاوب، وسمات داكنة وفاتحة، وشِفرات قصيرة مخصصة، والعديد من المميزات الأخرى. + +> ملاحظة: هذه الصفحة هي عرض توضيحي لدعم اللغة العربية في تابي. للحصول على التوثيق الكامل، يرجى الرجوع إلى [النسخة الإنجليزية](@/_index.md). diff --git a/content/_index.ca.md b/content/_index.ca.md index ed92599..a5da748 100644 --- a/content/_index.ca.md +++ b/content/_index.ca.md @@ -1,7 +1,6 @@ +++ title = "Publicacions recents" sort_by = "date" -template = "section.html" [extra] header = {title = "Hola! Soc tabi~", img = "img/main.webp", img_alt = "Óscar Fernández, l'autor de tabi" } @@ -10,7 +9,7 @@ max_posts = 4 projects_path = "projects/_index.ca.md" max_projects = 3 show_projects_first = false -social_media_card = "social_cards/ca.jpg" +social_media_card = "ca.jpg" +++ -tabi és un tema de [Zola](https://www.getzola.org) ràpid, lleuger i modern. Té com a objectiu ser una pàgina personal i llar d'entrades de blog. Compta amb una puntuació perfecta de Lighthouse, disseny responsive, tema fosc i clar, shortcodes personalitzats i molt més. +tabi és un tema accessible per a Zola amb [cerca](@/blog/mastering-tabi-settings/index.ca.md#cerca), [suport multilingüe](@/blog/faq-languages/index.ca.md), [JavaScript opcional](@/blog/javascript/index.ca.md), una puntuació perfecta a Lighthouse i documentació exhaustiva. Dissenyat per a llocs web i blogs personals. diff --git a/content/_index.es.md b/content/_index.es.md index 51b9e2b..53eb2e9 100644 --- a/content/_index.es.md +++ b/content/_index.es.md @@ -1,7 +1,6 @@ +++ title = "Publicaciones recientes" sort_by = "date" -template = "section.html" [extra] header = {title = "¡Hola! Soy tabi~", img = "img/main.webp", img_alt = "Óscar Fernández, el autor de tabi" } @@ -10,7 +9,7 @@ max_posts = 4 projects_path = "projects/_index.es.md" max_projects = 3 show_projects_first = false -social_media_card = "social_cards/es.jpg" +social_media_card = "es.jpg" +++ -tabi es un tema de [Zola](https://www.getzola.org) rápido, ligero y moderno. Su objetivo es ser una página personal y hogar para publicaciones de blogs. Cuenta con una puntuación perfecta en Lighthouse, diseño responsive, tema oscuro y claro, shortcodes personalizados y mucho más. +tabi es un tema accesible para [Zola](https://www.getzola.org) con [búsqueda](@/blog/mastering-tabi-settings/index.es.md#busqueda), [soporte multilingüe](@/blog/faq-languages/index.es.md), [JavaScript opcional](@/blog/javascript/index.es.md), una puntuación perfecta en Lighthouse y documentación exhaustiva. Diseñado para sitios web y blogs personales. diff --git a/content/_index.md b/content/_index.md index fba6172..4d1dbe6 100644 --- a/content/_index.md +++ b/content/_index.md @@ -1,7 +1,6 @@ +++ title = "Latest posts" sort_by = "date" -template = "section.html" [extra] header = {title = "Hello! I'm tabi~", img = "img/main.webp", img_alt = "Óscar Fernández, the theme's author" } @@ -10,7 +9,7 @@ max_posts = 4 projects_path = "projects/_index.md" max_projects = 3 show_projects_first = false -social_media_card = "social_cards/index.jpg" +social_media_card = "index.jpg" +++ -tabi is a fast, lightweight, and modern [Zola](https://www.getzola.org) theme. It aims to be a personal page and home to blog posts. It features a perfect Lighthouse score, responsive design, dark and light themes, custom shortcodes, and much more. +tabi is an accessible [Zola](https://www.getzola.org) theme with [search](@/blog/mastering-tabi-settings/index.md#search), [multi-language support](@/blog/faq-languages/index.md), [optional JavaScript](@/blog/javascript/index.md), a perfect Lighthouse score, and comprehensive documentation. Crafted for personal websites and blogs. diff --git a/content/ar.jpg b/content/ar.jpg new file mode 100644 index 0000000..64e77bc Binary files /dev/null and b/content/ar.jpg differ diff --git a/content/archive/_index.ar.md b/content/archive/_index.ar.md new file mode 100644 index 0000000..59055be --- /dev/null +++ b/content/archive/_index.ar.md @@ -0,0 +1,4 @@ ++++ +title = "الأرشيف" +template = "archive.html" ++++ diff --git a/content/archive/_index.ca.md b/content/archive/_index.ca.md index 984a17a..869b1d2 100644 --- a/content/archive/_index.ca.md +++ b/content/archive/_index.ca.md @@ -3,5 +3,5 @@ title = "Arxiu" template = "archive.html" [extra] -social_media_card = "archive/social_cards/ca_archive.jpg" +social_media_card = "ca_archive.jpg" +++ diff --git a/content/archive/_index.es.md b/content/archive/_index.es.md index c7bca8f..9f33695 100644 --- a/content/archive/_index.es.md +++ b/content/archive/_index.es.md @@ -3,5 +3,5 @@ title = "Archivo" template = "archive.html" [extra] -social_media_card = "archive/social_cards/es_archive.jpg" +social_media_card = "es_archive.jpg" +++ diff --git a/content/archive/_index.md b/content/archive/_index.md index dea9aab..10cf255 100644 --- a/content/archive/_index.md +++ b/content/archive/_index.md @@ -3,5 +3,5 @@ title = "Archive" template = "archive.html" [extra] -social_media_card = "archive/social_cards/archive.jpg" +social_media_card = "archive.jpg" +++ diff --git a/content/archive/social_cards/archive.jpg b/content/archive/archive.jpg similarity index 100% rename from content/archive/social_cards/archive.jpg rename to content/archive/archive.jpg diff --git a/content/archive/social_cards/ca_archive.jpg b/content/archive/ca_archive.jpg similarity index 100% rename from content/archive/social_cards/ca_archive.jpg rename to content/archive/ca_archive.jpg diff --git a/content/archive/social_cards/es_archive.jpg b/content/archive/es_archive.jpg similarity index 100% rename from content/archive/social_cards/es_archive.jpg rename to content/archive/es_archive.jpg diff --git a/content/blog/_index.ar.md b/content/blog/_index.ar.md new file mode 100644 index 0000000..55a7a88 --- /dev/null +++ b/content/blog/_index.ar.md @@ -0,0 +1,10 @@ ++++ +paginate_by = 5 +title = "التدوينات" +sort_by = "date" +template = "section.html" +insert_anchor_links = "right" + +[extra] +show_previous_next_article_links = true ++++ diff --git a/content/blog/_index.ca.md b/content/blog/_index.ca.md index 7a72231..25e0758 100644 --- a/content/blog/_index.ca.md +++ b/content/blog/_index.ca.md @@ -2,10 +2,9 @@ paginate_by = 5 title = "Blog" sort_by = "date" -template = "section.html" insert_anchor_links = "left" [extra] -social_media_card = "blog/social_cards/ca_blog.jpg" +social_media_card = "ca_blog.jpg" show_previous_next_article_links = true +++ diff --git a/content/blog/_index.es.md b/content/blog/_index.es.md index a367dbb..201c2d4 100644 --- a/content/blog/_index.es.md +++ b/content/blog/_index.es.md @@ -2,10 +2,9 @@ paginate_by = 5 title = "Blog" sort_by = "date" -template = "section.html" insert_anchor_links = "left" [extra] -social_media_card = "blog/social_cards/es_blog.jpg" +social_media_card = "es_blog.jpg" show_previous_next_article_links = true +++ diff --git a/content/blog/_index.md b/content/blog/_index.md index 036db4d..22dbcda 100644 --- a/content/blog/_index.md +++ b/content/blog/_index.md @@ -2,10 +2,9 @@ paginate_by = 5 title = "Blog" sort_by = "date" -template = "section.html" insert_anchor_links = "left" [extra] -social_media_card = "blog/social_cards/blog.jpg" +social_media_card = "blog.jpg" show_previous_next_article_links = true +++ diff --git a/content/blog/social_cards/blog.jpg b/content/blog/blog.jpg similarity index 100% rename from content/blog/social_cards/blog.jpg rename to content/blog/blog.jpg diff --git a/content/blog/social_cards/ca_blog.jpg b/content/blog/ca_blog.jpg similarity index 100% rename from content/blog/social_cards/ca_blog.jpg rename to content/blog/ca_blog.jpg diff --git a/content/blog/custom-font-subset/index.ca.md b/content/blog/custom-font-subset/index.ca.md index ede8541..20906aa 100644 --- a/content/blog/custom-font-subset/index.ca.md +++ b/content/blog/custom-font-subset/index.ca.md @@ -1,7 +1,7 @@ +++ title = "Optimitza la càrrega amb un subconjunt de font personalitzat" date = 2023-04-29 -updated = 2023-07-08 +updated = 2025-01-12 description = "Aprèn com crear un subconjunt personalitzat que només inclogui els glifs necessaris." [taxonomies] @@ -21,7 +21,11 @@ Per solucionar això, tabi carrega un subconjunt de glifs per a l'encapçalament Per defecte, tabi inclou fitxers de subconjunts per a caràcters en anglès i espanyol (amb alguns símbols). Aquests fitxers es carreguen quan la pàgina o el lloc web de Zola està en aquest idioma. -Per a una optimització addicional, pots crear un subconjunt de fonts personalitzat que només inclogui els caràcters utilitzats en el teu encapçalament. +{% admonition(type="tip") %} +Si estàs fent servir una font personalitzada, pots crear el teu propi subconjunt (segueix llegint) o desactivar completament els subconjunts predeterminats amb `enable_subset = false` a `config.toml`. +{% end %} + +Per a una optimització addicional, a continuació t'expliquem com crear un subconjunt de fonts personalitzat que només inclogui els caràcters utilitzats en el teu encapçalament. ## Requisits diff --git a/content/blog/custom-font-subset/index.es.md b/content/blog/custom-font-subset/index.es.md index 4f00491..31e8197 100644 --- a/content/blog/custom-font-subset/index.es.md +++ b/content/blog/custom-font-subset/index.es.md @@ -1,7 +1,7 @@ +++ title = "Optimiza la carga con un subconjunto de fuente personalizado" date = 2023-04-29 -updated = 2023-07-08 +updated = 2025-01-12 description = "Aprende cómo crear un subconjunto personalizado que solo incluya los glifos necesarios." [taxonomies] @@ -21,7 +21,11 @@ Para solucionar esto, tabi carga un subconjunto de glifos para el encabezado. Da Por defecto, tabi incluye archivos de subconjuntos para caracteres en inglés y español (con algunos símbolos). Estos archivos se cargan cuando la página o el sitio de Zola está en ese idioma. -Para una optimización adicional, puedes crear un subconjunto de fuentes personalizado que solo incluya los caracteres utilizados en tu encabezado. +{% admonition(type="tip") %} +Si estás usando una fuente personalizada, puedes crear tu propio subconjunto (ver más abajo) o desactivar completamente los subconjuntos predeterminados con `enable_subset = false` en tu `config.toml`. +{% end %} + +Para una optimización adicional, a continuación verás cómo crear un subconjunto de fuentes personalizado que solo incluya los caracteres utilizados en tu encabezado. ## Requisitos diff --git a/content/blog/custom-font-subset/index.md b/content/blog/custom-font-subset/index.md index 9cd54d3..fdb1d6b 100644 --- a/content/blog/custom-font-subset/index.md +++ b/content/blog/custom-font-subset/index.md @@ -1,7 +1,7 @@ +++ title = "Optimise loading times with a custom font subset" date = 2023-04-29 -updated = 2023-07-08 +updated = 2025-01-12 description = "Learn how to create a custom subset that only includes the necessary glyphs." [taxonomies] @@ -21,7 +21,11 @@ To fix this, tabi loads a subset of glyphs for the header. Since this (slightly) By default, there are subset files for English and Spanish characters (with a few symbols). These files are loaded when the Zola page/site is set to that language. -For further optimisation, you can create a custom font subset that only includes the characters used in your header. +{% admonition(type="tip") %} +If you're using a custom font, either create your custom subset (see below) or disable the built-in subsets completely with `enable_subset = false` in your `config.toml`. +{% end %} + +Here's how you can create a custom font subset that only includes the characters used in your header, for maximum efficiency. ## Requirements diff --git a/content/blog/social_cards/es_blog.jpg b/content/blog/es_blog.jpg similarity index 100% rename from content/blog/social_cards/es_blog.jpg rename to content/blog/es_blog.jpg diff --git a/content/blog/faq-languages/index.ca.md b/content/blog/faq-languages/index.ca.md index 37fc2f5..c4be47f 100644 --- a/content/blog/faq-languages/index.ca.md +++ b/content/blog/faq-languages/index.ca.md @@ -1,7 +1,7 @@ +++ title = "Lost in Translation? Explora les capacitats multilingües de tabi" date = 2023-09-12 -updated = 2024-08-18 +updated = 2025-09-14 description = "Descobreix com tabi t'ajuda a connectar amb una audiència global gràcies a les seves funcions multilingües. Aprèn a canviar la llengua per defecte, afegir més llengües i aportar les teves pròpies traduccions." [taxonomies] @@ -30,6 +30,7 @@ tabi admet les següents llengües: - Coreà - Espanyol - Estonià +- Finès - Francès - Hindi - Italià @@ -106,6 +107,19 @@ Per tant, si crees `i18n/ca.toml` al teu directori base, tabi llegirà les caden Assegura't de copiar tot el fitxer per a aquest idioma primer, o el tema utilitzarà l'anglès per les claus que faltin. +## Com personalitzo els formats de data per a diferents idiomes? + +Pots establir formats de data específics per idioma al teu `config.toml` utilitzant la matriu `date_formats`: + +```toml +date_formats = [ + { lang = "es", long = "%d de %B de %Y", short = "%-d %b %Y", archive = "%d de %b" }, + { lang = "de", long = "%d. %B %Y", short = "%d.%m.%Y", archive = "%d. %b" }, +] +``` + +Això permet que cada idioma mostri les dates segons les convencions locals. Per exemple, l'espanyol mostrarà «3 de febrero de 2024» mentre que l'alemany mostrarà «3. Februar 2024». Si no es defineix un format específic per a un idioma, tabi utilitzarà la configuració global `long_date_format`, `short_date_format` i `archive_date_format`. + ## Què passa si falta una traducció o està incompleta? Si una cadena no es troba en el fitxer d'idioma, tabi utilitzarà a la cadena predeterminada en anglès. @@ -133,3 +147,7 @@ Si ho vas fer, hauràs d'actualitzar manualment les traduccions. Pots fer-ho cop ## tabi tradueix el meu contingut? No. tabi només tradueix les cadenes de text del tema. Hauràs de traduir el teu contingut tu mateix. + +## Com puc mostrar el codi de l'idioma actual al commutador d'idioma? + +Afegeix `show_selected_language_code_in_language_switcher = true` a la secció `[extra]` del teu `config.toml`. diff --git a/content/blog/faq-languages/index.es.md b/content/blog/faq-languages/index.es.md index a8682e8..b9fe08f 100644 --- a/content/blog/faq-languages/index.es.md +++ b/content/blog/faq-languages/index.es.md @@ -1,7 +1,7 @@ +++ title = "¿Lost in Translation? Explora las capacidades multilingües de tabi" date = 2023-09-12 -updated = 2024-08-18 +updated = 2025-09-14 description = "Descubre cómo tabi te ayuda a conectar con una audiencia global gracias a sus funciones multilingües. Aprende a cambiar el idioma por defecto, añadir más idiomas y aportar tus propias traducciones." [taxonomies] @@ -30,6 +30,7 @@ tabi admite los siguientes idiomas: - Coreano - Español - Estonio +- Finlandés - Francés - Hindi - Inglés @@ -106,6 +107,19 @@ Por lo tanto, si creas `i18n/en.toml` en tu directorio base, tabi leerá las cad Asegúrate de copiar todo el archivo para ese idioma primero, o el tema usará el inglés para las claves faltantes. +## ¿Cómo personalizo los formatos de fecha para diferentes idiomas? + +Puedes establecer formatos de fecha específicos por idioma en tu `config.toml` usando la matriz `date_formats`: + +```toml +date_formats = [ + { lang = "es", long = "%d de %B de %Y", short = "%-d %b %Y", archive = "%d de %b" }, + { lang = "de", long = "%d. %B %Y", short = "%d.%m.%Y", archive = "%d. %b" }, +] +``` + +Esto permite que cada idioma muestre las fechas según las convenciones locales. Por ejemplo, el español mostrará «3 de febrero de 2024» mientras que el alemán mostrará «3. Februar 2024». Si no se define un formato específico para un idioma, tabi usará la configuración global `long_date_format`, `short_date_format` y `archive_date_format`. + ## ¿Qué pasa si falta una traducción o está incompleta? Si una cadena no se encuentra en el archivo de idioma, tabi recurrirá a la cadena predeterminada en inglés. @@ -133,3 +147,7 @@ Si lo hiciste, tendrás que actualizar manualmente las traducciones. Puedes hace ## ¿tabi traduce el contenido de mi sitio? No. tabi sólo traduce el tema. Los posts deberás traducirlos tú mismo. + +## ¿Cómo puedo mostrar el código del idioma actual en el conmutador de idioma? + +Añade `show_selected_language_code_in_language_switcher = true` en la sección `[extra]` de tu `config.toml`. diff --git a/content/blog/faq-languages/index.md b/content/blog/faq-languages/index.md index ee4d46f..229a5a0 100644 --- a/content/blog/faq-languages/index.md +++ b/content/blog/faq-languages/index.md @@ -1,7 +1,7 @@ +++ title = "Lost in Translation? Not with tabi's Multilingual Capabilities" date = 2023-09-12 -updated = 2024-03-01 +updated = 2025-09-14 description = "Master the art of serving a global audience through tabi's built-in multilingual features. Learn how to change the default language, add multilingual support, and contribute your own translations." [taxonomies] @@ -29,6 +29,7 @@ tabi supports the following languages: - Chinese (Traditional) - English - Estonian +- Finnish - French - German - Hindi @@ -107,6 +108,19 @@ So if you create `i18n/en.toml` in your base directory, tabi will read the stri Make sure to copy the entire file for that language first, or the theme will fall back to the default English strings. +## How do I customize date formats for different languages? + +You can set language-specific date formats in your `config.toml` using the `date_formats` array: + +```toml +date_formats = [ + { lang = "es", long = "%d de %B de %Y", short = "%-d %b %Y", archive = "%d de %b" }, + { lang = "de", long = "%d. %B %Y", short = "%d.%m.%Y", archive = "%d. %b" }, +] +``` + +This allows each language to display dates according to local conventions. For example, Spanish will show "3 de febrero de 2024" while German will show "3. Februar 2024". If no language-specific format is defined, tabi will use the global `long_date_format`, `short_date_format` and `archive_date_format` settings. + ## What happens if a translation is missing or incomplete? If a string is not found in the language file, tabi will fall back to the default English string. @@ -134,3 +148,7 @@ If you did, you will need to manually update the translations. You can do this b ## Does tabi translate my content? No. tabi only translates the theme's text strings. You will need to translate your content yourself. + +# How to show current language code on the language switcher? + +Add `show_selected_language_code_in_language_switcher = true` in your config extras. diff --git a/content/blog/javascript/index.ca.md b/content/blog/javascript/index.ca.md index 34acfc1..d9e461f 100644 --- a/content/blog/javascript/index.ca.md +++ b/content/blog/javascript/index.ca.md @@ -1,7 +1,7 @@ +++ title = "Sense JavaScript obligatori" date = 2023-01-06 -updated = 2024-08-28 +updated = 2025-02-21 description = "JavaScript només s'utilitza quan HTML i CSS no són suficients." [taxonomies] @@ -25,10 +25,11 @@ Aquest tema no requereix JavaScript obligatori. Opcionalment, pot carregar una q Les següents opcions es poden especificar per a publicacions, seccions i globalment, seguint la jerarquia de `pàgina > secció > config.toml`: -- [**Suport de KaTeX**](@/blog/markdown/index.ca.md#katex). Habilitat configurant `katex = true` (274 KB). +- [**Suport de KaTeX**](@/blog/markdown/index.ca.md#katex). Habilitat configurant `katex = true` (274 KB). Per renderitzar fórmules sense JS, prova [MathML](https://developer.mozilla.org/docs/Web/MathML/). - [**Diagrames de Mermaid**](@/blog/shortcodes/index.ca.md#diagrames-de-mermaid). Habilitat configurant `mermaid = true` (~2.5 MB). - [**Còpia de blocs de codi amb un sol clic**](@/blog/markdown/index.ca.md#bloc-de-codi). Habilitada configurant `copy_button = true`. (~700 bytes) -- [**Mostrar ruta/URL a blocs de codi**](@/blog/shortcodes/index.ca.md#mostrar-ruta-o-url). S'activa configurant `add_src_to_code_block = true`. (~400 bytes) +- [**Noms de blocs de codi clicables**](@/blog/shortcodes/index.ca.md#mostrar-ruta-o-url). S'activa configurant `code_block_name_links = true`. (~400 bytes) +- [**Filtratge per etiquetes** per a graelles de targetes](@/blog/mastering-tabi-settings/index.ca.md#filtrar-projectes) (p. ex. [projectes](@/projects/_index.ca.md)) (~2KB). S'habilita configurant `enable_cards_tag_filtering = true`. Per especificar aquestes opcions: @@ -42,4 +43,6 @@ Per especificar aquestes opcions: A part d'això, és un tema ràpid amb HTML i CSS que funciona sense JavaScript. Just com hauria de ser (la majoria de) la web :-) +--- + [^1]: Per codificar el teu correu en base64 pots utilitzar [eines en línia](https://www.base64encode.org/) o, al terminal, executa: `printf 'mail@example.com' | base64`. diff --git a/content/blog/javascript/index.es.md b/content/blog/javascript/index.es.md index bbc62c7..36e550e 100644 --- a/content/blog/javascript/index.es.md +++ b/content/blog/javascript/index.es.md @@ -1,7 +1,7 @@ +++ title = "Sin JavaScript obligatorio" date = 2023-01-06 -updated = 2024-08-28 +updated = 2025-02-21 description = "JavaScript solo se utiliza cuando HTML y CSS no son suficientes." [taxonomies] @@ -25,10 +25,11 @@ Este tema no requiere JavaScript de manera obligatoria. Opcionalmente, puede car Las siguientes opciones pueden especificarse para publicaciones, secciones y a nivel global, siguiendo la jerarquía de `página > sección > config.toml`: -- [**Soporte de KaTeX**](@/blog/markdown/index.es.md#katex). Habilitado al configurar `katex = true` (274 KB). +- [**Soporte de KaTeX**](@/blog/markdown/index.es.md#katex). Habilitado al configurar `katex = true` (274 KB). Para renderizar fórmulas sin JS, prueba [MathML](https://developer.mozilla.org/docs/Web/MathML/). - [**Diagramas de Mermaid**](@/blog/shortcodes/index.es.md#diagramas-de-mermaid). Habilitado al configurar `mermaid = true` (~2.5 MB). - [**Copia de bloques de código con un solo clic**](@/blog/markdown/index.es.md#bloque-de-codigo). Habilitado al configurar `copy_button = true` (~700 bytes). -- [**Mostrar ruta/URL en bloques de código**](@/blog/shortcodes/index.es.md#mostrar-ruta-o-url). Se activa configurando `add_src_to_code_block = true`. (~400 bytes) +- [**Nombres de bloques de código clicables**](@/blog/shortcodes/index.es.md#mostrar-ruta-o-url). Se activa configurando `code_block_name_links = true`. (~400 bytes) +- [**Filtraje por etiquetas** para cuadrículas de tarjetas](@/blog/mastering-tabi-settings/index.es.md#filtrar-proyectos) (p. ej. [proyectos](@/projects/_index.es.md)) (~2KB). Habilitado al configurar `enable_cards_tag_filtering = true`. Para especificar estas opciones: @@ -42,4 +43,6 @@ Para especificar estas opciones: Aparte de eso, es un tema rápido con HTML y CSS que funciona con JavaScript deshabilitado. Justo como debería ser (la mayoría de) la web :-) +--- + [^1]: Para codificar tu correo electrónico en base64 puedes usar [herramientas en línea](https://www.base64encode.org/) o, en tu terminal, ejecutar: `printf 'mail@example.com' | base64`. diff --git a/content/blog/javascript/index.md b/content/blog/javascript/index.md index 734a9af..57864b0 100644 --- a/content/blog/javascript/index.md +++ b/content/blog/javascript/index.md @@ -1,7 +1,7 @@ +++ title = "No mandatory JavaScript" date = 2023-01-06 -updated = 2024-08-28 +updated = 2025-02-21 description = "JavaScript is only used when HTML and CSS aren't enough." [taxonomies] @@ -25,10 +25,11 @@ This theme has no mandatory JavaScript. Optionally, it can load a minimal amount The following settings can be specified for posts, sections and globally, following the hierarchy of `page > section > config.toml`: -- [**KaTeX support**](@/blog/markdown/index.md#katex). Enabled by setting `katex = true` (274 KB). +- [**KaTeX support**](@/blog/markdown/index.md#katex). Enabled by setting `katex = true` (274 KB). To render math without JS, check out [MathML](https://developer.mozilla.org/docs/Web/MathML/). - [**Mermaid diagrams**](@/blog/shortcodes/index.md#mermaid-diagrams). Enabled by setting `mermaid = true` (~2.5 MB). - [**One-click copy of code blocks**](@/blog/markdown/index.md#code-block). Enabled by setting `copy_button = true`. (~700 bytes) -- [**Showing source (path or URL) in code blocks**](@/blog/shortcodes/index.md#show-source-or-path). Enabled by setting `add_src_to_code_block = true`. (~300 bytes) +- [**Clickable code block names**](@/blog/shortcodes/index.md#show-source-or-path). Enabled by setting `code_block_name_links = true`. (~300 bytes) +- [**Tag filtering** for card grids](@/blog/mastering-tabi-settings/index.md#filtering-projects) (e.g. [projects](@/projects/_index.md)) (~2KB). Enabled by setting `enable_cards_tag_filtering = true`. To specify these settings: @@ -42,4 +43,6 @@ To specify these settings: Other than that, it's a fast theme with HTML and CSS which works with JavaScript disabled. Just the way (most of) the web should be :-) +--- + [^1]: To encode your email in base64 you can use [online tools](https://www.base64encode.org/) or, on your terminal, run: `printf 'mail@example.com' | base64`. diff --git a/content/blog/markdown/index.ar.md b/content/blog/markdown/index.ar.md new file mode 100644 index 0000000..9322dc4 --- /dev/null +++ b/content/blog/markdown/index.ar.md @@ -0,0 +1,93 @@ ++++ +title = "أمثلة على ماركداون" +date = 2023-01-31 +updated = 2023-09-01 +description = "تعرض هذه التدوينة بعض الأمثلة على تنسيق ماركداون، بما في ذلك الجداول، والشِفرات البرمجية والوسوم، والاقتباسات، والهوامش." + +[taxonomies] +tags = ["ماركداون", "توضيحي"] + +[extra] +katex = true ++++ + +{% admonition(type="note", title="ملاحظة عن الاتجاه", icon="info") %} +يدعم تابي الكتابة من اليمين إلى اليسار (RTL) بشكل كامل، مما يجعله مثالياً للغة العربية. + +الشفرات البرمجية والمعادلات الرياضية تبقى من اليسار إلى اليمين كما هو متوقع. +{% end %} + +## الرياضيات مع $\KaTeX$ + +{{ aside(text="تأتي كلمة *ماركداون* من الإنجليزية *Markdown*، وهي لغة ترميز بسيطة صممها جون غروبر وآرون سوارتز في عام 2004.") }} + +[$\KaTeX$](https://katex.org/) هي مكتبة سريعة وسهلة الاستخدام تمكن من عرض الرموز الرياضية باستخدام صيغة LaTeX. + +يمكنك استخدام $\KaTeX$ **ضمن السطر** عن طريق وضع التعبير بين `$` أو بين `\\(` و `\\)`. + +على سبيل المثال، `$ \sin(x) = \sum_{n=0}^{\infty} \frac{(-1)^n}{(2n + 1)!} x^{2n + 1} $` سيظهر هكذا: $ \sin(x) = \sum_{n=0}^{\infty} \frac{(-1)^n}{(2n + 1)!} x^{2n + 1} $ + +لعرض التعبير **في سطر منفصل ومتوسط**، ضعه بين `$$` أو بين `\\[` و `\\]`. + +على سبيل المثال، `\\[ r = \frac{\sum_{i=1}^{n}(x_i - \bar{x})(y_i - \bar{y})}{\sqrt{\sum_{i=1}^{n}(x_i - \bar{x})^2}\sqrt{\sum_{i=1}^{n}(y_i - \bar{y})^2}} \\]` سيظهر هكذا: \\[ r = \frac{\sum_{i=1}^{n}(x_i - \bar{x})(y_i - \bar{y})}{\sqrt{\sum_{i=1}^{n}(x_i - \bar{x})^2}\sqrt{\sum_{i=1}^{n}(y_i - \bar{y})^2}} \\] + +لتفعيل $\KaTeX$ لتدوينة أو قسم كامل، أضف `katex = true` داخل قسم `[extra]` في المقدمة. على سبيل المثال: + +```toml,hl_lines=5-6 +title = "تجربة KaTeX" +date = 2002-11-30 + +[extra] +katex = true +``` + +يمكنك أيضاً تفعيله بشكل عام عن طريق تعيين `katex = true` في قسم `[extra]` في ملف `config.toml` الخاص بك. + +لتحسين الأداء والأمان، يتم استضافة ملفات جافا سكريبت و CSS والخطوط الخاصة بـ $\KaTeX$ محلياً. + +**ملاحظة**: بعد تفعيل $\KaTeX$، إذا أردت استخدام \$ بدون عرض تعبير رياضي، استخدم شرطة مائلة للخلف قبلها: `\$`. + +## جدول + +هذا مثال على جدول[^1]. تتغير ألوانه حسب سمة التدوينة. + +| الرمز | العنصر | العدد الذري | +|--------|----------|--------------| +| H | هيدروجين| 1 | +| C | كربون | 6 | +| Fe | حديد | 26 | +| Au | ذهب | 79 | + +## الشِفرات البرمجية + +```rust +fn main() { + println!("مرحباً يا عالم") -> (); +} +``` + +### من اليمين إلى اليسار +{% force_text_direction(direction="rtl") %} + +``` +نص قل_مرحباً(نص الاسم) { + أرجع تنسيق("مرحباً {الاسم}")؛ +} +``` + +{% end %} + +## سطر برمجي + +في Rust، تعلن عن متغير متغير باستخدام `let mut x = 5`، بينما في Python، تستخدم ببساطة `x = 5`. وبالمثل، لطباعة قيمة في Rust، تستخدم `println!("القيمة: {}", x)`، ولكن في Python، الأمر بسيط مثل `print(f"القيمة: {x}")` +وفي لغة البرمجة العربية هو `مهنة = "صائد فئران"` + +## اقتباس + +> وابِطُكَ قابِضِ الأَرواحِ يَرمي ... بِسَهمِ المَوتِ مِن تَحتِ الثِيابِ +> +> شَرابُكَ في السَرابِ إِذا عَطِشنا ... وَخُبزُكَ عِندَ مُنقَطِعِ التُرابِ +> +> — أبو الشمقمق، العصر العباسي + +[^1]: وهذا مثال على الهامش! diff --git a/content/blog/markdown/index.ca.md b/content/blog/markdown/index.ca.md index 27ad917..16cf165 100644 --- a/content/blog/markdown/index.ca.md +++ b/content/blog/markdown/index.ca.md @@ -1,7 +1,7 @@ +++ title = "Exemples de Markdown" date = 2023-01-31 -updated = 2023-09-01 +updated = 2025-02-21 description = "Aquesta publicació mostra alguns exemples de format en Markdown, incloent-hi una taula, blocs de codi i etiquetes, citacions, taules i notes a peu de pàgina." [taxonomies] @@ -59,6 +59,42 @@ fn main() { } ``` +### Amb numeració de línies + +```rust,linenos +use std::collections::HashMap; + +#[derive(Debug)] +struct TwinPeaksCharacter { + name: String, + coffee_rating: f32, + pie_preference: String, +} + +fn main() { + let mut black_lodge = HashMap::new(); + + black_lodge.insert("agent", TwinPeaksCharacter { + name: String::from("Dale Cooper"), + coffee_rating: 9999.99, + pie_preference: String::from("Damn Fine Cherry"), + }); + + black_lodge.insert("giant", TwinPeaksCharacter { + name: String::from("The Fireman"), + coffee_rating: 42.424242, + pie_preference: String::from("Garmonbozia"), + }); + + // Calculate total appreciation of damn fine coffee + let total_coffee: f32 = black_lodge.values() + .map(|character| character.coffee_rating) + .sum(); + + println!("☕ Total coffee appreciation: {:.2} cups", total_coffee); +} +``` + ## Etiquetes de codi A Rust, declares una variable mutable amb `let mut x = 5;`, mentre que a Python, simplement fas `x = 5`. De manera similar, per imprimir un valor a Rust, utilitzaries `println!("Valor: {}", x);`, però a Python, és tan senzill com `print(f"Valor: {x}")`. @@ -69,4 +105,6 @@ A Rust, declares una variable mutable amb `let mut x = 5;`, mentre que a Python, > > — Mercè Rodoreda, La plaça del Diamant +--- + [^1]: I aquí tens un exemple de nota a peu de pàgina! diff --git a/content/blog/markdown/index.es.md b/content/blog/markdown/index.es.md index 6c6718f..af38f47 100644 --- a/content/blog/markdown/index.es.md +++ b/content/blog/markdown/index.es.md @@ -1,7 +1,7 @@ +++ title = "Ejemplos de Markdown" date = 2023-01-31 -updated = 2023-09-01 +updated = 2025-02-21 description = "Esta publicación muestra algunos ejemplos de formato Markdown, incluyendo una tabla, bloques de código y etiquetas, citas, tablas y notas al pie de página." [taxonomies] @@ -59,6 +59,42 @@ fn main() { } ``` +### Con números de línea + +```rust,linenos +use std::collections::HashMap; + +#[derive(Debug)] +struct TwinPeaksCharacter { + name: String, + coffee_rating: f32, + pie_preference: String, +} + +fn main() { + let mut black_lodge = HashMap::new(); + + black_lodge.insert("agent", TwinPeaksCharacter { + name: String::from("Dale Cooper"), + coffee_rating: 9999.99, + pie_preference: String::from("Damn Fine Cherry"), + }); + + black_lodge.insert("giant", TwinPeaksCharacter { + name: String::from("The Fireman"), + coffee_rating: 42.424242, + pie_preference: String::from("Garmonbozia"), + }); + + // Calculate total appreciation of damn fine coffee + let total_coffee: f32 = black_lodge.values() + .map(|character| character.coffee_rating) + .sum(); + + println!("☕ Total coffee appreciation: {:.2} cups", total_coffee); +} +``` + ## Etiquetas de código En Rust, declaras una variable mutable con `let mut x = 5;`, mientras que en Python, simplemente usas `x = 5`. De manera similar, para imprimir un valor en Rust, utilizarías `println!("Valor: {}", x);`, pero en Python, es tan sencillo como `print(f"Valor: {x}")`. @@ -69,4 +105,6 @@ En Rust, declaras una variable mutable con `let mut x = 5;`, mientras que en Pyt > > — Miguel de Unamuno, Niebla +--- + [^1]: ¡Y aquí tienes un ejemplo de una nota al pie de página! diff --git a/content/blog/markdown/index.md b/content/blog/markdown/index.md index ab825d9..ca2f4cf 100644 --- a/content/blog/markdown/index.md +++ b/content/blog/markdown/index.md @@ -1,7 +1,7 @@ +++ title = "Markdown examples" date = 2023-01-31 -updated = 2023-09-01 +updated = 2025-02-21 description = "This post showcases some examples of Markdown formatting, including a table, code blocks and tags, quotes, tables, and footnotes." [taxonomies] @@ -59,6 +59,42 @@ fn main() { } ``` +### With line numbers + +```rust,linenos +use std::collections::HashMap; + +#[derive(Debug)] +struct TwinPeaksCharacter { + name: String, + coffee_rating: f32, + pie_preference: String, +} + +fn main() { + let mut black_lodge = HashMap::new(); + + black_lodge.insert("agent", TwinPeaksCharacter { + name: String::from("Dale Cooper"), + coffee_rating: 9999.99, + pie_preference: String::from("Damn Fine Cherry"), + }); + + black_lodge.insert("giant", TwinPeaksCharacter { + name: String::from("The Fireman"), + coffee_rating: 42.424242, + pie_preference: String::from("Garmonbozia"), + }); + + // Calculate total appreciation of damn fine coffee + let total_coffee: f32 = black_lodge.values() + .map(|character| character.coffee_rating) + .sum(); + + println!("☕ Total coffee appreciation: {:.2} cups", total_coffee); +} +``` + ## Code tags In Rust, you declare a mutable variable with `let mut x = 5;`, whereas in Python, you simply use `x = 5`. Similarly, to print a value in Rust, you would use `println!("Value: {}", x);`, but in Python, it's as straightforward as `print(f"Value: {x}")`. @@ -69,4 +105,6 @@ In Rust, you declare a mutable variable with `let mut x = 5;`, whereas in Python > > — Charlie Kaufman, Synecdoche, New York +--- + [^1]: And here's an example of a footnote! diff --git a/content/blog/mastering-tabi-settings/img/external_link_dark.webp b/content/blog/mastering-tabi-settings/img/external_link_dark.webp new file mode 100644 index 0000000..61a6641 Binary files /dev/null and b/content/blog/mastering-tabi-settings/img/external_link_dark.webp differ diff --git a/content/blog/mastering-tabi-settings/img/external_link_light.webp b/content/blog/mastering-tabi-settings/img/external_link_light.webp new file mode 100644 index 0000000..16d03a1 Binary files /dev/null and b/content/blog/mastering-tabi-settings/img/external_link_light.webp differ diff --git a/content/blog/mastering-tabi-settings/img/jump_to_series_posts_dark.webp b/content/blog/mastering-tabi-settings/img/jump_to_series_posts_dark.webp new file mode 100644 index 0000000..4790470 Binary files /dev/null and b/content/blog/mastering-tabi-settings/img/jump_to_series_posts_dark.webp differ diff --git a/content/blog/mastering-tabi-settings/img/jump_to_series_posts_light.webp b/content/blog/mastering-tabi-settings/img/jump_to_series_posts_light.webp new file mode 100644 index 0000000..4fee0d6 Binary files /dev/null and b/content/blog/mastering-tabi-settings/img/jump_to_series_posts_light.webp differ diff --git a/content/blog/mastering-tabi-settings/img/pinned_post_dark.webp b/content/blog/mastering-tabi-settings/img/pinned_post_dark.webp new file mode 100644 index 0000000..6111f62 Binary files /dev/null and b/content/blog/mastering-tabi-settings/img/pinned_post_dark.webp differ diff --git a/content/blog/mastering-tabi-settings/img/pinned_post_light.webp b/content/blog/mastering-tabi-settings/img/pinned_post_light.webp new file mode 100644 index 0000000..ddddc44 Binary files /dev/null and b/content/blog/mastering-tabi-settings/img/pinned_post_light.webp differ diff --git a/content/blog/mastering-tabi-settings/img/projects_tag_filter_dark.webp b/content/blog/mastering-tabi-settings/img/projects_tag_filter_dark.webp new file mode 100644 index 0000000..a7c9fd4 Binary files /dev/null and b/content/blog/mastering-tabi-settings/img/projects_tag_filter_dark.webp differ diff --git a/content/blog/mastering-tabi-settings/img/projects_tag_filter_light.webp b/content/blog/mastering-tabi-settings/img/projects_tag_filter_light.webp new file mode 100644 index 0000000..42c9c36 Binary files /dev/null and b/content/blog/mastering-tabi-settings/img/projects_tag_filter_light.webp differ diff --git a/content/blog/mastering-tabi-settings/img/webmention_dark.webp b/content/blog/mastering-tabi-settings/img/webmention_dark.webp new file mode 100644 index 0000000..2d4290f Binary files /dev/null and b/content/blog/mastering-tabi-settings/img/webmention_dark.webp differ diff --git a/content/blog/mastering-tabi-settings/img/webmention_light.webp b/content/blog/mastering-tabi-settings/img/webmention_light.webp new file mode 100644 index 0000000..f555252 Binary files /dev/null and b/content/blog/mastering-tabi-settings/img/webmention_light.webp differ diff --git a/content/blog/mastering-tabi-settings/index.ca.md b/content/blog/mastering-tabi-settings/index.ca.md index e77a1c0..b866951 100644 --- a/content/blog/mastering-tabi-settings/index.ca.md +++ b/content/blog/mastering-tabi-settings/index.ca.md @@ -1,13 +1,14 @@ +++ title = "Domina la configuració de tabi: guia completa" date = 2023-09-18 -updated = 2024-09-17 +updated = 2025-08-07 description = "Descobreix les múltiples maneres en què pots personalitzar tabi." [taxonomies] tags = ["funcionalitat", "tutorial", "preguntes freqüents"] [extra] +pinned = true quick_navigation_buttons = true social_media_card = "social_cards/ca_blog_mastering_tabi_settings.jpg" +++ @@ -110,46 +111,77 @@ header = {title = "Hola! Soc tabi~", img = "img/main.webp", img_alt = "Óscar Fe La descripció és contingut Markdown normal, escrit fora del front matter. -#### Mostrant publicacions recents +#### Llistant publicacions recents -Si vols mostrar publicacions a la pàgina principal, primer necessites decidir si la seva ruta serà `/` o quelcom diferent, com ara `/blog/`. +Per mostrar publicacions a la pàgina principal, primer has de decidir d'on es serviran: de la ruta arrel (`/`) o d'un subdirectori (per exemple, `/blog`). -Si vols servir les publicacions des de `/`, necessites configurar `paginate_by = 5` al front matter del teu arxiu `_index.md`. **Nota**: això no es configura a l'apartat `[extra]`, sinó al front matter principal. Exemple: +**Opció A: Servir publicacions des de la ruta arrel (`/`)** + +Configura `paginate_by` al front matter del teu arxiu `content/_index.md`: ```toml +title = "Últimes publicacions" sort_by = "date" -template = "section.html" -paginate_by = 5 +paginate_by = 5 # Mostra 5 publicacions per pàgina. [extra] -header = {title = "Hola! Sóc tabi~", img = "img/main.webp", img_alt = "Óscar Fernández, l'autor del tema" } +header = {title = "Hola! Soc tabi~", img = "img/main.webp", img_alt = "El teu nom" } ``` -Si prefereixes servir les publicacions des de `/blog`, pots configurar `section_path = "/blog"` a la secció `[extra]`. Aquesta és la configuració d'aquesta demo: +{{ admonition(type="note", text="La configuració `paginate_by` va al front matter principal, no a la secció `[extra]`.") }} + +**Opció B: Servir publicacions des d'un subdirectori (per exemple, `/blog`)** + +Utilitza `section_path` a la secció `[extra]` del teu arxiu `content/_index.md`: ```toml -title = "Publicacions recents" +title = "Últimes publicacions" sort_by = "date" -template = "section.html" +# No configuris `paginate_by` aquí. [extra] -header = {title = "Hola! Sóc tabi~", img = "img/main.webp", img_alt = "Óscar Fernández, l'autor del tema" } -section_path = "blog/_index.es.md" -max_posts = 4 +header = {title = "Hola! Soc tabi~", img = "img/main.webp", img_alt = "El teu nom" } +section_path = "blog/_index.md" # On trobar les teves publicacions. +max_posts = 5 # Mostra fins a 5 publicacions a la pàgina principal. ``` -Fixa't que si configures `section_path`, no cal que configuris `paginate_by`. Pots establir `max_posts` per determinar el nombre de publicacions que vols mostrar a la pàgina principal. +{{ admonition(type="warning", title="ALERTA", text="No configuris `paginate_by` i `section_path` alhora. Aquestes configuracions són mútuament excloents i usar ambdues pot fer que no es mostrin publicacions.") }} -El `title` és el títol que apareix a sobre de les publicacions. +Notes addicionals: + +- El `title` al front matter estableix el títol que apareix sobre les publicacions. +- Utilitza la ruta completa a l'arxiu `_index.md` de la secció per a `section_path`. Usar `section_path = "blog/"` no funcionarà. + +##### Fixar entrades + +Pots fixar entrades per mantenir-les a la part superior de la pàgina principal. En aquesta demo, aquesta entrada està fixada, així que apareix primera amb una icona i etiqueta de "fixada": + +{{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/pinned_post_light.webp", dark_src="blog/mastering-tabi-settings/img/pinned_post_dark.webp", alt="Entrada fixada", full_width=true) }} + +Les entrades fixades es mostren primer, mantenint el seu ordre relatiu segons el `sort_by` de la secció, seguides per les entrades regulars. + +Per fixar una entrada, afegeix el següent al seu front matter: + +```toml +[extra] +pinned = true +``` + +{{ admonition(type="info", text="Aquesta configuració només afecta les pàgines principals del lloc (com `/`, `/es/`, `/fr/`). Altres seccions com `blog/`, `tags/` o `archive/` mostren les publicacions en el seu ordre habitual.") }} + +{{ admonition(type="warning", text='Quan s'utilitza la paginació (`paginate_by`), les entrades fixades poden aparèixer dues vegades: una vegada a la part superior de la primera pàgina, i una altra en la seva posició cronològica normal en pàgines posteriors.') }} ##### Mostrar la data dels articles al llistat - Per defecte, quan es llisten els articles, es mostra la data de creació. Pots configurar quina(es) data(es) mostrar utilitzant l'opció `post_listing_date`. Configuracions disponibles: - `date`: Mostra només la data de publicació original de l'article (opció per defecte). - `updated`: Mostra només la data de l'última actualització de l'article. Si no hi ha data d'actualització, es mostra la data de publicació original. - `both`: Mostra tant la data de publicació original com la data de l'última actualització. +{% admonition(type="tip") %} +Aquesta configuració segueix la jerarquia: pots establir un valor global a `config.toml` o canviar-lo per a seccions específiques al seu arxiu `_index.md`. En ambdós casos, afegeix-lo a la secció `[extra]`. +{% end %} + #### Llistat de Projectes Pots mostrar una selecció de projectes a la teva pàgina principal. Per fer això, primer necessitaràs configurar el directori `projects`. @@ -191,7 +223,7 @@ Les skins («pells») de tabi canvien el color principal del lloc web. Pots conf {{ image_toggler(default_src="blog/customise-tabi/skins/lavender_light.webp", toggled_src="blog/customise-tabi/skins/lavender_dark.webp", default_alt="pell lavender en mode clar", toggled_alt="pell lavender en mode fosc", full_width=true) }} -Explora les skins disponibles i aprèn com crear la teva pròpia consultant [la documentació](/ca/blog/customise-tabi/#skins). +Explora les skins disponibles i aprèn com crear la teva pròpia consultant [la documentació](@/blog/customise-tabi/index.ca.md#skins). ### Font sans serif (pal sec) @@ -205,6 +237,25 @@ Fes clic a la imatge a continuació per comparar les fonts: {{ image_toggler(default_src="blog/mastering-tabi-settings/img/serif.webp", toggled_src="blog/mastering-tabi-settings/img/sans-serif.webp", default_alt="Font serif", toggled_alt="Font sans-serif", full_width=true) }} +### Indicador d'enllaços externs + +| Pàgina | Secció | `config.toml` | Segueix Jerarquia | Requereix JavaScript | +|:------:|:------:|:-------------:|:-----------------:|:-------------------:| +| ❌ | ❌ | ✅ | ❌ | ❌ | + +{{ admonition(type="info", text="Requereix Zola 0.20.0 o posterior.") }} + +Si vols afegir una icona als enllaços externs, configura la secció `[markdown]` (no `[extra]`) al teu `config.toml`: + +```toml +[markdown] +external_links_class = "external" +``` + +Això afegirà una petita icona al costat dels enllaços externs: + +{{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/external_link_light.webp", dark_src="blog/mastering-tabi-settings/img/external_link_dark.webp", alt="Icona d'enllaç extern", full_width=true) }} + ### Estils CSS personalitzats | Pàgina | Secció | `config.toml` | Segueix la jerarquia | Requereix JavaScript | @@ -256,6 +307,34 @@ Si configures `tag_sorting = "frequency"`, s'ordenaran segons el nombre de publi --- +## Sèries + +Per a una explicació detallada, consulta la [documentació de sèries](@/blog/series/index.ca.md). + +### Enllaç per saltar a les publicacions + +| Pàgina | Secció | `config.toml` | Segueix la jerarquia | Requereix JavaScript | +|:------:|:-------:|:-------------:|:------------------:|:-------------------:| +| ❌ | ✅ | ✅ | ✅ | ❌ | + +Per defecte, apareix automàticament un enllaç "Salta a les publicacions" al costat del títol de la sèrie quan una sèrie té un contingut de més de 2000 caràcters: + +{{ dual_theme_image(light_src="blog/series/img/jump_to_series_posts_light.webp", dark_src="blog/series/img/jump_to_series_posts_dark.webp" alt="enllaç per saltar a les publicacions de la sèrie", full_width=true) }} + +Estableix `show_jump_to_posts = true` per forçar l'activació de la funció i `show_jump_to_posts = false` per desactivar-la. + +### Indexació de pàgines de sèries + +| Pàgina | Secció | `config.toml` | Segueix la jerarquia | Requereix JavaScript | +|:------:|:-------:|:-------------:|:------------------:|:-------------------:| +| ❌ | ✅ | ✅ | ✅ | ❌ | + +Per defecte, les pàgines de sèries s'indexen (usant una indexació basada en 1) segons el `sort_by` de la secció de sèries. + +Estableix `post_listing_index_reversed = true` per invertir aquest índex. + +--- + ## Integració amb repositoris Git | Pàgina | Secció | `config.toml` | Segueix la jerarquia | Requereix JavaScript | @@ -314,7 +393,7 @@ quick_navigation_buttons = true - `show_reading_time = false` amaga el temps estimat de lectura. - `quick_navigation_buttons = true` mostra els botons de navegació ràpida. -Al costat del fitxer `_index.md`, pots crear un fitxer per a cada projecte. Per exemple, aquest és el bloc de metadades per a la pàgina del projecte [tabi](/ca/projects/tabi/): +Al costat del fitxer `_index.md`, pots crear un fitxer per a cada projecte. Per exemple, aquest és el bloc de metadades per a la pàgina del projecte [tabi](@/projects/tabi/index.ca.md): ```toml title = "tabi" @@ -334,6 +413,33 @@ Quan un usuari faci clic a la imatge o al títol d'un projecte, serà portat a l La pàgina del projecte individual es renderitza amb la plantilla predeterminada, tret que estableixis una altra, per exemple, `template = "info-page.html"`. +#### Filtrar projectes + +Si afegeixes etiquetes als teus projectes, veuràs un filtre d'etiquetes: + +{{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/projects_tag_filter_light.webp", dark_src="blog/mastering-tabi-settings/img/projects_tag_filter_dark.webp", alt="Pàgina de projectes amb filtre d'etiquetes", full_width=true) }} + +El sistema de filtratge d'etiquetes utilitza millora progressiva: + +- Sense JavaScript: Les etiquetes enllacen directament a pàgines d'etiquetes dedicades (per exemple, `/tags/nom-de-l-etiqueta`). +- Amb JavaScript: Filtratge instantani, sincronització d'URL (#nom-etiqueta) i navegació amb el teclat. + +Per desactivar aquesta funció, estableix `enable_cards_tag_filtering = false` a la secció `[extra]` del fitxer `projects/_index.md` o a `config.toml`. + +{% admonition(type="tip") %} + +Per filtrar projectes per etiquetes, necessites establir etiquetes a la front matter de cada projecte. Per exemple: + +```toml +title = "nom del projecte" +weight = 40 + +[taxonomies] +tags = ["etiqueta", "etiqueta 2", "tercera etiqueta"] +``` + +{% end %} + ### Arxiu Afegir una pàgina d'arxiu és similar a afegir una pàgina de projectes. Pots crear un directori a `content/archive/`. Allà, pots crear un fitxer `_index.md` amb el següent encapçalament: @@ -354,10 +460,14 @@ Per defecte, l'arxiu llistarà les publicacions situades a `blog/`. Per personal section_path = ["blog/", "notes/", "camí-tres/"] ``` -**Nota**: +L'arxiu mostra les publicacions en ordre cronològic invers (les més recents primer). Pots invertir aquest ordre establint `archive_reverse = true` a la secció `[extra]`: -- La pàgina d'arxiu només llistarà publicacions amb data. -- L'ordre de les publicacions ve determinada per la variable `sort_by` de les seccions arxivades. Aquesta demo utilitza `sort_by = "date"` en `blog/_index.md`. +```toml +[extra] +archive_reverse = true # mostra les publicacions més antigues primer +``` + +{{ admonition(type="note", title="nota" text="La pàgina d'arxiu només llistarà publicacions que tinguin data al seu encapçalament.") }} ### Etiquetes @@ -406,6 +516,17 @@ path = "about" Fixa't com s'estableix `path = "about"`. Zola situarà la pàgina a `$base_url/about/`. Si vols que la pàgina estigui disponible a `/contacte/`, hauries d'establir `path = "contacte"`. +La plantilla `info-page.html` també es pot utilitzar per crear landing pages a la ruta arrel (`"/"`). Per fer-ho, l'arxiu `content/_index.md` hauria de ser així: + +```markdown ++++ +title = "Títol de la pàgina" +template = "info-page.html" ++++ + +Contingut amb Markdown. +``` + --- ## SEO @@ -468,7 +589,19 @@ Si ambdues rutes, relativa i absoluta, són vàlides, la ruta relativa tindrà p Ja que segueix la [jerarquia](#jerarquia-de-configuracio), si no està configurat en una pàgina, però sí ho està en una secció, s'utilitzarà la imatge de la secció. Si no està configurat en una pàgina o secció, però sí en `config.toml`, s'utilitzarà la imatge global. -**Consell**: automatitza la seva creació amb un [script](https://github.com/welpo/osc.garden/blob/main/static/code/social-cards-zola): [De reservat a rei de les xarxes: automatitzant les vistes prèvies dels enllaços amb Zola](https://osc.garden/ca/blog/automating-social-media-cards-zola/). +{{ admonition(type="tip", title="CONSELL", text="Automatitza la seva creació amb un [script](https://github.com/welpo/osc.garden/blob/main/static/code/social-cards-zola): [Automatitzant les vistes prèvies dels enllaços amb Zola](https://osc.garden/ca/blog/automating-social-media-cards-zola/).") }} + +### Creador del fedivers + +| Pàgina | Secció | `config.toml` | Segueix jerarquia | Requereix JavaScript | +|:------:|:------:|:-------------:|:-----------------:|:--------------------:| +| ❌ | ❌ | ✅ | ❌ | ❌ | + +Pots mostrar el perfil del fedivers de l'autor en les previsualitzacions d'enllaços de Mastodon configurant la variable `fediverse_creator` al teu `config.toml`. Per exemple, per a @username@example.com, fes servir: + +```toml +fediverse_creator = { handle = "username", domain = "example.com" } +``` --- @@ -480,7 +613,9 @@ Ja que segueix la [jerarquia](#jerarquia-de-configuracio), si no està configura |:------:|:------:|:-------------:|:---------------:|:-------------------:| | ❌ | ❌ | ✅ | ❌ | ❌ | -La barra de navegació és la franja a la part superior de la pàgina que conté el títol del lloc i el menú de navegació. Pots personalitzar els elements que apareixen configurant `menu` en `config.toml`. Per exemple: +La barra de navegació és la franja a la part superior de la pàgina que conté el títol del lloc i el menú de navegació. Pots personalitzar els elements que apareixen configurant `menu` en `config.toml`. + +Soporta links relatius per a pàgines internes i links absoluts per a enllaços externs. Per exemple: ```toml menu = [ @@ -489,6 +624,7 @@ menu = [ { name = "etiquetes", url = "tags", trailing_slash = true }, { name = "projectes", url = "projects", trailing_slash = true }, { name = "sobre nosaltres", url = "about", trailing_slash = true }, + { name = "github", url = "https://github.com/welpo/tabi", trailing_slash = false }, ] ``` @@ -561,13 +697,21 @@ Establir `copy_button = true` afegirà un petit botó de copiar a la part superi {{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/copy_button_on_code_blocks_light.webp", dark_src="blog/mastering-tabi-settings/img/copy_button_on_code_blocks_dark.webp", alt="Botó de copiar en blocs de codi", full_width=true) }} -### Mostrar ruta/URL en blocs de codi +### Nom del bloc de codi clicable | Pàgina | Secció | `config.toml` | Segueix la jerarquia | Requereix JavaScript | |:------:|:-------:|:-------------:|:---------------:|:-------------------:| | ✅ | ✅ | ✅ | ✅ | ✅ | -Estableix `add_src_to_code_block = true` per habilitar l'ús del [shortcode `add_src_to_code_block`](@/blog/shortcodes/index.ca.md#mostrar-ruta-o-url). +En establir `code_block_name_links = true` s'habiliten els enllaços clicables als noms dels blocs de codi. Consulta la [documentació](@/blog/shortcodes/index.ca.md#mostrar-ruta-o-url) per veure exemples i ús. + +### Forçar blocs de codi d'esquerra a dreta + +| Pàgina | Secció | `config.toml` | Segueix la jerarquia | Requereix JavaScript | +|:------:|:------:|:-------------:|:-----------------:|:--------------------:| +| ✅ | ✅ | ✅ | ✅ | ❌ | + +Per defecte, els blocs de codi es renderitzen d'esquerra a dreta, independentment de la direcció general del text. Estableix `force_codeblock_ltr = false` per permetre que els blocs de codi segueixin la direcció del document. Útil per a idiomes de dreta a esquerra que necessiten blocs de codi de dreta a esquerra. ### Suport per a KaTeX @@ -595,10 +739,12 @@ Consulta la [documentació de Mermaid](@/blog/shortcodes/index.ca.md#diagrames-d |:------:|:------:|:-------------:|:------------------:|:--------------------:| | ❌ | ❌ | ✅ | ❌ | ❌ | -Les tipus de lletra personalitzades causen parpalleig del text en Firefox. Per resoldre això, tabi carrega un subconjunt de glifs per a la capçalera. Donat que això (lleugerament) augmenta el temps de càrrega inicial, és una bona idea intentar minimitzar la mida d'aquest subconjunt. +Les tipus de lletra personalitzades causen parpalleig del text en Firefox. Per resoldre això, tabi carrega un subconjunt de glifs per a la capçalera. Donat que això (lleugerament) augmenta el temps de càrrega inicial, és una bona idea intentar minimitzar la mida d'aquest subconjunt, o desactivar-lo completament si no estàs fent servir un tipus de lletra personalitzat al teu tema. Pots crear un subconjunt personalitzat adaptat al teu lloc, guardar-lo com a `static/custom_subset.css`, i fer que es carregui amb `custom_subset = true`. +Per desactivar el subconjunt, utilitza `enable_subset = false`. + Per obtenir més informació, incloent instruccions sobre com crear un subconjunt personalitzat, consulta la [documentació](@/blog/custom-font-subset/index.ca.md). ### Contingut complet al feed @@ -615,7 +761,10 @@ Per defecte, el feed Atom només conté el resum o descripció de les teves publ |:----:|:-------:|:-------------:|:-----------------:|:-------------------:| | ✅ | ✅ | ✅ | ✅ | ❌ | -Pots amagar pàgines específiques o seccions senceres del feed amb `hide_from_feed = true`. +Pots controlar com apareix el contingut als feeds utilitzant dues configuracions: + +- `hide_from_feed = true`: Amaga el contingut de tots els feeds (feed principal, feeds de secció i feeds d'etiquetes) +- `hide_from_main_feed = true`: Amaga el contingut només del feed principal mentre el manté visible als feeds de secció i d'etiquetes ### Comentaris {#afegir-comentaris} @@ -631,6 +780,35 @@ Si has activat un sistema de forma global i vols desactivar-lo per a una pàgina Llegeix la [documentació](@/blog/comments/index.ca.md) per a més informació sobre els sistemes disponibles i la seva configuració. +### Botons d'iine {#iine} + +| Pàgina | Secció | `config.toml` | Segueix la jerarquia | Requereix JavaScript | +|:------:|:------:|:-------------:|:--------------------:|:--------------------:| +| ✅ | ✅ | ✅ | ✅ | ❌ | + +tabi permet botons d'[iine](https://iine.to/) per mostrar apreciació anònima pel teu contingut. Aquests botons centrats en la privadesa funcionen sense JavaScript i no rastegen usuaris. + +Per activar els botons iine globalment: + +```toml +[extra] +iine = true +``` + +Pots personalitzar la icona usada als botons (segueix la jerarquia): + +```toml +[extra] +iine_icon = "thumbs_up" # Opcions: "heart", "thumbs_up", "upvote", o qualsevol emoji +``` + +Per a llocs multilingües, pots unificar els recomptes de likes entre versions en diferents idiomes del mateix contingut (configuració només de config; valor per defecte és `true`): + +```toml +[extra] +iine_unified_languages = true # Els likes a /ca/blog/hello/ compten cap a /blog/hello/ +``` + ### Anàlisi web | Pàgina | Secció | `config.toml` | Segueix la jerarquia | Requereix JavaScript | @@ -644,7 +822,7 @@ Pots configurar-los en la secció `[extra.analytics]` del teu arxiu `config.toml - `service`: el servei a utilitzar. Les opcions disponibles són `"goatcounter"`, `"umami", i "plausible"`. - `id`: l'identificador únic per al teu servei d'anàlisi. Això varia segons el servei: - - Per a GoatCounter, és el codi triat durant el registre. Instàncies auto-allotjades no requereixen aquest camp. + - Per a GoatCounter, és el codi triat durant el registre. Instàncies auto-allotjades de GoatCounter no requereixen aquest camp. - Per a Umami, és l'ID del lloc web. - Per a Plausible, és el nom de domini. @@ -653,6 +831,8 @@ Pots configurar-los en la secció `[extra.analytics]` del teu arxiu `config.toml - Per a Umami: `"https://umami.example.com"` - Per a Plausible: `"https://plausible.example.com"` +- `do_not_track`: (només per a Umami) opcional. Quan s'estableix com a `true`, es desactiva el seguiment per als usuaris els navegadors dels quals envien una capçalera "Do Not Track". + Un exemple de configuració per a GoatCounter no auto-allotjada seria: ```toml @@ -692,6 +872,8 @@ Per utilitzar una icona personalitzada, pots afegir-la al directori `static/soci { name = "custom", url = "https://example.com", icon = "custom" } ``` +{{ admonition(type="note", title="NOTA", text="Tots els enllaços a xarxes socials inclouen l'[atribut](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel/me) `rel='me'`. Això ajuda els motors de cerca i serveis web a verificar que les comptes de xarxes socials et pertanyen.") }} + ### Icona de feed | Pàgina | Secció | `config.toml` | Segueix la jerarquia | Requereix JavaScript | @@ -786,12 +968,25 @@ Per defecte, la data es mostra sota el títol de la publicació. Pots amagar-la |:------:|:-------:|:-------------:|:---------------------:|:-------------------:| | ❌ | ❌ | ✅ | ❌ | ❌ | -tabi té dos formats de data: `long_date_format` i `short_date_format`. El format curt s'utilitza a les metadades d'una publicació, mentre que el format llarg s'utilitza al llistar les publicacions (és a dir, a la [secció de blog](/ca/blog/) o a la [pàgina principal](/ca/)). +tabi té tres formats de data: `long_date_format`, `short_date_format` i `archive_data_format`. El format curt s'utilitza a les metadades d'una publicació, mentre que el format llarg s'utilitza al llistar les publicacions (és a dir, a la [secció de blog](/ca/blog/) o a la [pàgina principal](/ca/)). El format d'arxiu s'utilitza per mostrar el dia i el mes a la pàgina d'arxiu. -Per defecte és "6th July 2049" per a ambdós formats en anglès. Per a altres idiomes, el predeterminat és `"%d %B %Y"` per al format llarg i `"%-d %b %Y"` per al format curt. +Per defecte és "6th July 2049" per als formats curt i llarg en anglès. Per a altres idiomes, el predeterminat és `"%d %B %Y"` per al format llarg i `"%-d %b %Y"` per al format curt. El format d'arxiu predeterminat universal és `"%d %b"`. A Zola, la sintaxi per al format de temps està inspirada en strftime. Una referència completa està disponible a la [documentació de chrono](https://docs.rs/chrono/0.4.31/chrono/format/strftime/index.html). +#### Formats de data per idioma + +Pots personalitzar els formats de data per idiomes específics utilitzant la matriu `date_formats` a `config.toml`: + +```toml +date_formats = [ + { lang = "es", long = "%d de %B de %Y", short = "%-d %b %Y", archive = "%d de %b" }, + { lang = "de", long = "%d. %B %Y", short = "%d.%m.%Y", archive = "%d. %b" }, +] +``` + +Això permet que diferents idiomes utilitzin formats de data culturalment apropiats (per exemple, "6. Juli 2049" per a alemany VS "6 de julio de 2049" per a espanyol). + ### Separador personalitzat | Pàgina | Secció | `config.toml` | Segueix la jerarquia | Requereix JavaScript | @@ -854,6 +1049,68 @@ Aquesta opció està habilitada per defecte. Per desactivar-la per una pàgina, Per a més informació, consulta la [pàgina de documentació de CSP](@/blog/security/index.ca.md). +--- + +## Indieweb + +### Webmentions + +| Pàgina | Secció | `config.toml` | Segueix jerarquia | Requereix JavaScript | +|:------:|:------:|:-------------:|:-----------------:|:--------------------:| +| ❓ | ❓ | ✅ | ❓ | ✅ | + +Com es descriu en l'estàndard W3C recomanat, [Webmention](https://www.w3.org/TR/webmention/#abstract-p-1) és una manera senzilla de notificar qualsevol URL quan la menciones al teu lloc web. Des de la perspectiva del receptor, és una manera de sol·licitar notificacions quan altres llocs web la mencionen. + +Per a llocs web estàtics, [webmention.io](https://webmention.io/) allotja un punt final de webmention que es pot utilitzar per rebre webmentions. Aquesta funcionalitat recupera les webmentions emmagatzemades a webmention.io i les mostra per a una pàgina. Hauràs de configurar un compte per al teu lloc web a webmention.io. Quan habilitis la funcionalitat de webmention, anunciarà el teu punt final de webmention.io i mostrarà les webmentions per a qualsevol pàgina. + +Habilita les webmentions per al teu lloc web afegint el següent al teu fitxer `config.toml`. + +```toml +[extra.webmentions] +enable = true +# Especifica el domini registrat amb webmention.io. +domain = "www.example.com" +``` + +❓: Per desactivar les webmentions per a una secció o pàgina específica, estableix `webmentions = false` a la secció `[extra]` del front matter d'aquesta secció o pàgina. + +La secció de webmentions es veu així: + +{{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/webmention_light.webp", dark_src="blog/mastering-tabi-settings/img/webmention_dark.webp" alt="Captura de pantalla de webmentions mostrant republications, m'agrada, marcadors i comentaris", full_width=true) }} + +### h-card representativa + +| Pàgina | Secció | `config.toml` | Segueix la jerarquia | Requereix JavaScript | +| :--: | :-----: | :-----------: | :---------------: | :-----------------: | +| ❌ | ❌ | ✅ | ❌ | ❌ | + +Per defecte, tabi afegeix una h-card representativa [h-card](https://microformats.org/wiki/h-card) **oculta** a la pàgina d'inici. Tot i que és invisible per als visitants, està disponible per als analitzadors de microformats. Pots comprovar la validesa de la targeta amb l'eina [Indiewebify.me](https://indiewebify.me/validate-h-card/). + +Per desactivar l'h-card, estableix `enable = false` a la secció `[extra.hcard]` de `config.toml`. + +L'h-card predeterminada inclou el teu nom, l'URL del lloc web i els enllaços a les xarxes socials. + +Pots establir una imatge de perfil i una petita biografia amb els paràmetres `avatar` i `biography`. + +Totes les altres [propietats h-card](https://microformats.org/wiki/h-card#Properties) es poden afegir llistant-les a la secció `[extra.hcard]` del fitxer de configuració. Simplement substitueix tots els caràcters `-` per `_`. + +--- + +## Estenent elements HTML a tabi + +Alguns elements HTML a tabi es poden estendre per admetre casos d'ús addicionals, com ara afegir JavaScript personalitzat per a comportaments a tot el lloc al final de l'etiqueta `` o incloure contingut addicional al final de l'element `` que no estigui suportat per altres configuracions de tabi. + +Consulta la taula a continuació per veure els elements que es poden estendre: + +| Element | Plantilla | +| :------: | :-------------------------------: | +| `` | `templates/tabi/extend_head.html` | +| `` | `templates/tabi/extend_body.html` | + +No hi ha configuracions explícites que hagis d'establir per al teu lloc o pàgines. Simplement crea el fitxer de plantilla corresponent per al teu lloc, i tabi l'inclourà automàticament. + +--- + [^1]: Si estàs utilitzant un repositori Git remot, potser voldràs automatitzar el procés d'actualització del camp `updated`. Aquí tens una guia per a això: [Zola Git Hook: actualitzant les dates de les publicacions](https://osc.garden/ca/blog/zola-date-git-hook/). [^2]: Per a codificar el teu correu electrònic en base64 pots utilitzar [eines en línia](https://www.base64encode.org/) o, al teu terminal, executar: `printf 'mail@example.com' | base64` diff --git a/content/blog/mastering-tabi-settings/index.es.md b/content/blog/mastering-tabi-settings/index.es.md index 3dc5833..ba259fe 100644 --- a/content/blog/mastering-tabi-settings/index.es.md +++ b/content/blog/mastering-tabi-settings/index.es.md @@ -1,13 +1,14 @@ +++ title = "Domina la configuración de tabi: guía completa" date = 2023-09-18 -updated = 2024-09-17 +updated = 2025-08-07 description = "Descubre las múltiples maneras en que puedes personalizar tabi." [taxonomies] tags = ["funcionalidad", "tutorial", "preguntas frecuentes"] [extra] +pinned = true quick_navigation_buttons = true social_media_card = "social_cards/es_blog_mastering_tabi_settings.jpg" +++ @@ -110,37 +111,65 @@ header = {title = "¡Hola! Soy tabi~", img = "blog/mastering-tabi-settings/img/m La descripción es contenido Markdown normal, escrito fuera del front matter. -#### Mostrando publicaciones recientes +#### Listando publicaciones recientes -Si deseas mostrar publicaciones en la página principal, primero necesitas decidir si su ruta será `/` o algo como `/blog`. +Para mostrar publicaciones en la página principal, primero debes decidir de dónde se servirán: de la ruta raíz (`/`) o de un subdirectorio (por ejemplo, `/blog`). -Si quieres servir las publicaciones desde `/`, necesitas configurar `paginate_by = 5` en el front matter de tu archivo `_index.md`. **Nota**: esto no se configura en el apartado `[extra]`, sino en el front matter principal. Ejemplo: +**Opción A: Servir publicaciones desde la ruta raíz (`/`)** + +Configura `paginate_by` en el front matter de tu archivo `content/_index.md`: ```toml +title = "Últimas publicaciones" sort_by = "date" -template = "section.html" -paginate_by = 5 +paginate_by = 5 # Muestra 5 publicaciones por página. [extra] -header = {title = "¡Hola! Soy tabi~", img = "img/main.webp", img_alt = "Óscar Fernández, el autor del tema" } +header = {title = "¡Hola! Soy tabi~", img = "img/main.webp", img_alt = "Tu nombre" } ``` -Si prefieres servir las publicaciones desde `/blog`, puedes configurar `section_path = "/blog"` en la sección `[extra]`. Esta es la configuración de esta demo: +{{ admonition(type="note", text="La configuración `paginate_by` va en el front matter principal, no en la sección `[extra]`.") }} + +**Opción B: Servir publicaciones desde un subdirectorio (por ejemplo, `/blog`)** + +Utiliza `section_path` en la sección `[extra]` de tu archivo `content/_index.md`: ```toml -title = "Publicaciones recientes" +title = "Últimas publicaciones" sort_by = "date" -template = "section.html" +# No configures `paginate_by` aquí. [extra] -header = {title = "¡Hola! Soy tabi~", img = "img/main.webp", img_alt = "Óscar Fernández, el autor del tema" } -section_path = "blog/_index.es.md" -max_posts = 4 +header = {title = "¡Hola! Soy tabi~", img = "img/main.webp", img_alt = "Tu nombre" } +section_path = "blog/_index.md" # Dónde encontrar tus publicaciones. +max_posts = 5 # Muestra hasta 5 publicaciones en la página principal. ``` -Fíjate que si configuras `section_path`, no necesitas configurar `paginate_by`. Puedes establecer `max_posts` para determinar el número de publicaciones que deseas mostrar en la página principal. +{{ admonition(type="warning", title="ALERTA", text="No configures `paginate_by` y `section_path` a la vez. Estas configuraciones son mutuamente excluyentes y usarlas juntas puede resultar en que no se muestren publicaciones.") }} -El `title` es el encabezado que aparece sobre las publicaciones. +Notas adicionales: + +- El `title` en el front matter establece el título que aparece sobre las publicaciones. +- Usa la ruta completa al archivo `_index.md` de la sección para `section_path`. Usar `section_path = "blog/"` no funcionará. + +##### Fijar publicaciones + +Puedes fijar publicaciones para mantenerlas en la parte superior de la página principal. En esta demo, esta publicación está fijada, por lo que aparece primera con un icono y etiqueta de "fijada": + +{{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/pinned_post_light.webp", dark_src="blog/mastering-tabi-settings/img/pinned_post_dark.webp", alt="Entrada fijada", full_width=true) }} + +Las publicaciones fijadas se muestran primero, manteniendo su orden relativo según el `sort_by` de la sección, seguidas por el resto de las publicaciones. + +Para fijar una publicación, añade lo siguiente a su front matter: + +```toml +[extra] +pinned = true +``` + +{{ admonition(type="info", text="Este ajuste solo afecta a las páginas principales del sitio (como `/`, `/es/`, `/fr/`). Otras secciones como `blog/`, `tags/` o `archive/` muestran las publicaciones en su orden habitual.") }} + +{{ admonition(type="warning", text='Cuando se utiliza la paginación (`paginate_by`), las publicaciones destacadas pueden aparecer dos veces: una vez en la parte superior de la primera página, y otra en su posición cronológica normal en páginas posteriores.') }} ##### Mostrar la fecha de los artículos en el listado @@ -150,6 +179,10 @@ Por defecto, cuando se listan los artículos, se muestra la fecha de creación. - `updated`: Muestra solo la fecha de la última actualización del artículo. Si no hay fecha de actualización, muestra la fecha de publicación original. - `both`: Muestra tanto la fecha de publicación original como la fecha de la última actualización. +{% admonition(type="tip") %} +Esta configuración sigue la jerarquía: puedes establecer un valor global en `config.toml` o configurarlo para secciones específicas en su archivo `_index.md`. En ambos casos, añádelo a la sección `[extra]`. +{% end %} + #### Listado de proyectos Puedes mostrar una selección de proyectos en tu página principal. Para hacer esto, primero necesitarás configurar el directorio `projects`. @@ -191,7 +224,7 @@ Las pieles de tabi cambian el color principal del sitio. Puedes configurar la pi {{ image_toggler(default_src="blog/customise-tabi/skins/lavender_light.webp", toggled_src="blog/customise-tabi/skins/lavender_dark.webp", default_alt="piel lavender en modo claro", toggled_alt="piel lavender en modo oscuro", full_width=true) }} -Explora las pieles disponibles y aprende cómo crear la tuya propia consultando [la documentación](/es/blog/customise-tabi/#skins). +Explora las pieles disponibles y aprende cómo crear la tuya propia consultando [la documentación](@/blog/customise-tabi/index.es.md#skins). ### Fuente sans serif (paloseco) @@ -205,6 +238,25 @@ Haz clic en la imagen para comparar las fuentes: {{ image_toggler(default_src="blog/mastering-tabi-settings/img/serif.webp", toggled_src="blog/mastering-tabi-settings/img/sans-serif.webp", default_alt="Fuente serif", toggled_alt="Fuente sans-serif", full_width=true) }} +### Indicador de enlaces externos + +| Página | Sección | `config.toml` | Sigue Jerarquía | Requiere JavaScript | +|:------:|:-------:|:-------------:|:----------------:|:------------------:| +| ❌ | ❌ | ✅ | ❌ | ❌ | + +{{ admonition(type="info", text="Requiere Zola 0.20.0 o posterior.") }} + +Si deseas añadir un icono a los enlaces externos, configura la sección `[markdown]` (no `[extra]`) en tu `config.toml`: + +```toml +[markdown] +external_links_class = "external" +``` + +Esto añadirá un pequeño icono junto a los enlaces externos: + +{{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/external_link_light.webp", dark_src="blog/mastering-tabi-settings/img/external_link_dark.webp", alt="Icono de enlace externo", full_width=true) }} + ### Estilos CSS personalizados | Página | Sección | `config.toml` | Sigue la jerarquía | Requiere JavaScript | @@ -256,6 +308,34 @@ Si configuras `tag_sorting = "frequency"`, se ordenarán según el número de pu --- +## Series + +Para una explicación detallada, consulta la [documentación de series](@/blog/series/index.es.md). + +### Enlace para saltar a las publicaciones + +| Página | Sección | `config.toml` | Sigue jerarquía | Requiere JavaScript | +|:------:|:-------:|:-------------:|:------------------:|:-------------------:| +| ❌ | ✅ | ✅ | ✅ | ❌ | + +Por defecto, aparece automáticamente un enlace "Saltar a publicaciones" junto al título de la serie cuando una serie tiene un contenido de más de 2000 caracteres: + +{{ dual_theme_image(light_src="blog/series/img/jump_to_series_posts_light.webp", dark_src="blog/series/img/jump_to_series_posts_dark.webp" alt="enlace para saltar a las publicaciones de la serie", full_width=true) }} + +Establece `show_jump_to_posts = true` para forzar la activación de la función y `show_jump_to_posts = false` para desactivarla. + +### Indexación de páginas de series + +| Página | Sección | `config.toml` | Sigue la jerarquía | Requiere JavaScript | +|:------:|:-------:|:-------------:|:------------------:|:-------------------:| +| ❌ | ✅ | ✅ | ✅ | ❌ | + +Por defecto, las páginas de series se indexan (usando una indexación basada en 1) según el `sort_by` de la sección de series. + +Establece `post_listing_index_reversed = true` para invertir el índice. + +--- + ## Integración con repositorios Git | Página | Sección | `config.toml` | Sigue la jerarquía | Requiere JavaScript | @@ -314,7 +394,7 @@ quick_navigation_buttons = true - `show_reading_time = false` oculta el tiempo estimado de lectura. - `quick_navigation_buttons = true` muestra los botones de navegación rápida. -Junto al archivo `_index.md`, puedes crear un archivo para cada proyecto. Por ejemplo, este es el bloque de metadatos para la página del proyecto [tabi](/es/projects/tabi/): +Junto al archivo `_index.md`, puedes crear un archivo para cada proyecto. Por ejemplo, este es el bloque de metadatos para la página del proyecto [tabi](@/projects/tabi/index.es.md): ```toml title = "tabi" @@ -334,6 +414,33 @@ Cuando un usuario haga clic en la imagen o el título de un proyecto, será llev La página del proyecto individual se renderiza con la plantilla predeterminada, a menos que establezcas otra, por ejemplo, `template = "info-page.html"`. +#### Filtrar proyectos + +Si agregas etiquetas a tus proyectos, verás un filtro de etiquetas: + +{{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/projects_tag_filter_light.webp", dark_src="blog/mastering-tabi-settings/img/projects_tag_filter_dark.webp", alt="Página de proyectos con filtro de etiquetas", full_width=true) }} + +El sistema de filtrado de etiquetas utiliza mejora progresiva: + +- Sin JavaScript: Las etiquetas enlazan directamente a páginas de etiquetas dedicadas (por ejemplo, `/tags/nombre-etiqueta`). +- Con JavaScript: Filtrado instantáneo, sincronización de URL (#nombre-etiqueta) y navegación por teclado. + +Para desactivar esta función, establece `enable_cards_tag_filtering = false` en la sección `[extra]` del archivo `projects/_index.md` o en `config.toml`. + +{% admonition(type="tip") %} + +Para filtrar proyectos por etiquetas, necesitas establecer etiquetas en el front matter de cada proyecto. Por ejemplo: + +```toml +title = "nombre del proyecto" +weight = 40 + +[taxonomies] +tags = ["etiqueta uno", "etiqueta 2", "tercera etiqueta"] +``` + +{% end %} + ### Archivo Agregar una página de archivo es similar a agregar una página de proyectos. Puedes crear un directorio en `content/archive/`. Allí, puedes crear un archivo `_index.md` con el siguiente encabezado: @@ -354,10 +461,14 @@ Por defecto, el archivo mostrará las publicaciones ubicadas en `blog/`. Para pe section_path = ["blog/", "notas/", "ruta-tres/"] ``` -**Nota**: +El archivo muestra las publicaciones en orden cronológico inverso (las más recientes primero). Puedes invertir este orden estableciendo `archive_reverse = true` en la sección `[extra]`: -- La página de Archivo sólo listará publicaciones con fecha. -- El orden las publicaciones viene determinada por la variable `sort_by` de las secciones archivadas. Esta demo utiliza `sort_by = "date"` en `blog/_index.md`. +```toml +[extra] +archive_reverse = true # muestra las publicaciones más antiguas primero +``` + +{{ admonition(type="note", title="nota" text="La página de Archivo sólo listará publicaciones que tengan fecha en su encabezado.") }} ### Etiquetas @@ -406,6 +517,17 @@ path = "about" Fíjate cómo se establece `path = "about"`. Zola colocará la página en `$base_url/about/`. Si deseas que la página esté disponible en `/contacto/`, tendrías que establecer `path = "contacto"`. +La plantilla `info-page.html` también se puede utilizar para crear lading pages en la ruta raíz (`"/"`). Para hacerlo, el archivo `content/_index.md` debería verse así: + +```markdown ++++ +title = "Título de la página" +template = "info-page.html" ++++ + +Contenido con Markdown. +``` + --- ## SEO @@ -468,7 +590,19 @@ Si ambas rutas, relativa y absoluta, son válidas, la ruta relativa tendrá prio Dado que sigue la [jerarquía](#jerarquia-de-configuracion), si no está configurado en una página, pero sí lo está en una sección, se utilizará la imagen de la sección. Si no está configurado en una página o sección, pero sí en `config.toml`, se usará la imagen global. -**Consejo**: automatiza su creación con un [script](https://github.com/welpo/osc.garden/blob/main/static/code/social-cards-zola): [De reservado a rey de las redes: automatizando las vistas previas de los enlaces con Zola](https://osc.garden/es/blog/automating-social-media-cards-zola/). +{{ admonition(type="tip", title="CONSEJO", text="Automatiza su creación con un [script](https://github.com/welpo/osc.garden/blob/main/static/code/social-cards-zola): [Automatizando las vistas previas de los enlaces con Zola](https://osc.garden/es/blog/automating-social-media-cards-zola/).") }} + +### Creador del fediverso + +| Página | Sección | `config.toml` | Sigue jerarquía | Requiere JavaScript | +|:------:|:-------:|:-------------:|:----------------:|:-------------------:| +| ❌ | ❌ | ✅ | ❌ | ❌ | + +Puedes mostrar tu perfil del fediverso en las vistas previas de enlaces de Mastodon configurando la variable `fediverse_creator` en tu `config.toml`. Por ejemplo, para @username@example.com, usa: + +```toml +fediverse_creator = { handle = "username", domain = "example.com" } +``` --- @@ -480,7 +614,9 @@ Dado que sigue la [jerarquía](#jerarquia-de-configuracion), si no está configu |:------:|:-------:|:-------------:|:---------------:|:-------------------:| | ❌ | ❌ | ✅ | ❌ | ❌ | -La barra de navegación es la barra en la parte superior de la página que contiene el título del sitio y el menú de navegación. Puedes personalizar los elementos que aparecen configurando `menu` en `config.toml`. Por ejemplo: +La barra de navegación es la barra en la parte superior de la página que contiene el título del sitio y el menú de navegación. Puedes personalizar los elementos que aparecen configurando `menu` en `config.toml`. + +Soporta links relativos para páginas internas y links absolutos para enlaces externos. Por ejemplo: ```toml menu = [ @@ -489,6 +625,7 @@ menu = [ { name = "etiquetas", url = "tags", trailing_slash = true }, { name = "proyectos", url = "projects", trailing_slash = true }, { name = "acerca de", url = "about", trailing_slash = true }, + { name = "github", url = "https://github.com/welpo/tabi", trailing_slash = false }, ] ``` @@ -561,13 +698,21 @@ Establecer `copy_button = true` añadirá un pequeño botón de copiar en la par {{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/copy_button_on_code_blocks_light.webp", dark_src="blog/mastering-tabi-settings/img/copy_button_on_code_blocks_dark.webp", alt="Botón de copiar en bloques de código", full_width=true) }} -### Mostrar ruta/URL en bloques de código +### Nombres de bloques de código clicables | Página | Sección | `config.toml` | Sigue la jerarquía | Requiere JavaScript | |:------:|:-------:|:-------------:|:---------------:|:-------------------:| | ✅ | ✅ | ✅ | ✅ | ✅ | -Establece `add_src_to_code_block = true` para habilitar el uso del [shortcode `add_src_to_code_block`](@/blog/shortcodes/index.es.md#mostrar-ruta-o-url). +Establece `code_block_name_links = true` para habilitan los enlaces clickables en los nombres de bloques de código. Consulta la [documentación](@/blog/shortcodes/index.es.md#mostrar-ruta-o-url) para ver ejemplos y uso. + +### Forzar bloques de código de izquierda a derecha + +| Página | Sección | `config.toml` | Sigue la jerarquía | Requiere JavaScript | +|:------:|:-------:|:-------------:|:----------------:|:-------------------:| +| ✅ | ✅ | ✅ | ✅ | ❌ | + +Por defecto, los bloques de código se renderizan de izquierda a derecha, independientemente de la dirección general del texto. Establece `force_codeblock_ltr = false` para permitir que los bloques de código sigan la dirección del documento. Útil para idiomas de derecha a izquierda que necesitan bloques de código de derecha a izquierda. ### Soporte para KaTeX @@ -595,10 +740,12 @@ Consulta la [documentación de Mermaid](@/blog/shortcodes/index.es.md#diagramas- |:------:|:-------:|:-------------:|:---------------:|:-------------------:| | ❌ | ❌ | ✅ | ❌ | ❌ | -Las fuentes personalizadas causan parpadeo del texto en Firefox. Para solucionar esto, tabi carga un subconjunto de glifos para el encabezado. Dado que esto (ligeramente) aumenta el tiempo de carga inicial, es una buena idea intentar minimizar el tamaño de este subconjunto. +Las fuentes personalizadas causan parpadeo del texto en Firefox. Para solucionar esto, tabi carga un subconjunto de glifos para el encabezado. Dado que esto (ligeramente) aumenta el tiempo de carga inicial, es una buena idea intentar minimizar el tamaño de este subconjunto, o desactivarlo por completo si no estás usando una fuente personalizada en tu tema. Puedes crear un subconjunto personalizado adaptado a tu sitio, guardarlo como `static/custom_subset.css`, y hacer que se cargue con `custom_subset = true`. +Para desactivar el subconjunto, puedes usar `enable_subset = false`. + Para obtener más información, incluyendo instrucciones sobre cómo crear un subconjunto personalizado, consulta la [documentación](@/blog/custom-font-subset/index.es.md). ### Contenido completo en el feed @@ -615,7 +762,10 @@ Por defecto, el feed Atom solo contiene el resumen/descripción de tus publicaci |:----:|:-------:|:-------------:|:-----------------:|:-------------------:| | ✅ | ✅ | ✅ | ✅ | ❌ | -Puedes ocultar páginas específicas o secciones enteras del feed con `hide_from_feed = true`. +Puedes controlar cómo aparece el contenido en los feeds usando dos configuraciones: + +- `hide_from_feed = true`: Oculta el contenido de todos los feeds (feed principal, feeds de sección y feeds de etiquetas) +- `hide_from_main_feed = true`: Oculta el contenido solo del feed principal mientras lo mantiene visible en los feeds de sección y de etiquetas ### Comentarios {#añadir-comentarios} @@ -631,6 +781,37 @@ Si has activado un sistema globalmente, pero quieres desactivarlo en una página Lee la [documentación](@/blog/comments/index.es.md) para obtener más información sobre los sistemas disponibles y su configuración. +### Botones de iine {#iine} + +| Página | Sección | `config.toml` | Sigue la jerarquía | Requiere JavaScript | +|:------:|:-------:|:-------------:|:-------------------:|:-------------------:| +| ✅ | ✅ | ✅ | ✅ | ❌ | + +tabi soporta botones de [iine](https://iine.to/) para mostrar apreciación anónima por tu contenido. Estos botones centrados en la privacidad funcionan sin JavaScript y no rastrean usuarios. + +Para activar los botones iine globalmente: + +```toml +[extra] +iine = true +``` + +Puedes personalizar el icono usado en los botones (esta configuración sigue la jerarquía): + +```toml +[extra] +iine_icon = "thumbs_up" # Opciones: "heart", "thumbs_up", "upvote", o cualquier emoji +``` + +Para sitios multilingües, puedes unificar los conteos de likes entre versiones en diferentes idiomas del mismo contenido (configuración solo de config; valor predeterminado: `true`): + +```toml +[extra] +iine_unified_languages = true # Los likes en /es/blog/hello/ cuentan hacia /blog/hello/ +``` + +También puedes activar los botones iine en páginas o secciones individuales estableciendo `iine = true` en su front matter, o personalizar el icono con `iine_icon = "🚀"`. + ### Análisis web | Página | Sección | `config.toml` | Sigue Jerarquía | Requiere JavaScript | @@ -644,7 +825,7 @@ Puedes configurarlos en la sección `[extra.analytics]` de tu archivo `config.to - `service`: el servicio a utilizar. Las opciones disponibles son `"goatcounter"`, `"umami"`, y `"plausible"`. - `id`: el identificador único para tu servicio de análisis. Esto varía según el servicio: - - Para GoatCounter, es el código elegido durante el registro. Instancias auto-alojadas no requieren este campo. + - Para GoatCounter, es el código elegido durante el registro. Instancias auto-alojadas de GoatCounter no requieren este campo. - Para Umami, es la ID del sitio web. - Para Plausible, es el nombre de dominio. @@ -653,6 +834,8 @@ Puedes configurarlos en la sección `[extra.analytics]` de tu archivo `config.to - Para Umami: `"https://umami.example.com"` - Para Plausible: `"https://plausible.example.com"` +- `do_not_track`: (sólo para Umami) opcional. Cuando se establece en `true`, se desactiva el seguimiento para los usuarios cuyos navegadores envían un encabezado "Do Not Track". + Un ejemplo de configuración para GoatCounter no auto-alojada sería: ```toml @@ -694,6 +877,8 @@ Para usar un icono personalizado, puedes añadirlo al directorio `static/social_ { name = "custom", url = "https://example.com", icon = "custom" } ``` +{{ admonition(type="note", title="NOTA", text="Todos los enlaces sociales incluyen el [atributo](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel/me) `rel='me'`. Esto ayuda a los motores de búsqueda y servicios web a verificar que las cuentas de redes sociales te pertenecen.") }} + ### Icono de feed | Página | Sección | `config.toml` | Respeta jerarquía | Requiere JavaScript | @@ -788,12 +973,25 @@ Por defecto, la fecha se muestra debajo del título de la publicación. Puedes o |:------:|:-------:|:-------------:|:------------------:|:-------------------:| | ❌ | ❌ | ✅ | ❌ | ❌ | -tabi tiene dos formatos de fecha: `long_date_format` y `short_date_format`. El formato corto se utiliza en los metadatos de una publicación, mientras que el formato largo se utiliza al listar las publicaciones (es decir, en la [sección de blog](/es/blog/) o en la [página principal](/es/)). +tabi tiene tres formatos de fecha: `long_date_format`, `short_date_format` y `archive_date_format`. El formato corto se utiliza en los metadatos de una publicación, mientras que el formato largo se utiliza al listar las publicaciones (es decir, en la [sección de blog](/es/blog/) o en la [página principal](/es/)). El formato de archivo se usa para mostrar el día y el mes en la página de archivo. -Por defecto es "6th July 2049" para ambos formatos en inglés. Para otros idiomas, el predeterminado es `"%d %B %Y"` para el formato largo y `"%-d %b %Y"` para el formato corto. +Por defecto es "6th July 2049" para los formatos corto y largo en inglés. Para otros idiomas, el predeterminado es `"%d %B %Y"` para el formato largo y `"%-d %b %Y"` para el formato corto. El formato de archivo predeterminado universal es `"%d %b"`. En Zola, la sintaxis para el formateo de tiempo está inspirada en strftime. Una referencia completa está disponible en la [documentación de chrono](https://docs.rs/chrono/0.4.31/chrono/format/strftime/index.html). +#### Formatos de fecha por idioma + +Puedes personalizar los formatos de fecha para idiomas específicos usando la matriz `date_formats` en `config.toml`: + +```toml +date_formats = [ + { lang = "es", long = "%d de %B de %Y", short = "%-d %b %Y", archive = "%d de %b" }, + { lang = "de", long = "%d. %B %Y", short = "%d.%m.%Y", archive = "%d. %b" }, +] +``` + +Esto permite que diferentes idiomas usen formatos de fecha culturalmente apropiados (por ejemplo, "6 de julio de 2049" en español o "6. Juli 2049" en alemán). + ### Separador personalizado | Página | Sección | `config.toml` | Sigue la jerarquía | Requiere JavaScript | @@ -854,6 +1052,68 @@ Esta función está habilitada por defecto. Para deshabilitarla (y permitir todo Para obtener más información, consulta la [página de documentación de CSP](@/blog/security/index.es.md). +--- + +## Indieweb + +### Webmentions + +| Página | Sección | `config.toml` | Sigue la jerarquía | Requiere JavaScript | +|:------:|:-------:|:-------------:|:---------------:|:-------------------:| +| ❓ | ❓ | ✅ | ❓ | ✅ | + +Como se describe en el estándar W3C recomendado, [Webmention](https://www.w3.org/TR/webmention/#abstract-p-1) es una manera sencilla de notificar cualquier URL cuando la mencionas en tu sitio web. Desde la perspectiva del receptor, es una forma de solicitar notificaciones cuando otros sitios web la mencionan. + +Para sitios web estáticos, [webmention.io](https://webmention.io/) aloja un punto final de webmention que se puede utilizar para recibir webmentions. Esta función recupera las webmentions almacenadas en webmention.io y las muestra para una página. Necesitarás configurar una cuenta para tu sitio web en webmention.io. Cuando habilites la función, anunciará tu punto final de webmention.io y mostrará las webmentions para cualquier página. + +Habilita las webmentions para tu sitio web agregando lo siguiente a tu archivo `config.toml`. + +```toml +[extra.webmentions] +enable = true +# Especifica el dominio registrado con webmention.io. +domain = "www.example.com" +``` + +❓: Para desactivar las webmentions para una sección o página específica, establece `webmentions = false` en la sección `[extra]` del front matter de esa sección o página. + +La sección de webmentions se ve así: + +{{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/webmention_light.webp", dark_src="blog/mastering-tabi-settings/img/webmention_dark.webp" alt="Captura de pantalla de webmentions mostrando reposts, me gusta, marcadores y comentarios", full_width=true) }} + +### h-card representativa + +| Página | Sección | `config.toml` | Sigue Jerarquía | Requiere JavaScript | +| :--: | :-----: | :-----------: | :---------------: | :-----------------: | +| ❌ | ❌ | ✅ | ❌ | ❌ | + +Por defecto, tabi añade una [h-card](https://microformats.org/wiki/h-card) representativa **oculta** a la página de inicio. Aunque es invisible para los visitantes, está disponible para los analizadores de microformatos. Puedes comprobar la validez de la tarjeta con la herramienta [Indiewebify.me](https://indiewebify.me/validate-h-card/). + +Para desactivar la h-card, establece `enable = false` en la sección `[extra.hcard]` de `config.toml`. + +La h-card predeterminada incluye tu nombre, la URL del sitio web y los enlaces a redes sociales. + +Puedes establecer una imagen de perfil y una pequeña biografía con los ajustes `avatar` y `biography`. + +Todas las demás [propiedades de h-card](https://microformats.org/wiki/h-card#Properties) se pueden añadir listándolas en la sección `[extra.hcard]` del archivo de configuración. Simplemente reemplaza todos los caracteres `-` por `_`. + +--- + +## Extendiendo elementos HTML en tabi + +Algunos elementos HTML en tabi pueden extenderse para admitir casos de uso adicionales, como agregar JavaScript personalizado para comportamientos en todo el sitio al final de la etiqueta `` o incluir contenido adicional al final del elemento `` que no esté soportado por otras configuraciones de tabi. + +Consulta la tabla a continuación para ver los elementos que pueden extenderse: + +| Elemento | Plantilla | +| :------: | :-------------------------------: | +| `` | `templates/tabi/extend_head.html` | +| `` | `templates/tabi/extend_body.html` | + +No hay configuraciones explícitas que debas establecer para tu sitio o páginas. Simplemente crea el archivo de plantilla correspondiente para tu sitio, y tabi lo incluirá automáticamente. + +--- + [^1]: Si estás utilizando un repositorio Git remoto, es posible que quieras automatizar el proceso de actualización del campo `updated`. Aquí tienes una guía para eso: [Zola Git Hook: actualizando las fechas de las publicaciones](https://osc.garden/es/blog/zola-date-git-hook/). [^2]: Para codificar tu correo electrónico en base64 puedes utilizar [herramientas en línea](https://www.base64encode.org/) o, en tu terminal, ejecutar: `printf 'mail@example.com' | base64` diff --git a/content/blog/mastering-tabi-settings/index.md b/content/blog/mastering-tabi-settings/index.md index 9e084e8..68e399a 100644 --- a/content/blog/mastering-tabi-settings/index.md +++ b/content/blog/mastering-tabi-settings/index.md @@ -1,13 +1,14 @@ +++ title = "Mastering tabi Settings: A Comprehensive Guide" date = 2023-09-18 -updated = 2024-09-17 +updated = 2025-08-07 description = "Discover the many ways you can customise your tabi site." [taxonomies] tags = ["showcase", "tutorial", "FAQ"] [extra] +pinned = true quick_navigation_buttons = true social_media_card = "social_cards/blog_mastering_tabi_settings.jpg" +++ @@ -112,35 +113,63 @@ The description is regular Markdown content, set outside the front matter. #### Listing Recent Posts -If you'd like to show posts on the main page, you first need to decide whether their path will be `/` or something like `/blog`. +To show posts on your main page, you first need to decide where these posts will be served from: the root path (`/`) or a subdirectory (e.g., `/blog`). -If you want to serve the posts from `/`, you need to set `paginate_by = 5` in the front matter of your `_index.md` file. **Note**: this is not in the `[extra]` section, but in the main front matter. Example: +**Option A: Serve posts from the root path (`/`)** -```toml -sort_by = "date" -template = "section.html" -paginate_by = 5 - -[extra] -header = {title = "Hello! I'm tabi~", img = "img/main.webp", img_alt = "Óscar Fernández, the theme's author" } -``` - -If you'd rather serve the posts from `/blog`, you can set `section_path = "/blog"` in the `[extra]` section. This is the setup of this demo: +Set `paginate_by` in the front matter of your `content/_index.md` file: ```toml title = "Latest posts" sort_by = "date" -template = "section.html" +paginate_by = 5 # Show 5 posts per page. [extra] -header = {title = "Hello! I'm tabi~", img = "img/main.webp", img_alt = "Óscar Fernández, the theme's author" } -section_path = "blog/_index.md" -max_posts = 4 +header = {title = "Hello! I'm tabi~", img = "img/main.webp", img_alt = "Your Name" } ``` -Notice how if you set `section_path`, you don't need to set `paginate_by`. You can set `max_posts` to the determine the number of posts you want to show on the main page. +{{ admonition(type="note", text="The `paginate_by` setting goes in the main front matter, not in the `[extra]` section.") }} -The `title` is the header that appears above the posts. +**Option B: Serve posts from a subdirectory (e.g., `/blog`)** + +Use `section_path` in the `[extra]` section of your `content/_index.md` file: + +```toml +title = "Latest posts" +sort_by = "date" +# Do not set `paginate_by` here. + +[extra] +header = {title = "Hello! I'm tabi~", img = "img/main.webp", img_alt = "Your Name" } +section_path = "blog/_index.md" # Where to find your posts. +max_posts = 5 # Show up to 5 posts on the main page. +``` + +{{ admonition(type="warning", text="Do not set both `paginate_by` and `section_path`. These settings are mutually exclusive and using both may result in no posts being displayed.") }} + +Additional notes: + +- The `title` in the front matter sets the header that appears above the posts. +- Use the full path to the section's `_index.md` file for `section_path`. Using `section_path = "blog/"` will not work. + +##### Pinning Posts + +You can pin posts to keep them at the top of the main page listing. In this demo, this post is pinned, so it appears first with a "pinned" icon and label: + +{{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/pinned_post_light.webp", dark_src="blog/mastering-tabi-settings/img/pinned_post_dark.webp", alt="Pinned post", full_width=true) }} + +Pinned posts are shown first, maintaining their relative order of the section's `sort_by`, followed by regular posts. + +To pin a post, add the following to its front matter: + +```toml +[extra] +pinned = true +``` + +{{ admonition(type="info", text="This setting only affects your site's main pages (like `/`, `/es/`, `/fr/`). Other sections like `blog/`, `tags/`, or `archive/` show posts in their normal order.") }} + +{{ admonition(type="warning", text='When using pagination (`paginate_by`), pinned posts may appear twice: once on top of page 1, and again in their normal chronological position on subsequent pages.') }} ##### Display the Date of Posts in Listing @@ -154,6 +183,10 @@ By default, when listing posts, the date of post creation is shown. You can conf post_listing_date = "date" ``` +{% admonition(type="tip") %} +This setting follows the hierarchy: you can set a global value in `config.toml` or override it for specific sections in their `_index.md` file. In both cases, add it to the `[extra]` section. +{% end %} + #### Listing Projects You can showcase a selection of projects on your main page. To do this, you'll need to set up the `projects` directory first. @@ -195,7 +228,7 @@ tabi's skins change the main colour of the site. You can set the skin in `config {{ image_toggler(default_src="blog/customise-tabi/skins/lavender_light.webp", toggled_src="blog/customise-tabi/skins/lavender_dark.webp", default_alt="lavender skin in light mode", toggled_alt="lavender skin in dark mode", full_width=true) }} -Explore the available skins and learn how to create your own reading [the documentation](/blog/customise-tabi/#skins). +Explore the available skins and learn how to create your own reading [the documentation](@/blog/customise-tabi/index.md#skins). ### Sans-serif Font @@ -209,6 +242,25 @@ Click on the image below to compare the two looks: {{ image_toggler(default_src="blog/mastering-tabi-settings/img/serif.webp", toggled_src="blog/mastering-tabi-settings/img/sans-serif.webp", default_alt="Serif font", toggled_alt="Sans-serif font", full_width=true) }} +### External Link Indicator + +| Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript | +|:----:|:-------:|:-------------:|:-----------------:|:-------------------:| +| ❌ | ❌ | ✅ | ❌ | ❌ | + +{{ admonition(type="info", text="Requires Zola 0.20.0 or later.") }} + +If you'd like to add an icon to external links, configure the `[markdown]` (not `[extra]`) section in your `config.toml`: + +```toml +[markdown] +external_links_class = "external" +``` + +This will add a small icon next to external links: + +{{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/external_link_light.webp", dark_src="blog/mastering-tabi-settings/img/external_link_dark.webp", alt="External link icon", full_width=true) }} + ### Custom CSS | Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript | @@ -261,6 +313,34 @@ Setting `tag_sorting = "frequency"` will sort them by number-of-posts (descendin --- +## Series + +For a detailed explanation of the series feature, see the [series documentation](@/blog/series/index.md). + +### Jump to posts link + +| Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript | +|:----:|:-------:|:-------------:|:-----------------:|:-------------------:| +| ❌ | ✅ | ✅ | ✅ | ❌ | + +By default, a "Jump to posts" link automatically appears next to the series title when a series has a content over 2000 characters: + +{{ dual_theme_image(light_src="blog/series/img/jump_to_series_posts_light.webp", dark_src="blog/series/img/jump_to_series_posts_dark.webp" alt="jump to series posts link", full_width=true) }} + +Set `show_jump_to_posts = true` to force the feature on and `show_jump_to_posts = false` to force it off. + +### Series pages indexation + +| Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript | +|:----:|:-------:|:-------------:|:-----------------:|:-------------------:| +| ❌ | ✅ | ✅ | ✅ | ❌ | + +By default, series page are indexed (using a 1-based indexing) as per the series section `sort_by`. + +Set `post_listing_index_reversed = true` to reverse this index. + +--- + ## Git Repository Integration | Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript | @@ -299,7 +379,7 @@ Clicking on this link will take you to the commit history of the post, where you ### Projects -tabi has a built-in projects template. To enable it, you can create a directory in `content/projects/`. There, you can create a `_index.md` file with the following front matter: +tabi has a built-in projects (cards) template. To enable it, you can create a directory in `content/projects/`. There, you can create a `_index.md` file with the following front matter: ```toml title = "Projects" @@ -319,11 +399,11 @@ quick_navigation_buttons = true - `show_reading_time = false` hides the [reading time](#reading-time). - `quick_navigation_buttons = true` shows the [quick navigation buttons](#quick-navigation-buttons) are shown. -Alongside the `_index.md` file, you can create a file for each project. For example, this is the front matter for the [tabi project page](/projects/tabi/): +Alongside the `_index.md` file, you can create a file for each project. For example, this is the front matter for the [tabi project page](@/projects/tabi/index.md): ```toml title = "tabi" -description = "A fast, lightweight, and modern Zola theme with multi-language support." +description = "A feature-rich modern Zola theme with first-class multi-language support." weight = 1 [extra] @@ -339,6 +419,33 @@ When a user clicks on the image or title of a project, they will be taken to the The individual project's page is rendered with the default template, unless you set another one, e.g. `template = "info-page.html"`. +#### Filtering Projects + +If you add tags to your projects, you will see a tag filter: + +{{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/projects_tag_filter_light.webp", dark_src="blog/mastering-tabi-settings/img/projects_tag_filter_dark.webp", alt="Projects page with tag filter", full_width=true) }} + +The tag filtering system uses progressive enhancement: + +- Without JavaScript: Tags link directly to dedicated tag pages (e.g. `/tags/tag-name`) +- With JavaScript: Instant filtering, URL syncing (#tag-name), and keyboard navigation + +To disable this feature, set `enable_cards_tag_filtering = false` in the `[extra]` section of the `projects/_index.md` file or in `config.toml`. + +{% admonition(type="tip") %} + +To filter projects by tags, you need to set tags in the front matter of each project. For example: + +```toml +title = "project name" +weight = 40 + +[taxonomies] +tags = ["tag one", "tag 2", "third tag"] +``` + +{% end %} + ### Archive Adding an archive page is similar to adding a projects page. You can create a directory in `content/archive/`. There, you can create a `_index.md` file with the following front matter: @@ -359,10 +466,14 @@ By default, the archive will list posts located in `blog/`. To customise this, y section_path = ["blog/", "notes/", "path-three/"] ``` -**Notes**: +The archive displays posts in reverse chronological order (newest first). You can reverse this order by setting `archive_reverse = true` in the `[extra]` section: -- the Archive page will only list posts that have a date in their front matter. -- Post sorting is determined by the `sort_by` variable of the sections you are archiving. This demo uses `sort_by = "date"` set in the `blog/_index.md`. +```toml +[extra] +archive_reverse = true # displays oldest posts first. +``` + +{{ admonition(type="note", text="The Archive page will only list posts that have a date in their front matter.") }} ### Tags @@ -411,6 +522,17 @@ path = "about" Notice how the `path` is set to `about`. Zola will place the page at `$base_url/about/`. If you'd like to have the page available at `/contact/`, you'd set `path = "contact"`. +The `info-page.html` template can also be used to create landing pages at the path root (`"/"`). To do that, the `content/_index.md` file should look like this: + +```markdown ++++ +title = "Landing Page Title" +template = "info-page.html" ++++ + +Place your landing page Markdown content here. +``` + --- ## SEO @@ -473,7 +595,21 @@ If both relative and absolute paths are valid, the relative path will take prece Since it follows the [hierarchy](#settings-hierarchy), if it's not set on a page, but is set on a section, the section's image will be used. If it's not set on a page or section, but is set in `config.toml`, the global image will be used. -**Protip**: automate their creation with a [script](https://github.com/welpo/osc.garden/blob/main/static/code/social-cards-zola): [From Bashful to Social Butterfly: Automating Link Previews for Zola Sites](https://osc.garden/blog/automating-social-media-cards-zola/). +{{ admonition(type="tip", title="PROTIP", text="Automate their creation with a [script](https://github.com/welpo/osc.garden/blob/main/static/code/social-cards-zola): [Automating Link Previews for Zola Sites](https://osc.garden/blog/automating-social-media-cards-zola/).") }} + +### Fediverse Creator + +| Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript | +|:----:|:-------:|:-------------:|:-----------------:|:-------------------:| +| ❌ | ❌ | ✅ | ❌ | ❌ | + +You can highlight your fediverse profile in Mastodon link previews by setting the `fediverse_creator` variable in your `config.toml`. For example, for @username@example.com, use: + +```toml +fediverse_creator = { handle = "username", domain = "example.com" } +``` + +This adds metadata to your HTML, allowing Mastodon to display the author's fediverse profile when your content is shared. --- @@ -485,7 +621,9 @@ Since it follows the [hierarchy](#settings-hierarchy), if it's not set on a page |:----:|:-------:|:-------------:|:-----------------:|:-------------------:| | ❌ | ❌ | ✅ | ❌ | ❌ | -The navigation bar is the bar at the top of the page that contains the site title and the navigation menu. You can customise which items appear by setting `menu` in `config.toml`. For example: +The navigation bar is the bar at the top of the page that contains the site title and the navigation menu. You can customise which items appear by setting `menu` in `config.toml`. + +The menu supports both relative URLs for internal pages and absolute URLs for external links. For example: ```toml menu = [ @@ -494,6 +632,7 @@ menu = [ { name = "tags", url = "tags", trailing_slash = true }, { name = "projects", url = "projects", trailing_slash = true }, { name = "about", url = "about", trailing_slash = true }, + { name = "github", url = "https://github.com/welpo/tabi", trailing_slash = false }, ] ``` @@ -569,13 +708,21 @@ Setting `copy_button = true` will add a small copy button to the top right of co {{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/copy_button_on_code_blocks_light.webp", dark_src="blog/mastering-tabi-settings/img/copy_button_on_code_blocks_dark.webp" alt="Copy button on code blocks", full_width=true) }} -### Source/Path on Code Blocks +### Clickable Code Block Names | Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript | |:----:|:-------:|:-------------:|:-----------------:|:-------------------:| | ✅ | ✅ | ✅ | ✅ | ✅ | -Setting `add_src_to_code_block = true` enables the use of the [`add_src_to_code_block` shortcode](@/blog/shortcodes/index.md#show-source-or-path). +Setting `code_block_name_links = true` enables URLs in code block names to become clickable links. Check out the [documentation](@/blog/shortcodes/index.md#show-source-or-path) for examples and usage. + +### Force Code Blocks LTR + +| Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript | +|:----:|:-------:|:-------------:|:-----------------:|:-------------------:| +| ✅ | ✅ | ✅ | ✅ | ❌ | + +By default, code blocks are rendered left-to-right, regardless of the overall text direction. Set `force_codeblock_ltr = false` to allow code blocks to follow the document's text direction. Useful for RTL languages needing RTL code blocks. ### KaTeX Support @@ -603,9 +750,9 @@ See the [Mermaid documentation](@/blog/shortcodes/index.md#mermaid-diagrams) for |:----:|:-------:|:-------------:|:-----------------:|:-------------------:| | ❌ | ❌ | ✅ | ❌ | ❌ | -Custom fonts cause flashing text in Firefox. To amend this, tabi loads a subset of glyphs for the header. Since this (slightly) increases the initial load time, it's a good idea to try and minimise the size of this subset. +Custom fonts cause flashing text in Firefox. To amend this, tabi loads a subset of glyphs for the header. Since this (slightly) increases the initial load time, it's a good idea to try and minimise the size of this subset, or disable it completely if you're not using a custom font in your skin. -You can create a custom subset tailored to your site, save it as `static/custom_subset.css`, and have it load with `custom_subset = true`. +You can create a custom subset tailored to your site, save it as `static/custom_subset.css`, and have it load with `custom_subset = true`. Disabling the subset can be done with `enable_subset = false`. For more information, including instructions on how to create a custom subset, see the [docs](@/blog/custom-font-subset/index.md). @@ -623,7 +770,10 @@ By default, the Atom feed only contains the summary/description of your posts. Y |:----:|:-------:|:-------------:|:-----------------:|:-------------------:| | ✅ | ✅ | ✅ | ✅ | ❌ | -You can hide specific pages or entire sections from your feed by setting `hide_from_feed = true`. +You can control how content appears in your feeds using two settings: + +1. `hide_from_feed = true`: Hides content from all feeds (main, section, and tag feeds) +2. `hide_from_main_feed = true`: Hides content only from the main feed while keeping it visible in section and tag feeds ### Comments {#adding-comments} @@ -639,6 +789,37 @@ If you have enabled a system globally, but want to disable it on a specific page Read [the docs](@/blog/comments/index.md) for more information on the available systems and their setup. +### iine Like Buttons {#iine} + +| Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript | +|:----:|:-------:|:-------------:|:-----------------:|:-------------------:| +| ✅ | ✅ | ✅ | ✅ | ❌ | + +tabi supports [iine](https://iine.to/) like buttons for anonymous appreciation of your content. These privacy-focused buttons work without JavaScript and don't track users. + +To enable iine buttons globally: + +```toml +[extra] +iine = true +``` + +You can customise the icon used for the buttons (follows the hierarchy): + +```toml +[extra] +iine_icon = "thumbs_up" # Options: "heart", "thumbs_up", "upvote", or any emoji +``` + +For multilingual sites, you can unify like counts across language versions of the same content (config-only setting; true by default): + +```toml +[extra] +iine_unified_languages = true # Likes on /es/blog/hello/ count towards /blog/hello/ +``` + +You can also enable iine buttons on individual pages or sections by setting `iine = true` in their front matter, or override the icon with `iine_icon = "🚀"`. + ### Analytics | Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript | @@ -652,7 +833,7 @@ You can set them up in the `[extra.analytics]` section of your `config.toml`. - `service`: Specifies which analytics service to use. Supported options are `"goatcounter"`, `"umami"`, and `"plausible"`. - `id`: The unique identifier for your analytics service. This varies based on the service: - - For GoatCounter, it's the code chosen during signup. Self-hosted instances don't require this field. + - For GoatCounter, it's the code chosen during signup. Self-hosted instances of GoatCounter don't require this field. - For Umami, it's the website ID. - For Plausible, it's the domain name. @@ -661,6 +842,8 @@ You can set them up in the `[extra.analytics]` section of your `config.toml`. - For Umami: `"https://umami.example.com"` - For Plausible: `"https://plausible.example.com"` +- `do_not_track`: (Umami only) Optional. When set to `true`, the generated tracking script will include the `data-do-not-track="true"` attribute, which disables tracking for users whose browsers send a "Do Not Track" header. + An example configuration for non-self-hosted GoatCounter would look like this: ```toml @@ -702,6 +885,8 @@ To use a custom icon, you can add it to your site's `static/social_icons` direct { name = "custom", url = "https://example.com", icon = "custom" } ``` +{{ admonition(type="note", text="All social links include the `rel='me'` [attribute](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel/me). This helps search engines and web services verify that the social media accounts are owned by you.") }} + ### Feed Icon | Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript | @@ -798,12 +983,25 @@ By default, the date is shown below the post title. You can hide it with `show_d |:----:|:-------:|:-------------:|:-----------------:|:-------------------:| | ❌ | ❌ | ✅ | ❌ | ❌ | -tabi has two date formats: `long_date_format` and `short_date_format`. The short format is used in a post's metadata, while the long format is used when listing posts (i.e. on the [blog section](@/blog/_index.md) or the [main page](@/_index.md)). +tabi has three date formats: `long_date_format`, `short_date_format` and `archive_date_format`. The short format is used in a post's metadata, while the long format is used when listing posts (i.e. on the [blog section](@/blog/_index.md) or the [main page](@/_index.md)). The archive format is used to display day and month on the archive page. -The default is "6th July 2049" for both formats in English. For other languages, the defaut is `"%d %B %Y"` for the long format and `"%-d %b %Y"` for the short format. +The default is "6th July 2049" for `long_date_format` and `short_date_format` in English. For other languages, the defaut is `"%d %B %Y"` for the long format and `"%-d %b %Y"` for the short format. The universal default for the archive format is `"%d %b"`. In Zola, time formatting syntax is inspired fom strftime. A full reference is available in the [chrono docs](https://docs.rs/chrono/0.4.31/chrono/format/strftime/index.html). +#### Per-language date formats + +You can customise date formats for specific languages using the `date_formats` array in `config.toml`: + +```toml +date_formats = [ + { lang = "es", long = "%d de %B de %Y", short = "%-d %b %Y", archive = "%d de %b" }, + { lang = "de", long = "%d. %B %Y", short = "%d.%m.%Y", archive = "%d. %b" }, +] +``` + +This allows different languages to use culturally appropriate date formatting (e.g. Spanish "3 de febrero de 2024" vs German "3. Februar 2024"). + ### Custom Separator | Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript | @@ -864,6 +1062,68 @@ This feature is enabled by default. To disable it (and allow all connections), s See the [CSP documentation page](@/blog/security/index.md) for more information. +--- + +## Indieweb + +### Webmentions + +| Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript | +|:----:|:-------:|:-------------:|:-----------------:|:-------------------:| +| ❓ | ❓ | ✅ | ❓ | ✅ | + +As described by the recommended W3C standard [Webmention](https://www.w3.org/TR/webmention/#abstract-p-1) is a simple way to notify any URL when you mention it on your site. From the receiver's perspective, it's a way to request notifications when other sites mention it. + +For static sites [webmention.io](https://webmention.io/) hosts a webmention endpoint that can be used to receive webmentions. This feature fetches the webmentions stored at webmention.io and displays them for a page. You will need to have setup an account for your website at webmention.io. When you enable the webmention feature it will advertise your webmention.io endpoint and display the webmentions for all posts. + +Enable webmentions for your site by adding the following to your `config.toml` file. + +```toml +[extra.webmentions] +enable = true +# Specify the domain registered with webmention.io. +domain = "www.example.com" +``` + +❓: To disable webmentions for a specific section or page, set `webmentions = false` in the `[extra]` section of that section or page's front matter. + +The webmentions section looks like this: + +{{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/webmention_light.webp", dark_src="blog/mastering-tabi-settings/img/webmention_dark.webp" alt="Webmentions screenshot showing reposts, likes, bookmarks, and comments", full_width=true) }} + +### Representative h-card + +| Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript | +| :--: | :-----: | :-----------: | :---------------: | :-----------------: | +| ❌ | ❌ | ✅ | ❌ | ❌ | + +By default, tabi adds a **hidden** representative [h-card](https://microformats.org/wiki/h-card) to the homepage. While invisible to visitors, it's available to microformat parsers. You can check the validity of the card with the [Indiewebify.me](https://indiewebify.me/validate-h-card/) tool. + +To disable the h-card, set `enable = false` in the `[extra.hcard]` section of `config.toml`. + +The default h-card includes your name, website url and social media links. + +You can set a profile picture and a small bio with the `avatar` and `biography` settings. + +All other [h-card properties](https://microformats.org/wiki/h-card#Properties) can be added by listing them under the `[extra.hcard]`section of the config file. Simply replace all `-` characters by `_`. + +--- + +## Extending HTML Elements in tabi + +Some HTML elements in tabi can be extended to support additional use cases such as adding custom JavaScript for site-wide behavior at the end of the `` tag or including additional content at the end of the `` element that is not otherwise supported by other tabi settings. + +See the table below for elements that can be extended: + +| Element | Template | +| :------: | :-------------------------------: | +| `` | `templates/tabi/extend_head.html` | +| `` | `templates/tabi/extend_body.html` | + +There are no explicit settings to configure for your site or pages. Simply create the relevant template file for your site, and tabi will automatically include it. + +--- + [^1]: If you're using a remote Git repository, you might want to automate the process of updating the `updated` field. Here's a guide for that: [Zola Git Pre-Commit Hook: Updating Post Dates](https://osc.garden/blog/zola-date-git-hook/). [^2]: To encode your email in base64 you can use [online tools](https://www.base64encode.org/) or, on your terminal, run: `printf 'mail@example.com' | base64`. diff --git a/content/blog/security/index.ca.md b/content/blog/security/index.ca.md index be1f675..6d3ebfe 100644 --- a/content/blog/security/index.ca.md +++ b/content/blog/security/index.ca.md @@ -1,7 +1,7 @@ +++ title = "Seguretat per defecte" date = 2023-02-22 -updated = 2024-08-28 +updated = 2025-02-21 description = "tabi té una Política de Seguretat de Contingut (CSP) fàcilment personalitzable amb valors segurs per defecte. Obtingues tranquil·litat i un A+ en l'Observatori de Mozilla." [taxonomies] @@ -41,4 +41,6 @@ Pots desactivar les capçaleres (permitint-ho tot) en una pàgina, secció, o gl { directive = "style-src", domains = ["'self'", "'unsafe-inline'"] }, ``` +--- + [^1]: Requereix una configuració adequada del servidor web (p. ex., redirigir el trànsit HTTP a HTTPS). diff --git a/content/blog/security/index.es.md b/content/blog/security/index.es.md index 928e03d..0a6f663 100644 --- a/content/blog/security/index.es.md +++ b/content/blog/security/index.es.md @@ -1,7 +1,7 @@ +++ title = "Seguro por defecto" date = 2023-02-22 -updated = 2024-08-28 +updated = 2025-02-21 description = "tabi tiene una Política de Seguridad de Contenido (CSP) fácilmente personalizable con configuraciones seguras. Obtén tranquilidad y una calificación de A+ en Mozilla Observatory." [taxonomies] @@ -41,4 +41,6 @@ Puedes desactivar las cabeceras (permitiendo todo) en una página, sección, o g { directive = "style-src", domains = ["'self'", "'unsafe-inline'"] }, ``` +--- + [^1]: Requiere una configuración adecuada del servidor web (por ejemplo, redirigir el tráfico HTTP a HTTPS). diff --git a/content/blog/security/index.md b/content/blog/security/index.md index fb46313..7765287 100644 --- a/content/blog/security/index.md +++ b/content/blog/security/index.md @@ -1,7 +1,7 @@ +++ title = "Secure by default" date = 2023-02-22 -updated = 2024-08-28 +updated = 2025-02-21 description = "tabi has an easily customizable Content Security Policy (CSP) with safe defaults. Get peace of mind and an A+ on Mozilla Observatory." [taxonomies] @@ -41,4 +41,6 @@ You can disable the CSP (allowing all connections) on a page, section, or global { directive = "style-src", domains = ["'self'", "'unsafe-inline'"] }, ``` +--- + [^1]: Requires proper webserver configuration (e.g. redirecting HTTP traffic to HTTPS). diff --git a/content/blog/series/img/jump_to_series_posts_dark.webp b/content/blog/series/img/jump_to_series_posts_dark.webp new file mode 100644 index 0000000..d88a292 Binary files /dev/null and b/content/blog/series/img/jump_to_series_posts_dark.webp differ diff --git a/content/blog/series/img/jump_to_series_posts_light.webp b/content/blog/series/img/jump_to_series_posts_light.webp new file mode 100644 index 0000000..22f5e78 Binary files /dev/null and b/content/blog/series/img/jump_to_series_posts_light.webp differ diff --git a/content/blog/series/img/series_dark.webp b/content/blog/series/img/series_dark.webp new file mode 100644 index 0000000..89223d0 Binary files /dev/null and b/content/blog/series/img/series_dark.webp differ diff --git a/content/blog/series/img/series_light.webp b/content/blog/series/img/series_light.webp new file mode 100644 index 0000000..780e2f2 Binary files /dev/null and b/content/blog/series/img/series_light.webp differ diff --git a/content/blog/series/img/series_reversed_dark.webp b/content/blog/series/img/series_reversed_dark.webp new file mode 100644 index 0000000..112a853 Binary files /dev/null and b/content/blog/series/img/series_reversed_dark.webp differ diff --git a/content/blog/series/img/series_reversed_light.webp b/content/blog/series/img/series_reversed_light.webp new file mode 100644 index 0000000..2a1dd0e Binary files /dev/null and b/content/blog/series/img/series_reversed_light.webp differ diff --git a/content/blog/series/index.ca.md b/content/blog/series/index.ca.md new file mode 100644 index 0000000..adb3998 --- /dev/null +++ b/content/blog/series/index.ca.md @@ -0,0 +1,409 @@ ++++ +title = "Guia completa sobre sèries" +date = 2024-11-08 +updated = 2025-02-21 +description = "Aprèn a organitzar les teves publicacions en sèries seqüencials, perfectes per a tutorials, cursos i històries de diverses parts." + +[taxonomies] +tags = ["funcionalitat", "tutorial", "preguntes freqüents", "sèries"] + +[extra] +quick_navigation_buttons = true +toc = true +mermaid = true +social_media_card = "social_cards/ca_blog_series.jpg" ++++ + +Una sèrie organitza publicacions relacionades en ordre seqüencial, similar als capítols d'un llibre. A diferència de les etiquetes, que simplement agrupen contingut relacionat, les sèries suggereixen un ordre específic de lectura de principi a fi. + +Les publicacions dins d'una sèrie no necessiten publicar-se de forma consecutiva; la funció de sèries reuneix publicacions temàticament vinculades en una seqüència coherent. + +El següent diagrama il·lustra com les publicacions de la sèrie (3, 5 i 8) existeixen dins del flux principal del blog mentre mantenen la seva pròpia seqüència ordenada dins de Sèrie 1. + +{% mermaid(full_width=true) %} +flowchart + subgraph main[BLOG] + P1[Post 1] + P2[P2] + P3[P3] + P4[P4] + P5[P5] + P6[P6] + P7[P7] + P8[P8] + P9[P9] + end + subgraph series1[SÈRIE 1] + PS1["Post Sèrie 1 (=P3)"] + PS2["Post Sèrie 2 (=P5)"] + PS3["Post Sèrie 3 (=P8)"] + end + P3 o-.-o PS1 + P5 o-.-o PS2 + P8 o-.-o PS3 +{% end %} + +## Inici ràpid + +1. Crea un directori per a la teva sèrie +2. Crea `_index.md` al directori de la sèrie +3. Configura el front matter de `_index.md`: + + ```toml,name=series/_index.md + title = "Aprenent Rust" + template = "series.html" + sort_by = "slug" + transparent = true + + [extra] + series = true + ``` + +4. Crea els teus articles de la sèrie en aquest directori + +Vols saber-ne més? Continua llegint! + +## Com funcionen les sèries? + +Una sèrie és simplement una secció que tabi gestiona de manera especial. Per a més detalls sobre seccions, consulta la [documentació de Zola](https://www.getzola.org/documentation/content/section/). + +Prenent l'exemple del diagrama anterior, l'estructura de directoris seria així: + +```txt +content/ + _index.md + blog/ + _index.md + post1/ + index.md + post2/ + index.md + post4/ + index.md + post6/ + index.md + post7/ + index.md + post9/ + index.md + serie1/ + _index.md + post3/ + index.md + post5/ + index.md + post8/ + index.md +``` + +Per crear una sèrie, necessites: + +1. Utilitzar la plantilla `series.html` +2. Establir `series = true` a la configuració `[extra]` de la secció +3. Activar `transparent = true` per integrar les publicacions de la sèrie amb la secció del blog principal + +La pàgina principal de la sèrie mostra un resum seguit d'una llista de totes les publicacions a la sèrie: + +{{ dual_theme_image(light_src="blog/series/img/series_light.webp", dark_src="blog/series/img/series_dark.webp" alt="una sèrie", full_width=true) }} + +## Saltar a les publicacions + +Si el contingut d'una sèrie (el Markdown després del frontmatter a `_index.md`) supera els 2000 caràcters, apareix un enllaç "Salta a les publicacions" al costat del títol de la sèrie. + +{{ dual_theme_image(light_src="blog/series/img/jump_to_series_posts_light.webp", dark_src="blog/series/img/jump_to_series_posts_dark.webp" alt="enllaç per saltar a les publicacions de la sèrie", full_width=true) }} + +Per forçar l'activació o desactivació d'aquesta funció, configura `show_jump_to_posts` a la secció `[extra]` de la teva secció de sèries o a `config.toml`. Aquesta configuració segueix [la jerarquia](@/blog/mastering-tabi-settings/index.ca.md#jerarquia-de-configuracio). + +## Pàgines de sèries i ordre + +Totes les pàgines a la secció de sèries seran pàgines de sèrie. Les pàgines s'ordenaran segons el `sort_by` de la secció. + +Tot i que les sèries mantenen el seu propi ordre intern, romanen independents del flux cronològic de la secció principal (per exemple, `blog/`) gràcies a la configuració `transparent`. + +### Opcions d'ordre + +Tria entre aquests mètodes d'ordre, cadascun amb els seus avantatges: + +{% wide_container() %} + +`sort_by` | avantatges | desavantatges +---------|------------|--------------- +`slug` | L'ordre de les pàgines és explícit a la ruta (per exemple, `example.com/blog/series1/01-series-post-un`). | Cada pàgina de la sèrie ha de tenir el prefix corresponent. +`weight` | L'ordre de les pàgines és fàcil de configurar de forma transparent.
La primera publicació té pes `1`, la segona pes `2` i així successivament. | Cada pàgina de la sèrie ha de tenir el seu pes configurat. +`date` | L'ordre de les pàgines es pot configurar una sola vegada a la configuració de la secció. No cal fer res a cada pàgina. | L'ordre de les pàgines s'ha d'invertir perquè la primera pàgina sol ser la més antiga. Això només es pot aconseguir paginant la secció (`paginate_by = 9999`) i invertint el seu ordre (`paginate_reversed = true`). + +{% end %} + +{{ admonition(type="danger", title="Versió de Zola per ordenar per data", text="Per invertir correctament les dates, es requereix Zola v0.19.3+ (no publicada) perquè la informació de paginació estigui disponible a través de la funció `get_section`. En cas contrari, qualsevol cosa que depengui de l'ordre de les pàgines de la sèrie no serà correcta (per exemple, pàgina anterior/següent, llistes ordenades i no ordenades...) Vegeu [Zola PR #2653](https://github.com/getzola/zola/pull/2653).") }} + +### Indexació de pàgines + +Les pàgines en una sèrie s'indexen començant des d'1, seguint el seu ordre `sort_by`. Per invertir la indexació (fent que la primera pàgina tingui l'índex més alt), afegeix aquesta configuració a `_index.md` o `config.toml`: + +```toml +[extra] +post_listing_index_reversed = true # Per defecte és false si no es configura +``` + +{{ dual_theme_image(light_src="blog/series/img/series_reversed_light.webp", dark_src="blog/series/img/series_reversed_dark.webp" alt="una sèrie amb índexs invertits", full_width=true) }} + +Aquesta configuració segueix [la jerarquia](@/blog/mastering-tabi-settings/index.ca.md#jerarquia-de-configuracio). + +## Plantilles d'introducció i conclusió + +Els articles d'una sèrie poden tenir seccions automàtiques d'introducció i conclusió. Aquestes es configuren al `_index.md` de la teva sèrie. Un exemple bàsic: + +```toml,name=series/_index.md +[extra.series_intro_templates] +default = "Aquest article és part de la sèrie $SERIES_HTML_LINK." + +[extra.series_outro_templates] +default = "Gràcies per llegir la part $SERIES_PAGE_INDEX de $SERIES_HTML_LINK!" +``` + +Les seccions d'introducció i conclusió tenen les seves pròpies classes CSS (`series-page-intro` i `series-page-outro`), que et permeten personalitzar la seva aparença mitjançant [CSS personalitzat](@/blog/mastering-tabi-settings/index.ca.md#estils-css-personalitzats). + +### Tipus de plantilles + +El sistema de sèries utilitza diferents plantilles segons la posició de l'article a la sèrie: + +- `next_only` - Utilitzat per al primer article (té article següent però no anterior) +- `middle` - Utilitzat per a articles amb articles anterior i següent +- `prev_only` - Utilitzat per a l'últim article (té article anterior però no següent) +- `default` - Plantilla per defecte utilitzada quan no existeix una plantilla específica per a la posició + +El sistema determina automàticament quina plantilla utilitzar segons la posició de l'article. Les plantilles es defineixen a la configuració de la sèrie (`_index.md`), com `extra.series_intro_templates` i `extra.series_outro_templates`: + +```toml,name=series/_index.md +[extra.series_intro_templates] +next_only = "Benvingut a la part 1! Següent: $NEXT_HTML_LINK" +middle = "Anterior: $PREV_HTML_LINK | Següent: $NEXT_HTML_LINK" +prev_only = "El capítol final! Anteriorment: $PREV_HTML_LINK" +default = "Part $SERIES_PAGE_INDEX de $SERIES_PAGES_NUMBER" +``` + +Totes les plantilles són opcionals. La selecció de plantilles segueix un sistema de prioritat: + +1. Si existeix una plantilla específica per a la posició (`next_only`, `middle`, o `prev_only`), s'utilitzarà aquesta +2. Si no, s'utilitza la plantilla `default` +3. Si no es defineix cap plantilla, no es mostrarà informació de la sèrie + +Mira l'[exemple de plantilla](#exemple-de-plantilla) per veure un exemple més elaborat. + +### Ubicació al contingut + +Per defecte: + +- Les introduccions de sèrie apareixen a l'inici del teu article +- La conclusió apareix al final (abans de les notes al peu, si n'hi ha) + +Pots controlar exactament on apareixen utilitzant `` i `` al teu Markdown: + +```markdown +Aquest paràgraf apareix abans de la introducció de la sèrie. + + + +Contingut principal de l'article. + + + +## Recursos d'aprenentatge + +Contingut addicional... + +[^1]: Les notes al peu sempre apareixeran al final. +``` + +## Variables + +Les plantilles de sèries utilitzen un sistema flexible de variables que et permet: + +1. Fer referència a informació de la sèrie (títol, enllaços) +2. Afegir navegació entre articles +3. Mostrar indicadors de progrés +4. Incloure informació personalitzada utilitzant les teves pròpies variables + +Les variables són marcadors que comencen amb `$` i es reemplacen amb contingut real quan es construeix el teu lloc. Per exemple, `$SERIES_HTML_LINK` es converteix en un enllaç clicable a la pàgina índex de la teva sèrie. + +Hi ha tres tipus de variables: + +- [Variables bàsiques de sèrie](#variables-basiques-de-serie): Informació general sobre la sèrie +- [Variables de navegació](#variables-de-navegacio): Enllaços a articles anterior/següent +- [Variables personalitzades](#variables-personalitzades): Els teus propis marcadors per a informació addicional + +### Variables bàsiques de sèrie + +{% wide_container() %} + +| Variable | Disponibilitat | Retorna | Descripció | Exemple d'ús | Exemple de sortida | +|----------|---------------|----------|------------|--------------|-------------------| +| `$SERIES_TITLE` | Sempre | Text | Títol de la sèrie en text pla | `Part de $SERIES_TITLE` | Part d'Aprenent Rust | +| `$SERIES_PERMALINK` | Sempre | Text | URL a l'índex de la sèrie | `[Veure totes les publicacions]($SERIES_PERMALINK)` | [Veure totes les publicacions](/series/learn-rust) | +| `$SERIES_HTML_LINK` | Sempre | HTML | Enllaç llest per usar a la sèrie | `Benvingut a $SERIES_HTML_LINK!` | Benvingut a Aprenent Rust! | +| `$SERIES_PAGES_NUMBER` | Sempre | Nombre | Total d'articles a la sèrie | `Una sèrie de $SERIES_PAGES_NUMBER parts` | Una sèrie de 5 parts | +| `$SERIES_PAGE_INDEX` | Sempre | Nombre | Posició de l'article actual | `Part $SERIES_PAGE_INDEX de $SERIES_PAGES_NUMBER` | Part 3 de 5 | +| `$SERIES_PAGES_OLIST` | Sempre | HTML | Llista ordenada de tots els articles | `Articles a la sèrie: $SERIES_PAGES_OLIST` | Articles a la sèrie:
  1. Article actual
  2. Altres articles
| +| `$SERIES_PAGES_ULIST` | Sempre | HTML | Llista desordenada de tots els articles | `Articles a la sèrie: $SERIES_PAGES_ULIST` | Articles a la sèrie: | + +{% end %} + +{{ admonition(type="tip", title="CONSELL: Text personalitzat amb permalinks", text='Els enllaços markdown com `[text]($SERIES_PERMALINK)` seran marcats (i [estilitzats](@/blog/mastering-tabi-settings/index.ca.md#indicador-d-enllacos-externs)) com externs. Si necessites text personalitzat i vols evitar l\'estil extern, utilitza HTML: `el teu text`.') }} + +### Variables de navegació + +{% wide_container() %} + +| Variable | Disponibilitat | Retorna | Descripció | Exemple d'ús | Exemple de sortida | +|----------|---------------|----------|------------|--------------|-------------------| +| `$PREV_TITLE` | Existeix anterior | Text | Títol de l'article anterior | `Anteriorment: $PREV_TITLE` | Anteriorment: Configurant el teu entorn | +| `$PREV_PERMALINK` | Existeix anterior | Text | URL a l'article anterior | `[← Enrere]($PREV_PERMALINK)` | [← Enrere](/series/learn-rust/setup) | +| `$PREV_HTML_LINK` | Existeix anterior | HTML | Enllaç llest per usar a l'anterior | `Llegeix primer $PREV_HTML_LINK` | Llegeix primer Configurant el teu entorn | +| `$PREV_DESCRIPTION` | Existeix anterior | Text | Descripció de l'article anterior | `Resum: $PREV_DESCRIPTION` | Resum: Configurant Rust | +| `$NEXT_TITLE` | Existeix següent | Text | Títol del següent article | `Següent: $NEXT_TITLE` | Següent: Patrons avançats | +| `$NEXT_PERMALINK` | Existeix següent | Text | URL al següent article | `[Continuar →]($NEXT_PERMALINK)` | [Continuar →](/series/learn-rust/patterns) | +| `$NEXT_HTML_LINK` | Existeix següent | HTML | Enllaç llest per usar al següent | `Continua amb $NEXT_HTML_LINK` | Continua amb Patrons avançats | +| `$NEXT_DESCRIPTION` | Existeix següent | Text | Descripció del següent article | `Properament: $NEXT_DESCRIPTION` | Properament: Aprèn sobre les característiques avançades de pattern matching en Rust | + +{% end %} + +### Referència al primer article + +{% wide_container() %} + +| Variable | Disponibilitat | Retorna | Descripció | Exemple d'ús | Exemple de sortida | +|----------|---------------|----------|------------|--------------|-------------------| +| `$FIRST_TITLE` | Sempre | Text | Títol del primer article | `Comença amb $FIRST_TITLE` | Comença amb Introducció a Rust | +| `$FIRST_HTML_LINK` | Sempre | HTML | Enllaç llest per usar al primer article | `Comença a $FIRST_HTML_LINK` | Comença a Introducció a Rust | + +{% end %} + +### Exemple de plantilla + +{{ admonition(type="tip", title="Variables HTML vs text", text="Utilitza variables HTML (que acaben en `_HTML_LINK`) quan vulguis enllaços preparats per usar. Utilitza variables de text (que acaben en `_TITLE` o `_PERMALINK`) quan vulguis més control sobre el format.") }} + +```toml,name=series/_index.md +# Introducció +[extra.series_intro_templates] +next_only = """ +Benvingut a $SERIES_HTML_LINK! Aquesta sèrie de $SERIES_PAGES_NUMBER parts t'ensenyarà Rust des de zero. + +Següent: $NEXT_HTML_LINK - $NEXT_DESCRIPTION +""" + +middle = """ +📚 Part $SERIES_PAGE_INDEX de $SERIES_PAGES_NUMBER a $SERIES_HTML_LINK + +Anterior: $PREV_HTML_LINK +Següent: $NEXT_HTML_LINK +""" + +prev_only = """ +Benvingut a l'última part de $SERIES_HTML_LINK! +Ets nou? Comença amb $FIRST_HTML_LINK per construir una base sòlida. + +Anterior: $PREV_HTML_LINK +""" + +# Plantilla de respatller +default = "Aquest article és part de la sèrie $SERIES_HTML_LINK." + +# Conclusió +[extra.series_outro_templates] +next_only = """ +Gràcies per llegir! 🙌 + +Continua el teu viatge amb $NEXT_HTML_LINK, on $NEXT_DESCRIPTION +O revisa l'esquema complet de la sèrie [$SERIES_TITLE]($SERIES_PERMALINK). +""" + +middle = """ +--- +📝 Navegació de la sèrie + +- Anterior: $PREV_HTML_LINK +- Següent: $NEXT_HTML_LINK +- [Resum de la sèrie]($SERIES_PERMALINK) +""" + +prev_only = """ +🎉 Felicitats! Has completat $SERIES_HTML_LINK. + +Vols repassar? Aquí vam començar: $FIRST_HTML_LINK +O revisa el que acabem de veure a $PREV_HTML_LINK. +""" + +# Respatller. +default = """ +--- +Aquest article és la part $SERIES_PAGE_INDEX de $SERIES_PAGES_NUMBER a $SERIES_HTML_LINK. +""" +``` + +### Variables personalitzades + +Les plantilles de sèries admeten variables personalitzades per incloure informació addicional a tota la teva sèrie. El procés té dos passos: + +1. Primer, defineix els teus **marcadors** a la configuració de la teva sèrie (`_index.md`): + +```toml,name=series/_index.md +[extra] +series = true +series_template_placeholders = ["$POSITION", "$TOPIC", "$DIFFICULTY"] +``` + +2. Després, a cada article de la sèrie, proporciona els valors per a aquests marcadors a `series_template_variables`: + +```toml,name=series/article.md +[extra.series_template_variables] +position = "primer" +topic = "Variables i tipus" +difficulty = "Principiant" +``` + +### Ús de variables personalitzades + +Pots usar les teves variables personalitzades a qualsevol plantilla, juntament amb les variables integrades: + +```toml,name=series/_index.md +[extra.series_intro_templates] +default = """ +Aquest és l'article $POSITION a $SERIES_HTML_LINK. +Tema d'avui: $TOPIC +Nivell de dificultat: $DIFFICULTY +""" +``` + +{{ admonition(type="warning", text="Encara que els marcadors es defineixen en majúscules (`$POSITION`), els noms de variables a `series_template_variables` han d'estar en minúscules (`position`).") }} + +### Exemple amb variables personalitzades + +```toml,name=series/_index.md +# A la configuració de la sèrie. +[extra] +series = true +series_template_placeholders = ["$LEARNING_TIME", "$KEY_CONCEPTS"] + +series_intro_templates.default = """ +📚 Part $SERIES_PAGE_INDEX de $SERIES_PAGES_NUMBER +⏱️ Temps estimat: $LEARNING_TIME +🔑 Conceptes clau: $KEY_CONCEPTS +""" +``` + +```toml,name=series/02-learning-rust/index.md +# En un article de la sèrie. +[extra.series_template_variables] +learning_time = "30 minuts" +key_concepts = "Funcions, gestió d'errors, coincidència de patrons" +``` + +Això generarà: + +```txt +📚 Part 2 de 5 +⏱️ Temps estimat: 30 minuts +🔑 Conceptes clau: Funcions, gestió d'errors, coincidència de patrons +``` + +{{ admonition(type="warning", title="Variables que falten", text="Si uses un marcador a les teves plantilles però no proporciones el seu valor a `series_template_variables`, la compilació fallarà amb un error que llista les variables que falten.") }} diff --git a/content/blog/series/index.es.md b/content/blog/series/index.es.md new file mode 100644 index 0000000..9c6d673 --- /dev/null +++ b/content/blog/series/index.es.md @@ -0,0 +1,409 @@ ++++ +title = "Guía completa sobre series" +date = 2024-11-08 +updated = 2025-02-21 +description = "Aprende a organizar tus publicaciones en series secuenciales, perfectas para tutoriales, cursos e historias de varias partes." + +[taxonomies] +tags = ["funcionalidad", "tutorial", "preguntas frecuentes", "series"] + +[extra] +quick_navigation_buttons = true +toc = true +mermaid = true +social_media_card = "social_cards/es_blog_series.jpg" ++++ + +Una serie organiza publicaciones relacionadas en orden secuencial, similar a los capítulos de un libro. A diferencia de las etiquetas, que simplemente agrupan contenido relacionado, las series sugieren un orden específico de lectura de principio a fin. + +Las publicaciones dentro de una serie no necesitan publicarse de forma consecutiva; la función de series reúne publicaciones temáticamente vinculadas en una secuencia coherente. + +El siguiente diagrama ilustra cómo las publicaciones de la serie (3, 5 y 8) existen dentro del flujo principal del blog mientras mantienen su propia secuencia ordenada dentro de Serie 1. + +{% mermaid(full_width=true) %} +flowchart + subgraph main[BLOG] + P1[Post 1] + P2[P2] + P3[P3] + P4[P4] + P5[P5] + P6[P6] + P7[P7] + P8[P8] + P9[P9] + end + subgraph series1[SERIE 1] + PS1["Post Serie 1 (=P3)"] + PS2["Post Serie 2 (=P5)"] + PS3["Post Serie 3 (=P8)"] + end + P3 o-.-o PS1 + P5 o-.-o PS2 + P8 o-.-o PS3 +{% end %} + +## Inicio rápido + +1. Crea un directorio para tu serie +2. Crea `_index.md` en el directorio de la serie +3. Configura el front matter de `_index.md`: + + ```toml,name=series/_index.md + title = "Aprendiendo Rust" + template = "series.html" + sort_by = "slug" + transparent = true + + [extra] + series = true + ``` + +4. Crea tus artículos de la serie en este directorio + +¿Quieres saber más? ¡Sigue leyendo! + +## ¿Cómo funcionan las series? + +Una serie es simplemente una sección que tabi maneja de manera especial. Para más detalles sobre secciones, consulta la [documentación de Zola](https://www.getzola.org/documentation/content/section/). + +Tomando el ejemplo del diagrama anterior, la estructura de directorios sería así: + +```txt +content/ + _index.md + blog/ + _index.md + post1/ + index.md + post2/ + index.md + post4/ + index.md + post6/ + index.md + post7/ + index.md + post9/ + index.md + serie1/ + _index.md + post3/ + index.md + post5/ + index.md + post8/ + index.md +``` + +Para crear una serie, necesitas: + +1. Usar la plantilla `series.html` +2. Establecer `series = true` en la configuración `[extra]` de la sección +3. Activar `transparent = true` para integrar las publicaciones de la serie con la sección del blog principal + +La página principal de la serie muestra un resumen seguido de una lista de todas las publicaciones en la serie: + +{{ dual_theme_image(light_src="blog/series/img/series_light.webp", dark_src="blog/series/img/series_dark.webp" alt="una serie", full_width=true) }} + +## Saltar a las publicaciones + +Si el contenido de una serie (el Markdown después del frontmatter en `_index.md`) supera los 2000 caracteres, aparece un enlace "Saltar a publicaciones" junto al título de la serie. + +{{ dual_theme_image(light_src="blog/series/img/jump_to_series_posts_light.webp", dark_src="blog/series/img/jump_to_series_posts_dark.webp" alt="enlace para saltar a las publicaciones de la serie", full_width=true) }} + +Para forzar la activación o desactivación de esta función, configura `show_jump_to_posts` en la sección `[extra]` de tu sección de series o en `config.toml`. Esta configuración sigue [la jerarquía](@/blog/mastering-tabi-settings/index.es.md#jerarquia-de-configuracion). + +## Páginas de series y orden + +Todas las páginas en la sección de series serán páginas de serie. Las páginas se ordenarán según el `sort_by` de la sección. + +Aunque las series mantienen su propio orden interno, permanecen independientes del flujo cronológico de la sección principal (por ejemplo, `blog/`) gracias a la configuración `transparent`. + +### Opciones de orden + +Elige entre estos métodos de orden, cada uno con sus ventajas: + +{% wide_container() %} + +`sort_by` | ventajas | desventajas +---------|-------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- +`slug` | El orden de las páginas es explícito en la ruta (por ejemplo, `example.com/blog/series1/01-series-post-uno`). | Cada página de la serie debe tener el prefijo correspondiente. +`weight` | El orden de las páginas es fácil de configurar de forma transparente.
La primera publicación tiene peso `1`, la segunda peso `2` y así sucesivamente. | Cada página de la serie debe tener su peso configurado. +`date` | El orden de las páginas se puede configurar una sola vez en la configuración de la sección. No hay que hacer nada en cada página. | El orden de las páginas debe invertirse porque la primera página suele ser la más antigua. Esto solo se puede lograr paginando la sección (`paginate_by = 9999`) e invirtiendo su orden (`paginate_reversed = true`). + +{% end %} + +{{ admonition(type="danger", title="Versión de Zola para ordenar por fecha", text="Para invertir correctamente las fechas, se requiere Zola v0.19.3+ (no publicada) para que la información de paginación esté disponible a través de la función `get_section`. De lo contrario, cualquier cosa que dependa del orden de las páginas de la serie no será correcta (por ejemplo, página anterior/siguiente, listas ordenadas y no ordenadas...) Ver [Zola PR #2653](https://github.com/getzola/zola/pull/2653).") }} + +### Indexación de páginas + +Las páginas en una serie se indexan empezando desde 1, siguiendo su orden `sort_by`. Para invertir la indexación (haciendo que la primera página tenga el índice más alto), añade esta configuración a `_index.md` o `config.toml`: + +```toml +[extra] +post_listing_index_reversed = true # Por defecto es false si no se configura +``` + +{{ dual_theme_image(light_src="blog/series/img/series_reversed_light.webp", dark_src="blog/series/img/series_reversed_dark.webp" alt="una serie con índices invertidos", full_width=true) }} + +Esta configuración sigue [la jerarquía](@/blog/mastering-tabi-settings/index.es.md#jerarquia-de-configuracion). + +## Plantillas de introducción y conclusión + +Los artículos de una serie pueden tener secciones automáticas de introducción y conclusión. Estas se configuran en el `_index.md` de tu serie. Un ejemplo básico: + +```toml,name=series/_index.md +[extra.series_intro_templates] +default = "Este artículo es parte de la serie $SERIES_HTML_LINK." + +[extra.series_outro_templates] +default = "¡Gracias por leer la parte $SERIES_PAGE_INDEX de $SERIES_HTML_LINK!" +``` + +Las secciones de introducción y conclusión tienen sus propias clases CSS (`series-page-intro` y `series-page-outro`), lo que te permite personalizar su apariencia mediante [CSS personalizado](@/blog/mastering-tabi-settings/index.es.md#estilos-css-personalizados). + +### Tipos de plantillas + +El sistema de series usa diferentes plantillas según la posición del artículo en la serie: + +- `next_only` - Usado para el primer artículo (tiene artículo siguiente pero no anterior) +- `middle` - Usado para artículos con artículos anterior y siguiente +- `prev_only` - Usado para el último artículo (tiene artículo anterior pero no siguiente) +- `default` - Plantilla por defecto usada cuando no existe una plantilla específica para la posición + +El sistema determina automáticamente qué plantilla usar según la posición del artículo. Las plantillas se definen en la configuración de la serie (`_index.md`), como `extra.series_intro_templates` y `extra.series_outro_templates`: + +```toml,name=series/_index.md +[extra.series_intro_templates] +next_only = "¡Bienvenido a la parte 1! Siguiente: $NEXT_HTML_LINK" +middle = "Anterior: $PREV_HTML_LINK | Siguiente: $NEXT_HTML_LINK" +prev_only = "¡El capítulo final! Anteriormente: $PREV_HTML_LINK" +default = "Parte $SERIES_PAGE_INDEX de $SERIES_PAGES_NUMBER" +``` + +Todas las plantillas son opcionales. La selección de plantillas sigue un sistema de prioridad: + +1. Si existe una plantilla específica para la posición (`next_only`, `middle`, o `prev_only`), se usará esa +2. Si no, se usa la plantilla `default` +3. Si no se define ninguna plantilla, no se mostrará información de la serie + +Mira el [ejemplo de plantilla](#ejemplo-de-plantilla) para ver un ejemplo más elaborado. + +### Ubicación en el contenido + +Por defecto: + +- Las introducciones de serie aparecen al inicio de tu artículo +- La conclusión aparece al final (antes de las notas al pie, si las hay) + +Puedes controlar exactamente dónde aparecen usando `` y `` en tu Markdown: + +```markdown +Este párrafo aparece antes de la introducción de la serie. + + + +Contenido principal del artículo. + + + +## Recursos de aprendizaje + +Contenido adicional... + +[^1]: Las notas al pie siempre aparecerán al final. +``` + +## Variables + +Las plantillas de series usan un sistema flexible de variables que te permite: + +1. Hacer referencia a información de la serie (título, enlaces) +2. Añadir navegación entre artículos +3. Mostrar indicadores de progreso +4. Incluir información personalizada usando tus propias variables + +Las variables son marcadores que comienzan con `$` y se reemplazan con contenido real cuando se construye tu sitio. Por ejemplo, `$SERIES_HTML_LINK` se convierte en un enlace clicable a la página índice de tu serie. + +Hay tres tipos de variables: + +- [Variables básicas de serie](#variables-basicas-de-serie): Información general sobre la serie +- [Variables de navegación](#variables-de-navegacion): Enlaces a artículos anterior/siguiente +- [Variables personalizadas](#variables-personalizadas): Tus propios marcadores para información adicional + +### Variables básicas de serie + +{% wide_container() %} + +| Variable | Disponibilidad | Devuelve | Descripción | Ejemplo de uso | Ejemplo de salida | +|----------|---------------|-----------|-------------|----------------|-------------------| +| `$SERIES_TITLE` | Siempre | Texto | Título de la serie en texto plano | `Parte de $SERIES_TITLE` | Parte de Aprendiendo Rust | +| `$SERIES_PERMALINK` | Siempre | Texto | URL al índice de la serie | `[Ver todas las publicaciones]($SERIES_PERMALINK)` | [Ver todas las publicaciones](/series/learn-rust) | +| `$SERIES_HTML_LINK` | Siempre | HTML | Enlace listo para usar a la serie | `¡Bienvenido a $SERIES_HTML_LINK!` | ¡Bienvenido a Aprendiendo Rust! | +| `$SERIES_PAGES_NUMBER` | Siempre | Número | Total de artículos en la serie | `Una serie de $SERIES_PAGES_NUMBER partes` | Una serie de 5 partes | +| `$SERIES_PAGE_INDEX` | Siempre | Número | Posición del artículo actual | `Parte $SERIES_PAGE_INDEX de $SERIES_PAGES_NUMBER` | Parte 3 de 5 | +| `$SERIES_PAGES_OLIST` | Siempre | HTML | Lista ordenada de todos los artículos | `Artículos en la serie: $SERIES_PAGES_OLIST` | Artículos en la serie:
  1. Artículo actual
  2. Otros artículos
| +| `$SERIES_PAGES_ULIST` | Siempre | HTML | Lista desordenada de todos los artículos | `Artículos en la serie: $SERIES_PAGES_ULIST` | Artículos en la serie: | + +{% end %} + +{{ admonition(type="tip", title="CONSEJO: Texto personalizado con permalinks", text='Los enlaces markdown como `[texto]($SERIES_PERMALINK)` serán marcados (y [estilizados](@/blog/mastering-tabi-settings/index.es.md#indicador-enlaces-externos)) como externos. Si necesitas texto personalizado y quieres evitar el estilo externo, usa HTML: `tu texto`.') }} + +### Variables de navegación + +{% wide_container() %} + +| Variable | Disponibilidad | Devuelve | Descripción | Ejemplo de uso | Ejemplo de salida | +|----------|---------------|-----------|-------------|----------------|-------------------| +| `$PREV_TITLE` | Existe anterior | Texto | Título del artículo anterior | `Anteriormente: $PREV_TITLE` | Anteriormente: Configurando tu entorno | +| `$PREV_PERMALINK` | Existe anterior | Texto | URL al artículo anterior | `[← Atrás]($PREV_PERMALINK)` | [← Atrás](/series/learn-rust/setup) | +| `$PREV_HTML_LINK` | Existe anterior | HTML | Enlace listo para usar al anterior | `Lee primero $PREV_HTML_LINK` | Lee primero Configurando tu entorno | +| `$PREV_DESCRIPTION` | Existe anterior | Texto | Descripción del artículo anterior | `Resumen: $PREV_DESCRIPTION` | Resumen: Configurando Rust | +| `$NEXT_TITLE` | Existe siguiente | Texto | Título del siguiente artículo | `Siguiente: $NEXT_TITLE` | Siguiente: Patrones avanzados | +| `$NEXT_PERMALINK` | Existe siguiente | Texto | URL al siguiente artículo | `[Continuar →]($NEXT_PERMALINK)` | [Continuar →](/series/learn-rust/patterns) | +| `$NEXT_HTML_LINK` | Existe siguiente | HTML | Enlace listo para usar al siguiente | `Continúa con $NEXT_HTML_LINK` | Continúa con Patrones avanzados | +| `$NEXT_DESCRIPTION` | Existe siguiente | Texto | Descripción del siguiente artículo | `Próximamente: $NEXT_DESCRIPTION` | Próximamente: Aprende sobre las características avanzadas de pattern matching en Rust | + +{% end %} + +### Referencia al primer artículo + +{% wide_container() %} + +| Variable | Disponibilidad | Devuelve | Descripción | Ejemplo de uso | Ejemplo de salida | +|----------|---------------|-----------|-------------|----------------|-------------------| +| `$FIRST_TITLE` | Siempre | Texto | Título del primer artículo | `Comienza con $FIRST_TITLE` | Comienza con Introducción a Rust | +| `$FIRST_HTML_LINK` | Siempre | HTML | Enlace listo para usar al primer artículo | `Empieza en $FIRST_HTML_LINK` | Empieza en Introducción a Rust | + +{% end %} + +### Ejemplo de plantilla + +{{ admonition(type="tip", title="Variables HTML vs texto", text="Usa variables HTML (que terminan en `_HTML_LINK`) cuando quieras enlaces listos para usar. Usa variables de texto (que terminan en `_TITLE` o `_PERMALINK`) cuando quieras más control sobre el formato.") }} + +```toml,name=series/_index.md +# Introducción. +[extra.series_intro_templates] +next_only = """ +¡Bienvenido a $SERIES_HTML_LINK! Esta serie de $SERIES_PAGES_NUMBER partes te enseñará Rust desde cero. + +Siguiente: $NEXT_HTML_LINK - $NEXT_DESCRIPTION +""" + +middle = """ +📚 Parte $SERIES_PAGE_INDEX de $SERIES_PAGES_NUMBER en $SERIES_HTML_LINK + +Anterior: $PREV_HTML_LINK +Siguiente: $NEXT_HTML_LINK +""" + +prev_only = """ +¡Bienvenido a la última parte de $SERIES_HTML_LINK! +¿Eres nuevo? Comienza con $FIRST_HTML_LINK para construir una base sólida. + +Anterior: $PREV_HTML_LINK +""" + +# Plantilla de respaldo. +default = "Este artículo es parte de la serie $SERIES_HTML_LINK." + +# Conclusión. +[extra.series_outro_templates] +next_only = """ +¡Gracias por leer! 🙌 + +Continúa tu viaje con $NEXT_HTML_LINK, donde $NEXT_DESCRIPTION +O revisa el esquema completo de la serie [$SERIES_TITLE]($SERIES_PERMALINK). +""" + +middle = """ +--- +📝 Navegación de la serie + +- Anterior: $PREV_HTML_LINK +- Siguiente: $NEXT_HTML_LINK +- [Resumen de la serie]($SERIES_PERMALINK) +""" + +prev_only = """ +🎉 ¡Felicidades! Has completado $SERIES_HTML_LINK. + +¿Quieres repasar? Aquí comenzamos: $FIRST_HTML_LINK +O revisa lo que acabamos de ver en $PREV_HTML_LINK. +""" + +# Respaldo. +default = """ +--- +Este artículo es la parte $SERIES_PAGE_INDEX de $SERIES_PAGES_NUMBER en $SERIES_HTML_LINK. +""" +``` + +### Variables personalizadas + +Las plantillas de series admiten variables personalizadas para incluir información adicional en toda tu serie. El proceso tiene dos pasos: + +1. Primero, define tus **marcadores** en la configuración de tu serie (`_index.md`): + +```toml,name=series/_index.md +[extra] +series = true +series_template_placeholders = ["$POSITION", "$TOPIC", "$DIFFICULTY"] +``` + +2. Luego, en cada artículo de la serie, proporciona los valores para estos marcadores en `series_template_variables`: + +```toml,name=series/article.md +[extra.series_template_variables] +position = "primero" +topic = "Variables y tipos" +difficulty = "Principiante" +``` + +### Uso de variables personalizadas + +Puedes usar tus variables personalizadas en cualquier plantilla, junto con las variables integradas: + +```toml,name=series/_index.md +[extra.series_intro_templates] +default = """ +Este es el artículo $POSITION en $SERIES_HTML_LINK. +Tema de hoy: $TOPIC +Nivel de dificultad: $DIFFICULTY +""" +``` + +{{ admonition(type="warning", text="Aunque los marcadores se definen en mayúsculas (`$POSITION`), los nombres de variables en `series_template_variables` deben estar en minúsculas (`position`).") }} + +### Ejemplo con variables personalizadas + +```toml,name=series/_index.md +# En la configuración de la serie. +[extra] +series = true +series_template_placeholders = ["$LEARNING_TIME", "$KEY_CONCEPTS"] + +series_intro_templates.default = """ +📚 Parte $SERIES_PAGE_INDEX de $SERIES_PAGES_NUMBER +⏱️ Tiempo estimado: $LEARNING_TIME +🔑 Conceptos clave: $KEY_CONCEPTS +""" +``` + +```toml,name=series/02-learning-rust/index.md +# En un artículo de la serie. +[extra.series_template_variables] +learning_time = "30 minutos" +key_concepts = "Funciones, manejo de errores, coincidencia de patrones" +``` + +Esto generará: + +```txt +📚 Parte 2 de 5 +⏱️ Tiempo estimado: 30 minutos +🔑 Conceptos clave: Funciones, manejo de errores, coincidencia de patrones +``` + +{{ admonition(type="warning", title="Variables faltantes", text="Si usas un marcador en tus plantillas pero no proporcionas su valor en `series_template_variables`, la compilación fallará con un error que lista las variables faltantes.") }} diff --git a/content/blog/series/index.md b/content/blog/series/index.md new file mode 100644 index 0000000..b17ce42 --- /dev/null +++ b/content/blog/series/index.md @@ -0,0 +1,409 @@ ++++ +title = "A Complete Guide to Series" +date = 2024-11-08 +updated = 2025-02-21 +description = "Learn how to organize your posts into sequential series, perfect for tutorials, courses, and multi-part stories." + +[taxonomies] +tags = ["showcase", "tutorial", "FAQ", "series"] + +[extra] +quick_navigation_buttons = true +toc = true +mermaid = true +social_media_card = "social_cards/es_blog_series.jpg" ++++ + +A series organizes related posts in a sequential order, similar to chapters in a book. Unlike tags, which simply group related content, series suggest a specific reading order from start to finish. + +Posts within a series do not need to be published consecutively; the series feature brings together thematically linked posts in a coherent sequence. + +The diagram below illustrates how series posts (3, 5, and 8) exist within the main blog flow while maintaining their own ordered sequence within Series 1. + +{% mermaid(full_width=true) %} +flowchart + subgraph main[BLOG] + P1[Post 1] + P2[P2] + P3[P3] + P4[P4] + P5[P5] + P6[P6] + P7[P7] + P8[P8] + P9[P9] + end + subgraph series1[SERIES 1] + PS1["Series Post 1 (=P3)"] + PS2["Series Post 2 (=P5)"] + PS3["Series Post 3 (=P8)"] + end + P3 o-.-o PS1 + P5 o-.-o PS2 + P8 o-.-o PS3 +{% end %} + +## Quick Start + +1. Create a directory for your series. +2. Create `_index.md` in the series directory. +3. Set up the `_index.md` front matter: + + ```toml,name=series/_index.md + title = "Learning Rust" + template = "series.html" + sort_by = "slug" + transparent = true + + [extra] + series = true + ``` + +4. Create your series articles in this directory. + +Want more? Keep reading! + +## How Do Series Work? + +A series is just a section which is handled in a special way by tabi. For more details on sections, see the [Zola documentation](https://www.getzola.org/documentation/content/section/). + +Taking the example from the diagram above, the directory structure would be as follow: + +```txt +content/ + _index.md + blog/ + _index.md + post1/ + index.md + post2/ + index.md + post4/ + index.md + post6/ + index.md + post7/ + index.md + post9/ + index.md + series1/ + _index.md + post3/ + index.md + post5/ + index.md + post8/ + index.md +``` + +To create a series, you need to: + +1. Use the `series.html` template +2. Set `series = true` in the section's `[extra]` configuration +3. Enable `transparent = true` to integrate series posts with the parent blog section + +The series main page displays an overview followed by a list of all posts in the series: + +{{ dual_theme_image(light_src="blog/series/img/series_light.webp", dark_src="blog/series/img/series_dark.webp" alt="a series", full_width=true) }} + +## Jump to Posts + +If the content of a series (the Markdown after the front matter in `_index.md`) is over 2000 characters, a "Jump to posts" link appears next to the series title. + +{{ dual_theme_image(light_src="blog/series/img/jump_to_series_posts_light.webp", dark_src="blog/series/img/jump_to_series_posts_dark.webp" alt="jump to series posts link", full_width=true) }} + +To force the feature on or off, set `show_jump_to_posts` in the `[extra]` section of your series section or in `config.toml`. This setting follows [the hierarchy](@/blog/mastering-tabi-settings/index.md#settings-hierarchy). + +## Series Pages and Order + +All pages in the series section will be a series page. The series pages will be ordered as per the series section `sort_by`. + +While series maintain their own internal order, they remain independent from the main section's (e.g. `blog/`) chronological flow thanks to the `transparent` setting. + +### Sorting Options + +Choose from these sorting methods, each with its own advantages: + +{% wide_container() %} + +`sort_by` | pros | cons +---------|-------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- + `slug` | The series pages order is made explicit in the path (e.g. `example.com/blog/series1/01-series-post-one`). | Each series page must be prefixed accordingly. + `weight` | The series pages order is easy to set up transparently.
First series post has weight `1`, second series post has weight `2` and so on. | Each series page must have its weight set accordingly. + `date` | The series pages order can be configured once in the series section configuration. No need to do anything on each series page. | The series pages order has to be reversed because the first page is usually the oldest. This can only be achieved by paginating the series section (`paginate_by = 9999`) and reversing its order (`paginate_reversed = true`). + +{% end %} + +{{ admonition(type="danger", title="Zola version to sort by date", text="In order to properly reverse dates, Zola v0.19.3+ (unreleased) is required so that pagination information is available through the `get_section` function. Anything relying on the series pages order won't be correct in a series page otherwise (e.g. previous/next series page, ordered and unordered list…) See [Zola PR #2653](https://github.com/getzola/zola/pull/2653).") }} + +### Page Indexing + +Pages in a series are indexed starting from 1, following their `sort_by` order. To reverse the indexing (making the first page have the highest index instead), add this setting to `_index.md` or `config.toml`: + +```toml +[extra] +post_listing_index_reversed = true # Defaults to false if unset. +``` + +{{ dual_theme_image(light_src="blog/series/img/series_reversed_light.webp", dark_src="blog/series/img/series_reversed_dark.webp" alt="a series with indexes reversed", full_width=true) }} + +This setting follows [the hierarchy](@/blog/mastering-tabi-settings/index.md#settings-hierarchy). + +## Intro and Outro Templates + +Series articles can have automatic introduction and conclusion sections. These are configured in your series' `_index.md`. A basic example: + +```toml,name=series/_index.md +[extra.series_intro_templates] +default = "This article is part of the $SERIES_HTML_LINK series." + +[extra.series_outro_templates] +default = "Thanks for reading part $SERIES_PAGE_INDEX of $SERIES_HTML_LINK!" +``` + +The intro and outro sections each have their own CSS classes (`series-page-intro` and `series-page-outro`), allowing you to customize their appearance through [custom CSS](@/blog/mastering-tabi-settings/index.md#custom-css). + +### Template Types + +The series system uses different templates based on an article's position in the series: + +- `next_only` - Used for the first article (has next article but no previous) +- `middle` - Used for articles with both previous and next articles +- `prev_only` - Used for the last article (has previous article but no next) +- `default` - Fallback template used when a specific position template isn't defined + +The system automatically determines which template to use based on the article's position. The templates are defined in the series configuration (`_index.md`), as `extra.series_intro_templates` and `extra.series_outro_templates`.: + +```toml,name=series/_index.md +[extra.series_intro_templates] +next_only = "Welcome to part 1! Next up: $NEXT_HTML_LINK" +middle = "Previous: $PREV_HTML_LINK | Next: $NEXT_HTML_LINK" +prev_only = "The final chapter! Previously: $PREV_HTML_LINK" +default = "Part $SERIES_PAGE_INDEX of $SERIES_PAGES_NUMBER" +``` + +All templates are optional. Template selection follows a priority system: + +1. If a position-specific template exists (`next_only`, `middle`, or `prev_only`), it will be used +2. Otherwise, the `default` template is used +3. If no templates are defined at all, no series information will be displayed + +See the [template example](#template-example) for a more elaborate example. + +### Placement in Content + +By default: + +- Series introductions appear at the start of your article +- Series outro appears at the end (before footnotes, if any) + +You can control exactly where these appear using `` and `` in your Markdown: + +```markdown +This paragraph appears before the series introduction. + + + +Main content of the article. + + + +## Learning Resources + +Extra content… + +[^1]: Footnotes will always appear at the end. +``` + +## Variables + +Series templates use a flexible variable system that lets you: + +1. Reference series information (title, links) +2. Add navigation between articles +3. Show progress indicators +4. Include custom information using your own variables + +Variables are placeholders starting with `$` that get replaced with actual content when your site builds. For example, `$SERIES_HTML_LINK` becomes a clickable link to your series index page. + +There are three types of variables: + +- [**Basic Series Variables**](#basic-series-variables): General information about the series +- [**Navigation Variables**](#navigation-variables): Links to previous/next articles +- [**Custom Variables**](#custom-variables): Your own placeholders for additional information + +### Basic Series Variables + +{% wide_container() %} + +| Variable | Availability | Returns | Description | Example Usage | Example Output | +|----------|-------------|---------|-------------|---------------|----------------| +| `$SERIES_TITLE` | Always | Text | Plain text title of the series | `Part of $SERIES_TITLE` | Part of Learn Rust | +| `$SERIES_PERMALINK` | Always | Text | URL to series index | `[See all posts]($SERIES_PERMALINK)` | [See all posts](/series/learn-rust) | +| `$SERIES_HTML_LINK` | Always | HTML | Ready-to-use link to series | `Welcome to $SERIES_HTML_LINK!` | Welcome to Learn Rust! | +| `$SERIES_PAGES_NUMBER` | Always | Number | Total articles in series | `A $SERIES_PAGES_NUMBER part series` | A 5 part series | +| `$SERIES_PAGE_INDEX` | Always | Number | Current article's position | `Part $SERIES_PAGE_INDEX of $SERIES_PAGES_NUMBER` | Part 3 of 5 | +| `$SERIES_PAGES_OLIST` | Always | HTML | Ordered list of all articles | `Articles in series: $SERIES_PAGES_OLIST` | Articles in series:
  1. Current article
  2. Other articles
| +| `$SERIES_PAGES_ULIST` | Always | HTML | Unordered list of all articles | `Articles in series: $SERIES_PAGES_ULIST` | Articles in series: | + +{% end %} + +{{ admonition(type="tip", title="TIP: Custom text with permalinks", text='Markdown links like `[text]($SERIES_PERMALINK)` will be marked (and [styled](@/blog/mastering-tabi-settings/index.md#external-link-indicator)) as external. If you need custom text and want to avoid external styling, use HTML: `your text`.') }} + +### Navigation Variables + +{% wide_container() %} + +| Variable | Availability | Returns | Description | Example Usage | Example Output | +|----------|-------------|---------|-------------|---------------|----------------| +| `$PREV_TITLE` | Previous exists | Text | Previous article's title | `Previously: $PREV_TITLE` | Previously: Setting Up Your Environment | +| `$PREV_PERMALINK` | Previous exists | Text | URL to previous article | `[← Back]($PREV_PERMALINK)` | [← Back](/series/learn-rust/setup) | +| `$PREV_HTML_LINK` | Previous exists | HTML | Ready-to-use link to previous | `Read $PREV_HTML_LINK first` | Read Setting Up Your Environment first | +| `$PREV_DESCRIPTION` | Previous exists | Text | Description of previous article | `Recap: $PREV_DESCRIPTION` | Recap: Setting up Rust | +| `$NEXT_TITLE` | Next exists | Text | Next article's title | `Next up: $NEXT_TITLE` | Next up: Advanced Patterns | +| `$NEXT_PERMALINK` | Next exists | Text | URL to next article | `[Continue →]($NEXT_PERMALINK)` | [Continue →](/series/learn-rust/patterns) | +| `$NEXT_HTML_LINK` | Next exists | HTML | Ready-to-use link to next | `Continue with $NEXT_HTML_LINK` | Continue with Advanced Patterns | +| `$NEXT_DESCRIPTION` | Next exists | Text | Description of next article | `Coming up: $NEXT_DESCRIPTION` | Coming up: Learn about Rust's advanced pattern matching features | + +{% end %} + +### First Article Reference + +{% wide_container() %} + +| Variable | Availability | Returns | Description | Example Usage | Example Output | +|----------|-------------|---------|-------------|---------------|----------------| +| `$FIRST_TITLE` | Always | Text | First article's title | `Start with $FIRST_TITLE` | Start with Introduction to Rust | +| `$FIRST_HTML_LINK` | Always | HTML | Ready-to-use link to first article | `Begin at $FIRST_HTML_LINK` | Begin at Introduction to Rust | + +{% end %} + +### Template Example + +{{ admonition(type="tip", title="HTML vs text variables", text="Use HTML variables (ending in `_HTML_LINK`) when you want ready-made links. Use text variables (ending in `_TITLE` or `_PERMALINK`) when you want more control over the formatting.") }} + +```toml,name=series/_index.md +# Introduction. +[extra.series_intro_templates] +next_only = """ +Welcome to $SERIES_HTML_LINK! This $SERIES_PAGES_NUMBER-part series will teach you Rust from scratch. + +Up next: $NEXT_HTML_LINK - $NEXT_DESCRIPTION +""" + +middle = """ +📚 Part $SERIES_PAGE_INDEX of $SERIES_PAGES_NUMBER in $SERIES_HTML_LINK + +Previously: $PREV_HTML_LINK +Next up: $NEXT_HTML_LINK +""" + +prev_only = """ +Welcome to the final part of $SERIES_HTML_LINK! +New here? Start with $FIRST_HTML_LINK to build a strong foundation. + +Previously: $PREV_HTML_LINK +""" + +# Fallback template. +default = "This article is part of the $SERIES_HTML_LINK series." + +# Outro. +[extra.series_outro_templates] +next_only = """ +Thanks for reading! 🙌 + +Continue your journey with $NEXT_HTML_LINK, where $NEXT_DESCRIPTION +Or check out the complete [$SERIES_TITLE]($SERIES_PERMALINK) series outline. +""" + +middle = """ +--- +📝 Series Navigation + +- Previous: $PREV_HTML_LINK +- Next: $NEXT_HTML_LINK +- [Series Overview]($SERIES_PERMALINK) +""" + +prev_only = """ +🎉 Congratulations! You've completed $SERIES_HTML_LINK. + +Want to review? Here's where we started: $FIRST_HTML_LINK +Or check what we just covered in $PREV_HTML_LINK. +""" + +# Fallback. +default = """ +--- +This article is part $SERIES_PAGE_INDEX of $SERIES_PAGES_NUMBER in $SERIES_HTML_LINK. +""" +``` + +### Custom Variables + +Series templates support custom variables for additional information you want to include across your series. The process takes two steps: + +1. First, define your **placeholders** in your series configuration (`_index.md`): + +```toml,name=series/_index.md +[extra] +series = true +series_template_placeholders = ["$POSITION", "$TOPIC", "$DIFFICULTY"] +``` + +2. Then, in each series article, provide the values for these placeholders in `series_template_variables`: + +```toml,name=series/article.md +[extra.series_template_variables] +position = "first" +topic = "Variables and Types" +difficulty = "Beginner" +``` + +### Using Custom Variables + +You can use your custom variables in any template, alongside the built-in variables: + +```toml,name=series/_index.md +[extra.series_intro_templates] +default = """ +This is the $POSITION article in $SERIES_HTML_LINK. +Today's topic: $TOPIC +Difficulty level: $DIFFICULTY +""" +``` + +{{ admonition(type="warning", text="While placeholders are defined with uppercase (`$POSITION`), the variable names in `series_template_variables` must be lowercase (`position`).") }} + +### Example with Custom Variables + +```toml,name=series/_index.md +# In the series configuration. +[extra] +series = true +series_template_placeholders = ["$LEARNING_TIME", "$KEY_CONCEPTS"] + +series_intro_templates.default = """ +📚 Part $SERIES_PAGE_INDEX of $SERIES_PAGES_NUMBER +⏱️ Estimated time: $LEARNING_TIME +🔑 Key concepts: $KEY_CONCEPTS +""" +``` + +```toml,name=series/02-learning-rust/index.md +# In an article of the series. +[extra.series_template_variables] +learning_time = "30 minutes" +key_concepts = "Functions, Error Handling, Pattern Matching" +``` + +This will output: + +```txt +📚 Part 2 of 5 +⏱️ Estimated time: 30 minutes +🔑 Key concepts: Functions, Error Handling, Pattern Matching +``` + +{{ admonition(type="warning", title="Missing Variables", text="If you use a placeholder in your templates but don't provide its value in `series_template_variables`, the build will fail with an error listing the missing variables.") }} diff --git a/content/blog/series/social_cards/blog_series.jpg b/content/blog/series/social_cards/blog_series.jpg new file mode 100644 index 0000000..0de6828 Binary files /dev/null and b/content/blog/series/social_cards/blog_series.jpg differ diff --git a/content/blog/series/social_cards/ca_blog_series.jpg b/content/blog/series/social_cards/ca_blog_series.jpg new file mode 100644 index 0000000..12ccc6c Binary files /dev/null and b/content/blog/series/social_cards/ca_blog_series.jpg differ diff --git a/content/blog/series/social_cards/es_blog_series.jpg b/content/blog/series/social_cards/es_blog_series.jpg new file mode 100644 index 0000000..3a24a96 Binary files /dev/null and b/content/blog/series/social_cards/es_blog_series.jpg differ diff --git a/content/blog/shortcodes/index.ca.md b/content/blog/shortcodes/index.ca.md index 5219be9..880267b 100644 --- a/content/blog/shortcodes/index.ca.md +++ b/content/blog/shortcodes/index.ca.md @@ -1,7 +1,7 @@ +++ title = "Shortcodes personalitzats" date = 2023-02-19 -updated = 2024-09-22 +updated = 2025-08-01 description = "Aquest tema inclou alguns shortcodes personalitzats útils que pots utilitzar per millorar les teves publicacions. Ja sigui per mostrar imatges que s'adapten als temes clar i fosc, o per donar format a una secció de referències amb un aspecte professional, aquests shortcodes personalitzats t'ajudaran." [taxonomies] @@ -11,7 +11,7 @@ tags = ["funcionalitat", "shortcodes"] toc = true toc_levels = 2 quick_navigation_buttons = true -add_src_to_code_block = true +code_block_name_links = true mermaid = true social_media_card = "social_cards/ca_blog_shortcodes.jpg" +++ @@ -28,7 +28,7 @@ Per incloure un diagrama Mermaid a la teva publicació, cal fer dues coses: 2. Utilitza el shortcode `mermaid()` per definir el teu diagrama. Per exemple: -```plaintext +```txt {%/* mermaid() */%} classDiagram class DistorsionsCognitives { @@ -91,12 +91,25 @@ El shortcode de Mermaid admet dos paràmetres: {{ admonition(type="tip", title="CONSELL", text="Empra l'[editor de Mermaid](https://mermaid.live/) per crear i previsualitzar els teus diagrames.") }} +#### Ús + +``` +{%/* mermaid(invertible=true, full_width=false) */%} + +El teu codi Mermaid va aquí. + +`invertible` or `full_width` poden ometre's per emprar els valors per defecte. + +{%/* end */%} +``` + ## Shortcodes d'imatge Tots els shortcodes d'imatge admeten rutes absolutes, rutes relatives, i fonts remotes en el paràmetre `src`. -Tots els shortcodes d'imatge tenen tres paràmetres opcionals: +Tots els shortcodes d'imatge tenen els següents paràmetres opcionals: +- `raw_path`. Per defecte és `false`. Si es configura a `true`, el paràmetre `src` s'utilitzarà tal qual. Útil per a actius ubicats a la mateixa carpeta que tenen un slug personalitzat (vegeu [Zola issue #2598](https://github.com/getzola/zola/issues/2598)). - `inline`. Valor predeterminat: `false`. Si s'estableix a `true`, la imatge es mostrarà en línia amb el text. - `full_width`. Valor predeterminat: `false` (vegeu [a sota](#imatge-d-amplada-completa)). - `lazy_loading`. Valor predeterminat: `true`. @@ -174,27 +187,81 @@ Tots els altres shortcodes d'imatges poden utilizar l'amplada completa assignant {{/* full_width_image(src="img/amsterdam_by_oskerwyld.webp", alt="Fotografia d'un canal a Àmsterdam") */}} ``` +## Shortcodes socials + +### iine + +{{ aside(text="Per afegir-lo a totes les publicacions, estableix `iine = true` a la secció `[extra]` del teu `config.toml`.") }} + +Aquest shortcode et permet afegir botons addicionals d'[iine.to](https://iine.to) a les teves publicacions, com aquest: + +{{ iine(slug="/blog/shortcodes/demo-button") }} + +#### Ús + +``` +{{/* iine(icon="heart", slug="/post/el-meu-slug-de-post/like", label="M'agrada aquesta publicació") */}} +``` + +El shortcode accepta els següents paràmetres opcionals: + +- `icon`: La icona a mostrar. Pot ser `heart`, `thumbs_up`, `upvote`, o qualsevol emoji. +- `slug`: Un identificador únic. Per defecte és la ruta de la pàgina actual. Útil si vols més d'un botó a la mateixa pàgina. +- `label`: L'etiqueta d'accessibilitat per al botó. Per defecte és "M'agrada aquesta publicació". + ## Shortcodes de codi ### Mostrar ruta o URL -Mostra una ruta o URL al següent bloc de codi trobat. Si comença amb "http", es convertirà en un enllaç. Particularment útil quan s'utilitza en conjunció amb el [shortcode de text remot](#text-remot). +Pots mostrar una ruta o URL per a un bloc de codi utilitzant la sintaxi nativa de Zola: -{{ admonition(type="warning", title="IMPORTANT", text="Aquesta funcionalitat requereix JavaScript. Per activar-la, configura `add_src_to_code_block = true` a la secció `[extra]` de la teva pàgina, secció, o `config.toml`.") }} +{{ aside(text="Requereix Zola 0.20.0 o superior.") }} -{{ add_src_to_code_block(src="https://github.com/welpo/doteki/blob/main/.gitignore") }} +```` +```rust,name=src/main.rs +fn main() { + println!("Hola, món!"); +} +``` +```` -```.gitignore -{{ remote_text(src="https://raw.githubusercontent.com/welpo/doteki/main/.gitignore") }} +Això renderitza: + +```rust,name=src/main.rs +fn main() { + println!("Hola, món!"); +} +``` + +Si estableixes el `name` com una URL (és a dir, comença amb `http` o `https`), pots convertir-lo en un enllaç clicable. Això és particularment útil quan s'utilitza juntament amb el [shortcode de text remot](#text-remot). + +{{ admonition(type="warning", title="JavaScript necessari", text="La funció d'URLs clicables requereix JavaScript. Per habilitar-la, configura `code_block_name_links = true` a la secció `[extra]` de la teva pàgina, secció, o `config.toml`.") }} + +```.gitignore,name=https://github.com/welpo/doteki/blob/main/.gitignore +__pycache__/ +*coverage* +.vscode/ +dist/ +``` + +### Suport de shortcode heretat + +El shortcode `add_src_to_code_block` segueix funcionant per retrocompatibilitat però serà descontinuat en una versió futura. Si us plau, utilitza la sintaxi nativa de Zola: + +``` +# Forma antiga (descontinuada): +{{/* add_src_to_code_block(src="ruta/al/fitxer.rs") */}} + +# Forma nova (recomanada): +```rust,name=ruta/al/fitxer.rs ``` #### Ús ```` {{/* add_src_to_code_block(src="https://github.com/welpo/doteki/blob/main/.gitignore") */}} - ```.gitignore -__pycache__/ +**pycache**/ *coverage* .vscode/ dist/ @@ -203,6 +270,38 @@ dist/ ## Shortcodes de text +### Aside (nota al marge) + +Afegeix contingut complementari als marges en pantalles amples, o com a blocs distintius en mòbil. + +{{ aside(text="*Nota al marge* ve de *nota* (del llatí, 'marca' o 'senyal') i *marge* (del llatí *margo*, 'vora' o 'límit').") }} + +El shortcode accepta dos paràmetres: + +- `position`: Establir com a `"right"` per col·locar al marge dret (per defecte, esquerre) +- El contingut es pot proporcionar mitjançant el paràmetre `text` o entre les etiquetes del shortcode + +#### Ús + +{{ admonition(type="warning", text="Separa la definició de la nota del shortcode amb dues línies en blanc per evitar errors de renderització.") }} + +Fent servir el paràmetre `text`: + +``` +{{/* aside(text="*Nota al marge* ve de *nota* (del llatí, 'marca' o 'senyal') i *marge* (del llatí *margo*, 'vora' o 'límit').") */}} +``` + +Fent servir el cos del contingut i indicant la posició a la dreta: + +``` +{%/* aside(position="right") */%} +Una nota més llarga que +pot ocupar diverses línies. + +S'admet *Markdown*. +{%/* end */%} +``` + ### Text remot Afegeix text des d'una URL remota o un arxiu local. @@ -263,10 +362,26 @@ Pots canviar el `title` i la `icon` de l'advertència. Ambdós paràmetres accep #### Ús -``` +Pots utilitzar les advertències de dues maneres: + +1. En línia amb paràmetres: + +```md {{/* admonition(type="danger", icon="tip", title="Un consell important", text="Mantingues-te hidratat") */}} ``` +2. Amb contingut al cos: + +```md +{%/* admonition(type="danger", icon="tip", title="Un consell important") */%} +Mantingues-te hidratat + +Aquest mètode és especialment útil per a contingut llarg o múltiples paràgrafs. +{%/* end */%} +``` + +Ambdós mètodes admeten els mateixos paràmetres (`type`, `icon`, i `title`). + ### Cites multillenguatge Aquest shortcode permet mostrar una cita traduïda i en el llenguatge original: @@ -350,3 +465,31 @@ El Markdown, per suposat, serà interpretat. {%/* end */%} ``` + +### Forçar direcció del text + +Força la direcció del text d'un bloc de contingut. Substitueix tant la configuració global `force_codeblock_ltr` com la direcció general del document. + +Accepta el paràmetre `direction`: la direcció de text desitjada. Pot ser "ltr" (d'esquerra a dreta) o "rtl" (de dreta a esquerra). Per defecte és "ltr". + +{% force_text_direction(direction="rtl") %} +```python +def مرحبا_بالعالم(): + print("مرحبا بالعالم!") +``` +{% end %} + +#### Ús + +En una pàgina LTR podem forçar que un bloc de codi sigui RTL (com es mostra a dalt) de la següent manera: + +```` +{%/* force_text_direction(direction="rtl") */%} + +```python +def مرحبا_بالعالم(): + print("مرحبا بالعالم!") +``` + +{%/* end */%} +```` diff --git a/content/blog/shortcodes/index.es.md b/content/blog/shortcodes/index.es.md index 8dc2d90..5efaf8c 100644 --- a/content/blog/shortcodes/index.es.md +++ b/content/blog/shortcodes/index.es.md @@ -1,7 +1,7 @@ +++ title = "Shortcodes personalizados" date = 2023-02-19 -updated = 2024-09-22 +updated = 2025-08-01 description = "Este tema incluye algunos shortcodes personalizados útiles que puedes utilizar para mejorar tus publicaciones. Puedes mostrar imágenes que se adapten a los temas claro y oscuro, dar formato a una sección de referencias con un aspecto profesional, y más." [taxonomies] @@ -11,7 +11,7 @@ tags = ["funcionalidad", "shortcodes"] toc = true toc_levels = 2 quick_navigation_buttons = true -add_src_to_code_block = true +code_block_name_links = true mermaid = true social_media_card = "social_cards/es_blog_shortcodes.jpg" +++ @@ -28,7 +28,7 @@ Para incluir un diagrama Mermaid en tu publicación, sigue estos dos pasos: 2. Usa el shortcode `mermaid()` para definir tu diagrama. Por ejemplo: -```plaintext +```txt {%/* mermaid() */%} classDiagram class DistorsionesCognitivas { @@ -91,12 +91,23 @@ El shortcode de Mermaid admite dos parámetros: {{ admonition(type="tip", title="CONSEJO", text="Puedes usar el [editor de Mermaid](https://mermaid.live/) para crear y previsualizar tus diagramas.") }} +#### Uso + +``` +{%/* mermaid(invertible=true, full_width=false) */%} + +Tu diagrama Mermaid va aquí. Puedes omitir los parámetros para usar los valores predeterminados. + +{%/* end */%} +``` + ## Shortcodes de imagen Todos los shortcodes de imagen admiten rutas absolutas, rutas relativas, y fuentes remotas en el parámetro `src`. -Todos los shortcodes de imagen tienen tres parámetros opcionales: +Todos los shortcodes de imagen tienen los siguientes parámetros opcionales: +- `raw_path`. Por defecto es `false`. Si se establece en `true`, el parámetro `src` se usará tal cual. Útil para activos ubicados en la misma carpeta que tienen un slug personalizado (ver [Zola issue #2598](https://github.com/getzola/zola/issues/2598)). - `inline`. Valor predeterminado: `false`. Si se establece `true`, la imagen se mostrará en línea con el texto. - `full_width`. Valor predeterminado: `false` (ver [más abajo](#imagen-a-ancho-completo)). - `lazy_loading`. Valor predeterminado: `true`. @@ -175,35 +186,109 @@ Todos los otros shortcodes de imágenes pueden usar el ancho completo asignando {{/* full_width_image(src="img/amsterdam_by_oskerwyld.webp", alt="Fotografía de un canal en Ámsterdam") */}} ``` +## Shortcodes sociales + +### iine + +{{ aside(text="Para añadirlo a todas las publicaciones, establece `iine = true` en la sección `[extra]` de tu `config.toml`.") }} + +Este shortcode te permite añadir botones adicionales de [iine.to](https://iine.to) a tus publicaciones, como este: + +{{ iine(slug="/blog/shortcodes/demo-button") }} + +#### Uso + +``` +{{/* iine(icon="heart", slug="/post/mi-slug-de-post/like", label="Me gusta esta publicación") */}} +``` + +El shortcode acepta los siguientes parámetros opcionales: + +- `icon`: El icono a mostrar. Puede ser `heart`, `thumbs_up`, `upvote`, o cualquier emoji. +- `slug`: Un identificador único. Por defecto es la ruta de la página actual. Útil si quieres más de un botón en la misma página. +- `label`: La etiqueta de accesibilidad para el botón. Por defecto es "Me gusta esta publicación". + ## Shortcodes de código ### Mostrar ruta o URL -Muestra una ruta o URL en el siguiente bloque de código encontrado. Si comienza con "http", se convertirá en un enlace. Particularmente útil cuando se usa junto con el [shortcode de texto remot](#texto-remoto). +Puedes mostrar una ruta o URL para un bloque de código usando la sintaxis nativa de Zola: -{{ add_src_to_code_block(src="https://github.com/welpo/doteki/blob/main/.gitignore") }} - -```.gitignore -{{ remote_text(src="https://raw.githubusercontent.com/welpo/doteki/main/.gitignore") }} -``` - -{{ admonition(type="warning", title="IMPORTANT", text="Esta característica requiere JavaScript. Para habilitarla, configura `add_src_to_code_block = true` en la sección `[extra]` de tu página, sección, o `config.toml`.") }} - -#### Uso +{{ aside(text="Requiere Zola 0.20.0 o superior.") }} ```` -{{/* add_src_to_code_block(src="https://github.com/welpo/doteki/blob/main/.gitignore") */}} +```rust,name=src/main.rs +fn main() { + println!("¡Hola, mundo!"); +} +``` +```` -```.gitignore +Esto renderiza: + +```rust,name=src/main.rs +fn main() { + println!("¡Hola, mundo!"); +} +``` + +Si estableces el `name` como una URL (es decir, comienza con `http` o `https`), puedes convertirlo en un enlace clickable. Esto es particularmente útil cuando se usa junto con el [shortcode de texto remoto](#texto-remoto). + +{{ admonition(type="warning", title="JavaScript requerido", text="La función de URLs clickables requiere JavaScript. Para habilitarla, configura `code_block_name_links = true` en la sección `[extra]` de tu página, sección, o `config.toml`.") }} + +```.gitignore,name=https://github.com/welpo/doteki/blob/main/.gitignore __pycache__/ *coverage* .vscode/ dist/ ``` -```` + +### Soporte de shortcode heredado + +El shortcode `add_src_to_code_block` sigue funcionando por retrocompatibilidad, pero será descontinuado en una versión futura. Por favor, usa la sintaxis nativa de Zola: + +``` +# Forma antigua (descontinuada): +{{/* add_src_to_code_block(src="ruta/al/archivo.rs") */}} + +# Forma nueva (recomendada): +```rust,name=ruta/al/archivo.rs +``` ## Shortcodes de texto +### Aside (nota al margen) + +Añade contenido complementario en los márgenes en pantallas anchas, o como bloques distintivos en móvil. + +{{ aside(text="*Nota al margen* viene de *nota* (del latín, 'marca' o 'señal') y *margen* (del latín *margo*, 'borde' o 'límite').") }} + +El shortcode acepta dos parámetros: + +- `position`: Establecer como `"right"` para colocar en el margen derecho (por defecto, izquierdo) +- El contenido puede proporcionarse mediante el parámetro `text` o entre las etiquetas del shortcode + +#### Uso + +{{ admonition(type="warning", text="Separa la llamada al shortcode con saltos de línea para evitar errores de renderizado.") }} + +Usando el parámetro `text`: + +``` +{{/* aside(text="*Nota al margen* viene de *nota* (del latín, 'marca' o 'señal') y *margen* (del latín *margo*, 'borde' o 'límite').") */}} +``` + +Usando el cuerpo del contenido e indicando la posición: + +``` +{%/* aside(position="right") */%} +Una nota más larga que +puede ocupar varias líneas. + +Se admite *Markdown*. +{%/* end */%} +``` + ### Texto remoto Añade texto desde una URL remota o un archivo local. @@ -264,10 +349,26 @@ Puedes cambiar el `title` y el `icon` de la advertencia. Ambos parámetros acept #### Uso -``` +Puedes usar las advertencias de dos formas: + +1. En línea con parámetros: + +```md {{/* admonition(type="danger", icon="tip", title="Un consejo importante", text="Mantente hidratado") */}} ``` +2. Con contenido en el cuerpo: + +```md +{%/* admonition(type="danger", icon="tip", title="Un consejo importante") */%} +Mantente hidratado + +Este método es especialmente útil para contenido largo o múltiples párrafos. +{%/* end */%} +``` + +Ambos métodos admiten los mismos parámetros (`type`, `icon`, y `title`). + ### Citas multilenguaje Este shortcode permite mostrar una cita traducida y en su lenguaje original: @@ -352,3 +453,31 @@ El Markdown, por supuesto, será interpretado. {%/* end */%} ``` + +### Forzar dirección del texto + +Fuerza la dirección del texto de un bloque de contenido. Anula tanto la configuración global `force_codeblock_ltr` como la dirección general del documento. + +Acepta el parámetro `direction`: la dirección de texto deseada. Puede ser "ltr" (de izquierda a derecha) o "rtl" (de derecha a izquierda). Por defecto es "ltr". + +{% force_text_direction(direction="rtl") %} +```python +def مرحبا_بالعالم(): + print("مرحبا بالعالم!") +``` +{% end %} + +#### Uso + +En una página LTR podemos forzar que un bloque de código sea RTL (como se muestra arriba) de la siguiente manera: + +```` +{%/* force_text_direction(direction="rtl") */%} + +```python +def مرحبا_بالعالم(): + print("مرحبا بالعالم!") +``` + +{%/* end */%} +```` diff --git a/content/blog/shortcodes/index.md b/content/blog/shortcodes/index.md index b993d14..d40d3cd 100644 --- a/content/blog/shortcodes/index.md +++ b/content/blog/shortcodes/index.md @@ -1,7 +1,7 @@ +++ title = "Custom shortcodes" date = 2023-02-19 -updated = 2024-09-22 +updated = 2025-07-26 description = "This theme includes some useful custom shortcodes that you can use to enhance your posts. Whether you want to display images that adapt to light and dark themes, or format a professional-looking reference section, these custom shortcodes have got you covered." [taxonomies] @@ -11,7 +11,7 @@ tags = ["showcase", "shortcodes"] toc = true toc_levels = 2 quick_navigation_buttons = true -add_src_to_code_block = true +code_block_name_links = true mermaid = true social_media_card = "social_cards/blog_shortcodes.jpg" +++ @@ -28,7 +28,7 @@ To include a Mermaid diagram in your post, there are two steps: 2. Use the `mermaid()` shortcode to define your diagram in your posts. For example: -```plaintext +```txt {%/* mermaid() */%} classDiagram class CognitiveDistortions { @@ -91,12 +91,25 @@ The Mermaid shortcode supports two parameters: {{ admonition(type="tip", text="You can use the [Mermaid Live Editor](https://mermaid.live/) to create and preview your diagrams.") }} +#### Usage + +``` +{%/* mermaid(invertible=true, full_width=false) */%} + +Your diagram goes here. + +`invertible` or `full_width` can be omitted if default values are used. + +{%/* end */%} +``` + ## Image shortcodes All image shortcodes support absolute paths, relative paths, and remote sources in the `src` parameter. -All image shortcodes have three optional parameters: +All image shortcodes have these optional parameters: +- `raw_path`. Defaults to `false`. If set to `true`, the `src` parameter will be used as is. Useful for colocated assets with a custom slug (see [Zola issue #2598](https://github.com/getzola/zola/issues/2598)). - `inline`. Defaults to `false`. If set to `true`, the image will be displayed inline with the text. - `full_width`. Defaults to `false` (see [below](#full-width-image)) - `lazy_loading`. Defaults to `true`. @@ -108,6 +121,7 @@ Useful if you want to use a different image for the light and dark themes: {{ dual_theme_image(light_src="img/paris_day.webp", dark_src="img/paris_night.webp" alt="The Eiffel tower") }} #### Usage + ``` {{/* dual_theme_image(light_src="img/paris_day.webp", dark_src="img/paris_night.webp" alt="The Eiffel tower") */}} ``` @@ -138,7 +152,7 @@ Images with too much brightness or contrast can be jarring against a dark backgr ### Swap image on hover -Povides an interaction where the image displayed changes as the user hovers over it. Useful for before-after comparisons, for example. +Provides an interaction where the image displayed changes as the user hovers over it. Useful for before-after comparisons, for example. {{ image_hover(default_src="img/edited.webp", hovered_src="img/raw.webp", default_alt="Edited picture", hovered_alt="Original shot") }} @@ -174,35 +188,109 @@ All other image shortcodes can be made into full-width by setting the optional p {{/* full_width_image(src="img/amsterdam_by_oskerwyld.webp", alt="Photograph of a canal in Amsterdam") */}} ``` +## Engagement shortcodes + +### iine + +{{ aside(text="To add it to all posts, set `iine = true` in the `[extra]` section of your `config.toml`.") }} + +This shortcode allows you to add extra [iine.to](https://iine.to) buttons to your posts, like this: + +{{ iine(slug="/blog/shortcodes/demo-button") }} + +#### Usage + +``` +{{/* iine(icon="heart", slug="/post/my-post-slug/like", label="Like this post") */}} +``` + +The shortcode takes the following optional parameters: + +- `icon`: The icon to display. Can be `heart`, `thumbs_up`, `upvote`, or any emoji. +- `slug`: A unique identifier. Defaults to the current page's path. Useful if you want more than one button on the same page. +- `label`: The accessibility label for the button. Defaults to "Like this post". + ## Code shortcodes ### Show source or path -Display a path or URL on the next code block found. If it starts with "http", it will become a link. Particularly useful when used in conjunction with the [remote text shortcode](#remote-text). +You can display a path or URL for a code block using Zola's native syntax: -{{ add_src_to_code_block(src="https://github.com/welpo/doteki/blob/main/.gitignore") }} - -```.gitignore -{{ remote_text(src="https://raw.githubusercontent.com/welpo/doteki/main/.gitignore") }} -``` - -{{ admonition(type="warning", title="IMPORTANT", text="This feature requires JavaScript. To enable it, set `add_src_to_code_block = true` on the `[extra]` section of your page, section, or `config.toml`.") }} - -#### Usage +{{ aside(text="Requires Zola 0.20.0 or later.") }} ```` -{{/* add_src_to_code_block(src="https://github.com/welpo/doteki/blob/main/.gitignore") */}} +```rust,name=src/main.rs +fn main() { + println!("Hello, world!"); +} +``` +```` -```.gitignore +This renders: + +```rust,name=src/main.rs +fn main() { + println!("Hello, world!"); +} +``` + +If you set the `name` to a URL (i.e. it starts with `http` or `https`), you can turn it into a clickable link. This is particularly useful when used in conjunction with the [remote text shortcode](#remote-text). + +{{ admonition(type="warning", title="JavaScript required", text="The clickable URL feature requires JavaScript. To enable it, set `code_block_name_links = true` on the `[extra]` section of your page, section, or `config.toml`.") }} + +```.gitignore,name=https://github.com/welpo/doteki/blob/main/.gitignore __pycache__/ *coverage* .vscode/ dist/ ``` -```` + +### Legacy shortcode support + +The `add_src_to_code_block` shortcode is still supported for backward compatibility but will be deprecated in a future release. Please use Zola's native syntax shown above instead: + +``` +# Old way (deprecated): +{{/* add_src_to_code_block(src="path/to/file.rs") */}} + +# New way (preferred): +```rust,name=path/to/file.rs +``` ## Text shortcodes +### Aside (side/margin note) + +Add supplementary content in the margins on wide screens, or as distinct blocks on mobile. + +{{ aside(text="*Sidenote* comes from Latin *nota* ('mark') + Old English *síde* ('side').") }} + +The shortcode accepts two parameters: + +- `position`: Set to `"right"` to place in right margin (defaults to left) +- Content can be provided via `text` parameter or between shortcode tags + +#### Usage + +{{ admonition(type="warning", text="Place the aside shortcode on its own line to prevent formatting issues.") }} + +Using the `text` parameter: + +``` +{{/* aside(text="*Sidenote* comes from Latin *nota* ('mark') + Old English *síde* ('side').") */}} +``` + +Using the content body and setting the position to right: + +``` +{%/* aside(position="right") */%} +A longer note that +can span multiple lines. + +_Markdown_ is supported. +{%/* end */%} +``` + ### Remote text Embed text from a remote URL or a local file. To display the path or URL on the code block, see the [show source or path shortcode](#show-source-or-path). @@ -263,20 +351,36 @@ You can change the `title` and `icon` of the admonition. Both parameters take a #### Usage -``` +You can use admonitions in two ways: + +1. Inline with parameters: + +```md {{/* admonition(type="danger", icon="tip", title="An important tip", text="Stay hydrated~") */}} ``` +2. With a content body: + +```md +{%/* admonition(type="danger", icon="tip", title="An important tip") */%} +Stay hydrated~ + +This method is particularly useful for longer content or multiple paragraphs. +{%/* end */%} +``` + +Both methods support the same parameters (`type`, `icon`, and `title`), with the content either passed as the `text` parameter or as the body between tags. + ### Multilingual quotes This shortcode allows you to display both the translated and original text for a quote. The quotation marks will be added automatically: -{{ multilingual_quote(original="Qué sosiego, ir por la vida en silencio, saludando sólo a los amigos.", translated="What tranquility, to go through life in silence, greeting only friends.", author="Francisco Umbral") }} +{{ multilingual_quote(original="Qué sosiego, ir por la vida en silencio, saludando sólo a los amigos.", translated="What tranquillity, to go through life in silence, greeting only friends.", author="Francisco Umbral") }} #### Usage ``` -{{/* multilingual_quote(original="Qué sosiego, ir por la vida en silencio, saludando sólo a los amigos.", translated="What tranquility, to go through life in silence, greeting only friends.", author="Francisco Umbral") */}} +{{/* multilingual_quote(original="Qué sosiego, ir por la vida en silencio, saludando sólo a los amigos.", translated="What tranquillity, to go through life in silence, greeting only friends.", author="Francisco Umbral") */}} ``` ### References with hanging indent @@ -350,3 +454,33 @@ Markdown will of course be rendered. {%/* end */%} ``` + +### Force text direction + +Force the text direction of a content block. Overrides both the global `force_codeblock_ltr` setting and the document's overall direction. + +Accepts the parameter `direction`: the desired text direction. This can be either "ltr" (left-to-right) or "rtl" (right-to-left). Defaults to "ltr". + +{% force_text_direction(direction="rtl") %} + +```python +def مرحبا_بالعالم(): + print("مرحبا بالعالم!") +``` + +{% end %} + +#### Usage + +In a LTR page we can force a code block to be RTL (as shown above) like so: + +```` +{%/* force_text_direction(direction="rtl") */%} + +```python +def مرحبا_بالعالم(): + print("مرحبا بالعالم!") +``` + +{%/* end */%} +```` diff --git a/content/social_cards/ca.jpg b/content/ca.jpg similarity index 100% rename from content/social_cards/ca.jpg rename to content/ca.jpg diff --git a/content/social_cards/es.jpg b/content/es.jpg similarity index 100% rename from content/social_cards/es.jpg rename to content/es.jpg diff --git a/content/social_cards/index.jpg b/content/index.jpg similarity index 100% rename from content/social_cards/index.jpg rename to content/index.jpg diff --git a/content/pages/_index.ar.md b/content/pages/_index.ar.md new file mode 100644 index 0000000..704bbde --- /dev/null +++ b/content/pages/_index.ar.md @@ -0,0 +1,7 @@ ++++ +render = false +insert_anchor_links = "right" + +[extra] +hide_from_feed = true ++++ diff --git a/content/pages/about/index.ar.md b/content/pages/about/index.ar.md new file mode 100644 index 0000000..3c87d48 --- /dev/null +++ b/content/pages/about/index.ar.md @@ -0,0 +1,40 @@ ++++ +title = "عني" +template = "info-page.html" +path = "/ar/about" + +[extra] +quick_navigation_buttons = true +social_media_card = "social_cards/about.ar.jpg" ++++ + +مرحبًا بكم في العرض التقديمي ل[**تابي**]، وهو قالب لـ[Zola]، مولد المواقع الثابتة السريع. + +**تابي** هو من ابتكار أوسكار فرنانديز ([welpo] على GitHub)، وقد صُمم في البداية لموقعه الشخصي [osc.garden]. هو قالب بشكل حديث غني بالميزات يوفر إعدادات افتراضية منطقية وآمنة. + +يمكنك العثور على وثائق تشرح طريقة إستخدام **تابي** في [المدونة] و[الأرشيف]، سوف تجد بهم مقالات تشرح القالب وتقدم لك نظرة عامة حوله. + +## الميزات + +يركز **تابي** على الاداء ويدعم [تعدد اللغات] أي انه يمكن لمدونتك دعم أكثر من لغة، ويمكنك [تخصيص مظهرها]، ويمكنك [تفعيل التعليقات بها] أي السماح للأخرين بالتعليق على منشوراتك. و **تابي** لا يجبر مدونتك على إستخدام جافاسكربت، حيث انها [إختيارية] ولكنك سوف تفقد المميزات التي تحتاج إليها. + +## المساهمة + +نحن نقدر المساهمات! نرحب بالتبليغ على الأخطاء، وتحسينات الترجمة أو الوثائق (بغض النظر عن حجمها)، واقتراحات الميزات... تحقق من [إرشادات المساهمة] لمعرفة كيفية المساعدة. شكرًا لك! + +## الترخيص + +الكود متاح بموجب [رخصة MIT]. + +[**تابي**]: https://github.com/welpo/tabi +[Zola]: https://www.getzola.org +[welpo]: https://github.com/welpo +[osc.garden]: https://osc.garden +[المدونة]: https://welpo.github.io/tabi/blog +[الأرشيف]: https://welpo.github.io/tabi/archive +[تعدد اللغات]: https://welpo.github.io/tabi/blog/faq-languages +[تخصيص مظهرها]: https://welpo.github.io/tabi/blog/customise-tabi +[تفعيل التعليقات بها]: https://welpo.github.io/tabi/blog/comments +[إختيارية]: https://welpo.github.io/tabi/blog/javascript +[إرشادات المساهمة]: https://github.com/welpo/tabi/blob/main/CONTRIBUTING.md +[رخصة MIT]: https://choosealicense.com/licenses/mit diff --git a/content/pages/about/index.ca.md b/content/pages/about/index.ca.md index 503fa84..4ecb30e 100644 --- a/content/pages/about/index.ca.md +++ b/content/pages/about/index.ca.md @@ -5,7 +5,6 @@ path = "/ca/about" [extra] quick_navigation_buttons = true -social_media_card = "social_cards/about.ca.jpg" +++ Benvingut a la demo de [**tabi**](https://github.com/welpo/tabi), un tema per a [Zola](https://www.getzola.org/), un generador de llocs web estàtics rapidíssim. diff --git a/content/pages/about/index.es.md b/content/pages/about/index.es.md index 005c336..8f74bef 100644 --- a/content/pages/about/index.es.md +++ b/content/pages/about/index.es.md @@ -5,7 +5,6 @@ path = "/es/about" [extra] quick_navigation_buttons = true -social_media_card = "social_cards/about.es.jpg" +++ Bienvenido a la demo de [**tabi**](https://github.com/welpo/tabi), un tema para [Zola](https://www.getzola.org/), un rapidísimo generador de sitios estáticos. diff --git a/content/pages/about/index.md b/content/pages/about/index.md index fba24f9..5db48c3 100644 --- a/content/pages/about/index.md +++ b/content/pages/about/index.md @@ -5,7 +5,6 @@ path = "about" [extra] quick_navigation_buttons = true -social_media_card = "social_cards/about.jpg" +++ Welcome to the demo of [**tabi**](https://github.com/welpo/tabi), a theme for [Zola](https://www.getzola.org/), a fast static site generator. diff --git a/content/pages/about/social_cards/about.ar.jpg b/content/pages/about/social_cards/about.ar.jpg new file mode 100644 index 0000000..981ba8f Binary files /dev/null and b/content/pages/about/social_cards/about.ar.jpg differ diff --git a/content/pages/about/social_cards/about.ca.jpg b/content/pages/about/social_cards/about.ca.jpg deleted file mode 100644 index 6104cdc..0000000 Binary files a/content/pages/about/social_cards/about.ca.jpg and /dev/null differ diff --git a/content/pages/about/social_cards/about.es.jpg b/content/pages/about/social_cards/about.es.jpg deleted file mode 100644 index 809bd3a..0000000 Binary files a/content/pages/about/social_cards/about.es.jpg and /dev/null differ diff --git a/content/pages/about/social_cards/about.jpg b/content/pages/about/social_cards/about.jpg deleted file mode 100644 index 4117d18..0000000 Binary files a/content/pages/about/social_cards/about.jpg and /dev/null differ diff --git a/content/pages/privacy/index.ar.md b/content/pages/privacy/index.ar.md new file mode 100644 index 0000000..04450e5 --- /dev/null +++ b/content/pages/privacy/index.ar.md @@ -0,0 +1,95 @@ ++++ +title = "سياسة الخصوصية" +path = "/ar/privacy" +date = 2023-10-31 +updated = 2024-05-12 ++++ + +هذه السياسة توضح كيف نقوم بجمع ومعالجة بياناتك على هذا الموقع. + +{{ toc() }} + +## ما البيانات التي نجمعها؟ + +### التصفح العام {#what-general} + +أثناء تصفح الموقع، لا يتم جمع أي معلومات شخصية. + +### التعليقات {#what-comments} + +نحن لا نجمع أي بيانات عند إرسال تعليق على تدوينة، لكن GitHub يجمع البيانات لتوفير الخدمة، حيث انه يتم توفيرها من خلاله. + +### التحليلات {#what-analytics} + +لتحسين الموقع، يتم جمع البيانات غير الشخصية التالية: + +- **المرجع**: المصدر الذي قادك إلى هذا الموقع. +- **الرابط المطلوب**: الصفحة المحددة التي قمت بزيارتها. +- **وكيل المستخدم**: يحدد المتصفح ونظام التشغيل الذي تستخدمه (مثل "Safari 17.0، Mac OS X"). +- **اسم البلد**: البلد الذي زرت الموقع منه، يتم تحديده بواسطة عنوان IP الخاص بك. +- **حجم الشاشة**: أبعاد شاشة جهازك. +- **الوقت**: الوقت الذي وصلت فيه إلى الموقع. +- **جلسة التصفح**: رمز تعريف مؤقت يتم إنشاؤه من عنوان IP الخاص بك، ومعلومات المتصفح، ورقم عشوائي. يُستخدم هذا للتعرف على جلسة التصفح لمدة 8 ساعات. بعد ذلك، يتم حذف الرمز من الذاكرة ولا يُخزن في أي مكان. + +نحن لا نتتبع الزوار عبر الجلسات، ولا نتتبع مدة بقائك في الموقع أو أين تذهب بعد مغادرتك. + +## كيف نجمع هذه البيانات؟ + +### التعليقات {#how-comments} + +يتم جمع البيانات المرتبطة بالتعليقات باستخدام [Giscus](https://giscus.app/)، وهي منصة تمكن من إضافة التعليقات، المبنية على GitHub. + +### التحليلات {#how-analytics} + +يتم جمع البيانات غير الشخصية باستخدام نسخة مستضافة ذاتيًا من [GoatCounter](https://www.goatcounter.com/)، وهي منصة مفتوحة المصدر لتحليلات الويب تركز على الخصوصية. + +## كيف سنستخدم البيانات؟ + +تُستخدم البيانات المرسلة إلى GitHub لعرض تعليقك على الموقع. + +تُستخدم البيانات غير الشخصية لإنشاء إحصائيات حول الموقع، مثل عدد الزوار يوميًا، أو الصفحات والمراجع الأكثر شعبية. تُستخدم هذه البيانات لتحسين هذا الموقع التجريبي وقالب تابي. يمكنك رؤية الإحصائيات الناتجة عن هذه البيانات على [صفحة الإحصائيات العامة](https://tabi-stats.osc.garden/). + +جميع البيانات المجمعة متاحة للجمهور، سواء في شكل تعليقات أو إحصائيات. + +نحن لا نستخدم البيانات لأي غرض آخر. + +## كيف نقوم بتخزين البيانات؟ + +بيانات التعليقات لا تُخزن بواسطة Giscus، كما هو موضح في [سياسة الخصوصية الخاصة بهم](https://github.com/giscus/giscus/blob/main/PRIVACY-POLICY.md#what-data-do-we-collect). يتم تخزين البيانات على خوادم GitHub. راجع [سياسة الخصوصية الخاصة بGitHub](https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement). + +يتم تخزين بيانات التحليلات على خادم مستضاف بواسطة [Vultr](https://www.vultr.com/). يقع الخادم في باريس، فرنسا. + +## كم من الوقت سنقوم بتخزين البيانات؟ + +تُخزن التعليقات إلى أجل غير مسمى، أو حتى تطلب حذفها. + +تُخزن باقي البيانات إلى أجل غير مسمى. + +## ما هي حقوقك في حماية البيانات؟ + +اعتمادًا على المعالجة والأساس القانوني، هناك عدد من الخيارات المتاحة لك للحفاظ على السيطرة على بياناتك الشخصية: + +- حق الوصول إلى بياناتك +- حق تعديل بياناتك +- حق الاعتراض على معالجة بياناتك الشخصية +- حق تقييد معالجة بياناتك +- حق حذف بياناتك +- حق سحب موافقتك + +إذا قدمت طلبًا، لدينا شهر واحد للرد عليك. إذا كنت ترغب في ممارسة أي من هذه الحقوق، يرجى الاتصال بنا باستخدام أيقونة البريد الإلكتروني في تذييل الموقع. + +## الكوكيز + +الموقع لا يستخدم الكوكيز. + +## سياسات الخصوصية لمواقع أخرى + +يحتوي هذا الموقع على روابط لمواقع أخرى. تنطبق سياسة الخصوصية هذه فقط على هذا الموقع، لذا إذا قمت بالنقر على رابط لموقع آخر، يجب عليك قراءة سياسة الخصوصية الخاصة بهم. + +## التغييرات على سياسة الخصوصية + +نحن نراجع هذه السياسة بانتظام ونضع أي تحديثات على هذه الصفحة. يمكنك التحقق من تاريخ تحديث هذه السياسة، بالإضافة إلى سجل التغييرات تحت عنوان الصفحة. + +## كيف تتواصل معنا + +إذا كانت لديك أي أسئلة حول سياسة الخصوصية هذه، أو البيانات التي نحتفظ بها عنك، أو إذا كنت ترغب في ممارسة أحد حقوق حماية البيانات الخاصة بك، فلا تتردد في الاتصال بنا باستخدام أيقونة البريد الإلكتروني في تذييل الموقع. \ No newline at end of file diff --git a/content/projects/_index.ar.md b/content/projects/_index.ar.md new file mode 100644 index 0000000..d351532 --- /dev/null +++ b/content/projects/_index.ar.md @@ -0,0 +1,10 @@ ++++ +title = "مشاريعي" +sort_by = "weight" +template = "cards.html" +insert_anchor_links = "right" + +[extra] +show_reading_time = false +quick_navigation_buttons = true ++++ diff --git a/content/projects/_index.ca.md b/content/projects/_index.ca.md index 5b65f16..b454ba3 100644 --- a/content/projects/_index.ca.md +++ b/content/projects/_index.ca.md @@ -5,7 +5,7 @@ template = "cards.html" insert_anchor_links = "left" [extra] -social_media_card = "projects/social_cards/ca_projects.jpg" +social_media_card = "projects/ca_projects.jpg" show_reading_time = false quick_navigation_buttons = true +++ diff --git a/content/projects/_index.es.md b/content/projects/_index.es.md index 196a3cd..93ab3fd 100644 --- a/content/projects/_index.es.md +++ b/content/projects/_index.es.md @@ -5,7 +5,7 @@ template = "cards.html" insert_anchor_links = "left" [extra] -social_media_card = "projects/social_cards/es_projects.jpg" +social_media_card = "projects/es_projects.jpg" show_reading_time = false quick_navigation_buttons = true +++ diff --git a/content/projects/_index.md b/content/projects/_index.md index e9130d9..e07ac64 100644 --- a/content/projects/_index.md +++ b/content/projects/_index.md @@ -5,7 +5,8 @@ template = "cards.html" insert_anchor_links = "left" [extra] -social_media_card = "projects/social_cards/projects.jpg" +social_media_card = "projects/projects.jpg" show_reading_time = false quick_navigation_buttons = true +iine_icon = 'heart' +++ diff --git a/content/projects/social_cards/ca_projects.jpg b/content/projects/ca_projects.jpg similarity index 100% rename from content/projects/social_cards/ca_projects.jpg rename to content/projects/ca_projects.jpg diff --git a/content/projects/doteki/doteki_logo.png b/content/projects/doteki/doteki_logo.png deleted file mode 100644 index ebef2ce..0000000 Binary files a/content/projects/doteki/doteki_logo.png and /dev/null differ diff --git a/content/projects/doteki/doteki_logo.webp b/content/projects/doteki/doteki_logo.webp index c48c54c..ee76f41 100644 Binary files a/content/projects/doteki/doteki_logo.webp and b/content/projects/doteki/doteki_logo.webp differ diff --git a/content/projects/doteki/index.ca.md b/content/projects/doteki/index.ca.md index 761a597..6a318cb 100644 --- a/content/projects/doteki/index.ca.md +++ b/content/projects/doteki/index.ca.md @@ -3,33 +3,58 @@ title = "dōteki" description = "Afegeix contingut dinàmic al teu perfil de GitHub amb un sistema intuïtiu de plugins." weight = 30 +[taxonomies] +tags = ["GitHub Actions", "automatització", "Python"] + [extra] local_image = "projects/doteki/doteki_logo.webp" social_media_card = "social_cards/projects_doteki.jpg" canonical_url = "https://osc.garden/ca/projects/doteki/" +++ -[**dōteki**](https://doteki.org/) és una eina dissenyada per donar vida als perfils de GitHub afegint contingut dinàmic de manera senzilla. Amb un arxiu de configuració TOML intuïtiu i un sistema de plugins versàtil, **dōteki** permet als usuaris mostrar contingut recent i automatitzat directament als seus perfils de GitHub. +**dōteki** actualitza el teu perfil de GitHub automàticament. Afegeix les teves últimes publicacions del blog, la música que escoltes o qualsevol altre contingut dinàmic mitjançant plugins. ![logo de dōteki: un riu passant per un bosc de bambú](https://cdn.jsdelivr.net/gh/welpo/doteki@main/website/static/img/logo.png) #### [GitHub](https://github.com/welpo/doteki) • [Lloc web](https://doteki.org/) • [Documentació](https://doteki.org/docs/) {.centered-text} -## Per què dōteki? +## Com funciona -**dōteki** destaca per la seva simplicitat i potència. És altament personalitzable i extensible, i està dissenyat per ser fàcil de configurar i utilitzar. +1. Afegeix marcadors al teu README: -## Característiques clau +```md,name=README.md + + +``` -- **Plug-and-Play**: Afegeix marcadors al teu README i utilitza un arxiu TOML per incorporar seccions de contingut dinàmic al teu perfil de GitHub. -- **Sistema de plugins extensible**: Des de mostrar les últimes publicacions del teu blog fins a compartir la música que has estat escoltant, el sistema de plugins permet infinites possibilitats. No trobes un plugin que s'ajusti a les teves necessitats? [Crea el teu propi](https://doteki.org/docs/developer-guide/plugin-standard)! -- [**Documentació exhaustiva**](https://doteki.org/docs/) amb informació detallada sobre com configurar i utilitzar **dōteki** i els seus plugins. Inclou [instruccions clares per als desenvolupadors](https://doteki.org/docs/developer-guide/) que vulguin contribuir al projecte. -- **Preparat per a l'automatització**: Utilitza l'[Acció de GitHub](https://github.com/welpo/doteki-action) per mantenir el teu perfil sempre actualitzat. +2. Configura què hi va: -## Refresca el teu perfil de GitHub +```toml,name=doteki.toml +[sections.blog] +plugin = "feed" +url = "https://osc.garden/atom.xml" # Substitueix amb el teu feed. -Aprofita les capacitats dinàmiques de **dōteki** i transforma el teu perfil de GitHub en un aparador del teu treball més recent, pensaments i interessos. +[sections.last_updated] +plugin = "current_date" +inline = true +``` -[Configura **dōteki** en menys de 5 minuts](https://doteki.org/) i dóna vida al teu perfil de GitHub. +3. Configura l'[Acció de GitHub](https://github.com/welpo/doteki-action). -[![targeta de xarxes socials de dōteki](social_cards/projects_doteki.jpg)](https://doteki.org/) +Això és tot! El teu README s'actualitzarà automàticament. + +## Característiques + +- **Sistema de plugins**: Mostra [entrades del blog](https://doteki.org/docs/plugins/feed), [música](https://doteki.org/docs/plugins/lastfm), o [crea el teu propi plugin](https://doteki.org/docs/developer-guide/plugin-standard) +- **Configuració simple**: Un arxiu TOML, una Acció de GitHub +- **Flexible**: Cada plugin té les seves pròpies opcions (ordre, entrades màximes, format…) +- **[Documentació detallada](https://doteki.org/docs/)**: Informació detallada sobre com configurar i utilitzar **dōteki** i els seus plugins. Inclou [instruccions clares per als desenvolupadors](https://doteki.org/docs/developer-guide/) que vulguin contribuir. + +## Documentació + +Consulta la [documentació](https://doteki.org/docs/) per a: + +- [Guia d'inici](https://doteki.org/docs/) +- [Plugins disponibles](https://doteki.org/docs/category/plugins) +- [Desenvolupament de plugins](https://doteki.org/docs/developer-guide/) +- [Opcions de configuració](https://doteki.org/docs/configuration/) diff --git a/content/projects/doteki/index.es.md b/content/projects/doteki/index.es.md index 4e50e6c..93e5159 100644 --- a/content/projects/doteki/index.es.md +++ b/content/projects/doteki/index.es.md @@ -3,33 +3,58 @@ title = "dōteki" description = "Añade contenido dinámico a tu perfil de GitHub con un sistema intuitivo de plugins." weight = 30 +[taxonomies] +tags = ["GitHub Actions", "automatización", "Python"] + [extra] local_image = "projects/doteki/doteki_logo.webp" social_media_card = "social_cards/projects_doteki.jpg" canonical_url = "https://osc.garden/es/projects/doteki/" +++ -[**dōteki**](https://doteki.org/) es una herramienta diseñada para dar vida a los perfiles de GitHub añadiendo contenido dinámico de manera sencilla. Con un archivo de configuración TOML intuitivo y un versátil sistema de plugins, **dōteki** permite a los usuarios mostrar contenido reciente y automatizado directamente en sus perfiles de GitHub. +**dōteki** actualiza tu perfil de GitHub automáticamente. Añade tus últimas publicaciones del blog, la música que escuchas o cualquier otro contenido dinámico mediante plugins. ![logo de dōteki: un río pasando por un bosque de bambú](https://cdn.jsdelivr.net/gh/welpo/doteki@main/website/static/img/logo.png) #### [GitHub](https://github.com/welpo/doteki) • [Sitio web](https://doteki.org/) • [Documentación](https://doteki.org/docs/) {.centered-text} -## ¿Por qué dōteki? +## Cómo funciona -**dōteki** destaca por su simplicidad y potencia. Permite mostrar tu trabajo, intereses y personalidad en tu perfil de GitHub, siempre al día. Es altamente personalizable y extensible, y está diseñado para ser fácil de configurar y usar. +1. Añade marcadores a tu README: -## Características clave +```md,name=README.md + + +``` -- **Plug-and-Play**: Añade marcadores a tu README y utiliza un archivo TOML para incorporar secciones de contenido dinámico en tu perfil de GitHub. -- **Sistema de plugins extensible**: Desde mostrar las últimas publicaciones de tu blog hasta compartir la música que has estado escuchando, el sistema de plugins permite infinitas posibilidades. ¿No encuentras un plugin que se ajuste a tus necesidades? ¡[Crea tu propio plugin](https://doteki.org/docs/developer-guide/plugin-standard)! -- [**Documentación exhaustiva**](https://doteki.org/docs/) con información detallada sobre cómo configurar y usar **dōteki** y sus plugins. Incluye [instrucciones claras para los desarrolladores](https://doteki.org/docs/developer-guide/) que quieran contribuir al proyecto -- **Listo para la automatización**: Utiliza la [Acción de GitHub](https://github.com/welpo/doteki-action) para mantener tu perfil siempre actualizado. +2. Configura qué va ahí: -## Refresca tu perfil de GitHub +```toml,name=doteki.toml +[sections.blog] +plugin = "feed" +url = "https://osc.garden/atom.xml" # Reemplaza con tu feed. -Aprovecha las capacidades dinámicas de **dōteki** y transforma tu perfil de GitHub en un escaparate de tu trabajo más reciente, pensamientos e intereses. +[sections.last_updated] +plugin = "current_date" +inline = true +``` -[Configura **dōteki** en menos de 5 minutos](https://doteki.org/) y da vida a tu perfil de GitHub. +3. Configura la [Acción de GitHub](https://github.com/welpo/doteki-action). -[![tarjeta de redes sociales de dōteki](social_cards/projects_doteki.jpg)](https://doteki.org/) +¡Eso es todo! Tu README se actualizará automáticamente. + +## Características + +- **Sistema de plugins**: Muestra [entradas del blog](https://doteki.org/docs/plugins/feed), [música](https://doteki.org/docs/plugins/lastfm), o [crea tu propio plugin](https://doteki.org/docs/developer-guide/plugin-standard) +- **Configuración simple**: Un archivo TOML, una Acción de GitHub +- **Flexible**: Cada plugin tiene sus propias opciones (orden, entradas máximas, formato…) +- **[Documentación detallada](https://doteki.org/docs/)**: Información detallada sobre cómo configurar y usar **dōteki** y sus plugins. Incluye [instrucciones claras para los desarrolladores](https://doteki.org/docs/developer-guide/) que quieran contribuir. + +## Documentación + +Consulta la [documentación](https://doteki.org/docs/) para: + +- [Guía de inicio rápido](https://doteki.org/docs/) +- [Plugins disponibles](https://doteki.org/docs/category/plugins) +- [Desarrollo de plugins](https://doteki.org/docs/developer-guide/) +- [Opciones de configuración](https://doteki.org/docs/configuration/) diff --git a/content/projects/doteki/index.md b/content/projects/doteki/index.md index e8e9fec..067bf76 100644 --- a/content/projects/doteki/index.md +++ b/content/projects/doteki/index.md @@ -3,33 +3,58 @@ title = "dōteki" description = "Add dynamic content to your GitHub profile through an intuitive plugin system." weight = 30 +[taxonomies] +tags = ["GitHub Actions", "automation", "Python"] + [extra] local_image = "projects/doteki/doteki_logo.webp" social_media_card = "social_cards/projects_doteki.jpg" canonical_url = "https://osc.garden/projects/doteki/" +++ -[**dōteki**](https://doteki.org/) is a tool designed to breathe life into GitHub profiles by adding dynamic content effortlessly. By leveraging an intuitive TOML configuration file along with a versatile plugin system, **dōteki** empowers users to showcase fresh, automated content directly on their GitHub profiles. +**dōteki** updates your GitHub profile README automatically. Add your latest blog posts, music you're listening to, or any other dynamic content using plugins. ![doteki logo: a river passing through a bamboo forest](https://cdn.jsdelivr.net/gh/welpo/doteki@main/website/static/img/logo.png) #### [GitHub](https://github.com/welpo/doteki) • [Website](https://doteki.org/) • [Documentation](https://doteki.org/docs/) {.centered-text} -## Why dōteki? +## How it works -**dōteki** stands out for its simplicity and power, enabling you to dynamically showcase your work, interests and personality on your GitHub profile. It's designed to be easy to set up and use, while also being highly customizable and extensible. +1. Add markers to your README: -## Key Features +```md,name=README.md + + +``` -- **Plug-and-Play**: Add markers to your README and use a TOML file for straightforward setup and easy management of dynamic content sections on your GitHub profile README. -- **Extensible plugin system**: From showcasing your latest blog posts to displaying your favourite music, the plugin system allows for endless possibilities. Can't find a plugin that suits your needs? [Create your own](https://doteki.org/docs/developer-guide/plugin-standard)! -- **Extensive documentation**: The [comprehensive documentation](https://doteki.org/docs/) provides detailed information on how to set up and use **dōteki** and its plugins. It includes [clear instructions for developers](https://doteki.org/docs/developer-guide/) looking to contribute. -- **Automation Ready**: Use the [GitHub Action](https://github.com/welpo/doteki-action) to keep your profile always up to date. +2. Configure what goes there: -## Enhance Your GitHub Profile Today +```toml,name=doteki.toml +[sections.blog] +plugin = "feed" +url = "https://osc.garden/atom.xml" # Replace with your feed. -Embrace the dynamic capabilities of **dōteki** and transform your GitHub profile into a vibrant showcase of your latest work, thoughts, and interests. +[sections.last_updated] +plugin = "current_date" +inline = true +``` -[Set up **dōteki** in less than 5 minutes](https://doteki.org/) and bring your GitHub profile to life. +3. Set up the [GitHub Action](https://github.com/welpo/doteki-action). -[![dōteki social media card](social_cards/projects_doteki.jpg)](https://doteki.org/) +That's it! Your README will stay updated automatically. + +## Features + +- **Plugin system**: Show [blog posts](https://doteki.org/docs/plugins/feed), [music](https://doteki.org/docs/plugins/lastfm), or [build your own plugin](https://doteki.org/docs/developer-guide/plugin-standard) +- **Simple setup**: One TOML file, one GitHub Action +- **Flexible**: Each plugin has its own options (sort order, max entries, format…) +- **[Extensive documentation](https://doteki.org/docs/)**: Detailed information on how to set up and use **dōteki** and its plugins. It includes [clear instructions for developers](https://doteki.org/docs/developer-guide/) looking to contribute. + +## Documentation + +Check the [docs](https://doteki.org/docs/) for: + +- [Getting started guide](https://doteki.org/docs/) +- [Available plugins](https://doteki.org/docs/category/plugins) +- [Plugin development](https://doteki.org/docs/developer-guide/) +- [Configuration options](https://doteki.org/docs/configuration/) diff --git a/content/projects/social_cards/es_projects.jpg b/content/projects/es_projects.jpg similarity index 100% rename from content/projects/social_cards/es_projects.jpg rename to content/projects/es_projects.jpg diff --git a/content/projects/git-sumi/git-sumi_logo.png b/content/projects/git-sumi/git-sumi_logo.png deleted file mode 100644 index 450d71b..0000000 Binary files a/content/projects/git-sumi/git-sumi_logo.png and /dev/null differ diff --git a/content/projects/git-sumi/git-sumi_logo.webp b/content/projects/git-sumi/git-sumi_logo.webp index d5d3ae8..90fd11b 100644 Binary files a/content/projects/git-sumi/git-sumi_logo.webp and b/content/projects/git-sumi/git-sumi_logo.webp differ diff --git a/content/projects/git-sumi/index.ca.md b/content/projects/git-sumi/index.ca.md index 8d6b4ad..cdee76e 100644 --- a/content/projects/git-sumi/index.ca.md +++ b/content/projects/git-sumi/index.ca.md @@ -3,13 +3,16 @@ title = "git-sumi" description = "El linter de missatges de commit no opinat basat en Rust." weight = 10 +[taxonomies] +tags = ["Git", "Rust", "Continuous Integration", "GitHub Actions", "CLI", "automatització"] + [extra] local_image = "projects/git-sumi/git-sumi_logo.webp" social_media_card = "social_cards/projects_git-sumi.jpg" canonical_url = "https://osc.garden/ca/projects/git-sumi/" +++ -**git-sumi** és un linter de missatges de commit no opinat escrit en Rust. És una eina flexible per complir els teus estàndards de missatges de commit, facilitant missatges consistents i fàcilment automatitzables. +**git-sumi** és el linter de missatges de commit no opinat escrit en Rust. {% wide_container() %} @@ -19,21 +22,12 @@ canonical_url = "https://osc.garden/ca/projects/git-sumi/" ## Característiques principals -- **Regles personalitzables**: Configura git-**sumi** per satisfer els requisits específics de cada projecte. Configura regles per a Conventional Commits, límits de longitud, ús de Gitmoji i més a través d'un senzill arxiu de configuració TOML. -- **Informe d'errors clar**: Proporciona un informe d'errors detallat, fent que la correcció sigui senzilla i educativa. -- **Integració sense fissures**: Sent un únic binari, git-**sumi** s'integra fàcilment en el teu flux de treball. Fins i tot pots utilitzar l'[Acció de GitHub](https://github.com/welpo/git-sumi-action) per validar els teus commits (o títols de PR) sense necessitat d'instal·lar res localment. +- **Regles personalitzables**: Configura regles per a Conventional Commits, límits de longitud, ús de [Gitmoji](https://gitmoji.dev/) i [més](https://sumi.rs/docs/rules). +- **Informe d'errors clar**: Proporciona errors detallats, fent que la correcció sigui senzilla i educativa. +- **Integració senzilla**: Com a binari únic, git-sumi s'integra fàcilment al teu flux de treball. També pots fer servir l'[Acció de GitHub](https://github.com/welpo/git-sumi-action) per validar commits (o títols de PR) sense instal·lar res. ## Bones pràctiques de desenvolupament -- **Ampla cobertura del codi**: Més del 95% de cobertura de línies i una cobertura de característiques exhaustiva garanteixen la robustesa de git-**sumi**. -- **Integració [contínua](https://github.com/welpo/git-sumi/blob/main/.github/workflows/ci.yml) i [publicació](https://github.com/welpo/git-sumi/blob/main/.github/workflows/release.yml)**: Fluxos de treball automatitzats per provar, integrar i publicar asseguren que cada versió de git-**sumi** estigui completament provada i llesta per al seu ús. -- **Contribucions de la comunitat**: Fomenta les contribucions de la comunitat de tot tipus, amb un enfocament acollidor tant per als nouvinguts com per als desenvolupadors experimentats. -- [**Documentació exhaustiva**](https://sumi.rs/docs/) per començar amb git-**sumi** i comprendre les seves característiques i capacitats. - -## Comença a millorar les teves pràctiques de commit avui - -Fes el primer pas cap a la transformació de les teves pràctiques de commit. La combinació de flexibilitat, retroalimentació detallada i fàcil integració de git-**sumi** el converteix en l'opció perfecta per a equips i individus que busquen millorar els seus missatges de commit. - -[Descobreix **git-sumi**](https://sumi.rs/) i fes-lo part del teu kit d'eines de desenvolupament. - -[![targeta de xarxes socials de git-sumi](social_cards/projects_git-sumi.jpg)](https://sumi.rs/) +- **Cobertura de codi**: 98% de cobertura en tests; un linter ha de ser fiable. +- **[Integració](https://github.com/welpo/git-sumi/blob/main/.github/workflows/ci.yml) i [publicació](https://github.com/welpo/git-sumi/blob/main/.github/workflows/release.yml) contínua**: Fluxos automatitzats per a testing i publicació de binaris multiplataforma a crates.io, PyPI i GitHub releases. +- **Documentació**: [Documentació completa](https://sumi.rs/docs/) amb [guia ràpida](https://sumi.rs/docs/), [exemples](https://sumi.rs/docs/examples), [regles](https://sumi.rs/docs/rules), [integració](https://sumi.rs/docs/integration), [FAQ](https://sumi.rs/docs/faq)... diff --git a/content/projects/git-sumi/index.es.md b/content/projects/git-sumi/index.es.md index 0f8df7d..5830eee 100644 --- a/content/projects/git-sumi/index.es.md +++ b/content/projects/git-sumi/index.es.md @@ -3,13 +3,16 @@ title = "git-sumi" description = "El linter de mensajes de commit no opinado basado en Rust." weight = 10 +[taxonomies] +tags = ["Git", "Rust", "Continuous Integration", "GitHub Actions", "CLI", "automatización"] + [extra] local_image = "projects/git-sumi/git-sumi_logo.webp" social_media_card = "social_cards/projects_git-sumi.jpg" canonical_url = "https://osc.garden/es/projects/git-sumi/" +++ -**git-sumi** es un linter de mensajes de commit no opinado escrito en Rust. Es una herramienta flexible para cumplir tus estándares de mensajes de commit, facilitando mensajes consistentes y fácilmente automatizables. +**git-sumi** es el linter de mensajes de commit no opinado escrito en Rust. {% wide_container() %} @@ -19,21 +22,12 @@ canonical_url = "https://osc.garden/es/projects/git-sumi/" ## Características principales -- **Reglas personalizables**: Configura git-**sumi** para satisfacer los requisitos específicos de cada proyecto. Configura reglas para Conventional Commits, límites de longitud, uso de Gitmoji y más a través de un archivo de un sencillo archivo de configuración TOML. -- **Reporte de errores claro**: Proporciona un reporte de errores detallado, haciendo que la corrección sea sencilla y educativa. -- **Integración sin fisuras**: Al ser único binario, git-**sumi** se integra fácilmente en tu flujo de trabajo. Incluso puedes usar la [Acción de GitHub](https://github.com/welpo/git-sumi-action) para validar tus commits (o títulos de PR) sin necesidad de instalar nada localmente. +- **Reglas personalizables**: Configura reglas para [Conventional Commits](https://www.conventionalcommits.org/), límites de longitud, uso de [Gitmoji](https://gitmoji.dev/) y [más](https://sumi.rs/docs/rules). +- **Reporte de errores claro**: Proporciona errores detallados, haciendo que la corrección sea sencilla y educativa. +- **Integración sencilla**: Al ser único binario, git-sumi se integra fácilmente en tu flujo de trabajo. Puedes usar la [Acción de GitHub](https://github.com/welpo/git-sumi-action) para validar commits (o títulos de PR) sin instalar nada. ## Buenas prácticas de desarrollo -- **Amplia cobertura del código**: Más del 95% de cobertura de líneas y una cobertura de características exhaustiva garantizan la robustez de git-**sumi**. -- **Integración [continua](https://github.com/welpo/git-sumi/blob/main/.github/workflows/ci.yml) y [publicación](https://github.com/welpo/git-sumi/blob/main/.github/workflows/release.yml)**: Flujos de trabajo automatizados para probar, integrar y publicar aseguran que cada versión de git-**sumi** esté completamente probada y lista para su uso. -- **Contribuciones de la comunidad**: Fomenta las contribuciones de la comunidad de todo tipo, con un enfoque acogedor tanto para los recién llegados como para los desarrolladores experimentados. -- [**Documentación exhaustiva**](https://sumi.rs/docs/) para empezar con git-**sumi** y comprender sus características y capacidades. - -## Empieza a mejorar tus prácticas de commit hoy - -Da el primer paso hacia la transformación de tus prácticas de commit. La combinación de flexibilidad, retroalimentación detallada y fácil integración de git-**sumi** lo convierte en la opción perfecta para equipos e individuos que buscan mejorar sus mensajes de commit. - -[Descubre **git-sumi**](https://sumi.rs/) y hazlo parte de tu kit de herramientas de desarrollo. - -[![tarjeta de redes sociales de git-sumi](social_cards/projects_git-sumi.jpg)](https://sumi.rs/) +- **Cobertura de código**: 98% de cobertura de código; un linter debe ser robusto. +- **[Integración](https://github.com/welpo/git-sumi/blob/main/.github/workflows/ci.yml) y [publicación](https://github.com/welpo/git-sumi/blob/main/.github/workflows/release.yml) continua**: Flujos automatizados para testing y publicación de binarios multiplataforma en crates.io, PyPI y GitHub releases. +- **Documentación**: [Documentación completa](https://sumi.rs/docs/) con [guía rápida](https://sumi.rs/docs/), [ejemplos](https://sumi.rs/docs/examples), [reglas](https://sumi.rs/docs/rules), [integración](https://sumi.rs/docs/integration), [FAQ](https://sumi.rs/docs/faq)... diff --git a/content/projects/git-sumi/index.md b/content/projects/git-sumi/index.md index f2cfb74..0cb59b8 100644 --- a/content/projects/git-sumi/index.md +++ b/content/projects/git-sumi/index.md @@ -3,13 +3,16 @@ title = "git-sumi" description = "The non-opinionated Rust-based commit message linter." weight = 10 +[taxonomies] +tags = ["Git", "Rust", "Continuous Integration", "GitHub Actions", "CLI", "automation"] + [extra] local_image = "projects/git-sumi/git-sumi_logo.webp" social_media_card = "social_cards/projects_git-sumi.jpg" canonical_url = "https://osc.garden/projects/git-sumi/" +++ -**git-sumi** is a non-opinionated commit message linter written in Rust. It's a flexible tool to enforce commit message standards, ensuring consistent and automation-friendly commit messages. +**git-sumi** is the non-opinionated commit message linter written in Rust. {% wide_container() %} @@ -17,23 +20,14 @@ canonical_url = "https://osc.garden/projects/git-sumi/" #### [GitHub](https://github.com/welpo/git-sumi) • [Website](https://sumi.rs/) • [Documentation](https://sumi.rs/docs/) {.centered-text} -## Main Features +## Main features -- **Customizable rules**: Tailor git-sumi to meet the specific requirements of each project. Configure rules to enforce Conventional Commits, length limits, Gitmoji usage, and more through a simple TOML configuration file. +- **Customizable rules**: Configure rules to enforce [Conventional Commits](https://www.conventionalcommits.org/), length limits, [Gitmoji](https://gitmoji.dev/) usage, and [more](https://sumi.rs/docs/rules). - **Clear error reporting**: Provides detailed error reporting, making fixing commit messages straightforward and educational. -- **Seamless integration**: As a single binary, git-sumi integrates easily into your existing workflow with minimal setup. You can even use the [GitHub Action](https://github.com/welpo/git-sumi-action) to lint your commits (or PR titles) without installing anything locally. +- **Seamless integration**: As a single binary, git-sumi easily integrates into your existing workflow with minimal setup. You can even use the [GitHub Action](https://github.com/welpo/git-sumi-action) to lint your commits (or PR titles) without installing anything. -## Development Best Practices +## Development best practices -- **Comprehensive code coverage**: Over 95% line coverage and thorough feature coverage ensures that git-sumi is reliable, robust, and ready for use. -- **Continuous [integration](https://github.com/welpo/git-sumi/blob/main/.github/workflows/ci.yml) and [deployment](https://github.com/welpo/git-sumi/blob/main/.github/workflows/release.yml)**: Automated workflows for testing, releasing, and deploying, ensuring that each version of git-sumi is thoroughly tested and ready for use. -- **Community contributions**: Encourages contributions from the community, including feature requests, bug reports, and enhancements, with a welcoming approach to both newcomers and seasoned developers. -- **Documentation**: [Comprehensive documentation](https://sumi.rs/docs/) to help users get started with git-sumi and understand its features and capabilities. - -## Start Enhancing Your Commit Practices Today - -Take the first step towards transforming your commit practices. git-sumi's blend of flexibility, detailed feedback, and ease of integration makes it the perfect choice for teams and individuals looking to improve their Git commit messages. - -[Discover **git-sumi**](https://sumi.rs/) and make it a part of your development toolkit. - -[![git-sumi social media card](social_cards/projects_git-sumi.jpg)](https://sumi.rs/) +- **Comprehensive code coverage**: 98% test coverage; linting needs to be reliable. +- **Continuous [integration](https://github.com/welpo/git-sumi/blob/main/.github/workflows/ci.yml) and [deployment](https://github.com/welpo/git-sumi/blob/main/.github/workflows/release.yml)**: Automated workflows for testing and releasing cross-compiled binaries to crates.io, PyPI and GitHub releases. +- **Documentation**: [Comprehensive documentation](https://sumi.rs/docs/) with a [quick start guide](https://sumi.rs/docs/), [examples](https://sumi.rs/docs/examples), [rules](https://sumi.rs/docs/rules), [integration](https://sumi.rs/docs/integration), [FAQ](https://sumi.rs/docs/faq)… diff --git a/content/projects/iine/iine_logo.webp b/content/projects/iine/iine_logo.webp new file mode 100644 index 0000000..f6681dd Binary files /dev/null and b/content/projects/iine/iine_logo.webp differ diff --git a/content/projects/iine/index.ca.md b/content/projects/iine/index.ca.md new file mode 100644 index 0000000..28b7f90 --- /dev/null +++ b/content/projects/iine/index.ca.md @@ -0,0 +1,52 @@ ++++ +title = "iine" +description = "Botons d'apreciació centrats en la privadesa i accessibles per a la web petita/independent." +weight = 15 + +[taxonomies] +tags = ["web", "JavaScript", "privadesa", "backend"] + +[extra] +local_image = "projects/iine/iine_logo.webp" +social_media_card = "social_cards/projects_iine.jpg" +canonical_url = "https://osc.garden/projects/iine/" ++++ + +Botons d'apreciació per al teu blog, jardí digital, portafoli… No cal compte. Sense seguiment. + +#### [GitHub](https://github.com/welpo/iine) • [Web](https://iine.to) {.centered-text} + +## Característiques + +- Sense marques de temps, sense IPs, sense seguiment +- ~3KB de JavaScript vanilla +- Funciona sense JavaScript +- Diverses icones: cor, polze amunt, vot positiu, o qualsevol emoji +- Construït per a la web petita/independent +- Gratuït per sempre +- Accessible per disseny +- Auto-hostejable + +## Inici ràpid + +Afegeix botons d'apreciació al teu lloc amb dues línies. Carrega l'script: + +```html + +``` + +Afegeix el botó: + +```html + +``` + +Fet. Els teus visitants ja poden mostrar apreciació anònima pel teu contingut. + +## Per què iine? + +Volia afegir botons de m'agrada/felicitacions/alegria/apreciació al [meu blog](https://osc.garden) sense registrar-me a res, i assegurant-me que els meus visitants no fossin rastrejats. + +Esperant que altres ho trobin útil, vaig fer el servei públic (codi obert) i gratuït per sempre (almenys fins que doni suport a més de 100k llocs web). + +Construït per a blogs, portafolis, jardins digitals, i qualsevol que cregui que la web hauria de ser més humana. diff --git a/content/projects/iine/index.es.md b/content/projects/iine/index.es.md new file mode 100644 index 0000000..5396832 --- /dev/null +++ b/content/projects/iine/index.es.md @@ -0,0 +1,52 @@ ++++ +title = "iine" +description = "Botones de apreciación centrados en la privacidad y accesibles para la web pequeña." +weight = 15 + +[taxonomies] +tags = ["web", "JavaScript", "privacidad", "backend"] + +[extra] +local_image = "projects/iine/iine_logo.webp" +social_media_card = "social_cards/projects_iine.jpg" +canonical_url = "https://osc.garden/projects/iine/" ++++ + +Botones de apreciación para tu blog, jardín digital, portafolio… Sin cuenta requerida. Sin seguimiento. + +#### [GitHub](https://github.com/welpo/iine) • [Sitio web](https://iine.to) {.centered-text} + +## Características + +- Sin marcas de tiempo, sin IPs, sin seguimiento +- ~3KB de JavaScript vanilla +- Funciona sin JavaScript +- Varios iconos: corazón, pulgar arriba, voto positivo, o cualquier emoji +- Construido para la web pequeña/independiente +- Gratis para siempre +- Accesible por diseño +- Auto-hosteable + +## Inicio rápido + +Añade botones de apreciación a tu sitio con dos líneas. Carga el script: + +```html + +``` + +Añade el botón: + +```html + +``` + +Listo. Tus visitantes ya pueden mostrar apreciación anónima por tu contenido. + +## ¿Por qué iine? + +Quería añadir botones de me gusta/felicitaciones/alegría/apreciación a [mi blog](https://osc.garden) sin registrarme en nada, y asegurándome de que mis visitantes no fueran rastreados. + +Esperando que otros lo encuentren útil, hice el servicio público (código abierto) y gratis para siempre (al menos hasta que soporte más de 100k sitios web). + +Construido para blogs, portafolios, jardines digitales, y cualquiera que crea que la web debería ser más humana. diff --git a/content/projects/iine/index.md b/content/projects/iine/index.md new file mode 100644 index 0000000..557310f --- /dev/null +++ b/content/projects/iine/index.md @@ -0,0 +1,52 @@ ++++ +title = "iine" +description = "Privacy-focused & accessible like buttons for the small web." +weight = 15 + +[taxonomies] +tags = ["web", "JavaScript", "privacy", "backend"] + +[extra] +local_image = "projects/iine/iine_logo.webp" +social_media_card = "social_cards/projects_iine.jpg" +canonical_url = "https://osc.garden/projects/iine/" ++++ + +Appreciation buttons for your blog, digital garden, portfolio… No account required. No tracking. + +#### [GitHub](https://github.com/welpo/iine) • [Website](https://iine.to) {.centered-text} + +## Features + +- No timestamps, no IPs, no tracking +- ~3KB of vanilla JavaScript +- Works without JavaScript +- Various icons: heart, thumbs up, upvote, or any emoji +- Built for the small/indie web +- Free forever +- Accessible by design +- Self-hostable + +## Quick start + +Add appreciation buttons to your site with two lines. Load the script: + +```html + +``` + +Add the button: + +```html + +``` + +Done. Your visitors can now show anonymous appreciation for your content. + +## Why iine? + +I wanted to add like/kudos/cheers/appreciation buttons to [my blog](https://osc.garden) without signing up for anything, and making sure my visitors weren't tracked. + +Hoping others find it useful, I made the service public (open source) and free forever (at least until it supports over 100k websites). + +Built for blogs, portfolios, digital gardens, and anyone who believes the web should be more human. diff --git a/content/projects/iine/social_cards/projects_iine.jpg b/content/projects/iine/social_cards/projects_iine.jpg new file mode 100644 index 0000000..bdb1d9a Binary files /dev/null and b/content/projects/iine/social_cards/projects_iine.jpg differ diff --git a/content/projects/nani/index.ca.md b/content/projects/nani/index.ca.md index 5bf2375..abd9663 100644 --- a/content/projects/nani/index.ca.md +++ b/content/projects/nani/index.ca.md @@ -3,6 +3,9 @@ title = "nani" description = "Script Bash per crear URLs públiques a partir d'arxius o text en servidors remots." weight = 50 +[taxonomies] +tags = ["bash", "CLI"] + [extra] local_image = "projects/nani/nani_logo.webp" canonical_url = "https://osc.garden/ca/projects/tabi/" diff --git a/content/projects/nani/index.es.md b/content/projects/nani/index.es.md index edf773a..0b338aa 100644 --- a/content/projects/nani/index.es.md +++ b/content/projects/nani/index.es.md @@ -3,6 +3,9 @@ title = "nani" description = "Script Bash para crear URLs públicas a partir de archivos o texto en servidores remotos." weight = 50 +[taxonomies] +tags = ["bash", "CLI"] + [extra] local_image = "projects/nani/nani_logo.webp" canonical_url = "https://osc.garden/es/projects/tabi/" diff --git a/content/projects/nani/index.md b/content/projects/nani/index.md index cab154a..4372312 100644 --- a/content/projects/nani/index.md +++ b/content/projects/nani/index.md @@ -3,6 +3,9 @@ title = "nani" description = "Bash script to create public URLs from files or text on remote servers." weight = 50 +[taxonomies] +tags = ["bash", "CLI"] + [extra] local_image = "projects/nani/nani_logo.webp" canonical_url = "https://osc.garden/projects/tabi/" diff --git a/content/projects/nani/nani_logo.webp b/content/projects/nani/nani_logo.webp index 2f301b1..08d7175 100644 Binary files a/content/projects/nani/nani_logo.webp and b/content/projects/nani/nani_logo.webp differ diff --git a/content/projects/nemui/index.ca.md b/content/projects/nemui/index.ca.md new file mode 100644 index 0000000..5b2e61f --- /dev/null +++ b/content/projects/nemui/index.ca.md @@ -0,0 +1,35 @@ ++++ +title = "nemui" +description = "Ajusta gradualment el teu horari de son amb suport per horari d'estiu." +weight = 22 + +[taxonomies] +tags = ["son", "interactiu", "web app", "web", "JavaScript"] + +[extra] +local_image = "projects/nemui/nemui_logo.webp" +canonical_url = "https://osc.garden/ca/projects/tabi/" +social_media_card = "social_cards/projects_nemui.jpg" ++++ + +nemui és una aplicació web que t'ajuda a fer una transició suau a un nou horari de son. El seu nom ve de les paraules japoneses per dormir (眠nemu) i transició (移i), que es llegeix com 眠いnemui (somnolent). + +#### [Prova-la ara](https://nemui.osc.garden) • [GitHub](https://github.com/welpo/nemui) • [Blog](https://osc.garden/ca/blog/nemui-sleep-schedule-planner/) {.centered-text} + +## Característiques + +- Interfície interactiva de rellotge inspirada en Apple +- Ajust gradual de l'horari de son basat en la ciència del son +- Suport complet per a l'horari d'estiu (DST) +- Exportació a calendari (.ics) amb recordatoris per anar a dormir +- Emmagatzematge local per seguir el teu progrés +- Accessible: compatible amb navegació per teclat i lectors de pantalla + +## Per què nemui? + +A diferència dels canvis bruscos que poden alterar el teu ritme circadià, nemui t'ajuda a ajustar el teu horari de son de manera gradual. És especialment útil per a: + +- Adaptar-te a nous horaris de feina/estudi +- Preparar-te per a canvis de zona horària +- Fer una transició suau durant els canvis d'hora +- Corregir un horari de son desajustat diff --git a/content/projects/nemui/index.es.md b/content/projects/nemui/index.es.md new file mode 100644 index 0000000..6365ad0 --- /dev/null +++ b/content/projects/nemui/index.es.md @@ -0,0 +1,35 @@ ++++ +title = "nemui" +description = "Ajusta gradualmente tu horario de sueño con soporte para horario de verano." +weight = 32 + +[taxonomies] +tags = ["sueño", "interactivo", "web app", "web", "JavaScript"] + +[extra] +local_image = "projects/nemui/nemui_logo.webp" +canonical_url = "https://osc.garden/es/projects/tabi/" +social_media_card = "social_cards/projects_nemui.jpg" ++++ + +nemui es una aplicación web que te ayuda a hacer una transición suave a un nuevo horario de sueño. Su nombre viene de las palabras japonesas para dormir (眠nemu) y transición (移i), que se lee como 眠いnemui (somnoliento). + +#### [Pruébala ahora](https://nemui.osc.garden) • [GitHub](https://github.com/welpo/nemui) • [Blog](https://osc.garden/es/blog/nemui-sleep-schedule-planner/) {.centered-text} + +## Características + +- Interfaz interactiva de reloj inspirada en Apple +- Ajuste gradual del horario de sueño basado en la ciencia del sueño +- Soporte completo para el horario de verano (DST) +- Exportación a calendario (.ics) con recordatorios para dormir +- Almacenamiento local para seguir tu progreso +- Accesible: compatible con navegación por teclado y lectores de pantalla + +## ¿Por qué nemui? + +A diferencia de los cambios bruscos que pueden alterar tu ritmo circadiano, nemui te ayuda a ajustar tu horario de sueño de forma gradual. Es especialmente útil para: + +- Adaptarte a nuevos horarios de trabajo/estudio +- Prepararte para cambios de zona horaria +- Hacer una transición suave durante los cambios de hora +- Corregir un horario de sueño desajustado diff --git a/content/projects/nemui/index.md b/content/projects/nemui/index.md new file mode 100644 index 0000000..f6347cd --- /dev/null +++ b/content/projects/nemui/index.md @@ -0,0 +1,35 @@ ++++ +title = "nemui" +description = "Gradually adjust your sleep schedule with support for DST transitions." +weight = 32 + +[taxonomies] +tags = ["sleep", "interactive", "web app", "web", "JavaScript"] + +[extra] +local_image = "projects/nemui/nemui_logo.webp" +canonical_url = "https://osc.garden/projects/tabi/" +social_media_card = "social_cards/projects_nemui.jpg" ++++ + +nemui is a web app that helps you smoothly transition to a new sleep schedule. Named after the Japanese words for sleep (眠nemu) and transition (移i), reading as 眠いnemui (sleepy). + +#### [Try it now](https://nemui.osc.garden) • [GitHub](https://github.com/welpo/nemui) • [Blog post](https://osc.garden/blog/nemui-sleep-schedule-planner/) {.centered-text} + +## Features + +- Interactive clock interface inspired by Apple +- Gradual sleep schedule adjustment based on sleep science +- Full Daylight Saving Time (DST) support +- Calendar (.ics) export with bedtime reminders +- Local storage for progress tracking +- Accessible: supports keyboard navigation and screen readers + +## Why nemui? + +Unlike abrupt changes that can disrupt your circadian rhythm, nemui helps you adjust your sleep schedule gradually. It's particularly useful for: + +- Adapting to new work/study schedules +- Preparing for timezone changes +- Smoothly transitioning through DST changes +- Fixing a misaligned sleep schedule diff --git a/content/projects/nemui/nemui_logo.webp b/content/projects/nemui/nemui_logo.webp new file mode 100644 index 0000000..454203f Binary files /dev/null and b/content/projects/nemui/nemui_logo.webp differ diff --git a/content/projects/nemui/social_cards/projects_nemui.jpg b/content/projects/nemui/social_cards/projects_nemui.jpg new file mode 100644 index 0000000..d7b6ea0 Binary files /dev/null and b/content/projects/nemui/social_cards/projects_nemui.jpg differ diff --git a/content/projects/social_cards/projects.jpg b/content/projects/projects.jpg similarity index 100% rename from content/projects/social_cards/projects.jpg rename to content/projects/projects.jpg diff --git a/content/projects/ramu/index.ca.md b/content/projects/ramu/index.ca.md new file mode 100644 index 0000000..63ce50e --- /dev/null +++ b/content/projects/ramu/index.ca.md @@ -0,0 +1,34 @@ ++++ +title = "ramu" +description = "Una aplicació web per practicar la lectura i comprensió auditiva de nombres en japonès." +weight = 35 + +[taxonomies] +tags = ["Japonès", "interactiu", "web app", "web", "PWA", "JavaScript"] + +[extra] +local_image = "projects/ramu/ramu_logo.webp" +canonical_url = "https://osc.garden/ca/projects/ramu/" +social_media_card = "social_cards/projects_ramu.jpg" +iine_icon = '🐏' ++++ + +ラraムmu és una aplicació web progressiva per practicar la lectura i comprensió auditiva de nombres en japonès. El nom reflecteix el seu propòsit: aconseguir accès aleatori (RAM; memòria d'accés aleatori) als nombres, en contraposició a una memòria seqüencial (1, 2, 3…). + +{% wide_container() %} + +{% end %} + +#### [Prova-la ara](https://ramu.osc.garden) • [GitHub](https://github.com/welpo/ramu) • [Article](https://osc.garden/ca/blog/ramu-japanese-numbers-practice-web-app/) {.centered-text} + +## Característiques + +- Pràctica amb nombres aràbics (123…) i japonesos (一二三…) +- Dos modes de pràctica: lectura i comprensió auditiva +- Rangs numèrics configurables (des de 0 fins a més de 100.000.000) +- Pràctica de comptadors (個、本、匹…) +- Funciona sense connexió com a aplicació web progressiva +- Control complet per teclat (espai/→ per següent, esc per aturar) +- Compatible amb lectors de pantalla per a la pràctica amb nombres aràbics + +[![targeta social de ramu](social_cards/projects_ramu.jpg)](https://ramu.osc.garden) diff --git a/content/projects/ramu/index.es.md b/content/projects/ramu/index.es.md new file mode 100644 index 0000000..9e0311e --- /dev/null +++ b/content/projects/ramu/index.es.md @@ -0,0 +1,34 @@ ++++ +title = "ramu" +description = "Una aplicación web para practicar la lectura y comprensión auditiva de números en japonés." +weight = 35 + +[taxonomies] +tags = ["Japonés", "interactivo", "web app", "web", "PWA", "JavaScript"] + +[extra] +local_image = "projects/ramu/ramu_logo.webp" +canonical_url = "https://osc.garden/es/projects/ramu/" +social_media_card = "social_cards/projects_ramu.jpg" +iine_icon = '🐏' ++++ + +ラraムmu es una aplicación web progresiva para practicar la lectura y comprensión auditiva de números en japonés. El nombre refleja su propósito: lograr acceso aleatorio (RAM; memoria de acceso aleatorio) a los números, en contraposición a una memoria secuencial (1, 2, 3…). + +{% wide_container() %} + +{% end %} + +#### [Pruébala ahora](https://ramu.osc.garden) • [GitHub](https://github.com/welpo/ramu) • [Artículo](https://osc.garden/es/blog/ramu-japanese-numbers-practice-web-app/) {.centered-text} + +## Características + +- Práctica con números arábigos (123…) y japoneses (一二三…) +- Dos modos de práctica: lectura y comprensión auditiva +- Rangos numéricos configurables (desde 0 hasta más de 100.000.000) +- Práctica de contadores (個、本、匹…) +- Funciona sin conexión como aplicación web progresiva +- Control por teclado (espacio/→ para siguiente, esc para detener) +- Compatible con lectores de pantalla para la práctica con números arábigos + +[![tarjeta social de ramu](social_cards/projects_ramu.jpg)](https://ramu.osc.garden) diff --git a/content/projects/ramu/index.md b/content/projects/ramu/index.md new file mode 100644 index 0000000..8016baf --- /dev/null +++ b/content/projects/ramu/index.md @@ -0,0 +1,34 @@ ++++ +title = "ramu" +description = "A web app to practice reading and listening to Japanese numbers." +weight = 35 + +[taxonomies] +tags = ["Japanese", "interactive", "web app", "web", "PWA", "JavaScript"] + +[extra] +local_image = "projects/ramu/ramu_logo.webp" +canonical_url = "https://osc.garden/projects/ramu/" +social_media_card = "social_cards/projects_ramu.jpg" +iine_icon = '🐏' ++++ + +ラraムmu is a Progressive Web App to practice reading and listening to Japanese numbers. The name reflects its purpose: achieving RAM (Random Access Memory) to numbers, as opposed to sequential memory (1, 2, 3…). + +{% wide_container() %} + +{% end %} + +#### [Try it now](https://ramu.osc.garden) • [GitHub](https://github.com/welpo/ramu) • [Blog post](https://osc.garden/blog/ramu-japanese-numbers-practice-web-app/) {.centered-text} + +## Features + +- Practice with both Arabic (123…) and Japanese (一二三…) numerals +- Two practice modes: reading and listening comprehension +- Configurable number ranges (from 0 to over 100,000,000) +- Counter word practice (個、本、匹…) +- Works offline as a Progressive Web App +- Full keyboard control (space/→ for next, esc to stop) +- Screen reader friendly for Arabic numeral practice + +[![ramu social media card](social_cards/projects_ramu.jpg)](https://ramu.osc.garden) diff --git a/content/projects/ramu/media/ラム_demo.mp4 b/content/projects/ramu/media/ラム_demo.mp4 new file mode 100644 index 0000000..0a96a11 Binary files /dev/null and b/content/projects/ramu/media/ラム_demo.mp4 differ diff --git a/content/projects/ramu/ramu_logo.webp b/content/projects/ramu/ramu_logo.webp new file mode 100644 index 0000000..1eee491 Binary files /dev/null and b/content/projects/ramu/ramu_logo.webp differ diff --git a/content/projects/ramu/social_cards/projects_ramu.jpg b/content/projects/ramu/social_cards/projects_ramu.jpg new file mode 100644 index 0000000..09757fd Binary files /dev/null and b/content/projects/ramu/social_cards/projects_ramu.jpg differ diff --git a/content/projects/shuku/index.ca.md b/content/projects/shuku/index.ca.md new file mode 100644 index 0000000..78230a0 --- /dev/null +++ b/content/projects/shuku/index.ca.md @@ -0,0 +1,48 @@ ++++ +title = "shuku" +description = "Condensa pel·lícules i sèries per quedar-te només amb el diàleg. Dissenyat per aprendre idiomes." +weight = 20 + +[taxonomies] +tags = ["Python", "media", "linguistics", "CLI"] + +[extra] +local_image = "projects/shuku/shuku_logo.webp" +social_media_card = "social_cards/projects_shuku.jpg" +canonical_url = "https://osc.garden/ca/projects/shuku/" ++++ + +**shuku** (縮しゅく小しょう: «minificació») crea versions condensades de pel·lícules i sèries conservant només els diàlegs. + + + +#### [GitHub](https://github.com/welpo/shuku) • [Blog](https://osc.garden/ca/blog/shuku-condensed-media-language-learning/) • [Documentació](https://github.com/welpo/shuku#readme) • [PyPI](https://pypi.org/project/shuku/) {.centered-text} + +## Característiques + +### Gestió intel·ligent de continguts + +- Detecció i correspondència automàtica de subtítols amb cerca difusa (fuzzy matching) +- Selecció intel·ligent de pistes d'àudio/subtítols +- Extracció de metadades (títol, temporada, número d'episodi) + +### Output flexible + +- Àudio condensat (MP3, FLAC, AAC, Opus…) +- Vídeo condensat +- Subtítols sincronitzats (SRT, ASS, o LRC per a apps tipus karaoke) + +### Alta personalització + +- Qualitat i còdecs d'àudio/vídeo configurables +- Ajust de temps de subtítols i farciment +- Filtra subtítols (efectes de so, lletres, capítols específics) +- Suport per a arguments personalitzats de FFmpeg + +### Experiència de l'usuari + +- Multiplataforma: GNU+Linux, macOS i Windows +- Logging detallat amb indicadors de progrés +- Suport per a processament per lots + +[![targeta social de shuku](/img/social_cards/projects_shuku.jpg)](https://github.com/welpo/shuku) diff --git a/content/projects/shuku/index.es.md b/content/projects/shuku/index.es.md new file mode 100644 index 0000000..dd8d79b --- /dev/null +++ b/content/projects/shuku/index.es.md @@ -0,0 +1,48 @@ ++++ +title = "shuku" +description = "Condensa películas y series para quedarte solo con el diálogo. Diseñado para aprender idiomas." +weight = 20 + +[taxonomies] +tags = ["Python", "media", "linguistics", "CLI"] + +[extra] +local_image = "projects/shuku/shuku_logo.webp" +social_media_card = "social_cards/projects_shuku.jpg" +canonical_url = "https://osc.garden/es/projects/shuku/" ++++ + +**shuku** (縮しゅく小しょう: «minificación») crea versiones condensadas de películas y series conservando solo los diálogos. + + + +#### [GitHub](https://github.com/welpo/shuku) • [Blog](https://osc.garden/es/blog/shuku-condensed-media-language-learning/) • [Documentación](https://github.com/welpo/shuku#readme) • [PyPI](https://pypi.org/project/shuku/) {.centered-text} + +## Características + +### Manejo inteligente de medios + +- Detección y correspondencia automática de subtítulos con búsqueda difusa (fuzzy matching) +- Selección inteligente de pistas de audio/subtítulos +- Extracción de metadatos (título, temporada, número de episodio) + +### Output flexible + +- Audio condensado (MP3, FLAC, AAC, Opus…) +- Video condensado +- Subtítulos sincronizados (SRT, ASS, o LRC para apps tipo karaoke) + +### Alta personalización + +- Calidad y códecs de audio/video configurables +- Ajuste de tiempo de subtítulos y relleno +- Filtra subtítulos (efectos de sonido, letras, capítulos específicos) +- Soporte para argumentos personalizados de FFmpeg + +### Experiencia del usuario + +- Multiplataforma: GNU+Linux, macOS y Windows +- Logging detallado con indicadores de progreso +- Soporte para procesamiento por lotes + +[![tarjeta social de shuku](/img/social_cards/projects_shuku.jpg)](https://github.com/welpo/shuku) diff --git a/content/projects/shuku/index.md b/content/projects/shuku/index.md new file mode 100644 index 0000000..1c188fe --- /dev/null +++ b/content/projects/shuku/index.md @@ -0,0 +1,56 @@ ++++ +title = "shuku" +description = "Shrink media to keep only the dialogue. For immersion language learning." +weight = 20 + +[taxonomies] +tags = ["Python", "media", "linguistics", "CLI"] + +[extra] +local_image = "projects/shuku/shuku_logo.webp" +social_media_card = "social_cards/projects_shuku.jpg" +canonical_url = "https://osc.garden/projects/shuku/" ++++ + +**shuku** (縮しゅく小しょう: "minification") creates condensed versions of films and TV shows by keeping only the dialogue. + + + +#### [GitHub](https://github.com/welpo/shuku) • [Blog post](https://osc.garden/blog/shuku-condensed-media-language-learning/) • [Documentation](https://github.com/welpo/shuku#readme) • [PyPI](https://pypi.org/project/shuku/) {.centered-text} + +## Features + +### Smart media handling + +- Automatic subtitle detection and matching with fuzzy search +- Intelligent audio/subtitle track selection +- Metadata extraction (title, season, episode number) + +### Flexible output + +- Condensed audio (MP3, FLAC, AAC, Opus...) +- Condensed video +- Synchronized subtitles (including LRC for karaoke-style review) +- Clean filenames in output + +### High customization + +- Configurable audio/video quality and codecs +- Subtitle timing adjustment and padding +- Skip unwanted content (sound effects, lyrics, specific chapters) +- Custom FFmpeg arguments support + +### User experience + +- Cross-platform: GNU+Linux, macOS, and Windows +- Detailed logging with progress indicators +- Batch processing support + +## Development best practices + +- Comprehensive testing: 100% code coverage +- Clean code: Type-hinted Python with clear responsibilities +- Continuous Integration/Deployment +- Comprehensive documentation + +[![shuku social media card](/img/social_cards/projects_shuku.jpg)](https://github.com/welpo/shuku) diff --git a/content/projects/shuku/shuku_logo.webp b/content/projects/shuku/shuku_logo.webp new file mode 100644 index 0000000..900a598 Binary files /dev/null and b/content/projects/shuku/shuku_logo.webp differ diff --git a/content/projects/shuku/social_cards/projects_shuku.jpg b/content/projects/shuku/social_cards/projects_shuku.jpg new file mode 100644 index 0000000..24d2bed Binary files /dev/null and b/content/projects/shuku/social_cards/projects_shuku.jpg differ diff --git a/content/projects/streaming-royalties-calculator/index.ca.md b/content/projects/streaming-royalties-calculator/index.ca.md index 2c3ccc8..bfa69f8 100644 --- a/content/projects/streaming-royalties-calculator/index.ca.md +++ b/content/projects/streaming-royalties-calculator/index.ca.md @@ -3,6 +3,9 @@ title = "Calculadora de royalties de streaming" description = "Una eina per calcular els royalties de streaming per a músics." weight = 45 +[taxonomies] +tags = ["música", "interactiu", "web app", "web", "JavaScript", "anàlisi de dades"] + [extra] local_image = "projects/streaming-royalties-calculator/streaming-royalties-calculator_logo.webp" canonical_url = "https://osc.garden/ca/projects/streaming-royalties-calculator/" diff --git a/content/projects/streaming-royalties-calculator/index.es.md b/content/projects/streaming-royalties-calculator/index.es.md index ae4d9f7..a9f598f 100644 --- a/content/projects/streaming-royalties-calculator/index.es.md +++ b/content/projects/streaming-royalties-calculator/index.es.md @@ -3,6 +3,9 @@ title = "Calculadora de royalties de streaming" description = "Una herramienta para calcular los royalties de streaming para músicos." weight = 45 +[taxonomies] +tags = ["música", "interactivo", "web app", "web", "JavaScript", "análisis de datos"] + [extra] local_image = "projects/streaming-royalties-calculator/streaming-royalties-calculator_logo.webp" canonical_url = "https://osc.garden/es/projects/streaming-royalties-calculator/" diff --git a/content/projects/streaming-royalties-calculator/index.md b/content/projects/streaming-royalties-calculator/index.md index 8aac428..c531834 100644 --- a/content/projects/streaming-royalties-calculator/index.md +++ b/content/projects/streaming-royalties-calculator/index.md @@ -3,6 +3,9 @@ title = "Streaming Royalties Calculator" description = "A tool to calculate streaming royalties for musicians." weight = 45 +[taxonomies] +tags = ["music", "interactive", "web app", "web", "JavaScript", "data analysis"] + [extra] local_image = "projects/streaming-royalties-calculator/streaming-royalties-calculator_logo.webp" canonical_url = "https://osc.garden/projects/streaming-royalties-calculator/" diff --git a/content/projects/streaming-royalties-calculator/streaming-royalties-calculator_logo.webp b/content/projects/streaming-royalties-calculator/streaming-royalties-calculator_logo.webp index 06754bf..19c8fe4 100644 Binary files a/content/projects/streaming-royalties-calculator/streaming-royalties-calculator_logo.webp and b/content/projects/streaming-royalties-calculator/streaming-royalties-calculator_logo.webp differ diff --git a/content/projects/tabi/index.ar.md b/content/projects/tabi/index.ar.md new file mode 100644 index 0000000..02abea0 --- /dev/null +++ b/content/projects/tabi/index.ar.md @@ -0,0 +1,47 @@ ++++ +title = "تابي" +description = "سمة زولا عصرية غنية بالمميزات مع دعم متميز لتعدد اللغات" +weight = 40 + +[taxonomies] +tags = ["ويب", "جافا سكريبت"] + +[extra] +local_image = "projects/tabi/tabi.webp" ++++ + +[**تابي**](https://github.com/welpo/tabi) هي سمة عصرية غنية بالمميزات لـ[Zola](https://www.getzola.org/)، منشئ مواقع ثابتة سريع. + +{{ full_width_image(src="https://cdn.jsdelivr.net/gh/welpo/tabi@main/light_dark_screenshot.png", alt="تابي في الوضعين الفاتح والداكن") }} + +#### [عرض على GitHub](https://github.com/welpo/tabi) • [عرض توضيحي وتوثيق](https://welpo.github.io/tabi/) {.centered-text} + +## المميزات + +- دعم كامل [للغة العربية والكتابة من اليمين إلى اليسار](https://welpo.github.io/tabi/blog/faq-languages/#how-do-i-set-a-default-language-for-my-site) +- [دعم للسلاسل](https://welpo.github.io/tabi/blog/series/) لإنشاء محتوى متسلسل مثل الدروس والدورات +- سمتان داكنة وفاتحة، مع التبديل التلقائي حسب إعدادات النظام +- [دعم التعليقات](https://welpo.github.io/tabi/blog/comments/) باستخدام giscus أو utterances أو Hyvor Talk أو Isso +- [دعم KaTeX](https://katex.org/) للمعادلات الرياضية +- [دعم Indieweb](https://indieweb.org/) مع microformats وh-card وwebmentions +- [دعم Mermaid](https://welpo.github.io/tabi/blog/shortcodes/#mermaid-diagrams) لإنشاء المخططات +- [بحث محلي](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#search) متعدد اللغات +- تصميم متجاوب يعمل على جميع الأجهزة +- [صفحة مشاريع](https://welpo.github.io/tabi/projects/) و[أرشيف](https://welpo.github.io/tabi/archive/) + +## ممارسات التطوير + +- **[الالتزامات التقليدية](https://www.conventionalcommits.org) و[Gitmoji](https://gitmoji.dev/)**: تتبع رسائل الالتزام تنسيقات موحدة لتحسين القراءة +- **تتبع المشكلات**: لكل خطأ أو ميزة جديدة تذكرة مخصصة، مرتبطة بأي التزامات برمجية وطلبات سحب ذات صلة +- **تعليقات شاملة**: يتم توثيق التذاكر بالصور ومقاطع الفيديو والأوصاف التفصيلية لتسهيل التواصل الفعال وحل المشكلات +- **الإحالات المرجعية**: نربط جميع التذاكر بالتزامات الشفرة وطلبات السحب أو المشكلات ذات الصلة للتتبع الكامل + +## تطور المشروع + +تم تصميم **تابي** في الأصل لموقعي الشخصي، [osc.garden](https://osc.garden). على الرغم من أصولها للاستخدام الشخصي، تم تنفيذ أفضل الممارسات منذ البداية لضمان الجودة وقابلية الصيانة. ومنذ ذلك الحين نمت السمة لتجذب مجتمعًا نشطًا من المساهمين على GitHub. + +## ابدأ رحلة الكتابة مع تابي + +لديك شيء تريد قوله. ربما عن تجربتك في تعلم لغة جديدة، أو عن رحلتك في استكشاف [فن الفلامنكو](https://en.wikipedia.org/wiki/Palo_(flamenco))، أو عن كيف نجحت في حل مشكلة برمجية في مشروع مفتوح المصدر. + +**تابي** توفر الأساس المثالي لمساحة كتابتك، مما يتيح لك التركيز على كلماتك بينما يهتم Zola وتابي بالجانب التقني. ادخل عالم التدوين مع نظام يجعل كل تدوينة متعة في الكتابة والقراءة. صوتك له قيمة—شاركه مع العالم. diff --git a/content/projects/tabi/index.ca.md b/content/projects/tabi/index.ca.md index 01f353d..0293403 100644 --- a/content/projects/tabi/index.ca.md +++ b/content/projects/tabi/index.ca.md @@ -1,17 +1,21 @@ +++ title = "tabi" description = "Un tema de Zola ràpid, lleuger i modern amb suport multilingüe." -weight = 30 +weight = 40 + +[taxonomies] +tags = ["web", "JavaScript"] [extra] local_image = "projects/tabi/tabi.webp" canonical_url = "https://osc.garden/ca/projects/tabi/" social_media_card = "social_cards/ca_projects_tabi.jpg" +iine_icon = '🌱' +++ [**tabi**](https://github.com/welpo/tabi) és un tema modern i ric en funcionalitat per a [Zola](https://www.getzola.org/), un generador de llocs web estàtics molt ràpid. -{{ full_width_image(src="light_dark_tabi.webp", alt="Modes clar i fosc de tabi") }} +{{ full_width_image(src="https://cdn.jsdelivr.net/gh/welpo/tabi@main/light_dark_screenshot.png", alt="Modes clar i fosc de tabi") }} #### [Veure a GitHub](https://github.com/welpo/tabi) • [Demo i documentación](https://welpo.github.io/tabi/ca/) {.centered-text} @@ -19,10 +23,13 @@ social_media_card = "social_cards/ca_projects_tabi.jpg" - [Estableix qualsevol idioma com a predeterminat](https://welpo.github.io/tabi/ca/blog/faq-languages/#com-estableixo-la-llengua-predeterminada-del-meu-lloc). Configura el teu lloc en xinès, espanyol, francès, hindi… o qualsevol [altre idioma compatible](https://welpo.github.io/tabi/ca/blog/faq-languages/#quines-llengues-admet-tabi). La interfície del tema es traduirà en conseqüència. - [Integració amb repositoris remots](https://welpo.github.io/tabi/ca/blog/mastering-tabi-settings#integracio-amb-repositoris-git) a GitHub, GitLab, Gitea i Codeberg per a l'historial de commits i mostrar el codi font del lloc. -- Temes clars i foscos. S'adapta a la configuració del sistema operatiu, amb un interruptor a la barra de navegació. +- Tema clar i fosc. S'adapta a la configuració del sistema operatiu, amb un interruptor a la barra de navegació. - [Suport multilingüe complet](https://welpo.github.io/tabi/ca/blog/faq-languages/#com-gestiona-tabi-el-suport-multilingue). Afegeix tants idiomes com vulguis i deixa que els teus usuaris triin amb el selector d'idioma. +- [Suport per a sèries](https://welpo.github.io/tabi/ca/blog/series/) per crear contingut seqüencial com tutorials, cursos i històries multipart. - Puntuació perfecta en Lighthouse (Rendiment, Accessibilitat, Millors Pràctiques i SEO). +- Suport per a [Indieweb](https://indieweb.org/) amb microformats, suport per a [hcard](https://welpo.github.io/tabi/ca/blog/mastering-tabi-settings/#h-card-representativa) i [webmentions](https://welpo.github.io/tabi/ca/blog/mastering-tabi-settings/#webmentions). - Suport per a [diagrames de Mermaid](https://welpo.github.io/tabi/ca/blog/shortcodes/#diagrames-de-mermaid) per a crear diagrames i gràfics amb text. +- Botons de «m'agrada» d'[iine](https://iine.to/) per mostrar apreciació anònima pel teu contingut. - Ressaltat de sintaxi de codi amb colors basats en [Catppuccin](https://github.com/catppuccin/catppuccin) Frappé. - Suport per a [comentaris usant giscus, utterances, Hyvor Talk o Isso](https://welpo.github.io/tabi/ca/blog/comments/). - [Cerca local](https://welpo.github.io/tabi/ca/blog/mastering-tabi-settings/#cerca) amb una interfície accessible i multilingüe. @@ -40,6 +47,7 @@ social_media_card = "social_cards/ca_projects_tabi.jpg" - [Botons de navegació ràpida](https://welpo.github.io/tabi/ca/blog/mastering-tabi-settings/#botons-de-navegacio-rapida). - [Shortcodes personalitzats](https://welpo.github.io/tabi/ca/blog/shortcodes/). - [Skins personalitzables](https://welpo.github.io/tabi/ca/blog/customise-tabi/). +- [Publicacions fixades](https://welpo.github.io/tabi/ca/blog/mastering-tabi-settings/#fixar-entrades). - [Pàgina de projectes](https://welpo.github.io/tabi/ca/projects/). - Disseny responsive. - Suport de [KaTeX](https://katex.org/). diff --git a/content/projects/tabi/index.es.md b/content/projects/tabi/index.es.md index abb091b..d6725bb 100644 --- a/content/projects/tabi/index.es.md +++ b/content/projects/tabi/index.es.md @@ -1,17 +1,21 @@ +++ title = "tabi" description = "Un tema de Zola rápido, ligero y moderno con soporte multilingüe." -weight = 30 +weight = 40 + +[taxonomies] +tags = ["web", "JavaScript"] [extra] local_image = "projects/tabi/tabi.webp" canonical_url = "https://osc.garden/es/projects/tabi/" social_media_card = "social_cards/es_projects_tabi.jpg" +iine_icon = '🌱' +++ [**tabi**](https://github.com/welpo/tabi) es un tema moderno y rico en funcionalidad para [Zola](https://www.getzola.org/), un generador de sitios web estáticos muy rápido. -{{ full_width_image(src="light_dark_tabi.webp", alt="Modos claro y oscuro de tabi") }} +{{ full_width_image(src="https://cdn.jsdelivr.net/gh/welpo/tabi@main/light_dark_screenshot.png", alt="Modos claro y oscuro de tabi") }} #### [Ver en GitHub](https://github.com/welpo/tabi) • [Demo y documentación](https://welpo.github.io/tabi/es/) {.centered-text} @@ -20,8 +24,11 @@ social_media_card = "social_cards/es_projects_tabi.jpg" - [Establece cualquier idioma como predeterminado](https://welpo.github.io/tabi/es/blog/faq-languages/#como-establezco-el-idioma-predeterminado-de-mi-sitio). Configura tu sitio en chino, español, francés, hindi… o cualquier [otro idioma compatible](https://welpo.github.io/tabi/es/blog/faq-languages/#que-idiomas-admite-tabi). La interfaz del tema se traducirá en consecuencia. - [Integración con repositorios remotos](https://welpo.github.io/tabi/es/blog/mastering-tabi-settings/#integracion-con-repositorios-git) en GitHub, GitLab, Gitea y Codeberg para el historial de commits y mostrar el código fuente del sitio. - [Soporte multilingüe completo](https://welpo.github.io/tabi/es/blog/faq-languages/#como-gestiona-tabi-el-soporte-multilingue). Añade tantos idiomas como desees y deja que tus usuarios elijan con un selector de idioma. -- Temas claros y oscuros. Se adapta a la configuración del sistema operativo, con un interruptor en la barra de navegación. +- Tema claro y oscuro. Se adapta a la configuración del sistema operativo, con un interruptor en la barra de navegación. +- [Soporte para series](https://welpo.github.io/tabi/es/blog/series/) para crear contenido secuencial como tutoriales, cursos e historias en varias partes. - Puntuación perfecta en Lighthouse (Rendimiento, Accesibilidad, Mejores Prácticas y SEO). +- Soporte para [Indieweb](https://indieweb.org/) con microformatos, soporte para [hcard](https://welpo.github.io/tabi/es/blog/mastering-tabi-settings/#h-card-representativa) y [webmentions](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#webmentions). +- Botones de «me gusta» de [iine](https://iine.to/) para mostrar aprecio anónimo por tu contenido. - Soporte para [diagramas de Mermaid](https://welpo.github.io/tabi/es/blog/shortcodes/#diagramas-de-mermaid) para crear diagramas y gráficos con texto. - Resaltado de sintaxis de código con colores basados en [Catppuccin](https://github.com/catppuccin/catppuccin) Frappé. - Soporte para [comentarios usando giscus, utterances, Hyvor Talk o Isso](https://welpo.github.io/tabi/es/blog/comments/). @@ -40,6 +47,7 @@ social_media_card = "social_cards/es_projects_tabi.jpg" - [Tarjetas para redes sociales](https://welpo.github.io/tabi/es/blog/mastering-tabi-settings/#tarjetas-para-redes-sociales). - [Shortcodes personalizados](https://welpo.github.io/tabi/es/blog/shortcodes/). - [Skins personalizables](https://welpo.github.io/tabi/es/blog/customise-tabi/). +- [Publicaciones fijadas](https://welpo.github.io/tabi/es/blog/mastering-tabi-settings/#fijar-publicaciones). - [Página de proyectos](https://welpo.github.io/tabi/es/projects/). - Diseño responsive. - Soporte de [KaTeX](https://katex.org/). diff --git a/content/projects/tabi/index.md b/content/projects/tabi/index.md index a3fa4d6..1d13797 100644 --- a/content/projects/tabi/index.md +++ b/content/projects/tabi/index.md @@ -1,11 +1,15 @@ +++ title = "tabi" description = "A feature-rich modern Zola theme with first-class multi-language support." -weight = 30 +weight = 40 + +[taxonomies] +tags = ["web", "JavaScript"] [extra] local_image = "projects/tabi/tabi.webp" social_media_card = "social_cards/projects_tabi.jpg" +iine_icon = '🌱' +++ [**tabi**](https://github.com/welpo/tabi) is a modern, feature-rich theme for [Zola](https://www.getzola.org/), a fast static site generator. @@ -18,12 +22,15 @@ social_media_card = "social_cards/projects_tabi.jpg" - [Set any language as default](https://welpo.github.io/tabi/blog/faq-languages/#how-do-i-set-a-default-language-for-my-site). Set your base site to Chinese, Spanish, French, Hindi… or any [other supported language](https://welpo.github.io/tabi/blog/faq-languages/#what-languages-does-tabi-support). The theme's interface will be translated accordingly. - [Integration with remote repositories](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#git-repository-integration) on GitHub, GitLab, Gitea & Codeberg for commit history and showing the site source. +- [Series support](https://welpo.github.io/tabi/blog/series/) for creating sequential content like tutorials, courses, and multi-part stories. - Dark and light themes. Defaults to the OS setting, with a switcher in the navigation bar. - Thorough documentation. See [Mastering tabi Settings: A Comprehensive Guide](https://welpo.github.io/tabi/blog/mastering-tabi-settings/). - Perfect Lighthouse score (Performance, Accessibility, Best Practices and SEO). - [Comprehensive multi-language support](https://welpo.github.io/tabi/blog/faq-languages/#how-does-tabi-handle-multilingual-support). Add as many languages as you wish. - Support for [comments using giscus, utterances, Hyvor Talk, or Isso](https://welpo.github.io/tabi/blog/comments/). +- [Indieweb](https://indieweb.org/) ready with microformats, [hcard](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#representative-h-card) and [webmentions](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#webmentions) support. - Code syntax highlighting with colours based on [Catppuccin](https://github.com/catppuccin/catppuccin) Frappé. +- [iine like buttons](https://iine.to/) for anonymous appreciation of your content. - [Mermaid support](https://welpo.github.io/tabi/blog/shortcodes/#mermaid-diagrams) to create diagrams and charts with text. - [Local search](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#search) with an accessible, multi-lingual interface. - [Custom Twitter card](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#social-media-cards) and automatic Open Graph tags. @@ -44,6 +51,7 @@ social_media_card = "social_cards/projects_tabi.jpg" - Responsive design. - [Projects page](https://welpo.github.io/tabi/projects/). - [Archive page](https://welpo.github.io/tabi/archive/). +- [Pinned posts](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#pinning-posts). - [Social links](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#social-media-icons). - [Tags](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#tags). diff --git a/content/projects/tabi/tabi.webp b/content/projects/tabi/tabi.webp index 5b0f1d2..c05d2a7 100644 Binary files a/content/projects/tabi/tabi.webp and b/content/projects/tabi/tabi.webp differ diff --git a/content/projects/zutsu/index.ca.md b/content/projects/zutsu/index.ca.md new file mode 100644 index 0000000..cbe50bb --- /dev/null +++ b/content/projects/zutsu/index.ca.md @@ -0,0 +1,51 @@ ++++ +title = "zutsu" +description = "Una aplicació minimalista i privada de gestió de tasques." +weight = 32 + +[taxonomies] +tags = ["interactiu", "productivitat", "web app", "web", "JavaScript"] + +[extra] +local_image = "projects/zutsu/zutsu_logo.webp" +canonical_url = "https://osc.garden/ca/projects/zutsu/" +social_media_card = "social_cards/projects_zutsu.jpg" ++++ + +{% wide_container() %} + +{% end %} + +#### [Prova-la ara](https://zutsu.osc.garden) • [GitHub](https://github.com/welpo/zutsu) • [Article](https://osc.garden/ca/blog/zutsu-offline-task-planner-web-app/) {.centered-text} + +ずzuつtsu és una aplicació web de gestió de tasques dissenyada per ajudar-te a centrar-te en una tasca cada vegada. El nom ve de 一つhitotsuずつzutsu, que significa «d'un en un» en 日本語japonès. + +## Per què? + +Volia substituir els esdeveniments de calendari inflexibles per a les sessions d'estudi per alguna cosa senzilla i adaptable. Sense aplicacions de tercers, sense sincronització al núvol, només un espai centrat en a la gestió de tasques. + +## Funcionalitats + +### Principals + +- Gestió de tasques amb possibilitat de reordenar-les arrossegant +- Temporitzador amb durada personalitzable per tasca +- Privada i offline —sense comptes, seguiment ni emmagatzematge al servidor +- Importació/exportació de llistes de tasques (JSON) + +### Utilitats + +- Temporitzador Pomodoro +- Calendari d'activitat (vista de 30 dies) +- Comptador i cronòmetre +- Espai per prendre notes +- Selectors aleatoris + +### Qualitat de vida + +- Tema fosc i clar +- Notificacions del navegador i so +- Dreceres de teclat +- Disseny responsive + +[![targeta social de zutsu](social_cards/projects_zutsu.jpg)](https://zutsu.osc.garden) diff --git a/content/projects/zutsu/index.es.md b/content/projects/zutsu/index.es.md new file mode 100644 index 0000000..003fa19 --- /dev/null +++ b/content/projects/zutsu/index.es.md @@ -0,0 +1,51 @@ ++++ +title = "zutsu" +description = "Una aplicación minimalista y privada de gestión de tareas." +weight = 32 + +[taxonomies] +tags = ["interactivo", "productividad", "web app", "web", "JavaScript"] + +[extra] +local_image = "projects/zutsu/zutsu_logo.webp" +canonical_url = "https://osc.garden/es/projects/zutsu/" +social_media_card = "social_cards/projects_zutsu.jpg" ++++ + +{% wide_container() %} + +{% end %} + +#### [Pruébala ahora](https://zutsu.osc.garden) • [GitHub](https://github.com/welpo/zutsu) • [Artículo](https://osc.garden/es/blog/zutsu-offline-task-planner-web-app/) {.centered-text} + +ずzuつtsu es una aplicación web de gestión de tareas diseñada para ayudarte a centrarte en una tarea a la vez. El nombre viene de 一つhitotsuずつzutsu, que significa «uno por uno» en 日本語japonés. + +## ¿Por qué? + +Quería sustituir la inflexibilidad del calendario para planificar las sesiones de estudio por algo simple y adaptable. Sin aplicaciones de terceros, sin sincronización en la nube —solo un espacio centrado en la gestión de tareas. + +## Funcionalidades + +### Principales + +- Gestión de tareas con posibilidad de reordenarlas arrastrando y soltando +- Temporizador con duración personalizable por tarea +- Privada y offline —sin cuentas, seguimiento ni almacenamiento en servidor +- Importación/exportación de listas de tareas (JSON) + +### Utilidades + +- Temporizador Pomodoro +- Calendario de actividad (vista de 30 días) +- Contador y cronómetro +- Espacio para tomar notas +- Selectores aleatorios + +### Calidad de vida + +- Tema oscuro y claro +- Notificaciones del navegador y sonido +- Atajos de teclado +- Diseño responsive + +[![tarjeta social de zutsu](social_cards/projects_zutsu.jpg)](https://zutsu.osc.garden) diff --git a/content/projects/zutsu/index.md b/content/projects/zutsu/index.md new file mode 100644 index 0000000..4205459 --- /dev/null +++ b/content/projects/zutsu/index.md @@ -0,0 +1,51 @@ ++++ +title = "zutsu" +description = "A private minimalist task management app." +weight = 32 + +[taxonomies] +tags = ["interactive", "productivity", "web app", "web", "JavaScript"] + +[extra] +local_image = "projects/zutsu/zutsu_logo.webp" +canonical_url = "https://osc.garden/projects/zutsu/" +social_media_card = "social_cards/projects_zutsu.jpg" ++++ + +{% wide_container() %} + +{% end %} + +#### [Try it now](https://zutsu.osc.garden) • [GitHub](https://github.com/welpo/zutsu) • [Blog post](https://osc.garden/blog/zutsu-offline-task-planner-web-app/) {.centered-text} + +ずzuつtsu is a task management web app designed to help you focus on one task at a time. The name comes from 一つhitotsuずつzutsu which means "one at a time" in 日本語Japanese. + +## Why? + +I wanted to replace inflexible calendar events for study sessions with something simple and adaptable. No third-party apps, no cloud sync —just a focused space for task management. + +## Features + +### Core + +- Task management with drag-and-drop reordering +- Timer with customizable duration for each task +- Private & offline—no accounts, tracking, or server storage +- Import/export task lists (JSON) + +### Utilities + +- Pomodoro timer +- Activity calendar (30-day view) +- Counter & stopwatch +- Note-taking space +- Random choice makers + +### Quality of life + +- Dark and light theme support +- Browser and sound notifications +- Keyboard shortcuts +- Responsive design + +[![zutsu social media card](social_cards/projects_zutsu.jpg)](https://zutsu.osc.garden) diff --git a/content/projects/zutsu/social_cards/projects_zutsu.jpg b/content/projects/zutsu/social_cards/projects_zutsu.jpg new file mode 100644 index 0000000..9373a35 Binary files /dev/null and b/content/projects/zutsu/social_cards/projects_zutsu.jpg differ diff --git a/content/projects/zutsu/zutsu_logo.webp b/content/projects/zutsu/zutsu_logo.webp new file mode 100644 index 0000000..8432797 Binary files /dev/null and b/content/projects/zutsu/zutsu_logo.webp differ diff --git a/i18n/ar.toml b/i18n/ar.toml index ccc36a9..afeeb28 100644 --- a/i18n/ar.toml +++ b/i18n/ar.toml @@ -30,6 +30,9 @@ few_results = "تم العثور على $NUMBER نتائج" # for 3 to 10 searc many_results = "تم العثور على $NUMBER نتيجة" # 11 or more search results. # Navigation. +skip_to_content = "الإنتقال إلى المحتوى" +pinned = "مثبتة" +jump_to_posts = "الإنتقال إلى التدوينات" read_more = "إقرأ المزيد" one_posts = "تدوينة واحدة" #One blog post. two_posts = "تدوينتين" #Two blog posts. @@ -81,6 +84,9 @@ load_comments = "إظهار التعليقات" copied = "تم النسخ!" copy_code_to_clipboard = "نسخ الشِفرة إلى الحافظة" +# iine appreciation button. +like_this_post = "أعجبني" + # Footer: Powered by Zola and tabi. powered_by = "مُشَغل بواسطة" and = "و" diff --git a/i18n/ca.toml b/i18n/ca.toml index 2c8ccfa..5edd8cd 100644 --- a/i18n/ca.toml +++ b/i18n/ca.toml @@ -23,6 +23,9 @@ one_results = "$NUMBER resultat" # "1 result" many_results = "$NUMBER resultats" # "3 results" # Navigation. +skip_to_content = "Saltar al contingut" +pinned = "Fixada" +jump_to_posts = "Saltar als articles" read_more = "Llegir més" one_posts = "$NUMBER entrada" many_posts = "$NUMBER entrades" @@ -66,6 +69,9 @@ load_comments = "Carregar comentaris" copied = "Copiat!" copy_code_to_clipboard = "Copia el codi al porta-retalls" +# iine appreciation button. +like_this_post = "M'agrada aquesta publicació" + # Footer: Powered by Zola and tabi. powered_by = "Propulsat per" and = "i" diff --git a/i18n/de.toml b/i18n/de.toml index 3671fd0..79c846f 100644 --- a/i18n/de.toml +++ b/i18n/de.toml @@ -27,6 +27,9 @@ one_results = "$NUMBER Ergebnis" # "1 result" many_results = "$NUMBER Ergebnisse" # "3 results" # Navigation. +skip_to_content = "Zum Inhalt springen" +pinned = "Angeheftet" +jump_to_posts = "Zu den Beiträgen springen" read_more = "Weiterlesen" one_posts = "$NUMBER Beitrag" many_posts = "$NUMBER Beiträge" @@ -70,6 +73,9 @@ load_comments = "Kommentare laden" copied = "Kopiert!" copy_code_to_clipboard = "Code in die Zwischenablage kopieren" +# iine appreciation button. +like_this_post = "Dieser Beitrag gefällt mir" + # Footer. powered_by = "Angetrieben von" and = "und" diff --git a/i18n/en.toml b/i18n/en.toml index d081e9c..586153c 100644 --- a/i18n/en.toml +++ b/i18n/en.toml @@ -23,6 +23,9 @@ one_results = "$NUMBER result" # "1 result" many_results = "$NUMBER results" # "3 results" # Navigation. +skip_to_content = "Skip to content" +pinned = "Pinned" +jump_to_posts = "Jump to posts" read_more = "Read more" one_posts = "$NUMBER post" many_posts = "$NUMBER posts" # "3 posts" @@ -66,6 +69,9 @@ load_comments = "Load comments" copied = "Copied!" copy_code_to_clipboard = "Copy code to clipboard" +# iine appreciation button. +like_this_post = "Like this post" + # Footer: Powered by Zola and tabi. powered_by = "Powered by" and = "&" diff --git a/i18n/es.toml b/i18n/es.toml index fb40061..df419e8 100644 --- a/i18n/es.toml +++ b/i18n/es.toml @@ -23,6 +23,9 @@ one_results = "$NUMBER resultado" many_results = "$NUMBER resultados" # Navigation. +skip_to_content = "Saltar al contenido" +pinned = "Fijada" +jump_to_posts = "Saltar a las entradas" read_more = "Leer más" one_posts = "$NUMBER entrada" many_posts = "$NUMBER entradas" @@ -66,6 +69,9 @@ load_comments = "Cargar comentarios" copied = "Copiado!" copy_code_to_clipboard = "Copiar código al portapapeles" +# iine appreciation button. +like_this_post = "Me gusta esta publicación" + # Footer: Powered by Zola and tabi. powered_by = "Impulsado por" and = "y" diff --git a/i18n/et.toml b/i18n/et.toml index 9ebc0f4..f328552 100644 --- a/i18n/et.toml +++ b/i18n/et.toml @@ -23,6 +23,9 @@ one_results = "$NUMBER tulemus" # "1 result" many_results = "$NUMBER tulemust" # "3 results" # Navigation. +skip_to_content = "Hüppa sisu juurde" +pinned = "Kinnitatud" +jump_to_posts = "Hüppa postitusteni" read_more = "Loe edasi" one_posts = "$NUMBER postitus" many_posts = "$NUMBER postitust" # "3 posts" @@ -66,6 +69,9 @@ load_comments = "Lae kommentaarid" copied = "Kopeeritud!" copy_code_to_clipboard = "Kopeeri kood lõikelauale" +# iine appreciation button. +like_this_post = "Mulle meeldib see postitus" + # Footer: Powered by Zola and tabi. powered_by = "Toetab" and = "ja" diff --git a/i18n/fa.toml b/i18n/fa.toml index 5b76e7c..2153aab 100644 --- a/i18n/fa.toml +++ b/i18n/fa.toml @@ -23,6 +23,9 @@ one_results = "$NUMBER نتیجه" # "1 result" many_results = "$NUMBER نتیجه" # "3 results" # Navigation. +skip_to_content = "پرش به محتوا" +pinned = "سنجاق‌شده" +jump_to_posts = "پرش به نوشته‌ها" read_more = "ادامه مطلب" one_posts = "$NUMBER مطلب" many_posts = "$NUMBER مطلب" # "3 posts" @@ -67,6 +70,9 @@ load_comments = "بارگذاری نظرات" copied = "کپی شد!" copy_code_to_clipboard = "کپی کد به کلیپ‌بورد" +# iine appreciation button. +like_this_post = "این مقاله را دوست دارم" + # Footer: Powered by Zola and tabi. powered_by = "قدرت گرفته از" and = "و" diff --git a/i18n/fi.toml b/i18n/fi.toml new file mode 100644 index 0000000..32fa48d --- /dev/null +++ b/i18n/fi.toml @@ -0,0 +1,103 @@ +language_name = "suomi" # Shown in language picker for multi-language sites. +date_locale = "fi_FI" +full_stop = "." # Used at the end of a sentence. + +# Menu items. +# Should match the names in config.extra.menu and config.extra.footer_menu. +blog = "blogi" +archive = "arkisto" +tags = "tunnisteet" +projects = "projektit" +diagrams = "kaaviot" +about = "minusta" +contact = "yhteystiedot" +privacy = "tietosuojakäytäntö" +site_statistics = "tilastot" +sitemap = "sivustokartta" + +# Search. +search = "Hae" +search_icon_title = "Paina $SHORTCUT avataksesi haun" # $SHORTCUT will be replaced with the actual keyboard shortcut. +clear_search = "Tyhjennä haku" # Title of the X icon next to search input. +zero_results = "Ei tuloksia" +one_results = "$NUMBER tulos" # "1 result" +many_results = "$NUMBER tulosta" # "3 results" + +# Navigation. +skip_to_content = "Siirry sisältöön" +# Some will prefer artikkeli (=article) instead of julkaisu (=publication), but this is more general +pinned = "Kiinnitetty" +jump_to_posts = "Siirry julkaisuihin" +read_more = "Lue lisää" +one_posts = "$NUMBER julkaisu" +many_posts = "$NUMBER julkaisua" # "3 posts" +prev = "Edellinen" # As in "Previous" page. +next = "Seuraava" # As in "Next" page. +of = "/" # E.g. Page 1 "of" 3 +all_posts = "Kaikki julkaisut" +all_tags = "Kaikki tunnisteet" +all_projects = "Kaikki projektit" +featured_projects = "Esittelyprojektit" +language_selection = "Kielivalinta" +toggle_mode = "Vaihda $MODE" # $MODE will be replaced by a value (or both) below. Literally "Change $MODE" +# The declension assumes that both values are used. e.g. "Change dark mode" wouldn't work and would need the "to" preposition +# It also omits the "mode" word: "Change dark/light mode" instead of "Change dark mode/light mode" +dark = "tumma" +light = "vaalea tila" +reset_mode = "Palauta oletustilaan" + +# Quick navigation buttons. +toggle_toc = "Sisällysluettelo päälle/pois" +go_to_top = "Siirry sivun alkuun" +go_to_comments = "Siirry kommenttiosioon" + +# Post metadata. +by_author = "Kirjoittanut $AUTHOR" # $AUTHOR will be replaced by the author(s). Literally "Written by $AUTHOR" +author_separator = ", " # For multiple authors. Ensure spacing where necessary. +author_conjunction = " ja " # For multiple authors. Ensure spacing where necessary. +draft = "LUONNOS" +zero_min_read = "<1 min. lukuaika" +one_min_read = "$NUMBER min. lukuaika" +many_min_read = "$NUMBER min. lukuaika" +zero_words = "Ei sanoja" +one_words = "$NUMBER sana" +many_words = "$NUMBER sanaa" +last_updated_on = "Päivitetty $DATE" +see_changes = "Katso muutokset" + +# Post body. +table_of_contents = "Sisällysluettelo" +load_comments = "Lataa kommentit" + +# Copy code block button. +copied = "Kopioitu!" +copy_code_to_clipboard = "Kopioi koodi leikepöydälle" + +# iine appreciation button. +like_this_post = "Pidän tästä kirjoituksesta" + +# Footer: Powered by Zola and tabi. +powered_by = "Pyörii ohjelmilla" # "Works using the software" +and = "&" +site_source = "Sivuston lähdekoodi" + +# 404 error. +# https://welpo.github.io/tabi/404.html +page_missing = "Pyytämääsi sivua ei löydy" +translation_missing = "tai sitä ei ole vielä käännetty kielellesi" +check_url = "Tarkista URL-osoitteesta mahdolliset virheet tai" +go_home = "palaa etusivulle" + +# For multilingual quote shortcode. +# https://welpo.github.io/tabi/blog/shortcodes/#multilingual-quotes +show_original_quote = "Näytä alkuperäinen lainaus" +show_translation = "Näytä käännös" +open_quotation_mark = "“" +close_quotation_mark = "”" + +# Translations for stylised Atom feed. +# https://welpo.github.io/tabi/atom.xml +# Must contain "About Feeds"; it will become a link. +about_feeds = "Tämä on verkkosyöte, joka tunnetaan myös nimellä Atom-syöte. Tilaa kopioimalla URL-osoite osoitepalkista uutislukijaasi. Käy sivulla About Feeds saadaksesi lisätietoja ja aloittaakeksi. Se on ilmaista." +visit_the_site = "Vieraile sivustolla" +recent_posts = "Viimeisimmät julkaisut" diff --git a/i18n/fr.toml b/i18n/fr.toml index d27b1ee..636a015 100644 --- a/i18n/fr.toml +++ b/i18n/fr.toml @@ -23,6 +23,9 @@ one_results = "$NUMBER résultat" # "1 result" many_results = "$NUMBER résultats" # "3 results" # Navigation. +skip_to_content = "Passer au contenu" +pinned = "Épinglé" +jump_to_posts = "Aller aux articles" read_more = "Lire plus" one_posts = "$NUMBER article" many_posts = "$NUMBER articles" @@ -66,6 +69,9 @@ load_comments = "Afficher les commentaires" copied = "Copié !" copy_code_to_clipboard = "Copier le code dans le presse-papier" +# iine appreciation button. +like_this_post = "J'aime cet article" + # Footer: Powered by Zola and tabi. powered_by = "Propulsé par" and = "et" diff --git a/i18n/hi.toml b/i18n/hi.toml index 6de5c00..77320c8 100644 --- a/i18n/hi.toml +++ b/i18n/hi.toml @@ -25,6 +25,9 @@ one_results = "$NUMBER परिणाम" # "1 result" many_results = "$NUMBER परिणाम" # "3 results" # Navigation. +skip_to_content = "सामग्री पर जाएं" +pinned = "पिन किया गया" +jump_to_posts = "पोस्ट पर जाएं" read_more = "और पढ़ें" one_posts = "$NUMBER पोस्ट" many_posts = "$NUMBER पोस्ट्स" @@ -68,6 +71,9 @@ load_comments = "कमेंट्स लोड करें" copied = "कॉपी किया गया!" copy_code_to_clipboard = "कोड क्लिपबोर्ड में कॉपी करें" +# iine appreciation button. +like_this_post = "मुझे यह पोस्ट पसंद है" + # Footer: Powered by Zola and tabi. powered_by = "चालित द्वारा" and = "और" diff --git a/i18n/it.toml b/i18n/it.toml index 5e7fd66..44495dd 100644 --- a/i18n/it.toml +++ b/i18n/it.toml @@ -23,6 +23,9 @@ one_results = "$NUMBER risultato" many_results = "$NUMBER risultati" # Navigation. +skip_to_content = "Salta al contenuto" +pinned = "In evidenza" +jump_to_posts = "Vai ai post" read_more = "Leggi di più" one_posts = "$NUMBER post" many_posts = "$NUMBER post" @@ -66,6 +69,9 @@ load_comments = "Carica commenti" copied = "Copiato!" copy_code_to_clipboard = "Copia codice negli appunti" +# iine appreciation button. +like_this_post = "Mi piace questo post" + # Footer: Powered by Zola and tabi. powered_by = "Alimentato da" and = "e" diff --git a/i18n/ja.toml b/i18n/ja.toml index a28ca53..10b9265 100644 --- a/i18n/ja.toml +++ b/i18n/ja.toml @@ -27,6 +27,9 @@ one_results = "$NUMBER 結果" # "1 result" many_results = "$NUMBER 結果" # "3 results" # Navigation. +skip_to_content = "コンテンツにスキップ" +pinned = "固定" +jump_to_posts = "投稿へジャンプ" read_more = "続きを読む" one_posts = "$NUMBER 投稿" many_posts = "$NUMBER 投稿" @@ -70,6 +73,9 @@ load_comments = "コメントを読む" copied = "コピーしました！" copy_code_to_clipboard = "コードをクリップボードにコピー" +# iine appreciation button. +like_this_post = "いいね！" + # Footer: Powered by Zola and tabi. powered_by = "Powered by" and = "と" diff --git a/i18n/ko.toml b/i18n/ko.toml index 945d7b5..e5eee12 100644 --- a/i18n/ko.toml +++ b/i18n/ko.toml @@ -27,6 +27,9 @@ one_results = "$NUMBER 결과" # "1 result" many_results = "$NUMBER 결과" # "3 results" # Navigation. +skip_to_content = "콘텐츠로 건너뛰기" +pinned = "고정됨" +jump_to_posts = "게시물로 이동" read_more = "더 읽기" one_posts = "$NUMBER 게시물" many_posts = "$NUMBER 게시물" @@ -70,6 +73,9 @@ load_comments = "댓글 불러오기" copied = "복사됨!" copy_code_to_clipboard = "코드를 클립보드에 복사" +# iine appreciation button. +like_this_post = "이 글이 좋아요" + # Footer: Powered by Zola and tabi. powered_by = "제공됨" and = "&" diff --git a/i18n/nl.toml b/i18n/nl.toml index 9471c37..c6649d5 100644 --- a/i18n/nl.toml +++ b/i18n/nl.toml @@ -23,6 +23,9 @@ one_results = "$NUMBER resultaat" # "1 result" many_results = "$NUMBER resultaten" # "3 results" # Navigation. +skip_to_content = "Naar inhoud springen" +pinned = "Vastgezet" +jump_to_posts = "Naar berichten springen" read_more = "Lees meer" one_posts = "$NUMBER bericht" # "1 post" many_posts = "$NUMBER berichten" # "3 posts" @@ -66,6 +69,9 @@ load_comments = "Laad opmerkingen" copied = "Gekopieerd!" copy_code_to_clipboard = "Kopieer code naar klembord" +# iine appreciation button. +like_this_post = "Vind ik leuk" + # Footer: Powered by Zola and tabi. powered_by = "Aangedreven door" and = "&" diff --git a/i18n/or.toml b/i18n/or.toml index e689be8..2db18e9 100644 --- a/i18n/or.toml +++ b/i18n/or.toml @@ -23,6 +23,9 @@ one_results = "$NUMBER ପରିଣାମ" # "1 result" many_results = "$NUMBER ପରିଣାମଗୁଡ଼ିକ" # "3 results" # Navigation. +skip_to_content = "ବିଷୟବସ୍ତୁକୁ ଯାଆନ୍ତୁ" +pinned = "ପିନ୍ କରାଯାଇଛି" +jump_to_posts = "ପୋଷ୍ଟକୁ ଯାଆନ୍ତୁ" read_more = "ଆହୁରି ପଢ଼ନ୍ତୁ" one_posts = "$NUMBER ପୋଷ୍ଟ" many_posts = "$NUMBER ପୋଷ୍ଟଗୁଡ଼ିକ" # "3 posts" @@ -66,6 +69,9 @@ load_comments = "ମତାମତ ଲୋଡ କରନ୍ତୁ" copied = "କପି ହେଲା!" copy_code_to_clipboard = "କ୍ଲିପବୋର୍ଡକୁ କପି କରନ୍ତୁ" +# iine appreciation button. +like_this_post = "ମୋର ଏହି ପୋସ୍ଟ ଭଲ ଲାଗେ" + # Footer: Powered by Zola and tabi. powered_by = "ଚାଳିତ ଦ୍ୱାରା" and = "ଏବଂ" diff --git a/i18n/pt-PT.toml b/i18n/pt-PT.toml index a05e99a..1147770 100644 --- a/i18n/pt-PT.toml +++ b/i18n/pt-PT.toml @@ -23,6 +23,9 @@ one_results = "$NUMBER resultado" # "1 result" many_results = "$NUMBER resultados" # "3 results" # Navigation. +skip_to_content = "Pular para o conteúdo" +pinned = "Fixado" +jump_to_posts = "Ir para as publicações" read_more = "Ler mais" one_posts = "$NUMBER publicação" many_posts = "$NUMBER publicações" @@ -66,6 +69,9 @@ load_comments = "Carregar comentários" copied = "Copiado!" copy_code_to_clipboard = "Copiar código para a área de transferência" +# iine appreciation button. +like_this_post = "Gosto desta publicação" + # Footer: Powered by Zola and tabi. powered_by = "Impulsionado por" and = "e" diff --git a/i18n/ru.toml b/i18n/ru.toml index aad5d63..1b566ad 100644 --- a/i18n/ru.toml +++ b/i18n/ru.toml @@ -28,6 +28,9 @@ few_results = "$NUMBER результата" # 2, 3, 4 but not 12-14 many_results = "$NUMBER результатов" # 5-9, 0, 11-14, and others # Navigation. +skip_to_content = "Перейти к содержанию" +pinned = "Закреплено" +jump_to_posts = "Перейти к записям" read_more = "Читать далее" post = "пост" one_posts = "$NUMBER пост" @@ -75,6 +78,9 @@ load_comments = "Загрузить комментарии" copied = "Скопировано!" copy_code_to_clipboard = "Скопировать код в буфер обмена" +# iine appreciation button. +like_this_post = "Мне нравится эта статья" + # Footer: Powered by Zola and tabi. powered_by = "Под управлением" and = "&" diff --git a/i18n/uk.toml b/i18n/uk.toml index 95a0f51..d1696fe 100644 --- a/i18n/uk.toml +++ b/i18n/uk.toml @@ -33,6 +33,9 @@ few_results = "$NUMBER результати" many_results = "$NUMBER результатів" # Navigation. +skip_to_content = "Перейти до вмісту" +pinned = "Закріплено" +jump_to_posts = "Перейти до дописів" read_more = "Читати далі" one_posts = "$NUMBER пост" few_posts = "$NUMBER пости" # 2, 3, 4 but not 12-14 @@ -79,6 +82,9 @@ load_comments = "Завантажити коментарі" copied = "Скопійовано!" copy_code_to_clipboard = "Копіювати код у буфер обміну" +# iine appreciation button. +like_this_post = "Мені подобається ця стаття" + # Footer: Powered by Zola and tabi. powered_by = "Під управлінням" and = "та" diff --git a/i18n/zh-Hans.toml b/i18n/zh-Hans.toml index c44557f..15a4cc6 100644 --- a/i18n/zh-Hans.toml +++ b/i18n/zh-Hans.toml @@ -23,6 +23,9 @@ one_results = "$NUMBER 个结果" many_results = "$NUMBER 个结果" # Navigation. +skip_to_content = "跳到内容" +pinned = "置顶" +jump_to_posts = "跳转到文章" read_more = "阅读全文" one_posts = "$NUMBER 篇文章" many_posts = "$NUMBER 篇文章" @@ -66,6 +69,9 @@ load_comments = "载入留言" copied = "已复制!" # Machine translated. copy_code_to_clipboard = "复制代码到剪贴板" # Machine translated. +# iine appreciation button. +like_this_post = "喜欢这篇文章" + # Footer: Powered by Zola and tabi. powered_by = "网站基于" and = "和" diff --git a/i18n/zh-Hant.toml b/i18n/zh-Hant.toml index 14866c5..d6f42e5 100644 --- a/i18n/zh-Hant.toml +++ b/i18n/zh-Hant.toml @@ -23,6 +23,9 @@ one_results = "$NUMBER 個結果" many_results = "$NUMBER 個結果" # Navigation. +skip_to_content = "跳到內容" +pinned = "釘選" +jump_to_posts = "跳轉到文章" read_more = "閱讀全文" one_posts = "$NUMBER 篇文章" many_posts = "$NUMBER 篇文章" @@ -66,6 +69,9 @@ load_comments = "載入留言" copied = "已复制!" # Machine translated. copy_code_to_clipboard = "复制代码到剪贴板" # Machine translated. +# iine appreciation button. +like_this_post = "喜歡這篇文章" + # Footer: Powered by Zola and tabi. powered_by = "網站基於" and = "和" diff --git a/release b/release deleted file mode 100644 index f8fc9d8..0000000 --- a/release +++ /dev/null @@ -1,113 +0,0 @@ -#!/usr/bin/env bash -# Bash script to prepare a release using git-cliff. -# Inspired by https://github.com/orhun/git-cliff/blob/main/release.sh -set -eu - -VERSION_FORMAT="^v[0-9]+\.[0-9]+\.[0-9]+$" - -exit_with_message() { - echo "$1" >&2 - exit 1 -} - -# Run only from default branch. -default_branch=$(git remote show origin | sed -n '/HEAD branch/s/.*: //p') -current_branch=$(git rev-parse --abbrev-ref HEAD) -if [ "$current_branch" != "$default_branch" ]; then - exit_with_message "Not on $default_branch branch. Switch to $default_branch before running this script." -fi - -# Check for a clean working directory. -if [ -n "$(git status --porcelain)" ]; then - exit_with_message "Your working directory is dirty. Commit or stash your changes before running this script." -fi - -# Ensure the local repository is up-to-date. -echo "Updating local repository…" -git fetch origin -git_status=$(git status -uno) -if echo "$git_status" | grep -q "Your branch is behind"; then - exit_with_message "Your local branch is behind the remote. Pull the latest changes before running this script." -elif echo "$git_status" | grep -q "Your branch is ahead"; then - echo "Your local branch is ahead of the remote. Checking if local changes can be pushed…" - if git push --dry-run &> /dev/null; then - echo "Local changes can be pushed without conflicts. Proceeding with the release." - else - exit_with_message "Unable to push local changes. Resolve any conflicts before running this script." - fi -elif ! echo "$git_status" | grep -q "Your branch is up to date"; then - exit_with_message "Unable to determine if branch is up to date. Check your git status manually." -fi -echo "Local repository is ready for release." - -# Check if a version tag is provided. -if [ "$#" -eq 1 ]; then - VERSION_TAG=$1 -else - suggested_version=$(git cliff --bumped-version) - echo -n "No version tag provided. git-cliff suggests $suggested_version. Proceed? [Y/n] " - read user_input - - # Check if input is empty or a variation of "yes". - if [[ -z "$user_input" || "$user_input" =~ ^[Yy](es)?$ ]]; then - echo "Proceeding with version $suggested_version." - VERSION_TAG=$suggested_version - else - exit_with_message "Release preparation cancelled." - fi -fi - -# Verify that the version tag matches the expected format. -if ! [[ $VERSION_TAG =~ $VERSION_FORMAT ]]; then - exit_with_message "Version tag $VERSION_TAG does not match the expected format ${VERSION_FORMAT}." -fi - -echo "Preparing release ${VERSION_TAG}…" -echo - -# Update CHANGELOG. -git cliff --tag "$VERSION_TAG" -o CHANGELOG.md -sed -E 's/@([a-zA-Z0-9_-]+)/[@\1](https:\/\/github.com\/\1)/g' CHANGELOG.md > CHANGELOG.tmp && mv CHANGELOG.tmp CHANGELOG.md - -# Add all changes and commit. -git add -A -git commit -m "🔖 chore(release): prepare for $VERSION_TAG" - - -# Generate the tag description. -changelog=$(git cliff --tag "$VERSION_TAG" --unreleased --strip all) - -# Clean up tag's changelog; tag descriptions don't support markdown. -# Remove PR links. -changelog=$(echo "$changelog" | sed -E 's/\[\#([0-9]+)\]\(https:\/\/github\.com\/welpo\/[^\/]+\/(issues|pull)\/([0-9]+)\)/#\1/g') -# Remove commit links. -changelog=$(echo "$changelog" | sed -E 's/\[([0-9a-f]+)\]\(https:\/\/github\.com\/welpo\/[^\/]+\/commit\/([0-9a-f]+)\)/\1/g') -# Remove scopes. -changelog=$(echo "$changelog" | sed -E 's/\*\(([^)]+)\)\* //g') -# Remove markdown headers. -changelog=$(echo "$changelog" | sed -E 's/^#+ //g') -# Remove version comparison lines. -changelog=$(echo "$changelog" | sed '/https:\/\/github\.com\/.*\/compare\/.*/d') - -# Create a signed and annotated tag. -git tag -s -a "$VERSION_TAG" -m "Release $VERSION_TAG" -m "$changelog" - -echo "Most recent commit:" -git log -1 -echo -echo "Information for tag $VERSION_TAG:" -git show $VERSION_TAG -echo - -echo "Release $VERSION_TAG is ready. Don't forget to push the changes and the tag:" - -remote_url=$(git remote get-url origin) -# Check if the URL is in SSH format (git@). -if [[ "$remote_url" == git@github.com:* ]]; then - https_url="https://github.com/${remote_url#git@github.com:}" - https_url="${https_url%.git}" -else - https_url="${remote_url%.git}" -fi - -echo "git push && git push --tags && open ${https_url}/tags" diff --git a/sass/main.scss b/sass/main.scss index 2079528..d1470ff 100644 --- a/sass/main.scss +++ b/sass/main.scss @@ -1,5 +1,6 @@ @use 'parts/_admonitions.scss'; @use 'parts/_archive.scss'; +@use 'parts/_aside.scss'; @use 'parts/_cards.scss'; @use 'parts/_code.scss'; @use 'parts/_comments.scss'; @@ -7,6 +8,7 @@ @use 'parts/_header-anchor.scss'; @use 'parts/_header.scss'; @use 'parts/_home-banner.scss'; +@use 'parts/_iine.scss'; @use 'parts/_image-hover.scss'; @use 'parts/_image-toggler.scss'; @use 'parts/_image.scss'; @@ -21,6 +23,7 @@ @use 'parts/_table.scss'; @use 'parts/_tags.scss'; @use 'parts/_theme-switch.scss'; +@use 'parts/_webmention.scss'; @use 'parts/_zola-error.scss'; @font-face { @@ -98,6 +101,9 @@ --serif-font: 'Source Serif', 'Georgia', serif; --code-font: 'Cascadia Code'; + scrollbar-color: var(--primary-color) transparent; + accent-color: var(--primary-color); + line-height: 190%; font-family: var(--sans-serif-font); } @@ -158,6 +164,7 @@ body { article { $base-margin: 6rem; + position: relative; margin: 0 auto; max-width: calc(var(--max-layout-width) - 2*$base-margin); @@ -191,7 +198,7 @@ article { } .section-title { - display: block; + display: flex; margin: 0; margin-top: -0.15em; color: var(--text-color-high-contrast); diff --git a/sass/parts/_admonitions.scss b/sass/parts/_admonitions.scss index 972f5e7..6feec43 100644 --- a/sass/parts/_admonitions.scss +++ b/sass/parts/_admonitions.scss @@ -2,7 +2,7 @@ border-color: var(--admonition-#{$type}-border); background-color: var(--admonition-#{$type}-bg); - code { + > .admonition-content > p > code { background-color: var(--admonition-#{$type}-code); } @@ -62,7 +62,7 @@ /* Info */ --admonition-info-border: #50a9d5; --admonition-info-bg: #193C47; - --admonition-info-code: #005f00; + --admonition-info-code: #245e70; /* Warning */ --admonition-warning-border: #e19d0a; diff --git a/sass/parts/_aside.scss b/sass/parts/_aside.scss new file mode 100644 index 0000000..4757524 --- /dev/null +++ b/sass/parts/_aside.scss @@ -0,0 +1,31 @@ +aside { + margin-block-end: var(--paragraph-spacing); + border-radius: 4px; + background: var(--bg-0); + padding-block: 0.8rem; + padding-inline: 1rem; + color: var(--meta-color); + font-size: 0.9rem; + + article & p { + margin: 0; + font-family: var(--sans-serif-font); + } + + @media only screen and (min-width: 1300px) { + position: absolute; + inset-inline-start: -14rem; + margin-block: 0; + border-radius: 0; + background: none; + padding: 0; + width: 12rem; + text-align: end; + + &[data-position="right"] { + inset-inline-start: auto; + inset-inline-end: -14rem; + text-align: start; + } + } +} diff --git a/sass/parts/_cards.scss b/sass/parts/_cards.scss index 9a415be..0b6c560 100644 --- a/sass/parts/_cards.scss +++ b/sass/parts/_cards.scss @@ -1,3 +1,44 @@ +.filter-controls { + display: flex; + flex-wrap: wrap; + justify-content: center; + align-items: center; + gap: 12px; + margin-top: 1.2rem; + margin-bottom: -1rem; + padding: 0; + list-style: none; + + #all-projects-filter { + display: none; + } + + .taxonomy-item { + margin: 0; + + a { + display: inline-block; + box-shadow: rgba(0, 0, 0, 0.1) 0px 1px 3px 0px, rgba(0, 0, 0, 0.06) 0px 1px 2px 0px; + border-radius: 1rem; + background: var(--bg-2); + padding: 0 16px; + color: var(--text-color); + font-size: 0.8rem; + text-decoration: none; + + &:hover { + background: var(--primary-color); + color: var(--hover-color); + } + + &.active { + background: var(--primary-color); + color: var(--hover-color); + } + } + } +} + .cards { display: grid; grid-template-rows: auto; @@ -27,13 +68,12 @@ padding-block-end: 24px; text-align: center; } - - .card-title { - margin-top: 0.7em; - } - .card-image { - width: 100%; + $margin: 1.6rem; + margin: $margin; + margin-bottom: $margin / 1.5; + width: calc(100% - $margin * 2); + height: auto; } .card-image-placeholder { @@ -53,4 +93,13 @@ .cards { gap: 18px; } + + .filter-controls { + gap: 8px; + margin: 18px 0; + + .taxonomy-item a { + padding: 4px 12px; + } + } } diff --git a/sass/parts/_code.scss b/sass/parts/_code.scss index 3940997..2623f50 100644 --- a/sass/parts/_code.scss +++ b/sass/parts/_code.scss @@ -1,4 +1,5 @@ code { + -webkit-text-size-adjust: 100%; border-radius: 5px; background-color: var(--bg-1); padding-inline: 0.2em; @@ -27,10 +28,13 @@ code { padding: 0rem; } + // Line number col. tbody td:first-child { - width: 2rem; + opacity: 50%; + padding-inline-end: 0.8rem; + width: 1px; // Without this, iOS Safari centres short lines. user-select: none; - text-align: start; + text-align: end; } tbody tr:nth-child(even) { @@ -41,6 +45,7 @@ code { a:hover code { background-color: inherit; + padding-block: 0; } pre { @@ -54,6 +59,32 @@ pre { overflow-x: auto; line-height: 1.4; + code, + code td { + font-size: 0.8rem; // Fits ~77 characters. + } + + // Supports both native Zola way of adding src, and old shortcode-based logic. + // See: https://github.com/welpo/tabi/pull/489 + &::after, + code .source-path { + display: block; + position: absolute; + top: 0; + inset-inline-end: 1.3rem; + padding-top: 0.3rem; + padding-inline-end: 1.3rem; + max-width: calc(100% - 14em); + height: 0.9rem; + overflow: hidden; + content: attr(data-name); + color: var(--hover-color); + font-size: 0.65rem; + text-align: end; + text-overflow: ellipsis; + white-space: nowrap; + } + code { display: block; border: 0rem; @@ -62,7 +93,6 @@ pre { padding: 0rem; overflow-x: auto; color: inherit; - font-size: 0.8rem; // Fits ~77 characters. white-space: pre; &::before { @@ -81,23 +111,18 @@ pre { text-align: start; text-transform: uppercase; } + } +} - .source-path { - display: block; - position: absolute; - top: 0; - inset-inline-end: 1.3rem; - padding-top: 0.3rem; - padding-inline-end: 1.3rem; - max-width: calc(100% - 14em); - height: 0.9rem; - overflow: hidden; - color: var(--hover-color); - font-size: 0.65rem; - text-align: end; - text-overflow: ellipsis; - white-space: nowrap; - } +// Default to LTR codeblocks. +code, pre { + direction: ltr; +} + +// Allows RTL codeblocks if `force_codeblock_ltr` is set to false. +html[data-code-direction="inherit"] { + code, pre { + direction: inherit; } } diff --git a/sass/parts/_header.scss b/sass/parts/_header.scss index fbba0bd..d88bfe3 100644 --- a/sass/parts/_header.scss +++ b/sass/parts/_header.scss @@ -24,12 +24,13 @@ header { .nav-navs { display: flex; flex-wrap: wrap; + align-items: center; ul { display: flex; - flex-wrap: wrap; - justify-content: center; - align-items: center; + flex-wrap: inherit; + justify-content: inherit; + align-items: inherit; gap: 1px; margin: 0; padding: 0; @@ -37,6 +38,18 @@ header { } } +.menu-icons-container { + display: flex; + align-items: center; + margin-left: auto; +} + +.menu-icons-group { + gap: 1px; + margin: 0; + padding: 0; +} + .nav-links { justify-content: right; padding: 0.66rem; @@ -76,11 +89,22 @@ header { ul, li { - display: inline; + display: inline-block; + margin-inline-end: 0.2rem; font-family: var(--sans-serif-font); list-style-type: none; } + + .tag { + margin-inline-end: 0; + } } + +.separator { + margin-inline-end: 0.2rem; + user-select: none; +} + .language-switcher { display: flex; justify-content: center; @@ -101,6 +125,28 @@ header { background: var(--meta-color); } } + + .language-switcher-icon-with-code { + margin-inline-end: 0.3rem; + width: 0.7rem; + height: 0.7rem; + } +} + +.language-switcher-icon-code { + position: absolute; + top: -0.15rem; + z-index: 10; + inset-inline-start: 0.7rem; + width: 100%; + height: 100%; + color: var(--text-color); + font-size: 0.5rem; + text-transform: uppercase; + + &:hover { + color: var(--meta-color); + } } .dropdown { @@ -147,21 +193,21 @@ header { .nav-navs { display: flex; - justify-content: flex-end; + justify-content: center; + } + + .menu-icons-container { + margin-left: 0; } } @media only screen and (max-width: 600px) { .nav-navs { - flex-wrap: wrap; - justify-content: center; margin-top: 0.8rem; - width: 100%; } .navbar { flex-direction: column; - justify-content: center; align-items: center; } } diff --git a/sass/parts/_home-banner.scss b/sass/parts/_home-banner.scss index 79e17a6..ce6b9c1 100644 --- a/sass/parts/_home-banner.scss +++ b/sass/parts/_home-banner.scss @@ -1,7 +1,7 @@ #banner-container-home { display: flex; - justify-content: center; - align-items: center; + justify-content: space-between; + align-items: flex-start; margin: 0.2rem auto; width: 100%; @@ -11,6 +11,7 @@ } #home-banner-text { + flex: 1; margin-block-end: 1.5rem; color: var(--primary-color); font-size: 1.875rem; @@ -53,9 +54,9 @@ #image-container-home { position: relative; + margin: auto 0; padding-inline-start: 2rem; - min-width: 11rem; - min-height: 11rem; + max-width: 11rem; overflow: hidden; text-align: center; @@ -63,9 +64,8 @@ border: none; aspect-ratio: 1 / 1; width: 100%; - max-width: 15rem; - height: auto; - max-height: 15rem; + height: 100%; + object-fit: cover; @media only screen and (max-width: 600px) { max-width: 12rem; @@ -75,6 +75,8 @@ @media only screen and (max-width: 600px) { padding-inline-start: 0; + width: 100%; + max-width: none; } } } diff --git a/sass/parts/_iine.scss b/sass/parts/_iine.scss new file mode 100644 index 0000000..9ac95c4 --- /dev/null +++ b/sass/parts/_iine.scss @@ -0,0 +1,37 @@ +.iine-button { + display: inline-flex; + align-items: center; + gap: 5px; + transition: background-color 0.2s ease, color 0.2s ease, border-color 0.2s ease; + cursor: pointer; + border: none; + background: transparent; + color: inherit; + font-family: var(--sans-serif-font); + -webkit-tap-highlight-color: transparent; + appearance: none; + margin: 0; + padding: 0; + font-size: inherit; + line-height: inherit; + + .icon { + display: inline-flex; + align-items: center; + } + + .counter { + margin-left: .2rem; + font-size: 0.8rem; + } + + svg { + width: 1em; + height: 1em; + } +} + +.iine-auto-buttons { + margin-top: 2rem; + padding: 1rem 0; +} diff --git a/sass/parts/_misc.scss b/sass/parts/_misc.scss index e5bd716..52fec23 100644 --- a/sass/parts/_misc.scss +++ b/sass/parts/_misc.scss @@ -1,3 +1,11 @@ +kbd { + border: 1px solid var(--divider-color); + border-radius: 5px; + background-color: var(--bg-0); + padding: 0.1rem 0.3rem; + font-size: 0.8rem; +} + .draft-label { margin-inline-end: 0.3rem; background-color: var(--primary-color); @@ -40,6 +48,9 @@ ul { .title-container { padding-bottom: 8px; + .social { + margin-inline-start: 0.5rem; + } } .bottom-divider { @@ -74,12 +85,45 @@ a { text-decoration: inherit; } +// External link styles with `external_links_class = "external"`. +main { + --external-link-icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cg fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2'%3E%3Cpath d='M11 5h-6v14h14v-6'/%3E%3Cpath d='M13 11l7 -7'/%3E%3Cpath d='M21 3h-6M21 3v6'/%3E%3C/g%3E%3C/svg%3E"); + + a.external:not(:has(img, svg, video, picture, figure))::after { + display: inline-block; + vertical-align: -0.05em; + margin-inline-start: 0.1em; + background-color: currentColor; + width: 0.8em; + height: 0.8em; + content: ''; + -webkit-mask-image: var(--external-link-icon); + -webkit-mask-size: 100% 100%; + } + + &:dir(rtl) a.external:not(:has(img, svg, video, picture, figure))::after { + transform: rotate(-90deg); + } + + .meta a.external:not(:has(img, svg, video, picture, figure))::after { + background-color: var(--meta-color); + } + + a.external:not(:has(img, svg, video, picture, figure)):hover::after { + background-color: var(--hover-color); + } +} + a:hover { background-color: var(--primary-color); color: var(--hover-color); } -a:not(.no-hover-padding):hover::after { +a:hover rt { + color: var(--text-color); +} + +a:not(.no-hover-padding):hover::before { display: inline-block; position: absolute; z-index: -1; @@ -88,7 +132,7 @@ a:not(.no-hover-padding):hover::after { inset-inline-end: -0.15em; inset-inline-start: -0.15em; background-color: var(--primary-color); - max-inline-size: 105%; // This fixes multi-line links (see #225) + max-inline-size: 105%; content: ""; } @@ -106,6 +150,11 @@ hr { height: 1px; } +.footnotes-list, +.footnotes { + text-align: start; +} + .footnote-reference { font-size: 0.7rem; font-family: var(--serif-font); @@ -130,7 +179,12 @@ hr { font-size: 0.8rem; } -.footnotes-list a[href^="#fr-"] { +.footnotes-list a[href^="#fr-"], +.footnotes a[href^="#fr-"] { + font-size: 0.8rem; +} + +.footnotes code { font-size: 0.8rem; } @@ -237,3 +291,65 @@ details summary { .mermaid .node .label { max-width: none !important; } + +// For the `force_text_direction` shortcode. +[data-force-text-direction="ltr"] { + direction: ltr; + unicode-bidi: bidi-override; +} + +[data-force-text-direction="rtl"] { + direction: rtl; + unicode-bidi: bidi-override; +} + +[data-force-text-direction="ltr"] *, +[data-force-text-direction="rtl"] * { + direction: inherit; +} + +.title-with-jump { + display: flex; + justify-content: space-between; + align-items: center; +} + +.title-with-jump h1 { + flex: 1; +} + +.jump-link { + flex-shrink: 0; + font-size: 0.9rem; +} + +@media (max-width: 500px) { + .title-with-jump { + flex-direction: column; + } +} + +#skip-link { + position: absolute; + top: -40px; + left: 0; + transform: translateY(-100%); + opacity: 0; + z-index: 9999; + transition: all 0.1s ease; + border-radius: 0 0 5px 0; + background-color: var(--primary-color); + padding: 4px 8px; + color: var(--hover-color); + font-weight: 500; + font-size: 0.9rem; + text-decoration: none; +} + +#skip-link:focus { + top: 0; + transform: translateY(0); + opacity: 1; + outline: 2px solid var(--text-color); + outline-offset: 2px; +} diff --git a/sass/parts/_posts_list.scss b/sass/parts/_posts_list.scss index ce38a83..e74f89c 100644 --- a/sass/parts/_posts_list.scss +++ b/sass/parts/_posts_list.scss @@ -1,24 +1,40 @@ .bloglist-container { display: grid; - grid-template-columns: 1fr; + grid-template-columns: 1fr 8fr; } -.bloglist-row { + +$padding: 2.5rem; + +.bloglist-meta { display: flex; align-items: flex-start; background-color: var(--navbar-color); - padding-block: 2.5rem; + padding-block: $padding; + min-width: 13.5rem; - .bloglist-meta { + .thumbnail-image { + margin: 0; + margin-inline: auto; // Centred by default. + max-width: 70%; + } + + li.date + li.post-thumbnail .thumbnail-image { + // Styles for the thumbnail when there's a date above (either date or updated). + margin-inline: 0; // Since metadata is left aligned, the image looks weird when centred. + margin-block-start: 0.7rem; + } + + ul { margin-inline-end: 0.7rem; padding: 0; - width: 13.5rem; color: var(--meta-color); font-weight: 300; font-size: 0.9rem; li { list-style-type: none; + white-space: nowrap; } li.draft-label { @@ -26,22 +42,33 @@ line-height: 1.2rem; } } +} - .bloglist-tags { - margin-top: 0.1rem; +.bloglist-content { + display: flex; + position: relative; + align-items: flex-start; + background-color: var(--navbar-color); + padding: $padding 0; - .tag { - display: inline-block; - margin-inline-end: 0.7rem; - font-weight: 400; - font-size: 0.75rem; - text-transform: uppercase; - } + .pinned-label { + display: flex; + position: absolute; + top: 0.8rem; + align-items: center; + gap: 0.3rem; + color: var(--meta-color); + font-weight: 300; + font-size: 0.8rem; } - .bloglist-content { - flex: 1; + .pinned-label svg { + width: 0.8rem; + height: 0.8rem; + } + div { + flex: 1; .bloglist-title { margin: 0; @@ -58,6 +85,18 @@ } } + .bloglist-tags { + margin-top: 0.1rem; + + .tag { + display: inline-block; + margin-inline-end: 0.7rem; + font-weight: 400; + font-size: 0.75rem; + text-transform: uppercase; + } + } + .description p { margin: 0.5rem 0 1rem; color: var(--text-color); @@ -86,12 +125,19 @@ } @media only screen and (max-width: 1100px) { - .bloglist-row { - flex-direction: column; - align-items: flex-start; + .bloglist-container { + display: block; + } + + .pinned-label svg { + margin-bottom: -2px; + } + + .bloglist-meta { + border-bottom: 0; padding-block: 2rem; - .bloglist-meta { + ul { margin-block-end: 0; width: 100%; @@ -101,7 +147,25 @@ } } - .bloglist-content { + .post-thumbnail { + display: none; + } + } + + .bloglist-content { + flex-direction: column; + align-items: flex-start; + padding: 0; + padding-bottom: 2rem; + + + .pinned-label { + position: static; + margin: 0; + margin-top: -1.9rem; + } + + div { width: 100%; } } diff --git a/sass/parts/_webmention.scss b/sass/parts/_webmention.scss new file mode 100644 index 0000000..b6d6338 --- /dev/null +++ b/sass/parts/_webmention.scss @@ -0,0 +1,149 @@ +#webmentions { + position: relative; + z-index: 100; + margin: 0; + background-color: var(--background-color); + color: var(--text-color); + line-height: 1.2em; + + h2 { + margin-bottom: 1.5em; + font-size: 1.1em; + } + + h3 { + display: flex; + align-items: center; + font-size: 0.9em; + + svg { + margin-inline-end: 0.2rem; + } + + .svg-icon, + span { + margin-inline-end: .3rem; + } + } + + ol { + padding: 0; + } + + li, + p { + font-family: inherit; + } + + +.likes { + display: flex; + flex-wrap: wrap; + margin-top: 0.5rem; + padding: 0; + list-style: none; + + li { + position: relative; + transition: transform 0.8s ease-out, z-index 0s linear 0.4s; + margin-bottom: .375rem; + margin-inline-start: -.75rem; + + &:first-child { + margin-inline-start: 0; + } + + &:hover { + transform: scale(1.3) translateY(-4px); + z-index: 10; + transition: transform 0.05s ease-out, z-index 0s linear 0s; + } + + img { + display: block; + border: 2px solid var(--background-color, white); + border-radius: 50%; + aspect-ratio: 1/1; + width: 2.5rem; + height: 2.5rem; + object-fit: cover; + } + } + } + + .comment { + margin-bottom: 1rem; + border-radius: 10px; + background: var(--bg-0); + padding: 1rem; + overflow: hidden; + font-size: 80%; + + div { + display: flex; + flex-wrap: nowrap; + justify-content: space-between; + align-items: center; + } + + p { + margin-bottom: 0; + line-height: 1.5em; + } + + .p-author { + font-style: bold; + font-size: 1.3em; + } + + .u-url { + font-style: italic; + text-decoration: underline; + } + + .u-author { + display: flex; + align-items: center; + + img { + display: block; + margin-inline-end: .625rem; + width: 2rem; + max-width: 100%; + height: 2rem; + } + } + } + + form { + input { + flex: 1; + border: 1px solid var(--divider-color); + border-radius: 20px 0px 0px 20px; + background-color: var(--input-background-color); + padding-inline: 1rem 1rem; + padding-block: .75rem; + width: calc(60% - 2rem); + color: var(--text-color); + font-size: 1rem; + } + + button { + flex: 1; + border: 1px solid var(--divider-color); + border-radius: 0px 20px 20px 0px; + background-color: var(--input-background-color); + padding-inline: 0.7rem 0.7rem; + padding-block: .75rem; + width: 7rem; + color: var(--text-color); + font-size: 1rem; + } + + button:hover { + cursor: pointer; + background-color: var(--primary-color); + color: var(--hover-color); + } + } +} diff --git a/scripts/release b/scripts/release new file mode 160000 index 0000000..8e0a56e --- /dev/null +++ b/scripts/release @@ -0,0 +1 @@ +Subproject commit 8e0a56e333ad53b01a6036744facaab21404d329 diff --git a/scripts/upgrade-deps b/scripts/upgrade-deps index 01f4b53..62a5d52 100755 --- a/scripts/upgrade-deps +++ b/scripts/upgrade-deps @@ -80,11 +80,30 @@ get_latest_version_github() { } get_local_mermaid_version() { - sed -n 's/.*bpt="\([^"]*\)".*/\1/p' "$MERMAID_PATH" | head -n 1 + local version + # Old format. + version=$(grep -o '[A-Za-z]\+t="[0-9]\+\.[0-9]\+\.[0-9]\+"' "$MERMAID_PATH" | grep -o '[0-9]\+\.[0-9]\+\.[0-9]\+' || true) + + # New format. + if [ -z "$version" ]; then + version=$(grep -o 'version:"[0-9]\+\.[0-9]\+\.[0-9]\+"' "$MERMAID_PATH" | grep -o '[0-9]\+\.[0-9]\+\.[0-9]\+' || true) + fi + + if [ -z "$version" ]; then + exit_with_message "Could not detect local Mermaid.js version" + fi + echo "$version" } + get_local_katex_version() { - sed -n 's/.*version:"\([^"]*\)".*/\1/p' "$KATEX_JS_PATH" | head -n 1 + local version + version=$(sed -n 's/.*version:"\([^"]*\)".*/\1/p' "$KATEX_JS_PATH" | head -n 1) + if [ -z "$version" ]; then + echo "Could not detect local KaTeX version" >&2 + return 1 + fi + echo "$version" } compare_md5() { @@ -361,17 +380,22 @@ main() { echo "Updating local repository…" git fetch origin - local git_status - git_status=$(git status -uno) - if echo "$git_status" | grep -q "Your branch is behind"; then - exit_with_message "Your local branch is behind the remote. Pull the latest changes before running this script." - elif echo "$git_status" | grep -q "Your branch is ahead"; then - echo "Your local branch is ahead of the remote. Checking if local changes can be pushed…" - if ! git push --dry-run &> /dev/null; then - exit_with_message "Unable to push local changes. Resolve any conflicts before running this script." + current_branch=$(git rev-parse --abbrev-ref HEAD) + echo "Current branch: $current_branch" + # Check if the branch exists on the remote + if git ls-remote --exit-code --heads origin "$current_branch" >/dev/null 2>&1; then + # Branch exists on remote, compare with local. + local_commit=$(git rev-parse HEAD) + remote_commit=$(git rev-parse origin/"$current_branch") + if [ "$local_commit" = "$remote_commit" ]; then + echo "Branch is up to date with origin/$current_branch" + elif git merge-base --is-ancestor "$remote_commit" "$local_commit"; then + echo "Local branch is ahead of origin/$current_branch" + else + exit_with_message "Your local branch is behind origin/$current_branch. Pull the latest changes before running this script." fi - elif ! echo "$git_status" | grep -q "Your branch is up to date"; then - exit_with_message "Unable to determine if branch is up to date. Check your git status manually." + else + echo "Branch $current_branch does not exist on remote. Assuming it's a new branch." fi echo "Local repository is ready." diff --git a/static/custom_subset.css b/static/custom_subset.css index 884f59f..13ac96e 100644 --- a/static/custom_subset.css +++ b/static/custom_subset.css @@ -1 +1 @@ -@font-face{font-family:"Inter Subset";src:url(data:application/font-woff2;base64,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);} +@font-face{font-family:"Inter Subset";src:url(data:application/font-woff2;base64,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);} diff --git a/static/feed_style.xsl b/static/feed_style.xsl index 5fa7160..1e413bb 100644 --- a/static/feed_style.xsl +++ b/static/feed_style.xsl @@ -14,7 +14,8 @@ - + + @@ -60,8 +61,8 @@
-
-
{% endif %} diff --git a/templates/partials/paginate.html b/templates/partials/paginate.html index 1833dca..6502af7 100644 --- a/templates/partials/paginate.html +++ b/templates/partials/paginate.html @@ -1,4 +1,4 @@ -{% if paginator %} +{% if paginator and paginator.number_pagers > 1 %}
    {% if paginator.previous %}
  • diff --git a/templates/partials/social_media_images.html b/templates/partials/social_media_images.html new file mode 100644 index 0000000..d6bbcc7 --- /dev/null +++ b/templates/partials/social_media_images.html @@ -0,0 +1,50 @@ +{%- set social_media_card = macros_settings::evaluate_setting_priority(setting="social_media_card", page=page | default(value=""), section=section | default(value=""), default_global_value="") -%} +{% if social_media_card %} + {# Get base path from page/section #} + {% set base_path = "" %} + {% if section and section.path %} + {% set base_path = section.path | trim_end_matches(pat="/_index.md") %} + {% if base_path and not social_media_card is starting_with("/") %} + {% set base_path = base_path ~ "/" %} + {% endif %} + {% else %} + {% set base_path = page.colocated_path | default(value="") %} + {% endif %} + + {% set current_path = base_path ~ social_media_card | trim_start_matches(pat="/") %} + + {# Try parent path by removing the last directory component #} + {% set parent_path = base_path | split(pat="/") | slice(end=-2) | join(sep="/") %} + {% if parent_path and not social_media_card is starting_with("/") %} + {% set parent_path = parent_path ~ "/" %} + {% endif %} + {% set parent_relative_path = parent_path ~ social_media_card | trim_start_matches(pat="/") %} + + {# Check all possible locations #} + {%- set current_meta = get_image_metadata(path=current_path, allow_missing=true) -%} + {%- set parent_meta = get_image_metadata(path=parent_relative_path, allow_missing=true) -%} + {%- set absolute_meta = get_image_metadata(path=social_media_card, allow_missing=true) -%} + + {% if current_meta %} + {% set final_path = current_path %} + {% set meta = current_meta %} + {% elif parent_meta %} + {% set final_path = parent_relative_path %} + {% set meta = parent_meta %} + {% elif absolute_meta %} + {% set final_path = social_media_card %} + {% set meta = absolute_meta %} + {% else %} + {{ throw(message="Could not find social media card image. Tried: + 1. Current page path: '" ~ current_path ~ "' + 2. Parent page path: '" ~ parent_relative_path ~ "' + 3. Absolute path: '" ~ social_media_card ~ "' + Please ensure the file exists at one of these locations.") }} + {% endif %} + + + + + + +{% endif %} diff --git a/templates/partials/title.html b/templates/partials/title.html index 297390a..de77d73 100644 --- a/templates/partials/title.html +++ b/templates/partials/title.html @@ -1,4 +1,7 @@ {#- Setup -#} +{% if not config.title %} +{{ throw(message="ERROR: No `title` set in `config.toml`. tabi requires a title to function.") }} +{% endif %} {%- set prefix = config.title | safe -%} {%- set custom_separator = config.extra.separator | default(value="•") -%} {%- set separator = " " ~ custom_separator ~ " " -%} diff --git a/templates/partials/webmentions.html b/templates/partials/webmentions.html new file mode 100644 index 0000000..e579a04 --- /dev/null +++ b/templates/partials/webmentions.html @@ -0,0 +1,51 @@ +{# Incorporate webmention.io links and script into the page head. +1. Provide the link to the webmention data in the at webmention.io. +2. Link to the stylesheet for styling webmentions on a page. +3. Add and configure the javascript to fetch and display the webmentions collected at webmention.io. #} + + + +{# Calculate the configured data for the script, if any #} + +{% set script_data = "" %} + +{% if config.extra.webmentions.id %} +{% set script_data = script_data ~ "data-id=" ~ config.extra.webmentions.id %} +{% endif %} + +{% if config.extra.webmentions.page_url %} +{% set script_data = script_data ~ " data-page-url=" ~ config.extra.webmentions.page_url %} +{% endif %} + +{% if config.extra.webmentions.add_urls %} +{% set script_data = script_data ~ "data-add-urls=" ~ config.extra.webmentions.add_urls %} +{% endif %} + +{% if config.extra.webmentions.wordcount %} +{% set script_data = script_data ~ " data-wordcount=" ~ config.extra.webmentions.wordcount %} +{% endif %} + +{% if config.extra.webmentions.max_webmentions %} +{% set script_data = script_data ~ "data-max-webmentions=" ~ config.extra.webmentions.max_webmentions %} +{% endif %} + +{% if config.extra.webmentions.prevent_spoofing %} +{% set script_data = script_data ~ "data-prevent-spoofing=" ~ config.extra.webmentions.prevent_spoofing %} +{% endif %} + +{% if config.extra.webmentions.sort_by %} +{% set script_data = script_data ~ "data-sort-by=" ~ config.extra.webmentions.sort_by %} +{% endif %} + +{% if config.extra.webmentions.sort_dir %} +{% set script_data = script_data ~ "data-sort-dir=" ~ config.extra.webmentions.sort_dir %} +{% endif %} + +{% if config.extra.webmentions.comments_are_reactions %} +{% set script_data = script_data ~ " data-comments-are-reactions=" ~ config.extra.webmentions.comments_are_reactions %} +{% endif %} + + + +
    diff --git a/templates/section.html b/templates/section.html index 34802c6..3739461 100644 --- a/templates/section.html +++ b/templates/section.html @@ -2,6 +2,16 @@ {% block main_content %} +{# We'll only pin posts in the root section. #} +{# Right now both the main page and blog/ use the same `section.html` template. #} +{# To avoid using different templates, we do this. #} +{%- if lang == config.default_language -%} + {%- set expected_root = "/" -%} +{%- else -%} + {%- set expected_root = "/" ~ lang ~ "/" -%} +{%- endif -%} +{%- set is_root_section = current_path == expected_root -%} + {%- set show_projects_first = section.extra.show_projects_first | default(value=false) -%} {%- if show_projects_first -%} {%- set first_section = "projects" -%} @@ -14,8 +24,15 @@ {%- endif -%}
    +{%- if config.extra.hcard %} + {%- include "partials/hcard.html" -%} +{% endif -%} {%- if section.extra.header %} {%- include "partials/home_banner.html" -%} +{%- elif section.content -%} +
    + {{ section.content | safe }} +
    {% endif -%} {% if section.extra.section_path -%} @@ -37,4 +54,6 @@ {%- endif -%}
    +{%- include "partials/extra_features.html" -%} + {% endblock main_content %} diff --git a/templates/series.html b/templates/series.html new file mode 100644 index 0000000..5a4cc0c --- /dev/null +++ b/templates/series.html @@ -0,0 +1,62 @@ +{% extends "base.html" %} + +{% block main_content %} + +{# Throw an error if the section is not flagged as a series. #} +{# This page would be displayed properly but it would become impossible for the series' child pages to reference their series. #} +{%- if "series" not in section.extra or not section.extra.series -%} + {{ throw(message="Section is not flagged as a series. Set `section.extra.series` to `true` if you want to use `series.html` template.") }} +{%- endif -%} + +
    +{%- if section.extra.header %} + {%- include "partials/home_banner.html" -%} +{% endif -%} + + {%- set show_jump = false -%} + {%- set show_jump_hierarchy = macros_settings::evaluate_setting_priority(setting="show_jump_to_posts", page=section) -%} + {%- if show_jump_hierarchy == "true" -%} + {%- set show_jump = true -%} + {%- elif show_jump_hierarchy != "false" -%} + {#- Default to true if the content is long and var is unset #} + {%- if section.content | length > 2000 -%} + {%- set show_jump = true -%} + {%- endif -%} + {%- endif -%} + + {%- if show_jump -%} +
    +

    {{ section.title }}

    + {{ macros_translate::translate(key="jump_to_posts", default="Jump to posts", language_strings=language_strings) }} ↓ +
    + {%- else -%} + {{ macros_page_header::page_header(title=section.title) }} + {%- endif -%} + +
    + {{ section.content | safe }} +
    + +
    +

    + {{ macros_translate::translate(key="all_posts", default="All posts", language_strings=language_strings) }} +

    + {%- if paginator %} + {%- set pages = paginator.pages -%} + {% else %} + {%- set pages = section.pages -%} + {% endif -%} + + {% set max_posts = section.extra.max_posts | default(value=999999) %} + {{ macros_list_posts::list_posts(posts=pages, max=max_posts, metadata="indexes", language_strings=language_strings, section_path=section.path, paginator=paginator | default(value="")) }} +
    + + {% if paginator %} + {%- include "partials/paginate.html" -%} + {% endif %} + +
    + +{%- include "partials/extra_features.html" -%} + +{% endblock main_content %} diff --git a/templates/shortcodes/admonition.html b/templates/shortcodes/admonition.html index ce6758e..3519527 100644 --- a/templates/shortcodes/admonition.html +++ b/templates/shortcodes/admonition.html @@ -1,6 +1,7 @@ {%- set type = type | default(value="info") -%} {%- set title = title | default(value=type | upper) -%} {%- set icon = icon | default(value=type) -%} +{%- set text = text | default(value=body) -%}
    diff --git a/templates/shortcodes/aside.html b/templates/shortcodes/aside.html new file mode 100644 index 0000000..ca337f9 --- /dev/null +++ b/templates/shortcodes/aside.html @@ -0,0 +1,5 @@ +{%- set text = text | default(value=body) -%} + + diff --git a/templates/shortcodes/dimmable_image.html b/templates/shortcodes/dimmable_image.html index 327ff51..a72720c 100644 --- a/templates/shortcodes/dimmable_image.html +++ b/templates/shortcodes/dimmable_image.html @@ -1,5 +1,5 @@ {#- Determine image path based on whether the src is remote or local -#} -{%- if src is starting_with("http") -%} +{%- if src is starting_with("http") or raw_path -%} {%- set image_url = src -%} {%- else -%} {%- set colocated_path = page.colocated_path | default(value="") -%} @@ -9,9 +9,9 @@ {#- Fallback to absolute path if relative path doesn't work -#} {%- if not meta -%} {%- set meta = get_image_metadata(path=src, allow_missing=true) -%} - {%- set image_url = get_url(path=src) -%} + {%- set image_url = get_url(path=src, cachebust=true) -%} {%- else -%} - {%- set image_url = get_url(path=relative_path) -%} + {%- set image_url = get_url(path=relative_path, cachebust=true) -%} {%- endif -%} {%- endif -%} diff --git a/templates/shortcodes/dual_theme_image.html b/templates/shortcodes/dual_theme_image.html index b73ae03..5eadc09 100644 --- a/templates/shortcodes/dual_theme_image.html +++ b/templates/shortcodes/dual_theme_image.html @@ -10,28 +10,28 @@ {%- endif -%} {# Handling for light mode image #} -{%- if light_src is starting_with("http") -%} +{%- if light_src is starting_with("http") or raw_path -%} {%- set light_image_url = light_src -%} {%- else -%} {%- set relative_light_path = colocated_path ~ light_src -%} {%- set light_meta = get_image_metadata(path=relative_light_path, allow_missing=true) -%} {%- if not light_meta -%} - {%- set light_image_url = get_url(path=light_src) -%} + {%- set light_image_url = get_url(path=light_src, cachebust=true) -%} {%- else -%} - {%- set light_image_url = get_url(path=relative_light_path) -%} + {%- set light_image_url = get_url(path=relative_light_path, cachebust=true) -%} {%- endif -%} {%- endif -%} {# Handling for dark mode image #} -{%- if dark_src is starting_with("http") -%} +{%- if dark_src is starting_with("http") or raw_path -%} {%- set dark_image_url = dark_src -%} {%- else -%} {%- set relative_dark_path = colocated_path ~ dark_src -%} {%- set dark_meta = get_image_metadata(path=relative_dark_path, allow_missing=true) -%} {%- if not dark_meta -%} - {%- set dark_image_url = get_url(path=dark_src) -%} + {%- set dark_image_url = get_url(path=dark_src, cachebust=true) -%} {%- else -%} - {%- set dark_image_url = get_url(path=relative_dark_path) -%} + {%- set dark_image_url = get_url(path=relative_dark_path, cachebust=true) -%} {%- endif -%} {%- endif -%} diff --git a/templates/shortcodes/force_text_direction.html b/templates/shortcodes/force_text_direction.html new file mode 100644 index 0000000..79d9697 --- /dev/null +++ b/templates/shortcodes/force_text_direction.html @@ -0,0 +1,5 @@ +{%- set direction = direction | default(value="ltr") -%} + +
    + {{ body | markdown | safe }} +
    diff --git a/templates/shortcodes/full_width_image.html b/templates/shortcodes/full_width_image.html index 41809a7..a50bf10 100644 --- a/templates/shortcodes/full_width_image.html +++ b/templates/shortcodes/full_width_image.html @@ -1,5 +1,5 @@ {#- Set paths based on whether the src is remote or local -#} -{%- if src is starting_with("http") -%} +{%- if src is starting_with("http") or raw_path -%} {%- set image_url = src -%} {%- else -%} {%- set colocated_path = page.colocated_path | default(value="") -%} @@ -9,9 +9,9 @@ {#- Fallback to absolute path if relative path doesn't work -#} {%- if not meta -%} {%- set meta = get_image_metadata(path=src, allow_missing=true) -%} - {%- set image_url = get_url(path=src) -%} + {%- set image_url = get_url(path=src, cachebust=true) -%} {%- else %} - {%- set image_url = get_url(path=relative_path) -%} + {%- set image_url = get_url(path=relative_path, cachebust=true) -%} {%- endif -%} {%- endif -%} diff --git a/templates/shortcodes/iine.html b/templates/shortcodes/iine.html new file mode 100644 index 0000000..d37211d --- /dev/null +++ b/templates/shortcodes/iine.html @@ -0,0 +1,5 @@ +{% set button_icon = icon | default(value="heart") %} +{% set label = label | default(value="Like this post") %} +{% set slug = slug | default(value=page.path) %} + +{% include "partials/iine_button.html" %} diff --git a/templates/shortcodes/image_hover.html b/templates/shortcodes/image_hover.html index d00967a..443329b 100644 --- a/templates/shortcodes/image_hover.html +++ b/templates/shortcodes/image_hover.html @@ -15,28 +15,28 @@ {%- endif -%} {#- Direct or relative URL handling for default image -#} -{%- if default_src is starting_with("http") -%} +{%- if default_src is starting_with("http") or raw_path -%} {%- set default_image_url = default_src -%} {%- else -%} {%- set relative_default_path = colocated_path ~ default_src -%} {%- set default_meta = get_image_metadata(path=relative_default_path, allow_missing=true) -%} {%- if not default_meta -%} - {%- set default_image_url = get_url(path=default_src) -%} + {%- set default_image_url = get_url(path=default_src, cachebust=true) -%} {%- else -%} - {%- set default_image_url = get_url(path=relative_default_path) -%} + {%- set default_image_url = get_url(path=relative_default_path, cachebust=true) -%} {%- endif -%} {%- endif -%} {#- Direct or relative URL handling for hovered image -#} -{%- if hovered_src is starting_with("http") -%} +{%- if hovered_src is starting_with("http") or raw_path -%} {%- set hovered_image_url = hovered_src -%} {%- else -%} {%- set relative_hovered_path = colocated_path ~ hovered_src -%} {%- set hovered_meta = get_image_metadata(path=relative_hovered_path, allow_missing=true) -%} {%- if not hovered_meta -%} - {%- set hovered_image_url = get_url(path=hovered_src) -%} + {%- set hovered_image_url = get_url(path=hovered_src, cachebust=true) -%} {%- else -%} - {%- set hovered_image_url = get_url(path=relative_hovered_path) -%} + {%- set hovered_image_url = get_url(path=relative_hovered_path, cachebust=true) -%} {%- endif -%} {%- endif -%} diff --git a/templates/shortcodes/image_toggler.html b/templates/shortcodes/image_toggler.html index 2fd811b..991d5f5 100644 --- a/templates/shortcodes/image_toggler.html +++ b/templates/shortcodes/image_toggler.html @@ -19,28 +19,28 @@ {%- endif -%} {# Direct or relative URL handling for default image #} -{%- if default_src is starting_with("http") -%} +{%- if default_src is starting_with("http") or raw_path -%} {%- set default_image_url = default_src -%} {%- else -%} {%- set relative_default_path = colocated_path ~ default_src -%} {%- set default_meta = get_image_metadata(path=relative_default_path, allow_missing=true) -%} {%- if not default_meta -%} - {%- set default_image_url = get_url(path=default_src) -%} + {%- set default_image_url = get_url(path=default_src, cachebust=true) -%} {%- else -%} - {%- set default_image_url = get_url(path=relative_default_path) -%} + {%- set default_image_url = get_url(path=relative_default_path, cachebust=true) -%} {%- endif -%} {%- endif -%} {# Direct or relative URL handling for toggled image #} -{%- if toggled_src is starting_with("http") -%} +{%- if toggled_src is starting_with("http") or raw_path -%} {%- set toggled_image_url = toggled_src -%} {%- else -%} {%- set relative_toggled_path = colocated_path ~ toggled_src -%} {%- set toggled_meta = get_image_metadata(path=relative_toggled_path, allow_missing=true) -%} {%- if not toggled_meta -%} - {%- set toggled_image_url = get_url(path=toggled_src) -%} + {%- set toggled_image_url = get_url(path=toggled_src, cachebust=true) -%} {%- else -%} - {%- set toggled_image_url = get_url(path=relative_toggled_path) -%} + {%- set toggled_image_url = get_url(path=relative_toggled_path, cachebust=true) -%} {%- endif -%} {%- endif -%} diff --git a/templates/shortcodes/invertible_image.html b/templates/shortcodes/invertible_image.html index b036269..0e3c920 100644 --- a/templates/shortcodes/invertible_image.html +++ b/templates/shortcodes/invertible_image.html @@ -1,5 +1,5 @@ {#- Determine if src is a remote URL or a local path -#} -{%- if src is starting_with("http") -%} +{%- if src is starting_with("http") or raw_path -%} {%- set image_url = src -%} {%- else -%} {%- set colocated_path = page.colocated_path | default(value="") -%} @@ -9,9 +9,9 @@ {#- Fallback to absolute path if relative path doesn't work -#} {%- if not meta -%} {%- set meta = get_image_metadata(path=src, allow_missing=true) -%} - {%- set image_url = get_url(path=src) -%} + {%- set image_url = get_url(path=src, cachebust=true) -%} {%- else %} - {%- set image_url = get_url(path=relative_path) -%} + {%- set image_url = get_url(path=relative_path, cachebust=true) -%} {%- endif -%} {%- endif -%} diff --git a/templates/tags/single.html b/templates/tags/single.html index 29d6158..2f25fd2 100644 --- a/templates/tags/single.html +++ b/templates/tags/single.html @@ -2,7 +2,13 @@ {% block main_content %} -{{ macros_page_header::page_header(title=term.name) }} +{#- Feed icon -#} +{%- set generate_feed = feed_utils::get_generate_feed() == "true" -%} +{%- set feed_url = feed_utils::get_feed_url() -%} +{%- set feed_pre_conditions = generate_feed and feed_url and taxonomy.feed -%} +{%- set show_feed_icon = feed_pre_conditions and term.pages | filter(attribute="date") -%} + +{{ macros_page_header::page_header(title=term.name, show_feed_icon=show_feed_icon) }} {% set max = section.extra.max_posts | default(value=999999) %} {{ macros_list_posts::list_posts(posts=term.pages, max=max, language_strings=language_strings) }} diff --git a/templates/taxonomy_single.html b/templates/taxonomy_single.html index bce132a..ff09a3b 100644 --- a/templates/taxonomy_single.html +++ b/templates/taxonomy_single.html @@ -2,7 +2,13 @@ {% block main_content %} -{{ macros_page_header::page_header(title=term.name) }} +{#- Feed icon -#} +{%- set generate_feed = feed_utils::get_generate_feed() == "true" -%} +{%- set feed_url = feed_utils::get_feed_url() -%} +{%- set feed_pre_conditions = generate_feed and feed_url and taxonomy.feed -%} +{%- set show_feed_icon = feed_pre_conditions and term.pages | filter(attribute="date") | length > 0 -%} + +{{ macros_page_header::page_header(title=term.name, show_feed_icon=show_feed_icon) }} {% set max = section.extra.max_posts | default(value=999999) %} {{ macros_list_posts::list_posts(posts=term.pages, max=max, language_strings=language_strings) }} diff --git a/theme.toml b/theme.toml index e3a7770..c3ecdb6 100644 --- a/theme.toml +++ b/theme.toml @@ -1,5 +1,5 @@ name = "tabi" -description = "A fast, lightweight, and modern Zola theme with multi-language support, optional JavaScript, and a perfect Lighthouse score" +description = "tabi is an accessible Zola theme with search, multi-language support, optional JavaScript, a perfect Lighthouse score, and comprehensive documentation. Crafted for personal websites and blogs." license = "MIT" homepage = "https://github.com/welpo/tabi" @@ -56,6 +56,9 @@ skin = "" # browser_theme_color = "#087e96" # Example of single value. # browser_theme_color = ["#ffffff", "#000000"] # Example of light/dark colours. +# Show current language code on the language switcher +show_selected_language_code_in_language_switcher = false + # List additional stylesheets to load site-wide. # These stylesheets should be located in your site's `static` directory. # Example: stylesheets = ["extra1.css", "path/extra2.css"] @@ -87,9 +90,14 @@ show_remote_source = true # Defaults to true. # Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy copy_button = true -# Loads the necessary JavaScript (~400 bytes) to use the "Show source or path" shortcode: https://welpo.github.io/tabi/blog/shortcodes/#show-source-or-path +# Make code block names clickable if they are URLs (loads ~400 bytes of JavaScript). # Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy -add_src_to_code_block = false +code_block_name_links = false + +# Force left-to-right (LTR) direction for code blocks. +# Set to false to allow code to follow the document's natural direction. +# Can be set at page or section levels. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy +force_codeblock_ltr = true # Show the author(s) of a page. # Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy @@ -109,6 +117,24 @@ show_date = true # "both" - Show both the original date and the last updated date. post_listing_date = "date" +# Enable iine like buttons on all posts: https://iine.to/ +# Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy +iine = false +iine_icon = "heart" # See https://iine.to/#customise +# Unify like counts across all language versions of the same page. +# When enabled, likes on /es/blog/hello/ will count towards /blog/hello/ (default language). +iine_unified_languages = true + +# Show "Jump to posts" link next to series' title. +# By default, the link appears automatically when a series description exceeds 2000 characters. +# Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy +# show_jump_to_posts = true + +# Determines if indexes should be increasing (false) or decreasing (true) in series' posts list. +# It has only effect if the section uses indexes metadata (which is only the case for series as of now). +# Can be set at section levels, following the hierarchy: section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy +post_listing_index_reversed = false # Defaults to false. + # DEPRECATED! # Use Zola's built-in `bottom_footnotes = true` in the [markdown] section instead. (Available since v0.19.0) # Adds backlinks to footnotes (loads ~500 bytes of JavaScripts). @@ -160,6 +186,17 @@ quick_navigation_buttons = false # Default is "6th July 2049" in English and "%-d %B %Y" in other languages. short_date_format = "" +# Date format used for the archive page. +# Default is "06 July" in English and "%d %b" in other languages. +# archive_date_format = "" + +# Per-language date format overrides. +# Examples: Spanish uses "3 de febrero de 2024", German uses "3. Februar 2024" +# date_formats = [ +# { lang = "es", long = "%d de %B de %Y", short = "%d %b %Y" }, +# { lang = "de", long = "%d. %B %Y", short = "%d.%m.%Y" }, +# ] + # Custom separator used in title tag and posts metadata (between date, time to read, and tags). separator = "•" @@ -173,6 +210,12 @@ compact_tags = false # Default: "name". tag_sorting = "name" +# Show clickable tags above cards.html template (e.g. projects/) to filter the displayed items. +# Loads JS to filter. If JS is disabled, the buttons are links to the tag's page. +# Can be set at the section or config.toml level, following the hierarchy: section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy +# Default: true +enable_cards_tag_filtering = true + # Invert the order of the site title and page title in the browser tab. # Example: true => "Blog • ~/tabi", false => "~/tabi • Blog" invert_title_order = false @@ -224,6 +267,11 @@ encode_plaintext_email = true # Setting is ignored if email is already encoded. # { name = "spotify", url = "https://open.spotify.com/artist/5Hv2bYBhMp1lUHFri06xkE", icon = "spotify" }, # ] +# Fediverse profile. +# Adds metadata to feature the author's profile in Mastodon link previews. +# Example: for @username@example.com, use: +# fediverse_creator = { handle = "username", domain = "example.com" } + # Extra menu to show on the footer, below socials section. # footer_menu = [ # {url = "about", name = "about", trailing_slash = true}, @@ -265,11 +313,15 @@ allowed_domains = [ # Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy enable_csp = true -# Custom subset of characters for the header. -# If set to true, the `static/custom_subset.css` file will be loaded first. -# This avoids a flashing text issue in Firefox. -# Please see https://welpo.github.io/tabi/blog/custom-font-subset/ to learn how to create this file. -# custom_subset = true +# Font subsetting configuration. +# This feature helps prevent text flashing in Firefox when using custom fonts. +# See: https://welpo.github.io/tabi/blog/custom-font-subset/ +# Enable or disable font subsetting completely, both built-in and custom subsets. +enable_subset = true +# Use a custom subset of characters for the header. +# If true, tabi will load the `static/custom_subset.css` file. +# If false, tabi will use the default language-specific subset (English or Spanish). +custom_subset = true [extra.analytics] # Specify which analytics service you want to use. @@ -280,7 +332,7 @@ enable_csp = true # For GoatCounter, this is the code you choose during signup. # For Umami, this is the website ID. # For Plausible, this is the domain name (e.g. "example.com"). -# Note: Leave this field empty if you're self-hosting. +# Note: Leave this field empty if you're self-hosting GoatCounter. # id = "yourID" # Optional: Specify the URL for self-hosted analytics instances. @@ -290,6 +342,9 @@ enable_csp = true # Leave this field empty if you're using the service's default hosting. # self_hosted_url = "" +# Optional: For Umami, enable this option to respect users' Do Not Track (DNT) settings. The default is true. +do_not_track = true + # giscus support for comments. https://giscus.app # Setup instructions: https://welpo.github.io/tabi/blog/comments/#setup [extra.giscus] @@ -345,3 +400,69 @@ enable_csp = true # voting = true # page_author_hashes = "" # hash (or list of hashes) of the author. # lazy_loading = true # Loads when the comments are in the viewport (using the Intersection Observer API). + +[extra.webmentions] +# To disable for a specific section or page, set webmentions = false in that page/section's front matter's [extra] section. +enable = false +# Specify the domain registered with webmention.io. +# domain = "" + +# The HTML ID for the object to fill in with the webmention data. +# Defaults to "webmentions" +# id = "webmentions" + +# data configuration for the webmention.min.js script +# The base URL to use for this page. Defaults to window.location +# page_url = + +# Additional URLs to check, separated by |s +# add_urls + +# The maximum number of words to render in reply mentions. +# wordcount = 20 + +# The maximum number of mentions to retrieve. Defaults to 30. +# max_webmentions = 30 + +# By default, Webmentions render using the mf2 'url' element, which plays +# nicely with webmention bridges (such as brid.gy and telegraph) +# but allows certain spoofing attacks. If you would like to prevent +# spoofing, set this to a non-empty string (e.g. "true"). +# prevent_spoofing + +# What to order the responses by; defaults to 'published'. See +# https://github.com/aaronpk/webmention.io#api +# sort_by + +# The order to sort the responses by; defaults to 'up' (i.e. oldest +# first). See https://github.com/aaronpk/webmention.io#api +# sort_dir + +# If set to a non-empty string (e.g. "true"), will display comment-type responses +# (replies/mentions/etc.) as being part of the reactions +# (favorites/bookmarks/etc.) instead of in a separate comment list. +# comments_are_reactions = "true" + +# h-card configuration +# Will identify you on the indieweb (see https://microformats.org/wiki/h-card) +[extra.hcard] +# Enable home page h-card. +enable = true +# Add your email to the card if extra.email is set and not encoded. +# with_mail = true +# Add your social links ('socials' config) to the card. +with_social_links = true +# Homepage url. Defaults to the value of 'base_url'. +# homepage = "https://myhomepage.net" +# avatar = "img/profile.webp" +# Display name, default to the value of 'author'. +# full_name = "John Doe" +# Small bio, as shown on social media profiles. +# biography = "Fond of the indieweb" +# +# You can add any property from https://microformats.org/wiki/h-card#Properties +# Make sure to replace all '-' characters by '_' +# Examples: +# p_nickname = "nickname" +# p_locality = "Bordeaux" +# p_country_name = "France"