漫言模板,或称漫言主题、漫言前端,英文项目名为 mangatalk-twentynineteen
,是一个 WordPress 主题,驱动着漫画媒体网站「漫言 MangaTalk」的所有前端页面。
漫言模板的作者是 Karuto,这个模板系统自 2012 年初版上线起几经大改,目前最新一版是基于 Karuto 的父主题系统(WordPress 官方模板 Twenty Nineteen 的个人衍生版)改造而成,因此本项目的英文名称随官方惯例,以发布的年份标记。
本软件基于 GPL v3 通用公共许可协议发布,开发者不承担延用后产生的任何法律责任。
-
搭建一个 WordPress 博客的本地开发环境。请遵循 WordPress 官方的常规指示,直到你可以正常访问本地博客的首页和后台为止。
-
获取漫言开发用数据库备份,将你在第一步新建的 WordPress 数据库覆盖。
-
进入
wp_options
数据表,将siteurl
和home
两项改为你的本地开发环境地址,如http://localhost:3000
。 -
使用
git clone
将本项目拷贝至wp_contents/themes
目录下。拷贝后的项目文件夹名称必须是mangatalk-twentynineteen
。 -
本地开发环境搭建完毕。确认你可以正常访问本地博客的首页和后台。
在对漫言模板进行修改和开发之前,需要确保 node 8
和 npm 4
已被正常安装。
npm install
漫言模板使用 Sass
预处理器进行 CSS 的开发和编译。本地开发或修改 CSS,需要在 sass/
目录下进行。
修改后,对 CSS 进行一次性的编译:
npm run build
这将会在项目根目录下生成编译后的单个 CSS 文件,style.css
,以及相关的 source maps。style.css
会被保存到 git 的版本历史中,因此在生产环境(production environment)中无需再进行即时的 CSS 编译。
注:如果你在开发过程中切换了 node
的版本,请执行以下命令,将 node-sass
依赖包重新组建,否则编译将会出现问题:
npm rebuild node-sass
漫言模板提供对 Sass
文件的实时监听与自动重载,便于本地开发:
npm run watch
漫言模板,如同所有 WordPress 模板主题一样,使用 PHP 作为驱动模板和后端的语言。
漫言模板组织 PHP 代码的理论与思路,请见 Karuto 的父主题系统的文档。
请联系本项目作者 Karuto,或来信至 hi@mangatalk.net。