الإعدادات

كل إعداد يقرؤه الموقع، وقيمته الافتراضية، وكيف تغيّره مع Docker وبدونه.

الإعدادات

كل إعداد اختياري: يعمل الموقع بدون أي منها.

المتغير	القيمة الافتراضية	وظيفته
`NEXT_PUBLIC_SITE_URL`	`http://localhost:3030`	العنوان العام للموقع، مع `https://`. تُحذف الشرطة المائلة في آخره. تُبنى منه الروابط القياسية، والروابط بين اللغتين، وخريطة الموقع، و`robots.txt`، والبيانات المنظمة، وبطاقات المشاركة الاجتماعية. اضبطه على نطاقك قبل الإطلاق.
`NEXT_PUBLIC_BUY_URL`	فارغ	عند ضبطه، يظهر شريط أسفل كل صفحة فيه زر «Buy This Template» يفتح هذا العنوان في تبويب جديد. اتركه فارغًا.
`NEXT_PUBLIC_RECAPTCHA_SITE_KEY`	فارغ	مفتاح موقع Google reCAPTCHA v2. عند ضبطه، يطلب نموذج الصفحة الرئيسية تحديد مربع «أنا لست برنامج روبوت» قبل الإرسال. اتركه فارغًا إن لم تُرد خطوة كابتشا.
`BUILD_STANDALONE`	فارغ	القيمة `true` تبني خادمًا مستقلًا بذاته في `.next/standalone`. يضبطها `Dockerfile` لك. اتركها فارغة عند استخدام `yarn start`.

المنفذ ليس متغيرًا: الموقع يستمع دائمًا على 3030. لاستخدام منفذ آخر، انظر أدناه.

من دون Docker

انسخ .env.example إلى .env.local وعدّل القيم هناك. أبقِ .env.example كما هو، فهو قائمة بما هو موجود.

الطرفيةفي Publino-template

cp .env.example .env.local

.env.local

NEXT_PUBLIC_SITE_URL=https://www.your-domain.com

لاستخدام منفذ غير 3030، مرّره إلى السكربت: yarn dev -p 3041 أو yarn start -p 3041.

باستخدام Docker

لا يقرأ بناء الصورة ملفي .env و.env.local. مرّر كل قيمة كمعامل بناء بدلًا من ذلك:

الطرفيةفي Publino-template

docker build -t publino-landing --build-arg NEXT_PUBLIC_SITE_URL=https://www.your-domain.com .

الموقع داخل الحاوية يستمع دائمًا على المنفذ 3030. لاستخدام منفذ آخر على جهازك، غيّر الرقم الذي على يسار -p عند التشغيل: docker run -p 3041:3030 publino-landing.

متى يسري التغيير

القيم التي تبدأ بـ NEXT_PUBLIC_ تُضمَّن في ملف JavaScript الذي يحمّله المتصفح عند بناء الموقع. تغيير إحداها لا يغيّر شيئًا حتى يُبنى الموقع من جديد:

طريقة التشغيل	بعد تغيير قيمة
`yarn dev`	أوقف الخادم وشغّل `yarn dev` من جديد.
`yarn build` و`yarn start`	شغّل `yarn build` مجددًا، ثم `yarn start`.
Docker	ابنِ الصورة من جديد بالقيمة كـ `--build-arg`، ثم شغّل حاوية جديدة.
Vercel	غيّره في Environment Variables الخاصة بالمشروع وانشر مجددًا.

لا تضع سرًا في قيمة NEXT_PUBLIC_: يستطيع كل زائر قراءتها في كود الصفحة. مفتاح موقع reCAPTCHA معدّ ليكون علنيًا، أما مفتاحه السري فمكانه على خادمك.

البناء المستقل

مع BUILD_STANDALONE=true، يكتب yarn build خادمًا لا يحتاج إلى node_modules في .next/standalone. يستخدمه Dockerfile ليُبقي الصورة صغيرة. لا يُقصد استخدام yarn start مع هذا النوع من البناء، ويحذّر بالرسالة "next start" does not work with "output: standalone" configuration. اترك المتغير فارغًا ما لم تنسخ المجلد المستقل إلى خادم بنفسك.