OnlyCalm's Blog

Doxygen基础篇（一）——安装Doxygen前言：  Doxygen可以像JavaDoc那样提取代码中的注释生成文档手册，它不仅是一种文档生成工具，更是一种注释的规范，要写出规范的代码掌握Doxygen是必要的。 1 Doxygen简介   Doxygen 是一种开源跨平台的代码文档生成工具。Doxygen可将按照其规定格式编辑的注释信息提取转换生成方便阅读的说明文档，文档格式有LATEX、RTF等，支持C, Objective-C, C#, PHP, Java, Python等语言。 2 安装Doxygen2.1 Windows下安装Doxygen  Windows下载官网找到exe文件下载安装，它捆绑了32位和64位版本，根据操作系统自动选择合适的版本安装。里面包含了手册和GUI。   在点击 I accept the agreement 然后点击 Next...

解决vim-translator提示pySocks问题前言：  vim-translator是比较好用的Vim翻译插件，使用浮动窗口显示翻译结果时，提示pySocks没有安装，本篇文章将带你解决这个问题。 1 问题描述  在安装了 vim-translator 后，在浮动窗口中显示翻译结果会得到下图的报错信息。    pySocks module should installed ， 2 安装pySocks  如果使用的是python3，在Ubuntu下需要先执行以下指令安装 python3-pip 。 1sudo apt-get install python3-pip   python3-pip安装完成后，通过 pip 安装pySocks。Ubuntu终端中运行以下指令进行安装。 1pip install pysocks   再次在浮动窗口中显示翻译结果，现在没有报错了。

Shields使用教程前言：  Shields是制作徽章的工具，在各大代码托管平台上被广泛使用，掌握它将利于我们编写出更加漂亮规范的README说明。 1 Shields   Shields 是目前主流的徽章制作工具，简介快速生成徽章，可以嵌入到网页或Markdown中。 2 生成徽章2.1 编辑链接生成徽章 1   语法格式如下： 1https://img.shields.io/badge/<LABEL>-<MESSAGE>-<COLOR>   通过Shields语法规则生成徽章非常简单，<LABEL>-<MESSAGE>-<COLOR> 由三部分构成，中间通过 - 分隔。 <LABEL> :...

规范的README前言：  Github上浏览开源项目时通常项目根目录都有一个字说明文件README.md，该文件可以帮助开发或使用者快速的熟悉和使用这个项目。为项目写出规范的README文件是有必要的。 1 README的作用  README是项目的自述文件，通常它 README.md 是项目的第一个入口文件，而不是急着看代码。阅读它能使得开发或使用者快速熟悉和使用该项目。 2 README应该有哪些内容  README应该告诉阅读者如何使用你的模块或工程，如果安装和使用它。标准的方式编写README将使得阅读理解它更轻松，维护更加方便。  在Github上有一个关于README的开源项目 RichardLitt/standard-readme ，可以访问它，本篇文章也是基于此规范进行讨论。  以下是一个好的README应该具有的内容。 3...

c进阶篇（六）——结构体位域前言：  结构体位域可以方便对Bit级数据的操作，可以更有效的利用Bit数据空间。 1 数据存储大小端  大小端表示数据在计算机中的存放顺序。 小端模式：低字节保存在内存低地址，高字节保存在内存高地址。 大端模式：低字节保存在内存高地址，高字节保存在内存低地址。   在使用结构体位域操作和联合嵌套结构体时尤其需要注意数据存储的大小端问题。如果使用的是单片机，可以查看用户手册了解所用型号的单片机。 2 定义位域结构体   在符号 : 之后给出数据类型所占的Bit数，对数据位域长度进行限制，以下为了方便均假设数据存储为小段模式，即结构体中先定义的成员变量存储在低地址和低Bit字段。 123456789101112131415161718192021#include <stdio.h>#include <stdint.h>typedef uint8_t Byte;typedef uint16_t Word;typedef uint32_t...

