CMake笔记

Background

CMake意为cross-platform make，可用于管理c/c++工程。
CMake解析配置文件CMakeLists.txt生成Makefile，相比直接用Makefile管理工程，CMake更灵活和简单。

最简单的CMakeLists.txt

1
2

PROJECT(HELLO)    //更简单，这一句都可以省略!!!
ADD_EXECUTABLE(hello main.c)

然后执行cmake .,后输入make（单线程编译）或者make -jN（多线程编译：例如make -j4，即使用4个线程编译）

内置变量

系统信息

• CMAKE_MAJOR_VERSION，CMAKE主版本号，比如2.4.6中的2
• CMAKE_MINOR_VERSION，CMAKE次版本号，比如2.4.6中的4
• CMAKE_PATCH_VERSION，CMAKE补丁等级，比如2.4.6 中的6
• CMAKE_SYSTEM，系统名称，比如Linux-2.6.22
• CMAKE_SYSTEM_NAME，不包含版本的系统名，比如Linux
• CMAKE_SYSTEM_VERSION，系统版本，比如2.6.22
• CMAKE_SYSTEM_PROCESSOR，处理器名称，比如i686.
• UNIX，在所有的类UNIX平台为TRUE，包括OS X和cygwin
• WIN32，在所有的win32平台为TRUE，包括cygwin

开关选项

注:

1
2

set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fpermissive") 
//g++使用 -fpermissive 参数进行编译，即兼容一些老的语法，但是一些语法错误也会被忽略

命令

注意:

• 参数使用括弧括起，参数之间使用空格或分号分开。command(avg1 avg2 ...)
• 指令是大小写无关的，参数和变量是大小写相关的。但推荐全部使用大写指令。

ADD_LIBRARY

1

ADD_LIBRARY(libname [SHARED|STATIC|MODULE] [EXCLUDE_FROM_ALL] source1 source2 ... sourceN)

类型有三种：

• SHARED 动态库 后缀为.so –>生成文件lib[libname].so
• STATIC 静态库 后缀为.a –>生成文件lib[libname].a
• MODULE 在使用 dyld 的系统有效，如果不支持 dyld，则被当作 SHARED 对待

EXCLUDE_FROM_ALL 参数的意思是这个库不会被默认构建，除非有其他的组件依赖或者手工构建。

1
2
3
4
5

SET(LIBHELLO_SRC hello.c)
ADD_LIBRARY(hello SHARED ${LIBHELLO_SRC})   //动态库
ADD_LIBRARY(hello STATIC ${LIBHELLO_SRC})    //静态库
ADD_EXECUTABLE(demo main.c)
TARGET_LINK_LIBRARIES(demo hello)           //hello为一个库

INCLUDE_DIRECTORIES

1

INCLUDE_DIRECTORIES([AFTER|BEFORE] [SYSTEM] dir1 dir2 ...)

用来向工程添加多个特定的头文件搜索路径，路径之间用空格分割，如果路径中包含了空格，可以使用双引号将它括起来，默认的行为是追加到当前的头文件搜索路径的后面。你可以通过两种方式来进行控制搜索路径添加的方式：

1. CMAKE_INCLUDE_DIRECTORIES_BEFORE，通过 SET 这个 cmake 变量为 on，可以将添加的头文件搜索路径放在已有路径的前面。（另一个变量CMAKE_INCLUDE_DIRECTORIES_BEFORE也可使用!!）
2. 通过 AFTER 或者 BEFORE 参数，也可以控制是追加还是置前。

ADD_DEFINITIONS

1
2
3

add_definitions(
    -D__SHORT_FILE__=__FILE__
)

等价于

1

gcc -D__SHORT_FILE__=__FILE__ main.c -o demo

或者

1
2

cmake -D__SHORT__FILE__=__FILE__ main.c -o demo
cmake -DMY_VAR=hello .

或者在main.c头部添加了
#define SHORT_FILE FILE

注: ADD_DEFINITIONS本是添加编译参数，如：

add_definitions(-DDEBUG) 将在gcc命令行添加DEBUG宏定义；
add_definitions( “-Wall -ansi –pedantic –g”) 添加多个编译参数

ENABLE_TESTING & ADD_TEST

