بص بحاول ارفع موقع انشاته من تمبلت من جت هب وخلصته...

Question

بص بحاول ارفع موقع انشاته من تمبلت من جت هب وخلصته مع شات تاني بس في مشاكل في الرفع بص اخر احاجه ظهرت في تريمنال
metadata.url = https://YousefMohamd.github.io
Yousef@Apples-MacBook-Pro my-portfolio % node -e "const fs=require('fs');const p='_data/metadata.json';let j=fs.existsSync(p)?JSON.parse(fs.readFileSync(p)):{author:{}};j.url=j.url||'https://yousefmohamd.github.io';fs.writeFileSync(p,JSON.stringify(j,null,2));console.log('metadata.url =',j.url)"

metadata.url = https://YousefMohamd.github.io
Yousef@Apples-MacBook-Pro my-portfolio % git commit -m "Upgrade Eleventy to v2 + enable RSS filters"
On branch main
Your branch is up to date with 'origin/main'.

Changes not staged for commit:
modified: .eleventy.js
modified: package.json

no changes added to commit
Yousef@Apples-MacBook-Pro my-portfolio % git push origin main
Everything up-to-date
Yousef@Apples-MacBook-Pro my-portfolio %
applypatch << 'EOF'
*** Begin Patch
*** Update File: .eleventy.js
@@
module.exports = function(eleventyConfig) {
eleventyConfig.addPlugin(pluginRss);

// Fallback filters لو CI لسه ماسك نسخة قديمة
eleventyConfig.addFilter("htmlDateString", (dateObj) => {
const d = new Date(dateObj);
return d.toISOString();
});
*** End Patch
EOF

zsh: command not found: applypatch
Yousef@Apples-MacBook-Pro my-portfolio % applypatch << 'EOF'
*** Begin Patch
*** Update File: .eleventy.js
@@
module.exports = function(eleventyConfig) {
eleventyConfig.addPlugin(pluginRss);

// Fallback filters لو CI لسه ماسك نسخة قديمة
eleventyConfig.addFilter("htmlDateString", (dateObj) => {
const d = new Date(dateObj);
return d.toISOString();
});
*** End Patch
EOF

zsh: command not found: applypatch
Yousef@Apples-MacBook-Pro my-portfolio % cd ~/my-portfolio

اضف الملفات المعدّلة لمؤشر git

git add package.json package-lock.json .eleventy.js _data/metadata.json

اعمل commit

git commit -m "Upgrade Eleventy to v2 + enable RSS filters"

ابعته لـ GitHub

git push origin main

zsh: command not found: #
The following paths are ignored by one of your .gitignore files:
package-lock.json
Use -f if you really want to add them.
zsh: command not found: #
[main 55fc91a] Upgrade Eleventy to v2 + enable RSS filters
2 files changed, 3 insertions(+), 5 deletions(-)
zsh: command not found: #
Counting objects: 4, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (4/4), done.
Writing objects: 100% (4/4), 405 bytes | 405.00 KiB/s, done.
Total 4 (delta 3), reused 0 (delta 0)
remote: Resolving deltas: 100% (3/3), completed with 3 local objects.
To https://github.com/YousefMohamd/YousefMohamd.github.io.git
cbb1d8d..55fc91a main -> main
Yousef@Apples-MacBook-Pro my-portfolio % npx @11ty/eleventy --version # لازم يطبع 2.x
npx @11ty/eleventy # يبني لـ _site بدون Errors

[11ty] Eleventy CLI Fatal Error: (more in DEBUG output)
[11ty] We don’t know what '#' is. Use --help to see the list of supported commands. (via EleventyCommandCheckError)
[11ty]
[11ty] Original error stack trace: EleventyCommandCheckError: We don’t know what '#' is. Use --help to see the list of supported commands.
[11ty] at Object.unknown [as unknownFn] (/Users/Yousef/my-portfolio/node_modules/@11ty/eleventy/cmd.js:36:13)
[11ty] at module.exports (/Users/Yousef/my-portfolio/node_modules/minimist/index.js:234:34)
[11ty] at Object.<anonymous> (/Users/Yousef/my-portfolio/node_modules/@11ty/eleventy/cmd.js:19:35)
[11ty] at Module._compile (node:internal/modules/cjs/loader:1688:14)
[11ty] at Object..js (node:internal/modules/cjs/loader:1820:10)
[11ty] at Module.load (node:internal/modules/cjs/loader:1423:32)
[11ty] at Function._load (node:internal/modules/cjs/loader:1246:12)
[11ty] at TracingChannel.traceSync (node:diagnostics_channel:322:14)
[11ty] at wrapModuleLoad (node:internal/modules/cjs/loader:235:24)
[11ty] at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:171:5)
[11ty] Eleventy CLI Fatal Error: (more in DEBUG output)
[11ty] We don’t know what '#' is. Use --help to see the list of supported commands. (via EleventyCommandCheckError)
[11ty]
[11ty] Original error stack trace: EleventyCommandCheckError: We don’t know what '#' is. Use --help to see the list of supported commands.
[11ty] at Object.unknown [as unknownFn] (/Users/Yousef/my-portfolio/node_modules/@11ty/eleventy/cmd.js:36:13)
[11ty] at module.exports (/Users/Yousef/my-portfolio/node_modules/minimist/index.js:234:34)
[11ty] at Object.<anonymous> (/Users/Yousef/my-portfolio/node_modules/@11ty/eleventy/cmd.js:19:35)
[11ty] at Module._compile (node:internal/modules/cjs/loader:1688:14)
[11ty] at Object..js (node:internal/modules/cjs/loader:1820:10)
[11ty] at Module.load (node:internal/modules/cjs/loader:1423:32)
[11ty] at Function._load (node:internal/modules/cjs/loader:1246:12)
[11ty] at TracingChannel.traceSync (node:diagnostics_channel:322:14)
[11ty] at wrapModuleLoad (node:internal/modules/cjs/loader:235:24)
[11ty] at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:171:5)
Yousef@Apples-MacBook-Pro my-portfolio % >....
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 20
cache: npm
- run: npm ci
- run: npm run build
- run: touch _site/.nojekyll
- uses: actions/upload-pages-artifact@v3
with:
path: _site

