前言
在工作学习中,我配置好了一个VSCode
,学习C语言
,需要经常性的创建代码文件,而往往这里面有一个固定的模板,比如下面:
#define _CRT_SECURE_NO_WARNINGS
#include <stdlib.h>
#include <stdio.h>
int main(int argc,char* argv[])
{
/* code */
system("pause");
return 0;
}
你总不能一个一个文件复制粘贴吧?尤其代码量上去的时候,尤其不方便。但如果你学习的语言越多:C++
、Python
、JavaScript
,以及写博客需要用MD
。这些都能在VSCode
得到很好的解决方案,但是管理起来十分麻烦。于是我是想为什么不自己写一个软件来实现这种管理呢?NewCode
于是就写出来了,原本是一种语言一个版本,现在只需要配置好,就能实现一个NewCode
程序管理大量的单文件代码了。
仓库地址
目前只在GitHub
上,等这个软件差不多了搬到Gitee
:https://github.com/Wing-summer/NewCode
编码语言和编译环境
本人使用目前版本较高的VS2020
,使用C#
语言编写,下载编译即可。
入门
当你双击运行时,就会出现这个界面。
也就是说,当你直接运行该程序不带参数的时候,只会显示帮助并显示按任意键退出。
本工具的所有命令不区分大小写,如下为几个示例:
NewCode -t cpp -p C:\test -k
NewCode -st c
NewCode -t cpp -p C:\test -f "hello" " world"
NewCode -q
看不懂,我们来看看每个参数的含义:
-t | -type:类型,配置 json 代码块时的 id
-p | -path:路径,创建文件的路径,如果省略后缀,则以 json 配置为准添加
-k | -keepalive | -keep | -alive:执行该程序后不会退出,保持运行状态,可以执行其他的命令
-f | -fill | -param:填充可变参数,这对于模板十分有用,如何编写合适请见示例
-st | -settype:程序运行后,如果没特地设置,默认调用配置文件的第一个
-q:退出程序,仅在 keepalive 环境中有效
-add [type] [path] {ext}:添加以 type 的内容为 id ,然后用 path 作为路径,注意路径建议为相对路径,如果有 ext 参数则以它
为扩展名。
-mod [type] p={path} ext={ext}:修改 type 中的配置
-del [type]:删除以 type == id 的内容
-cls:清理所有的配置
-showAll:显示所有配置键值
-showInfo [type]:显示该类型的所有信息
-showtype [type]:作用同 -showInfo
-r | -restart:重启程序,如果后面带有 # 作为参数说明以管理员权限重启,重启默认带有 -k 参数。
-curdir | -pwd:显示当前工作目录
-prodir:显示该程序所在目录
-cd:更改当前目录,这通常很有用
-setenv:为该程序所在目录添加环境变量
-delenv:删除该程序所在目录的环境变量
下面有个说明:如果在keepalive
状态,也就是带有参数-k
运行时。就不需输入 NewCode
。如果上面的参数没有,该程序会调用cmd
命令运行。如果被视为cmd
命令运行,开头不得带有-
字符,否则视为内部命令。
输入几个命令测试一下:
配合VSCode
的中断功能更舒服:
编写配置
文件配置目录建议为相对目录,使用相对目录是指相对于本程序来说的。比如我配置一个cpp
模板,如下所示:
#include <iostream>
using namespace std;
int main(int argc,char* argv[])
{
// Written By |[0]|
system("pause");
return 0;
}
其中你可能会发现一个特殊字符|[0]|
这个是啥意思,对于C#
来说,如果格式化此字符串,等同于如下代码:
string.Format( "Written By {0}" , arg );
看到这个代码是不是懂了很多,因为代码语法比如C++
、C
、C#
、Java
等语言的大括号是有含义的,为了实现格式化功能,我对这个做了一个转义而已。也就是说,这个格式化支持所有的C#
代码格式化。
配置文件弄好,并用UTF-8
编码进行保存,这个就是我的程序遵守的协定,记好它的相对路径假设code\cpp.txt
。
然后我们在控制台并转到程序目录,运行该程序并带上参数:
NewCode -add cpp code\cpp.txt
这样我们就成功的在配置文件配置好了。
如果程序位置固定的话,建议为它设置环境变量,这就需要我们添加,不过我程序已经封装好这个功能,需要管理员权限,但是通常是以普通权限启动的,我们可以在keepalive
模式下使用下面的命令:
-r #
#
就是代表管理员权限,然后就使用keepalive
模式的管理员权限启动了这个程序,然后输入下面的命令:
-setenv
这就会为该程序所在目录添加环境变量,此时就不要动它的目录了,以防失效。
生成使用
接着上面的配置,我们就可以使用该程序创建,我们可以输入下面的命令:
Newcode -t cpp -p D:\test -f wingsummer
上面命令的含义就是在D盘
创建一个文件test.cpp
文件,并将wingsummer
作为参数进行格式化,调用配置cpp
,也就是我们之前配置好的,生成好的文件打开就会有如下结果:
#include <iostream>
using namespace std;
int main(int argc,char* argv[])
{
// Written By wingsummer
system("pause");
return 0;
}
但是如果没有后面的格式化填充命令,将会得到警告,并用空字符串进行填充,也就是如下命令:
Newcode -t cpp -p D:\test
也就是下面的结果:
#include <iostream>
using namespace std;
int main(int argc,char* argv[])
{
// Written By
system("pause");
return 0;
}
这就可以正常使用了,想要更好的使用的话,请详细阅读源码并作出自己习惯的使用的方式的代码,毕竟经过自己体会的代码,自己做出的工具是最趁自己手的。
关于提交 Bug
自己闲时写的,难免有错误。如有Bug
,欢迎递交。如果有其他需求,请自己把C#
代码写好并在GitHub
上进行Pull Request
,本人不会实现自己不需要的Request
功能。
协议
该软件使用MIT
协议,说明您可以使用可以在合法的用途下对其代码进行修改以符合自己的需求。但请不得随意用于商业用途,除非您对改代码修改程度超出总代码的八成。您可以将您的贡献自行写入该文件中,但不得删除原作者的信息和说明。