1
2
3

ENABLE_TESTING()
ADD_TEST(mytest ${PROJECT_BINARY_DIR}/BIN/main 2 10)
SET_TESTS_PROPERTIES(mytest PROPERTIES PASS_REGULAR_EXPRESSION "1024")  \\用来测试输出中是否包含后面的字符串

AUX_SOURCE_DIRECTORY

1
2

AUX_SOURCE_DIRECTORY(. SRC_LIST)
ADD_EXECUTABLE(main ${SRC_LIST})

FILE指令

1
2
3
4
5
6
7
8
9
10
11

FILE(WRITE filename "message towrite"... )
FILE(APPEND filename "message towrite"... )
FILE(READ filename variable)
FILE(GLOB variable [RELATIVE path][globbing expressions]...)
FILE(GLOB_RECURSE variable [RELATIVE path] [globbingexpressions]...)
FILE(REMOVE [directory]...)
FILE(REMOVE_RECURSE [directory]...)
FILE(MAKE_DIRECTORY [directory]...)
FILE(RELATIVE_PATH variable directory file)
FILE(TO_CMAKE_PATH path result)
FILE(TO_NATIVE_PATH path result)

注： FILE(GLOB_RECURSE SRC_LIST "*.cpp")即将该目录下及所有子文件夹内的++所有++后缀为.cpp的文件的路径，全部放入SRC_LIST变量中。

1
2
3
4
5
6

查找当前目录下所有的源文件并保存到SRC_LIST变量里
aux_source_directory(. SRC_LIST)
查找src目录下所有以cmake开头的文件并保存到CMAKE_FILES变量里
file(GLOB CMAKE_FILES "src/cmake*")
file命令同时支持目录递归查找
file(GLOB_RECURSE CMAKE_FILES "src/cmake*")

IF

1
2
3
4
5
6
7
8
9
10

IF(expression)
    # THEN section.
    COMMAND1(ARGS ...)COMMAND2(ARGS ...)
    ...
ELSE(expression)
    # ELSE section.
    COMMAND1(ARGS ...)
    COMMAND2(ARGS ...)
    ...
ENDIF(expression)

表达式的使用方法如下：

1
2
3
4
5
6
7
8
9
10
11
12

IF(var)，如果变量不是：空，0，N, NO, OFF, FALSE, NOTFOUND 或
<var>_NOTFOUND 时，表达式为真。
IF(NOT var )，与上述条件相反。
IF(var1 AND var2)，当两个变量都为真是为真。
IF(var1 OR var2)，当两个变量其中一个为真时为真。
IF(COMMAND cmd)，当给定的 cmd 确实是命令并可以调用是为真。
IF(EXISTS dir)或者 IF(EXISTS file)，当目录名或者文件名存在时为真。
IF(file1 IS_NEWER_THAN file2)，当 file1 比 file2 新，或者 file1/file2 其
中有一个不存在时为真，文件名请使用完整路径。
IF(IS_DIRECTORY dirname)，当 dirname 是目录时，为真。
IF(variable MATCHES regex)
IF(string MATCHES regex)

当给定的变量或者字符串能够匹配正则表达式 regex 时为真。比如：

1
2
3
4
5
6
7
8
9

IF("hello" MATCHES "ell")
    MESSAGE("true")
ENDIF("hello" MATCHES "ell")IF(variable LESS number)

IF(string LESS number)
IF(variable GREATER number)
IF(string GREATER number)
IF(variable EQUAL number)
IF(string EQUAL number)

数字比较表达式

1
2
3
4
5
6

IF(variable STRLESS string)
IF(string STRLESS string)
IF(variable STRGREATER string)
IF(string STRGREATER string)
IF(variable STREQUAL string)
IF(string STREQUAL string)

按照字母序的排列进行比较.

1

IF(DEFINED variable)，如果变量被定义，为真。

一个小例子，用来判断平台差异：

1
2
3
4
5
6
7

IF(WIN32)
       MESSAGE(STATUS “This is windows.”)
    #作一些 Windows 相关的操作
ELSE(WIN32)   //容易引起歧义
    MESSAGE(STATUS “This is not windows”)
    #作一些非 Windows 相关的操作
