This is the official documentation for the CakePHP project. It is available online in HTML, PDF and EPUB formats at http://book.cakephp.org.
You can read all of the documentation within as its just in plain text files, marked up with ReST text formatting. To build the documentation you'll need the following:
You can install sphinx using:
easy_install sphinx==1.2.3
You can install the phpdomain using:
easy_install sphinxcontrib-phpdomain
To run the easy_install command, the setuptools package must be previously installed.
After installing the required packages, you can build the documentation using make
.
# Create all the HTML docs. Including all the languages.
make html
# Create just the English HTML docs.
make html-en
# Create all the EPUB (e-book) docs.
make epub
# Create just the English EPUB docs.
make epub-en
# Populate the search index
make populate-index
This will generate all the documentation in an HTML form. Other output such as 'htmlhelp' are not fully complete at this time.
After making changes to the documentation, you can build the HTML version of the docs by using make html
again. This will build only the HTML files that have had changes made to them.
Building the PDF is a non-trivial task.
tlmgr
make latex-en
.make pdf-en
.At this point the completed PDF should be in build/latex/en/CakePHPCookbook.pdf.
Contributing to the documentation is pretty simple. Please read the documentation on contributing to the documentation over on the cookbook for help.
There are currently a number of outstanding issues that need to be addressed. We've tried to flag these with .. todo::
where possible. To see all the outstanding todo's add the following to your config/all.py
todo_include_todos = True
After rebuilding the HTML content, you should see a list of existing todo items at the bottom of the table of contents.
You are also welcome to make and suggestions for new content as commits in a GitHub fork. Please make any totally new sections in a separate branch. This makes changes far easier to integrate later on.
Contributing translations requires that you make a new directory using the two letter name for your language. As content is translated, directories mirroring the english content should be created with localized content.
searchUrl
in themes/cakephp/static/app.js
to point at the
baseurl for your docs_search clone.make populate-index
.此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。
1. 开源生态
2. 协作、人、软件
3. 评估模型