正在查看: 标记有标签 stblog 的文章(第 1 页 / 共 3 篇)

在Stblog中定制你的代码高亮功能

首先感谢目前正在使用stblog的朋友,正是你们的使用和批评才有了我不断改进->思考->改进的动力。当前版本还有诸多BUG和不完善的地方,我会在最近发布一个新的patch修正和完善这些功能。希望大家多提建议,感谢大家!

国内玩博客的人大部分都是Geek,他们的特点大多是:个性,最求完美,而且或多或少懂些编程的知识。这就是为什么我在开发stblog的第一个版本就引入了代码高亮功能。

stblog的代码高亮采用JavaScript渲染工具SyntaxHighlighter,使用和Hack方法也与其一致。

具体来说,要在stblog中定制和高亮你所需的代码,仅需要在模板中添加和删除对应高亮语法JS文件即可。

比如,朋友 rockics提到,当他在后台编辑器中添加C++代码时出现如下弹窗错误:

“can't find brush for :cpp”

这是因为没有引入Cpp的高亮语法,解决方法很简单。

用支持代码编辑的文本编辑器(请勿使用windows自带的记事本)打开模板文件:

./themes/default/footer.php

找到如下代码并修改:

<script type="text/javascript" src="<?php echo base_url(). ST_PLUGINS_DIR;?>/editor/syntaxhighlighter/scripts/shCore.js"></script>
 <script type="text/javascript" src="<?php echo base_url(). ST_PLUGINS_DIR;?>/editor/syntaxhighlighter/scripts/shBrushPhp.js"></script>
 <script type="text/javascript" src="<?php echo base_url(). ST_PLUGINS_DIR;?>/editor/syntaxhighlighter/scripts/shBrushXml.js"></script>
 <script type="text/javascript" src="<?php echo base_url(). ST_PLUGINS_DIR;?>/editor/syntaxhighlighter/scripts/shBrushCSharp.js"></script>
 <script type="text/javascript" src="<?php echo base_url(). ST_PLUGINS_DIR;?>/editor/syntaxhighlighter/scripts/shBrushCss.js"></script>
 <script type="text/javascript" src="<?php echo base_url(). ST_PLUGINS_DIR;?>/editor/syntaxhighlighter/scripts/shBrushJava.js"></script>
 <script type="text/javascript" src="<?php echo base_url(). ST_PLUGINS_DIR;?>/editor/syntaxhighlighter/scripts/shBrushJScript.js"></script>
 <script type="text/javascript" src="<?php echo base_url(). ST_PLUGINS_DIR;?>/editor/syntaxhighlighter/scripts/shBrushSql.js"></script>
 <script type="text/javascript" src="<?php echo base_url(). ST_PLUGINS_DIR;?>/editor/syntaxhighlighter/scripts/shBrushBash.js"></script>
 <script type="text/javascript" src="<?php echo base_url(). ST_PLUGINS_DIR;?>/editor/syntaxhighlighter/scripts/shBrushPython.js"></script>
 <script type="text/javascript">
  SyntaxHighlighter.config.clipboardSwf = '<?php echo base_url(). ST_PLUGINS_DIR;?>/editor/syntaxhighlighter/scripts/clipboard.swf';
  SyntaxHighlighter.all();
 </script>

加入你需要的高亮语法JS文件,比如这里是C++的,那么加入:

<script type="text/javascript" src="<?php echo base_url(). ST_PLUGINS_DIR;?>/editor/syntaxhighlighter/scripts/shBrushCpp.js"></script>

请注意以上shBrushCpp.js,这里是我们要引入的Cpp高亮语法JS文件。对应SyntaxHighlighter所支持的语法,请详见./st_plugins/editor/syntaxhighlighter/scripts目录参考SyntaxHighilighter的说明

修改完成后,请上传至服务器并覆盖掉原文件。

Update:本来修改模板文件可以在后台进行,不过现在发现在后台修改模板会将部分代码转义,从而使模板功能失效。这里证实是一个BUG(下一个小版本中修正),请手动修改并上传服务器。

