标签cms建站教程

最好用的开源php内容管理系统Catfish(鲶鱼)CMS最好用的开源php博客建站系统Catfish(鲶鱼)Blog2019罗举翔著Catfish(鲶鱼)CMS&Catfish(鲶鱼)Blog2019/4/22Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册第四版Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版2Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册第四版Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版3目录前言5Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题文件结构_7主题的最简组成7主题文件代码的重用7使用单页主题8添加辅助文件8添加独立的手机端主题9为主题设置截图9制作404页面的主题10制作关闭网站的主题10制作sitemap主题_11文章形式相关主题文件11主题文件结构小结12Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题标签_13初识标签13标签语法14标签名15标签详解19catfish_19menu19hunhe_20tuwen_22catfishBlog23bozhu24fenleixiang25zuixinpinglun25zuire26reping_27zuixin28suiji_29fenlei30daohang_31neirong_32previous32next32pinglun_33Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版4tuijian_33page34links34imageLinks35allLinks35imageAllLinks_36smItem_36smArticle37为Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题设置自定义标签37自定义标签使用37自定义标签命名规范38如何定义新标签38组合标签和简易标签39组合标签39简易标签40标签使用实例40导航菜单41注册登录42Catfish(鲶鱼)CMS和Catfish(鲶鱼)Blog的区别_43关于插件43后记44Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版5前言感谢您使用《Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册(第四版)》,希望通过本手册能够帮助您更好地制作Catfish(鲶鱼)CMS和Catfish(鲶鱼)Blog的主题.
鲶鱼系统的主题制作有一个特点是灵活性相对比较高,同样的输出可能会有不同的标签写法,例如可以用原生标签,也可以用简易标签.
为了让您更全面地了解和使用鲶鱼系统的标签,第四版主题制作手册将尽量全面地介绍,并且在前面几版的基础上增加了几个新的标签,另外还额外增加了一篇"标签使用实例",为了比较完整地介绍,所以把第三版略去的"组合标签和简易标签"这部分内容也重新添加进去.
鲶鱼系产品是向后兼容的,您之前做的主题可以很健壮地运行在新的系统上而不会导致兼容问题,所以您不用担心之前的工作会付之东流.
很感谢有那么多朋友一直伴随着鲶鱼产品的成长,我也将砥砺前行,不断推陈出新,为大家奉献更好的系统,更方便的使用,更安全稳定的网站,让您创建的每一个站点都能够成为最优秀的,这是我一直追求和期望的,让我们携手共进,也欢迎有更多的新朋友加入.
您在使用和设计制作过程中如果有什么好的建议可以到官方网站(www.
catfish-cms.
com)留言,或者加入QQ群(181836340)留言,您的任何建议都将被合理考虑.
为什么会有两个系统这个问题在前面的版本有回答,在新版手册中还是想重复一下,以免有朋友会混淆.
这是由于Catfish(鲶鱼)CMS有很强大的适应性和扩展性,可以用来做博客站当然是Catfish(鲶鱼)CMS的其中某一个方面,并且实现也十分地方便.
但是如果您的网站只是定位在博客站的话,那么用Catfish(鲶鱼)Blog系统会更方便且更简单.
为了保证使用者习惯的延续性,Catfish(鲶鱼)CMS和Catfish(鲶鱼)Blog的后台操作界面和部分功能架构基本是一致的,所以您会发觉这两个系统后台长得很像.
对手册了解的朋友肯定知道Catfish(鲶鱼)Blog的很多标签是特有的,就是说这些标签是专门为Catfish(鲶鱼)Blog设计的,并不能用到Catfish(鲶鱼)CMS上面.
反过来,有部分标签只能用在Catfish(鲶鱼)CMS上,而不能用在Catfish(鲶鱼)Blog上.
这是主题制作的时候要特别注意的地方,以免出错.
主题制作容易吗Catfish(鲶鱼)CMS和Catfish(鲶鱼)Blog系统的主题制作是令人感到轻松和愉快的,因为整个制作过程只需要让前端设计人员集中精力于界面设计,而不需要考虑后台和前台的关系.
基本上您只需要放一个标签在HTML代码中就可以了,并不需要对标签进行任何处理,甚至于您可以不知道标签表示什么意思,只要机械地参照案例把标签放在该放的地方就可以了.
熟悉鲶鱼系统主题制作的朋友会发现,鲶鱼的标签除了循环标签之外基本就都是直接放置的标签,也不需要去考虑过多的细节,因为鲶鱼系的主题制作特色就是让最终的使用者来确定页面的内容和显示数量等方式,主题制作人员只需要处理网页的外观和排版就可以了.
这点跟其他系统的主题制作方式有根本性的区别,也往往是一些有类似工作经验的人感到不习惯的地方.
所以当您学习和制作鲶鱼系的主题时,请先忘掉您原来的工作经验,不要去直接考虑诸如输出分类、确定显示数量等问题,很简单地放上标签就可以了.
一旦您熟悉了这些,就可以让您的精力最大程度地解放出来,并专注于页面设计.
Catfish(鲶鱼)CMS和Catfish(鲶鱼)Blog系统的主题文件都是放在系统安装目录下的"public"文件夹下面.
您只要把制作好的主题文件夹放到"public"文件夹里面,然后进后台,找到"系统设置",然后在下面找到"主题",点击"主题"后就可以在右边页面看到您刚才放入的主题,要使用该主题的话,用鼠标点击对应主题下的"开启"按钮就可以了.
需要注意的是,Catfish(鲶鱼)Blog的主题文件夹名称必须以"cBlog"开头,建议您用这样形式命名:"cBlog-主题名".
Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版6Catfish(鲶鱼)CMS的主题制作是比较灵活的,您可以用简单的三个文件来组成一个主题,也可以将主题扩展到很多文件,所以在制作主题的过程中您可以根据实际的需要来进行制作.
这本手册需要付费吗这本手册是免费给您使用的,并且您也可以把他分发给需要该手册的人,当然您的分发也是要免费的,手册的目的是相互学习,有什么不对的地方您可以到官网留言.
当然,如果您愿意的话,也可以给官网一些捐助,以帮助系统能更好地发展,进而您也可以使用更好的Catfish(鲶鱼)CMS或者Catfish(鲶鱼)Blog系统.
捐助二维码:Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版7Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题文件结构主题的最简组成一个Catfish(鲶鱼)CMS或者Catfish(鲶鱼)Blog主题在最简单的情况下可以只包含三个文件,这三个文件分别是:"index.
html","category.
html",以及"article.
html".
这三个文件依次是"首页文件","分类列文件","文章显示页文件".
这是Catfish(鲶鱼)CMS或者Catfish(鲶鱼)Blog主题的基本组成文件,也就是说Catfish(鲶鱼)CMS或者Catfish(鲶鱼)Blog主题必须包含有这三个文件,而其他的n多文件都是扩展,您可以制作也可以不制作,不会影响Catfish(鲶鱼)CMS或者Catfish(鲶鱼)Blog系统的正常运行.
主题文件代码的重用在一个网页中一般情况下会包含页头和页脚,并且页头和页脚的代码有可能整个网站都是一样的.
如果我们在制作主题的过程中,只制作了上面说到的最简三文件的话,那么可以肯定的是每个文件都将包含有页头和页脚的重复代码.
为了避免我们重复写代码,就是为了我们能够偷点小懒,我们可以把相同代码的页头和页脚从最简三文件中分离出来,把他们分别放到页头文件"header.
html"和页脚文件"footer.
html"中.
这样我们就只需要写一遍重复的代码就可以了.
那么页头页脚代码分离出来后,怎么用到主题中呢我们需要在最简三文件中把页头和页脚文件的代码包含进来,这样系统才能正常地运行.
怎么包含进来我们需要在最简三文件的最开头写入以下代码:{includefile="public/default/header.
html"/}有了这行代码后,我们就把页头文件的代码包含进最简三文件了.
然后我们在最简三文件的最后写入以下代码:{includefile="public/default/footer.
html"/}有了这行代码后,我们又把页脚文件的代码包含进最简三文件了.
注意:记得把上面代码中红色部分换成您的主题名.
Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版8好了,现在我们的主题就可以正常运行了.
并且我们的主题文件从原来的三个文件变成了五个.
使用单页主题我们知道Catfish(鲶鱼)CMS以及Catfish(鲶鱼)Blog后台的"页面管理"下有个"新建页面",当您点击按钮开始新建页面的时候会发现有一个模板选项,这个是为单页面选择对应主题模板文件的,而这个模板文件是要我们在主题制作的时候放入主题文件夹中的.
怎么放我们可以在主题文件夹里面新建一个文件夹,我们把这个文件夹命名为"page",然后把制作好的模板文件放到这个"page"文件夹里面,这样我们在新建页面的时候就可以看到您放入"page"文件夹里的模板文件了.
到现在为止我们的主题又有了一个"page"文件夹成员,当然现在主题中有多少文件就很难说了,您可以在"page"文件夹中新建n多的模板文件,当然也可以只制作一个模板文件.
添加辅助文件做主题设计的朋友肯定会用到一些图片,JavaScript代码,样式代码.
我们当然可以把他们凌乱地放在主题中,但是为了整齐和方便起见,我们可以分别为他们建一个文件夹,然后把他们集中放在他们该放的文件夹中.
这样我们就又需要建三个文件夹,分别是:图片文件夹"images",JavaScript文件夹"js",样式代码文件夹"css".
到现在我们的主题中又多了三个文件夹成员,当您查看主题文件夹的时候就是这个样子了:这个是到现在为止我们给主题最简三文件进行扩展的结果.
当然,后面我们还将对他进行扩展,以实现更多的功能.
Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版9添加独立的手机端主题Catfish(鲶鱼)CMS以及Catfish(鲶鱼)Blog是全站自适应的,也就是说您可以在任何大小的屏幕上浏览您的网站,包括前台和后台,程序会根据您的浏览屏幕大小自动调整页面的显示.
但是如果您是自己设计主题使用的话,也需要将主题设计成自适应屏幕的,如果您对自适应设计还不能很好地把握,那么也没有关系,Catfish(鲶鱼)CMS以及Catfish(鲶鱼)Blog已经为您考虑周全了,您可以设计自己独立的手机端显示主题.
怎么实现手机端主题分离呢很简单,您只要照着前面所讲的主题制作方法照样制作一份手机端主题,然后在主题文件夹下新建一个文件夹"mobile",然后把制作好的手机端主题文件放到这个"mobile"文件夹中就可以了.
下面的图显示了增加手机端主题后的主题文件夹中所包含的文件和文件夹.
我们发现这个图的最下面有一个"screenshot.
jpg"文件,这个文件的作用将在后面介绍.
我们在"mobile"文件夹里面放入手机端的主题文件,就像下面这个图显示的那样:是不是跟前面讲过的主题中的文件结构一模一样,只是代码实现方式有所不同.
为主题设置截图前面我们发现了一个陌生的文件"screenshot.
jpg"在主题里,那么这个文件是起什么作Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版10用的呢这个文件是主题的截图文件,是一个JPG的图片文件,当您制作完主题后,可以为这个主题截个图,然后命名为"screenshot.
jpg",再把它放在主题文件夹下面.
这样做了以后,您在后台"系统设置"下设置"主题"的时候,您的主题会显示其截图.
制作404页面的主题当页面不存在的时候,Catfish(鲶鱼)CMS以及Catfish(鲶鱼)Blog会显示404页面,当然您也可以用自己设计的404页面来替换系统默认的404页面,具体实现方法就是在主题文件夹中放入您自己设计的404文件.
像下面这个图所示,主题文件夹中多了404文件.
制作关闭网站的主题当您的网站需要维护时,您可以关闭您的站点,这样当有人来访问您的网站时,将会显示站点已经关闭的页面.
当然您也可以用自己设计的主题文件来替换系统默认的关闭页面,实现方法和404页面一样,只要在主题文件夹中放入关闭页面文件就可以了,关闭页面文件命名为"close.
html".
像下面这个图所显示的:Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版11制作sitemap主题Catfish(鲶鱼)CMS以及Catfish(鲶鱼)Blog支持站点地图sitemap,当然sitemap主要是给搜索引擎看的,但是我们也可以设计自己美观的sitemap页面.
实现的方法和404页面一样,就是在主题文件夹下面制作一个命名为"sitemap.
html"的站点地图文件.
文章形式相关主题文件Catfish(鲶鱼)CMS以及Catfish(鲶鱼)Blog在写文章的时候可以为文章设置文章形式,默认情况下不同的文章形式都会调用默认的文章主题来显示,如果要达到不同文章形式有不同显示效果的话,需要对文章形式设计各自的主题,然后把这些主题文件放入主题文件夹下面.
下面这个图显示了设计了所有的文章形式主题后的主题文件结构.
Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版12文章形式和主题文件对应如下表:文章形式主题文件文章article.
html日志log.
html相册album.
html视频video.
html音频audio.
html链接link.
html通知notice.
html分页paging.
html文章形式的手机端独立主题设计也是一样的,在"mobile"文件夹下放入相同命名的主题文件就可以了.
主题文件结构小结到现在为止,我们知道设计一个Catfish(鲶鱼)CMS或者Catfish(鲶鱼)Blog主题既可以只设计最简三文件:Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版13也可以在最简三文件的基础上对Catfish(鲶鱼)CMS或者Catfish(鲶鱼)Blog主题进行扩展,通过前面的介绍我们已经可以将主题扩展到如下图所示的结构:您可以根据实际的需要来设计自己的主题.
Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题标签初识标签Catfish(鲶鱼)CMS以及Catfish(鲶鱼)Blog的主题制作是通过"html代码+主题标签"的Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版14形式来完成的.
主题标签以{和}作为开始和结束标识,例如:{$title}表示站点的名称;{$subtitle}表示站点的副标题;{$keyword}表示站点关键字;{$description}表示站点描述.
"$"后面是标签的名称,标签{$title}的名称就是"title".
类似地标签{$subtitle}的名称就是"subtitle".
标签语法知道了标签以后,我们还需要学习一点简单的标签语法.
主要的几个语法有:一、循环输出标签{volistname="标签名"id="vo"offset="0"length='6'key="k"}输出内容{/volist}说明:id的名称可以随意换,不一定是"vo",您也可以把"vo"改成"ov"之类的其他字符,id的作用是指代输出项的,比方说输出项里面有一个是标题的项,我们就可以用"vo.
biaoti"这样的形式来输出标题的内容;offset表示从哪里开始显示,比方说一共有10个输出项,当offset被设置为0时,就是从第一个开始输出,如果被设置成1的话就是从第二个开始输出;length表示显示几个输出的内容.
上例就表示从第一个输出内容开始,一共输出6个;key表示循环输出项的序号,这个名称也可以换,不一定是"k",您可以设置成"j"之类的.
特别要提一下的是,如果有多个循环输出标签嵌套的话,那么内外层的循环标签的id要有区别,比方说外层的id是"vo"的话,那么内层的id可以设置为"cvo".
循环标签的"name"和"id"是必须的,其他几个都可以省略,例如您可以像下面这样使用:{volistname="标签名"id="vo"}输出内容{/volist}二、判断标签是否存在,非空标签和空标签非空标签:{notemptyname="标签名"}如果标签不为空,则显示内容{/notempty}说明:如果标签内容不为空的话,那么显示标签之间的内容.
空标签{emptyname="标签名"}Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版15如果标签为空,则显示内容{/empty}说明:如果标签内容为空的话,那么显示标签之间的内容.
这里要提一下的是非空标签和空标签都可以进行else的判断,例如:{notemptyname="标签名"}如果标签不为空,则显示内容{else/}如果标签为空,则显示内容{/notempty}三、判断标签{ifcondition="$标签名eq1"}输出1{else/}输出2{/if}说明:表示标签等于1的话则输出1,否则输出2.
"eq"表示等于,"neq"表示不等于.
简单起见您也可以把"eq"写成"==",把"neq"写成"!
=",这种写法了解JavaScript的朋友一定熟悉,分别表示等于和不等于.
那么上面的判断标签就可以写成如下:{ifcondition="$标签名==1"}输出1{else/}输出2{/if}主题中应用到的标签语法主要就是以上三类,配合系统约定的标签名,就可以进行主题开发了.
标签名Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog的基础标签名如下表:标签名说明适用系统适用文件标签类型title站点的名称通用通用直接标签subtitle站点的副标题通用通用直接标签keyword站点关键字通用通用直接标签description站点描述通用通用直接标签ico站点小图标通用通用直接标签Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版16domain您站点的域名通用通用直接标签template当前使用的模板通用通用直接标签menu菜单通用通用组标签url地址通用通用组标签pageUrl当前页地址通用通用直接标签login登录用户通用通用直接标签notAllowLogin不允许登录通用通用直接标签yunxupinglun允许评论通用article.
html直接标签hunhe混合组CatfishCMS通用组标签tuwen图文组CatfishCMS通用组标签catfishBlog内容输出CatfishBlogindex.
html组标签bozhu博客主人CatfishBlog通用组标签fenleixiang分类项CatfishBlog通用组标签zuixinpinglun最新评论CatfishBlog通用组标签tuijianshu推荐文章的数量CatfishBlog通用直接标签fengmiantu封面图片,首页图片CatfishBlog通用直接标签fengmianzi封面图片上的文字颜色CatfishBlog通用直接标签beijingtu网站背景图片CatfishBlog通用直接标签zuire最热文章CatfishBlog通用组标签reping热评文章CatfishBlog通用组标签closeComment关闭评论通用article.
html直接标签closeSlide关闭幻灯片展示通用通用直接标签openMessage启动留言通用通用直接标签zuixin最新发布内容通用通用组标签suiji随机文章通用通用组标签daohang1面包屑导航位1通用通用直接标签daohang按路径输出的面包屑导航通用通用组标签sousuo显示搜索未找到通用category.
html直接标签fenlei分类内容通用category.
html组标签pages分页通用通用直接标签neirong文章内容通用article.
html组标签previous上一篇文章通用article.
html组标签next下一篇文章通用article.
html组标签pinglun评论通用article.
html组标签defaultAvatar默认头像通用通用直接标签tuijian推荐的内容通用通用组标签page单页内容通用page组标签links友情链接,首页输出首页链接,其他页面输出非首页链接通用通用组标签imageLinks输出图片友情链接,首页输出首页链接,其他页面输出非首页链接通用通用组标签Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版17allLinks输出所有友情链接通用通用组标签imageAllLinks输出所有的图片友情链接通用通用组标签copyright显示版权通用通用直接标签statistics统计代码通用通用直接标签record备案信息通用通用直接标签catfishSEO优化通用通用直接标签smItem站点地图中的单项输出通用sitemap.
html组标签smArticle站点地图中的文章输出通用sitemap.
html组标签isMobile用于判断是否手机端访问通用通用直接标签lang输出当前语言通用通用直接标签以上标签是基础标签,为了方便使用,标签名主要是以拼音为主.
适用系统为"通用"的表示Catfish(鲶鱼)CMS和Catfish(鲶鱼)Blog主题中都可以使用,否则只适用于对应主题.
适用文件为"通用"的表示这个标签可以使用在所有主题文件内,否则只能够用在标注的这个文件内为了更方便地制作主题,自CatfishCMS4.
7.
X版本以及CatfishBlog1.
2.
X版本开始系统支持了几个简易标签来替换原有标签的使用,当然原有标签还是可以正常使用的.
Catfish(鲶鱼)CMS和Catfish(鲶鱼)Blog的简易标签如下:标签名说明适用范围标签类型title_easy用于网站标题中的文章标题输出通用直接标签ico_easy输出网站ico图标通用直接标签logo_easy输出网站logo通用直接标签subtitle_easy输出网站副标题通用直接标签fengmiantu_easy首页封面图CatfishBlog直接标签fengmianzi_easy首页封面图上的文字颜色CatfishBlog直接标签beijingtu_easy网站背景图CatfishBlog直接标签简易标签的命名一般是在原来的标签后面加上"_easy",可以用来替换主题中原来的标签,达到简化主题制作的目的.
例如简易标签{$ico_easy}可以用来替代原来的"{notemptyname="ico"}{$ico}{else/}{$domain}public/common/images/favicon.
ico{/notempty}",可以看到由于使用原来的标签需要进行判断,所以代码会显得很长,现在只需要简单的一个标签就可以了.
为了进一步简化主题制作,自CatfishCMS4.
8.
X版本以及CatfishBlog2.
0.
X版本开始系统支持了几个辅助标签来使主题代码更加简单并清晰,当然原有标签还是可以正常使用的.
Catfish(鲶鱼)CMS和Catfish(鲶鱼)Blog的辅助标签如下:标签名说明适用范围标签类型menuAide菜单辅助标签bootstrap通用组标签loginAide登录辅助标签bootstrap通用组标签Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版18菜单辅助标签是为了简化主题制作中的菜单生成所实现的标签,做过主题的朋友一定知道主题中的菜单代码是相对复杂的,有一大段代码需要写,即使可以直接把系统自带案例中的代码直接复制过来,但是整个HTML代码看上去就比较复杂且令新手感到畏惧.
现在这一大段代码只需要用一个辅助标签替换就可以了,但是这里有一个前提是,您的主题是使用bootstrap来实现的,您就可以用{$menuAide.
menu1.
bootstrap}来表示导航菜单的所有代码,详细可以参考系统自带案例的header.
html文件中的实现.
另一个辅助标签是登录辅助标签,跟菜单辅助标签类似,是为了简化主题中登录代码所增设的标签,我们现在可以用{$loginAide.
bootstrap}表示原先一大段代码,当然这里的前提也是主题要使用bootstrap来实现,可以参考系统自带案例的header.
html文件中的实现.
有了基础标签,我们就可以制作Catfish(鲶鱼)CMS和Catfish(鲶鱼)Blog主题了,但为了使系统有更好的扩展性,我们还需要在主题中增加一些占位标签.
当然,占位标签不是主题中必须使用的标签,您完全可以不使用占位标签,只是损失了主题的扩展性.
Catfish(鲶鱼)CMS和Catfish(鲶鱼)Blog的占位标签如下表:标签名说明标签类型top页顶部独立标签bottom页底部独立标签home_top首页顶部独立标签home_bottom首页底部独立标签article_top文章顶部独立标签article_mid文章中间独立标签article_bottom文章底部独立标签comment_top评论顶部独立标签comment_mid评论中间独立标签comment_bottom评论底部独立标签page_top单页顶部独立标签page_mid单页中间独立标签page_bottom单页底部独立标签home_side_top_group首页边栏顶部组合标签home_side_bottom_group首页边栏底部组合标签category_top_group分类页顶部组合标签category_bottom_group分类页底部组合标签category_side_top_group分类边栏顶部组合标签category_side_bottom_group分类边栏底部组合标签article_side_top_group文章边栏顶部组合标签article_side_bottom_group文章边栏底部组合标签page_side_top_group单页边栏顶部组合标签page_side_bottom_group单页边栏底部组合标签占位标签的使用形式跟直接标签一样,只需要{$标签名}就可以了.
这里去掉了一些古老的标签,当然您如果愿意的话,也是可以继续沿用那些古老标签,可以到以前的手册中寻找,之所以说是古老的标签,是因为用这些标签会让主题代码显得更繁琐,并且不是太实用,因Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版19为完全可以用新的标签来替代他们的存在.
标签详解对于基础标签,又分为两种情况,一种是标签名加上开始和结束标识({$标签名})就可以直接使用;另一种标签不能这样直接使用,它还有子标签,使用的话是这样的格式:{$标签名.
子标签名},或者通过循环来输出内容.
我们把第一种可以直接使用的标签叫"直接标签",把第二种情况的标签叫"组标签",用来区分这两种不同的标签.
直接标签只要在标签名两边加上标签标识就可以直接使用,不需要展开来说明.
需要着重提一下的是直接标签"catfish".
catfishcatfish标签是一个直接标签,在主题文件中直接用"{$catfish}"就可以了,该标签是Catfish(鲶鱼)CMS和Catfish(鲶鱼)Blog系统中最重要的标签,每个主题必须要带的标签,没有这个标签会导致系统运行出现问题,同时这个标签又是一个SEO优化标签,也是一个功能标签,这个标签可以帮助您更好地运营网站.
这个标签一般放在"footer.
html"主题文件中,如果您的主题是最简三文件的话,就需要把这个标签放在"index.
html"主题文件中.
在Catfish(鲶鱼)CMS和Catfish(鲶鱼)Blog系统中,该标签只用作功能标签使用,而不会在前台页面显示内容.
所以您可以把这个标签随意放到"footer.
html"主题文件的任意地方.
下面对组标签的使用分别进行说明.
menumenu标签拥有子标签menu1,menu2,,一般情况下导航菜单是menu1,其他的菜单项如果后台没有设置的话,是不存在的.
所以当我们制作导航菜单时可以使用menu.
menu1,对menu1的循环输出:{volistname="menu.
menu1"id="vo"}输出内容{/volist}子标签说明href地址Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版20target点击后窗口打开方式icon图标label菜单项的文字描述children子菜单子标签的调用方法是"vo.
子标签".
如果您的主题是用bootstrap来实现的,那么建议您使用辅助标签{$menuAide.
menu1.
bootstrap}来替换,这样可以节省很多代码量.
urlurl标签用来输出url地址.
标签说明url.
href首页地址url.
search搜索页地址url.
register注册页地址url.
login登录页地址url.
userCenter用户中心地址url.
quit退出登录url.
articles文章列表地址url.
rssRss地址url.
sitemapSitemap地址hunhe混合标签hunhe用来输出Catfish(鲶鱼)CMS的混合内容,该标签不适用于Catfish(鲶鱼)Blog系统.
hunhe标签拥有子标签hunhe1,hunhe2,,hunhe6,hunhe.
hunhe1.
neirong是输出混合1下面的内容,其余类同.
其标签使用形如:{volistname="hunhe.
hunhe1.
neirong"id="vo"}循环输出内容{/volist}标签说明hunhe.
hunheX.
biaoti标题hunhe.
hunheX.
changdu输出个数hunhe.
hunheX.
neirong主内容hunhe.
hunhe1.
pages分页,这里只对混合1有效hunhe.
hunhe1.
fenlei对应分类的链接地址Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版21hunhe.
hunheX.
neirong的子标签说明biaoti标题guanjianzi关键字zhaiyao摘要fabushijian发布时间pinglunshu评论数量suolvetu缩略图地址yuedu阅读量zan赞数nicheng昵称touxiang头像地址href链接datu大图地址xiaotu小图地址date日期(组标签)guanjianzu关键字组(组标签)date的子标签说明nian年yue月ri日shi时fen分miao秒guanjianzu的子标签说明name关键字href链接其中hunhe.
hunheX的X表示数字1-6,例如hunhe.
hunhe1、hunhe.
hunhe2等.
date子标签的调用方法是:vo.
date.
nian,vo.
date.
yue,vo.
date.
ri,vo.
date.
shi,vo.
date.
fen,vo.
date.
miao这里的vo就是循环输出项的id,您如果设定了其他id,那么就换成您设定的那个即可.
关键字组的标签"guanjianzu"的输出方法是使用循环输出,例如:{volistname="vo.
guanjianzu"id="gvo"}{$gvo.
name}{$gvo.
href}{/volist}这个是一个嵌套在外层volist内的循环输出,其中的id要跟外层循环有区别,这里用gvo,您也可以使用其他的.
Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版22tuwen图文标签tuwen用来输出Catfish(鲶鱼)CMS的图文内容,该标签不适用于Catfish(鲶鱼)Blog系统.
tuwen标签拥有子标签tuwen1,tuwen2,tuwen3,tuwen.
tuwen1.
neirong是输出图文1下面的内容,其余类同.
其标签使用形如:{volistname="tuwen.
tuwen1.
neirong"id="vo"offset="0"length='6'}输出内容{/volist}标签说明tuwen.
tuwenX.
biaoti标题tuwen.
tuwenX.
changdu输出个数tuwen.
tuwenX.
neirong主内容tuwen.
tuwenX.
neirong的子标签说明biaoti标题guanjianzi关键字zhaiyao摘要fabushijian发布时间pinglunshu评论数量suolvetu缩略图地址yuedu阅读量zan赞数nicheng昵称touxiang头像地址href链接datu大图地址xiaotu小图地址date日期(组标签)guanjianzu关键字组(组标签)date的子标签说明nian年yue月ri日shi时fen分miao秒Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版23guanjianzu的子标签说明name关键字href链接其中tuwen.
tuwenX的X表示数字1-3,例如tuwen.
tuwen1、tuwen.
tuwen2、tuwen.
Tuwen3.
date子标签的调用方法是:vo.
date.
nian,vo.
date.
yue,vo.
date.
ri,vo.
date.
shi,vo.
date.
fen,vo.
date.
miao这里的vo就是循环输出项的id,您如果设定了其他id,那么就换成您设定的那个即可.
关键字组的标签"guanjianzu"的输出方法是使用循环输出,例如:{volistname="vo.
guanjianzu"id="gvo"}{$gvo.
name}{$gvo.
href}{/volist}这个是一个嵌套在外层volist内的循环输出,其中的id要跟外层循环有区别,这里用gvo,您也可以使用其他的.
catfishBlogcatfishBlog标签是用来输出Catfish(鲶鱼)Blog的内容的,该标签不适用于Catfish(鲶鱼)CMS系统.
其标签使用形如:{volistname="catfishBlog.
neirong"id="vo"}输出内容{/volist}标签说明catfishBlog.
changdu输出个数catfishBlog.
neirong主内容catfishBlog.
pages分页catfishBlog.
neirong的子标签说明biaoti标题guanjianzi关键字zhaiyao摘要fabushijian发布时间pinglunshu评论数量suolvetu缩略图地址yuedu阅读量zan赞数nicheng昵称Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版24touxiang头像地址href链接datu大图地址xiaotu小图地址date日期(组标签)guanjianzu关键字组(组标签)date的子标签说明nian年yue月ri日shi时fen分miao秒guanjianzu的子标签说明name关键字href链接date子标签的调用方法是:vo.
date.
nian,vo.
date.
yue,vo.
date.
ri,vo.
date.
shi,vo.
date.
fen,vo.
date.
miao这里的vo就是循环输出项的id,您如果设定了其他id,那么就换成您设定的那个即可.
关键字组的标签"guanjianzu"的输出方法是使用循环输出,例如:{volistname="vo.
guanjianzu"id="gvo"}{$gvo.
name}{$gvo.
href}{/volist}这个是一个嵌套在外层volist内的循环输出,其中的id要跟外层循环有区别,这里用gvo,您也可以使用其他的.
bozhu博客主人标签bozhu可以输出博客主人的相关信息.
可以通过"{$bozhu.
子标签}"的方式来输出对应内容.
该标签仅用于CatfishBlog.
子标签说明nicheng昵称email电子邮箱href个人网站touxiang头像xingbie性别shengri生日qianming个性签名qqQQCatfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版25weibo微博weixin微信facebook脸书twitter推特skypeskypexuexiao毕业学校shouji手机fenleixiang分类项标签fenleixiang可以输出一级分类项.
该标签仅用于CatfishBlog.
其标签使用形如:{volistname="fenleixiang"id="vo"}输出内容{/volist}子标签说明fenlei分类名href分类的链接地址zuixinpinglun最新评论标签zuixinpinglun可以输出对文章的最新评论内容.
该标签仅用于CatfishBlog.
其标签使用形如:{volistname="zuixinpinglun"id="vo"offset="0"}输出内容{/volist}子标签说明shijian时间neirong评论内容nicheng昵称href链接Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版26zuire最热门标签zuire可以输出访问量最大的文章内容.
该标签仅用于CatfishBlog.
其标签使用形如:{volistname="zuire"id="vo"offset="0"}输出内容{/volist}子标签说明biaoti标题guanjianzi关键字zhaiyao摘要fabushijian发布时间pinglunshu评论数量suolvetu缩略图地址yuedu阅读量zan赞数nicheng昵称touxiang头像地址href链接datu大图地址xiaotu小图地址date日期(组标签)guanjianzu关键字组(组标签)date的子标签说明nian年yue月ri日shi时fen分miao秒guanjianzu的子标签说明name关键字href链接date子标签的调用方法是:vo.
date.
nian,vo.
date.
yue,vo.
date.
ri,vo.
date.
shi,vo.
date.
fen,vo.
date.
miao这里的vo就是循环输出项的id,您如果设定了其他id,那么就换成您设定的那个即可.
关键字组的标签"guanjianzu"的输出方法是使用循环输出,例如:{volistname="vo.
guanjianzu"id="gvo"}Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版27{$gvo.
name}{$gvo.
href}{/volist}这个是一个嵌套在外层volist内的循环输出,其中的id要跟外层循环有区别,这里用gvo,您也可以使用其他的.
reping热评标签reping可以输出评论量最大的文章内容.
该标签仅用于CatfishBlog.
其标签使用形如:{volistname="reping"id="vo"offset="0"}输出内容{/volist}子标签说明biaoti标题guanjianzi关键字zhaiyao摘要fabushijian发布时间pinglunshu评论数量suolvetu缩略图地址yuedu阅读量zan赞数nicheng昵称touxiang头像地址href链接datu大图地址xiaotu小图地址date日期(组标签)guanjianzu关键字组(组标签)date的子标签说明nian年yue月ri日shi时fen分miao秒guanjianzu的子标签说明name关键字Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版28href链接date子标签的调用方法是:vo.
date.
nian,vo.
date.
yue,vo.
date.
ri,vo.
date.
shi,vo.
date.
fen,vo.
date.
miao这里的vo就是循环输出项的id,您如果设定了其他id,那么就换成您设定的那个即可.
关键字组的标签"guanjianzu"的输出方法是使用循环输出,例如:{volistname="vo.
guanjianzu"id="gvo"}{$gvo.
name}{$gvo.
href}{/volist}这个是一个嵌套在外层volist内的循环输出,其中的id要跟外层循环有区别,这里用gvo,您也可以使用其他的.
zuixin最新标签zuixin可以输出最新的文章信息.
其标签使用形如:{volistname="zuixin"id="vo"offset="0"}输出内容{/volist}子标签说明biaoti标题guanjianzi关键字zhaiyao摘要fabushijian发布时间pinglunshu评论数量suolvetu缩略图地址yuedu阅读量zan赞数nicheng昵称touxiang头像地址href链接datu大图地址xiaotu小图地址date日期(组标签)guanjianzu关键字组(组标签)date的子标签说明nian年yue月ri日Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版29shi时fen分miao秒guanjianzu的子标签说明name关键字href链接date子标签的调用方法是:vo.
date.
nian,vo.
date.
yue,vo.
date.
ri,vo.
date.
shi,vo.
date.
fen,vo.
date.
miao这里的vo就是循环输出项的id,您如果设定了其他id,那么就换成您设定的那个即可.
关键字组的标签"guanjianzu"的输出方法是使用循环输出,例如:{volistname="vo.
guanjianzu"id="gvo"}{$gvo.
name}{$gvo.
href}{/volist}这个是一个嵌套在外层volist内的循环输出,其中的id要跟外层循环有区别,这里用gvo,您也可以使用其他的.
suiji随机标签suiji可以随机输出文章信息.
其标签使用形如:{volistname="suiji"id="vo"offset="0"}输出内容{/volist}子标签说明biaoti标题guanjianzi关键字zhaiyao摘要fabushijian发布时间pinglunshu评论数量suolvetu缩略图地址yuedu阅读量zan赞数nicheng昵称touxiang头像地址href链接datu大图地址xiaotu小图地址date日期(组标签)Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版30guanjianzu关键字组(组标签)date的子标签说明nian年yue月ri日shi时fen分miao秒guanjianzu的子标签说明name关键字href链接date子标签的调用方法是:vo.
date.
nian,vo.
date.
yue,vo.
date.
ri,vo.
date.
shi,vo.
date.
fen,vo.
date.
miao这里的vo就是循环输出项的id,您如果设定了其他id,那么就换成您设定的那个即可.
关键字组的标签"guanjianzu"的输出方法是使用循环输出,例如:{volistname="vo.
guanjianzu"id="gvo"}{$gvo.
name}{$gvo.
href}{/volist}这个是一个嵌套在外层volist内的循环输出,其中的id要跟外层循环有区别,这里用gvo,您也可以使用其他的.
fenlei分类标签fenlei用于输出分类页面的内容.
其标签使用形如:{volistname="fenlei"id="vo"}输出内容{/volist}子标签说明biaoti标题guanjianzi关键字zhaiyao摘要fabushijian发布时间pinglunshu评论数量suolvetu缩略图地址yuedu阅读量zan赞数Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版31nicheng昵称touxiang头像地址href链接datu大图地址xiaotu小图地址date日期(组标签)guanjianzu关键字组(组标签)date的子标签说明nian年yue月ri日shi时fen分miao秒guanjianzu的子标签说明name关键字href链接date子标签的调用方法是:vo.
date.
nian,vo.
date.
yue,vo.
date.
ri,vo.
date.
shi,vo.
date.
fen,vo.
date.
miao这里的vo就是循环输出项的id,您如果设定了其他id,那么就换成您设定的那个即可.
关键字组的标签"guanjianzu"的输出方法是使用循环输出,例如:{volistname="vo.
guanjianzu"id="gvo"}{$gvo.
name}{$gvo.
href}{/volist}这个是一个嵌套在外层volist内的循环输出,其中的id要跟外层循环有区别,这里用gvo,您也可以使用其他的.
daohang导航标签daohang用于输出面包屑导航的路径.
其标签使用形如:{volistname="daohang"id="vo"}输出内容{/volist}子标签说明label名称icon图标Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版32href链接neirongneirong标签用来输出文章的相关内容.
可以通过"{$neirong.
子标签}"的方式来输出对应内容.
子标签说明biaoti标题laiyuan来源fabushijian发布时间nicheng作者昵称yuedu阅读量guanjianzi关键字zhengwen正文zhaiyao摘要suolvetu缩略图zan点赞数previousprevious标签是显示前一篇文章链接的.
可以通过"{$previous.
子标签}"的方式来输出对应内容.
子标签说明biaoti标题href链接nextnext标签是显示后一篇文章链接的.
可以通过"{$next.
子标签}"的方式来输出对应内容.
子标签说明biaoti标题href链接Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版33pinglunpinglun标签是用来输出评论内容的.
其标签使用形如:{volistname="pinglun"id="vo"}输出内容{/volist}子标签说明shijian时间neirong评论内容nicheng评论人昵称email评论人邮箱url评论人个人网址touxiang评论人头像地址qianming评论人签名tuijiantuijian标签是用来输出推荐内容的.
其标签使用形如:{volistname="tuijian"id="vo"offset="0"length='10'}输出内容{/volist}子标签说明biaoti标题guanjianzi关键字zhaiyao摘要fabushijian发布时间pinglunshu评论数量suolvetu缩略图地址yuedu阅读量zan赞数nicheng昵称touxiang头像地址href链接datu大图地址Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版34xiaotu小图地址date日期(组标签)guanjianzu关键字组(组标签)date的子标签说明nian年yue月ri日shi时fen分miao秒guanjianzu的子标签说明name关键字href链接date子标签的调用方法是:vo.
date.
nian,vo.
date.
yue,vo.
date.
ri,vo.
date.
shi,vo.
date.
fen,vo.
date.
miao这里的vo就是循环输出项的id,您如果设定了其他id,那么就换成您设定的那个即可.
关键字组的标签"guanjianzu"的输出方法是使用循环输出,例如:{volistname="vo.
guanjianzu"id="gvo"}{$gvo.
name}{$gvo.
href}{/volist}这个是一个嵌套在外层volist内的循环输出,其中的id要跟外层循环有区别,这里用gvo,您也可以使用其他的.
pagepage标签是在单页中输出内容.
可以通过"{$page.
子标签}"的方式来输出对应内容.
子标签说明biaoti标题zhengwen正文guanjianzi关键字zhaiyao摘要suolvetu缩略图linkslinks标签用于输出友情链接.
其标签使用形如:Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版35{volistname="links"id="vo"}输出内容{/volist}子标签说明link_url友链地址link_name友链名称link_image图片友链地址link_target点击后打开方式link_description链接描述imageLinksimageLinks标签用于输出图片友情链接.
其标签使用形如:{volistname="imageLinks"id="vo"}输出内容{/volist}子标签说明link_url友链地址link_name友链名称link_image图片友链地址link_target点击后打开方式allLinksallLinks标签用于输出所有的友情链接,包括首页以及非首页的友情链接.
其标签使用形如:{volistname="allLinks"id="vo"}输出内容{/volist}子标签说明link_url友链地址Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版36link_name友链名称link_image图片友链地址link_target点击后打开方式imageAllLinksimageAllLinks标签用于输出所有的图片友情链接,包括首页以及非首页的图片友情链接.
其标签使用形如:{volistname="imageAllLinks"id="vo"}输出内容{/volist}子标签说明link_url友链地址link_name友链名称link_image图片友链地址link_target点击后打开方式smItemsmItem标签用于输出站点地图中的单项内容,即对应于菜单项的内容.
其标签使用形如:{volistname="smItem"id="svo"}{volistname="svo"id="vo"}输出内容{/volist}{/volist}子标签说明biaoti标题href链接Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版37smArticlesmArticle标签用于输出站点地图中的文章内容,即对应于每篇文章的链接.
其标签使用形如:{volistname="smArticle"id="vo"}输出内容{/volist}子标签说明biaoti标题href链接为Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题设置自定义标签自CatfishCMS4.
7.
X版本以及CatfishBlog1.
2.
X版本开始,系统支持主题设计者自定义标签,也就是说主题设计者不仅可以使用系统设定的标签,而且还可以使用自己设定的标签并方便地使用到主题中.
当然这不是必须的,所以您也可以忽略这部分内容.
在介绍如何自定义标签之前,我们先来看一下,当一个自定义的标签被设定好后如何使用这个标签.
自定义标签使用假设我们现在自定义了一个标签,比如我把这个标签的名称设定为"biaoqian",当然标签的名称是由您自己设定的,但是需要符合一些命名规范,这个命名规范下面会介绍.
现在有了这个新的标签,那么我怎么在主题中来使用这个标签呢很简单,我们可以在主题中使用"{$z_标签名}"的形式来使用,其中的标签名就是您自己设定的标签名称,如前所述,就是"biaoqian".
那么我们就可以在主题中用"{$z_biaoqian}"这样的方式来使用我们自己设定的标签.
说得简单点就是在您设定的标签名称前面加上前缀"z_",然后您就可以直接使用了.
Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版38自定义标签命名规范接下来我们来了解一下命名标签的一些命名规范:1、标签名使用字母、数字、下划线组成;2、标签名由字母开始.
以上两点是建议的标签命名规范,为什么要如此建议命名标签,主要是因为这样命名标签不太会容易出错,并且代码看上去会比较明了,另外,这两条规范也很容易记忆.
如何定义新标签定义自己命名的标签是为了要在主题中使用,那么下面我们来看一下如何定义自己的标签.
自定义标签的格式是:标签名:标签内容;//注释其中的标签名就是您自己设定的标签名称,例如上面说到的"biaoqian",然后在标签名后面跟一个":"号,这个冒号要英文的半角符号,不能使用中文的全角冒号.
在冒号后面是将要显示到页面的内容,就是这个标签所代表的内容.
这个标签内容的最后需要用半角";"号结束,表示标签内容已经结束.
如果您需要对这个标签注解一些说明文字,那么可以在半角分号的后面跟上"//",接着写上注释的内容.
这里要注意的是,在标签内容里面除了网址里面带的"//"(例如"http://"里的"//"),需要将"//"写成"\/\/",也就是对"//"进行转义,否则将被当作注释处理.
而网址里面的"//"不需要进行转义.
标签命名的规则是一行命名一个标签.
需要命名第二个标签时,就必须另起一行开始命名.
例如:biaoqian1:标签1的内容;//标签1注释biaoqian2:标签2的内容;//标签2注释当然,这个注释是可以省略的,如下:biaoqian1:标签1的内容;biaoqian2:标签2的内容;我们把标签设计好了以后,接下去该怎么做呢接下来,我们需要把自定义的标签放到一个标签文件中.
并且把这个标签文件命名为"labels.
html",然后把这个标签文件放到主题文件夹下面.
例如假设您原来的主题文件夹下面的结构是这样的:Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版39然后我们在这个主题文件夹中放入标签文件,就变成下面这样了:"labels.
html"文件就是标签文件,标签文件里面放的就是一行行的标签代码.
标签代码中的标签内容可以是普通的文本或者HTML代码,但是如果标签内容是分成多行的话,那么中间的每一行结尾都不能以";"结束.
组合标签和简易标签自CatfishCMS4.
7.
X版本以及CatfishBlog1.
2.
X版本开始,系统支持组合标签和简易标签.
组合标签和简易标签是为了进一步降低主题制作难度而设计的,可以把原来需要很长一段标签代码来表示的内容用简单的一个标签实现.
当然,如果您在这之前已经根据原先的方法设计了主题,那么您还是可以继续使用原先设计的主题,也就是说标签是完全兼容的.
换一个说法就是,现在您不但可以按原来的方法制作主题,也可以选择更简单的方法来制作主题.
组合标签Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版40组合标签和简易标签在前面的表中已经有介绍了,这里不再重复,需要说明的是组合标签是占位标签的一种,用来替换原来复杂的占位标签,例如:原先需要用以下一大段代码实现分类页的侧边栏占位:{notemptyname="side_top"}{$side_top}{/notempty}{notemptyname="category_side_top"}{$category_side_top}{/notempty}{notemptyname="article_list_side_top"}{$article_list_side_top}{/notempty}{notemptyname="search_side_top"}{$search_side_top}{/notempty}现在只需要简单地像下面这样就可以了:{$category_side_top_group}是不是变得超级简单了,其他的占位标签可以参看随系统一起发布的主题,CatfishCMS中一个是blog主题,用于博客站,另一个是default主题,用于cms站,这两个主题的目的主要是给主题制作人员做参考的.
CatfishBlog中可以看cBlog-sample主题,这个主题也是主要给设计人员做参考用的.
这里要提一下的是,占位标签不是主题必须的,您制作主题完全可以不用占位标签,只是不用的话扩展性不会很强,但是不会影响主题的使用.
简易标签简易标签也是为了使主题设计变得简单而设计的,例如原来站点logo图片的链接地址要这么写:src="{ifcondition="$logoeq''"}{$domain}public/{$template}/images/catfish.
png{else/}{$logo}{/if}"现在只要简单地一个标签就可以了,如下:src="{$logo_easy}"是不是变得很简单了.
前面的简易标签表中已经列出了可以使用的所有简易标签,有部分是只能用在CatfishBlog中的,这点要注意一下.
标签使用实例由于鲶鱼的部分简易标签是用来替代原生标签复杂代码的,例如导航菜单的标签是相对来说在鲶鱼主题制作中最为复杂的,因为会涉及到子菜单的调用,所以代码量是比较大的,而在系统自带主题中,导航菜单使用的是简易标签来替代原生标签的写法,就像这样:{$menuAide.
menu1.
bootstrap},这一行代码其实是一大段原生代码的简写方法.
但是这里有一个限制,{$menuAide.
menu1.
bootstrap}这个简写代码是专门针对于使用前端框架bootstrap的,如果您并不使用这个前端框架的话,那么您还是必须要用原生的标签来写.
另一个事实Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版41是现在的前端框架很多,系统不可能把所有框架都带上,只能带上最流行最受欢迎的前端框架,例如bootstrap.
那么对于喜欢用一些其他框架,或者喜欢用纯的css来写主题的伙伴,可做的选择只能是使用原生标签,这里的标签使用实例主要就是把一些比较复杂并且系统自带主题中又没有体现出来的原生标签用法列举出来,以做参考.
导航菜单一般来说,导航菜单是网站必备的,而且也是相对来说最复杂的,因为会涉及到子菜单的循环输出,所以代码量会比较大,下面就是导航菜单的原生标签写法:{volistname="menu.
menu1"id="vo"}{emptyname="vo.
children"}{ifcondition="$vo.
iconneq''"}{$vo.
icon}{/if}{$vo.
label}{else/}{$vo.
label}{volistname="vo.
children"id="voc"}{$voc.
label}{/volist}{/empty}{/volist}上面的标签"{volistname="menu.
menu1"id="vo"}{/volist}"表示对菜单中的导航菜单进行循环输出,"{emptyname="vo.
children"}没有子菜单{else/}有子菜单{/empty}"表示对每个菜单项的输出,其中else前面的是菜单项没有二级菜单的情况下的输出,else后面的是菜单项包含二级菜单的情况下的输出.
对于菜单项的输出,这里作为示例是使用"li"标签输出的,请根据您的实际情况确定使用哪个HTML标签.
代码"{ifcondition="$pageUrleq$vo.
href"}class="active"{/if}"是用来判断是否当前页面的链接并设置成高亮显示,这个例子里面高亮显示用了active这个class,请根据您的实际情况使用.
Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版42注册登录Catfish(鲶鱼)CMS的注册登录代码示例:{emptyname="notAllowLogin"}注册登录{$login}用户中心退出{/empty}Catfish(鲶鱼)Blog的注册登录代码示例:{emptyname="notAllowLogin"}{emptyname="login"}注册登录{else/}{$login}  用户中心  退出{/empty}{/empty}上面两段注册登录的代码,两个系统是有所区别的,其中的HTML代码是基于bootstrap的,您可以根据实际情况进行修改,这里主要是用作标签示例,标签弄明白了,其中的HTML代码可以替换成实际使用的代码.
代码"{emptyname="notAllowLogin"}{/empty}"表示如果允许注册登录的话那么输出其中间的代码.
"{notemptyname="login"}hidden{/notempty}"表示如果用户已经登录了的话则不显示,"{emptyname="login"}hidden{/empty}"表示没有登录的话则不显示.
以上示例了导航菜单和登录注册代码的原生标签,这两类标签在使用非bootstrap前端Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版43框架的时候需要使用原生标签来写.
其他的标签用法请参考系统自带的几个主题,这几个自带主题代码比较规范,没有什么冗余的特效代码,容易识别和参考.
另外推荐大家阅读两本电子书《手把手教您制作Catfish(鲶鱼)CMS主题》和《手把手教您制作Catfish(鲶鱼)Blog主题》,这两本电子书虽然是初级读本,但是对于有一定基础的制作者也可以看一下,因为里面对标签的意思和用法有解释,对了解和理解鲶鱼标签有一定的意义.
Catfish(鲶鱼)CMS和Catfish(鲶鱼)Blog的区别虽然Catfish(鲶鱼)CMS也可以用来建博客站,但是后来发现博客站还可以有针对性地做得更好,使用更方便,系统更专业,所以Catfish(鲶鱼)Blog就诞生了.
虽然Catfish(鲶鱼)Blog是一款专门的博客建站程序,但是秉承了Catfish(鲶鱼)CMS的设计理念,并对博客用户进行了有针对性的设计,极大地方便了博主们的使用.
Catfish(鲶鱼)Blog和Catfish(鲶鱼)CMS主题制作的主要区别是什么Catfish(鲶鱼)Blog和Catfish(鲶鱼)CMS区别之一:Catfish(鲶鱼)Blog的主题文件夹名称必须以"cBlog"开头,这是为了不和Catfish(鲶鱼)CMS的主题文件相混淆,建议您用这样形式命名:"cBlog-主题名".
Catfish(鲶鱼)Blog和Catfish(鲶鱼)CMS区别之二:Catfish(鲶鱼)Blog中不再使用hunhe以及tuwen标签,而是用"catfishBlog"标签来输出博客文章.
这点在主题的制作中是需要注意的.
当然Catfish(鲶鱼)CMS的主题是不认catfishBlog标签的.
也就是说Catfish(鲶鱼)Blog和Catfish(鲶鱼)CMS的主题是不通用的.
Catfish(鲶鱼)Blog和Catfish(鲶鱼)CMS区别之三:Catfish(鲶鱼)Blog针对博客系统新增了一些专用标签,详细可以查看前面的标签表.
关于插件按理说插件不应该在主题制作手册中提及,但是从实际情况看,有部分主题设计者从主题设计的一开始就考虑插件功能在主题中的实现,把一件很简单的事情弄得很复杂,这是一种十分糟糕的设计,所以不得不在这里说一下.
虽然鲶鱼系统的扩展性十分强,很多主题的内容也可以用插件来完成.
但是如果您是一个主题设计者的话,那么请在主题制作的整个过程中,把插件这件事先忘掉.
因为主题制作跟插件制作本来就是两码事,主题是用于展示页面的,而插件是用于功能性的实现的.
这两个如果混在一起的话,也就是说如果用您制作的主题必须同时用您制作的插件的话,那么您所制作的主题没有通用性,也缺乏灵活性,更会给使用这个主题的人带来不易理解的困惑.
所以一个好的主题是仅仅只有主题,而没有捆绑在一起的插件.
这一点需要主题设计人员记住的.
Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册–第四版44后记感谢您阅读完《Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog主题制作手册(第四版)》,当您阅读这本手册的时候,鲶鱼CMS即将发布4.
9.
X版,鲶鱼Blog也即将发布2.
1.
X版,在未来的新版本中也将会有更精彩的内容呈现给大家,同时很开心和朋友们一起分享,共同进步,也十分感谢曾经给我提过建议的每一个人,虽然我并不知道他们的名字,或者建议并不可取,但在我心里一直很感谢!
对于所有的建议,不管是对的还是欠妥的,我都会合理考虑.
随着鲶鱼的标签体系的构建,有部分标签是用来替代某些原生标签的,而例如像:{$menuAide.
menu1.
bootstrap}这样的标签是必须配合bootstrap前端框架使用的,而有不少主题制作者可能并不使用bootstrap这个框架,所以还是必须用原生标签来写,为了让主题设计人员能够方便地使用原生标签,这版手册添加了标签使用实例.
Catfish(鲶鱼)CMS的自带主题有两个:一个是"default",用于Catfish(鲶鱼)CMS系统的CMS网站;另一个是"blog",用于Catfish(鲶鱼)CMS系统的Blog网站.
这两个自带主题的目的是让大家做参考的,为了方便阅读和参考,里面没有使用多语言的方式写代码,使用的是中文.
当您只是做中文网站时,类似"{:lang('Home')}"这样的代码,直接写成"首页"就行.
所谓自带主题就是随着系统发布一起发布的主题.
Catfish(鲶鱼)blog的自带主题有三个,分别是:"cBlog-default"、"cBlog-single"、"cBlog-sample".
其中的"cBlog-sample"主题主要也是给大家做参考的,同样没有使用多语言方式写代码,直接用的中文,方便查找和阅读.
另两个主题"cBlog-default"和"cBlog-single"可以直接在后台设置首页封面图和封面图上的文字颜色,还可以直接在后台修改网站的背景色,这些功能是专门为Blog系统做的,以方便个人站长使用,即使您使用的是同样的主题,也可以方便地做到和其他使用同样主题的网站不一样.
由于CMS系统跟Blog系统的应用区别,所以CMS系统中是没有类似的功能的.
Catfish(鲶鱼)CMS和Catfish(鲶鱼)blog自带主题一般都会用最新的方法来实现,使得HTML代码能够保持更清晰,这也是建议的做法,可以让HTML代码更加简洁、更加易读、更加容易理解.
也就是说,您以后在制作主题的过程中,可以尽可能少地去考虑标签怎么写,而把注意力主要放到页面设计中.
当然,如果您依然使用原生标签来写主题也是允许的,兼容性是有保障的,就是说您以前曾经制作的主题不需要随着版本提升而进行修改.
最后欢迎大家使用Catfish(鲶鱼)CMS或者Catfish(鲶鱼)blog系统,在使用和设计过程中有什么建议都欢迎大家到官网(www.
catfish-cms.
com)留言,或者加入QQ群(181836340)留言.
同时也祝愿大家能设计出优秀的主题.