教程_教程 火鸟门户 - CSDN
  • 单片机20个实例超详细图文教程

    千次下载 热门讨论 2020-07-25 23:33:35
    非常有用,值得收藏 单片机20个实例超详细图文教程
  • Qt 4.8.4下载以及傻瓜式安装教程

    千次下载 热门讨论 2020-07-29 14:20:58
    Qt4.8.4已经是Qt4的最后一个版本,本资源是一个安装教程word文档,但是里面有一个压缩包的下载地址,这个压缩包里面有三个东西,Qt4.8.4库包,QtCreator2.5,MinGW编译器。 在网上许多教程都是说得不清不楚的,所以...
  • 大数据Spark实战视频教程

    万人学习 2019-12-19 12:46:49
    大数据Spark实战视频培训教程:本课程内容涉及,Spark虚拟机安装、Spark表配置、平台搭建、快学Scala入门、Spark集群通信、任务调度、持久化等实战内容。Spark是UC Berkeley AMP lab (加州大学伯克利分校的AMP实验室...
  • Python全栈视频教程

    万人学习 2019-10-30 14:39:55
    Python全栈视频培训教程,帮助开发者从零到一入门python:1.深入理解python语法机制与底层原理,2.深入实战python各种案例 , 3.语音识别,图形界面,多线程爬虫,语音合成,游戏控制等等精彩案例。
  • Git使用详细教程

    万次阅读 多人点赞 2019-01-29 09:14:13
    一:Git是什么?  Git是目前世界上最先进的分布式版本控制系统。  二:SVN与Git的最主要的区别?  SVN是集中式版本控制系统,版本库是集中放在中央服务器的,而干活的时候,用的都是自己的电脑,所以首先要从...

    一:Git是什么?

      Git是目前世界上最先进的分布式版本控制系统。

      二:SVN与Git的最主要的区别?

      SVN是集中式版本控制系统,版本库是集中放在中央服务器的,而干活的时候,用的都是自己的电脑,所以首先要从中央服务器哪里得到最新的版本,然后干活,干完后,需要把自己做完的活推送到中央服务器。集中式版本控制系统是必须联网才能工作,如果在局域网还可以,带宽够大,速度够快,如果在互联网下,如果网速慢的话,就纳闷了。

      Git是分布式版本控制系统,那么它就没有中央服务器的,每个人的电脑就是一个完整的版本库,这样,工作的时候就不需要联网了,因为版本都是在自己的电脑上。既然每个人的电脑都有一个完整的版本库,那多个人如何协作呢?比如说自己在电脑上改了文件A,其他人也在电脑上改了文件A,这时,你们两之间只需把各自的修改推送给对方,就可以互相看到对方的修改了。

      三:在windows上如何安装Git?

      msysgit是 windows版的Git,如下:

         

      需要从网上下载一个,然后进行默认安装即可。安装完成后,在开始菜单里面找到 "Git --> Git Bash",如下:

      

      会弹出一个类似的命令窗口的东西,就说明Git安装成功。如下:

     

      安装完成后,还需要最后一步设置,在命令行输入如下:

     

      因为Git是分布式版本控制系统,所以需要填写用户名和邮箱作为一个标识。

      注意:git config  --global 参数,有了这个参数,表示你这台机器上所有的Git仓库都会使用这个配置,当然你也可以对某个仓库指定的不同的用户名和邮箱。

      四:如何操作?

      一:创建版本库。

      什么是版本库?版本库又名仓库,英文名repository,你可以简单的理解一个目录,这个目录里面的所有文件都可以被Git管理起来,每个文件的修改,删除,Git都能跟踪,以便任何时刻都可以追踪历史,或者在将来某个时刻还可以将文件”还原”。

      所以创建一个版本库也非常简单,如下我是D盘 –> www下 目录下新建一个testgit版本库。

       

      pwd 命令是用于显示当前的目录。

      1. 通过命令 git init 把这个目录变成git可以管理的仓库,如下:

          

      这时候你当前testgit目录下会多了一个.git的目录,这个目录是Git来跟踪管理版本的,没事千万不要手动乱改这个目录里面的文件,否则,会把git仓库给破坏了。如下:

        

      2. 把文件添加到版本库中。

      首先要明确下,所有的版本控制系统,只能跟踪文本文件的改动,比如txt文件,网页,所有程序的代码等,Git也不列外,版本控制系统可以告诉你每次的改动,但是图片,视频这些二进制文件,虽能也能由版本控制系统管理,但没法跟踪文件的变化,只能把二进制文件每次改动串起来,也就是知道图片从1kb变成2kb,但是到底改了啥,版本控制也不知道。

      下面先看下demo如下演示:

      我在版本库testgit目录下新建一个记事本文件 readme.txt 内容如下:11111111

      第一步:使用命令 git add readme.txt添加到暂存区里面去。如下:

        

      如果和上面一样,没有任何提示,说明已经添加成功了。

      第二步:用命令 git commit告诉Git,把文件提交到仓库。

       

      现在我们已经提交了一个readme.txt文件了,我们下面可以通过命令git status来查看是否还有文件未提交,如下:

      

      说明没有任何文件未提交,但是我现在继续来改下readme.txt内容,比如我在下面添加一行2222222222内容,继续使用git status来查看下结果,如下:

     

      上面的命令告诉我们 readme.txt文件已被修改,但是未被提交的修改。

      接下来我想看下readme.txt文件到底改了什么内容,如何查看呢?可以使用如下命令:

      git diff readme.txt 如下:

     

      如上可以看到,readme.txt文件内容从一行11111111改成 二行 添加了一行22222222内容。

      知道了对readme.txt文件做了什么修改后,我们可以放心的提交到仓库了,提交修改和提交文件是一样的2步(第一步是git add  第二步是:git commit)。

      如下:

     

      二:版本回退:

      如上,我们已经学会了修改文件,现在我继续对readme.txt文件进行修改,再增加一行

      内容为33333333333333.继续执行命令如下:

       

      现在我已经对readme.txt文件做了三次修改了,那么我现在想查看下历史记录,如何查呢?我们现在可以使用命令 git log 演示如下所示:

      

      git log命令显示从最近到最远的显示日志,我们可以看到最近三次提交,最近的一次是,增加内容为333333.上一次是添加内容222222,第一次默认是 111111.如果嫌上面显示的信息太多的话,我们可以使用命令 git log –pretty=oneline 演示如下:

      

      现在我想使用版本回退操作,我想把当前的版本回退到上一个版本,要使用什么命令呢?可以使用如下2种命令,第一种是:git reset  --hard HEAD^ 那么如果要回退到上上个版本只需把HEAD^ 改成 HEAD^^ 以此类推。那如果要回退到前100个版本的话,使用上面的方法肯定不方便,我们可以使用下面的简便命令操作:git reset  --hard HEAD~100 即可。未回退之前的readme.txt内容如下:

      

      如果想回退到上一个版本的命令如下操作:

      再来查看下 readme.txt内容如下:通过命令cat readme.txt查看

      可以看到,内容已经回退到上一个版本了。我们可以继续使用git log 来查看下历史记录信息,如下:

      我们看到 增加333333 内容我们没有看到了,但是现在我想回退到最新的版本,如:有333333的内容要如何恢复呢?我们可以通过版本号回退,使用命令方法如下:

      git reset  --hard 版本号 ,但是现在的问题假如我已经关掉过一次命令行或者333内容的版本号我并不知道呢?要如何知道增加3333内容的版本号呢?可以通过如下命令即可获取到版本号:git reflog  演示如下:

      通过上面的显示我们可以知道,增加内容3333的版本号是 6fcfc89.我们现在可以命令

      git reset  --hard 6fcfc89来恢复了。演示如下:

      可以看到 目前已经是最新的版本了。 

      三:理解工作区与暂存区的区别?

      工作区:就是你在电脑上看到的目录,比如目录下testgit里的文件(.git隐藏目录版本库除外)。或者以后需要再新建的目录文件等等都属于工作区范畴。

      版本库(Repository):工作区有一个隐藏目录.git,这个不属于工作区,这是版本库。其中版本库里面存了很多东西,其中最重要的就是stage(暂存区),还有Git为我们自动创建了第一个分支master,以及指向master的一个指针HEAD。

      我们前面说过使用Git提交文件到版本库有两步:

      第一步:是使用 git add 把文件添加进去,实际上就是把文件添加到暂存区。

      第二步:使用git commit提交更改,实际上就是把暂存区的所有内容提交到当前分支上。

      我们继续使用demo来演示下:

      我们在readme.txt再添加一行内容为4444444,接着在目录下新建一个文件为test.txt 内容为test,我们先用命令 git status来查看下状态,如下:

      现在我们先使用git add 命令把2个文件都添加到暂存区中,再使用git status来查看下状态,如下:

      接着我们可以使用git commit一次性提交到分支上,如下:

     

      四:Git撤销修改和删除文件操作。

      一:撤销修改:

      比如我现在在readme.txt文件里面增加一行 内容为555555555555,我们先通过命令查看如下:

      在我未提交之前,我发现添加5555555555555内容有误,所以我得马上恢复以前的版本,现在我可以有如下几种方法可以做修改:

      第一:如果我知道要删掉那些内容的话,直接手动更改去掉那些需要的文件,然后add添加到暂存区,最后commit掉。

      第二:我可以按以前的方法直接恢复到上一个版本。使用 git reset  --hard HEAD^

      但是现在我不想使用上面的2种方法,我想直接想使用撤销命令该如何操作呢?首先在做撤销之前,我们可以先用 git status 查看下当前的状态。如下所示:

      可以发现,Git会告诉你,git checkout  -- file 可以丢弃工作区的修改,如下命令:

      git checkout  --  readme.txt,如下所示:

      命令 git checkout --readme.txt 意思就是,把readme.txt文件在工作区做的修改全部撤销,这里有2种情况,如下:

    1. readme.txt自动修改后,还没有放到暂存区,使用 撤销修改就回到和版本库一模一样的状态。
    2. 另外一种是readme.txt已经放入暂存区了,接着又作了修改,撤销修改就回到添加暂存区后的状态。

      对于第二种情况,我想我们继续做demo来看下,假如现在我对readme.txt添加一行 内容为6666666666666,我git add 增加到暂存区后,接着添加内容7777777,我想通过撤销命令让其回到暂存区后的状态。如下所示:

      

      注意:命令git checkout -- readme.txt 中的 -- 很重要,如果没有 -- 的话,那么命令变成创建分支了。

      二:删除文件。

      假如我现在版本库testgit目录添加一个文件b.txt,然后提交。如下:

      

      如上:一般情况下,可以直接在文件目录中把文件删了,或者使用如上rm命令:rm b.txt ,如果我想彻底从版本库中删掉了此文件的话,可以再执行commit命令 提交掉,现在目录是这样的,

     

      只要没有commit之前,如果我想在版本库中恢复此文件如何操作呢?

      可以使用如下命令 git checkout  -- b.txt,如下所示:

      再来看看我们testgit目录,添加了3个文件了。如下所示:

     

      五:远程仓库。

      在了解之前,先注册github账号,由于你的本地Git仓库和github仓库之间的传输是通过SSH加密的,所以需要一点设置:

      第一步:创建SSH Key。在用户主目录下,看看有没有.ssh目录,如果有,再看看这个目录下有没有id_rsa和id_rsa.pub这两个文件,如果有的话,直接跳过此如下命令,如果没有的话,打开命令行,输入如下命令:

      ssh-keygen  -t rsa –C “youremail@example.com”, 由于我本地此前运行过一次,所以本地有,如下所示:

     

      id_rsa是私钥,不能泄露出去,id_rsa.pub是公钥,可以放心地告诉任何人。

      第二步:登录github,打开” settings”中的SSH Keys页面,然后点击“Add SSH Key”,填上任意title,在Key文本框里黏贴id_rsa.pub文件的内容。

      点击 Add Key,你就应该可以看到已经添加的key。

    1. 如何添加远程库?

      现在的情景是:我们已经在本地创建了一个Git仓库后,又想在github创建一个Git仓库,并且希望这两个仓库进行远程同步,这样github的仓库可以作为备份,又可以其他人通过该仓库来协作。

      首先,登录github上,然后在右上角找到“create a new repo”创建一个新的仓库。如下:

      在Repository name填入testgit,其他保持默认设置,点击“Create repository”按钮,就成功地创建了一个新的Git仓库:

      目前,在GitHub上的这个testgit仓库还是空的,GitHub告诉我们,可以从这个仓库克隆出新的仓库,也可以把一个已有的本地仓库与之关联,然后,把本地仓库的内容推送到GitHub仓库。

      现在,我们根据GitHub的提示,在本地的testgit仓库下运行命令:

      git remote add origin https://github.com/tugenhua0707/testgit.git

      所有的如下:

      

      把本地库的内容推送到远程,使用 git push命令,实际上是把当前分支master推送到远程。

      由于远程库是空的,我们第一次推送master分支时,加上了 –u参数,Git不但会把本地的master分支内容推送的远程新的master分支,还会把本地的master分支和远程的master分支关联起来,在以后的推送或者拉取时就可以简化命令。推送成功后,可以立刻在github页面中看到远程库的内容已经和本地一模一样了,上面的要输入github的用户名和密码如下所示:

      从现在起,只要本地作了提交,就可以通过如下命令:

      git push origin master

      把本地master分支的最新修改推送到github上了,现在你就拥有了真正的分布式版本库了。

      2. 如何从远程库克隆?

      上面我们了解了先有本地库,后有远程库时候,如何关联远程库。

      现在我们想,假如远程库有新的内容了,我想克隆到本地来 如何克隆呢?

      首先,登录github,创建一个新的仓库,名字叫testgit2.如下:

      如下,我们看到:

      现在,远程库已经准备好了,下一步是使用命令git clone克隆一个本地库了。如下所示:

      接着在我本地目录下 生成testgit2目录了,如下所示:

      六:创建与合并分支。

      在版本回填退里,你已经知道,每次提交,Git都把它们串成一条时间线,这条时间线就是一个分支。截止到目前,只有一条时间线,在Git里,这个分支叫主分支,即master分支。HEAD严格来说不是指向提交,而是指向master,master才是指向提交的,所以,HEAD指向的就是当前分支。

      首先,我们来创建dev分支,然后切换到dev分支上。如下操作:

     

      git checkout 命令加上 –b参数表示创建并切换,相当于如下2条命令

      git branch dev

      git checkout dev

      git branch查看分支,会列出所有的分支,当前分支前面会添加一个星号。然后我们在dev分支上继续做demo,比如我们现在在readme.txt再增加一行 7777777777777

      首先我们先来查看下readme.txt内容,接着添加内容77777777,如下:

      现在dev分支工作已完成,现在我们切换到主分支master上,继续查看readme.txt内容如下:

      现在我们可以把dev分支上的内容合并到分支master上了,可以在master分支上,使用如下命令 git merge dev 如下所示:

      git merge命令用于合并指定分支到当前分支上,合并后,再查看readme.txt内容,可以看到,和dev分支最新提交的是完全一样的。

      注意到上面的Fast-forward信息,Git告诉我们,这次合并是“快进模式”,也就是直接把master指向dev的当前提交,所以合并速度非常快。

      合并完成后,我们可以接着删除dev分支了,操作如下:

      总结创建与合并分支命令如下:

      查看分支:git branch

      创建分支:git branch name

      切换分支:git checkout name

      创建+切换分支:git checkout –b name

      合并某分支到当前分支:git merge name

      删除分支:git branch –d name

    1. 如何解决冲突?

      下面我们还是一步一步来,先新建一个新分支,比如名字叫fenzhi1,在readme.txt添加一行内容8888888,然后提交,如下所示:

      同样,我们现在切换到master分支上来,也在最后一行添加内容,内容为99999999,如下所示:

      现在我们需要在master分支上来合并fenzhi1,如下操作:

      Git用<<<<<<<,=======,>>>>>>>标记出不同分支的内容,其中<<<HEAD是指主分支修改的内容,>>>>>fenzhi1 是指fenzhi1上修改的内容,我们可以修改下如下后保存:

      如果我想查看分支合并的情况的话,需要使用命令 git log.命令行演示如下:

      3.分支管理策略。

      通常合并分支时,git一般使用”Fast forward”模式,在这种模式下,删除分支后,会丢掉分支信息,现在我们来使用带参数 –no-ff来禁用”Fast forward”模式。首先我们来做demo演示下:

    1. 创建一个dev分支。
    2. 修改readme.txt内容。
    3. 添加到暂存区。
    4. 切换回主分支(master)。
    5. 合并dev分支,使用命令 git merge –no-ff  -m “注释” dev
    6. 查看历史记录

      截图如下:

     

      分支策略:首先master主分支应该是非常稳定的,也就是用来发布新版本,一般情况下不允许在上面干活,干活一般情况下在新建的dev分支上干活,干完后,比如上要发布,或者说dev分支代码稳定后可以合并到主分支master上来。

      七:bug分支:

      在开发中,会经常碰到bug问题,那么有了bug就需要修复,在Git中,分支是很强大的,每个bug都可以通过一个临时分支来修复,修复完成后,合并分支,然后将临时的分支删除掉。

      比如我在开发中接到一个404 bug时候,我们可以创建一个404分支来修复它,但是,当前的dev分支上的工作还没有提交。比如如下:

     

      并不是我不想提交,而是工作进行到一半时候,我们还无法提交,比如我这个分支bug要2天完成,但是我issue-404 bug需要5个小时内完成。怎么办呢?还好,Git还提供了一个stash功能,可以把当前工作现场 ”隐藏起来”,等以后恢复现场后继续工作。如下:

      

      所以现在我可以通过创建issue-404分支来修复bug了。

      首先我们要确定在那个分支上修复bug,比如我现在是在主分支master上来修复的,现在我要在master分支上创建一个临时分支,演示如下:

     

      修复完成后,切换到master分支上,并完成合并,最后删除issue-404分支。演示如下:

      现在,我们回到dev分支上干活了。

      工作区是干净的,那么我们工作现场去哪里呢?我们可以使用命令 git stash list来查看下。如下:

      工作现场还在,Git把stash内容存在某个地方了,但是需要恢复一下,可以使用如下2个方法:

    1. git stash apply恢复,恢复后,stash内容并不删除,你需要使用命令git stash drop来删除。
    2. 另一种方式是使用git stash pop,恢复的同时把stash内容也删除了。

      演示如下

      八:多人协作。

      当你从远程库克隆时候,实际上Git自动把本地的master分支和远程的master分支对应起来了,并且远程库的默认名称是origin。

    1. 要查看远程库的信息 使用 git remote
    2. 要查看远程库的详细信息 使用 git remote –v

      如下演示:

     

      一:推送分支:

          推送分支就是把该分支上所有本地提交到远程库中,推送时,要指定本地分支,这样,Git就会把该分支推送到远程库对应的远程分支上:

          使用命令 git push origin master

      比如我现在的github上的readme.txt代码如下:

      本地的readme.txt代码如下:

     

      现在我想把本地更新的readme.txt代码推送到远程库中,使用命令如下:

      我们可以看到如上,推送成功,我们可以继续来截图github上的readme.txt内容 如下:

      可以看到 推送成功了,如果我们现在要推送到其他分支,比如dev分支上,我们还是那个命令 git push origin dev

      那么一般情况下,那些分支要推送呢?

    1. master分支是主分支,因此要时刻与远程同步。
    2. 一些修复bug分支不需要推送到远程去,可以先合并到主分支上,然后把主分支master推送到远程去。

      二:抓取分支:

      多人协作时,大家都会往master分支上推送各自的修改。现在我们可以模拟另外一个同事,可以在另一台电脑上(注意要把SSH key添加到github上)或者同一台电脑上另外一个目录克隆,新建一个目录名字叫testgit2

      但是我首先要把dev分支也要推送到远程去,如下

      接着进入testgit2目录,进行克隆远程的库到本地来,如下:

     

      现在目录下生成有如下所示:

      现在我们的小伙伴要在dev分支上做开发,就必须把远程的origin的dev分支到本地来,于是可以使用命令创建本地dev分支:git checkout  –b dev origin/dev

      现在小伙伴们就可以在dev分支上做开发了,开发完成后把dev分支推送到远程库时。

      如下:

      小伙伴们已经向origin/dev分支上推送了提交,而我在我的目录文件下也对同样的文件同个地方作了修改,也试图推送到远程库时,如下:

      由上面可知:推送失败,因为我的小伙伴最新提交的和我试图推送的有冲突,解决的办法也很简单,上面已经提示我们,先用git pull把最新的提交从origin/dev抓下来,然后在本地合并,解决冲突,再推送。

      git pull也失败了,原因是没有指定本地dev分支与远程origin/dev分支的链接,根据提示,设置dev和origin/dev的链接:如下:

      这回git pull成功,但是合并有冲突,需要手动解决,解决的方法和分支管理中的 解决冲突完全一样。解决后,提交,再push:

      我们可以先来看看readme.txt内容了。

      现在手动已经解决完了,我接在需要再提交,再push到远程库里面去。如下所示:

      因此:多人协作工作模式一般是这样的:

    1. 首先,可以试图用git push origin branch-name推送自己的修改.
    2. 如果推送失败,则因为远程分支比你的本地更新早,需要先用git pull试图合并。
    3. 如果合并有冲突,则需要解决冲突,并在本地提交。再用git push origin branch-name推送。

      Git基本常用命令如下:

      mkdir:         XX (创建一个空目录 XX指目录名)

      pwd:          显示当前目录的路径。

      git init          把当前的目录变成可以管理的git仓库,生成隐藏.git文件。

      git add XX       把xx文件添加到暂存区去。

      git commit –m “XX”  提交文件 –m 后面的是注释。

      git status        查看仓库状态

      git diff  XX      查看XX文件修改了那些内容

      git log          查看历史记录

      git reset  --hard HEAD^ 或者 git reset  --hard HEAD~ 回退到上一个版本

      (如果想回退到100个版本,使用git reset –hard HEAD~100 )

      cat XX         查看XX文件内容

      git reflog       查看历史记录的版本号id

      git checkout -- XX  把XX文件在工作区的修改全部撤销。

      git rm XX          删除XX文件

      git remote add origin https://github.com/tugenhua0707/testgit 关联一个远程库

      git push –u(第一次要用-u 以后不需要) origin master 把当前master分支推送到远程库

      git clone https://github.com/tugenhua0707/testgit  从远程库中克隆

      git checkout –b dev  创建dev分支 并切换到dev分支上

      git branch  查看当前所有的分支

      git checkout master 切换回master分支

      git merge dev    在当前的分支上合并dev分支

      git branch –d dev 删除dev分支

      git branch name  创建分支

      git stash 把当前的工作隐藏起来 等以后恢复现场后继续工作

      git stash list 查看所有被隐藏的文件列表

      git stash apply 恢复被隐藏的文件,但是内容不删除

      git stash drop 删除文件

      git stash pop 恢复文件的同时 也删除文件

      git remote 查看远程库的信息

      git remote –v 查看远程库的详细信息

      git push origin master  Git会把master分支推送到远程库对应的远程分支上

    原文地址:http://www.imooc.com/article/20411

     

    展开全文
  • Grafana使用教程

    万次阅读 多人点赞 2018-10-09 17:05:30
    Grafana是一个开源的度量分析与可视化套件。经常被用作基础设施的时间序列数据和应用程序分析的可视化,它在其他领域也被广泛的使用包括工业传感器、家庭自动化、天气和过程控制等。 Grafana支持许多不同的数据源。...

    Grafana是一个开源的度量分析与可视化套件。经常被用作基础设施的时间序列数据和应用程序分析的可视化,它在其他领域也被广泛的使用包括工业传感器、家庭自动化、天气和过程控制等。

    Grafana支持许多不同的数据源。每个数据源都有一个特定的查询编辑器,该编辑器定制的特性和功能是公开的特定数据来源。

     官方支持以下数据源:Graphite,InfluxDB,OpenTSDB,Prometheus,Elasticsearch,CloudWatch和KairosDB。

    每个数据源的查询语言和能力都是不同的。你可以把来自多个数据源的数据组合到一个仪表板,但每一个面板被绑定到一个特定的数据源,它就属于一个特定的组织。下面我们来一起感受一下grafana。

    1、登录grafana 界面

        http://192.168.21.250:3000 默认用户和密码均为admin

    2、配置Grafana启用zabbix插件

        登录到grafana,移动鼠标到grafana左上角,单击选择齿轮图标的向下按钮,然后选择“Zabbix”选项卡,选择“Pluugin Config”,打开Zabbix 插件配置对话框,选择启用zabbix插件。

        具体操作步骤如下图所示:

     

     

     

    3、配置Zabbix数据源

        添加新数据源,单击选择齿轮图标的向下按钮,打开 “Data Sources”

    ,单击“Add new”。

     

    注意红线标注的地方

        Name自定义

        Type选择Zabbix

        Http settings URL填入http://zabbix服务器ip/zabbix/api_jsonrpc.php

        Zabbix details用户名和密码需要在Zabbix web页面中设置,本文中用户名:admin,密码:zabbix。如不想新建的话,可以使用zabbix的初始用户。

        配置过程如下图所示:

        设置完成点击Save & Test按钮,弹出下图所示的Success提示对话框:

     

    本文档的Zabbix版本为Zabbix-3.0.5,详细配置教程请参考官方文档:

    http://docs.grafana-zabbix.org/installation/configuration

    常见错误解决请参考:http://docs.grafana.org/installation/troubleshooting/

    4、开始使用Grafana-Zabbix

    添加新的仪表板

        让我们开始创建一个新的仪表板。添加新的仪表板过程如下所示:

     

     

    在新建的仪表板中添加图面板

     

        图面板在Grafana中只是命名图。它提供了一组丰富的图形选项。如下图所示:

        单击标题面板可打开一个菜单框。单击edit 选项面板将会打开额外的配置选项。

    如下图所示:

     

    Graph里面的选项有:

        General(常规选择)、Metrics(指标)、Axes(坐标轴)、Legend(图例)、 Display(显示样式)、Time range(时间范围)

    Genera(常规选择):添加图形标题,图形宽度高度等

        Title:仪表板上的面板标题

        Span:列在面板中的宽度

        Height:面板内容高度(以像素为单位)

     

    钻取/详细信息链接(Drilldown / detail link)

        钻取部分允许添加动态面板的链接,可以链接到其他仪表板或URL。

        每个链接都有一个标题,一个类型和参数。链接可以是 dashboard或 absolute链接。如果它是一个仪表板链接, dashboard值必须是一个仪表板的名字。如果这是一个 absolute链接,是URL链接的URL。

        params允许添加额外的URL参数的链接。格式是 name=value与多个参数分开,当链接到另一个仪表板使用模板变量,你可以使用 var-myvar=value填充模板变量的期望值链接。

     

    Metrics(指标)

        定义了来源数据的呈现,每个数据源都提供不同的选择。面板的来源数据通过group,host,application,item从zabbix中获得。

     

    Axes(坐标轴)

        用于坐标轴和网格的显示方式,包括单位,比例,标签等。

    Left Y和 Right Y可以定制使用,因其中的可选参数太多,怕描述不准确。所以请在使用的时候参考官方文档

    Legend(图例):图例展示

        图例的参数:

        Total:返回所有度量查询值的总和

        Current:返回度量查询的最后一个值

        Min:返回最小的度量查询值

        Max:返回最大的度量查询值

        Avg:返回所有度量查询的平均值

        Decimals:控制Legend值的多少,以小数显示悬浮工具提示(图)

        Grafana 中Legend值的计算取决于你使用的度量查询方式和什么样类型的聚合或合并点来实现的,所有上述所说的值在同一时间可能都是不正确的。例如,如果你是每秒请求一次,这可能是使用平均值来作为一个整合,然而这个Legend值不会代表请求的总数。这只是Grafana收到的所有数据点的总和。

     

    Display(显示样式)

        显示样式的控件属性图如下:

    图表模式(Draw Modes)

    Bar:一个条形图显示值

    Lines:显示线图值

     Points:显示点值

    选择模式(Mode Options)

    Fill:系列的颜色填充,0是没有。

    Line Width:线的宽度。

     Staircase:楼梯状显示。

        如果有多个选择项,它们可以作为一个群体显示。

    叠加和空值(Stacking & Null value)

    Stack:每个系列是叠在另一个之上

    Null value:空值

        如果你启用了堆栈可以选择应该显示鼠标悬停功能。

    Time range(时间范围)

     

    顶级头介绍

     

    上图显示了仪表板顶部的标题。

        1.侧菜单切换:切换菜单,让你专注于仪表板中给出的数据。侧菜单提供了访问特性,仪表板,用户,组织和数据源等。

        2.仪表板下拉菜单:下拉菜单显示你当前浏览的仪表板,并允许轻松地切换到另一个新的仪表板。在这里你还可以创建一个新的仪表板,导入现有的仪表板和管理仪表板播放列表。

        3.星仪表板:星(或unstar)当前的仪表板。默认情况下星仪表板将出现在自己建立的仪表板里,为你提供快捷的查看途径。

        4.仪表板分享:通过创建一个链接或创建一个静态快照分享当前仪表板。

        5.保存仪表板:以当前仪表板的名字保存。

        6.设置:管理仪表板的设置和特性,比如模板和注释。

    5、创建流量监控图形

     

     

     

     

    6、仪表盘模板功能

        单纯的手动去添加一个个监控图,只能显示一个主机的所有监控图形,若要查看不同主机的所有监控图形,就要通过变量的方式去实现。我们要设置的变量包括group,host,application和iteam。

    模板

        仪表盘模板可以让你创建一个交互式和动态性的仪表板,它是Grafana里面最强大的、最常用的功能之一。创建的仪表盘模板参数,可以在任何一个仪表盘中使用。

    创建变量

        点击顶部导航栏上的齿轮图标,选择模板。

       单击新建按钮,你会看到模板变量编辑器。它包含以下部分:

    变量(Variable)

    命名:变量的名称。

    标签:可见标签变量。例如,主机组,而不是HOST_GROUP。

    类型:查询类型选择。

        图中有五种变量类型: query,custom,interval,Data source和Contsta。它们都可以用来创建动态变量,不同之处在于获得的数据值不一样。

    查询选项(Query Options)

    数据源:用于查询变量值的数据源。

    刷新:更新此变量的值。

    查询:查询字符串。 

    正则表达式:如果你需要筛选值或提取价值的一部分,那就使用正则表达式。

    选择选项(Selection Options)

    多值:启用,如果你想在同一时间选择多个值。

    数值组/标签(实验功能)(Value groups/tags (Experimental feature))

    7、查询格式

       zabbix模板变量数据源查询是一个包含了4个部分的以.号隔开的字符串{host group}.{host}.{application}.{item name}。例如, Zabbix servers.Zabbix server.CPU.*。

       例子:

       * 返回所有可用主机组

       *.* 返回主机组里所有可用主机

       Servers.*返回服务器组里的所有主机

       Linux servers.*.* 返回Linux服务器组中的所有应用程序

       Linux servers.*.*.* 返回Linux服务器组中所有主机的监控项。

       你可以使用另一个变量作为查询的一部分。例如,你有一个变量组,它返回的是主机组的列表,并仅希望将其用于在选定的组在查询主机。下面是这种情况的查询条件:

       $group.*

    8、变量的使用

        当你创建一个变量,你可以使用它作为一个数据源查询的一部分。Grafana还支持变量在不同的地方被使用,比如面板和行标题、文本面板的内容等。

     

        注意,你需要在变量的名字之前添加$标志。

    创建模板

     

     

       添加变量group,host,Application,iteam


        添加完四个变量,如下图所示:

        group匹配的显示结果

       变量添加完成后,就可以设置图形属性了。将之前所有添加的图形用下面的group,host,application,iteam变量来表示。

        这样我们就可以通过切换,来查看不同主机的所有监控内容 

        下图是通过仪表盘功能在一个页面中用多个graph显示多台机器的网卡流量。

        下图是在仪表盘中使用模板功能在一个页面中用一个graph显示单台机器或所有机器的单个监控项或所有监控项。

     

     

        这个仪表盘模板是在一个页面中用多个graph显示单台机器的多个监控项

    展开全文
  • 一篇实用的Latex的入门教程

    万次阅读 多人点赞 2018-08-07 16:26:39
    LaTeX新人教程,一小时从完全陌生到基本入门 作者 : 董楠   LaTeX新人教程,一小时从完全陌生到基本入门 by Nan   对于真心渴望迅速上手LaTeX的人,可以只看正文。 曾经在缝缝补补中变得长长的“前言”被我...

    转载

    LaTeX新人教程,一小时从完全陌生到基本入门

    作者 : 董楠

     

    LaTeX新人教程,一小时从完全陌生到基本入门

    by Nan

     

    对于真心渴望迅速上手LaTeX的人,可以只看正文。

    曾经在缝缝补补中变得长长的“前言”被我丢到了正文后面当“后记”。

    后记部分可以跳过不看或只看粗体。

    原本这个版本的流程内容是30分钟。

    后来应小伙伴呼声,加入了图片引用、公式引用和参考文献内容。

    因此如果要走完这个流程的话,大致需要一个小时。

     

    =============================================

    下面是教程正文。(正文最后应大家要求增添了附录)

    注:文章里的代码我自己测试是可以直接复制进winedt编译成功的。但是有朋友反馈说编译不成功,检查后的结果大概是在人人网发帖的时候,人人网自己神奇的排版系统自主“智能”增添了一些换行符制表符类似物。因此如果直接复制编译不成功的时候,请尝试手打一遍。代码内容已经十分精简,相信手打起来也不会有太大压力。

     

    1.LaTeX软件的安装和使用 
    方法A(自助):在MikTeX的官网下载免费的MikTeX编译包(150Mb)并安装。下载WinEdt(9.5Mb)(收费)或TexMaker(32Mb)(免费)等编辑界面软件并安装。 
    方法B(打包):在ctex.org下载ctex套装(203Mb或1.3Gb)(含MikTeX及WinEdt)

    哈哈这一部分当然不包含在标题的一小时里。

    新人不必纠结软件问题,随便什么软件随便什么版本只要下载下来能编译出pdf来就可以,先下载了装上来试试再说。我推荐winedt也是方便我在介绍按钮样子的时候可以统一描述。在真正开始跑步之前没有必要纠结该买NIKE跑鞋还是ADI跑鞋,跑起来再说。不要瞻前顾后,just try it.



    2.第一个文档 
    打开WinEdt,建立一个新文档,将以下内容复制进入文档中,保存,保存类型选择为UTF-8。 

    \documentclass{article} 
    \begin{document} 
       hello, world 
    \end{document} 

    然后在WinEdt的工具栏中找到编译按钮(在垃圾桶和字母B中间),在下拉菜单中选择XeLaTeX,并点击编译。 (这里请注意一下我之前一直笔误写的XeTeX,给大家带来困扰深感歉意)
    如果顺利的话,我们就可以顺利生成出第一个pdf文件,点击工具栏中的放大镜按钮就可以快速打开生成的pdf文件。 


    3.标题、作者和注释 
    建立一个新文档,将以下内容复制进入文档中,保存,保存类型选择为UTF-8,编译并观察现象。 

    \documentclass{article} 
       \author{My Name} 
       \title{The Title} 
    \begin{document} 
       \maketitle 
       hello, world % This is comment 
    \end{document}

    %为本行右边所有内容被注释掉,在生成的pdf中不会显示。

    块注释也有专门的语句,不过更方便的方式是选中一块区域点鼠标右键,点comment 


    4.章节和段落 
    建立一个新文档,将以下内容复制进入文档中,保存,保存类型选择为UTF-8,编译并观察现象。 

    \documentclass{article} 
       \title{Hello World} 
    \begin{document} 
       \maketitle 
       \section{Hello China} China is in East Asia. 
         \subsection{Hello Beijing} Beijing is the capital of China. 
           \subsubsection{Hello Dongcheng District} 
             \paragraph{Tian'anmen Square}is in the center of Beijing 
               \subparagraph{Chairman Mao} is in the center of Tian'anmen Square 
           \subsection{Hello Guangzhou} 
             \paragraph{Sun Yat-sen University} is the best university in Guangzhou. 
    \end{document} 

    退格只是我个人偏好,看起来层次清晰美观。实际操作上未必要如此,每一行之前的空格不影响编译生成PDF的排版结果。 


    5.加入目录 
    建立一个新文档,将以下内容复制进入文档中,保存,保存类型选择为UTF-8,编译并观察现象。 

    \documentclass{article} 
    \begin{document} 
       \tableofcontents 
       \section{Hello China} China is in East Asia. 
         \subsection{Hello Beijing} Beijing is the capital of China. 
           \subsubsection{Hello Dongcheng District} 
             \paragraph{Hello Tian'anmen Square}is in the center of Beijing 
               \subparagraph{Hello Chairman Mao} is in the center of Tian'anmen Square 
    \end{document} 

    6.换行 
    建立一个新文档,将以下内容复制进入文档中,保存,保存类型选择为UTF-8,编译并观察对比现象。 
    \documentclass{article} 
    \begin{document} 
       Beijing is 
       the capital 
       of China. 

      Washington is 

       the capital 

       of America. 

       Amsterdam is \\ the capital \\ 
       of the Netherlands. 
    \end{document}

    空一行为另起一段,\\为段内强制换行。

    我对之前手滑写出New York is the capital of America这类低级错误表示非常抱歉。



    7.数学公式 
    建立一个新文档,将以下内容复制进入文档中,保存,保存类型选择为UTF-8,编译并观察对比现象。 

    \documentclass{article} 
       \usepackage{amsmath} 
       \usepackage{amssymb} 
    \begin{document} 
       The Newton's second law is F=ma. 

       The Newton's second law is $F=ma$. 

       The Newton's second law is 
      

    F=maF=ma



       The Newton's second law is 
      

    F=maF=ma



       Greek Letters $\eta$ and $\mu$ 

       Fraction $\frac{a}{b}$ 

       Power $a^b$ 

       Subscript $a_b$ 

       Derivate $\frac{\partial y}{\partial t} $ 

       Vector $\vec{n}$ 

       Bold $\mathbf{n}$ 

       To time differential $\dot{F}$ 

       Matrix (lcr here means left, center or right for each column) 
       \[ 
         \left[ 
           \begin{array}{lcr} 
             a1 & b22 & c333 \\ 
             d444 & e555555 & f6 
           \end{array} 
         \right] 
       \] 

    Equations(here \& is the symbol for aligning different rows) 
    \begin{align} 
       a+b&=c\\ 
       d&=e+f+g 
    \end{align} 

    \[ 
       \left\{ 
         \begin{aligned} 
           &a+b=c\\ 
           &d=e+f+g 
         \end{aligned} 
       \right. 
    \]

    \end{document} 

    具体细节可以自行搜索LaTeX的数学符号表或别人给的例子。

     

    $...$是开启行内数学模式,用于和文本合在一起使用。

     

    ......

    ......

    是另起一行居中开启数学模式。通常用起来差别不是很大,不过$$会修改默认的公式行间距,有时可能会对文章的整体效果有影响。

    但是我最推荐使用的是equation环境,在之后的第9节中介绍。

     

    有一些网站可以通过画图的方式来生成公式,有的编辑器集成了各种数学功能按钮。这对于公式需求少的人来说很方便,具体信息可以自己去搜索。但是如果你的文章中要出现大段的证明过程,就会发觉还是老老实实地google一篇latex数学符号表,然后不懂的去查代码,自己用手指敲来得干脆利索。再进阶一点,可以去搜一下有关LaTeX的自定义command的内容去看一下,在敲公式时能省很多力气。


    8.插入图片 
    将待插入的图片姑且先命名为figure1.jpg 
    建立一个新文档,将以下内容复制进入文档中,保存,保存类型选择为UTF-8,放在和图片文件同一个文件夹里,编译并观察现象。 

    \documentclass{article} 
       \usepackage{graphicx} 
    \begin{document} 
       \includegraphics[width=4.00in,height=3.00in]{figure1.jpg} 
    \end{document}

    现在LaTeX对jpg、bmp、png等等常见图片都可以支持。

     

    9.可以被引用的图片和公式

    接下来进阶一点,我们来做有图片名称,可以在文中被引用的插入图片,还有可以在文中被引用的公式。建立一个新文档,将以下内容复制进入文档中,保存,保存类型选择为UTF-8,放在和图片文件同一个文件夹里。编译方式可以选择XeLaTeX或PDFTeXify。如果选择XeLaTeX,那么需要编译两次。如果选择PDFTeXify,那么编译一次就可以。

     

    \documentclass{article}
    \usepackage{amsmath}
    \usepackage{amssymb}
    \usepackage{graphicx, subfig}
    \usepackage{caption}
    \begin{document}
      One image ??????.
        \begin{figure}[!htbp]
          \centering
          \includegraphics[width = .8\textwidth]{image1.jpg}
          \caption{example of one image} \label{one-img}
        \end{figure}

      Image together is shown in Figure ??????.
      First sub-image is shown as Figure ??????.
      In Figure ?????? the second sub-image is presented.
        \begin{figure}[!htbp]
          \centering
          \subfloat[first sub-image]{
            \includegraphics[width = .45\textwidth]{image1.jpg}
            \label{sub1}
          }
          \qquad
          \subfloat[second sub-image]{
            \includegraphics[width = .45\textwidth]{image2.jpg}
            \label{sub2}
          }
          \caption{combined image}\label{img-together}
        \end{figure} 

      The result is shown in Equation ??????:
        \begin{equation}\label{abcde}
          a+b+c+d+e=f
        \end{equation}

    \end{document}

    9.简单表格 
    建立一个新文档,将以下内容复制进入文档中,保存,保存类型选择为UTF-8,编译并观察对比现象。 

    \documentclass{article} 
    \begin{document} 
       \begin{tabular}{|c|c|} 
         aaa & b \\ 
         c & ddddd\\ 
       \end{tabular} 

       \begin{tabular}{|l|r|} 
         \hline 
         aaaa & b \\ 
         \hline 
         c & ddddd\\ 
         \hline 
       \end{tabular} 

       \begin{center} 
         \begin{tabular}{|c|c|} 
           \hline 
           a & b \\ \hline 
           c & d\\ 
           \hline 
         \end{tabular} 
       \end{center} 
    \end{document}

    注意观察有无\hline和有无\begin{center}的区别。注意观察\begin{tabular}后的lcr的区别,分别是left对齐,center对齐和right对齐。                          

     

    10.制作参考文献

    建立一个新文档,把以下内容复制进入文档中,保存,保存文件名为references.bib,保存类型为UTF-8。这个文档专门用来存放参考文献的信息。

    @article{rivero2001resistance,
    title={Resistance to cold and heat stress: accumulation of phenolic compounds in tomato and watermelon plants},
    author={Rivero, Rosa M and Ruiz, Juan M and Garc{\i}a, Pablo C and L{\'o}pez-Lefebre, Luis R and S{\'a}nchez, Esteban and Romero, Luis},
    journal={Plant Science},
    volume={160},
    number={2},
    pages={315--321},
    year={2001},
    publisher={Elsevier}
    }

    @article{gostout1992clinical,
    title={The clinical and endoscopic spectrum of the watermelon stomach},
    author={Gostout, Christopher J and Viggiano, Thomas R and Ahlquist, David A and Wang, Kenneth K and Larson, Mark V and Balm, Rita},
    journal={Journal of clinical gastroenterology},
    volume={15},
    number={3},
    pages={256--263},
    year={1992},
    publisher={LWW}
    }

    建立一个新文档,把以下内容复制进入文档中,保存在同一个文件夹里,保存类型为UTF-8。

    \documentclass{article}
    \usepackage[numbers]{natbib}
    \begin{document}
              One reference about watermelon \cite{gostout1992clinical}        
              Another reference about watermelon \cite{rivero2001resistance}        
              \bibliographystyle{plain}        
              \bibliography{references}        
            \end{document}

    编译有两种方式可以选择,选择自己喜欢的随便一种就可以。

    比较简单的方式是选择编译方式为PDFTeXify编译一下就可以了。

    如果选择编译方式为XeLaTeX,那么需要多两个步骤,需要先用XeLaTeX编译一次,然后再用BibTeX编译一次(按钮就是在XeLaTeX编译右边的那个字母B),接着再用XeLaTeX编译两次。(谢谢小伙伴助攻~~)

    编译成功后观察并对比现象。

            (获得参考文献的那些信息的方式,我是觉得有谷歌学术搜索就可以了,没有必要装这个那个文献管理工具的。只要谷歌学术上搜索文献,在搜索结果下面点“引用”,在弹出窗口里点“BibTeX”,再把新窗口里的这些信息复制粘贴到自己的references.bib里去就可以了。)

     

    11.结尾 
    到目前为止,你已经可以用LaTeX自带的article模板来书写一篇基本的论文框架了,至少你已经能够借助搜索然后复制粘贴这些命令例子来开始用LaTeX编辑了。 
    在论文从框架到完整的过程中,必然还存在许多的细节问题,比如字体字号,比如图片拼合,比如复杂的表格等等。 
    那些问题,就请咨询google吧。通常来说我们作为初学者会提出的问题,早就已经有许多的先辈们在网络上提过同样的问题了,看看别人的回答就可以。 
    LaTeX在国内的普及率并不高,因此许多时候如果搜英文关键词,会获得更好的效果。


    =============================== 
    附录,有关我认为不是新手急需,但是的确比较有用的信息

     

    1.中文支持

    很多朋友给我留言希望我把中文支持部分加进这个基本入门的教程里。因为没有被人要求过,所以我自己没有用LaTeX写过中文的paper,只是偶尔拿来写写小说大纲。因此对于中文方面我知道的很少,也只能最简单地提一下。

    中文支持部分,在前文中提到的【自制】一份其实很短的 LaTeX 入门文档中有比较详细的介绍,大家可以点进去学习浏览。

     

     

    曾经的LaTeX的中文支持是比较麻烦的一件事,但是现在使用MikTeX+WinEdt的中文支持非常容易。 
    只需要把开头的\documentclass{atricle}换成\documentclass{ctexart}就可以了。 
    如果是第一次使用ctexart的话,会自动下载和安装宏包和模板,之后就不会再下载了。 
    例子参考如下: 
    打开WinEdt,建立一个新文档,将以下内容复制进入文档中,保存,保存类型选择为UTF-8。

    \documentclass[UTF8]{ctexart}
    \begin{document} 
    你好,世界 
    \end{document}

    有同学和我反映说直接copy这些代码生成的中文是乱码,的确这样的问题偶有发生。如果这样的话,不妨在windows左下角的开始菜单的程序列表里找到MikTeX的文件夹,用maintenance里面的package manager搜索和手动安装名为CJK的package,然后再试试能否成功编译出中文。


    2.宏包 
    \package{}就是在调用宏包,对计算机实在外行的同学姑且可以理解为工具箱。 
    每一个宏包里都定义了一些专门的命令,通过这些命令可以实现对于一类对象(如数学公式等)的统一排版(如字号字形),或用来实现一些功能(如插入图片或制作复杂表格)。 
    通常在\documentclass之后,在\begin{document}之前,将文章所需要涉及的宏包都罗列上。 
    对于新人而言比较常用的宏包有 

    编辑数学公式的宏包:\usepackage{amsmath}和 \usepackage{amssymb} 
    编辑数学定理和证明过程的宏包:\usepackage{amsthm} 
    插入图片的宏包:\usepackage{graphicx} 
    复杂表格的宏包:\usepackage{multirow} 

    差不多了,对于新人来说,这五个宏包已经基本够用了。如果有其他的特殊需求,就通过google去寻找吧。 
    补充说明一下,ctexart模板里已集成了CJK宏包。  


    3.模板 
    模板就是在\documentclass{}后面的大括号里的内容。 
    在这一份教程中,我们使用的是LaTeX默认自带的模板article,以及中文模板ctexart。 
    模板就是实现我之前所介绍的LaTeX的经验总结的第二点的实现方式。 
    一篇文章,我们定义了section,定义了paragraph,就是没有定义字体字号,因为字体字号这一部分通常来说是在模板中实现的。 
    一个模板可以规定,section这个层级都用什么字体什么字号怎么对齐,subsection这个层级用什么字体什么字号怎么对齐,paragraph又用什么字体什么字号怎么对齐。 
    当然模板里还可以包含一些自定义的口令,以及页眉页脚页边距一类的页面设置。 
    由于模板的使用,在我的使用经验里来看,绝对不可能算是基本入门级的内容,所以在正文里当然不会提及。 
    如果有人实在想学,如果LaTeX已经接触到这个程度上了,那么再去翻其他厚一些的教材,也不亏了。



    4.制作幻灯片

    有关用LaTeX做幻灯片,我和几个精通LaTeX的朋友聊到最后共识趋于一点,就是除非真的对LaTeX实在太有爱,除非内容涉及到太多太多的数学公式,否则还是用powerpoint吧。毕竟有导师要求论文必须用LaTeX做,但是没导师要求presentation也必须用LaTeX做。选择LaTeX做幻灯片,对比一下其学习和使用成本,和能做出的超出powerpoint的美观程度,性价比不是很高。

     

     

    =========================================

    下面是原先的“前言”,但是因为太长了太过啰嗦,所以我就把它放在教程正文的后面变成了“后记”。

    很有闲情的可以看完,略有闲情的可以只看黑体,没有闲情的就略过不看吧。

     

     

    这是一篇面向对LaTeX完全无认知无基础的新人的入门教程。 
    这一篇文章中,我追求的是极致的简短和实用。 
    我希望能够帮助新人能够用最简单快捷的方式,轻松入门,能够迅速使用LaTeX完成基本的文本编辑。 
    在我初学LaTeX时,我自己有着很强烈的感受,对于新人来说,LaTeX其实不缺少长篇的系统论述的manual,但是缺少简短的step by step的一个example接一个example的有操作价值的tutorial。 
    我想大多数人接触LaTeX的原因都和我一样,只是论文需要,并不是有多么想去当一个杂志编辑。

    因此这一篇tutorial的起点为零,终点到满足写一个proposal就为止了。

    同时这一篇tutorial的内容只涉及信息的撰写和录入,不涉及排版美化。

    我提倡的是新人们先开始跟着这个教程用LaTeX来写起来,在把内容放进去之后,遇到怎么让版面更加规范美观的问题的时候,可以从容地去翻manual或者问google。

    这篇教程中涉及的以及被我有意过滤掉的LaTeX的功能,都是我仔细斟酌过的,我确保文章的内容对于新人来说完全够用。 
    从proposal到paper当然还有一点距离,最重要的台阶是模板的应用,其次是做参考文献。 
    不过有了这篇文章垫底,至少能用LaTeX编辑点东西了,也就不怕了,单独去google需要的部分的教材就可以了。

    那么我个人对于即将接触LaTeX的新人的教材建议是,先从这一篇出发,掌握这一篇里的内容之后,就可以开始着手撰写和编辑自己的LaTeX文本了,比如自己的proposal或者论文的提纲,在写的过程中遇到的大部分格式和中文支持问题,都可以在我的朋友写的【自制】一份其实很短的 LaTeX 入门文档》中找到答案。而更多的问题,可以参考在我当初学LaTeX入门时认为最简短有指导意义有操作价值的《一份不太短的LaTeX介绍》,那一篇教材里基本就涵盖了以写paper为目的全部LaTeX功能需求了。

    另外感谢朋友留言提醒了我另外一篇当初在我入门时对我帮助非常大的教程,它名字很简单朴素叫做《LaTeX notes》。 这个note和《不太短的》都是内容合理实用,没有多余的废话,没有职业编辑才可能用到的高端内容,而且充满了清爽的examples的教程。我也要强烈推荐出来。它可以通过搜索“latex notes 包老师”获得。我写的这一篇教程,从一定意义上说,可以算是那两个简短教程的再简短的节选。因为这篇文章中的内容,就是当我在初学LaTeX的第一天,看着这两篇教程学会的,当时认为我最需要的技能。因此我将这些技能拿出来,带上我安排和精简过的例子,单独架构成精简再精简的入门教程,用来帮助新人打破在接触一个新事物最初始的“动手壁垒”。

    而对于其他一些manual或厚的教材,如果只是为了写paper的话,是没有必要专门去读的,拿来当百科全书或字典,需要的时候查阅就好了。

    (为什么那么多人在回复里都一定要提lshort?诚然lshort是经典教材,但是难道lshort本文没有提及吗?难道lshort不就是《The Not So Short Introduction to LaTeX》吗?难道不就是《一份不太短的LaTeX介绍》的英文版本吗?既然有中文的,也很清晰明了,毫无拙劣翻译拖后腿,却一定要拿一个英文版本来说事儿,那么这很显然除了装逼还能是什么呢?拜托实用一点好吧。)

     

     

     


    先用三句话来介绍什么是LaTeX,以下三点基于我个人写assignment report和写论文的主观经验的总结。 
    1.LaTeX是一类用于编辑和排版的软件,用于生成PDF文档。 
    2.LaTeX编辑和排版的核心思想在于,通过\section和\paragraph等语句,规定了每一句话在文章中所从属的层次,从而极大方便了对各个层次批量处理。 
    3.LaTeX在使用体验方面,最不易被Word替代的有四个方面:方便美观的数学公式编辑、不会乱动的退格对齐、非所见即所得因此可以在编辑的时候用退格和换行整理思路但生成PDF出来不影响美观、部分导师和刊物不接受Word排版的文章。

     

    (这一段为看到部分留言后一时冲动写下的,因为很多人转,而且也的确是在说明我的态度,因此保留原样摆在这里) 
    我要严厉警告和强烈声讨那些自以为是advanced LaTeX user的人。请你们不要为了自己那一点可怜可悲的虚荣心,去刻意渲染LaTeX有多么高端多么不容易学习,这和孔乙己炫耀茴香豆的茴字有四种写法有什么区别么?混账!LaTeX到底有多“难”你们自己清楚好么?同理的还有很大一部分喜欢炫耀上手难度而非实用趣味的VI user,还有Linux user,还有Fallout player。卧槽,一个软件而已,有什么好显摆的。别人想学LaTeX,好,你随手给人家丢一个几百页的英文Manual,显得自己很高端吗?你自己看过了吗?你推荐给别人的时候真的有希望别人看完吗?只是装逼的话就是混账!

     

     

    我考虑了很久,最后还是决定不将这些examples的代码注释完全,而是希望读者在对比了tex代码和生成的pdf内容之后,自己得出结论。这些例子都是我自己推敲安排过的,如果想学LaTeX的话,自己总要动点脑筋才好。

     

     

    写完之后很多人分享很多人回复,我很开心也很感激。文章总是在改,更正了很多信息,比如图片的插入和中文支持的问题。然而更多时候却不知不觉陷入迷途,文章开始背离面对新人说话的初衷,而开始越来越多地对一些老人去解释。居然形成了如此之长的前言,实在是有违我的本意。最终我将前言删减到现在这个样子,第一段是文章来由和闲谈,第二段是我的经验观点,第三段为看到一些留言之后一时冲动写下的,因为很多人转,而且也的确是在说明我的态度,因此保留原样,第四段是对一些朋友愿望的回应。那么前言到此结束。之后如果没有被告知文章内有重大错误,便不会再编辑修改了。诸君好运。

    展开全文
  • VScode使用教程大全,看完你一定会谢谢我的

    万次阅读 多人点赞 2019-10-12 11:40:54
    作为前端开发的我,之前的开发过程中一直用的是Atom这一款IDE,再配上了好看的主题插件很nice,Atom的界面是真心好看,但是插件装多了你们真的不觉得卡吗,VS Code比Atom更加的流畅,比webstorm更轻量级。...

    作为前端开发的我,之前的开发过程中一直用的是Atom这一款IDE,再配上了好看的主题插件很nice,Atom的界面是真心好看,但是插件装多了你们真的不觉得卡吗,VS CodeAtom更加的流畅,比webstorm更轻量级。一次偶然换的工作后,项目组要求统一IDE,让我了解到了VS Code,这边简单介绍下VS Code日常开发的需求。

    VS Code精选主题

     

     

     

    主题插件安装流程

    首先先简单介绍些主题插件的安装流程:

    第一步,点击扩展商店搜索你要找的插件名称如Atom One Dark Theme,点击安装;

     

     

     

    第二部,安装好了之后只是证明你本地的VS Code上面有这个插件了,还需要将当前使用的主题插件切换成你想要的才行;

    ①点击左下角的设置按钮,进入命令面板;

    ②搜索颜色主题关键字;

     

     

     

    ③点击想要的主题完成切换。

     

     

     

    一个编辑器界面的好看与否,真心挺重要的,之前对atom一直恋恋不舍,完全就是因为它的主题界面太优雅了。下图是笔者配置好的VS Code界面截图,下面推荐几款好看的主题:

     

     

     

    VS Code 主题插件列表(推荐)

    1. One Dark Pro

    One Dark Pro的主题界面效果如下(推荐指数5星) One Dark Pro

     

     

     

    2. Atom One Dark Theme

    Atom One Dark Theme的主题界面效果如下(推荐指数5星) Atom One Dark Theme

     

     

     

    3. Eva Theme

    Eva Theme的主题界面效果如下(推荐指数5星) Eva Theme

     

     

     

    4. Material Palenight Theme

    Material Palenight Theme的主题界面效果如下(推荐指数5星) Material Palenight Theme

     

     

     

    更多Visual Studio Code 主题插件请参考VS Code Downloads

    VS Code精选插件

    VS Code所有的插件都可以在VS Code Downloads插件库中找到,如下图:

     

     

     

    Auto Close Tag

    Auto Close Tag:匹配标签,关闭对应的标签。对于HTML/XML很实用。

    Auto Rename Tag

    Auto Rename Tag:改变标签的时候同时改动开闭合标签;对于HTML/XML很实用。

    HTML CSS Support

    HTML CSS Support : 这个也是HTML必备插件之一。

    CSS Peek

    CSS Peek : html和css中关联css的跳转

    Code Runner

    Code Runner : 代码编译运行看结果,支持众多语言

    Git History

    Git History : 查看git分支提交日志的插件

    Git History Diff

    Git History Diff : 寻找每一个git分支上面提交过的节点,并可以对比差异性。

    Path Autocomplete

    Path Autocomplete : 路径智能补全插件。

    Path Intellisense

    Path Intellisense : 路径智能提示插件。

    beautify

    beautify :良好的拓展性,可以格式化JSON|JS|HTML|CSS|SCSS,比内置格式化好用;但是react工程的jsx文件用beautify插件格式化会乱掉,建议不要用

    Prettier - Code formatter

    Prettier - Code formatter : 代码格式化插件,主要针对工程中的JavaScript / TypeScript / CSS

    Prettier Now

    Prettier Now : 支持语言比较全面的代码格式化插件,主要是支持jsx /tsx ,还有sass / less等(问的react工程基本上就是用这2个Prettier插件格式化代码)

    Terminal

    Terminal : vs code 内置的命令行插件,也比较实用。

    Bookmarks

    Bookmarks : 这个插件支持在文件特定的行做标记,更好的提高开发效率。

     

     

     

    Bracket Pair Colorizer

    Bracket Pair Colorizer :很多括号的情况下,这个插件可以做一个颜色的区分,代码一目了然。

     

     

     

    Chinese (Simplified) Language Pack for Visual Studio Code

    Chinese (Simplified) Language Pack for Visual Studio Code : 适用于 VS Code 的中文(简体)语言包。

    filesize

    filesize : 编辑器底部显示当前文件的大小。

    Markdown Preview Enhanced

    Markdown Preview Enhanced : 本地Markdown文档预览插件。

    vscode-icons

    vscode-icons : 一套vs code的图标插件。

    npm

    npm : 不多说npm。

    open-in-browser

    open-in-browser : 一键在浏览器中打开

    Live Server

    Live Server :一键开启本地服务。

    fileheader

    fileheader感觉用得上 新建文件作者注释

     

     

    在自定义设置页面(comd+,),可以设置一些作者信息,然后打开命令面板(comd+shift+P),输入fileheader回车即可

     

     

     

     

     

     

     

    Local History

    Local History个人感觉很有用 本地代码的一个保存日志,在没有git,svn,或者很长时间没有提交过代码的情况下,感觉挺实用,再也不怕代码回滚。

     

     

     

    GitLens -- Git supercharged

    GitLens -- Git supercharged : GitLens能增强Visual Studio代码中内置的Git功能。它帮助您通过Git blame注解和代码镜头直观地显示代码作者,无缝地导航和探索Git存储库,通过强大的比较命令获得有价值的见解。

     

     

     

     

    VS Code常用快捷键

    VS Code的快捷键有很多,需要具体的请仔细参考 VS Code => 左下角设置按钮 => 键盘快捷方式

     

     

     

    我们也可以自定义快捷键,在keybindings.json里面设置覆盖即可

     

     

     

    快捷键完全是个人操作习惯,这里不多介绍,我常用的有这几个:

    打开命令面板    cmd + shift + p / F1
    打开设置页面    cmd + ,
    删除一行        cmd + E(自定义)
    添加书签        cmd + option + k
    代码格式化      control + opiton + B
    复制代码

    VS Code git代码管理实战

    git现在是很常见的代码管理工具,VS Code 也有内置的git插件,当然,要是你觉得不完美,可以安装一些常用的git插件等,简单介绍下VS Code 下git的提交步骤。

     

     

     

    这里我以GitHub上面新建的一个仓库为例,仓库新建后默认分支是master,这里我在GitHub上新建了2个远程分支develop01develop02,当你在VS Code中点击切换到某一个远程分支的时候,VS Code会自动给你创建一个和当前远程分支对应的本地分支,如origin/develop02 对应develop02,如origin/master 对应master,如上图所示。

    现在我们在master分支上面提交代码,

     

     

     

    • 第一步,先暂存要提交的文件
    • 第二步,填下提交日志
    • 第三步,点击对勾按钮完成提交

    提交好了之后还需要拉取git远程分支的代码才能推送。

     

     

     

    • 第四步,拉取远程代码,解决冲突
    • 第五步,推送到远程分支上

    然后就没有然后了?,提交完成。

    假如你因为工作需求的原因,需要在不同的分支上面提交不同的代码,那就涉及到分支的切换了。首先第一步,切换分支之前先提交代码,不然老是有报错日志,切换了分支后,本地的代码也会对应分支改变。

     

     

     

    如上图,master切换成develo01之后,master分支上刚提交的代码成了develo01上对应的代码。

    git提交代码这部分,还可以使用相关git代码管理工具实现呢,如SourceTree、Tower等工具都很好用,这边也整理了一篇文章,欢迎收藏

    你问我答

    1.VS Code 怎么更改默认的设置?

    笔者使用的是mac,使用快捷键 Com + , 打开用户默认设置界面,左边是默认设置,右边是自定义设置,根据个人工作场景而定吧,就像我这边就统一格式化代码缩进4格等,还可以设置忽略一些文件夹等。

    {
        "explorer.confirmDelete": false,
        // 主题
        "workbench.iconTheme": "vscode-icons",
        // 小地图
        "editor.minimap.enabled": true,
        // 主题风格One Dark Pro
        "workbench.colorTheme": "One Dark Pro",
        "window.zoomLevel": 1,
        "extensions.autoUpdate": false,
        // 字体大小
        "editor.fontSize": 13,
        "editor.snippetSuggestions": "top",
        "diffEditor.ignoreTrimWhitespace": true,
        // 设置格式化缩进4格
        "prettier.tabWidth": 4,
        "vetur.format.defaultFormatter.html": "prettier",
        "gitlens.advanced.messages": {
            "suppressShowKeyBindingsNotice": true
        },
        "gitlens.historyExplorer.enabled": true,
        "atomKeymap.promptV3Features": true,
        "editor.multiCursorModifier": "ctrlCmd",
        //粘贴自动格式化
        "editor.formatOnPaste": false,
        //保存自动格式化
        "editor.formatOnSave": false,
        // 用来忽略工程打开的文件夹
        "files.exclude": {
            "**/.vscode": true,
            "**/.DS_Store": true,
            "**/.history":true,
            "**/nbproject":true
        },
        // 用来忽略搜索的文件夹
        "search.exclude": {
            "**/node_modules/**": true,
            "**/bower_components/**": true,
            "**/image/**": true,
            "**/*.xml": true,
            "**/.history/**":true,
            "**/nbproject/**":true,
            "**/vscode/**":true
    
        },
        // 创建和更新代码的头部信息作者
        "fileheader.Author": "Baldwin",
        "fileheader.LastModifiedBy": "Baldwin",
    }
    复制代码

    2.假如我几天没有提交代码了(git),今天突然发现代码youbug,需要还原到昨天版本,VS Code能做到吗?

    能。参考上面的 VS Code插件 Local History

     

    展开全文
  • 一篇“从入门到上手”的PCB设计教程

    万次阅读 多人点赞 2019-05-16 14:43:23
    一篇“从入门到上手”的PCB设计教程 这是一篇面向神马都不懂的小白玩家的PCB设计教程。希望能帮助大家快速上手PCB的设计。 1 预备知识 1.1 常用工具 (1)做图工具:Altium Designer (2)PCB板加工:嘉立创 (3)...
  • 设计-细说2020最新UI设计趋势与分析

    千次阅读 2020-06-07 00:46:11
    此前,我在一些设计网站上看到了一些与最新 设计趋势 相关的内容,但大部分都属于整个类别的趋势。因此,我想通过自己的理解和收集整理一些属于移动用户界面设计方向的设计趋势,并进行一些与设计相关的分析。...
  • 软件测试入门视频教程

    万人学习 2019-06-25 10:59:08
    软件测试入门视频培训教程:该课程将带你走进“软件测试”的大门,具体内容包括软件测试环境搭建、软件开发模型、产品模型、CMM模型、测试用例、等价类划分、边界值划分、白盒测试、单元测试、bugfree搭建、系统测试...
  • vs2017安装和使用教程(详细)

    万次阅读 多人点赞 2019-12-26 14:35:41
    vs2019 已于4月2日推出,用户不用卸载vs2017,因为这二者互相独立,项目也兼容,安装教程也是本篇的姊妹篇: vs2019安装和使用教程(详细) vs2017如此强大,不仅仅是C语言,Python,R,F#,ios,Android,Web,...
  • SEO优化网站教程6

    万次阅读 2019-08-23 09:04:49
    SEO优化网站教程之6个经典软件操作顺序6个经典软件操作顺序网站关键词优化到百度首页其主要关键在于网站内容关联建设,掌握【网站标题-网站首页长尾关键词建设-文章标题-文章内容】这三者紧密和高度关联性。打开教程...
  • vs2019安装和使用教程(详细)

    万次阅读 多人点赞 2019-12-26 14:37:46
    本篇博客是vs2017安装和使用教程(详细)的姊妹篇 vs2019已经在4月2日正式发布,vs2019发布会请看这个链接: vs2019发布活动 vs2019和vs2017一样强大,项目兼容,不用互相删除,而且C/C++,Python,F#,ios,...
  • 以太坊Linux系统挖矿教程

    万次阅读 热门讨论 2018-10-11 16:41:20
    小编发现网上的window以太坊挖矿教程很多,但是linux下的教程和软件几乎没有,只能查到三年前的,今天小编给大家带来最新的以太坊挖矿 教原版程和以太坊挖矿软件。   首先先放上最新的 百度网盘|Linux下原版ETH...
  • StarUML使用简明教程

    万次阅读 多人点赞 2018-08-31 18:45:09
    最近了解到StarUML比较多,所以写一篇教程供大家参考,不足支持,请见谅。 StarUML(简称SU),是一种创建UML类图,生成类图和其他类型的统一建模语言(UML)图表的工具。StarUML是一个开源项目之一发展快、灵活、可...
  • 图解GitHub和SourceTree 入门教程 使用教程

    万次阅读 多人点赞 2019-10-11 17:01:47
    教程适用于github和bitbucket和gitee等主流代码托管仓库,个人认为sourceTree还是比较好用的git客户端,支持windows和mac os,当然也不排斥使用纯命令行的朋友。 sourceTree配合高级的命令行,可以很方便快速的...
  • 以太坊(ETH)挖矿教程

    万次阅读 2020-09-01 10:07:06
    挖矿教程第三弹——以太坊挖矿教程 小白必看:什么是挖矿,挖矿的原理是什么,请看下方链接视频《什么是挖矿》 https://www.bilibili.com/video/av73767941/ 首先,请确保你的显存大于3GB,等于3GB也不行。因为...
  • Python入门教程完整版(懂中文就能学会)

    万次阅读 多人点赞 2020-05-21 16:43:37
    今天本宝宝给大家带来了干货,Python入门教程完整版,完整版啊!完整版! 言归正传,我来给大家介绍一下这套教程,希望每个小伙伴都沉迷学习,无法自拔! 本套教程学习时间15天 1-3天内容:为Linux基础命令 ...
  • 源码免杀教程 源码免杀思路详解

    万次阅读 2019-05-05 23:42:39
    绝对不一样的源码免杀教程!绝对不一样的免杀实战体验!清晰的思路!细致全面的思路详解!让你感到免杀原来可以这么简单!教你如何在源代码中找出被杀代码,修改代码从而达到免杀效果! 免杀之-网络攻防入门书籍推荐 ...
1 2 3 4 5 ... 20
收藏数 1,555,547
精华内容 622,218
关键字:

教程