中文 (Chinese)English

1
前提条件

开始之前先确保你已经安装了Node.js 0.10+ 和MongoDB v2.4+。

要使用KeystoneJS,你需要掌握合理的Javascript知识,并熟悉数据库概念之类的基础知识,会用 node / npm 等。

2
命令

安装生成器

你将要使用由Yeoman制作的KeystoneJS 生成器。在根目录运行:

npm install -g generator-keystone

给项目创建一个文件夹

你可以在任何地方创建项目:

mkdir my-test-project

然后进入新项目目录:

cd my-test-project

运行生成器

yo keystone

生成器会问你几个问题,主要是你想要什么功能,然后进行配置,并把你需要的所有文件复制到你的项目目录中。

它还会从npm中安装依赖项,帮你做好准备。

3
搞定了!

你刚刚创建了自己的第一个KeystoneJS项目,恭喜你!

像这样在命令行中运行它:

node keystone

然后打开http://localhost:3000 在浏览器中看看。

如果你想知道生成器究竟做了什么,可以看一下我们的入门指南,它介绍了手动搭建过程。如果你刚接触Node.js,看一下对你非常有帮助。

查阅入门指南 →

?
问题

出错了?希望下面这些提示会有帮助。

错误!请试着以root/管理员身份重新运行该命令。

在运行npm install -g generator-keystone时,你可能会遇到EACCES错误,让你以root/管理员身份重新运行这个命令。这表明有许可权限问题。

你可以在开发系统中将目录的所有权改成当前$USER,这样在安装非受信代码时就不必运行sudo了:

sudo chown -R $USER /usr/local
 
# 某些O/S可能还要改其它目录
sudo chown -R $USER /usr/lib/node_modules/

在生产/共享环境中,你可能希望带着sudo前缀重新运行npm命令:

sudo npm install -g generator-keystone

要了解更多信息,请参阅Isaac Schulueter写的Intro to npm中的"什么, 没sudo?"章节。

你说找不到我的数据库是什么意思?

默认情况下,KeystoneJS会在localhost的默认端口下连接运行中的MongoDB服务器。如果你遇到跟MongoDB连接相关的错误,请确保MongoDB服务器运行着。

如果你还没装MongoDB,请按照下面的指示操作。

要连接除localhost之外的其它服务器,找到Keystone项目目录下的.env文件,添加MONGO_URI配置:

MONGO_URI=mongodb://your-server/database-name

其它问题?

如果你的问题还没解决,可以到KeystoneJS谷歌群组上找我们。