- CMS系统内置文件目录
-
/inc //碎片存放目录 /content //新闻或文章存放目录 /flashfile //上传flash文件存放目录(暂未使用) /picfile //上传图片文件存放目录 /videofile //上传视频文件存放目录(暂未使用) /cmstemplet //上传模板文件存放目录 以上六个为CMS内置目录,无需进行手动创建,在你发布新闻/文章/图片等内容时系统会根据预先定义自动创建这些目录。
CMS规范 - CMS系统内置文件目录
CMS规范 - CMS系统推荐的站点引用资源文件存放目录
- CMS系统推荐的站点引用资源文件存放目录
-
/widget //一些零散文件,包括广告文件、评论引用文件等 /rss //RSS存放目录 /css //样式文件存放目录 /img //图片文件存放目录 /js //脚本文件存放目录 1. 以上widget目录是推荐的“零碎”文件存放目录,可以将页面中iframe引用的公共广告小页面、评论系统依赖的文件等放入此目录。
2. 其它四个目录是推荐的站点引用资源文件存放目录,其中
rss:目录用来存放站点相关的rss输出文件,如站点XML文件。
css:目录用来存放页面引用的样式文件。
img:目录用来存放页面中用到的图片文件,
js:目录用来存放页面中引用的script脚本文件。
CMS规范 - 其它常用存储目录
- 其它常用存储目录
-
1. include:用于存放公用或被包含性质类的文件,比如头部、底部、菜单等。
2. sponsor:用户存放广告文件,包含广告css等
3. error: 用于存放如403、404等出错时的页面。
4. test:用于存放测试文件,测试文件测试完后,请及时删除。
5. index:用于存放主页,当根目录下存储站点扉页时,主页置于index目录下。
6. bak :用于存放备份文件(bbgsite备份文件夹,在css、js、templates、include、rss、view里均可设置bak文件夹)
7. templates :用于存放模板类性质的文件
8. script : 存放javascript文件
9. images:存放站点内容型图片,存放时间相对较久,内容相对固定
以上目录与推荐存储目录有重叠的,尽量使用推荐的目录。
CMS规范 - 目录存储规范
- 目录存储规范
-
1. cms后台只允许上传html、htm、shtml、ico、js、txt、css及图片等静态文件
2.根目录除了存放index、ico和robot外,建议其他文件不要放置根目录
3. 同一目录不能放太多的文件(小于1w个文件),有多个文件要放同一目录时,需要分子目录存放。
4. 临时测试用的文件、文章、新闻以及不再使用的页面、文件等应及时删除,以免造成服务器垃圾文件过多。
5. css和js文件尽量整理成每个子站点一个目录文件夹。
CMS规范 - 文件夹命名规范
- 文件夹命名规范
-
1. CMS建文件夹时不使用"in_"和"t_"开头的命名,这2个是cms的保留字(使用会出错)以后CMS升级后保留字会改为"cmsT_"和"cmsIn_"
2. 文件夹只能由字母、数字、下划线组成,CMS系统尽量只用小写的英文字,需要断开用英文下划线 “_ ”,而不是“ –” 或“-”,且文件夹不能有空格,尽量使用推荐或常用的目录。
CMS规范 - 模板制作规范
- 模板制作规范
-
1.CMS模板一定要放在templates和cmstemplates目录下。
2.CMS模板只支持shtml后缀(WAP和3G频道用wml和xhtml除外)。
3.CMS模板命名需要遵守文件命名规范。
4.CMS模板有碎片模板和查看新闻模板,命名时最好区分开。
5.CMS模板制作时模板变量要符合CMS内部规定的模板标签,具体的可以见CMS标签说明。
6. CMS预览模板文件开头增加了“cmsIn_”,故模板文件真实名称应该去掉开头“cmsIn_”。
7.CMS模板调用碎片时,本域名内的尽量用inc文件,少用js文件。
8.CMS调用或推广站点信息时,一律不允许调用或推广地址后加“?”。
9.CMS系统模板语法必须严格按W3C规范语法制作模板,否则会影响到服务端对客户端发送上来的页面内容的解析。
PS. 验证模板或者静态页面的语法是否规范,可通过W3C官方工具检验。http://validator.w3.org/
CMS规范 - 文件命名规范
- 文件命名规范
-
1. 首页文件统一用index.shtml
2. 模板文件统一用shtml格式文件(WAP和3G频道用wml和xhtml除外)
3. 文件名只能由字母、数字、下划线组成,CMS系统尽量只用小写的英文字,需要断开用英文下划线 “_ ”,而不是“ –” 或“-”,且文件名不能有空格。
4. 文件命名尽量使用英文缩写或英文名,无法翻译的再考虑用中文,命名尽量简而易解,尽量遵照语义化命名规范,看其名,知其途;也可以根据页面内容命名文件,如wallpaper.shtml,时效性较强的新闻、文章可采用时间数字组合命名,同一文件夹中应采用同一种命名方式。
5. 常用公用文件说明,如:
头部“header.shtml”;(也可以用“top.shtml”)
底部“footer.shtml”;(也可以用“bottom.shtml”)
左菜单“left_menu.shtml”;
右边菜单“right_menu.shtml”等,可在文件名前加前缀以示区别,比如 exam_ header.shtml。
公用文件采用include方式:"[an error occurred while processing this directive]"(相对根目录路径形式)等;6. JS文件命名, UE设计使用的JS文件统一加“ue”前缀,表明此js文件为UE出品,与程序输出的加以区别。
7. 测试文件,测试文件统一用“原文件名_test_日期”,或是统一放置测试文件夹“test”下;
测试文件命名:原文件名_test号码_日期.文件类型(js/css)
如:index.html的测试文件,index_test1_20100209.shtml,index_test2_20100209.shtml (同一天测试同一个文件)8. 备份文件,备份文件统一用“原文件名_ bak_日期”,或是统一放置备份文件夹“bak”下;
备份文件命名:原文件名_bak号码_日期.文件类型(js/css)
如:index.html的备份文件,index_bak1_20100209.shtml,index_bak2_20100209.shtml (同一天备份同一个文件)9. 临时文件,临时文件统一用“原文件名_ temp_日期”,临时文件一般比较少用到。
10. 图片命名,图片修改时用“图片名_日期_操作号”命名。如原图:ind_01.jpg,2008年6月22号对这张图片第一次修改命名为:ind_01_20080622_1.jpg,同一天第二次对这张图片修改命名为:ind_01_0622_2.jpg。
11.碎片的建立,碎片名称更需遵照语义命名,方便后期和其他人查看页面就了解碎片的用途, 也方便搜索。
注意:测试结束后需将测试文件、及临时文件删除,备份文件一时间段内也及时删除。
CMS规范 - 版本管理
- 版本管理
-
1. cms目录下都需要有一个版本文件夹。频道实现版本管理,文件、模板等按版本存放,便于识别新旧文件、方便后期维护。
2. 版本文件夹设置规则:年份+版本号,如目前的版本统一称为09v1版,若明年第一次改版,则命名为10v1,若明年第二次改版,则命名为10v2,以此类推。
CMS规范 - 实例说明
- 实例说明
-
下面列举“Y媒体”为例,Y媒体栏目命名规范
栏目名 目录名 类型 备注(创建模板时的文件命名规则) Yangzl测试 /test 栏目 1.shtml 002测试 /test 栏目 2.shtml 003测试 /test 栏目 3.shtml 004碎片专用 /templates/inc 栏目 inc.shtml 01首页 / 栏目 index.shtml 1_0资讯查看模版_*** /templates 查看模板 news_*****.shtml 1_1资讯查看模版_*** /templates 查看模板 news_*****.shtml 1_2资讯查看模版_*** /templates 查看模板 news_*****.shtml 1_3资讯查看模版_*** /templates 查看模板 news_*****.shtml 2_0图片查看模板 /templates 查看模板 photo_****.shtml 2_1图片查看模板 /templates 查看模板 photo_****.shtml 6通用模板页 /templates 查看模板 common_***.shtml 1.测试页的数量不固定,不够用可以新建,按数字顺序排好。 对一些测试栏目还可以加上特定的说明如,yangzl测试首页,就为“yangzl”测试专用,没有标注的默认都可以使用,有多人操作的时候需要注意下。
2.模版前面的数字按模版类型来区分。如资讯、图片、专题等。