0%

SPHINX的输出文档格式

用rst编写,然后用sphinx-build进行编译,还是效果相当不错地,只要掌握了格式,可以一次编译,多种格式输出,主要是用的可能是html和pdf,不过其他格式也是具备的。

这些命令提供了广泛的灵活性,以满足各种输出格式的需求,如下所示:

  • HTML:make html 生成HTML格式的文档。
  • 目录HTML:make dirhtml 生成HTML格式的文档,每个目录下都有一个名为index.html的文件。
  • 单个HTML文件:make singlehtml 生成一个单独的大型HTML文件,这个比较方便分享。
  • Pickle:make pickle 生成Pickle文件。
  • JSON:make json 生成JSON文件。
  • HTML帮助项目:make htmlhelp 生成HTML格式的帮助项目。
  • qthelp项目:make qthelp 生成qthelp项目。
  • Devhelp项目:make devhelp 生成Devhelp项目。
  • ePub:make epub 生成ePub格式的电子书。
  • LaTeX:make latex 生成LaTeX格式的文档,可以设置 PAPER=a4 或者 PAPER=letter。
  • LaTeXPDF:make latexpdf 生成LaTeX和PDF格式的文档。
  • LaTeXPDFJA:make latexpdfja 生成LaTeX和PDF格式的文档,使用platex/dvipdfmx编译运行。
  • 文本:make text 生成文本文件。
  • 手册页:make man 生成手册页。
  • Texinfo:make texinfo 生成Texinfo格式的文档。
  • info:make info 生成Texinfo格式的文档,并通过makeinfo运行它们。
  • 获取gettext:make gettext 生成PO消息目录,用于多语种支持。
  • 变更概览:make changes 生成所有已更改/添加/弃用项的概览。
  • XML:make xml 生成Docutils原生XML文件。
  • 伪XML:make pseudoxml 为显示目的生成伪XML-XML文件。
  • 链接检查:make linkcheck 检查所有外部链接的完整性。
  • doctest:make doctest 运行文档中嵌入的所有doctest(如果启用)。
  • 覆盖率:make coverage 运行文档的覆盖率检查(如果启用)。
  • 清理:make clean 删除构建目录中的所有内容。

linux中最常用的文件传输命令

仅个人想法,会持续不间断更新和改进。

现在的Linux大抵都是具备图形界面的,特别是个人使用的话,不装个GUI界面那就说不过去了。

不过但是要远程使用服务器,后者超算,或者只能命令行的方式登陆到其他服务器,其他终端的话,那么命令行的文件传输命令就显得尤为重要。

如果仅仅会右键另存为,岂不抓瞎?

此时,我们就需要一些命令行的文件传输命令,比如wgetcurl,这两个命令是Linux中最常用的文件传输命令。


超多协议传输的 - curl

Linux curl命令是一款用于从一个server端传输的工具。

很强力,支持众多协议,比如:DICT, FILE, FTP, FTPS, GOPHER, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP, RTSP, SCP, SFTP, SMB, SMBS, SMTP,SMTPS, TELNET 和 TFTP.

说实话,有些协议我也不知道,不过我们只需要知道这个命令设计之初是希望不需要用户的交互和介入,就可以完成数据的传输。

所以这个命令被广泛应用于数据传输、测试、调试和自动化脚本中。

官方定义为:

curl - transfer a URL

语法

1
$ curl [options / URLs]

参数

  • -O : 把输出写到该文件中,保留远程文件的文件名
  • -u : 通过服务端配置的用户名和密码授权访问

默认传输下载文件

默认情况下,将下载的数据写入到文件,并且使用服务器上的名字,这里以下载Linux的内核代码为例。

1
2
3
4
$ curl https://mirrors.edge.kernel.org/pub/linux/kernel/v2.4/linux-2.4.32.tar.gz -O
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
1 36.7M 1 575k 0 0 17431 0 0:36:50 0:00:33 0:36:17 27222

需要授权的网站

部分网站可能需要访问的授权,此时可以使用-u选项提供用户名和密码进行授权:

1
2
$ curl -u username https://www.website.com/
Enter host password for user 'username':

批量下载

当然,这么强力的工具,肯定是支持批量下载的,并且是正则表达式的支持。

比如:ftp://ftp.example.com/的file1,file5和file7,方法如下:

1
$ curl ftp://ftp.example.com/file{1,5,7}.txt

如果下载ftp://ftp.example.com/的从file1到file100的100组文件,方法如下:

1
$ curl ftp://ftp.example.com/file[1-100].txt

非交互的下载工具 wget

Linux系统中的wget是一个下载文件📀的命令行工具,特别普遍 。

对于Linux用户是必不可少的工具,对于经常要下载一些软件或从远程服务器恢复备份到本地服务器,这个命令尤为重要。

wget支持很多协议,比如HTTPHTTPSFTP协议,还可以使用HTTP代理。