ENDIF(WIN32)

或者配合SET(CMAKE_ALLOW_LOOSE_LOOP_CONSTRUCTS ON)使用后，上述语句可简化为如下形式：

1
2
3

IF(WIN32)
ELSE()
ENDIF()

如果配合 ELSEIF 使用，可能的写法是这样:

1
2
3
4
5
6
7

IF(WIN32)
    #do something related to WIN32
ELSEIF(UNIX)
    #do something related to UNIX
ELSEIF(APPLE)
    #do something related to APPLE
ENDIF(WIN32)

WHILE

1
2
3
4
5

WHILE(condition)
    COMMAND1(ARGS ...)
    COMMAND2(ARGS ...)
    ...
ENDWHILE(condition)

FOREACH

1. 列表

   1 2 3 4

   AUX_SOURCE_DIRECTORY(. SRC_LIST) FOREACH(F ${SRC_LIST}) MESSAGE(${F}) ENDFOREACH(F)

2. 范围

   1 2 3

   FOREACH(VAR RANGE 10) //从0到10以1步进 MESSAGE(${VAR}) ENDFOREACH(VAR)

3. 范围和步进

   1 2 3

   FOREACH(A RANGE 5 15 3) //从5开始到15结束，以3为步进 MESSAGE(${A}) ENDFOREACH(A)

注:直到遇到ENDFOREACH指令，整个语句块才会得到真正的执行。

内部构建 vs 外部构建

构建分为内部构建(in-sourcebuild)和外部构建(out-of-source build)。
外部构建一个最大的好处是，对于原有的工程没有任何影响，所有动作全部发生在编译目录。而cmake强烈推荐的是外部构建。

|——build
|——CMakeLists.txt
|——CMakeLists.txt.bak
|____main.c

根目录下包含源文件.c、CMakeList.txt。然后创建*build**文件夹，并cd build下，再执行cmake ..，再make -j4.

注: 通过外部编译进行工程构建，HELLO_SOURCE_DIR仍然指代工程路径，即/backup/cmake/t1;而 HELLO_BINARY_DIR 则指代编译路径，即/backup/cmake/t1/build.

FAQ

1） 怎样获得一个目录下的所有源文件

>>  aux_source_directory(<dir> <variable>)
>>  将dir中所有源文件（不包括头文件）保存到变量variable中，然后可以add_executable (ss7gw ${variable})这样使用。

2） 怎样指定项目编译目标
>> project命令指定

3） 怎样添加动态库和静态库
>> target_link_libraries命令添加即可

4） 怎样在执行CMAKE时打印消息
>> message([SEND_ERROR | STATUS | FATAL_ERROR] “message to display” …)
>> 注意大小写

5） 怎样指定头文件与库文件路径
>> include_directories与link_directories
>>可以多次调用以设置多个路径
>> link_directories仅对其后面的targets起作用

6） 怎样区分debug、release版本
>>建立debug/release两目录，分别在其中执行cmake -DCMAKE_BUILD_TYPE=Debug（或Release），需要编译不同版本时进入不同目录执行make即可；
Debug版会使用参数-g；Release版使用-O3 –DNDEBUG
>> 另一种设置方法——例如DEBUG版设置编译参数DDEBUG

IF(DEBUG_mode)
    add_definitions(-DDEBUG)
ENDIF()
在执行cmake时增加参数即可，例如cmake -D DEBUG_mode=ON

7） 怎样设置条件编译
例如debug版设置编译选项DEBUG，并且更改不应改变CMakelist.txt

>> 使用option command，eg：

option(DEBUG_mode "ON for debug or OFF for release" ON)
IF(DEBUG_mode)
    add_definitions(-DDEBUG)
ENDIF()

>> 使其生效的方法：首先cmake生成makefile，然后make edit_cache编辑编译选项；Linux下会打开一个文本框，可以更改，该完后再make生成目标文件——emacs不支持make edit_cache；
>> 局限：这种方法不能直接设置生成的makefile，而是必须使用命令在make前设置参数；对于debug、release版本，相当于需要两个目录，分别先cmake一次，然后分别make edit_cache一次；
>> 期望的效果：在执行cmake时直接通过参数指定一个开关项，生成相应的makefile——可以这样做，例如cmake –DDEBUGVERSION=ON