deploy:
needs: build
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- id: deployment
uses: actions/deploy-pages@v4
EOF

git add .github/workflows/deploy.yml
git commit -m "Add Eleventy deploy workflow"
git push origin main

[main 1c0abbc] Add Eleventy deploy workflow
1 file changed, 10 insertions(+), 22 deletions(-)
Counting objects: 5, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (4/4), done.
Writing objects: 100% (5/5), 536 bytes | 536.00 KiB/s, done.
Total 5 (delta 2), reused 0 (delta 0)
remote: Resolving deltas: 100% (2/2), completed with 2 local objects.
To https://github.com/YousefMohamd/YousefMohamd.github.io.git
55fc91a..1c0abbc main -> main
Yousef@Apples-MacBook-Pro my-portfolio %
ودي الاخطاء الي علي جت هب
Run actions/setup-node@v4
Found in cache @ /opt/hostedtoolcache/node/20.19.4/x64
Environment details
/opt/hostedtoolcache/node/20.19.4/x64/bin/npm config get cache
/home/runner/.npm
Error: Dependencies lock file is not found in /home/runner/work/YousefMohamd.github.io/YousefMohamd.github.io. Supported file patterns: package-lock.json,npm-shrinkwrap.json,yarn.lock

Run npm run build
npm run build
shell: /usr/bin/bash -e {0}

[email protected] build
eleventy

[11ty] Problem writing Eleventy templates: (more in DEBUG output)
[11ty] 1. Having trouble rendering njk template ./archive.njk (via TemplateContentRenderError)
[11ty] 2. (./archive.njk)
[11ty] Template render error: (/home/runner/work/YousefMohamd.github.io/YousefMohamd.github.io/_includes/postslist.njk)
[11ty] Error: filter not found: htmlDateString (via Template render error)
[11ty]
[11ty] Original error stack trace: Template render error: (./archive.njk)
[11ty] Template render error: (/home/runner/work/YousefMohamd.github.io/YousefMohamd.github.io/_includes/postslist.njk)
[11ty] Error: filter not found: htmlDateString
[11ty] at Object._prettifyError (/home/runner/work/YousefMohamd.github.io/YousefMohamd.github.io/node_modules/nunjucks/src/lib.js:32:11)
[11ty] at /home/runner/work/YousefMohamd.github.io/YousefMohamd.github.io/node_modules/nunjucks/src/environment.js:464:19
[11ty] at eval (eval at _compile (/home/runner/work/YousefMohamd.github.io/YousefMohamd.github.io/node_modules/nunjucks/src/environment.js:527:18), <anonymous>:30:11)
[11ty] at /home/runner/work/YousefMohamd.github.io/YousefMohamd.github.io/node_modules/nunjucks/src/environment.js:471:11
[11ty] at Template.root [as rootRenderFunc] (eval at _compile (/home/runner/work/YousefMohamd.github.io/YousefMohamd.github.io/node_modules/nunjucks/src/environment.js:527:18), <anonymous>:105:3)
[11ty] at Template.render (/home/runner/work/YousefMohamd.github.io/YousefMohamd.github.io/node_modules/nunjucks/src/environment.js:454:10)
[11ty] at eval (eval at _compile (/home/runner/work/YousefMohamd.github.io/YousefMohamd.github.io/node_modules/nunjucks/src/environment.js:527:18), <anonymous>:29:10)
[11ty] at fn (/home/runner/work/YousefMohamd.github.io/YousefMohamd.github.io/node_modules/a-sync-waterfall/index.js:26:24)
[11ty] at /home/runner/work/YousefMohamd.github.io/YousefMohamd.github.io/node_modules/a-sync-waterfall/index.js:66:22
[11ty] at executeSync (/home/runner/work/YousefMohamd.github.io/YousefMohamd.github.io/node_modules/a-sync-waterfall/index.js:8:15)
[11ty] Copied 6 files / Wrote 0 files in 0.24 seconds (v2.0.1)
Error: Process completed with exit code 1.
وده لينك المشروع
https://github.com/YousefMohamd/YousefMohamd.github.io

Answer 1

تمام يا يوسف — شفت اللوجز وكده واضح إن عندك مشكلتين رئيسيتين + شوية لخبطة أوامر:

الـ CI بيقف عند خطوة npm ci لأن مفيش package-lock.json.
Eleventy بيقول filter not found: htmlDateString، وده معناه إن فلتر RSS مش متسجّل (أو البلاجين مش متسطّب).

كمان فيه سطور فيها تعليقات # ... اتتلزق جوّه الأوامر، وEleventy اعتبرها arguments (عشان كده طلع لك: “We don’t know what ‘#’ is”).

خلّيني أديك خطوات قصيرة تحل كله مرّة واحدة:

1) ثبّت البلاجين واضبط الفلتر

محليًا في مشروعك:

bash
# تحديث/تثبيت Eleventy 2 + RSS plugin
npm i -E @11ty/eleventy@^2 @11ty/eleventy-plugin-rss@^2

افتح .eleventy.js وتأكد إن فيه السطور دي:

js
// .eleventy.js
const pluginRss = require("@11ty/eleventy-plugin-rss");

