我见过一些书籍和文章中有一些非常漂亮的Git分支和提交的图表。如何制作Git历史的高质量可打印图像?


当前回答

gitg:基于gtk的存储库查看器。这是新的,但有趣且有用。

我目前正在使用它。

其他回答

我刚刚编写了一个工具,它可以使用HTML/Ccanvas生成一个漂亮的Git提交图。

并提供一个jQuery插件,使其易于使用。

[GitHub]https://github.com/tclh123/commits-graph

预览:

一个漂亮整洁的表,如外壳的Git图形输出

除了图树之外,通常使用哈希

或在额外的列中

编辑:你想在不阅读所有解释的情况下立即开始吗?跳转至EDIT 6。

信息:对于外壳的更像分支的彩色版本,请参见我的第二个答案(https://stackoverflow.com/a/63253135/).

在对这个问题的所有回答中,到目前为止,没有一个显示出类似于查找外壳输出的干净表格。最接近的答案是我刚开始时的小鹅。

我的方法的核心点是只计算显示给用户的树字符。然后用空格填充到个人长度。

除了Git,你还需要这些工具

希腊语粘贴输出函数已安装的序列号第三方厕所

大多数是在任何Linux发行版上。

代码段是

while IFS=+ read -r graph hash time branch message;do

  # Count needed amount of white spaces and create them
  whitespaces=$((9-$(sed -nl1000 'l' <<< "$graph" | grep -Eo '\\\\|\||\/|\ |\*|_' | wc -l)))
  whitespaces=$(seq -s' ' $whitespaces|tr -d '[:digit:]')

  # Show hashes besides the tree ...
  #graph_all="$graph_all$graph$(printf '%7s' "$hash")$whitespaces \n"

  # ... or in an own column
  graph_all="$graph_all$graph$whitespaces\n"
  hash_all="$hash_all$(printf '%7s' "$hash")  \n"

  # Format all other columns
  time_all="$time_all$(printf '%12s' "$time") \n"
  branch_all="$branch_all$(printf '%15s' "$branch")\n"
  message_all="$message_all$message\n"
done < <(git log --all --graph --decorate=short --color --pretty=format:'+%C(bold 214)%<(7,trunc)%h%C(reset)+%C(dim white)%>(12,trunc)%cr%C(reset)+%C(214)%>(15,trunc)%d%C(reset)+%C(white)%s%C(reset)' && echo);

# Paste the columns together and show the table-like output
paste -d' ' <(echo -e "$time_all") <(echo -e "$branch_all") <(echo -e "$graph_all") <(echo -e "$hash_all") <(echo -e "$message_all")

为了计算所需的空白空间,我们使用

  sed -nl1000 'l' <<< "$graph"

要获取所有字符(直到每行1000个),请仅选择树字符:*|/\ _和空格

  grep -Eo '\\\\|\||\/|\ |\*|_'

最后对它们进行计数,并从我们选择的长度值中减去结果,在示例中为9。

为了生成计算出的空白量,我们使用

  seq -s' ' $whitespaces

并用截断位置号

  tr -d '[:digit:]'

然后将它们添加到图形线的末尾。就是这样!

Git有一个很好的选项,可以用语法“%><(amount_of_characters,truncate_option)”格式化输出说明符的长度,它从左侧“>”或右侧“<”添加空格,并可以从开头“ltrunc”、中间“mtrunc”或结尾“trunk”截断字符。

重要的是,上面的printf cmd对相应的Git列使用相同的长度值。

享受自己的风格,就像根据自己的需要寻找输出一样。

额外:

要获得正确的长度值,可以使用以下代码段

while read -r graph;do
    chars=$(sed -nl1000 'l' <<< "$graph" | grep -Eo '\\\\|\||\/|\ |\*|_' | wc -l)
    [[ $chars -gt ${max_chars:-0} ]] && max_chars=$chars
done < <(git log --all --graph --pretty=format:' ')

并使用$max_chars作为上面的正确长度值。

编辑1:请注意,在git树中也使用下划线字符,并相应地编辑上面的代码片段。如果缺少其他字符,请留下评论。

编辑2:如果要去掉分支和标记项周围的括号,只需在git命令中使用“%D”而不是“%D”,就像在EDIT 3中一样。

编辑3:也许对于分支和标记条目,“自动”颜色选项是您最喜欢的选项?

更改git命令的这部分(颜色214)

%C(214)%>(15,trunc)%D%C(reset)

自动

%C(auto)%>(15,trunc)%D%C(reset)

编辑4:或者你喜欢你自己的颜色组合,一个闪烁着脑袋的花哨输出?

为了能够首先设置头部、分支名称和标记的样式,我们需要在git命令中使用“auto”颜色选项,如EDIT3中所示。

然后,我们可以通过添加这3行来替换已知的颜色值

 # branch name styling
 branch=${branch//1;32m/38;5;214m}
 # head styling
 branch=${branch//1;36m/3;5;1;38;5;196m}
 # tag styling
 branch=${branch//1;33m/1;38;5;222m}

就在行前

 branch_all="$branch_all$(printf '%15s' "$branch")\n"

在我们的代码段中。替换值产生上述颜色。

例如,水头的替换值为

3;5;1;38;5;196

其中3;代表斜体,5;用于闪烁和1;38;5.196表示颜色。有关更多信息,请从这里开始。注意:此行为取决于您喜爱的终端,因此可能不可用。

但你可以选择任何你喜欢的颜色值。

数字颜色值和ANSI等效值概述

您可以在这里找到带有git颜色/样式选项的列表。

如果您需要控制台上的输出以获得准确的颜色(上面的图片由堆栈溢出缩小),您可以使用

for ((i=0;i<=255;i++));do
  while IFS='+' read -r tree hash;do
    echo -e "$(printf '%-10s' "(bold $i)") $hash  $(sed -nl500 'l' <<< "$hash"|grep -Eom 1 '[0-9;]*[0-9]m'|tr -d 'm')"
  done < <(git log --all --graph --decorate=short --color --pretty=format:'+%C(bold '$i')%h%C(reset)'|head -n 1)
done

在Git项目路径中,该路径使用Git日志输出中的第一个提交。

编辑5:正如成员“Andras Deak”所提到的,有一些方法可以使用此代码:

1) 作为别名:

别名不接受参数,但函数可以,因此只需在.bashrc中定义

   function git_tably () {
     unset branch_all graph_all hash_all message_all time_all max_chars

     ### add here the same code as under "2) as a shell-script" ###

   }

并直接在git项目路径下调用函数gittable(从类表中派生),或者从任何您想要的地方调用,将git项目的路径作为第一个参数。

2) 作为shell脚本:

我使用它的选项是将Git项目目录作为第一个参数传递给它,如果为空,则像正常行为一样使用工作目录。整体而言,我们拥有

# Edit your color/style preferences here or use empty values for git auto style
tag_style="1;38;5;222"
head_style="1;3;5;1;38;5;196"
branch_style="38;5;214"

# Determine the max character length of your git tree
while IFS=+ read -r graph;do
  chars_count=$(sed -nl1000 'l' <<< "$graph" | grep -Eo '\\\\|\||\/|\ |\*|_' | wc -l)
  [[ $chars_count -gt ${max_chars:-0} ]] && max_chars=$chars_count
done < <(cd "${1:-"$PWD"}" && git log --all --graph --pretty=format:' ')

# Create the columns for your preferred table-like git graph output
while IFS=+ read -r graph hash time branch message;do

  # Count needed amount of white spaces and create them
  whitespaces=$(($max_chars-$(sed -nl1000 'l' <<< "$graph" | grep -Eo '\\\\|\||\/|\ |\*|_' | wc -l)))
  whitespaces=$(seq -s' ' $whitespaces|tr -d '[:digit:]')

  # Show hashes besides the tree ...
  #graph_all="$graph_all$graph$(printf '%7s' "$hash")$whitespaces \n"

  # ... or in an own column
  graph_all="$graph_all$graph$whitespaces\n"
  hash_all="$hash_all$(printf '%7s' "$hash")  \n"

  # Format all other columns
  time_all="$time_all$(printf '%12s' "$time") \n"
  branch=${branch//1;32m/${branch_style:-1;32}m}
  branch=${branch//1;36m/${head_style:-1;36}m}
  branch=${branch//1;33m/${tag_style:-1;33}m}
  branch_all="$branch_all$(printf '%15s' "$branch")\n"
  message_all="$message_all$message\n"

done < <(cd "${1:-"$PWD"}" && git log --all --graph --decorate=short --color --pretty=format:'+%C(bold 214)%<(7,trunc)%h%C(reset)+%C(dim white)%>(12,trunc)%cr%C(reset)+%C(auto)%>(15,trunc)%D%C(reset)+%C(white)%s%C(reset)' && echo);

# Paste the columns together and show the table-like output
paste -d' ' <(echo -e "$time_all") <(echo -e "$branch_all") <(echo -e "$graph_all") <(echo -e "$hash_all") <(echo -e "$message_all")

3) 作为git别名:

也许最舒服的方法是在.gitconfig中添加git别名

[color "decorate"]
    HEAD = bold blink italic 196
    branch = 214
    tag = bold 222

[alias]
    count-log = log --all --graph --pretty=format:' '
    tably-log = log --all --graph --decorate=short --color --pretty=format:'+%C(bold 214)%<(7,trunc)%h%C(reset)+%C(dim white)%>(12,trunc)%cr%C(reset)+%C(auto)%>(15,trunc)%D%C(reset)+%C(white)%s%C(reset)'
    tably     = !bash -c '"                                                                                                    \
                  while IFS=+ read -r graph;do                                                                                 \
                    chars_count=$(sed -nl1000 \"l\" <<< \"$graph\" | grep -Eo \"\\\\\\\\\\\\\\\\|\\||\\/|\\ |\\*|_\" | wc -l); \
                    [[ $chars_count -gt ${max_chars:-0} ]] && max_chars=$chars_count;                                          \
                  done < <(git count-log && echo);                                                                             \
                  while IFS=+ read -r graph hash time branch message;do                                                        \
                    chars=$(sed -nl1000 \"l\" <<< \"$graph\" | grep -Eo \"\\\\\\\\\\\\\\\\|\\||\\/|\\ |\\*|_\" | wc -l);       \
                    whitespaces=$(($max_chars-$chars));                                                                        \
                    whitespaces=$(seq -s\" \" $whitespaces|tr -d \"[:digit:]\");                                               \
                    graph_all=\"$graph_all$graph$whitespaces\n\";                                                              \
                    hash_all=\"$hash_all$(printf \"%7s\" \"$hash\")  \n\";                                                     \
                    time_all=\"$time_all$(printf \"%12s\" \"$time\") \n\";                                                     \
                    branch_all=\"$branch_all$(printf \"%15s\" \"$branch\")\n\";                                                \
                    message_all=\"$message_all$message\n\";                                                                    \
                  done < <(git tably-log && echo);                                                                             \
                  paste -d\" \" <(echo -e \"$time_all\") <(echo -e \"$branch_all\") <(echo -e \"$graph_all\")                  \
                                <(echo -e \"$hash_all\") <(echo -e \"$message_all\");                                          \
                '"

而不是在任何项目路径下调用git tably。

Git非常强大,你可以改变头像、标签。。。直接如上面所示并从这里取出。

另一个有趣的选择是选择你最喜欢的树颜色

[log]
    graphColors = bold 160, blink 231 bold 239, bold 166, bold black 214, bold green, bold 24, cyan

这给了你疯狂的外观,但总是像表一样的git日志输出

眨眼太多!只是为了证明什么是可能的。指定的颜色太少会导致颜色重复。

只需单击一下即可获得完整的.gitconfig引用。

编辑6:由于你的支持,我改进了这个片段。现在,您可以用几乎任何gitlog命令来输入它,而不必再调整代码。试试看!

它是如何工作的?

一如既往地在.gitconfig中定义Git日志命令(格式如下)定义一个正树列编号,其中显示git图(可选)

那就打电话

git tably YourLogAlias

在任何git项目路径下或

git tably YourLogAlias目录号

其中TreeClNumber覆盖上面始终定义的值。

git tably YourLogAlias | less-r

将把输出管道输送到较少的位置,这对于巨大的历史记录非常有用。您的Git日志别名必须遵循以下格式规则:

每一列都必须由一个列分隔符表示,您必须选择该分隔符,如果不是唯一的,可能会导致问题即^ in。。。格式:“^%h^%cr^%s”生成树、哈希、时间和提交列在日志命令中必须使用的每个提交占位符之前%><(<N>[,ltrunc|mtrunc|trunk]),带有trunk选项之一(有关语法解释,请参见https://git-scm.com/docs/pretty-formats),但是,任何换行符的最后一个提交占位符都可以在没有它的情况下使用即…格式:“^%<(7,trunc)%h^%<如果装饰需要额外的字符,如(committer:,<and>)…%C(暗白色)(提交人:%cn%<%ce>)%C(重置)。。。要获得类似表的输出,必须在提交占位符之前和之后直接写入它们即…%C(暗淡的白色)%<(25,trunc)(提交人:%cn%<(25,trunk)<%ce>)%C(重置)。。。使用列颜色,如%C(白色)…%C(重置)需要彩色输出的--color选项即…--颜色…格式:'^%C(白色)%<(7,trunk)%h%C(重置)。。。如果使用--stat选项或类似选项,请在末尾添加一个换行符%n即…--stat.…格式:“…%n”。。。只要不使用换行符或仅使用空字符格式,就可以在每一列中放置git图形:'…%没有对于非空换行符…%n%提交占位符。。。只有当每行的所有第n列都存在并且使用相同的宽度时,才能将git图放置在每列n+1处为特定日志别名定义的树列编号的名称必须为YourLogAlias col

与正常的git日志输出相比,这个输出速度慢,但很好。

现在将改进的代码段添加到.gitconfig中

[color "decorate"]
    HEAD   = bold blink italic 196
    branch = 214
    tag    = bold 222

[alias]

    # Delimiter used in every mylog alias as column seperator
    delim     = ^

    # Short overview about the last hashes without graph
    mylog     = log --all --decorate=short --color --pretty=format:'^%C(dim white)%>(12,trunc)%cr%C(reset)^%C(bold 214)%<(7,trunc)%h%C(reset)' -5

    # Log with hashes besides graph tree
    mylog2    = log --all --graph --decorate=short --color --pretty=format:'%C(bold 214)%<(7,trunc)%h%C(reset)^%C(dim white)%>(12,trunc)%cr%C(reset)^%C(auto)%>(15,trunc)%D%C(reset)^%C(white)%<(80,trunc)%s%C(reset)'
    mylog2-col= 3

    # Log with hashes in an own column and more time data
    mylog3    = log --all --graph --decorate=short --color --pretty=format:'^%C(dim white)%>(12,trunc)%cr%C(reset)^%C(cyan)%<(10,trunc)%cs%C(reset)^%C(bold 214)%<(7,trunc)%h%C(reset)^%C(auto)%<(15,trunc)%D%C(reset)^%C(white)%s%C(reset)'
    mylog3-col= 4

    tably     = !bash -c '" \
                \
                \
                declare -A col_length; \
                apost=$(echo -e \"\\u0027\"); \
                delim=$(git config alias.delim); \
                git_log_cmd=$(git config alias.$1); \
                git_tre_col=${2:-$(git config alias.$1-col)}; \
                [[ -z "$git_tre_col" ]] && git_tre_col=1; \
                [[ -z "$git_log_cmd" ]] && { git $1;exit; }; \
                \
                \
                i=0; \
                n=0; \
                while IFS= read -r line;do \
                  ((n++)); \
                  while read -d\"$delim\" -r col_info;do \
                    ((i++)); \
                    [[ -z \"$col_info\" ]] && col_length[\"$n:$i\"]=${col_length[\"${last[$i]:-1}:$i\"]} && ((i--)) && continue; \
                    [[ $i -gt ${i_max:-0} ]] && i_max=$i; \
                    col_length[\"$n:$i\"]=$(grep -Eo \"\\([0-9]*,[lm]*trunc\\)\" <<< \"$col_info\" | grep -Eo \"[0-9]*\" | head -n 1); \
                    [[ -n \"${col_length[\"$n:$i\"]}\" ]] && last[$i]=$n; \
                    chars_extra=$(grep -Eo \"trunc\\).*\" <<< \"$col_info\"); \
                    chars_extra=${chars_extra#trunc)}; \
                    chars_begin=${chars_extra%%\\%*}; \
                    chars_extra=${chars_extra%$apost*}; \
                    chars_extra=${chars_extra#*\\%}; \
                    case \" ad aD ae aE ai aI al aL an aN ar as at b B cd cD ce cE ci cI cl cL cn cN cr \
                            cs ct d D e f G? gd gD ge gE GF GG GK gn gN GP gs GS GT h H N p P s S t T \" in \
                      *\" ${chars_extra:0:2} \"*) \
                        chars_extra=${chars_extra:2}; \
                        chars_after=${chars_extra%%\\%*}; \
                        ;; \
                      *\" ${chars_extra:0:1} \"*) \
                        chars_extra=${chars_extra:1}; \
                        chars_after=${chars_extra%%\\%*}; \
                        ;; \
                      *) \
                        echo \"No Placeholder found. Probably no tablelike output.\"; \
                        continue; \
                        ;; \
                    esac; \
                    if [[ -n \"$chars_begin$chars_after\" ]];then \
                      len_extra=$(echo \"$chars_begin$chars_after\" | wc -m); \
                      col_length["$n:$i"]=$((${col_length["$n:$i"]}+$len_extra-1)); \
                    fi; \
                  done <<< \"${line#*=format:}$delim\"; \
                  i=1; \
                done <<< \"$(echo -e \"${git_log_cmd//\\%n/\\\\n}\")\"; \
                \
                \
                git_log_fst_part=\"${git_log_cmd%%\"$apost\"*}\"; \
                git_log_lst_part=\"${git_log_cmd##*\"$apost\"}\"; \
                git_log_tre_part=\"${git_log_cmd%%\"$delim\"*}\"; \
                git_log_tre_part=\"${git_log_tre_part##*\"$apost\"}\"; \
                git_log_cmd_count=\"$git_log_fst_part$apost $git_log_tre_part$apost$git_log_lst_part\"; \
                col_length[\"1:1\"]=$(eval git \"${git_log_cmd_count// --color}\" | wc -L); \
                \
                \
                i=0; \
                while IFS=\"$delim\" read -r graph rest;do \
                  ((i++)); \
                  graph_line[$i]=\"$graph\"; \
                done < <(eval git \"${git_log_cmd/ --color}\" && echo); \
                \
                \
                i=0; \
                l=0; \
                while IFS= read -r line;do \
                  c=0; \
                  ((i++)); \
                  ((l++)); \
                  [[ $l -gt $n ]] && l=1; \
                  while IFS= read -d\"$delim\" -r col_content;do \
                    ((c++)); \
                    [[ $c -le $git_tre_col ]] && c_corr=-1 || c_corr=0; \
                    if [[ $c -eq 1 ]];then \
                      [[ \"${col_content/\\*}\" = \"$col_content\" ]] && [[ $l -eq 1 ]] && l=$n; \
                      count=$(wc -L <<< \"${graph_line[$i]}\"); \
                      whitespaces=$(seq -s\" \" $((${col_length[\"1:1\"]}-$count))|tr -d \"[:digit:]\"); \
                      col_content[$git_tre_col]=\"${col_content}$whitespaces\"; \
                    else \
                      col_content[$c+$c_corr]=\"$(printf \"%-${col_length[\"$l:$c\"]}s\" \"${col_content:-\"\"}\")\"; \
                    fi; \
                  done <<< \"$line$delim\"; \
                  for ((k=$c+1;k<=$i_max;k++));do \
                    [[ $k -le $git_tre_col ]] && c_corr=-1 || c_corr=0; \
                    col_content[$k+$c_corr]=\"$(printf \"%-${col_length[\"$l:$k\"]:-${col_length[\"${last[$k]:-1}:$k\"]:-0}}s\" \"\")\"; \
                  done; \
                  unset col_content[0]; \
                  echo -e \"${col_content[*]}\"; \
                  unset col_content[*]; \
                done < <(eval git \"$git_log_cmd\" && echo); \
                "' "git-tably"

在tably

第一段将delim(iter)、YourLogAlias和YourLogAlias列加载到shell变量中第二个读取每列的长度第三个计算树的最大长度第四个将树加载到数组中第五个组织并打印类似表格的输出

结果:

或使用新的TreeColNumber

再次:尽情地设计自己的干净桌子,就像根据自己的需要寻找输出一样。

您还可以在评论中共享您首选的格式化Git日志别名。我会不时地在上面的文字中加入评分最高的,并添加图片。

我建议tighttps://github.com/jonas/tig,一个更好的Git命令行工具。

您可以使用Homebrew在macOS上安装tig:

$ brew install tig
$ tig

更新2:我发布了Git中可视化分支拓扑问题的改进版本,因为它更合适。该版本包含lg3,它显示了作者和提交者的信息,因此您确实应该检查一下。出于历史原因(我承认)留下这个答案,尽管我真的很想删除它。

我的两分钱:我通常在~/.gitconfig文件中使用两个别名:

[alias]
lg1 = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold green)(%ar)%C(reset) %C(white)%s%C(reset) %C(dim white)- %an%C(reset)%C(bold yellow)%d%C(reset)' --all
lg2 = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold cyan)%aD%C(reset) %C(bold green)(%ar)%C(reset)%C(bold yellow)%d%C(reset)%n''          %C(white)%s%C(reset) %C(dim white)- %an%C(reset)' --all
lg = !"git lg1"

git lg/git lg1如下所示:

git lg2看起来像这样:


(注意:现在有更多适用于此问题的答案,例如fracz、Jubobs或Harry Lee的!)

试试dita。它可以将任何ASCII图转换为图像。虽然它的设计没有考虑Git分支,但我对结果印象深刻。

源(txt文件):

        +--------+
        | hotfix |
        +---+----+
            |
--*<---*<---*
       ^
       |
       \--*<---*
               |
           +---+----+
           | master |
           +--------+

命令:

java -jar ditaa0_9.jar ascii-graph.txt

结果:

它还支持背景色、虚线、不同形状等。请参见示例。