16

BitBucket プロジェクトに次のような README.md ファイルがあります。

## Table of Contents

* [Document Organization](#document-organization)

...

## Document Organization

Sublime Text を使用してブラウザーでマークダウン プレビューを開くと、目次のリンクが適切なセクションにジャンプしますが、ファイルを BitBucket にアップロードすると、URL は正しいように見えますが、セクションにジャンプしません。

どうすればこれを修正できますか?

4

4 に答える 4

2

これもそうかもしれません。

これによると: https://confluence.atlassian.com/bitbucket/mark-up-comments-305037452.html 、bitbucket は、ドキュメント ヘッダーに基づいてリンクとアンカーを自動生成できる目次拡張機能をサポートしています。

TOC 拡張機能は、https ://pythonhosted.org/Markdown/extensions/toc.html に記載されています。

生成するドキュメントの先頭に「[TOC]」というテキストを追加します。

于 2016-06-29T19:47:52.693 に答える
2

Bitbucket の readme (またはその他のマークダウン ファイル) の目次を生成するためのスニペットを次に示します。

cat readme.md  |\
grep "^#" |\
sed 's|^[ ]*||g' |\
awk  -F, '\
BEGIN {
}{
  basic_name=$1;
  anchor=basic_name
  basic_name_no_hash=basic_name
  gsub(/^[#]* /,"",basic_name_no_hash)
  gsub(/[ ]*$/,"",basic_name_no_hash)
  subs_string=basic_name
  subs = gsub(/#/,"",subs_string);
  gsub(/^[#]+ /,"",anchor);
  gsub(/ /,"-",anchor);
  anchor = tolower(anchor);
  {for (i=0;i<subs-1;i++) printf "    " }
  print "* [" basic_name_no_hash "](#markdown-header-" anchor ")";
}
END {
}'
于 2015-03-01T23:48:06.357 に答える