module.exports = function (eleventyConfig) {
  eleventyConfig.addPlugin(pluginRss);

  // Fallback لو لأي سبب الفلتر مش متاح
  eleventyConfig.addFilter("htmlDateString", (dateObj) => {
    const d = new Date(dateObj);
    return d.toISOString().slice(0, 10); // YYYY-MM-DD مناسب لـ datetime
  });
};

ملاحظة: إضافة الفلاتر بالطريقة دي هي الموصى بيها في Eleventy، والـ RSS plugin هو اللي بيعرّف فلاتر التواريخ زي htmlDateString أصلًا. (Eleventy)

احفظ وعدّل commit:

bash
git add .eleventy.js package.json
git commit -m "Install 11ty v2 + RSS plugin and add htmlDateString fallback"

2) فعّل الـ lockfile عشان `npm ci`

حاليًا .gitignore عندك بيمنع package-lock.json، وده سبب الخطأ في الـ CI.

افتح .gitignore واحذف أي سطر فيه package-lock.json.
رجّع lockfile واعمِل commit:

bash
npm install   # هيولّد package-lock.json
git add .gitignore package-lock.json
git commit -m "Include package-lock.json for CI"
git push origin main

ليه ضروري؟ لأن actions/setup-node والـ caching بيتوقّعوا وجود lockfile في الروت. من غيره يطلع خطأ "Dependencies lock file is not found". (GitHub, chanwu.dev)

بديل (مش مفضّل): تغيّر خطوة الـ CI من npm ci لـ npm install. بس الأفضل تسيب npm ci مع lockfile ثابت.

3) نظّف أوامر التيرمنال

لما تشغّل:

bash
npx @11ty/eleventy --version
npx @11ty/eleventy

ما تحطّش تعليقات عربي بعد الأمر في نفس السطر (زي # يبني لـ _site) — ده اللي خلّى Eleventy يشتكي من #.

وبرضه الأمر applypatch مش أداة قياسية؛ إمّا تعدّل الملف بإيدك (الموصى بيه) أو تستخدم git apply لو عندك باتش فعلي.

4) اضبط ورقة النشر على GitHub Actions

حدّث ملف .github/workflows/deploy.yml بحيث يحتوي permissions وconcurrency الموصى بيهم لصفحات GitHub:

yaml
name: Deploy Eleventy to GitHub Pages

on:
  push:
    branches: [ "main" ]
  workflow_dispatch:

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: "pages"
  cancel-in-progress: true

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: 'npm'
      - run: npm ci
      - run: npx @11ty/eleventy
      - run: touch _site/.nojekyll
      - uses: actions/upload-pages-artifact@v3
        with:
          path: _site

  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - id: deployment
        uses: actions/deploy-pages@v4

أذونات pages: write وid-token: write مطلوبة علشان Action بتاع النشر يشتغل صح. (GitHub)

وبالمرة، في إعدادات الريبو → Pages خلّي المصدر GitHub Actions (لو مش معيّن بالفعل).

5) ثبّت العنوان الأساسي للموقع

حدّث _data/metadata.json بحيث:

json
{
  "title": "Yousef Mohamed",
  "url": "https://yousefmohamd.github.io"
}

(من غير / في الآخر)

6) جرّب محليًا قبل كل Push

bash
npx @11ty/eleventy --version   # المفروض يطلع 2.x
npx @11ty/eleventy             # يبني فولدر _site من غير Errors

لو كل ده اتعمل:

خطأ filter not found: htmlDateString هيختفي لأن البلاجين متسطّب والفولبّاك موجود.
خطأ Dependencies lock file is not found هيختفي لأنك أضفت package-lock.json للريبو.
النشر عبر Pages هيتم لأن الـ workflow بقى عنده الصلاحيات المطلوبة. (GitHub)

لو عايزني أشيّك على محتوى .eleventy.js الحالي أو deploy.yml سطراً بسطر، ابعتهولي هنا وأنا أعدّلهولك فورًا.

Answer 2

يوسف، تمام — واضح ليه لسه الـ CI/البيلد بيقع عندك. عندك حاجتين:

ركّبت نسخة الـ RSS Plugin الجديدة اللي بتتطلب Eleventy v3، وإنت عندك Eleventy v2.0.1 → ده سبب رسالة: required version '>=3.0.0-alpha.15'. الحل: ثبّت إصدار 1.2.0 من الـ RSS plugin المتوافق مع Eleventy v2. (GitHub)
قوالبك بتستخدم فلتر htmlDateString ومش متعرّف عندك → هنضيفه بإيدنا كـ fallback.

خلّيني أديك “نسخة لصق–ولعب” من الملف والأوامر من غير أي تعليقات (#) ولا باتشات applypatch.

1) غيّر نسخ الباكچات (أوامر نظيفة)

شغّل دول واحد واحد في مشروعك:

bash
npm remove @11ty/eleventy-plugin-rss
npm i -D @11ty/eleventy@^2 @11ty/[email protected]

v2 من الـ RSS plugin وما بعدها متوافقة مع Eleventy v3 فقط؛ عشان كده بنثبّت v1.2.0. (GitHub)

2) استبدل محتوى `.eleventy.js` بالكامل

انسخ ده زي ما هو:

js
// .eleventy.js
const pluginRss = require("@11ty/eleventy-plugin-rss");