8） 怎样添加编译宏定义
>> 使用add_definitions命令，见命令部分说明

9） 怎样添加编译依赖项
用于确保编译目标项目前依赖项必须先构建好
>>add_dependencies

10） 怎样指定目标文件目录
>> 建立一个新的目录，在该目录中执行cmake生成Makefile文件，这样编译结果会保存在该目录——类似
>> SET_TARGET_PROPERTIES(ss7gw PROPERTIES
RUNTIME_OUTPUT_DIRECTORY “${BIN_DIR}”)

11） 很多文件夹，难道需要把每个文件夹编译成一个库文件？
>> 可以不在子目录中使用CMakeList.txt，直接在上层目录中指定子目录

12） 怎样设定依赖的cmake版本
>> cmake_minimum_required(VERSION 2.6)

13） 相对路径怎么指定
>> ${projectname_SOURCE_DIR}表示根源文件目录，${ projectname _BINARY_DIR}表示根二进制文件目录？

14） 怎样设置编译中间文件的目录
>> TBD

15） 怎样在IF语句中使用字串或数字比较
>>数字比较LESS、GREATER、EQUAL，字串比STRLESS、STRGREATER、STREQUAL，
>> Eg：

set(CMAKE_ALLOW_LOOSE_LOOP_CONSTRUCTS ON)
set(AAA abc)
IF(AAA STREQUAL abc)
    message(STATUS "true")   #应该打印true
ENDIF()

16） 更改h文件时是否只编译必须的cpp文件
>> 是

17） 机器上安装了VC7和VC8，CMAKE会自动搜索编译器，但是怎样指定某个版本？
>> TBD

18） 怎样根据OS指定编译选项
>> IF( APPLE ); IF( UNIX ); IF( WIN32 )

19） 能否自动执行某些编译前、后命令？
>> 可以，TBD

20） 怎样打印make的输出
>> make VERBOSE=1 #看到 make 构建的详细过程

还未吃透！！！

###包含目录和链接目录
将./include和./abc加入包含目录列表

include_directories(
    ./include
    ./abc
)

将./lib加入编译器链接阶段的搜索目录列表

link_directories(
    ./lib
)

添加生成目标

使用SRC_LIST源文件列表里的文件生成一个可执行文件hello

add_executable(hello ${SRC_LIST})

使用SRC_LIST源文件列表里的文件生成一个静态链接库libhello.a

add_library(hello STATIC ${SRC_LIST})

使用SRC_LIST源文件列表里的文件生成一个动态链接库libhello.so

add_library(hello SHARED ${SRC_LIST})

将若干库文件链接到生成的目标hello(libhello.a或libhello.so)

target_link_libraries(hello A B.a C.so)

需要注意的是，target_link_libraries里库文件的顺序符合gcc链接顺序的规则，即被依赖的库放在依赖它的库的后面，比如上面的命令里，libA.so可能依赖于libB.a和libC.so，如果顺序有错，链接时会报错。还有一点，B.a会告诉CMake优先使用静态链接库libB.a，C.so会告诉CMake优先使用动态链接库libC.so，也可直接使用库文件的相对路径或绝对路径。使用绝对路径的好处在于，当依赖的库被更新时，make的时候也会重新链接。

Day 01

效率

开发效率：
C++11 -> auto、lambda、move
同步、异步、多线程、多进程…
运行效率

预备知识

1. TCP/IP （网络编程都是此种协议）
   • TCP -> 传输控制协议
   • IP -> 网际协议
2. Socket
3. C++
   • 指针、引用、地址、循环、函数、类…
   • std::shared_ptr、std::thread、std::aync、decltype、std::future、right、reference
4. 第三方库
   • BOOST

问题：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

// 反转链表
#include<algorithm>

using namespace std;
struct Node{
  int* next;
  int value;
}

void pirntNodeList(Node* n){
  while(n)
  {
  	cout << n->value << " ";
    n = n->next;
  }
  cout << "\n";
}

Node* reverseList(Node* node)
{
  
  return 0;
}

