Malton London Press

Problem

Akademik bir yayınevinin bir web sitesinden fazlasına ihtiyacı var. Her kitap ve konferans bildirisi ücretsiz okunup indirilebilmeli, editörler koda dokunmadan yayın yapabilmeli ve Google Scholar her makaleyi bulup indekslemeli. Yoksa yazarların emeği görünmez kalır.

Nasıl yapıldı

İki uygulama ve bir ortak paketten oluşan bir pnpm ve Turborepo monorepo'su: okurlar için bir Next.js sitesi ve editörlerin çalıştığı, sitenin içeriğini de aldığı, PostgreSQL üzerindeki Payload CMS. Okurlar kitaplara ve konferans bildiri kitaplarına göz atıp PDF'leri indiriyor, yazarlar kitap önerilerini bir formla gönderiyor. Her şey Nginx arkasında tek bir Hetzner sunucusunda çalışıyor; PM2 iki uygulamayı da cluster modunda tutuyor. Her push'ta GitHub Actions lint, type check ve testleri çalıştırıyor. Deploy elle başlatılıyor: workflow kontrolleri tam o commit üzerinde yeniden çalıştırıyor, sunucuya SSH ile bağlanıyor, bir insanın çalıştıracağı deploy script'inin aynısını çalıştırıyor (install, migrate, build, reload) ve site cevap verene kadar dışarıdan bir health endpoint'ini yokluyor.

Önemli kararlar

• Deploy sadece elle başlıyor

  Push'ta hiçbir şey deploy olmuyor, yani main'e giren hatalı bir commit kendi kendine production'a ulaşamaz. Workflow, bir insanın çalıştıracağı script'in aynısını çağırıyor; böylece elle ve otomatik yollar birbirinden kopamıyor.

• Otomatik rollback yok

  Eski kodu checkout etmek, çoktan çalışmış bir veritabanı migration'ını geri almaz; bu yüzden geri dönmek bilinçli bir adım olarak kalıyor. Her deploy'dan önce bir önceki commit sunucuda kaydediliyor, bu da rollback'i tek bir komuta indiriyor.

• Google Scholar'ın okuyabildiği metadata

  Her makale ve kitap sayfası Highwire Press citation tag'leri taşıyor ve her yazarın hemen arkasından kendi kurumu ve ORCID'i geliyor. Böylece Google Scholar ve Zotero gibi kaynak yöneticileri onları doğru indeksliyor.

Repodan kod

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}

Şu an ne durumda

Ocak 2026'dan beri maltonlondonpress.com adresinde yayında. Ayakta tutan da her değişikliği deploy eden de benim.