module.exports = function(eleventyConfig) {
  // Plugins
  eleventyConfig.addPlugin(pluginRss);

  // Passthrough
  eleventyConfig.addPassthroughCopy({ "img": "img" });
  eleventyConfig.addPassthroughCopy({ "css": "css" });
  eleventyConfig.addPassthroughCopy({ "files": "files" });

  // Fallback filters عشان القوالب اللي بتستعملها
  eleventyConfig.addFilter("htmlDateString", (dateObj) => {
    const d = new Date(dateObj);
    return d.toISOString().slice(0, 10); // YYYY-MM-DD للـ <time datetime="">
  });
  eleventyConfig.addFilter("readableDate", (dateObj) => {
    const d = new Date(dateObj);
    return d.toLocaleDateString("en-US", { year: "numeric", month: "long", day: "numeric" });
  });

  return {
    dir: { input: ".", includes: "_includes", data: "_data", output: "_site" },
    htmlTemplateEngine: "njk",
    markdownTemplateEngine: "njk",
    templateFormats: ["njk","md","html"]
  };
};

(القالب الأساسي بتاع Eleventy بيستخدم فلترين تواريخ دول كتير، فعشان كده ضمنّالهم fallback آمن). (equk.co.uk)

3) رجّع الـ `package-lock.json` للريبو

المشكلة اللي ظهرت لك في Actions: Dependencies lock file is not found لأن الـ lockfile متتضافش بسبب .gitignore.

نفّذ بالترتيب:

bash
# ولّد lockfile
npm install

# لو .gitignore بيطنّش lockfile شيله من الـ ignore أو اضغط إضافة بالقوة:
git add -f package-lock.json

git add .eleventy.js package.json
git commit -m "Pin RSS plugin to v1.2.0 and add date filters; include lockfile"
git push origin main

npm ci في GitHub Actions محتاج lockfile موجود في جذور المشروع. (vitejs)

4) ملف النشر للـ GitHub Pages (لو لسه)

لو workflow عندك ناقص صلاحيات Pages، استخدم ده كما هو في .github/workflows/deploy.yml:

yaml
name: Deploy Eleventy to GitHub Pages

on:
  push:
    branches: [ "main" ]   # لو بتدفع على dev غيّرها لـ ["dev"]
  workflow_dispatch:

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: "pages"
  cancel-in-progress: true

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
      - run: npm ci
      - run: npx @11ty/eleventy
      - run: touch _site/.nojekyll
      - uses: actions/upload-pages-artifact@v3
        with:
          path: _site

  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - id: deployment
        uses: actions/deploy-pages@v4

الـ Action deploy-pages محتاج pages: write وid-token: write وإلا هيفشل النشر. (GitHub)
وفي إعدادات الريبو → Pages تأكد إن Source = GitHub Actions. (نموذج Vite موضح نفس الصلاحيات بالظبط). (vitejs)

5) اختبر محليًا (من غير تعليقات في نفس السطر)

شغّل:

bash
npx @11ty/eleventy --version
npx @11ty/eleventy

لو كنت بتحب تكتب شرح عربي بعد الأوامر، اكتبه في سطر جديد؛ متكتبهوش بعد الأمر نفسه (عشان اللي حصل لك: Eleventy كان شايف # كأنه Argument).

6) تأكيد عنوان الموقع

خلّي _data/metadata.json فيه:

json
{
  "title": "Yousef Mohamed",
  "url": "https://yousefmohamd.github.io"
}

(استخدم lowercase زي اللي فوق).

لو عملت الخطوات دي:

خطأ We found Eleventy version '2.0.1' ... >=3.0.0-alpha.15 هيختفي لأننا ثبّتنا RSS plugin المتوافق مع v2. (GitHub)
خطأ filter not found: htmlDateString هيروح لأن الفلتر بقى متعرّف.
خطوة npm ci في Actions هتشتغل بوجود package-lock.json. (vitejs)

لو حابب، ابعتلي دلوقتي محتوى package.json وdeploy.yml الحاليين وأنا أراجعهم سطر-بسطر.

Answer 3

حلو جدًا يا يوسف 👏 واضح إنك خلّصت أهم جزءين:

نزّلت Eleventy v2 وثبّتِّت RSS plugin صح (v1.2.0 المتوافق مع v2).
ضفت الـ lockfile ودفعته للريبو.

دلوقتي الخطأ الجديد:

Unable to call collections["tagList"]["indexOf"], which is undefined

ده لأن القالب بتاعك بيستخدم collections.tagList (وكمان filterTagList) لكن إحنا لسه ماعرّفناش الـ collection/الفلاتر دي في .eleventy.js. ده طبيعي في تمبلت Eleventy Base Blog—لازم تضيف الـ collection اللي بتجمع كل التاجز وتستبعد all/nav/post/posts. توثيق Eleventy بيشرح موضوع الـ Collections، وتمبلت الـ Base Blog بيستخدم htmlDateString وreadableDate في postslist.njk، فإحنا هنكمّل النواقص دول في config. (Eleventy, GitHub)

كمان تذكير سريع: نسخة RSS plugin v2 بتحتاج Eleventy v3 فما تنزلهاش دلوقتي (إنت فعلًا رجّعتها لـ 1.2.0 المتوافقة مع Eleventy v2). (githubissues.com, npm)

اعمل الآتي بالضبط

1) استبدل محتوى `.eleventy.js` بالكامل

انسخ/الزق الملف ده (هيضيف الـ plugin + الفلاتر + مجموعة التاجز):

js
// .eleventy.js
const pluginRss = require("@11ty/eleventy-plugin-rss");

