一、 创建requirements.txt文件
requirements.txt文件是一个项目的依赖文件,可以通过下面的方式自动生成:
进入虚拟环境,切换到项目根目录下,使用pip工具的freeze参数。
(mysite_env) F:\Django_course\mysite>pip freeze > ./requirements.txt
打开requirements.txt文件,其内容如下:
Django==1.11.7
django-simple-captcha==0.5.5
olefile==0.44
Pillow==4.3.0
pytz==2017.3
six==1.11.0
他人如果拷贝了我们的代码,要安装第三方库依赖的话,只需要:
pip install -r requirements.txt
就可以一次性安装好所有的库了。
二、创建.gitignore文件
在项目代码中,有一些文件是不能上传的,比如密码文件、数据库文件、核心配置文件等等,还有一些是不用上传的,比如临时文件。为了让git自动忽略这些文件,我们需要创建一个忽略名单。
在项目根目录下新建一个.gitignore文件,这里可能需要你在Pycharm下安装ignore插件,如下图所示:
我这里是已经安装好了,新安装的话,要在搜索栏里搜索到插件后再安装。
在.gitignore文件里写入下面的内容:
.idea
settings.py
db.sqlite3
mysite/__pycache__/
这些文件将不会上传到Github中,也不会进行版本管理。
三、特殊文件处理
对于settings.py文件有个问题,如果没有这个文件是无法运行Django项目的,但是settings中又可能包含很多关键的不可泄露的部分,比如SECRET_KEY:
# SECURITY WARNING: keep the secret key used in production secret!SECRET_KEY = 'b(&6i_$g2%8vh)ruu$)a9pkw+s-e&qj_e_#=@gnbo^48#gp_8a'
还有数据库的IP/port、用户名和密码,邮件发送端的用户名和密码,这些都是绝对不能泄露的。
那怎么办呢?简单!复制settings文件,并重命名为settings.example.py文件,放在同一目录里,把敏感信息、密码等修改或删除。使用者看到这个文件名,自然会明白它的作用。
四、添加说明文件和许可文件
通常我们要给Github的仓库添加说明文件和许可文件。
在项目根目录下创建一个README.md文件,这是markdown格式的。在文件里写入项目说明,使用方法,注意事项等等所有你认为需要说明的东西。
对于许可文件LICENSE,如果你暂时不想公开授权,或者不知道用哪种授权,可以暂时不提供。
下面是一个APACHE2.0授权的范例:
mysite - User login and register system Copyright 2017- www.liujiangblog.com Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
发送邮件
Django 日志Django与缓存认证系统 AuthenticationDjango与CSRF 、AJAXDjango 国际化和本地化部署 Django实战一:用户登录与注册系统1. 搭建项目环境2. 设计数据模型3. admin后台4. url路由和视图5. 前端页面设计6. 登录视图7. Django表单8. 图片验证码9. session会话10. 注册视图11.使用Django发送邮件12. 邮件注册确认13. 使用Github管理项目实战二:CMDB之资产管理系统1.项目需求分析2.模型设计3.数据收集客户端4.Windows下收集数据5.Linux下收集数据6.新资产待审批区7.审批新资产8.已上线资产信息更新9.前端框架AdminLTE10.资产总表11.资产详细页面12.dashboard仪表盘
13. 使用Github管理项目
阅读: 736
项目介绍到这里,基本就结束了,可对于真正的业务开发,还只是刚开始。
不管是对于教程代码免费分享的需要,还是项目开发过程中的版本管理,Github都是我们首选的开源代码仓库,如果你没有私有仓库,并且不用保护代码,那么将项目上传到Github上是最佳的选择。
关于如何使用Git软件请自行学习,或许以后有空我也会写点教程。如何在Pycharm中配合Github,则在站点的博客中有一篇《在Pycharm中使用GitHub》,可供大家参考。
一、 创建requirements.txt文件
requirements.txt文件是一个项目的依赖文件,可以通过下面的方式自动生成:
进入虚拟环境,切换到项目根目录下,使用pip工具的freeze参数。
(mysite_env) F:\Django_course\mysite>pip freeze > ./requirements.txt
打开requirements.txt文件,其内容如下:
Django==1.11.7django-simple-captcha==0.5.5olefile==0.44Pillow==4.3.0pytz==2017.3six==1.11.0
他人如果拷贝了我们的代码,要安装第三方库依赖的话,只需要:
pip install -r requirements.txt
就可以一次性安装好所有的库了。
二、创建.gitignore文件
在项目代码中,有一些文件是不能上传的,比如密码文件、数据库文件、核心配置文件等等,还有一些是不用上传的,比如临时文件。为了让git自动忽略这些文件,我们需要创建一个忽略名单。
在项目根目录下新建一个.gitignore文件,这里可能需要你在Pycharm下安装ignore插件,如下图所示:
我这里是已经安装好了,新安装的话,要在搜索栏里搜索到插件后再安装。
在.gitignore文件里写入下面的内容:
.ideasettings.pydb.sqlite3mysite/__pycache__/
这些文件将不会上传到Github中,也不会进行版本管理。
三、特殊文件处理
对于settings.py文件有个问题,如果没有这个文件是无法运行Django项目的,但是settings中又可能包含很多关键的不可泄露的部分,比如SECRET_KEY:
# SECURITY WARNING: keep the secret key used in production secret!SECRET_KEY = 'b(&6i_$g2%8vh)ruu$)a9pkw+s-e&qj_e_#=@gnbo^48#gp_8a'
还有数据库的IP/port、用户名和密码,邮件发送端的用户名和密码,这些都是绝对不能泄露的。
那怎么办呢?简单!复制settings文件,并重命名为settings.example.py文件,放在同一目录里,把敏感信息、密码等修改或删除。使用者看到这个文件名,自然会明白它的作用。
四、添加说明文件和许可文件
通常我们要给Github的仓库添加说明文件和许可文件。
在项目根目录下创建一个README.md文件,这是markdown格式的。在文件里写入项目说明,使用方法,注意事项等等所有你认为需要说明的东西。
对于许可文件LICENSE,如果你暂时不想公开授权,或者不知道用哪种授权,可以暂时不提供。
下面是一个APACHE2.0授权的范例:
mysite - User login and register system Copyright 2017- www.liujiangblog.com Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
五、上传代码
在上传过程中,确认文件列表的时候,一定要注意查看没有保密文件被上传。
等待一会,项目文件上传完毕后,进入Github的仓库页面,如下所示:
点击进入详细页面:
现在,所有人都可以通过下面的方式,下载和使用本项目的源代码了:
git clone https://github.com/feixuelove1009/liujiangblog_project_1
六、使用Github仓库中的源码
如果你不是从教程的开始一步步地实现整个项目,而是直接使用从Github上copy下来的整个源码,那么你可能需要做一些额外的工作,比如:
创建虚拟环境
使用pip安装第三方依赖
修改settings.example.py文件为settings.py
运行migrate命令,创建数据库和数据表
运行python manage.py runserver启动服务器
而在Pycharm中运行服务器的话,可能还需要做一些额外的工作,比如:
配置解释器
配置启动参数
因为你本地Pycharm的配置情况,可能会发生不同的问题,需要根据实际情况实际处理,下面给两张配置图,供大家参考:
以上内容,都经过实际测试,如果你依然不能顺利启动服务器,请详细检查Pycharm的配置。
好了,本项目到此结束,期待下一个新的项目!
网友评论