WordPress -> Ghost -> Арфа (часть 2)

Я написал о переходе от WordPress к Ghost, а затем к Harp в первой части , в этом посте подробно описываются некоторые особенности реализации моего блога.

Технический обзор

Я использую Harp, с которым невероятно легко работать, но я также использую Harp в качестве зависимости внутри своего собственного веб-сервера пользовательских узлов, что позволяет мне добавить несколько свистков в мою реализацию.

• Пользовательская перезапись URL
• Статическое кеширование
• Использование специальных помощников внутри Арфы, таких как moment.js
• Список недавно измененных постов
• Архивировать и помечать страницы без повторения файлов
• Процесс выпуска на основе Makefile

Пользовательская перезапись URL

Поскольку я портировал существующий блог, я хотел убедиться, что URL-адреса не изменились. Это означает, что поддерживается мой старый / год / месяц / день / название формата. Что мне не нравилось на протяжении многих лет, но когда я перешел на Арфу, я решил убрать дату из тела своих постов и разрешить URL-адресу указывать эти метаданные.

Я также хотел разместить свои старые загрузки и демонстрации на Amazon S3, но URL-адреса из старых сообщений будут относиться к моему блогу, поэтому мне нужно было переписать их.

Я разветвлял router @ npm, чтобы создать router-stupid @ npm — который по сути тот же, слегка урезанный, но важный: если вы измените req.url в обработчике маршрутов, это повлияет на последующие сопоставленные маршруты.

Перенаправление просто:

/* redirect to s3 hosted urls */
route.all('/demo/{filename}', function (req, res, next) {
  res.writeHead(302, { 'location': 'http://download.remysharp.com/' + req.params.filename });
  res.end();
});

Поддерживать формат URL моей базы данных было сложнее. Фактический файл находится в / blog / <title>, поэтому, когда URL попадает на мой статический сервер, он должен быть в этой форме. Поэтому для поддержки URL базы данных требуется:

1. Формат URL правильный
2. Заголовок сообщения фактически находит сообщение
3. Дата в URL совпадает с датой публикации

/* main url handler: /{year}/{month}/{day}/{post} */
route.all(/^\/([0-9]{4})\/([0-9]{1,2})\/([0-9]{1,2})\/(
 
  .*?)(\/)?$/, 
  function (req, res, next) {
  var params = req.params;

  // the title slug of the url
  var post = blogs
];

  // make sure we have a real post before even proceeding
  if (post && post.date) {
    // test if the date matches

    // post.date is a timestamp, so splitting gets us the date
    var date = moment(post.date.split(' ')[0]);

    var requestDate = params.slice(1, 4).join('-');

    // compare the date of post _in the same format_ as requestDate
    if (date.format('YYYY-MM-DD') !== requestDate) {
      // if it's not good, move on - will likely result in a 404
      return next();
    }

    // if there's a trailing slash, remove it and redirect
    if (params[5] === '/') {
      res.writeHead(302, { 'location': req.url.replace(/(.)\/$/, '$1')});
      res.end();
      return;
    }

    // this now allows Harp to pick up the correct post
    req.url = '/blog/' + params[4];
  }

  // then let the rest of the router do it's work
  next();
});
 

Статическое кеширование

Используя Harp в предыдущих проектах (документация JS Bin , наш сайт событий и мой бизнес-сайт ) и создал harp-static @ npm, который использует st @ npm для кэширования и обслуживания статических файлов.

Так что в моем пользовательском сервере, я указываю все маршруты вплоть до ст служил содержание. Я также поддерживаю переход по URL-адресам без .html в конце, опять же, чтобы мои старые URL-адреса работали. Я бы порекомендовал проверить статический источник арфы, если это вас интересует.

Использование специальных помощников внутри Арфы

В настоящее время, если вы хотите использовать библиотеку внутри Harp, такую ​​как moment.js , можно обойти это путем создания .jade- файла с источником moment.js (в данном случае) в качестве скрипта. По сути, минимизированный однострочный файл с префиксом — .

Затем включите библиотеку в общий файл, такой как макет, и у вас будет доступный помощник:

!- load the moment.js library for server side access
!= partial('/js/moment')

Кроме того, это сломалось бы во время компиляции в статические файлы. Я уверен, что это связано с моим настраиваемым процессом обслуживания, но путь будет каким-то образом неправильным (поэтому библиотека не будет загружаться, и далее в моем коде в Jade будут исключения из-за того, что библиотека не существует).

Умный способ обойти это разоблачить глобальный от внешней арфы . Итак, в моем файле server.js (который выполняет всю маршрутизацию и т. Д.) Я требую в moment.js, а затем выставляю его глобально :

// this line, although dirty, ensures that Harp templates
// have access to moment - which given the whole partial
// import hack doesn't work consistently across dynamic vs
// compiled, this is the cleanest solution.
global.moment = moment;

var blogs = require('./public/blog/_data.json');
var slugs = Object.keys(blogs);

each post in recent
  li
    a(href="#{ public.blog._data[post.slug].relative }") #{ public.blog._data[post.slug].title }
    small  updated #{ moment(post.date).fromNow() }

!= partial('../../_partials/tag')

tag = filter === undefined ? current.path.slice(-2, -1)[0] : filter;
posts = partial('posts', { filter: function (post) { return post.tags.indexOf(tag) !== -1 } })
.post
  h1.title Tagged with "#{ tag }"
  .post-content
    ul
      while posts.length
        post = posts.shift()
        if post.date
          li
            a(href="#{ post.relative }") #{ post.title }
            small.date #{ moment(post.date).format('D-MMM YYYY')}

$ make release-minor publish