从Nodejs脚本到vue首页看开源始末的DemoHouse

hailai

　　最近上Github看见了大漠的DemoHouse项目，看到Issues说准备做一个首页，于是我的第一想法就是做一个md列表页面，md文件可以很容易的生成一个html文件。刚刚做好脚本文件，可以生成list.md。随后提了pr。同时看到 @jerexyz 使用gulp构建工具做好了一个生成index.html的工具，我也就暂时放弃了继续后面的工作，还好没做，继续做的话生成出来的也比较粗糙，还得再继续美化修改。想象一下，如果这时我新收集了一个Demo，准备提交版本库，我是不是还得先执行一下命令 node index.js 然后再添加暂存区，提交版本库，推远程。如何省略执行命令行这一句呢？

git hook (钩子)　　说到钩子，不知道大家喜欢钓鱼吗？喜欢不喜欢应该都知道鱼钩，不知道的再看一下，鱼钩长这样的。
　　

　　
这是有一期我爱发明里面介绍的，一个钓鱼狂热爱好者发明的钓鱼神器，看节目似乎很有效。通常我们见到的鱼钩就只是上半部分，这里却多了一个小钩，其实他就是我们这里准备学习的hook。

　　为了达到某种效果，我们添加的一个脚本，在正常流程执行的时候触发这个脚本（个人拙略，如有偏颇忘指出）。

　　git的钩子存放在 .git/hooks 目录下，git init 时会自动生成一些示例脚本在该目录下，脚本都是 .simple 后缀结尾，如果需要使用的时候，重命名取消后缀即可。
　　这里是希望在存入版本库之前生成列表页，查询文档发现 pre_commit 是在 键入提交信息前运行 。

　　git add demo => pre_commit => git add list.md => git commit -m 'add new demo and update list.md'

　　pre_commit 是一个脚本文件，由于nodejs写好了一个脚本文件，于是添加了一个头部，然后最后添加生成的list.md到暂存区间

　　git add demo => git commit -m 'add new demo and update list.md'

　　实际上我们的操作流程就变成如上描述的样子。这个就是正常流程，git commit 命名回车后先执行的是 pre_commit 脚本，再存入版本库
　　自动生成list.md的工作到这里就完成了，更多的钩子文件这里暂时不继续扩展了。
　　
又看到还有一个需求就是为每个demo添加一些其他信息，例如：分类/作者等信息。这样 @jerexyz 的项目工具怎么修改实现一下呢，或者说其他方案怎么实现呢？

方案讨论　　参考 @jerexyz 的想法与 大漠 的思路，如果要配置多项信息我想就是在每个demo下配置一个config.json文件靠谱一些。
　　
或者像 @jerexyz 提出的直接title添加分类，方法也行，这样存在修改index.html文件，还有就是配置信息多或者后期再增加修改就没有配置文件方便直观。如果在原来的工具的基础上修改的话就需要生成几个也买你，把分类数据统计出来，然后再为每个分类数据生成一次页面，最后相互调用。是不是有一种其他的方法来处理呢？恰巧最近又在学习vue，于是就准备尝试一下。一个单页就可以搞定，不需要每次更新前端页面，只需要更新后端数据文件db.json即可。

vue　　在vue还是版本号1打头的时候看过文档，没有实际做过demo，后面自然而然还是只能对着文档编码。
　　
一开始我是直接script编译好的vue.js文件，然后实例化vue。也就是这样子的
　　

    # index.html 中这样引入vue　　<script type=&quot;text/javascript&quot; src=&quot;vue.min.js&quot;></script>
　　

　　# scirpt 标签中这样实例化，纯纯的文档风
　　var vm = new Vue({
　　el: '#id',
　　data: {
　　message: '阿弥陀佛'
　　}
　　})
　　

　　这样子没毛病，没有任何问题。但是对于招牌需求这个构建工具那个构建工具，还是要摸索学习学习。于是又决定尝试一下也只是停留在文档风的webpack。选择它也是有原因的，因为我重视基础也更风啊，哈哈哈～
　　

前期准备工作

　　这里是写在vue2.0.0的RC版本

• 　　创建项目目录（这里其实也跟风的玩了一下yarn，但是并没太多感受理解它的优秀，不做描述）
  npm i vue-cli -g　　
  vue init webpack demo
  　　
  cd demo
  　　
  npm i
  　　
  npm run dev
  　　自动启动浏览器打开 http://localhost:8080 页面，展示一个vue的初始模板页面
  
  