void quizOne()
{
  Node* n = 0;
  for(int i = 0; i<3; i++)
  {
    n->next = Node(i);
  }
}

IP网际协议详解

IP = Internet protocol suite

OSI模型（Open System Interconnection model）

注意: 七个层级，过于复杂。

IP模型

数据进入协议栈的封装

注意: Frame data 长度有要求，最小46字节，不足添0；最大1500个字节。

MTU（最大传输单元），当传输数据 > MTU时，则在IP层需要拆分成小包。

IP特点

• 不可靠（unreliable）
• 无连接（connectionless）

IP数据报格式首部字段

注意:【小小】 网络数据都是按照Big Endian【大端存储】传送的；家用操作系统都是Littele Endian数据存储。

思考题：

1
2
3

static bool isLittleEndianSystem(){

}

TCP详解

TCP如何利用IP

• IP的特点
• TCP将应用程序的传输数据分割成合适的数据块
• 定时器
• 延迟确认
• 检验和CRC
• 流量控制

TCP首部

注意: IP首部20Byte，TCP首部20Byte，如需在网络传输，还需填充6Byte。

所谓的Socket , 即ip+port

ip 来自 IP首部
port 来自 TCP首部

• Sequence Number 用于标记定时器对那一数据包计时。
• Acknowlegment Number 与延迟确认有关 -> if ACK set
• Checksum 与 检验和 有关
• Data offset – 数据长度
• URG -> 数据紧急标志位
• ACK -> 数据确认标识位
• PSH -> push
• RST -> reset
• SYN -> 建立时需要
• FIN -> 结束

TCP状态

TPC状态变迁

蓝线–server；棕线–client；虚线–异常

TCP的连接（三次握手）

TCP连接的断开（四次握手）

1.为什么断开要四次握手？

全双工,两边都需要确认
主动断开方，会进入TIME_WAIT状态

TCP数据相互传送

• 交互式(小数据)与成块的数据两种
• 时间延迟确认
• Nagle算法[小数据积攒后再发送](游戏开发一般关闭这个算法)
• 接收窗口大小

TCP内部使用的定时器

• 重传定时器
• 坚持定时器(Persist)
• 保活定时器(KeepAlive)<建议不开启>
• 2MSL定时器(TIME_WAIT)

实战

Wireshark使用

需安装WinCap方能使用

筛选器

ip.addr==115.239.210.27 && ip.port==80

Socket API (Berkeley sockets, BSD Socket)

头文件

API函数

服务器和客户端的例子

TCP Socket 基本流程图

Code：

Server_main.cpp

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

#include<sys/types.h>
#include<sys/socket.h>
#include<netinet/in.h>
#include<arpa/inet.h>

#include<stdio.h>
#include<stdlib.h>
#include<string.h>
#include<unistd.h>

int main(int argc, char** argv)
{
  char hello[] = "hello world";
  struct sockaddr_in sa;
  int SocketFD = socket(PF_INET, SOCK_STREAM, IPPROTO_TCP);

  if(-1 == SocketFD)
  {
    perror("cannot create socket");
    exit(EXIT_FAILURE);
  }

  memset(&sa, 0, sizeof sa);

  sa.sin_family = AF_INET;
  sa.sin_port = htons(2222);
  sa.sin_addr.s_addr = htonl(INADDR_ANY);

  if(-1 == bind(SocketFD, (struct sockaddr*)&sa, sizeof sa))
  {
    perror("bind failed");
    close(SocketFD);
    exit(EXIT_FAILURE);
  }

  if(-1 == listen(SocketFD, 10))
  {
    perror("listen failed");
    close(SocketFD);
    exit(EXIT_FAILURE);
  }

  for(;;)
  {
    int ConnectFD = accept(SocketFD, NULL, NULL);

    if(0 > ConnectFD)
    {
      perror("accept failed");
      close(SocketFD);
      exit(EXIT_FAILURE);
    }

    int writeSize = 0;
    size_t totalWrite = 0;
    while(totalWrite < sizeof(hello))
    {
      writeSize = 
        write(ConnectFD, hello + totalWrite, sizeof(hello) - totalWrite);
      if(-1 == writeSize)
      {
        perror("write failed");
        close(ConnectFD);
        close(SocketFD);
        exit(EXIT_FAILURE);
      }
      totalWrite += writeSize;
    }

    if(-1 == shutdown(ConnectFD, SHUT_RDWR))
    {
      perror("shutdown failed");
      close(ConnectFD);
      close(SocketFD);
      exit(EXIT_FAILURE);
    }
    close(ConnectFD);
  }
  close(SocketFD);
  return EXIT_SUCCESS; 
}

