SSDOT

该文档基于最新版的ssdot

达成成就：用npm去跑一个Java的项目 lol (见下)

输入的时机

只要出现这个

Press Ctrl/Cmd + C to exit.

你就可以开始输入代码了

语法

注释

/comment_content/

两个/之间的内容会被当做注释忽略掉

输出字符

Hello, world!.

. 用于输出前面的所有字符并换行

转义

一共有三种特殊字符(对于三个语法)

• .
• \
• /

example\.com.

\用于转义下一个字符为普通字符(包括转义它自己\\)

Note

如果下一个字符不是特殊字符, 那转义了跟没转义一样, 浪费

Tip

若在注释内想表达一个/, 和注释外面的/转义方式不一样 使用// (特性: 第一个/代表注释的结束, 第二个/代表另外一个注释的开始)

示例

Slash (\/) is a special character, so we need/n't/ to escape it with a backslash (\\) to use it\..The/ first but not the/ second line!.

参数

keepResidue和keepStatus

1. keepResidue可以把上一次运行结果中还没输出出来的字符先存起来, 等到下一次输出时再一起输出

java -jar ./ssdot-java.jar --keepResidue <other_args>
java -jar ./ssdot-java.jar -kr <other_args>

Tip

下文, 若无特殊说明, 还没输出出来的字符就叫做residue

2. keepStatus可以把上一次运行结果后的状态先存起来, 下一次运行时默认就是以这个状态开始运行

java -jar ./ssdot-java.jar --keepStatus <other_args>
java -jar ./ssdot-java.jar -ks <other_args>

以下是ssdot的状态表

状态	意义	内部使用
0 (默认)	程序部分	NORMAL
1	转义	BACKSLASH
2	注释	COMMENT

Note

如果你退出了这个程序, 状态和待输出文本照样都会丢失

Tip

判断是否启用keepResidue或keepStatus, 可以逐行运行下面这段代码(先确保当前状态为0)

Residue kept\. /
./Status kept\..

trimEnd

java -jar ./ssdot-java.jar --trimEnd <other_args>
java -jar ./ssdot-java.jar -te <other_args>

这个功能可以将输出结果末尾的所有空格去除掉

verbose

java -jar ./ssdot-java.jar --verbose <other_args>
java -jar ./ssdot-java.jar -vb <other_args>

如果你不去启用这个功能, 输入的时机见上

这个功能会在请求输入时额外弹出一个提示框

[X Y]>

其中：

• X代表当前residue的长度, 若没有启用--keepResidue则会显示~
• Y代表当前status对应的数字(见上文status状态表), 若没有启用--keepStatus则会显示~

version

java -jar ./ssdot-java.jar --version
java -jar ./ssdot-java.jar -v

显示版本号

配置文件

Ssdot会查看执行目录下的.ssdotconf文件, 他们的参数配置比命令行给的参数优先级高

生成配置文件

1. 根据传入的参数(version除外)

java -jar ./ssdot-java.jar genconf <other_args>
java -jar ./ssdot-java.jar genconf:standard <other_args>
java -jar ./ssdot-java.jar genconf:simple <other_args>

2. 自己编辑

语法如下(一行一个)

<argument>:<arg_enable>

2001. argument

argument可以填以下内容(区分大小写, 同一项的两个效果一样)

• keepResidue kr
• keepStatus ks
• trimEnd te
• verbose vb

由于解析参数是惰性的, 所以argument理论上可以填任何东西. 但填其他内容则不会生效, 例如hello: world.

2002. arg_enable

arg_enable本质上需要填写布尔值, 但填写下面任一字符都会被视为true, 否则false (不区分大小写)

• true系: true, t
• yes系: yes, y
• please系: please, plz, pls
• on系: on

例如 True和pLEaSE也会被视为true.

这也留了一个坑, 例如 absolutely, yes plz都会被视为false, 所以要表示true最好用true或t.

与此同时, 要表示false, 最好只用这些字符

• false系: false, f
• no系: no, n
• off系: off

如果你想让启动ssdot(java -jar ./ssdot-java.jar)时再决定这些参数, 请留空该字段或者干脆删掉这一行得了

2003. 语法示例

• 标准

trimEnd: true
verbose: false

• 简洁

te:t
vb:f

为什么用npm

就一个小项目, 没有任何依赖, 后面也不会经常更新

为什么不用Maven或者Gradle

我平日里很少写Java, 但经常写JavaScript, 所以npm对我来说更熟悉一些

Maven和Gradle我完全不会, 说真的

为什么不直接用bash或者ps1文件代替npm run

跑npm run的时候, 你完全不用担心你现在在哪个目录, 因为它本来就是跑在项目根目录的, 并且跑完又切回来, 这样就不会有路径问题了