module.exports = function(eleventyConfig) {
  // Plugins
  eleventyConfig.addPlugin(pluginRss);

  // Static passthrough
  eleventyConfig.addPassthroughCopy({ "img": "img" });
  eleventyConfig.addPassthroughCopy({ "css": "css" });
  eleventyConfig.addPassthroughCopy({ "files": "files" });

  // ---- Dates (fallbacks للـ قوالب) ----
  eleventyConfig.addFilter("htmlDateString", (dateObj) => {
    const d = new Date(dateObj);
    return d.toISOString().slice(0, 10); // YYYY-MM-DD لـ <time datetime="">
  });
  eleventyConfig.addFilter("readableDate", (dateObj) => {
    const d = new Date(dateObj);
    return d.toLocaleDateString("en-US", { year: "numeric", month: "long", day: "numeric" });
  });

  // ---- Tags utilities (زي تمبلت Eleventy Base Blog) ----
  const EXCLUDED = new Set(["all", "nav", "post", "posts"]);
  eleventyConfig.addFilter("filterTagList", (tags) =>
    (tags || []).filter((t) => !EXCLUDED.has(t))
  );
  eleventyConfig.addCollection("tagList", (collectionApi) => {
    const tagSet = new Set();
    collectionApi.getAll().forEach((item) => {
      (item.data.tags || []).forEach((tag) => {
        if (!EXCLUDED.has(tag)) tagSet.add(tag);
      });
    });
    return Array.from(tagSet).sort();
  });

  return {
    dir: { input: ".", includes: "_includes", data: "_data", output: "_site" },
    htmlTemplateEngine: "njk",
    markdownTemplateEngine: "njk",
    templateFormats: ["njk","md","html"]
  };
};

ده بيكمّل الـ collections والفلترز اللي القوالب مستنيّاها (راجع وثائق Eleventy عن Collections، وpostslist.njk في الـ Base Blog اللي بيعتمد على فلاتر التاريخ). (Eleventy, GitHub)

2) تأكد إن الـ RSS plugin على v1.2.0 (متوافق مع Eleventy v2)

إنت بالفعل عملتها، لكن للتأكيد:

bash
npm remove @11ty/eleventy-plugin-rss
npm i -D @11ty/eleventy@^2 @11ty/[email protected]

إصدارات v2.x من plugin الـ RSS عايزة Eleventy v3 (>= 3.0.0-alpha.15)؛ عشان كده بنثبت 1.2.0. (githubissues.com)

3) جرّب محليًا (من غير تعليقات `#` في نفس السطر)

bash
npx @11ty/eleventy --version
npx @11ty/eleventy

4) ادفع التغييرات

bash
git add .eleventy.js package.json
git commit -m "Add tagList/filterTagList + date filters; finalize Eleventy v2 setup"
git push origin main

5) عن رسالة الـ lockfile في Actions

الـ Run اللي كان بيقول Dependencies lock file is not found غالبًا كان من قبل ما تدفع package-lock.json. بعد الكومِت 2bd507f اللي أضافه، المفروض المشكلة تختفي في الرنّات الجديدة. لو مازال ظاهر:

افتح Actions على آخر رنّ للـ commit الأخير وتأكد إن package-lock.json موجود في جذر الريبو (نفس المسار اللي ظاهر في اللوج).
خليه على npm ci (يحتاج lockfile)، ومتنساش إننا بالفعل ضفناه.
لو عملت Ignore للـ lockfile في .gitignore قبل كده، خلاص إحنا ضفناه بـ git add -f فبقى ضمن التاريخ.

احتمال نادر في `postslist.njk`

لو—بعد التعديلات—لسه ظهر نفس الخطأ، يبقى ملف _includes/postslist.njk نفسه فيه سطر بيعمل collections["tagList"].indexOf(...) مباشرة. تقدر تأمّنه بسرعة كده:

بدّل أي استعمال مباشر لـ collections.tagList بـ:

njk
{{ (collections.tagList | default([])) }}

بس غالبًا مش هتحتاج ده بعد ما ضفنا الـ addCollection("tagList").

جرّب كده وابنِ محليًا. لو البيلد اشتغل عندك بدون Errors، الـ GitHub Actions هيكمّل طبيعي ويبعت على Pages.
لو حابب تبعتلي محتوى archive.njk و_includes/postslist.njk هعدّلهملك فورًا لو فيهم سطر محتاج تأمين.

Answer 4

برافو يا يوسف 👏 شغلك وصل لحد كبير. دلوقتي اللي باين من اللوجز إننا اتحركنا خطوة لقدّام:

نسخة الـ RSS plugin بقت تمام (رجّعتها لـ v1.2.0 المتوافقة مع Eleventy v2). وده الصح — لأن v2 من الـ plugin محتاجة Eleventy v3 حسب الدوكيومنتيشن الرسمية. (11ty.dev, GitHub)
بقى فيه خطأين متبقّيين:
- ننجكس مش فاهم {% comment %} في 404.md → لازم تتكتب تعليقات ننجكس بالطريقة {# ... #}. (Mozilla GitHub Pages, docs.mydukaan.io)
- لو لسه بتشوف رسالة الـ lockfile في Actions في رنّات قديمة، ده كان قبل ما تضيف package-lock.json. آخر رنات بعد الكومِت اللي ضافه لازم تعدّي خطوة npm ci.

خلّيه “نسخ–لزق” علشان نقفلها:

1) بدّل بلوكات `{% comment %}` في المشروع كله

(على macOS؛ الأوامر من غير أي تعليقات في آخر السطر)

bash
# استبدال كل فتحات comment
grep -rl "{% *comment *%}" -- . | xargs sed -i '' -e 's/{% *comment *%}/{# /g'

# استبدال كل إغلاقات endcomment
grep -rl "{% *endcomment *%}" -- . | xargs sed -i '' -e 's/{% *endcomment *%}/ #}/g'

لو حابب تستهدف الملف اللي ظهر في اللوج بس:

bash
sed -i '' -e 's/{% *comment *%}/{# /g' -e 's/{% *endcomment *%}/ #}/g' 404.md

ننجكس مابيعرّفش بلوك باسم comment؛ الصيغة الصحيحة للتعليق هي {# ... #}. (Mozilla GitHub Pages)

2) اتأكد من إعدادات Eleventy في `.eleventy.js`