Hello, Stblog

时间过的真快,来墨尔本已经一年多了,而距离我写的上一篇日志也有半年多了。这段时间感悟很多,有一堆东西想写下来,不过还是手懒了。

目前你所看到的这段文字,来自我和CI中国其他几位成员目前正在开发的基于Codeigniter (PHP MVC框架)开发的一套博客程序——Stblog,目前的最新版为 v0.1.2。写这套程序的原因,我写在了这里,就不转载过来了。

正在学习PHP和Codeigniter的朋友,我推荐你们下载和试用这套程序,但目前暂不推荐使用在真实的环境当中,因为它有诸多地方需要完善。待程序和相关文档成熟之后,在使用也不迟。

Stblog开发相关动态:

项目主页:http://code.google.com/p/stblog/

程序下载:http://code.google.com/p/stblog/downloads/list

Bug提交:http://code.google.com/p/stblog/issues/list

安装方法/插件/主题开发教程:http://code.google.com/p/stblog/w/list

注意:STBlog的协作开发和版本控制工具为Git (没有使用SVN),目前被托管在Github.com。请移步 http://github.com/stblog/Stblog  了解最新开发动态,以及checkout最新开发版本。

PHP中插件机制的一种实现方案

这篇文章的出发点是我对插件机制的理解,及其在PHP中的实现。这套插件机制已经在你目前看到的这个博客程序中的重构代码中实现(我定名为STBlog),由于尚未开发完毕,所以目前暂不开发源代码。但文章会涉及到核心思想和部分实现代码。

插件,亦即Plug-in,是指一类特定的功能模块(通常由第三方开发者实现),它的特点是:当你需要它的时候激活它,不需要它的时候禁用/删除它;且无论是激活还是禁用都不影响系统核心模块的运行,也就是说插件是一种非侵入式的模块化设计,实现了核心程序与插件程序的松散耦合。一个典型的例子就是Wordpress中众多的第三方插件,比如Akimet插件用于对用户的评论进行Spam过滤。

一个健壮的插件机制,我认为必须具备以下特点:

  • 插件的动态监听和加载(Lookup)
  • 插件的动态触发
  • 以上两点的实现均不影响核心程序的运行

要在程序中实现插件,我们首先应该想到的就是定义不同的钩子(Hooks);“钩子”是一个很形象的逻辑概念,你可以认为它是系统预留的插件触发条件。它的逻辑原理如下:当系统执行到某个钩子时,会判断这个钩子的条件是否满足;如果满足,会转而先去调用钩子所制定的功能,然后返回继续执行余下的程序;如果不满足,跳过即可。这有点像汇编中的“中断保护”逻辑。

某些钩子可能是系统事先就设计好的,比如之前我举的关于评论Spam过滤的钩子,通常它已经由核心系统开发人员设计进了评论的处理逻辑中;另外一类钩子则可能是由用户自行定制的(由第三方开发人员制定),通常存在于表现层,比如一个普通的PHP表单显示页面中。

可能你感觉上面的话比较无聊,让人昏昏欲睡;但是要看懂下面我写的代码,理解以上的原理是必不可少的。

下面进行PHP中插件机制的核心实现,整个机制核心分为三大块:

  • 一个插件经理类:这是核心之核心。它是一个应用程序全局Global对象。它主要有三个职责:
    • 负责监听已经注册了的所有插件,并实例化这些插件对象。
    • 负责注册所有插件。
    • 当钩子条件满足时,触发对应的对象方法。
  • 插件的功能实现:这大多由第三方开发人员完成,但需要遵循一定的规则,这个规则是插件机制所规定的,因插件机制的不同而不同,下面的显示代码你会看到这个规则。
  • 插件的触发:也就是钩子的触发条件。具体来说这是一小段代码,放置在你需要插件实现的地方,用于触发这个钩子。

原理讲了一大堆,下面看看我的实现方案:

»阅读全文

Tags: php,stblog,插件