Skip to content

Latest commit

 

History

History
93 lines (60 loc) · 4.9 KB

Readme_chinese.md

File metadata and controls

93 lines (60 loc) · 4.9 KB

公共图书馆

Python Build JS Build Join the chat at https://gitter.im/theopenlibrary/Lobby Open in Gitpod

公共图书馆是一个开放的,可以编辑的图书平台。它为每一本已经出版的图书建立了其相关的网页。

您准备好开始了吗? 这份指南或许是您所需要的。您可能也会想要了解谷歌编程之夏(GSoC)?或者是十月黑客庆典

目录

概述

公共图书馆创立于2006年,致力于“给每一本已经出版的图书建立其相关的页面”。它提供了对主流领域和绝版书籍的访问权限,允许人们在线阅读。

这个视频可以让您更快地了解公共图书馆,以及它所提供的服务(大约10分钟)。

archive org_embed_openlibrary-tour-2020 (1)

安装

执行 docker compose up 并且访问 http://localhost:8080

需要更多信息?请查看 Docker指南 或者视频教程

或者,如果您不想在本地的电脑上安装公共图书馆,您可以尝试Gitpod!这可以让您在不安装任何插件的前提下,在浏览器中使用公共图书馆。警告:此集成仍在实验中。 Open In Gitpod

给开发者的指南

有关管理公共图书馆实例的说明,请参考开发者的快速入门指南。

您还可以在公共图书馆里的公共图书馆中找到更多关于开发说明书的信息Wiki

代码组成

  • openlibrary/core - 公共图书馆的核心功能,由www导入和使用
  • openlibrary/plugins - 其它模型、控制器和视图帮助器
  • openlibrary/views - 网页视图的呈现
  • openlibrary/templates - 所有在网页里使用的模板
  • openlibrary/macros - macros和模板类似,但可以被wikitext调用

结构

后端

公共图书馆是在Infogami wiki系统的基础上开发的,该系统本身建立在web.py Python web应用框架和Infobase数据库之上。

当您阅读完后端技术概要,我们强烈建议您阅览开发者入门手册,它解释了如何使用Infogami(及其数据库,Infobase)

如果您想更深入地了解Infogami的源代码,请参阅Infogami repo

运行测试

公共图书馆的测试可用pytest运行。 请参阅我们的测试文档以了解更多的信息

请在docker运行时进行测试

cd docker/
docker compose exec web make test

集成测试

集成测试需要使用Splinter webdriver和谷歌浏览器。关于安装要求和运行集成测试的说明,请参阅集成测试README

许可证

这里发布的所有源代码都是依据以下条款GNU Affero General Public License, version 3