بما إنك ضفت الـ filters والـ collections، خليه كده (لو مش عاملها بالفعل):

js
const pluginRss = require("@11ty/eleventy-plugin-rss");

module.exports = function(eleventyConfig) {
  eleventyConfig.addPlugin(pluginRss);

  eleventyConfig.addPassthroughCopy({ "img": "img" });
  eleventyConfig.addPassthroughCopy({ "css": "css" });
  eleventyConfig.addPassthroughCopy({ "files": "files" });

  // فلاتر تواريخ
  eleventyConfig.addFilter("htmlDateString", d => new Date(d).toISOString().slice(0,10));
  eleventyConfig.addFilter("readableDate", d =>
    new Date(d).toLocaleDateString("en-US", {year:"numeric", month:"long", day:"numeric"})
  );

  // tags utilities زي الـ Base Blog
  const EXCLUDED = new Set(["all","nav","post","posts"]);
  eleventyConfig.addFilter("filterTagList", tags => (tags || []).filter(t => !EXCLUDED.has(t)));
  eleventyConfig.addCollection("tagList", api => {
    const set = new Set();
    api.getAll().forEach(item => (item.data.tags || []).forEach(t => !EXCLUDED.has(t) && set.add(t)));
    return Array.from(set).sort();
  });

  return {
    dir: { input: ".", includes: "_includes", data: "_data", output: "_site" },
    htmlTemplateEngine: "njk",
    markdownTemplateEngine: "njk",
    templateFormats: ["njk","md","html"]
  };
};

3) شغّل محليًا (من غير تعليقات `#` في نفس السطر)

bash
npx @11ty/eleventy --version
npx @11ty/eleventy

لو البنّاء عدى محليًا، كمل:

bash
git add -A
git commit -m "Replace {% comment %} blocks with Nunjucks comments and finalize Eleventy v2 setup"
git push origin main

4) تذكير أخير بخصوص الـ CI

Action بتاع Pages يفضّل npm ci مع وجود package-lock.json في جذر الريبو. لو كانت رسالة “lock file is not found” ظهرت في رنّ قديم، راجع آخر رنّ للكومِت اللي فيه package-lock.json — المفروض الخطوة تعدّي دلوقتي.
لو عايز تلخّصها أكتر: خليك على npm ci + npm run build، والـ workflow فيه:
- permissions: { contents: read, pages: write, id-token: write }
- actions/upload-pages-artifact@v3 بـ path: _site
- actions/deploy-pages@v4

ليه عملنا كده؟

توافق الإصدارات: @11ty/eleventy-plugin-rss@^2 عايز Eleventy v3؛ وإنت على v2، فـ نثبّت v1.2.0 من الـ plugin. كده البروجكت يكمّل طبيعي. (11ty.dev, GitHub)
تعليقات ننجكس: التعليق المسموح هو {# ... #} مش بلوك {% comment %}، وإلا هتشوف unknown block tag: comment. (Mozilla GitHub Pages)

جرّب الخطوات دي دلوقتي. لو بعد الاستبدال لسه في Error، ابعتلي سطر 4–8 من 404.md و/أو محتوى _includes/postslist.njk وأنا هصلّحهالك فورًا هنا.

Answer 5

جامد جدًا يا يوسف — البيلد اتحرك وكتب شوية ملفات قبل ما يوقف 👌
دلوقتي عندك مشكلتين بس (واضحين من اللوج):

unknown block tag: comment في 404.md → لسه فيه {% comment %}/{% endcomment %} جوّا الملف.
قبلها ظهر filter not found: eleventyNavigation → محتاج تضيف Plugin التنقّل بتاع Eleventy.

هنقفل الاتنين دول دلوقتي خطوة-بخطوة (أوامر نظيفة من غير # في آخر السطر):

1) خلّص موضوع `{% comment %}` نهائيًا

أحيانًا الوسوم بتكون فيها شرطات - أو مسافات مختلفة، فخلّينا نستبدل كل الأشكال المحتملة على مستوى الريبو:

bash
# بدّل كل أشكال فتح/قفل comment (بما فيها {%- comment -%})
grep -rl "\{%-\{0,1\} *comment *-\{0,1\}%\}" -- . | xargs sed -E -i '' 's/\{%-?\s*comment\s*-?%\}/{# /g'
grep -rl "\{%-\{0,1\} *endcomment *-\{0,1\}%\}" -- . | xargs sed -E -i '' 's/\{%-?\s*endcomment\s*-?%\}/ #}/g'

ولو حابب تستهدف الملف اللي ظهر في الخطأ مباشرة:

bash
sed -E -i '' \
  -e 's/\{%-?\s*comment\s*-?%\}/{# /g' \
  -e 's/\{%-?\s*endcomment\s*-?%\}/ #}/g' \
  404.md

نون‌جاكس بيدعم التعليق بالشكل {# ... #} فقط. أي {% comment %} (ستايل Liquid/Jekyll) بتكسره.

2) فعّل Plugin التنقّل (eleventy-navigation)

القالب بتاعك بيستخدم الفلتر eleventyNavigation جوّا base.njk. ده جاي من Plugin رسمي.

ثبّت الباكدچ:

bash
npm i -D @11ty/eleventy-navigation

حدّث `.eleventy.js`

استبدل محتوى الملف بالكامل بالنص ده (بيشمل RSS + Navigation + فلاتر التاريخ + tags utilities):

js
// .eleventy.js
const pluginRss = require("@11ty/eleventy-plugin-rss");
const pluginNavigation = require("@11ty/eleventy-navigation");

module.exports = function(eleventyConfig) {
  // Plugins
  eleventyConfig.addPlugin(pluginRss);
  eleventyConfig.addPlugin(pluginNavigation);

  // Static passthrough
  eleventyConfig.addPassthroughCopy({ "img": "img" });
  eleventyConfig.addPassthroughCopy({ "css": "css" });
  eleventyConfig.addPassthroughCopy({ "files": "files" });

  // Date filters (fallbacks)
  eleventyConfig.addFilter("htmlDateString", (d) => new Date(d).toISOString().slice(0, 10));
  eleventyConfig.addFilter("readableDate", (d) =>
    new Date(d).toLocaleDateString("en-US", { year: "numeric", month: "long", day: "numeric" })
  );

  // Tags utilities (زي Eleventy Base Blog)
  const EXCLUDED = new Set(["all","nav","post","posts"]);
  eleventyConfig.addFilter("filterTagList", (tags) => (tags || []).filter((t) => !EXCLUDED.has(t)));
  eleventyConfig.addCollection("tagList", (api) => {
    const set = new Set();
    api.getAll().forEach((item) => {
      (item.data.tags || []).forEach((t) => { if(!EXCLUDED.has(t)) set.add(t); });
    });
    return Array.from(set).sort();
  });

  return {
    dir: { input: ".", includes: "_includes", data: "_data", output: "_site" },
    htmlTemplateEngine: "njk",
    markdownTemplateEngine: "njk",
    templateFormats: ["njk","md","html"]
  };
};

3) جرّب محليًا (من غير أي تعليقات في نفس السطر)

