一個(gè)正常運(yùn)作的 Harp 應(yīng)用需要公有的目錄。它決定了哪些會(huì)被公共服務(wù)，以及應(yīng)用會(huì)暴露哪些 URL。公共文件放在 public 目錄中，public 目錄之外的文件不會(huì)被解析。

myapp/
  |- harp.json
  |- README.md               <--- won’t be served
  |- secrets.txt             <--- won’t be served
  +- public/                 <--- public directory
      +- index.html          <--- will be served

忽略以下劃線開頭的那些。

任何以下劃線開頭的文件都會(huì)被服務(wù)器忽略。這是 layout 和 partial 文件的推薦命名約定。Harp 將會(huì)對(duì)文件和目錄都遵循這個(gè)規(guī)則。

根目錄風(fēng)格應(yīng)用

還可以有一種根目錄風(fēng)格的應(yīng)用，public 目錄事實(shí)上就是根目錄。這種情況下，你仍然可以通過在文件名前加下劃線，來(lái)避免它們對(duì)外伺服。

myapp/                       <--- public directory
    |- _harp.json
  |- _secrets.txt            <--- won't be served
  +- index.html              <--- will be served

設(shè)計(jì)原理

通過一個(gè)簡(jiǎn)單的約定，指定和鑒別哪些文件不對(duì)終端用戶服務(wù)變得相當(dāng)簡(jiǎn)單。

示例

myapp/
  |- harp.json               <--- won’t be served
  +- public/                 <--- public directory
      |- index.html          <--- will be served
      |- _some-partial.jade  <--- won’t be served
      +- _shared-partials/   <--- won’t be served
          +- nav.jade

myapp/                       <--- public directory
  |- _harp.json
  |- index.html              <--- will be served
  |- _some-partial.jade      <--- won’t be served
  +- _shared-partials/       <--- won’t be served
      +- nav.jade