# swallow

**Repository Path**: carlos/swallow

## Basic Information

- **Project Name**: swallow
- **Description**: 轻量博客引擎,基于python/webpy + mysql + markdown + jQuery开发
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2013-10-02
- **Last Updated**: 2021-12-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

###Swallow 轻量博客引擎 
基于python/web.py + mysql + markdown +  jQuery  

1. 文章内容为markdown格式  
2. 后台访问地址为 /admin  
3. 管理员默认密码为 888888  
4. 只支持单用户  
5. 默认输出全文rss (只有标题和摘要的rss源都是耍流氓！)  
6. 评论系统使用第三方服务，请在后台进行配置中输入评论系统的js调用代码

*ps:只在python2.7下测试通过，其他版本未做任何测试。*  
*如有任何疑问，请联系 tieniuzai#qq.com*

###一、环境部署
####1.环境要求
---  
python 2.7  
web.py 0.3.7  
markdown >=1.2  
MySQL-python  

####2.创建数据库  
---
MySQL Shell > create database swallow default character set utf8;   
MySQL Shell > use swallow;  
MySQL Shell > source /path/to/app/doc/swallow.sql;  

####3.创建配置文件 
---
shell > cd /path/to/app  
shell > cp configs.py.default configs.py  

修改配置文件中configs.py line 6中数据库配置  
user 数据库用户名  
pw   数据库密码
db   数据库名称

####4.启动测试环境
---
运行命令  
python /path/to/app/swallow.py  
通过浏览器访问 http://127.0.0.1:8080 即可访问  

*如果出现无法正常启动，请根据错误信息，确认运行环境是否搭建成功。*  

####5.部署正式环境
---
*以下以安装Nginx+uWSGI为例，如有使用其他环境，请自行修改。*

**安装uwsgi**  
easy_install uwsgi  

**nginx配置**  
    
    server {  
        listen 80;  
        server_name  your domain;  

        location / {
            root /var/www/swallow;
            include uwsgi_params;
            uwsgi_pass 127.0.0.1:8080;
            uwsgi_param UWSGI_CHDIR /var/www/swallow;
            uwsgi_param UWSGI_SCRIPT swallow;
        }

        location = /favicon.ico {
                root /var/www/swallow/static/;
                access_log off;
        }

        location  /static/ {
            root /var/www/swallow;
            if (-f $request_filename) {
                rewrite ^/static/(.*)$ /static/$1 break;
            }
        }
    }  
  
**启动服务**  
nginx -s reload  
uwsgi -s 127.0.0.1:8080 -w swallow --daemonize /var/log/swllow 


###二、可能遇到的问题  
  
**1.EnvironmentError: mysql_config not found**   
sudo apt-get install libmysqld-dev  

**2.error: Setup script exited with error: command 'gcc' failed with exit status 1**  
sudo apt-get install python-dev