路过秋天

同样的3年,有的人从学生到当了MVP了,而我却在原地,卖弄当年的代码,秋天的风,有点凄,有点凉!

公告信息
内涵是很强大的~~~别看外表~~~当犀利哥入侵不了的时候,感觉有种莫名的失落~~~
文章档案
最新评论

如何在CodeProject站点里写文章

今天打算在CodeProject上发表一下秋色园CYQ.Data数据框架的文章,可登陆上半天,硬是找不到在哪里发文章,郁闷的很纠结,于是上网搜了一下,免强搜到一篇,于是记录下来如下内容:

1. 首先得注册一个帐号,并登录

2. 网页的右上部分有一个 "Articles"的菜单, 鼠标hover上去之后会弹出一个子菜单, 选择"Submit an article", 会打开一个页面, 页面的标题下面, 有一行文字:
Submit article 

Submit your articles directly using the Article Submission Wizard. Please make sure you read the guidelines below.



点击那个链接会打开一个向导可上传文章。

上传文章还有一个办法是发一封mail给某个固定邮箱,不过这个办法,不用。

3. 点击上面的链接之前, 得先做足功课, 写好文章, 做好screen shot及展示图片, 把相关的代码和演示项目打包成 zip文件, 保证在300K 之内, 压缩用最大压缩比, 保证没有.obj, .suo, .user等不必要的文件. 因为在这个地方绕过弯路, 给自己提个醒:

所有要准备的文件分三类:

  • HTML 文件
这个是你要写的文件, 是你要发的贴子的主体, 图片和源代码下载都通过链接在里面体现, 另外就是用文字介绍你的idea了. 最好的做法是从 codeproject上下载一个 template.zip的东东, 直接修改它里面提供的模板文件.


注意这个文件却不是你要上传的, 而是接下来贴在一个编辑器里的.
  • 图片
这个不要压缩, 我的最爱是用PNG格式, 无损压缩, 对于电脑生成的图片有很好的压缩比. 多个文件也不必要根据其意义命名, 我的做法是按你的文章的"Base name"后面加1, 2, 这样命名, 比如
EasyHelp1.PNG
EasyHelp2.PNG

  • 源代码.
典型的做法是两种源代码, 一种是你要 show 的代码, 因为它很可能是个独立的组件, 编译成单独的dll, 所以还需要有一个 demo 的代码, 是你自己写的一个小程序, 演示如何用你的组件. 最好最好在你的 demo 里面包含可直接运行的程序, 根据我自己的经验, 往往想取最省事的, 在codeproject上找现成方案时, 第一优先看 screen shot, 尤其是UI方面的, 看效果是不是够炫够亮. 感兴趣了才下载代码, 下载完代码往往不想打开重编译, 因为很可能电脑上已经开着一个工作用的 solution了, 不想打开两个IDE, 也不想把工作中的 solution关掉再打开, 所以最贴心的做法是提供可直接运行的 exe, 当然要保证这个exe所 reference的DLL都在场. 别干砸场子的事.

4. 运行上面的wizard.


4.1 第一步

 

其中那个 BaseName, 最好起名成一个单词, 因为它将作为内部的目录名, 起成规规矩矩的名字, 少生事. 下面的东西顾名思义, 不用解释, 但是, 确定了 Section和 SubSection之后, codeproject也就在内部唯一确定了你的这篇文章, 它先用 Section分类, 再用 SubSection分子类, 最后是你的 BaseName, 一旦你在提交的半中间失败了, 我就是碰见了这种情况, 那个 BaseName还是被它录到了系统里, 你重新再来时就甭想再用这个名字了, 所以最好是做好准备工作, 一气呵成.



4.2 上传文件.

这里面加入你的 .zip文件, 图片文件, 一共提供了10个edit box供你放入文件名. 足够用了.



4.3 编辑文章
很恶心的一个页面.



它最上面是显示3个你上传成功的文件. 这没什么说的, 右边提供了快捷方法让你直接在文章编辑框中引用这三个文件.

问题就出在下面的文章编辑框中, 最右边的那个 [<>] 按钮, 点击了之后是切换HTML代码和正常的文字视图. 刚进这个页面时, 你上传的图片文件会有一个成功显示, 注意, 如果上传了两个图片文件, 只有一个(往往是第一个)成功显示, 不知道为什么, 而此时什么都不做, 切换[<>]到HTML代码, 看到那个能成功显示的图片, 它的URL是这样指定的:
http://www.codeproject.com/misc/XXX/EasyHelp/EashHelp1.PNG



也就是说, 是个完整的URL, 而代码 zip文件和其它的图片的URL则仅仅是下面的形式:

EasyHelp/EashHelp_Demo.zip
EashHelp/EashHelp2.PNG



是的, 不一致, 但看起来那个完整版的是正确的, 毕竟它能正确显示(注意关于代码能否下载此时无法验证), 但是, 一旦你手工把HTM代码中的URL自作聪明地改成它这个样子, 你提交后的文章就挂了, 里面的代码也不能下载, 图片也不能正确显示.

问题在于, 真正的 EashHelp/EasyHelp2.PNG 这样的短的URL形式反而是正确的. 因为这是提交之后能直接被引用到的位置, 但是在编辑时你却不能看到它. 所见非所得, 所不见反而或能有所得.


关于那个HTML代码编辑框, 它里面预先给你塞了一堆模板的东西, 直接在网页里面编辑大块的文字很危险, 一个<C-W>你就全部玩完, 我从不敢这么干, 我是把自己写好的HTML, 把其源代码贴过来, 保证里面的URL是"正确"的, 尽管在这个视图中是看不到东西的. 然后预览一下, 提交文章.

如果提交文章之后发现图片或代码不正确, 还有返工的机会.

还有一个误导人的地方:

那个"Broken Article" 的链接, 是给你的读者用的, 如果你的读者发现文章链接不存在, 或代码下载不了, 他报错给codeproject 网站用的, 而下面的 Modify, 才是给作为作者的你用的, 因为CU中的图片不能过长, 上面的上下两部分其实在codeproject上是同一水平位置的, 很容易混淆.


 

秋色园是QBlog的官方站点,由路过秋天创建,基于cyqdata数据层框架开发的支持多用户、多语言、多数据库(access,mssql,oracle)、目录级url等功能强大的博客系统
新浪微博粉丝精灵,刷粉丝、刷评论、刷转发、企业商家微博营销必备工具"

2011/1/25 18:42:42 | 开发测试及演示 | |

  • 发表评论