Client_main.cpp

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

#include<sys/types.h>
#include<sys/socket.h>
#include<netinet/in.h>
#include<arpa/inet.h>

#include<stdio.h>
#include<stdlib.h>
#include<string.h>
#include<unistd.h>

int main(int argc, char** argv)
{
  struct sockaddr_in sa;
  int res;
  int SocketFD = socket(PF_INET, SOCK_STREAM, IPPROTO_TCP);

  if(-1 == SocketFD)
  {
    perror("cannot create socket");
    exit(EXIT_FAILURE);
  }

  memset(&sa, 0, sizeof sa);

  sa.sin_family = AF_INET;
  sa.sin_port = htons(2222);
  res = inet_pton(AF_INET, "127.0.0.1", &sa.sin_addr);

  if(-1 == connect(SocketFD, (struct sockaddr*)&sa, sizeof sa))
  {
    perror("connect failed");
    close(SocketFD);
    exit(EXIT_FAILURE);
  }

  char buffer[512];
  int totalRead = 0;
  for(;;)
  {
    int readSize = 0;
    readSize = read(SocketFD, buffer + totalRead, sizeof(buffer)-totalRead);
    if(readSize == 0)
    {
      break;
    }
    else if(readSize == -1)
    {
      perror("read failed");
      close(SocketFD);
      exit(EXIT_FAILURE);
    }
    totalRead += readSize;
  }
  buffer[totalRead] = 0;
  printf("get from server: %s\n",buffer);

  (void)shutdown(SocketFD, SHUT_RDWR);

  close(SocketFD);
  return EXIT_SUCCESS;
}

常用命令汇总

注意：可以做个命令统计脚本，根据使用频次排序上述命令。

本地资料备份

已在github添加hexo分支，本地资料push到hexo分支，hexo部署由hexo d自动推送到master分支。

1

git push origin hexo

安装 hexo

1
2
3
4
5

npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo server

更换NexT 主题

1
2

cd blog
git clone https://github.com/iissnan/hexo-theme-next themes/next

修改配置文件
打开_config.yml:
修改主题一行为：

1

theme: next

写文章

1

hexo new [layout] <title>

默认layout使用 _config.yml 中的 default_layout 参数
若标题中包含空格，请使用引号括起来。

1

hexo new page --path about/me "About me"  # 自定义新文章路径

举例

1

hexo new first.md

编辑first.md文件即可

本地启动服务器

1
2
3

hexo server
# 可简写为
hexo s

