Malton London Press

المشكلة

تحتاج دار النشر الأكاديمية إلى أكثر من موقع إلكتروني. يجب أن يكون كل كتاب وكل ورقة مؤتمر متاحًا للقراءة والتنزيل مجانًا، وأن يتمكن المحررون من النشر دون لمس الكود، وأن يعثر Google Scholar على كل ورقة ويفهرسها. وإن لم يحدث ذلك، يبقى عمل المؤلفين غير مرئي.

كيف بُني

مستودع monorepo مبني بـ pnpm وTurborepo، فيه تطبيقان وحزمة مشتركة: موقع Next.js للقرّاء، وPayload CMS على PostgreSQL، حيث يعمل المحررون ومنه يأخذ الموقع محتواه. يتصفح القرّاء الكتب وأعمال المؤتمرات ويُنزّلون ملفات PDF، ويرسل المؤلفون مقترحات كتبهم عبر نموذج. ويعمل كل شيء على خادم Hetzner واحد خلف Nginx، ويُبقي PM2 التطبيقين في وضع cluster. ومع كل push تعمل في GitHub Actions عمليات lint وفحص الأنواع (type checks) والاختبارات. أما الـ deploy فيبدأ يدويًا: يعيد الـ workflow تشغيل الفحوصات على الـ commit نفسه بالضبط، ويتصل بالخادم عبر SSH، ويشغّل سكربت الـ deploy نفسه الذي قد يشغّله أي شخص (install وmigrate وbuild وreload)، ثم يفحص health endpoint من الخارج مرة بعد مرة حتى يستجيب الموقع.

القرارات المهمة

• الـ deploy لا يبدأ إلا يدويًا

  لا يحدث أي deploy عند الـ push، لذلك لا يمكن لـ commit سيئ على main أن يصل إلى بيئة الإنتاج من تلقاء نفسه. ويستدعي الـ workflow السكربت نفسه الذي يشغّله الشخص يدويًا، فلا يمكن للمسارين اليدوي والآلي أن يتباعدا.

• لا يوجد rollback تلقائي

  عمل checkout لكود قديم لا يلغي migration لقاعدة البيانات نُفّذت بالفعل، لذلك تبقى العودة إلى الوراء خطوة مقصودة. ويُحفظ الـ commit السابق على الخادم قبل كل deploy، فيصبح الـ rollback أمرًا واحدًا.

• بيانات وصفية يستطيع Google Scholar قراءتها

  تحمل صفحة كل ورقة وكل كتاب وسوم استشهاد بصيغة Highwire Press، ويأتي بعد كل مؤلف مؤسسته ومعرّف ORCID الخاص به، حتى يفهرسها Google Scholar وبرامج إدارة المراجع مثل Zotero بشكل صحيح.

كود من المستودع

1/** One citation_author per person, each followed by its own institution and ORCID. */
2function authorTags(people: Person[] | null | undefined): CitationTag[] {
3  const tags: CitationTag[] = []
4  for (const person of people ?? []) {
5    const name = person.name?.trim()
6    if (!name) continue
7    tags.push(['citation_author', name])
8    const institution = person.affiliation?.trim()
9    if (institution) tags.push(['citation_author_institution', institution])1
10    const orcid = orcidUrl(person.orcid)
11    if (orcid) tags.push(['citation_author_orcid', orcid])
12  }
13  return tags
14}
15 
16// …
17 
18/** Tags for a conference paper page (/proceedings/[volume]/[paper]). */
19export function paperCitationTags(
20  paper: Pick<Paper, 'title' | 'slug' | 'authors' | 'doi' | 'pdf' | 'pagesRange'>,
21  volume: Pick<Book, 'title' | 'slug' | 'publicationDate' | 'isbn' | 'conference'>,
22  siteUrl: string = publicSiteUrl(),
23): CitationTag[] {
24  const tags: CitationTag[] = []
25  add(tags, 'citation_title', paper.title)
26  tags.push(...authorTags(paper.authors))
27  add(tags, 'citation_publication_date', citationDate(volume.publicationDate))2
28  // …
29  const site = siteUrl.replace(/\/+$/, '')
30  // Same host and directory as this page (Scholar ignores a PDF anywhere else).
31  if (hasFile(paper.pdf)) add(tags, 'citation_pdf_url', `${site}${paperPdfPath(volume.slug, paper.slug)}`)3
32  add(tags, 'citation_abstract_html_url', `${site}/proceedings/${volume.slug}/${paper.slug}`)
33  add(tags, 'citation_language', 'en')
34  return tags
35}

أين وصل الآن

يعمل منذ يناير 2026 على maltonlondonpress.com. أتولى تشغيله وأنفّذ deploy لكل تغيير.