wget的有诸多特点,比如

  • 自动下载 wget支持自动下载,即wget可以在用户退出系统的之后在后台执行。这意味着你可以登录系统,启动一个wget下载任务,然后退出系统,wget将在后台执行直到任务完成,这是个牛气冲天的功能。
  • 完全重建 wget 可以跟踪HTML页面上的链接依次下载来创建远程服务器的本地版本,完全重建原始站点的目录结构。这又常被称作”递归下载”。在递归下载的时候,wget 遵循Robot Exclusion标准(/robots.txt). wget可以在下载的同时,将链接转换成指向本地文件,以方便离线浏览。
  • 高稳定 wget 非常稳定,它在带宽很窄的情况下和不稳定网络中有很强的适应性.如果是由于网络的原因下载失败,wget会不断地尝试,直到整个文件下载完毕。如果是服务器打断下载过程,它会再次联到服务器上从停止的地方继续下载。这对从那些限定了链接时间的服务器上下载大文件非常有用。

命令格式

1
$ wget [参数] [URL地址]

用于从网络上下载资源,没有指定目录,下载资源会默认为当前目录。wget虽然功能强大,但是使用起来还是比较简单:

使用范例

wget的命令参数很多,不过常用的为下面几个,详细的可以看进阶。

使用wget下载单个文件

比如,我们下载个Ubuntu的最新版本,试下效果如何

1
$ wget http://releases.ubuntu.com/16.04/ubuntu-16.04-desktop-amd64.iso

在下载的过程中会显示进度条,包含(下载完成百分比,已经下载的字节,当前下载速度,剩余下载时间)。

使用wget -O下载并以不同的文件名保存

这个对于动态链接的下载比较有用,特别是有些文件的名字实在是太……………….长了

1
$ wget -O wordpress.zip http://www.ubuntu.com/download.aspx?id=1234

使用wget -c断点续传

1
2
3
4
5
$ wget -c http://releases.ubuntu.com/16.04/ubuntu-16.04-desktop-amd64.iso

# or

$ wget --continue http://releases.ubuntu.com/16.04/ubuntu-16.04-desktop-amd64.iso

使用wget -c重新启动下载中断的文件,对于我们下载大文件时突然由于网络等原因中断非常有帮助,我们可以继续接着下载而不是重新下载一个文件。需要继续中断的下载时可以使用-c参数。

使用wget -o把下载信息存入日志文件

1
$ wget -o download.log URL

不希望下载信息直接显示在终端而是在一个日志文件,可以使用,特别注意需要与-O来区分开~


路德维格贝梅尔斯曼-玛德琳游马戏团

有趣的探险

克拉菲老师和玛德琳等十二个小女孩儿受西班牙大使的孩子佩皮托邀请,一起去好玩儿的吉普赛马戏团。正当她们在摩天轮上尽情玩耍时,天空下起了瓢泼大雨,大家也乱作一团。当晚,克拉菲老师发现玛德琳不见了,原来玛德琳和佩皮托被遗忘在高高的摩天轮顶端。自此,玛德琳和佩皮托便开始了与吉普赛马戏团的奇遇之旅……

《玛德琳游马戏团》是作者路德维格 贝梅尔曼斯成功出版《玛德琳》之后再次奉献给大家的玛德琳系列作品,也是启发继成功引进、出版《玛德琳》,时隔5年再次推出的玛德琳系列绘本故事。此次路德维格给读者带来的也不仅仅是趣味横生的故事,更是一次开阔眼界的游历。令人思考:我们身边有许多像玛德琳一样的孩子,教她们学会生存技能,认识家庭以外的广阔天地该是多么重要!就让我们跟随玛德琳的身影去认识巴黎,完成一次平面视觉空间的游学吧。

彼得兔的故事-the tale of peter rabbit

历经百年,获奖无数,依旧被世界喜欢的彼得兔。

所有的孩子都应该知道的“彼得兔”。

《比得兔》的创作来自于1893年,波特小姐写给她家庭教师的五岁儿子的信件。
这位家庭老师的儿子长期卧病在床,波特小姐不知道这封信该说些什么,就讲个故事作为这位小男孩的娱乐,并且在故事当中鼓励他。

和我一起玩 play with me

虽然是1955年的绘本,读来还是真挚而怀念。

小女孩走在草地上,陆续邀请小动物和她一起玩,可是每当她提出邀请时,动物们却都离开了,直到她静静地坐在石头上,令人意外的事情发生了……小动物们又回来了!

静观万物的纯真童年

玛德琳-Madeline

巴黎有一栋爬满了藤萝的老房子,住着十二个小女孩。
她们常常排成两排吃面包、刷牙、上床睡觉。
女孩当中个子最小的一个,名叫玛德琳。
她不怕老鼠,喜欢冬天、下雪和在冰上跳舞,在动物园的老虎面前,轻轻松松地说:“喵!”过桥时,她还敢一个人走在桥沿儿上。
她们的老师是修女克拉菲。

有一天半夜她觉得不对劲,小不点玛德琳坐在床上哭啊哭。
医生来了一看,是盲肠炎,打电话叫来了救护车。两个小时以后,玛德琳在摆了花的房间里醒过来。没多久,她就能吃能喝了。
她的床还可以摇上摇下,天花板的裂痕看上去像一只兔子。
窗外有鸟儿、树木和天空。十天很快就过去了。
在一个美好的早晨,克拉菲老师领女孩们来探望玛德琳,她们一人手上拿着一朵花。
一进门,看到房间里有那么多玩具和糖果,都啊的一声叫了起来。
最让她们吃惊的,还是玛德琳肚子上有一道疤!这天夜里,克拉菲老师又觉得有点不对劲。

她担心发生了什么大灾难:“告诉我,你们怎么了?”所有的女孩都哭着说:“呜呜呜……我们也要割盲肠!”