c进阶篇（五）——匿名结构体前言：  对c/c++程序员来说，结构体是非常常用的自定义数据类型，它对数据进行封装，使用匿名结构体可进一步增强数据的封装性。 1 什么是匿名结构体  以下是正常定义一个带名称的结构体示范。 12345typedef struct Rect{ Byte byLen; Byte byWide;}STRect;   名为 STRect 的结构体拥有两个成员 byLen 和 byWide ，要对其访问可以通过一个成员运算符即可访问 stRect.byLen 或 stRect.byWide 。  如果成员多几个 类别 ，往往会进行二次封装，比如矩形有关于尺寸的成员变量，也有关于颜色的成员变量。 1234567891011121314151617181920212223242526272829#include <stdio.h>#include <stdint.h>typedef uint8_t...

CMake基础篇（一）——安装CMake前言：   作为c/c++的深度使用者，有必要对编译器有一定了解，而CMake就是一种知名的跨平台编译工具。 1 CMake简介  CMake是一种跨平台的编译工具，它语法简单，可以输出各种各样的makefile或project文件。CMake用于产生标准的构建档，使得开发者可以在不同的平台用标准的方式构建软件，实现一次编写编译规则，多个平台相同编译。  官方有详细的 介绍文档 供学习。 2 安装CMake2.1 Windows下安装CMake  Windows下可以直接选择 CMake 的二进制文件安装，在 CMake下载 界面中找到最新版的msi下载。   下载后双击msi文件开始安装，安装很简单，一路 next 就行了。 2.2 Ubuntu下安装CMake  在Ubuntu下安装就简单多了，直接执行指令即可完成安装。 1sudo apt-get install...

解决Vim-visual-multi和coc.nvim插件冲突前言：  Vim-visual-multi是一款非常好用的多光标插件，而coc.nvim更是一款功能强大的插件，它已不止用来补全和语法提示，这么好用的插件如果无法同时使用将是巨大的悲哀。 1 冲突问题  在同时安装了插件 vim-visual-multi 和 coc.nvim 后，若Coc检测到语法错误或警告并提示，那么此时在多光标模式下的操作存在两种错误，一种是按退格键一次性删除多个字符。   另一种错误是在多光标模式下按下 d 或 x 键出现异常报错，无法深处字符。   这个两个插件的冲突我已经在Github上向原作者提出了 mg979/vim-visual-multi/issues/172 。 2 运行环境 Win10 WSL Ubuntu 20.04LTS； Vim v8.1； vim-visual-multi master Git hash: 8566a31； coc.nvim master...

自娱自乐，我的博客（十四）——Coding改版后的部署前言：  Coding已经改版一段时间了，改版最大的变动就是开始对网站部署收费。好在新用户从第一次部署开始前6个月免费，而最近Vercel也被墙了国内访问不了，所以这篇文章教你怎么在重新回到改版后的Coding上部署，本篇文章假设你已经在有过一些基础部署经验 1 重回Coding部署的原因  之前我已经在Coding上部署过（改版前），当时Coding免费且支持绑定自定义域名，而且访问速度还过得去（服务器在国内），后来收费所以跑到Vercel上部署，但Vercel近期被墙并且看不到恢复的希望，因此重新回到Coding好好利用它前六个月的免费期，六个月之后怎么办？到时候再说吧，懒得折腾到时候可能就付费了。 2 在Coding上新建网站  登录Coding官网，点开部署的项目仓库，点击左侧的 网站托管 ，然后点击页面的 新建网站 。   填写自己站点的信息，网站类型选静态仓库，网站类型选静态网站。节点如果网站已经备案选哪里随你，如果没有备案过智能选...

Vim解决Not an editor command ^M前言：  本篇文章解决提示Not an editor command ^M的异常问题。 1 为什么会产生这个错误？  在Windows系统中换行符表示为 \r\n ，而在Unix系统中换行符表示为 \n ，这里的 ^M 其实就是Unix中的 \r ，当Windows下的文件在Unix中打开就会遇到换行符不同而无法识别的问题。 2 通过替换指令解决  可以在Vim中通过指令将 \r 删除掉，这样在Unix中就不会报错了。 1:%s/\r//g   这个方法也是网上很多人给出的方法，但我亲测了无效。 3 修改文件格式  更好的方法是直接修改文件格式（注意是 fileformat 不是 fileencoding ），在Windows下创建的文件默认器 fileformat 是 dos ，我们通过Vim打开该文件将其改为 unix 即可。 1:set fileformat=unix