• 写技术博客的一些心得分享


    写技术博客的一些心得分享

    作者: Grey

    原文地址:

    博客园:写技术博客的一些心得分享

    CSDN:写技术博客的一些心得分享

    写博客有很多好处,见[BetterExplained]为什么你应该(从现在开始就)写博客

    最初写博客用的是 Word,平台是博客园,Word 可以通过这种方式将文章一键发布到博客园。

    后来学会了 markdown,写 markdown 的工具有很多,比如:typoraStackEditVisual Studio Code等,对我来说,都差不多,但是Visual Studio Code有一款插件可以自动格式化 markdown 的插件----markdownlint,非常好用,Visual Studio Code就成为我主力写博客的工具了,同时,也把 CSDN 作为自己的一个主力博客平台,和博客园同步更新。不过,这里还是想吐槽一个 CSDN 的博客编辑器的问题

    原先是 Word 文档,其实迁移不太方便,因为很多平台不支持 Word 的直接导入和复制粘贴,用了 markdown ,博客迁移的成本就低了很多,比如有段时间心血来潮,我在自己的服务器上折腾搭建了一个博客,要把原先博客平台的博客迁移过去,因为是 markdown 格式,自建博客可以直接渲染显示出来。

    PS:自建博客的评论和留言都比较麻烦,需要绑定第三方的账户,所以用过一段时间就放弃了。

    选择图床

    使用 markdown 写博客主要的问题是要选择一个稳定的图床。

    我采用的是把图片复制到 CSDN 或者博客园,这样会生成一个图片链接,直接采用这个链接作为图片链接即可,这样生成的图片链接也比较稳定。

    操作方式如下

    CSDN生成图片链接方式

    csdn-image

    博客园生成图片链接方式

    cnblogs-image

    备份博客

    原先备份的方式是直接存在 OneDrive 中,目录按照博客分类建好。无论在公司和家里,OneDrive 都可以很方便的同步所有内容。

    image

    但是 OneDrive 不方便看博客的版本历史,所以后续把博客都备份到了 GithubGitCode 中。因为很多未整理的博客,所以仓库设置成了私有仓库。之所以把博客放到了两个远端仓库,也是备份的需要。使用 Git 也可以很方便把文件推送到多个远端仓库,参考:Git 推送到多个远程仓库

    博客模板

    我的博客模板很简单,如下内容

    # 博客标题
    
    作者: [Grey](https://www.cnblogs.com/greyzeng/)
    
    原文地址:
    
    [博客园:博客标题](#)
    
    [CSDN:博客标题](#)
    
    ## 说明
    
    
    ## 参考资料
    

    素材收集

    素材来源包括如下几个方面:

    1. 实体书

    2. 电子书/博客/专栏

    3. 视频教程

    4. 微信,社区

    主力收集工具是 OneNote,收集方式有如下三种

    配置

    Visual Studio Code 我只装了如下几个插件

    image

    其中 markdownlint 插件是我选择 Visual Studio Code 作为 md 编辑器的原因,

    安装这个插件后,只需要配置一个选项

    "editor.codeActionsOnSave": {
        "source.fixAll.markdownlint": true
    }
    

    这个配置可以在你保存 markdown 文件的时候,自动格式化 markdown 文档,使用起来很方便,但是前提是要熟练使用 markdown 语法。

    关于 markdown 的学习,我觉得最好的方式还是多用 markdown 写博客,当你用 markdown 写博客超过 10 篇,很多 markdown 语法自然就熟悉了,也可以通过类似的方法学习 Vi,Shell,Git。

    CSDN 也提供了Markdown 技能树

    我有段时间,学习了很多内容,但是博客却迟迟不肯动手写,总要等到自己完全掌握了一些东西才敢写出来,不过后来当我不断梳理总结自己的博客的时候,发现,写博客已经成为自己的一个习惯了。

    邹老师在02 每一行代码,都是你最好的名片 |《编程人生》中说到:莽撞地开始,拙劣地完成,也好过心怀完美主义而迟迟不肯动手去做。解决问题的最好步骤是:

    首先让程序跑起来(make it work)

    其次让程序运行正确(make it work right)

    再次让程序跑的快并且可维护(make it work fast & maintainable)

    所以,写博客是不是也可以有一个最好的步骤:

    首先把博客写出来

    其次把博客中的存在的问题修正过来

    再次让博客可以持续更新并维护

    最后,分享最近看到的一段话和大家共勉

    『真正的目标不是实现完美,而是自我完善,在这个旅途中不断发展,拥抱缺陷,并获得成长与学习的能力。因此,我们要追求连贯性,而不是完美性。』

  • 相关阅读:
    基于Kubernates微服务案例
    领导人怎样带领好团队
    前端性能核对表Checklist-2018
    国际巨头互联网公司一些运营与管理思路
    IT研发工程师职业规划
    高性能风控数据平台设计
    基础设施DevOps演进之路
    2017-2018年Scrum状态调查报告
    大型互联网系统的监控流水线
    小程序【情书与歌】一小时过审经验小谈
  • 原文地址:https://www.cnblogs.com/greyzeng/p/16685628.html
Copyright © 2020-2023  润新知