bash
npx @11ty/eleventy --version
npx @11ty/eleventy

لو عدى بدون Errors، كمّل:

bash
git add -A
git commit -m "Fix Nunjucks comments and enable @11ty/eleventy-navigation plugin"
git push origin main

هي دي كل الحكاية.

خطأ unknown block tag: comment هيروح بعد الاستبدال الشامل.
خطأ eleventyNavigation هيروح بعد إضافة البلاجين.
وبما إن package-lock.json بقى في الجذر واتدفع، خطوة npm ci في الـ Actions هتعدّي عادي.

لو لسه يحصل خطأ، ابعتلي أول 15 سطر من 404.md وأول 40 سطر من _includes/layouts/base.njk وأنا هعدّلهم لك فورًا هنا.

Answer 6

تمام يا يوسف! 👍
الملف base.njk واضح إنه بيستخدم الفِلتر eleventyNavigation هنا:

njk
{%- for entry in collections.all | eleventyNavigation %}
  <a href="{{ entry.url | url }}" class="w3-bar-item w3-button" style="width:20% !important">{{ entry.title }}</a>
{%- endfor %}

وده هو سبب خطأ: filter not found: eleventyNavigation. عندك حلّين: إمّا تفعّل الـ Plugin الرسمي، أو تشيل الاعتماد عليه وتخلّي القايمة ثابتة.

الخيار A (المُستحسن): فعِّل Plugin التنقّل

1) ثبِّت الباكدچ

(لو كنت ثبّتّه قبل كده مفيش ضرر)

bash
npm i -D @11ty/eleventy-navigation

2) حدّث `.eleventy.js` (انسخه كاملًا)

js
// .eleventy.js
const pluginRss = require("@11ty/eleventy-plugin-rss");
const pluginNavigation = require("@11ty/eleventy-navigation");

module.exports = function(eleventyConfig) {
  // Plugins
  eleventyConfig.addPlugin(pluginRss);
  eleventyConfig.addPlugin(pluginNavigation);

  // Static passthrough
  eleventyConfig.addPassthroughCopy({ "img": "img" });
  eleventyConfig.addPassthroughCopy({ "css": "css" });
  eleventyConfig.addPassthroughCopy({ "files": "files" });

  // Date filters (fallbacks)
  eleventyConfig.addFilter("htmlDateString", (d) => new Date(d).toISOString().slice(0, 10));
  eleventyConfig.addFilter("readableDate", (d) =>
    new Date(d).toLocaleDateString("en-US", { year: "numeric", month: "long", day: "numeric" })
  );

  // Tags utilities زي Eleventy Base Blog
  const EXCLUDED = new Set(["all","nav","post","posts"]);
  eleventyConfig.addFilter("filterTagList", (tags) => (tags || []).filter((t) => !EXCLUDED.has(t)));
  eleventyConfig.addCollection("tagList", (api) => {
    const set = new Set();
    api.getAll().forEach((item) => {
      (item.data.tags || []).forEach((t) => { if(!EXCLUDED.has(t)) set.add(t); });
    });
    return Array.from(set).sort();
  });

  return {
    dir: { input: ".", includes: "_includes", data: "_data", output: "_site" },
    htmlTemplateEngine: "njk",
    markdownTemplateEngine: "njk",
    templateFormats: ["njk","md","html"]
  };
};

ملاحظة: علشان القايمة تتعبّى تلقائيًا، زوّد في الصفحات اللي عايزها تظهر بالناڤ: في الـ front matter:
yaml
---
title: About
eleventyNavigation:
  key: About
  order: 2
---
(اعمل نفس الفكرة لـ Home/Projects/Contact… القيم key وorder اللي تعجبك)

3) ثبّت إن مشكلة `{% comment %}` اختفت فعلًا

تأكّد إن ملف 404.md مفيهوش أي {% comment %} متبقّي:

bash
grep -n "{% *comment" 404.md || echo "OK: no comment blocks"
grep -n "{% *endcomment" 404.md || echo "OK: no endcomment blocks"

لو طلع أي سطر، بدّله يدويًا بـ {# ... #}.

4) جرّب محليًا ثم ادفع

bash
npx @11ty/eleventy --version
npx @11ty/eleventy

git add -A
git commit -m "Enable @11ty/eleventy-navigation and clean Nunjucks comments"
git push origin main

