OpenResty.org - Code and data for the official site of OpenResty
Table of Contents
This repository holds the source code and configurations for the official OpenResty site.
This site is a dynamic web application built entirely upon the OpenResty stack, backed by the PostgreSQL database management system.
The latest generation of this site is under the
v2/ directory of this repository.
You need to install both OpenResty and PostgreSQL 9.x, obviously.
brew install pandoc npm install marked cheerio axios pug sharp
You'll also need
perl installed in your system for building the web site (not needed for serivce deployment though).
cd v2/ make gendata # generate data files from .md files # create the test database "openresty_org" and the test account "openresty" in your local PostgreSQL server. # using commands in the initial comment lines of the init.sql file. # for example: psql -Upostgres # or "psql postgres", depending on your Pg installation # postgres=# create user openresty with password 'speedtheweb'; # postgres=# create database openresty_org; # postgres=# grant all privileges on database openresty_org to openresty; make initdb # create the database and load the data files make run # starting the test nginx server listened on localhost:8080 make reload # for reloading the test nginx server
If your machine has more than one spare CPU cores, then you can specify the
-jN option of
make to build the HTML
docs in parallel, as in
make gendata -j8
This command will run the build in 8 parallel jobs, thus utilizing 8 CPU cores at most.
If you want to re-generate the
openresty_org.templates Lua module from the TT2 template files under
you need to install the Lemplate CPAN module like this:
sudo cpan Lemplate
and then just run
.po files under
po/ are for I18N (we need to support both the English and Chinese versions of this site, at least).
These files are similar to the
.po files used by the classic GNU gettext toolchain,
but we do not use
GNU gettext at all. Our
.po files would be automatically updated according to the latest Lua source
and TT2 template files with this command as well. If you make any edits to the
.po files, then remember to re-run the
make command to make your changes take effect (by updating the
openresty_org.i18n Lua module file from the
If you want to update the list of blog posts, then you need to run:
This command also downloads images from our blog site, compress these images and save them to /v2/images/header-images.
- Add responsive design to the web page templates for mobile devices with small screens.
- Add a in-memory caching layer to the openresty_org web app via lua-resty-lrucache and/or lua_shared_dict.
- Translate more English
.mddocuments into Chinese.
- Add a pager to the search result page in the
- Add an RSS feed endpoint in the
- Add another tab page to the right-hand side-bar of the web pages featuring the top N hot pages.
- Add an OpenResty logo to the web page header.
- Remove the dependency on
pandocby migrating to a standalone Perl script.
- Thanks Mashape.com for contributing the page templates for the v2 version of this site.
- Thanks leaf corcoran for contributing the pgmoon library for communicating with PostgreSQL via cosockets.
Yichun Zhang (agentzh) <email@example.com>
Copyright and License
This module is licensed under the BSD license.
Copyright (C) 2011-2017 by Yichun "agentzh" Zhang (章亦春) <firstname.lastname@example.org>, OpenResty Inc.
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- The OpenResty Survey web application.