關於寫做那些事之github告訴我構建失敗,而後呢?

The page build failed for the master branch with the following error

問題描述

看到這封郵件,一臉懵逼,本地運行 gitbook 服務是正常渲染的,控制檯並無任何報錯,誰知道推送到 github 時就報錯了!

登陸到 github 網站查看網站源碼已經同步過來了,可是靜態網站沒法同步,本地實在找不到任何報錯信息,這讓我如何是好?

再看 github 反饋用的郵件中說道,若有問題能夠回覆郵件(If you have any questions you can contact us by replying to this email.).

而後死馬當活馬醫,嘗試闡釋了個人問題,請求幫助定位錯誤日誌,沒想到當天下午就收到 github 的回覆郵件,提供瞭解決辦法!

問題是因爲 Liquid Warning: Liquid syntax error (line 334) 錯誤,然而我肯定這部分代碼是沒有任何問題的,由於這是我改造 gitbook-plugin-tbfed-pagefooter 插件時的一段代碼,反覆確認後發現並無複製粘貼出錯啊!

var moment = require('moment');
module.exports = {
  book: {
    assets: './assets',
    css: [
      'footer.css'
    ],
  },
  hooks: {
    'page:before': function(page) {
      var _label = '最後更新時間: ',
          _format = 'YYYY-MM-DD',
          _copy = 'powered by snowdreams1006'
      if(this.options.pluginsConfig['tbfed-pagefooter']) {
        _label = this.options.pluginsConfig['tbfed-pagefooter']['modify_label'] || _label;
        _format = this.options.pluginsConfig['tbfed-pagefooter']['modify_format'] || _format;

        var _c = this.options.pluginsConfig['tbfed-pagefooter']['copyright'];
        _copy = _c ? _c + ' all right reserved，' + _copy : _copy;
      }
      var _copy = '<span class="copyright">'+_copy+'</span>';
      var str = ' \n\n<footer class="page-footer">' + _copy +
        '<span class="footer-modification">' +
        _label +
        '\n{{file.mtime | date("' + _format +
        '")}}\n</span></footer>';

      str += '\n\n<link rel="stylesheet" href="https://unpkg.com/gitalk/dist/gitalk.css">'+
      '\n\n<script src="https://unpkg.com/gitalk@latest/dist/gitalk.min.js"></script>'+
      '\n\n<div id="gitalk-container"></div>'+
      '\n\n<script src="https://snowdreams1006.github.io/gitalk-config.js"></script>';

      page.content = page.content + str;
      return page;
    }
  },
  filters: {
    date: function(d, format) {
      return moment(d).format(format)
    }
  }
};

來源於 gitbook-plugin-tbfed-pagefooter 插件的 index.js 文件,這裏爲了兼容 gitalk 插件而集成了相關代碼,詳情請參考 gitalk 評論插件

解決方案

根據郵件回覆,定位到出錯代碼片斷,真的沒發現有什麼問題啊?

既然已經肯定不是個人問題,那極可能就是 github 的問題了,郵件中推薦我使用 Jekyll 進行構建網站,不不不!

既然已經選擇 gitbook 搭建靜態網站,那就不必再使用 Jekyll ,我可不想那麼麻煩!

If you are not using Jekyll you can disable it by including a .nojekyll file in the root of your repository.

因此我不妨試試新增 .nojekyll 文件,說不定就好使了呢!

$ touch .nojekyll
$ git add .nojekyll
$ git commit -m "add .nojekyll"
$ git push

天不負我!居然真的好使了,再也沒有收到 github 的報錯郵件反饋了,源碼和網站都正常更新了!

小結

據我推測,多是 github 誤認爲個人網站是使用 Jekyll 工具構建的,實際上,是使用 gitbook 構建的!

所以,增長 .nojekyll 文件禁用 Jekyll 工具,天然不會再受相關語法限制而報錯了.

因此,遇到問題時,不只要多思考,更應該尋求官方人員的幫助,即便不回你,你也要嘗試一下!