文档章节

sphinx生成cakephp文档

SnowFlake
 SnowFlake
发布于 2016/06/20 16:12
字数 384
阅读 2
收藏 0

cakephp的文档是用一个叫sphinx程序生成的 这个程序是python写的,所以我们要用sphinx本机必须先装python。

编译过程在Ubuntu下进行,默认Ubuntu已经安装了python, 命令行下依次执行

sudo apt-get install python-setuptools
sudo apt-get install easy_install
easy_install sphinx
easy_install sphinxcontrib-phpdomain

最后把cakephp的官方文档下载到本地.

git --clone https://github.com/cakephp/docs.git
#根目录执行
cd docs 
make html 
#或者使用下面的命令,只编译en目录,就是英文的HTML文档,
make html-en

编译完成后最终根目录下多出个build目录,打开html/en/index.html。

页面和官网一模一样!http://book.cakephp.org/2.0/en/index.html

 

执行make实际运行的是Makefile文件,在windows下是make.bat批处理, 不过遗憾的是cakephp官方人员并没有提供bat文件。

关于这个问题,我壮着胆子还专门发邮件问了cakephp的作者Mark Story,没想到过了两天给我回信了,内容贴给大家看:

Unfortunately I've never tried to build the docs under windows. There is some support from sphinx (the tool we use to build the docs) for windows. But the additional customizations we've done to make it easy to build all the languages etc were never ported to windows as most people working on the docs don't use windows.

-Mark

On 2013-07-04, at 12:09 AM, Finley Fei Ma
wrote:

> Hi, Mark,
> I am a CakePHP fan also a PHP developer from China, recently I am studying the CakePHP doc, I meet a problem, I don’t know how to build the document under the Windows operating system, there is a Makefile,  looks like it only can run under Linux. So must I install  a Linux operating system?
>  
> Regards,
> Finley

本文转载自:http://www.cnblogs.com/mafeifan/p/3259945.html

SnowFlake
粉丝 9
博文 171
码字总数 0
作品 0
郑州
程序员
私信 提问
CakePHP 2.0 发布,PHP的Web应用框架

CakePHP开发团队已经发布了CakePHP 2.x系列的一个版本CakePHP 2.0。在该版本中不再支持PHP4,CakePHP团队对其代码库进行了重构,以便严格遵循PHP 5规范(包括5.2及以后版本)。 CakePHP是一个...

鉴客
2011/10/19
2.3K
2
CakePHP 3.4.0 和 3.3.15 发布,PHP 开发框架

CakePHP 核心团队很高兴地宣布 CakePHP 3.4.0 和 3.3.15 发布了,CakePHP 是一个 PHP 的快速开发框架,使用常见的设计模式,如关联数据映射、前端控制器和 MVC。 主要目标是提供一个结构化框...

两味真火
2017/02/13
1K
3
CakePHP 3.8.2 发布,PHP 快速开发框架

CakePHP 3.8.2 发布了,这是一个维护版本,修复了以下问题: 将 simplexml 添加到 cakephp/utility 的要求中 i18n extract 现在像其他核心 shell 一样支持 -p 选项 改进 API 文档 修复了与 ...

xplanet
08/10
630
0
CakePHP 2.6.7 发布,PHP 开发框架

CakePHP 2.6.7 发布,这是 CakePHP 2.6.6 的紧急修复版本,包括了 PHP < 5.4 的语法错误修复。如果你在使用 PHP < 5.4.0 请升级到 2.6.7 版本。此版本现已提供下载: https://github.com/cak...

oschina
2015/05/30
734
2
在 Windows Azure 网站上运行 CakePHP 应用

上周我搞了个简单的 CakePHP 应用并在 Windows Azure 上跑了起来。 CakePHP是一个运用了诸如ActiveRecord、Association Data Mapping、Front Controller和MVC等著名设计模式的快速开发框架。...

红薯
2012/08/02
1K
4

没有更多内容

加载失败,请刷新页面

加载更多

可见性有序性,Happens-before来搞定

写在前面 上一篇文章并发 Bug 之源有三,请睁大眼睛看清它们 谈到了可见性/原子性/有序性三个问题,这些问题通常违背我们的直觉和思考模式,也就导致了很多并发 Bug 为了解决 CPU,内存,IO ...

tan日拱一兵
24分钟前
2
0
网络七层模型与TCP/UDP

为了使全球范围内不同的计算机厂家能够相互之间能够比较协调的进行通信,这个时候就有必要建立一种全球范围内的通用协议,以规范各个厂家之间的通信接口,这就是网络七层模型的由来。本文首先...

爱宝贝丶
27分钟前
2
0
Jenkins World 贡献者峰会及专家答疑展位

本文首发于:Jenkins 中文社区 原文链接 作者:Marky Jackson 译者:shunw Jenkins World 贡献者峰会及专家答疑展位 本文为 Jenkins World 贡献者峰会活动期间的记录 Jenkins 15周岁啦!Jen...

Jenkins中文社区
45分钟前
8
0
杂谈:面向微服务的体系结构评审中需要问的三个问题

面向微服务的体系结构如今风靡全球。这是因为更快的部署节奏和更低的成本是面向微服务的体系结构的基本承诺。 然而,对于大多数试水的公司来说,开发活动更多的是将现有的单块应用程序转换为...

liululee
今天
7
0
OSChina 周二乱弹 —— 我等饭呢,你是不是来错食堂了?

Osc乱弹歌单(2019)请戳(这里) 【今日歌曲】 @ 自行车丢了:给主编推荐首歌 《クリスマスの夜》- 岡村孝子 手机党少年们想听歌,请使劲儿戳(这里) @烽火燎原 :国庆快来,我需要长假! ...

小小编辑
今天
727
11

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部