Hexo 入门指南（二） - 安装、初始化和配置

安装和初始化

linux下打开bash，win下面打开cmd，输入：

  1. $ npm install hexo -g
  2. $ hexo init blog
  3. $ cd blog
  4. $ npm install
  5. $ hexo server

访问http://localhost:4000，会看到生成好的博客。

同时，在blog文件夹中，文件如下：

  1. 2014/11/01  19:45    <DIR>          .
  2. 2014/11/01  19:45    <DIR>          ..
  3. 2014/11/01  11:16                68 .gitignore
  4. 2014/11/01  17:33            13,767 db.json
  5. 2014/11/01  11:16    <DIR>          node_modules
  6. 2014/11/01  11:17               186 package.json
  7. 2014/11/01  11:23    <DIR>          public
  8. 2014/11/01  11:16    <DIR>          scaffolds
  9. 2014/11/01  17:31    <DIR>          source
  10. 2014/11/01  11:16    <DIR>          themes
  11. 2014/11/01  11:38             1,844 _config.yml

配置

站点的配置文件是_config.yml，如果你不小心改花了，这里提供了一份默认的：

  1. # Hexo Configuration
  2. ## Docs: http://hexo.io/docs/configuration.html
  3. ## Source: https://github.com/hexojs/hexo/
  5. # Site
  6. title: Hexo
  7. subtitle:
  8. description:
  9. author: John Doe
  10. email:
  11. language:
  13. # URL
  14. ## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
  15. url: http://yoursite.com
  16. root: /
  17. permalink: :year/:month/:day/:title/
  18. tag_dir: tags
  19. archive_dir: archives
  20. category_dir: categories
  21. code_dir: downloads/code
  22. permalink_defaults:
  24. # Directory
  25. source_dir: source
  26. public_dir: public
  28. # Writing
  29. new_post_name: :title.md # File name of new posts
  30. default_layout: post
  31. titlecase: false # Transform title into titlecase
  32. external_link: true # Open external links in new tab
  33. filename_case: 0
  34. render_drafts: false
  35. post_asset_folder: false
  36. relative_link: false
  37. highlight:
  38.   enable: true
  39.   line_number: true
  40.   tab_replace:
  42. # Category & Tag
  43. default_category: uncategorized
  44. category_map:
  45. tag_map:
  47. # Archives
  48. ## 2: Enable pagination
  49. ## 1: Disable pagination
  50. ## 0: Fully Disable
  51. archive: 2
  52. category: 2
  53. tag: 2
  55. # Server
  56. ## Hexo uses Connect as a server
  57. ## You can customize the logger format as defined in
  58. ## http://www.senchalabs.org/connect/logger.html
  59. port: 4000
  60. server_ip: localhost
  61. logger: false
  62. logger_format: dev
  64. # Date / Time format
  65. ## Hexo uses Moment.js to parse and display date
  66. ## You can customize the date format as defined in
  67. ## http://momentjs.com/docs/#/displaying/format/
  68. date_format: MMM D YYYY
  69. time_format: H:mm:ss
  71. # Pagination
  72. ## Set per_page to 0 to disable pagination
  73. per_page: 10
  74. pagination_dir: page
  76. # Disqus
  77. disqus_shortname:
  79. # Extensions
  80. ## Plugins: https://github.com/hexojs/hexo/wiki/Plugins
  81. ## Themes: https://github.com/hexojs/hexo/wiki/Themes
  82. theme: landscape
  83. exclude_generator:
  85. # Deployment
  86. ## Docs: http://hexo.io/docs/deployment.html
  87. deploy:
  88.   type:

官方的页面上也提供了每一项详细的解释。

我们需要修改的只有Site部分，以及URL部分的url。Site部分每一项依次是标题、副标题、描述、作者、邮箱和语言（天朝大陆填zh-CN）。url改成网站的网址，如果你的网站放在某个子目录下，比如http://yoursite.com/child，root改成/child。

Server部分，如果之前你的服务器没有运行起来，则可能是端口被占了。把port改成别的数字，或者强行关掉占着端口的进程。

其它设置项先不用管，将会在接下来的文章中解释。

注意

如果页面中出现中文，应以UTF-8无BOM编码格式，所以不要用win自带的记事本，而是用notepad++这种支持编码转换的编辑器。

由于google在天朝大陆被墙，进入themes\landscape\layout_partial，打开head.ejs，删掉第31行fonts.googleapis.com的链接。

下载下来jquery-2.0.3.min.js，放到themes\landscape\source\js文件夹中。之后进入themes\landscape\layout_partial，打开after-footer.ejs，将第17行的路径替换为/js/jquery-2.0.3.min.js。

至此大功告成。