默认网址：![http://localhost:4000/]
-p 重设端口号
-s 只使用静态文件

部署到github

1. 安装 github部署工具

   1	npm install hexo-deployer-git --save

2. 修改_config.yml

   1 2 3

   deploy: type: git repo: https://github.com/Narglc/Narglc.github.io

3. 部署到github

   1 2 3

   hexo deploy # 可简写为： hexo d

generate vs deploy

1
2
3
4

hexo generate		# 生成静态文件
	-d,--deploy  	# 文件生成后立即部署网站
# 可简写为：
hexo g

hexo g 仅仅生成静态文件，用于本地部署；hexo d 可推送到github部署

clean

1

hexo clean			#清除缓存文件 (db.json) 和已生成的静态文件 (public)。

代码高亮样式

1
2

# normal | night | night eighties | night blue | night bright  # 5种可用
highlight_theme: night

添加阅读全文按钮 [暂未开启]

只显示文章一部分，多余的需要点击阅读全文来查看，需要在文章中添加

1

<!--more-->

设置网站缩略图标

修改站点配置文件_config.yml中small、medium、apple_touch_icon对应图片地址：

1
2
3
4
5

favicon:
  small: /images/favicon-16x16-next.png
  medium: /images/favicon-32x32-next.png
  apple_touch_icon: /images/apple-touch-icon-next.png
  safari_pinned_tab: /images/logo.svg

本地搜索功能

安装 hexo-generator-searchdb 插件

1

npm install hexo-generator-searchdb --save

修改next主题配置文件_config.yml:

1
2

local_search:
  enable: true

站点配置文件_config.yml的Extensions后添加：

1
2
3
4
5

search:
  path: search.xml
  field: post
  format: html
  limit: 10000

侧边栏社交链接

修改next主题配置文件_config.yml:

1
2
3
4
5
6
7
8
9

social:
  E-Mail: mailto:qingcheliuzhi@qq.com || envelope
  GitHub: https://github.com/Narglc || github
  豆瓣: https://www.douban.com/people/Narglc/ || douban
social_icons:
  enable: true
  icons_only: false
  transition: false
  微博: weibo		# 可设置上述对应的图标

注意： || 前面是链接地址，后面是FontAwsone字符库的图标名

打赏

修改站点配置文件_config.yml:

1
2
3
4

# Reward
reward_comment: Donate comment here
wechatpay: /images/wechatpay.jpg
alipay: /images/alipay.jpg

文章末尾添加版权信息

实现

手动修改主题目录下的 layout/_macro/post.swig 文件，找到 post-footer 标签，添加以下内容div内代码段：

即，将div内代码段插入footer标签开始处。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

<footer class="post-footer">
	<div>    
	 {# 此处判断是否在索引列表中 #}
	 {% if not is_index %}
	<ul class="post-copyright">
	  <li class="post-copyright-author">
	      <strong>本文作者：</strong>{{ theme.author }}
	  </li>
	  <li class="post-copyright-link">
	    <strong>本文链接：</strong>
	    <a href="{{ url_for(page.path) }}" title="{{ page.title }}">{{ page.path }}</a>
	  </li>
	  <li class="post-copyright-license">
	    <strong>版权： </strong>
	    本站文章均采用 <a href="http://creativecommons.org/licenses/by-nc-sa/3.0/cn/" rel="external nofollow" target="_blank">CC BY-NC-SA 3.0 CN</a> 许可协议，请勿用于商业，转载注明出处！
	  </li>
	</ul>
	{% endif %}
	</div>
[footer 原有内容]
</footer>

添加显示格式

修改主题目录下的 source/css/_custom/custom.styl 文件:

1
2
3
4
5
6
7

.post-copyright {
    margin: 1em 0 0;
    padding: 0.5em 1em;
    border-left: 3px solid #ff1700;
    background-color: #f9f9f9;
    list-style: none;
}

站点访问计数

使用不蒜子脚本实现计数

新实现

Next 主题在版本6.0以上已经内置了不蒜子访客统计的代码，修改主题配置文件_config.yml即可

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

busuanzi_count:
  # count values only if the other configs are false
  enable: true
  # custom uv span for the whole site
  site_uv: true
  site_uv_header: <i class="fa fa-user"></i> 访问人数
  site_uv_footer: 人
  # custom pv span for the whole site
  site_pv: true
  site_pv_header: <i class="fa fa-eye"></i> 总访问量
  site_pv_footer: 次
  # custom pv span for one page only
  page_pv: true
  page_pv_header: <i class="fa fa-file-o"></i> 阅读数
  page_pv_footer:

Welcome to Hexo! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub.

Quick Start

Create a new post

1

$ hexo new "My New Post"

More info: Writing

Run server

1

$ hexo server

More info: Server

Generate static files

1

$ hexo generate

More info: Generating

Deploy to remote sites

1

$ hexo deploy

More info: Deployment

文本居中的引用

1
2
3
4
5
6
7
8
9

<!-- HTML方式: 直接在 Markdown 文件中编写 HTML 来调用 -->
<!-- 其中 class="blockquote-center" 是必须的 -->
<blockquote class="blockquote-center">blah blah blah</blockquote>

<!-- 标签 方式，要求版本在0.4.5或以上 -->
{% centerquote %}blah blah blah{% endcenterquote %}

<!-- 标签别名 -->
{% cq %} blah blah blah {% endcq %}

效果如下：

blah blah blah

blah blah blah

blah blah blah