Box é um container usado para processar arquivos em um diretório específico. O Hexo usa dois Boxes diferentes: hexo.source ehexo.theme. O primeiro é usado para processar o diretório source e o segundo para processar o diretório theme.

Carregar Arquivos

O Box fornece dois métodos para carregar arquivos: process ewatch. process carrega todos os arquivos no diretório. watch faz o mesmo, mas também começa a assistir as mudanças nos arquivos.

box.process().then(function(){
  // ...
});

box.watch().then(function(){
  // You can call box.unwatch() later to stop watching.
});

Correspondência Caminho (Path Matching)

O Box fornece muitas maneiras para a correspondência de caminho. Você pode usar uma expressão regular, uma função ou uma string no padrão Express-style. Por exemplo:

posts/:id => posts/89
posts/*path => posts/2015/title

Veja util.Pattern para mais informações.

Processors

Um processor é um elemento essencial do Box e é usado para processar arquivos. Você pode usar o path matching conforme descrito acima para restringir o que exatamente o processor deve processar. Registre um novo processor com o método addProcessor.

box.addProcessor('posts/:id', function(file){
  //
});

O Box passa o conteúdo dos arquivos correspondentes aos processadores. Esta informação pode então ser lida diretamente do argumento file no retorno do callback:

O Box também fornece alguns métodos para que você não precise fazer o IO (entrada e saída) de arquivo por conta própria.