ده يقفل خطأ eleventyNavigation وغلطة التعليقات.

الخيار B (من غير Plugin): قايمة ثابتة للموبايل

لو مش عايز البلاجين، بدّل بلوك الناڤ للموبايل في base.njk بـ قايمة ثابتة (زي السايدبار):

njk
<div class="w3-top w3-hide-large w3-hide-medium" id="myNavbar">
  <div class="w3-bar w3-black w3-opacity w3-hover-opacity-off w3-center w3-small">
    <a href="/#" class="w3-bar-item w3-button" style="width:25% !important">Home</a>
    <a href="/#about" class="w3-bar-item w3-button" style="width:25% !important">About</a>
    <a href="/projects/" class="w3-bar-item w3-button" style="width:25% !important">Projects</a>
    <a href="/#contact" class="w3-bar-item w3-button" style="width:25% !important">Contact</a>
  </div>
</div>

وبكده نشيل الفِلتر eleventyNavigation من القالب وبالتالي الخطأ يختفي بدون إضافة أي باكدچ.

تِكات سريعة:

لما تكتب أوامر، ما تحطّش تعليق # ... في نفس السطر؛ ده كان سبب Error قبل كده.
اتأكد إن package-lock.json متضاف ومتبوش (عملت ده صح 👍).
في GitHub Actions خلّيك على:
- npm ci
- npx @11ty/eleventy (أو npm run build لو ضايف سكريبت)
- actions/upload-pages-artifact@v3 بملف _site
- actions/deploy-pages@v4
- وصلاحيات:
```
yaml
permissions:
  contents: read
  pages: write
  id-token: write
```

لو تحب، ابعتلي 404.md (أول 15 سطر) وأي صفحة حاطط فيها eleventyNavigation: في الـ front matter، وأنا أظبطلك القيم المناسبة بسرعة.

Frage

اضف الملفات المعدّلة لمؤشر git

اعمل commit

ابعته لـ GitHub

Gedanke

Antwort

1) ثبّت البلاجين واضبط الفلتر

2) فعّل الـ lockfile عشان npm ci

3) نظّف أوامر التيرمنال

4) اضبط ورقة النشر على GitHub Actions

5) ثبّت العنوان الأساسي للموقع

6) جرّب محليًا قبل كل Push

Frage

1) حدّث Eleventy وإضافة RSS (ده هيحدّث package-lock كمان)

اضف الملفات المعدّلة لمؤشر git

اعمل commit

ابعته لـ GitHub

Gedanke

Antwort

1) غيّر نسخ الباكچات (أوامر نظيفة)

2) استبدل محتوى .eleventy.js بالكامل

3) رجّع الـ package-lock.json للريبو

4) ملف النشر للـ GitHub Pages (لو لسه)

5) اختبر محليًا (من غير تعليقات في نفس السطر)

6) تأكيد عنوان الموقع

Frage

1) حدّث Eleventy وإضافة RSS (ده هيحدّث package-lock كمان)

اضف الملفات المعدّلة لمؤشر git

اعمل commit

ابعته لـ GitHub

Gedanke

Fixing tagList and Nunjucks issues

Clarifying steps for errors and fixes

Clarifying instructions and fixes

Antwort

اعمل الآتي بالضبط

1) استبدل محتوى .eleventy.js بالكامل

2) تأكد إن الـ RSS plugin على v1.2.0 (متوافق مع Eleventy v2)

3) جرّب محليًا (من غير تعليقات # في نفس السطر)

4) ادفع التغييرات

5) عن رسالة الـ lockfile في Actions

احتمال نادر في postslist.njk

Frage

Gedanke

Fixing the comment syntax

Alternative for comment blocks and collection fix

Steps for troubleshooting and deployment

Steps to resolve issues

Antwort

1) بدّل بلوكات {% comment %} في المشروع كله

2) اتأكد من إعدادات Eleventy في .eleventy.js

3) شغّل محليًا (من غير تعليقات # في نفس السطر)

4) تذكير أخير بخصوص الـ CI

ليه عملنا كده؟

Frage

Gedanke

Antwort

1) خلّص موضوع {% comment %} نهائيًا

2) فعّل Plugin التنقّل (eleventy-navigation)

ثبّت الباكدچ:

حدّث .eleventy.js

3) جرّب محليًا (من غير أي تعليقات في نفس السطر)

Frage

Gedanke

Troubleshooting plugin issue

Suggesting plugin or manual fix

Focusing on plugin installation

Ensuring plugin is set up

Antwort

الخيار A (المُستحسن): فعِّل Plugin التنقّل

1) ثبِّت الباكدچ

2) حدّث .eleventy.js (انسخه كاملًا)

3) ثبّت إن مشكلة {% comment %} اختفت فعلًا

4) جرّب محليًا ثم ادفع

الخيار B (من غير Plugin): قايمة ثابتة للموبايل

تِكات سريعة:

Diesen Q&A teilen

2) فعّل الـ lockfile عشان `npm ci`

2) استبدل محتوى `.eleventy.js` بالكامل

3) رجّع الـ `package-lock.json` للريبو

1) استبدل محتوى `.eleventy.js` بالكامل

3) جرّب محليًا (من غير تعليقات `#` في نفس السطر)

احتمال نادر في `postslist.njk`

1) بدّل بلوكات `{% comment %}` في المشروع كله

2) اتأكد من إعدادات Eleventy في `.eleventy.js`

3) شغّل محليًا (من غير تعليقات `#` في نفس السطر)

1) خلّص موضوع `{% comment %}` نهائيًا

حدّث `.eleventy.js`

2) حدّث `.eleventy.js` (انسخه كاملًا)

3) ثبّت إن مشكلة `{% comment %}` اختفت فعلًا