• 　　列表页组件
  　　
  不会从头到尾手写，还不会修改吗？由于暂时需要实现的就是一个列表，想到的就是 `v-for=&quot;demo in demos&quot;
  　　
  
  # 入口文件main.js中引入了app.vue组件　　
  
  　　
  # app.vue组件中包含了这里我们需要修改的list.vue
  　　
  
  　　
  # list.vue
  　　
  /**
  　　* 组件的三个部分（html+js+css），如果描述感觉vue就简单了好多
  　　* template（html或者是自定义标签）
  　　* script （js）
  　　* style （css）
  　　*/
  　　
  <template>
  　　<ol>
  　　<li v-for=&quot;demo in demos&quot;> {{ demo.title }} </li>
  　　</ol>
  　　
  </template>
  　　
  
  　　
  <script>
  　　export default {
  　　name: 'list',
  　　data: function() {
  　　return {
  　　{
  　　title: 'title1'
  　　},
  　　{
  　　title: 'title2'
  　　}
  　　}
  　　}
  　　}
  　　
  </script>
  　　
  
  　　
  <style>
  　　ol { /**/ }
  　　ol li { /**/ }
  　　
  </style>
  　　
  
  　　需要注意的一点是这里的data是一个函数，组件内的data都是函数的形式，至于为什么还没去理解，先学会第一步如何使用。其实你写成了对象形式，在开发者工具会输出提示。
  
  
• 　　导入数据
  　　
  准备了一个数据文件db.js，修改之前生成列表的工具，把每个demo下的配置文件读取出来追加到db.js中。
  
  

　　

    # 以下代码位于template中
　　<div>　　# li标签需要修改一下，如果newDemos存在，按照newDemos的分类数据输出
　　<li v-for=&quot;demo in (newDemos || demos}}&quot;> {{ demo.title }} </li>
　　

　　# 以下代码位于script中
　　# 导入db.js
　　import demos from './db'
　　

　　data: function() {
　　return {
　　demos: demos,
　　newDemos: ''
　　}
　　}
　　

　　# 如果要分类显示呢
　　# 添加一个方法
　　methods: {
　　getCategoryDemos: function(e) {
　　var newDemos = [];
　　this.demos.forEach(function(demo) {
　　if(demo.category === e.target.dataset.category) {
　　newDemos.push(demo);
　　}
　　})
　　this.newDemos = newDemos;
　　}
　　}
　　

• 显示全部　　
  上面取巧式的把分类数据实现了，如果要显示全部呢？即回到首页。把newDemos的值设为空不就好了吗？数据绑定的好处就是这里吧，监控数据的变化重新渲染。
  
  

　　

    # 添加template
　　<div>　　

　　# 添加method
　　showAll: function() {
　　this.newDemos = '';
　　}
　　

• 　　预览demo
  　　
  预览demo即在列表页面添加iframe标签引入demo静态页面。默认是不显示的，如果添加了一个判断语句 v-if
  　　
  
  # template add iframe　　
  <iframe src=&quot;{{ demo.url }}&quot; scrolling=&quot;no&quot; v-if=&quot;isShow&quot;></iframe>
  　　
  
  　　
  # script
  　　
  # data中添加isShow
  　　
  data: function() {
  　　return {
  　　// 新增
  　　isShow: false
  　　}
  　　
  }
  　　
  
  　　
  # method中添加showAll
  　　
  method: {
  　　// 新增
  　　showAll: function() {
  　　this.isShow = true;
  　　}
  　　
  }
  
  

其它问题总结

• iframe https　　
  github page是https协议，iframe的资源可能是http，也可能是https。对于不确定的情况下，我们不表明具体的协议，使用 // 。（不扩展讨论其它问题）
  
  
  
  
  • URI 是https协议，iframe src是http协议　　
    Mixed Content: The page at 'https://domain.dev' was loaded over HTTPS, but requested an insecure stylesheet 'http://domain.dev'. This request has been blocked; the content must be served over HTTPS.
    　　
    
    
    
  • URI 是http协议，iframe src是https协议　　
    均正常加载访问，iframe请求地址是https协议。
    
    
  • URI 是https协议，iframe src是https协议
    
  • URI 是http协议，iframe src是http协议
    
  
  
• 开源协议与开源精神　　
  截止昨晚22点左右，几位国外的开发者在 漠大 的repo下开了issue，讨论关于项目是否不应该存在，或者说是不是不应该拷贝其它平台（codepen，Codrops …）上的内容在github备份一份。
  
  
  
  
  • 　　观点一 原创
    　　
    国外：重视原创。对于原创的作品的保护或者尊重，我们是不是不应该在其它位置备份别人的作品，而没有署名源作者的版权信息（其实这一步是准备做，或者说是还没来得及做，但是考虑到的）。只是没想到国外的开发者对于原创的重视，还有在Twitter上发推讨论，虽然也就那么几个人在讨论，但其中不乏也有Codrops的开发者。
    　　
    国内：太多的技术类型的网站，除了作者自己主动分发。更多的还是爬虫抓取，最后抹去源作者的信息，也不注明来源出处。最后不得不说让源作者的原创不能得到很好的保护，还造成了很多垃圾水文的存在。
    
    
  • 　　观点二 加源保持最新
    　　
    很多作者会一直更新自己的项目，但是我们通常只是拷贝了一份最初的版本，如果有升级更新，通常我们都不能使用到最新的内容。还会觉得怎么参考的文章有错误，其实不然，是被抓取出来的没有及时更新。
    
    
  • 　　观点三 网络问题
    　　
    国外开发者也知道中国的问题，其实这是让我觉得有些可悲的，网络始终是病。当问及codepen是否能访问的时候，我说的不能，因为这个网络不稳定，常常是不能直接访问的，所以我们常常收藏一些好的例子，以备不时之需，但最后却始终是觉得国外的做的好。国内的好作品怎么搜集起来，怎么让他能够在trending上持续排第一，得到不止国内开发者的肯定。
    
    
  
  

　　虽然我也只是一个渣渣，但是我也有梦想，希望可以更多的提升自己，参与开源，对于原创的保护以及鼓励希望更多的人能够重视并自律参与，对于源进行物质的鼓励或者说行为上允许后再进行转载。这路应该还很长…