├── .gitignore ├── GLOSSARY.md ├── README.md ├── SUMMARY.md ├── assets ├── csv │ └── test.csv ├── images │ ├── api.png │ ├── catalog.png │ ├── comscore.png │ ├── copy-code-button.png │ ├── faq.png │ ├── summary1.png │ └── summary2.png └── musicxml │ └── mandoline - debussy.xml ├── book.json ├── bookjson.md ├── commands.md ├── favicon.ico ├── installation.md ├── introduction.md ├── plugins.md ├── settings.md ├── structure.md ├── styles └── website.css └── themes.md /.gitignore: -------------------------------------------------------------------------------- 1 | # Node rules: 2 | ## Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files) 3 | .grunt 4 | 5 | ## Dependency directory 6 | ## Commenting this out is preferred by some people, see 7 | ## https://docs.npmjs.com/misc/faq#should-i-check-my-node_modules-folder-into-git 8 | node_modules 9 | 10 | # Book build output 11 | _book 12 | 13 | # eBook build output 14 | *.epub 15 | *.mobi 16 | *.pdf 17 | # Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion 18 | 19 | *.iml 20 | 21 | ## Directory-based project format: 22 | .idea/ 23 | # if you remove the above rule, at least ignore the following: 24 | 25 | # User-specific stuff: 26 | # .idea/workspace.xml 27 | # .idea/tasks.xml 28 | # .idea/dictionaries 29 | 30 | # Sensitive or high-churn files: 31 | # .idea/dataSources.ids 32 | # .idea/dataSources.xml 33 | # .idea/sqlDataSources.xml 34 | # .idea/dynamic.xml 35 | # .idea/uiDesigner.xml 36 | 37 | # Gradle: 38 | # .idea/gradle.xml 39 | # .idea/libraries 40 | 41 | # Mongo Explorer plugin: 42 | # .idea/mongoSettings.xml 43 | 44 | ## File-based project format: 45 | *.ipr 46 | *.iws 47 | 48 | ## Plugin-specific files: 49 | 50 | # IntelliJ 51 | /out/ 52 | 53 | # mpeltonen/sbt-idea plugin 54 | .idea_modules/ 55 | 56 | # JIRA plugin 57 | atlassian-ide-plugin.xml 58 | 59 | # Crashlytics plugin (for Android Studio and IntelliJ) 60 | com_crashlytics_export_strings.xml 61 | crashlytics.properties 62 | crashlytics-build.properties 63 | -------------------------------------------------------------------------------- /GLOSSARY.md: -------------------------------------------------------------------------------- 1 | ## Git 2 | 分散式版本控制软件 3 | 4 | ## Markdown 5 | Aaron Swartz 跟John Gruber共同设计的排版语言 6 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # 前言 2 | 主要记录 GitBook 的安装配置以及一些插件信息,当前使用的 GitBook 版本为 `3.2.3`。 3 | 4 | 推荐一下 [docsify](https://github.com/QingWei-Li/docsify),相当于一个精简的 GitBook,不需要编译,使用很方便。[这里](https://github.com/zhangjikai/docsify) 基于 doscify 做了一些修改,具体的效果可以看一下 [在线的示例](http://doc.zhangjikai.com/#/) . 5 | 6 | ## 运行 7 | * 安装 GitBook 8 | ```bash 9 | npm install gitbook-cli -g 10 | ``` 11 | * Clone 代码到本地并运行 12 | ```bash 13 | git clone git@github.com:zhangjikai/gitbook-use.git 14 | cd gitbook-use 15 | gitbook install 16 | gitbook serve 17 | ``` 18 | * 在浏览器中打开 `http://localhost:4000/` 进行访问 19 | 20 | ## 目录 21 | * [安装](installation.md) 22 | * [命令](commands.md) 23 | * [目录结构](structure.md) 24 | * [配置](settings.md) 25 | * [插件](plugins.md) 26 | * [主题](themes.md) 27 | * [bookjson](bookjson.md) 28 | 29 | ## GitBook 资源 30 | 31 | * [GitBook主页](https://www.gitbook.com/) 32 | * [Github地址](https://github.com/GitbookIO/) 33 | * [GitBook编辑器](https://www.gitbook.com/editor/osx) 34 | * [GitBook Toolchain Documentation](http://toolchain.gitbook.com/) 35 | * [GitBook Documentation](http://help.gitbook.com/) 36 | -------------------------------------------------------------------------------- /SUMMARY.md: -------------------------------------------------------------------------------- 1 | # Summary 2 | ## 基本使用 3 | * [前言](introduction.md) 4 | * [安装](installation.md) 5 | * [命令](commands.md) 6 | * [目录结构](structure.md) 7 | * [配置](settings.md) 8 | 9 | ## 扩展 10 | * [插件](plugins.md) 11 | * [主题](themes.md) 12 | * [bookjson](bookjson.md) 13 | -------------------------------------------------------------------------------- /assets/csv/test.csv: -------------------------------------------------------------------------------- 1 | 产业,数值,比重 2 | 第一产业,111,10.00% 3 | 第二产业,222,20.00% 4 | 第三产业,333,30.00% 5 | 第四产业,444,40.00% 6 | -------------------------------------------------------------------------------- /assets/images/api.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhangjikai/gitbook-use/7ef152db9dfcb9fcb02d1e75e3537f376bff5a64/assets/images/api.png -------------------------------------------------------------------------------- /assets/images/catalog.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhangjikai/gitbook-use/7ef152db9dfcb9fcb02d1e75e3537f376bff5a64/assets/images/catalog.png -------------------------------------------------------------------------------- /assets/images/comscore.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhangjikai/gitbook-use/7ef152db9dfcb9fcb02d1e75e3537f376bff5a64/assets/images/comscore.png -------------------------------------------------------------------------------- /assets/images/copy-code-button.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhangjikai/gitbook-use/7ef152db9dfcb9fcb02d1e75e3537f376bff5a64/assets/images/copy-code-button.png -------------------------------------------------------------------------------- /assets/images/faq.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhangjikai/gitbook-use/7ef152db9dfcb9fcb02d1e75e3537f376bff5a64/assets/images/faq.png -------------------------------------------------------------------------------- /assets/images/summary1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhangjikai/gitbook-use/7ef152db9dfcb9fcb02d1e75e3537f376bff5a64/assets/images/summary1.png -------------------------------------------------------------------------------- /assets/images/summary2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhangjikai/gitbook-use/7ef152db9dfcb9fcb02d1e75e3537f376bff5a64/assets/images/summary2.png -------------------------------------------------------------------------------- /assets/musicxml/mandoline - debussy.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | Mandoline (Page 1) 5 | 6 | Claude Debussy 7 | Paul Verlaine 8 | Copyright © 2002 Recordare LLC 9 | 10 | Finale 2011 for Windows 11 | Dolet Light for Finale 2011 12 | 2010-12-10 13 | 14 | 15 | 16 | 17 | 18 | 19 | 6.35 20 | 40 21 | 22 | 23 | 1760 24 | 1360 25 | 26 | 80 27 | 80 28 | 80 29 | 80 30 | 31 | 32 | 33 | 34 | 0 35 | 0 36 | 37 | 127 38 | 127 39 | 40 | 41 | 90 42 | 43 | 44 | 1.25 45 | 5 46 | 0.8333 47 | 2.0833 48 | 6.6667 49 | 1.25 50 | 0.7682 51 | 0.957 52 | 1.6667 53 | 1.3542 54 | 66 55 | 66 56 | 57 | 58 | 59 | 60 | 61 | 62 | Copyright © 2002 Recordare LLC 63 | 64 | 65 | Mandoline 66 | 67 | 68 | Claude Debussy 69 | 70 | 71 | Paul Verlaine 72 | 73 | 74 | 75 | Voice 76 | 77 | Choir Aahs 78 | 79 | 80 | 1 81 | 53 82 | 80 83 | 0 84 | 85 | 86 | 87 | Piano 88 | 89 | Grand Piano 90 | 91 | 92 | 2 93 | 1 94 | 80 95 | 0 96 | 97 | 98 | 99 | 100 | 101 | 102 | 103 | 104 | 105 | 120 106 | 0 107 | 108 | 268 109 | 110 | system 111 | 112 | 113 | 48 114 | 115 | 0 116 | major 117 | 118 | 122 | 123 | G 124 | 2 125 | 126 | 127 | 128 | 129 | Allegretto vivace 130 | 131 | 132 | 133 | 134 | 135 | quarter 136 | 137 | 126 138 | 139 | 140 | 144 141 | 142 | 143 | 144 | 145 | B 146 | 4 147 | 148 | 144 149 | 1 150 | whole 151 | 152 | 153 | 154 | 155 | 156 | 157 | 158 | 159 | 160 | 144 161 | 1 162 | 163 | 164 | 165 | 166 | 167 | 168 | 144 169 | 1 170 | 171 | 172 | 173 | 174 | 175 | 176 | dolce e leggiero 177 | 178 | 5 179 | 180 | 181 | 182 | A 183 | 4 184 | 185 | 48 186 | 1 187 | quarter 188 | up 189 | 190 | single 191 | Les 192 | 193 | 194 | 195 | 196 | A 197 | 4 198 | 199 | 24 200 | 1 201 | eighth 202 | up 203 | 204 | begin 205 | don 206 | 207 | 208 | 209 | 210 | D 211 | 5 212 | 213 | 48 214 | 1 215 | quarter 216 | down 217 | 218 | end 219 | neurs 220 | 221 | 222 | 223 | 224 | D 225 | 5 226 | 227 | 24 228 | 1 229 | eighth 230 | down 231 | 232 | single 233 | de 234 | 235 | 236 | 237 | 238 | 239 | 240 | 241 | 193 242 | 243 | 244 | 245 | 246 | F 247 | 5 248 | 249 | 36 250 | 1 251 | eighth 252 | 253 | down 254 | begin 255 | 256 | 257 | 258 | 259 | begin 260 | 261 | 262 | 263 | 264 | 265 | E 266 | 5 267 | 268 | 12 269 | 1 270 | 16th 271 | down 272 | continue 273 | backward hook 274 | 275 | 276 | 277 | 278 | 279 | 280 | F 281 | 5 282 | 283 | 24 284 | 1 285 | eighth 286 | down 287 | end 288 | 289 | middle 290 | 291 | 292 | 293 | 294 | 295 | D 296 | 5 297 | 298 | 48 299 | 1 300 | quarter 301 | down 302 | 303 | middle 304 | na 305 | 306 | 307 | 308 | 309 | A 310 | 4 311 | 312 | 24 313 | 1 314 | eighth 315 | up 316 | 317 | end 318 | des 319 | 320 | 321 | 322 | 323 | 324 | 325 | 326 | 24 327 | 1 328 | eighth 329 | 330 | 331 | 332 | 333 | 334 | 335 | 336 | 337 | G 338 | 4 339 | 340 | 24 341 | 1 342 | eighth 343 | up 344 | begin 345 | 346 | 347 | 348 | 349 | single 350 | Et 351 | 352 | 353 | 354 | 355 | G 356 | 4 357 | 358 | 24 359 | 1 360 | eighth 361 | up 362 | end 363 | 364 | single 365 | les 366 | 367 | 368 | 369 | 370 | B 371 | 4 372 | 373 | 24 374 | 1 375 | eighth 376 | down 377 | begin 378 | 379 | 380 | 381 | 382 | begin 383 | bel 384 | 385 | 386 | 387 | 388 | 389 | 390 | 11 391 | 392 | 393 | 394 | D 395 | 5 396 | 397 | 24 398 | 1 399 | eighth 400 | down 401 | continue 402 | 403 | 404 | 405 | 406 | 407 | 408 | B 409 | 4 410 | 411 | 24 412 | 1 413 | eighth 414 | down 415 | end 416 | 417 | end 418 | les 419 | 420 | 421 | 422 | 423 | 424 | 425 | -10 426 | 427 | 428 | 429 | 430 | 431 | 432 | G 433 | 4 434 | 435 | 36 436 | 1 437 | eighth 438 | 439 | up 440 | begin 441 | 442 | 443 | 444 | 445 | begin 446 | é 447 | 448 | 449 | 450 | 451 | F 452 | 4 453 | 454 | 12 455 | 1 456 | 16th 457 | up 458 | continue 459 | backward hook 460 | 461 | 462 | 463 | 464 | 465 | 466 | E 467 | 4 468 | 469 | 24 470 | 1 471 | eighth 472 | up 473 | end 474 | 475 | middle 476 | cou 477 | 478 | 479 | 480 | 481 | G 482 | 4 483 | 484 | 48 485 | 1 486 | quarter 487 | up 488 | 489 | middle 490 | teu 491 | 492 | 493 | 494 | 495 | 496 | 497 | -4 498 | 499 | 500 | 501 | G 502 | 4 503 | 504 | 24 505 | 1 506 | eighth 507 | up 508 | 509 | 510 | 511 | 512 | end 513 | ses 514 | 515 | 516 | 517 | 518 | 519 | 520 | 521 | 24 522 | 1 523 | eighth 524 | 525 | 526 | 527 | 24 528 | 1 529 | eighth 530 | 531 | 532 | 533 | C 534 | 5 535 | 536 | 24 537 | 1 538 | eighth 539 | down 540 | 541 | 542 | 543 | 544 | begin 545 | E 546 | 547 | 548 | 549 | 550 | E 551 | 5 552 | 553 | 48 554 | 1 555 | quarter 556 | down 557 | 558 | middle 559 | chan 560 | 561 | 562 | 563 | 564 | E 565 | 5 566 | 567 | 24 568 | 1 569 | eighth 570 | down 571 | 572 | 573 | 574 | 575 | end 576 | gent 577 | 578 | 579 | 580 | 581 | 582 | 583 | 584 | 196 585 | 586 | 587 | 588 | 589 | C 590 | 5 591 | 592 | 24 593 | 1 594 | eighth 595 | up 596 | begin 597 | 598 | 599 | 600 | 601 | 602 | 603 | single 604 | des 605 | 606 | 607 | 608 | 609 | G 610 | 4 611 | 612 | 24 613 | 1 614 | eighth 615 | up 616 | continue 617 | 618 | 619 | 620 | 621 | 622 | 623 | begin 624 | pro 625 | 626 | 627 | 628 | 629 | C 630 | 5 631 | 632 | 24 633 | 1 634 | eighth 635 | up 636 | end 637 | 638 | 639 | 640 | 641 | 642 | 643 | end 644 | pos 645 | 646 | 647 | 648 | 649 | B 650 | 4 651 | 652 | 48 653 | 1 654 | quarter 655 | down 656 | 657 | 658 | 659 | 660 | 661 | 662 | begin 663 | fa 664 | 665 | 666 | 667 | 668 | B 669 | 4 670 | 671 | 24 672 | 1 673 | eighth 674 | down 675 | 676 | end 677 | des 678 | 679 | 680 | 681 | 682 | 683 | 684 | 685 | 686 | 687 | 688 | 689 | 690 | B 691 | -1 692 | 4 693 | 694 | 24 695 | 1 696 | eighth 697 | flat 698 | down 699 | begin 700 | 701 | single 702 | Sous 703 | 704 | 705 | 706 | 707 | B 708 | -1 709 | 4 710 | 711 | 24 712 | 1 713 | eighth 714 | down 715 | continue 716 | 717 | single 718 | les 719 | 720 | 721 | 722 | 723 | B 724 | -1 725 | 4 726 | 727 | 24 728 | 1 729 | eighth 730 | down 731 | end 732 | 733 | begin 734 | ra 735 | 736 | 737 | 738 | 739 | C 740 | 5 741 | 742 | 24 743 | 1 744 | eighth 745 | down 746 | begin 747 | 748 | middle 749 | mu 750 | 751 | 752 | 753 | 754 | A 755 | -1 756 | 4 757 | 758 | 24 759 | 1 760 | eighth 761 | flat 762 | down 763 | continue 764 | 765 | end 766 | res 767 | 768 | 769 | 770 | 771 | C 772 | 5 773 | 774 | 24 775 | 1 776 | eighth 777 | down 778 | end 779 | 780 | begin 781 | chan 782 | 783 | 784 | 785 | 786 | 787 | 788 | -5 789 | 790 | 791 | 792 | 793 | 794 | 795 | 796 |

797 | 798 | 799 | 800 | 801 | 802 | 803 | D 804 | 5 805 | 806 | 72 807 | 1 808 | quarter 809 | 810 | down 811 | 812 | 813 | 814 | 815 | 816 | middle 817 | teu 818 | 819 | 820 | 821 | 822 | dim. 823 | 824 | 825 | 826 | 827 | -51 828 | 829 | 830 | 831 | D 832 | -1 833 | 5 834 | 835 | 72 836 | 1 837 | quarter 838 | 839 | flat 840 | down 841 | 842 | 843 | 844 | 845 | 846 | 847 | C 848 | 5 849 | 850 | 72 851 | 1 852 | quarter 853 | 854 | down 855 | 856 | 857 | 858 | C 859 | -1 860 | 5 861 | 862 | 72 863 | 1 864 | quarter 865 | 866 | flat 867 | down 868 | 869 | 870 | 871 | 872 | 873 | -7 874 | 875 | 876 | 877 | 878 | 879 | 880 | 881 | 882 | 88 883 | 884 | none 885 | 886 | 887 | 8 888 | 889 | 0 890 | major 891 | 892 | 896 | 2 897 | 898 | G 899 | 2 900 | 901 | 902 | F 903 | 4 904 | 905 | 906 | 907 | 908 | 909 | 910 | 911 | 912 | 1 913 | 914 | 915 | 916 | 917 | 918 | G 919 | 3 920 | 921 | 1 922 | eighth 923 | up 924 | 2 925 | 926 | 927 | 928 | 929 | 930 | 931 | 932 | 933 | 9 934 | 1 935 | 936 | 937 | 938 | G 939 | 4 940 | 941 | 24 942 | 1 943 | half 944 | 945 | up 946 | 1 947 | 948 | 949 | 950 | 951 | 952 | 953 | 954 | 955 | 956 | -1 957 | 1 958 | 959 | 960 | 24 961 | 962 | 963 | 964 | D 965 | 3 966 | 967 | 24 968 | 2 969 | whole 970 | 2 971 | 972 | 973 | 974 | 975 | 976 | 977 | 978 | 979 | 980 | G 981 | 2 982 | 983 | 984 | 985 | 24 986 | 1 987 | 1 988 | 989 | 990 | 24 991 | 992 | 993 | 994 | 995 | 996 | 997 | 998 | 4 999 | 2 1000 | 1001 | 1002 | 1003 | 1004 | G 1005 | 3 1006 | 1007 | 4 1008 | 2 1009 | eighth 1010 | up 1011 | 2 1012 | begin 1013 | 1014 | 1015 | 1016 | 1017 | 1018 | 1019 | 1020 | D 1021 | 4 1022 | 1023 | 4 1024 | 2 1025 | eighth 1026 | up 1027 | 2 1028 | 1029 | 1030 | 1031 | 1032 | 1033 | 1034 | 1035 | A 1036 | 4 1037 | 1038 | 4 1039 | 2 1040 | eighth 1041 | up 1042 | 2 1043 | 1044 | 1045 | 1046 | 1047 | 1048 | 1049 | G 1050 | 4 1051 | 1052 | 4 1053 | 2 1054 | eighth 1055 | down 1056 | 1 1057 | continue 1058 | 1059 | 1060 | 1061 | 1062 | 1063 | 1064 | 1065 | D 1066 | 5 1067 | 1068 | 4 1069 | 2 1070 | eighth 1071 | down 1072 | 1 1073 | 1074 | 1075 | 1076 | 1077 | 1078 | 1079 | 1080 | A 1081 | 5 1082 | 1083 | 4 1084 | 2 1085 | eighth 1086 | down 1087 | 1 1088 | 1089 | 1090 | 1091 | 1092 | 1093 | 1094 | G 1095 | 3 1096 | 1097 | 4 1098 | 2 1099 | eighth 1100 | up 1101 | 2 1102 | end 1103 | 1104 | 1105 | 1106 | 1107 | 1108 | 1109 | 1110 | D 1111 | 4 1112 | 1113 | 4 1114 | 2 1115 | eighth 1116 | up 1117 | 2 1118 | 1119 | 1120 | 1121 | 1122 | 1123 | 1124 | 1125 | A 1126 | 4 1127 | 1128 | 4 1129 | 2 1130 | eighth 1131 | up 1132 | 2 1133 | 1134 | 1135 | 1136 | 1137 | 1138 | 1139 | G 1140 | 4 1141 | 1142 | 4 1143 | 2 1144 | eighth 1145 | down 1146 | 1 1147 | begin 1148 | 1149 | 1150 | 1151 | 1152 | 1153 | 1154 | 1155 | D 1156 | 5 1157 | 1158 | 4 1159 | 2 1160 | eighth 1161 | down 1162 | 1 1163 | 1164 | 1165 | 1166 | 1167 | 1168 | 1169 | 1170 | A 1171 | 5 1172 | 1173 | 4 1174 | 2 1175 | eighth 1176 | down 1177 | 1 1178 | 1179 | 1180 | 1181 | 1182 | 1183 | 1184 | G 1185 | 3 1186 | 1187 | 4 1188 | 2 1189 | eighth 1190 | up 1191 | 2 1192 | continue 1193 | 1194 | 1195 | 1196 | 1197 | 1198 | 1199 | 1200 | D 1201 | 4 1202 | 1203 | 4 1204 | 2 1205 | eighth 1206 | up 1207 | 2 1208 | 1209 | 1210 | 1211 | 1212 | 1213 | 1214 | 1215 | A 1216 | 4 1217 | 1218 | 4 1219 | 2 1220 | eighth 1221 | up 1222 | 2 1223 | 1224 | 1225 | 1226 | 1227 | 1228 | 1229 | G 1230 | 4 1231 | 1232 | 4 1233 | 2 1234 | eighth 1235 | down 1236 | 1 1237 | end 1238 | 1239 | 1240 | 1241 | 1242 | 1243 | 1244 | 1245 | D 1246 | 5 1247 | 1248 | 4 1249 | 2 1250 | eighth 1251 | down 1252 | 1 1253 | 1254 | 1255 | 1256 | 1257 | 1258 | 1259 | 1260 | A 1261 | 5 1262 | 1263 | 4 1264 | 2 1265 | eighth 1266 | down 1267 | 1 1268 | 1269 | 1270 | 1271 | 1272 | 1273 | 1274 | 1275 | 1276 | 24 1277 | 1 1278 | 1 1279 | 1280 | 1281 | 24 1282 | 1283 | 1284 | 1285 | G 1286 | 3 1287 | 1288 | 4 1289 | 2 1290 | eighth 1291 | up 1292 | 2 1293 | begin 1294 | 1295 | 1296 | 1297 | 1298 | 1299 | 1300 | 1301 | D 1302 | 4 1303 | 1304 | 4 1305 | 2 1306 | eighth 1307 | up 1308 | 2 1309 | 1310 | 1311 | 1312 | 1313 | 1314 | 1315 | 1316 | A 1317 | 4 1318 | 1319 | 4 1320 | 2 1321 | eighth 1322 | up 1323 | 2 1324 | 1325 | 1326 | 1327 | 1328 | 1329 | 1330 | G 1331 | 4 1332 | 1333 | 4 1334 | 2 1335 | eighth 1336 | down 1337 | 1 1338 | continue 1339 | 1340 | 1341 | 1342 | 1343 | 1344 | 1345 | 1346 | D 1347 | 5 1348 | 1349 | 4 1350 | 2 1351 | eighth 1352 | down 1353 | 1 1354 | 1355 | 1356 | 1357 | 1358 | 1359 | 1360 | 1361 | A 1362 | 5 1363 | 1364 | 4 1365 | 2 1366 | eighth 1367 | down 1368 | 1 1369 | 1370 | 1371 | 1372 | 1373 | 1374 | 1375 | G 1376 | 3 1377 | 1378 | 4 1379 | 2 1380 | eighth 1381 | up 1382 | 2 1383 | end 1384 | 1385 | 1386 | 1387 | 1388 | 1389 | 1390 | 1391 | D 1392 | 4 1393 | 1394 | 4 1395 | 2 1396 | eighth 1397 | up 1398 | 2 1399 | 1400 | 1401 | 1402 | 1403 | 1404 | 1405 | 1406 | A 1407 | 4 1408 | 1409 | 4 1410 | 2 1411 | eighth 1412 | up 1413 | 2 1414 | 1415 | 1416 | 1417 | 1418 | 1419 | 1420 | G 1421 | 4 1422 | 1423 | 4 1424 | 2 1425 | eighth 1426 | down 1427 | 1 1428 | begin 1429 | 1430 | 1431 | 1432 | 1433 | 1434 | 1435 | 1436 | D 1437 | 5 1438 | 1439 | 4 1440 | 2 1441 | eighth 1442 | down 1443 | 1 1444 | 1445 | 1446 | 1447 | 1448 | 1449 | 1450 | 1451 | A 1452 | 5 1453 | 1454 | 4 1455 | 2 1456 | eighth 1457 | down 1458 | 1 1459 | 1460 | 1461 | 1462 | 1463 | 1464 | 1465 | G 1466 | 3 1467 | 1468 | 4 1469 | 2 1470 | eighth 1471 | up 1472 | 2 1473 | continue 1474 | 1475 | 1476 | 1477 | 1478 | 1479 | 1480 | 1481 | D 1482 | 4 1483 | 1484 | 4 1485 | 2 1486 | eighth 1487 | up 1488 | 2 1489 | 1490 | 1491 | 1492 | 1493 | 1494 | 1495 | 1496 | A 1497 | 4 1498 | 1499 | 4 1500 | 2 1501 | eighth 1502 | up 1503 | 2 1504 | 1505 | 1506 | 1507 | 1508 | 1509 | 1510 | G 1511 | 4 1512 | 1513 | 4 1514 | 2 1515 | eighth 1516 | down 1517 | 1 1518 | end 1519 | 1520 | 1521 | 1522 | 1523 | 1524 | 1525 | 1526 | D 1527 | 5 1528 | 1529 | 4 1530 | 2 1531 | eighth 1532 | down 1533 | 1 1534 | 1535 | 1536 | 1537 | 1538 | 1539 | 1540 | 1541 | A 1542 | 5 1543 | 1544 | 4 1545 | 2 1546 | eighth 1547 | down 1548 | 1 1549 | 1550 | 1551 | 1552 | 1553 | 1554 | 1555 | 1556 | 1557 | 24 1558 | 1 1559 | 1 1560 | 1561 | 1562 | 24 1563 | 1564 | 1565 | 1566 | G 1567 | 3 1568 | 1569 | 4 1570 | 2 1571 | eighth 1572 | up 1573 | 2 1574 | begin 1575 | 1576 | 1577 | 1578 | 1579 | 1580 | 1581 | 1582 | D 1583 | 4 1584 | 1585 | 4 1586 | 2 1587 | eighth 1588 | up 1589 | 2 1590 | 1591 | 1592 | 1593 | 1594 | 1595 | 1596 | 1597 | A 1598 | 4 1599 | 1600 | 4 1601 | 2 1602 | eighth 1603 | up 1604 | 2 1605 | 1606 | 1607 | 1608 | 1609 | 1610 | 1611 | G 1612 | 4 1613 | 1614 | 4 1615 | 2 1616 | eighth 1617 | down 1618 | 1 1619 | continue 1620 | 1621 | 1622 | 1623 | 1624 | 1625 | 1626 | 1627 | D 1628 | 5 1629 | 1630 | 4 1631 | 2 1632 | eighth 1633 | down 1634 | 1 1635 | 1636 | 1637 | 1638 | 1639 | 1640 | 1641 | 1642 | A 1643 | 5 1644 | 1645 | 4 1646 | 2 1647 | eighth 1648 | down 1649 | 1 1650 | 1651 | 1652 | 1653 | 1654 | 1655 | 1656 | G 1657 | 3 1658 | 1659 | 4 1660 | 2 1661 | eighth 1662 | up 1663 | 2 1664 | end 1665 | 1666 | 1667 | 1668 | 1669 | 1670 | 1671 | 1672 | D 1673 | 4 1674 | 1675 | 4 1676 | 2 1677 | eighth 1678 | up 1679 | 2 1680 | 1681 | 1682 | 1683 | 1684 | 1685 | 1686 | 1687 | A 1688 | 4 1689 | 1690 | 4 1691 | 2 1692 | eighth 1693 | up 1694 | 2 1695 | 1696 | 1697 | 1698 | 1699 | 1700 | 1701 | G 1702 | 4 1703 | 1704 | 4 1705 | 2 1706 | eighth 1707 | down 1708 | 1 1709 | begin 1710 | 1711 | 1712 | 1713 | 1714 | 1715 | 1716 | 1717 | D 1718 | 5 1719 | 1720 | 4 1721 | 2 1722 | eighth 1723 | down 1724 | 1 1725 | 1726 | 1727 | 1728 | 1729 | 1730 | 1731 | 1732 | A 1733 | 5 1734 | 1735 | 4 1736 | 2 1737 | eighth 1738 | down 1739 | 1 1740 | 1741 | 1742 | 1743 | 1744 | 1745 | 1746 | G 1747 | 3 1748 | 1749 | 4 1750 | 2 1751 | eighth 1752 | up 1753 | 2 1754 | continue 1755 | 1756 | 1757 | 1758 | 1759 | 1760 | 1761 | 1762 | D 1763 | 4 1764 | 1765 | 4 1766 | 2 1767 | eighth 1768 | up 1769 | 2 1770 | 1771 | 1772 | 1773 | 1774 | 1775 | 1776 | 1777 | A 1778 | 4 1779 | 1780 | 4 1781 | 2 1782 | eighth 1783 | up 1784 | 2 1785 | 1786 | 1787 | 1788 | 1789 | 1790 | 1791 | G 1792 | 4 1793 | 1794 | 4 1795 | 2 1796 | eighth 1797 | down 1798 | 1 1799 | end 1800 | 1801 | 1802 | 1803 | 1804 | 1805 | 1806 | 1807 | D 1808 | 5 1809 | 1810 | 4 1811 | 2 1812 | eighth 1813 | down 1814 | 1 1815 | 1816 | 1817 | 1818 | 1819 | 1820 | 1821 | 1822 | A 1823 | 5 1824 | 1825 | 4 1826 | 2 1827 | eighth 1828 | down 1829 | 1 1830 | 1831 | 1832 | 1833 | 1834 | 1835 | 1836 | 1837 | 1838 | 1839 | 88 1840 | 1841 | 1842 | 1843 | 16 1844 | 1 1845 | 1 1846 | 1847 | 1848 | 8 1849 | 1 1850 | 1 1851 | 1852 | 1853 | 24 1854 | 1855 | 1856 | 1857 | G 1858 | 3 1859 | 1860 | 4 1861 | 2 1862 | eighth 1863 | up 1864 | 2 1865 | begin 1866 | 1867 | 1868 | 1869 | 1870 | 1871 | 1872 | 1873 | D 1874 | 4 1875 | 1876 | 4 1877 | 2 1878 | eighth 1879 | up 1880 | 2 1881 | 1882 | 1883 | 1884 | 1885 | 1886 | 1887 | 1888 | A 1889 | 4 1890 | 1891 | 4 1892 | 2 1893 | eighth 1894 | up 1895 | 2 1896 | 1897 | 1898 | 1899 | 1900 | 1901 | 1902 | G 1903 | 4 1904 | 1905 | 4 1906 | 2 1907 | eighth 1908 | down 1909 | 1 1910 | continue 1911 | 1912 | 1913 | 1914 | 1915 | 1916 | 1917 | 1918 | D 1919 | 5 1920 | 1921 | 4 1922 | 2 1923 | eighth 1924 | down 1925 | 1 1926 | 1927 | 1928 | 1929 | 1930 | 1931 | 1932 | 1933 | A 1934 | 5 1935 | 1936 | 4 1937 | 2 1938 | eighth 1939 | down 1940 | 1 1941 | 1942 | 1943 | 1944 | 1945 | 1946 | 1947 | G 1948 | 3 1949 | 1950 | 4 1951 | 2 1952 | eighth 1953 | up 1954 | 2 1955 | end 1956 | 1957 | 1958 | 1959 | 1960 | 1961 | 1962 | 1963 | D 1964 | 4 1965 | 1966 | 4 1967 | 2 1968 | eighth 1969 | up 1970 | 2 1971 | 1972 | 1973 | 1974 | 1975 | 1976 | 1977 | 1978 | A 1979 | 4 1980 | 1981 | 4 1982 | 2 1983 | eighth 1984 | up 1985 | 2 1986 | 1987 | 1988 | 1989 | 1990 | 1991 | 1992 | G 1993 | 4 1994 | 1995 | 4 1996 | 2 1997 | eighth 1998 | down 1999 | 1 2000 | begin 2001 | 2002 | 2003 | 2004 | 2005 | 2006 | 2007 | 2008 | D 2009 | 5 2010 | 2011 | 4 2012 | 2 2013 | eighth 2014 | down 2015 | 1 2016 | 2017 | 2018 | 2019 | 2020 | 2021 | 2022 | 2023 | A 2024 | 5 2025 | 2026 | 4 2027 | 2 2028 | eighth 2029 | down 2030 | 1 2031 | 2032 | 2033 | 2034 | 2035 | 2036 | 2037 | G 2038 | 3 2039 | 2040 | 4 2041 | 2 2042 | eighth 2043 | up 2044 | 2 2045 | continue 2046 | 2047 | 2048 | 2049 | 2050 | 2051 | 2052 | 2053 | D 2054 | 4 2055 | 2056 | 4 2057 | 2 2058 | eighth 2059 | up 2060 | 2 2061 | 2062 | 2063 | 2064 | 2065 | 2066 | 2067 | 2068 | A 2069 | 4 2070 | 2071 | 4 2072 | 2 2073 | eighth 2074 | up 2075 | 2 2076 | 2077 | 2078 | 2079 | 2080 | 2081 | 2082 | G 2083 | 4 2084 | 2085 | 4 2086 | 2 2087 | eighth 2088 | down 2089 | 1 2090 | end 2091 | 2092 | 2093 | 2094 | 2095 | 2096 | 2097 | 2098 | D 2099 | 5 2100 | 2101 | 4 2102 | 2 2103 | eighth 2104 | down 2105 | 1 2106 | 2107 | 2108 | 2109 | 2110 | 2111 | 2112 | 2113 | A 2114 | 5 2115 | 2116 | 4 2117 | 2 2118 | eighth 2119 | down 2120 | 1 2121 | 2122 | 2123 | 2124 | 2125 | 2126 | 2127 | 2128 | 2129 | 2130 | F 2131 | 4 2132 | 2133 | 2134 | 2135 | 2136 | 4 2137 | 1 2138 | eighth 2139 | 1 2140 | 2141 | 2142 | 2143 | G 2144 | 4 2145 | 2146 | 4 2147 | 1 2148 | eighth 2149 | down 2150 | 1 2151 | 2152 | 2153 | 2154 | 2155 | 2156 | 2157 | 2158 | C 2159 | 5 2160 | 2161 | 4 2162 | 1 2163 | eighth 2164 | down 2165 | 1 2166 | 2167 | 2168 | 2169 | 2170 | 2171 | 2172 | 2173 | G 2174 | 5 2175 | 2176 | 4 2177 | 1 2178 | eighth 2179 | down 2180 | 1 2181 | 2182 | 2183 | 2184 | 2185 | 2186 | 2187 | 4 2188 | 1 2189 | eighth 2190 | 1 2191 | 2192 | 2193 | 2194 | 4 2195 | 1 2196 | eighth 2197 | 1 2198 | 2199 | 2200 | 2201 | B 2202 | 4 2203 | 2204 | 4 2205 | 1 2206 | eighth 2207 | down 2208 | 1 2209 | 2210 | 2211 | 2212 | 2213 | 2214 | 2215 | 2216 | D 2217 | 5 2218 | 2219 | 4 2220 | 1 2221 | eighth 2222 | down 2223 | 1 2224 | 2225 | 2226 | 2227 | 2228 | 2229 | 2230 | 2231 | B 2232 | 5 2233 | 2234 | 4 2235 | 1 2236 | eighth 2237 | down 2238 | 1 2239 | 2240 | 2241 | 2242 | 2243 | 2244 | 2245 | 4 2246 | 1 2247 | eighth 2248 | 1 2249 | 2250 | 2251 | 24 2252 | 2253 | 2254 | 2255 | C 2256 | 3 2257 | 2258 | 4 2259 | 2 2260 | eighth 2261 | down 2262 | 2 2263 | begin 2264 | 2265 | 2266 | 2267 | 2268 | 2269 | 2270 | 2271 | G 2272 | 3 2273 | 2274 | 4 2275 | 2 2276 | eighth 2277 | down 2278 | 2 2279 | 2280 | 2281 | 2282 | 2283 | 2284 | 2285 | 2286 | E 2287 | 4 2288 | 2289 | 4 2290 | 2 2291 | eighth 2292 | down 2293 | 2 2294 | 2295 | 2296 | 2297 | 2298 | 2299 | 2300 | 2301 | 2302 | 2 2303 | 2304 | 2305 | 2306 | 4 2307 | 2 2308 | eighth 2309 | 2 2310 | 2311 | 2312 | 2313 | C 2314 | 3 2315 | 2316 | 4 2317 | 2 2318 | eighth 2319 | down 2320 | 2 2321 | end 2322 | 2323 | 2324 | 2325 | 2326 | G 2327 | 3 2328 | 2329 | 4 2330 | 2 2331 | eighth 2332 | down 2333 | 2 2334 | 2335 | 2336 | 2337 | 2338 | E 2339 | 4 2340 | 2341 | 4 2342 | 2 2343 | eighth 2344 | down 2345 | 2 2346 | 2347 | 2348 | 2349 | G 2350 | 1 2351 | 3 2352 | 2353 | 4 2354 | 2 2355 | eighth 2356 | sharp 2357 | down 2358 | 2 2359 | begin 2360 | 2361 | 2362 | 2363 | 2364 | B 2365 | 3 2366 | 2367 | 4 2368 | 2 2369 | eighth 2370 | down 2371 | 2 2372 | 2373 | 2374 | 2375 | 2376 | F 2377 | 4 2378 | 2379 | 4 2380 | 2 2381 | eighth 2382 | down 2383 | 2 2384 | 2385 | 2386 | 2387 | 2388 | 2389 | 2 2390 | 2 2391 | 2392 | 2393 | 2394 | 4 2395 | 2 2396 | eighth 2397 | 2 2398 | 2399 | 2400 | 2401 | G 2402 | 1 2403 | 3 2404 | 2405 | 4 2406 | 2 2407 | eighth 2408 | down 2409 | 2 2410 | end 2411 | 2412 | 2413 | 2414 | 2415 | B 2416 | 3 2417 | 2418 | 4 2419 | 2 2420 | eighth 2421 | down 2422 | 2 2423 | 2424 | 2425 | 2426 | 2427 | F 2428 | 4 2429 | 2430 | 4 2431 | 2 2432 | eighth 2433 | down 2434 | 2 2435 | 2436 | 2437 | 2438 | 2439 | 2440 | -2 2441 | 2 2442 | 2443 | 2444 | 2445 | 2446 | 2447 | 2448 | 4 2449 | 1 2450 | eighth 2451 | 1 2452 | 2453 | 2454 | 2455 | G 2456 | 4 2457 | 2458 | 4 2459 | 1 2460 | eighth 2461 | down 2462 | 1 2463 | 2464 | 2465 | 2466 | 2467 | 2468 | 2469 | 2470 | C 2471 | 5 2472 | 2473 | 4 2474 | 1 2475 | eighth 2476 | down 2477 | 1 2478 | 2479 | 2480 | 2481 | 2482 | 2483 | 2484 | 2485 | G 2486 | 5 2487 | 2488 | 4 2489 | 1 2490 | eighth 2491 | down 2492 | 1 2493 | 2494 | 2495 | 2496 | 2497 | 2498 | 2499 | 4 2500 | 1 2501 | eighth 2502 | 1 2503 | 2504 | 2505 | 2506 | 4 2507 | 1 2508 | eighth 2509 | 1 2510 | 2511 | 2512 | 2513 | G 2514 | 4 2515 | 2516 | 4 2517 | 1 2518 | eighth 2519 | down 2520 | 1 2521 | 2522 | 2523 | 2524 | 2525 | 2526 | 2527 | 2528 | B 2529 | 4 2530 | 2531 | 4 2532 | 1 2533 | eighth 2534 | down 2535 | 1 2536 | 2537 | 2538 | 2539 | 2540 | 2541 | 2542 | 2543 | G 2544 | 5 2545 | 2546 | 4 2547 | 1 2548 | eighth 2549 | down 2550 | 1 2551 | 2552 | 2553 | 2554 | 2555 | 2556 | 2557 | 4 2558 | 1 2559 | eighth 2560 | 1 2561 | 2562 | 2563 | 24 2564 | 2565 | 2566 | 2567 | C 2568 | 3 2569 | 2570 | 4 2571 | 2 2572 | eighth 2573 | down 2574 | 2 2575 | begin 2576 | 2577 | 2578 | 2579 | 2580 | 2581 | 2582 | 2583 | G 2584 | 3 2585 | 2586 | 4 2587 | 2 2588 | eighth 2589 | natural 2590 | down 2591 | 2 2592 | 2593 | 2594 | 2595 | 2596 | 2597 | 2598 | 2599 | E 2600 | 4 2601 | 2602 | 4 2603 | 2 2604 | eighth 2605 | down 2606 | 2 2607 | 2608 | 2609 | 2610 | 2611 | 2612 | 2613 | 4 2614 | 2 2615 | eighth 2616 | 2 2617 | 2618 | 2619 | 2620 | C 2621 | 3 2622 | 2623 | 4 2624 | 2 2625 | eighth 2626 | down 2627 | 2 2628 | end 2629 | 2630 | 2631 | 2632 | 2633 | G 2634 | 3 2635 | 2636 | 4 2637 | 2 2638 | eighth 2639 | down 2640 | 2 2641 | 2642 | 2643 | 2644 | 2645 | E 2646 | 4 2647 | 2648 | 4 2649 | 2 2650 | eighth 2651 | down 2652 | 2 2653 | 2654 | 2655 | 2656 | G 2657 | 3 2658 | 2659 | 4 2660 | 2 2661 | eighth 2662 | down 2663 | 2 2664 | begin 2665 | 2666 | 2667 | 2668 | 2669 | B 2670 | 3 2671 | 2672 | 4 2673 | 2 2674 | eighth 2675 | down 2676 | 2 2677 | 2678 | 2679 | 2680 | 2681 | D 2682 | 4 2683 | 2684 | 4 2685 | 2 2686 | eighth 2687 | down 2688 | 2 2689 | 2690 | 2691 | 2692 | 4 2693 | 2 2694 | eighth 2695 | 2 2696 | 2697 | 2698 | 2699 | 2700 | 2701 | -1 2702 | 2 2703 | 2704 | 2705 | 2706 | G 2707 | 3 2708 | 2709 | 4 2710 | 2 2711 | eighth 2712 | down 2713 | 2 2714 | end 2715 | 2716 | 2717 | 2718 | 2719 | B 2720 | 3 2721 | 2722 | 4 2723 | 2 2724 | eighth 2725 | down 2726 | 2 2727 | 2728 | 2729 | 2730 | 2731 | D 2732 | 4 2733 | 2734 | 4 2735 | 2 2736 | eighth 2737 | down 2738 | 2 2739 | 2740 | 2741 | 2742 | 2743 | 2744 | 2745 | G 2746 | 2 2747 | 2748 | 2749 | 2750 | 2751 | 4 2752 | 1 2753 | eighth 2754 | 1 2755 | 2756 | 2757 | 2758 | C 2759 | 5 2760 | 2761 | 4 2762 | 1 2763 | eighth 2764 | down 2765 | 1 2766 | 2767 | 2768 | 2769 | 2770 | E 2771 | 5 2772 | 2773 | 4 2774 | 1 2775 | eighth 2776 | down 2777 | 1 2778 | 2779 | 2780 | 2781 | 2782 | C 2783 | 6 2784 | 2785 | 4 2786 | 1 2787 | eighth 2788 | down 2789 | 1 2790 | 2791 | 2792 | 2793 | 4 2794 | 1 2795 | eighth 2796 | 1 2797 | 2798 | 2799 | 2800 | 4 2801 | 1 2802 | eighth 2803 | 1 2804 | 2805 | 2806 | 2807 | D 2808 | 5 2809 | 2810 | 4 2811 | 1 2812 | eighth 2813 | down 2814 | 1 2815 | 2816 | 2817 | 2818 | 2819 | G 2820 | 1 2821 | 5 2822 | 2823 | 4 2824 | 1 2825 | eighth 2826 | sharp 2827 | down 2828 | 1 2829 | 2830 | 2831 | 2832 | 2833 | E 2834 | 6 2835 | 2836 | 4 2837 | 1 2838 | eighth 2839 | down 2840 | 1 2841 | 2842 | 2843 | 2844 | 4 2845 | 1 2846 | eighth 2847 | 1 2848 | 2849 | 2850 | 24 2851 | 2852 | 2853 | 2854 | C 2855 | 4 2856 | 2857 | 4 2858 | 2 2859 | eighth 2860 | up 2861 | 2 2862 | begin 2863 | 2864 | 2865 | 2866 | 2867 | E 2868 | 4 2869 | 2870 | 4 2871 | 2 2872 | eighth 2873 | up 2874 | 2 2875 | 2876 | 2877 | 2878 | 2879 | G 2880 | 4 2881 | 2882 | 4 2883 | 2 2884 | eighth 2885 | up 2886 | 2 2887 | 2888 | 2889 | 2890 | 4 2891 | 2 2892 | eighth 2893 | 2 2894 | 2895 | 2896 | 2897 | C 2898 | 4 2899 | 2900 | 4 2901 | 2 2902 | eighth 2903 | up 2904 | 2 2905 | end 2906 | 2907 | 2908 | 2909 | 2910 | E 2911 | 4 2912 | 2913 | 4 2914 | 2 2915 | eighth 2916 | up 2917 | 2 2918 | 2919 | 2920 | 2921 | 2922 | G 2923 | 4 2924 | 2925 | 4 2926 | 2 2927 | eighth 2928 | up 2929 | 2 2930 | 2931 | 2932 | 2933 | B 2934 | 3 2935 | 2936 | 4 2937 | 2 2938 | eighth 2939 | up 2940 | 2 2941 | begin 2942 | 2943 | 2944 | 2945 | 2946 | D 2947 | 4 2948 | 2949 | 4 2950 | 2 2951 | eighth 2952 | up 2953 | 2 2954 | 2955 | 2956 | 2957 | 2958 | G 2959 | 1 2960 | 4 2961 | 2962 | 4 2963 | 2 2964 | eighth 2965 | sharp 2966 | up 2967 | 2 2968 | 2969 | 2970 | 2971 | 4 2972 | 2 2973 | eighth 2974 | 2 2975 | 2976 | 2977 | 2978 | B 2979 | 3 2980 | 2981 | 4 2982 | 2 2983 | eighth 2984 | up 2985 | 2 2986 | end 2987 | 2988 | 2989 | 2990 | 2991 | D 2992 | 4 2993 | 2994 | 4 2995 | 2 2996 | eighth 2997 | up 2998 | 2 2999 | 3000 | 3001 | 3002 | 3003 | G 3004 | 1 3005 | 4 3006 | 3007 | 4 3008 | 2 3009 | eighth 3010 | up 3011 | 2 3012 | 3013 | 3014 | 3015 | 3016 | 3017 | 3018 | 78 3019 | 3020 | 3021 | 87 3022 | 3023 | 3024 | 3025 | 3026 | 4 3027 | 1 3028 | eighth 3029 | 1 3030 | 3031 | 3032 | 3033 | C 3034 | 5 3035 | 3036 | 4 3037 | 1 3038 | eighth 3039 | down 3040 | 1 3041 | 3042 | 3043 | 3044 | 3045 | E 3046 | 5 3047 | 3048 | 4 3049 | 1 3050 | eighth 3051 | down 3052 | 1 3053 | 3054 | 3055 | 3056 | 3057 | C 3058 | 6 3059 | 3060 | 4 3061 | 1 3062 | eighth 3063 | down 3064 | 1 3065 | 3066 | 3067 | 3068 | 4 3069 | 1 3070 | eighth 3071 | 1 3072 | 3073 | 3074 | 3075 | 4 3076 | 1 3077 | eighth 3078 | 1 3079 | 3080 | 3081 | 3082 | D 3083 | 5 3084 | 3085 | 4 3086 | 1 3087 | eighth 3088 | down 3089 | 1 3090 | 3091 | 3092 | 3093 | 3094 | G 3095 | 1 3096 | 5 3097 | 3098 | 4 3099 | 1 3100 | eighth 3101 | sharp 3102 | down 3103 | 1 3104 | 3105 | 3106 | 3107 | 3108 | E 3109 | 6 3110 | 3111 | 4 3112 | 1 3113 | eighth 3114 | down 3115 | 1 3116 | 3117 | 3118 | 3119 | 4 3120 | 1 3121 | eighth 3122 | 1 3123 | 3124 | 3125 | 24 3126 | 3127 | 3128 | 3129 | C 3130 | 4 3131 | 3132 | 4 3133 | 2 3134 | eighth 3135 | up 3136 | 2 3137 | begin 3138 | 3139 | 3140 | 3141 | 3142 | E 3143 | 4 3144 | 3145 | 4 3146 | 2 3147 | eighth 3148 | up 3149 | 2 3150 | 3151 | 3152 | 3153 | 3154 | G 3155 | 4 3156 | 3157 | 4 3158 | 2 3159 | eighth 3160 | natural 3161 | up 3162 | 2 3163 | 3164 | 3165 | 3166 | 4 3167 | 2 3168 | eighth 3169 | 2 3170 | 3171 | 3172 | 3173 | C 3174 | 4 3175 | 3176 | 4 3177 | 2 3178 | eighth 3179 | up 3180 | 2 3181 | end 3182 | 3183 | 3184 | 3185 | 3186 | E 3187 | 4 3188 | 3189 | 4 3190 | 2 3191 | eighth 3192 | up 3193 | 2 3194 | 3195 | 3196 | 3197 | 3198 | G 3199 | 4 3200 | 3201 | 4 3202 | 2 3203 | eighth 3204 | up 3205 | 2 3206 | 3207 | 3208 | 3209 | B 3210 | 3 3211 | 3212 | 4 3213 | 2 3214 | eighth 3215 | up 3216 | 2 3217 | begin 3218 | 3219 | 3220 | 3221 | 3222 | D 3223 | 4 3224 | 3225 | 4 3226 | 2 3227 | eighth 3228 | up 3229 | 2 3230 | 3231 | 3232 | 3233 | 3234 | G 3235 | 1 3236 | 4 3237 | 3238 | 4 3239 | 2 3240 | eighth 3241 | sharp 3242 | up 3243 | 2 3244 | 3245 | 3246 | 3247 | 4 3248 | 2 3249 | eighth 3250 | 2 3251 | 3252 | 3253 | 3254 | B 3255 | 3 3256 | 3257 | 4 3258 | 2 3259 | eighth 3260 | up 3261 | 2 3262 | end 3263 | 3264 | 3265 | 3266 | 3267 | D 3268 | 4 3269 | 3270 | 4 3271 | 2 3272 | eighth 3273 | up 3274 | 2 3275 | 3276 | 3277 | 3278 | 3279 | G 3280 | 1 3281 | 4 3282 | 3283 | 4 3284 | 2 3285 | eighth 3286 | up 3287 | 2 3288 | 3289 | 3290 | 3291 | 3292 | 3293 | 3294 | 4 3295 | 1 3296 | eighth 3297 | 1 3298 | 3299 | 3300 | 3301 | 3302 | 3303 | -1 3304 | 1 3305 | 3306 | 3307 | 3308 | D 3309 | 5 3310 | 3311 | 4 3312 | 1 3313 | eighth 3314 | down 3315 | 1 3316 | 3317 | 3318 | 3319 | 3320 | B 3321 | -1 3322 | 5 3323 | 3324 | 4 3325 | 1 3326 | eighth 3327 | flat 3328 | down 3329 | 1 3330 | 3331 | 3332 | 3333 | 3334 | F 3335 | 6 3336 | 3337 | 4 3338 | 1 3339 | eighth 3340 | down 3341 | 1 3342 | 3343 | 3344 | 3345 | 4 3346 | 1 3347 | eighth 3348 | 1 3349 | 3350 | 3351 | 3352 | 4 3353 | 1 3354 | eighth 3355 | 1 3356 | 3357 | 3358 | 3359 | A 3360 | -1 3361 | 5 3362 | 3363 | 4 3364 | 1 3365 | eighth 3366 | flat 3367 | down 3368 | 1 3369 | 3370 | 3371 | 3372 | 3373 | C 3374 | 6 3375 | 3376 | 4 3377 | 1 3378 | eighth 3379 | down 3380 | 1 3381 | 3382 | 3383 | 3384 | 3385 | A 3386 | -1 3387 | 6 3388 | 3389 | 4 3390 | 1 3391 | eighth 3392 | flat 3393 | down 3394 | 1 3395 | 3396 | 3397 | 3398 | 4 3399 | 1 3400 | eighth 3401 | 1 3402 | 3403 | 3404 | 24 3405 | 3406 | 3407 | 3408 | 3409 | 3410 | 1 3411 | 2 3412 | 3413 | 3414 | 3415 | B 3416 | -1 3417 | 3 3418 | 3419 | 4 3420 | 2 3421 | eighth 3422 | flat 3423 | up 3424 | 2 3425 | begin 3426 | 3427 | 3428 | 3429 | 3430 | D 3431 | 4 3432 | 3433 | 4 3434 | 2 3435 | eighth 3436 | up 3437 | 2 3438 | 3439 | 3440 | 3441 | 3442 | F 3443 | 4 3444 | 3445 | 4 3446 | 2 3447 | eighth 3448 | up 3449 | 2 3450 | 3451 | 3452 | 3453 | 4 3454 | 2 3455 | eighth 3456 | 2 3457 | 3458 | 3459 | 3460 | B 3461 | -1 3462 | 3 3463 | 3464 | 4 3465 | 2 3466 | eighth 3467 | up 3468 | 2 3469 | end 3470 | 3471 | 3472 | 3473 | 3474 | D 3475 | 4 3476 | 3477 | 4 3478 | 2 3479 | eighth 3480 | up 3481 | 2 3482 | 3483 | 3484 | 3485 | 3486 | F 3487 | 4 3488 | 3489 | 4 3490 | 2 3491 | eighth 3492 | up 3493 | 2 3494 | 3495 | 3496 | 3497 | F 3498 | 4 3499 | 3500 | 3501 | 3502 | 3503 | A 3504 | -1 3505 | 3 3506 | 3507 | 4 3508 | 2 3509 | eighth 3510 | flat 3511 | down 3512 | 2 3513 | begin 3514 | 3515 | 3516 | 3517 | 3518 | C 3519 | 4 3520 | 3521 | 4 3522 | 2 3523 | eighth 3524 | down 3525 | 2 3526 | 3527 | 3528 | 3529 | 3530 | E 3531 | -1 3532 | 4 3533 | 3534 | 4 3535 | 2 3536 | eighth 3537 | flat 3538 | down 3539 | 2 3540 | 3541 | 3542 | 3543 | 4 3544 | 2 3545 | eighth 3546 | 2 3547 | 3548 | 3549 | 3550 | A 3551 | -1 3552 | 3 3553 | 3554 | 4 3555 | 2 3556 | eighth 3557 | down 3558 | 2 3559 | end 3560 | 3561 | 3562 | 3563 | 3564 | C 3565 | 4 3566 | 3567 | 4 3568 | 2 3569 | eighth 3570 | down 3571 | 2 3572 | 3573 | 3574 | 3575 | 3576 | E 3577 | -1 3578 | 4 3579 | 3580 | 4 3581 | 2 3582 | eighth 3583 | down 3584 | 2 3585 | 3586 | 3587 | 3588 | 3589 | 3590 | -1 3591 | 2 3592 | 3593 | 3594 | 3595 | 3596 | 3597 | 3598 | 3599 |

3600 | 3601 | 3602 | 1 3603 | 3604 | 3605 | 3606 | 3607 | 4 3608 | 1 3609 | eighth 3610 | 1 3611 | 3612 | 3613 | 3614 | dim. 3615 | 3616 | 3617 | 3618 | 3619 | -1 3620 | 1 3621 | 3622 | 3623 | 3624 | D 3625 | 6 3626 | 3627 | 4 3628 | 1 3629 | eighth 3630 | down 3631 | 1 3632 | begin 3633 | 3634 | 3635 | 3636 | 3637 | 3638 | 3639 | 3640 | 3641 | 3642 | 3643 | G 3644 | 6 3645 | 3646 | 4 3647 | 1 3648 | eighth 3649 | down 3650 | 1 3651 | 3652 | 3653 | 3654 | 3655 | B 3656 | 6 3657 | 3658 | 4 3659 | 1 3660 | eighth 3661 | down 3662 | 1 3663 | 3664 | 3665 | 3666 | B 3667 | 5 3668 | 3669 | 4 3670 | 1 3671 | eighth 3672 | down 3673 | 1 3674 | end 3675 | 3676 | 3677 | 3678 | 3679 | 3680 | 3681 | 3682 | 3683 | 3684 | 3685 | D 3686 | 6 3687 | 3688 | 4 3689 | 1 3690 | eighth 3691 | down 3692 | 1 3693 | 3694 | 3695 | 3696 | 3697 | G 3698 | 6 3699 | 3700 | 4 3701 | 1 3702 | eighth 3703 | down 3704 | 1 3705 | 3706 | 3707 | 3708 | 4 3709 | 1 3710 | eighth 3711 | 1 3712 | 3713 | 3714 | 3715 | B 3716 | -1 3717 | 5 3718 | 3719 | 4 3720 | 1 3721 | eighth 3722 | flat 3723 | down 3724 | 1 3725 | begin 3726 | 3727 | 3728 | 3729 | 3730 | 3731 | 3732 | 3733 | 3734 | 3735 | 3736 | D 3737 | -1 3738 | 6 3739 | 3740 | 4 3741 | 1 3742 | eighth 3743 | flat 3744 | down 3745 | 1 3746 | 3747 | 3748 | 3749 | 3750 | G 3751 | -1 3752 | 6 3753 | 3754 | 4 3755 | 1 3756 | eighth 3757 | flat 3758 | down 3759 | 1 3760 | 3761 | 3762 | 3763 | G 3764 | -1 3765 | 5 3766 | 3767 | 4 3768 | 1 3769 | eighth 3770 | flat 3771 | down 3772 | 1 3773 | end 3774 | 3775 | 3776 | 3777 | 3778 | 3779 | 3780 | 3781 | 3782 | 3783 | 3784 | B 3785 | -1 3786 | 5 3787 | 3788 | 4 3789 | 1 3790 | eighth 3791 | down 3792 | 1 3793 | 3794 | 3795 | 3796 | 3797 | D 3798 | -1 3799 | 6 3800 | 3801 | 4 3802 | 1 3803 | eighth 3804 | down 3805 | 1 3806 | 3807 | 3808 | 3809 | 3810 | 3811 | -2 3812 | 1 3813 | 3814 | 3815 | 24 3816 | 3817 | 3818 | 3819 | G 3820 | 3 3821 | 3822 | 12 3823 | 2 3824 | quarter 3825 | 3826 | down 3827 | 2 3828 | 3829 | 3830 | 3831 | 3832 | 3833 | 3834 | 3835 | B 3836 | 3 3837 | 3838 | 12 3839 | 2 3840 | quarter 3841 | 3842 | natural 3843 | down 3844 | 2 3845 | 3846 | 3847 | 3848 | 3849 | D 3850 | 4 3851 | 3852 | 12 3853 | 2 3854 | quarter 3855 | 3856 | down 3857 | 2 3858 | 3859 | 3860 | 3861 | B 3862 | -1 3863 | 3 3864 | 3865 | 12 3866 | 2 3867 | quarter 3868 | 3869 | flat 3870 | down 3871 | 2 3872 | 3873 | 3874 | 3875 | 3876 | D 3877 | -1 3878 | 4 3879 | 3880 | 12 3881 | 2 3882 | quarter 3883 | 3884 | flat 3885 | down 3886 | 2 3887 | 3888 | 3889 | 3890 | 3891 | G 3892 | -1 3893 | 4 3894 | 3895 | 12 3896 | 2 3897 | quarter 3898 | 3899 | flat 3900 | down 3901 | 2 3902 | 3903 | 3904 | 3905 | 3906 | 3907 | 3908 | G 3909 | 2 3910 | 3911 | 3912 | 3913 | 3914 | 4 3915 | 1 3916 | eighth 3917 | 1 3918 | 3919 | 3920 | 3921 | G 3922 | 5 3923 | 3924 | 4 3925 | 1 3926 | eighth 3927 | natural 3928 | down 3929 | 1 3930 | begin 3931 | 3932 | 3933 | 3934 | 3935 | 3936 | 3937 | 3938 | C 3939 | 6 3940 | 3941 | 4 3942 | 1 3943 | eighth 3944 | natural 3945 | down 3946 | 1 3947 | 3948 | 3949 | 3950 | 3951 | E 3952 | 6 3953 | 3954 | 4 3955 | 1 3956 | eighth 3957 | natural 3958 | down 3959 | 1 3960 | 3961 | 3962 | 3963 | E 3964 | 5 3965 | 3966 | 4 3967 | 1 3968 | eighth 3969 | down 3970 | 1 3971 | end 3972 | 3973 | 3974 | 3975 | 3976 | 3977 | 3978 | 3979 | G 3980 | 5 3981 | 3982 | 4 3983 | 1 3984 | eighth 3985 | down 3986 | 1 3987 | 3988 | 3989 | 3990 | 3991 | C 3992 | 6 3993 | 3994 | 4 3995 | 1 3996 | eighth 3997 | down 3998 | 1 3999 | 4000 | 4001 | 4002 | 4 4003 | 1 4004 | eighth 4005 | 1 4006 | 4007 | 4008 | 4009 | E 4010 | -1 4011 | 5 4012 | 4013 | 4 4014 | 1 4015 | eighth 4016 | flat 4017 | down 4018 | 1 4019 | begin 4020 | 4021 | 4022 | 4023 | 4024 | 4025 | 4026 | 4027 | G 4028 | -1 4029 | 5 4030 | 4031 | 4 4032 | 1 4033 | eighth 4034 | flat 4035 | down 4036 | 1 4037 | 4038 | 4039 | 4040 | 4041 | C 4042 | -1 4043 | 6 4044 | 4045 | 4 4046 | 1 4047 | eighth 4048 | flat 4049 | down 4050 | 1 4051 | 4052 | 4053 | 4054 | 4055 | 4056 | 1 4057 | 1 4058 | 4059 | 4060 | 4061 | C 4062 | -1 4063 | 5 4064 | 4065 | 4 4066 | 1 4067 | eighth 4068 | flat 4069 | down 4070 | 1 4071 | end 4072 | 4073 | 4074 | 4075 | 4076 | 4077 | 4078 | 4079 | E 4080 | -1 4081 | 5 4082 | 4083 | 4 4084 | 1 4085 | eighth 4086 | down 4087 | 1 4088 | 4089 | 4090 | 4091 | 4092 | G 4093 | -1 4094 | 5 4095 | 4096 | 4 4097 | 1 4098 | eighth 4099 | down 4100 | 1 4101 | 4102 | 4103 | 24 4104 | 4105 | 4106 | 4107 | C 4108 | 4 4109 | 4110 | 12 4111 | 2 4112 | quarter 4113 | 4114 | up 4115 | 2 4116 | 4117 | 4118 | 4119 | 4120 | E 4121 | 4 4122 | 4123 | 12 4124 | 2 4125 | quarter 4126 | 4127 | natural 4128 | up 4129 | 2 4130 | 4131 | 4132 | 4133 | 4134 | G 4135 | 4 4136 | 4137 | 12 4138 | 2 4139 | quarter 4140 | 4141 | natural 4142 | up 4143 | 2 4144 | 4145 | 4146 | 4147 | E 4148 | -1 4149 | 4 4150 | 4151 | 12 4152 | 2 4153 | quarter 4154 | 4155 | flat 4156 | up 4157 | 2 4158 | 4159 | 4160 | 4161 | 4162 | 4163 | 4164 | 4165 | G 4166 | -1 4167 | 4 4168 | 4169 | 12 4170 | 2 4171 | quarter 4172 | 4173 | flat 4174 | up 4175 | 2 4176 | 4177 | 4178 | 4179 | 4180 | C 4181 | -1 4182 | 5 4183 | 4184 | 12 4185 | 2 4186 | quarter 4187 | 4188 | flat 4189 | up 4190 | 2 4191 | 4192 | 4193 | 4194 | 4195 | 4196 | -------------------------------------------------------------------------------- /book.json: -------------------------------------------------------------------------------- 1 | { 2 | "title": "GitBook 使用教程", 3 | "description": "记录 GitBook 的配置和一些插件的使用", 4 | "author": "zhangjikai", 5 | "output.name": "site", 6 | "language": "zh-hans", 7 | "gitbook": "3.2.3", 8 | "root": ".", 9 | "structure": { 10 | "readme": "introduction.md" 11 | }, 12 | "links": { 13 | "sidebar": { 14 | "Home": "http://www.zhangjikai.com" 15 | } 16 | }, 17 | "plugins": [ 18 | "-lunr", 19 | "-search", 20 | "-highlight", 21 | "-livereload", 22 | "search-plus@^0.0.11", 23 | "simple-page-toc@^0.1.1", 24 | "github@^2.0.0", 25 | "github-buttons@2.1.0", 26 | "edit-link@^2.0.2", 27 | "disqus@^0.1.0", 28 | "prism@^2.1.0", 29 | "prism-themes@^0.0.2", 30 | "advanced-emoji@^0.2.1", 31 | "anchors@^0.7.1", 32 | "include-codeblock@^3.0.2", 33 | "ace@^0.3.2", 34 | "emphasize@^1.1.0", 35 | "katex@^1.1.3", 36 | "splitter@^0.0.8", 37 | "mermaid-gb3@2.1.0", 38 | "tbfed-pagefooter@^0.0.1", 39 | "expandable-chapters-small@^0.1.7", 40 | "sectionx@^3.1.0", 41 | "donate@^1.0.2", 42 | "local-video@^1.0.1", 43 | "sitemap-general@^0.1.1", 44 | "anchor-navigation-ex@0.1.8", 45 | "favicon@^0.0.2", 46 | "todo@^0.1.3", 47 | "3-ba@^0.9.0", 48 | "terminal@^0.3.2", 49 | "alerts@^0.2.0", 50 | "include-csv@^0.1.0", 51 | "puml@^1.0.1", 52 | "musicxml@^1.0.2", 53 | "klipse@^1.2.0", 54 | "versions-select@^0.1.1", 55 | "rss@^3.0.2", 56 | "-sharing", 57 | "sharing-plus@^0.0.2", 58 | "graph@^0.1.0", 59 | "chart@^0.2.0" 60 | ], 61 | 62 | "pluginsConfig": { 63 | "theme-default": { 64 | "showLevel": true 65 | }, 66 | "disqus": { 67 | "shortName": "gitbookuse" 68 | }, 69 | "prism": { 70 | "css": [ 71 | "prism-themes/themes/prism-base16-ateliersulphurpool.light.css" 72 | ] 73 | }, 74 | "github": { 75 | "url": "https://github.com/zhangjikai/gitbook-use" 76 | }, 77 | "github-buttons": { 78 | "repo": "zhangjikai/gitbook-use", 79 | "types": [ 80 | "star" 81 | ], 82 | "size": "small" 83 | }, 84 | "include-codeblock": { 85 | "template": "ace", 86 | "unindent": true, 87 | "edit": true 88 | }, 89 | "sharing": { 90 | "douban": false, 91 | "facebook": false, 92 | "google": true, 93 | "hatenaBookmark": false, 94 | "instapaper": false, 95 | "line": false, 96 | "linkedin": true, 97 | "messenger": false, 98 | "pocket": false, 99 | "qq": false, 100 | "qzone": false, 101 | "stumbleupon": false, 102 | "twitter": false, 103 | "viber": false, 104 | "vk": false, 105 | "weibo": true, 106 | "whatsapp": false, 107 | "all": [ 108 | "facebook", "google", "twitter", 109 | "weibo", "instapaper", "linkedin", 110 | "pocket", "stumbleupon", "qq", "qzone" 111 | ] 112 | }, 113 | "tbfed-pagefooter": { 114 | "copyright": "Copyright © zhangjikai.com 2017", 115 | "modify_label": "该文件修订时间:", 116 | "modify_format": "YYYY-MM-DD HH:mm:ss" 117 | }, 118 | "3-ba": { 119 | "token": "ff100361cdce95dd4c8fb96b4009f7bc" 120 | }, 121 | "donate": { 122 | "wechat": "https://zhangjikai.com/resource/weixin.png", 123 | "alipay": "https://zhangjikai.com/resource/alipay.png", 124 | "title": "", 125 | "button": "赏", 126 | "alipayText": "支付宝打赏", 127 | "wechatText": "微信打赏" 128 | }, 129 | "simple-page-toc": { 130 | "maxDepth": 3, 131 | "skipFirstH1": true 132 | }, 133 | "edit-link": { 134 | "base": "https://github.com/zhangjikai/gitbook-use/edit/master", 135 | "label": "Edit This Page" 136 | }, 137 | "sitemap-general": { 138 | "prefix": "http://gitbook.zhangjikai.com" 139 | }, 140 | "anchor-navigation-ex": { 141 | "isRewritePageTitle": false, 142 | "tocLevel1Icon": "fa fa-hand-o-right", 143 | "tocLevel2Icon": "fa fa-hand-o-right", 144 | "tocLevel3Icon": "fa fa-hand-o-right" 145 | }, 146 | "sectionx": { 147 | "tag": "b" 148 | }, 149 | "favicon": { 150 | "shortcut": "favicon.ico", 151 | "bookmark": "favicon.ico" 152 | }, 153 | "terminal": { 154 | "copyButtons": true, 155 | "fade": false, 156 | "style": "flat" 157 | }, 158 | 159 | "versions": { 160 | "options": [ 161 | { 162 | "value": "http://gitbook.zhangjikai.com", 163 | "text": "v3.2.3" 164 | }, 165 | { 166 | "value": "http://gitbook.zhangjikai.com/v2/", 167 | "text": "v2.6.4" 168 | } 169 | ] 170 | }, 171 | 172 | "rss": { 173 | "title": "GitBook 使用教程", 174 | "description": "记录 GitBook 的配置和一些插件的使用", 175 | "author": "Jikai Zhang", 176 | "feed_url": "http://gitbook.zhangjikai.com/rss", 177 | "site_url": "http://gitbook.zhangjikai.com/", 178 | "managingEditor": "me@zhangjikai.com", 179 | "webMaster": "me@zhangjikai.com", 180 | "categories": [ 181 | "gitbook" 182 | ] 183 | } 184 | } 185 | } 186 | -------------------------------------------------------------------------------- /bookjson.md: -------------------------------------------------------------------------------- 1 | # book.json配置文件 2 | 3 | 4 | [import](book.json) 5 | 6 | -------------------------------------------------------------------------------- /commands.md: -------------------------------------------------------------------------------- 1 | # 命令 2 | 3 | 这里主要介绍一下 GitBook 的命令行工具 `gitbook-cli` 的一些命令, 首先说明两点: 4 | * `gitbook-cli` 和 `gitbook` 是两个软件 5 | * `gitbook-cli` 会将下载的 gitbook 的不同版本放到 `~/.gitbook`中, 可以通过设置`GITBOOK_DIR`环境变量来指定另外的文件夹 6 | 7 | 8 | 9 | **列出gitbook所有的命令** 10 | ```bash 11 | gitbook help 12 | ``` 13 | 14 | **输出`gitbook-cli`的帮助信息** 15 | ```bash 16 | gitbook --help 17 | ``` 18 | 19 | **生成静态网页** 20 | ```bash 21 | gitbook build 22 | ``` 23 | **生成静态网页并运行服务器** 24 | ```bash 25 | gitbook serve 26 | ``` 27 | 28 | **生成时指定gitbook的版本, 本地没有会先下载** 29 | ```bash 30 | gitbook build --gitbook=2.0.1 31 | ``` 32 | 33 | **列出本地所有的gitbook版本** 34 | ```bash 35 | gitbook ls 36 | ``` 37 | 38 | **列出远程可用的gitbook版本** 39 | ```bash 40 | gitbook ls-remote 41 | ``` 42 | 43 | **安装对应的gitbook版本** 44 | ```bash 45 | gitbook fetch 标签/版本号 46 | ``` 47 | 48 | **更新到gitbook的最新版本** 49 | ```bash 50 | gitbook update 51 | ``` 52 | 53 | **卸载对应的gitbook版本** 54 | ```bash 55 | gitbook uninstall 2.0.1 56 | ``` 57 | 58 | **指定log的级别** 59 | ```bash 60 | gitbook build --log=debug 61 | ``` 62 | 63 | **输出错误信息** 64 | ```bash 65 | gitbook builid --debug 66 | ``` 67 | -------------------------------------------------------------------------------- /favicon.ico: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhangjikai/gitbook-use/7ef152db9dfcb9fcb02d1e75e3537f376bff5a64/favicon.ico -------------------------------------------------------------------------------- /installation.md: -------------------------------------------------------------------------------- 1 | # GitBook安装 2 | 下面介绍在本地如何安装 GitBook,如果不需要本地调试 & 不需要获得生成的 html 文件,可以直接使用 [官网](https://www.gitbook.com/) 提供的服务。 3 | 4 | 5 | ## 环境要求 6 | 7 | * NodeJS(v4.0.0及以上) 8 | 9 | ## 通过NPM安装 10 | 运行下面的命令进行安装 11 | ```bash 12 | npm install gitbook-cli -g 13 | ``` 14 | 其中`gitbook-cli`是gitbook的一个命令行工具, 通过它可以在电脑上安装和管理gitbook的多个版本. 15 | 16 | ## 编辑书籍 17 | gitbook 官方已经提供了一个本地的[编辑器](https://www.gitbook.com/editor/osx), 使用它可以方便的编写书籍(不需要手动的写SUMMARY.md), 并且支持windows、mac、linux 三种平台, 所以强烈建议使用编辑器编写书籍. 18 | 19 | ## 预览书籍 20 | 使用下列命令会运行一个服务器, 通过`http://localhost:4000/`可以预览书籍 21 | ```bash 22 | gitbook serve 23 | ``` 24 | 运行该命令后会在书籍的文件夹中生成一个 `_book` 文件夹, 里面的内容即为生成的 html 文件. 25 | 我们可以使用下面命令来生成网页而不开启服务器 26 | ```bash 27 | gitbook build 28 | ``` 29 | -------------------------------------------------------------------------------- /introduction.md: -------------------------------------------------------------------------------- 1 | # 前言 2 | 主要记录GitBook的安装配置以及一些插件信息, 下面是GitBook的一些资源 3 | 4 | * [GitBook主页](https://www.gitbook.com/) 5 | * [Github地址](https://github.com/GitbookIO/) 6 | * [GitBook编辑器](https://www.gitbook.com/editor/osx) 7 | * [GitBook Toolchain Documentation](http://toolchain.gitbook.com/) 8 | * [GitBook Documentation](http://help.gitbook.com/) 9 | 10 | --- 11 | > 如若转载请标明出处. 12 | -------------------------------------------------------------------------------- /plugins.md: -------------------------------------------------------------------------------- 1 | # GitBook 插件 2 | 3 | 记录一些实用的插件, 如果要指定插件的版本可以使用 `plugin@0.3.1`。下面的插件在 GitBook 的 `3.2.3` 版本中可以正常工作,因为一些插件可能不会随着 GitBook 版本的升级而升级,即下面的插件可能不适用高版本的 GitBook,所以这里指定了 GitBook 的版本。另外本文记录的插件在 Linux 下都是可以正确工作的,windows 系统没有测试。这里只是列举了一部分插件,如果有其它的需求,可以到 [插件官网](https://plugins.gitbook.com/) 区搜索相关插件。 4 | 5 | 6 | - [Disqus - Disqus 评论](#disqus) 7 | - [Search Plus - 支持中文搜索](#search-plus) 8 | - [Prsim - 使用 Prism.js 高亮代码](#prsim) 9 | - [Advanced Emoji - 支持 emoji 表情](#advanced-emoji) 10 | - [Github - 添加github图标](#github) 11 | - [Github Buttons - 添加项目在 Github 上的 star、fork、watch 信息](#github-buttons) 12 | - [Ace Plugin - 支持ace](#ace-plugin) 13 | - [Emphasize - 为文字加上底色](#emphasize) 14 | - [KaTex - 支持数学公式](#katex) 15 | - [Include Codeblock - 用代码块显示包含文件的内容](#include-codeblock) 16 | - [Splitter - 使侧边栏的宽度可以自由调节](#splitter) 17 | - [Mermaid-gb3 - 支持渲染 Mermaid 图表](#mermaid-gb3) 18 | - [Puml - 支持渲染 uml 图 ](#puml) 19 | - [Graph - 使用 function-plot 绘制数学函数图](#graph) 20 | - [Chart - 绘制图形](#chart) 21 | - [Sharing-plus - 分享当前页面](#sharing-plus) 22 | - [Tbfed-pagefooter - 为页面添加页脚](#tbfed-pagefooter) 23 | - [Expandable-chapters-small - 使左侧的章节目录可以折叠](#expandable-chapters-small) 24 | - [Toggle-chapters - 左侧章节目录可以折叠](#Toggle-chapters) 25 | - [Sectionx - 将页面分块显示](#sectionx) 26 | - [GA - Google 统计](#ga) 27 | - [3-ba - 百度统计](#3-ba) 28 | - [Donate - 打赏插件](#donate) 29 | - [Local Video - 使用 Video.js 播放本地视频](#local-video) 30 | - [Simple-page-toc - 自动生成本页的目录结构](#simple-page-toc) 31 | - [Anchors - 添加 Github 风格的锚点](#anchors) 32 | - [Anchor-navigation-ex - 添加Toc到侧边悬浮导航以及回到顶部按钮](#anchor-navigation-ex) 33 | - [Edit Link - 链接到当前页源文件上](#edit-link) 34 | - [Sitemap-general - 生成sitemap](#sitemap-general) 35 | - [Favicon - 更改网站的 favicon.ico](#favicon) 36 | - [Todo - 添加 Todo 功能](#todo) 37 | - [Terminal - 模拟终端样式](#terminal) 38 | - [Copy-code-button - 为代码块添加复制按钮](#copy-code-button) 39 | - [Alerts - 添加不同 alerts 样式的 blockquotes](#alerts) 40 | - [Include-csv - 显示 csv 文件内容](#include-csv) 41 | - [Musicxml - 支持 musicxml 格式的乐谱渲染](#musicxml) 42 | - [Klipse - 集成 Kplise (online code evaluator)](#klipse) 43 | - [Versions-select - 添加版本选择的下拉菜单](#versions-select) 44 | - [Rss - 添加 rss 订阅功能](#rss) 45 | - [Theme-comscore - 修改标题和表格颜色](#theme-comscore) 46 | - [summary - 自动生成目录](#summary) 47 | 48 | ## Disqus 49 | 50 | 添加disqus评论 51 | 52 | [插件地址](https://plugins.gitbook.com/plugin/disqus) 53 | ```json 54 | "plugins": [ 55 | "disqus" 56 | ], 57 | "pluginsConfig": { 58 | "disqus": { 59 | "shortName": "gitbookuse" 60 | } 61 | } 62 | ``` 63 | 64 | ## Search Plus 65 | 支持中文搜索, 需要将默认的 `search` 和 `lunr` 插件去掉。 66 | 67 | [插件地址](https://plugins.gitbook.com/plugin/search-plus) 68 | 69 | ```json 70 | { 71 | "plugins": ["-lunr", "-search", "search-plus"] 72 | } 73 | ``` 74 | 75 | ## Prism 76 | 使用 `Prism.js` 为语法添加高亮显示,需要将 `highlight` 插件去掉。该插件自带的主题样式较少,可以再安装 `prism-themes` 插件,里面多提供了几种样式,具体的样式可以参考 [这里](https://github.com/PrismJS/prism-themes),在设置样式时要注意设置 css 文件名,而不是样式名。 77 | 78 | [Prism 插件地址](https://plugins.gitbook.com/plugin/prism)    [prism-themes 插件地址](https://plugins.gitbook.com/plugin/prism-themes) 79 | 80 | ```json 81 | { 82 | "plugins": [ 83 | "prism", 84 | "-highlight" 85 | ], 86 | "pluginsConfig": { 87 | "prism": { 88 | "css": [ 89 | "prism-themes/themes/prism-base16-ateliersulphurpool.light.css" 90 | ] 91 | } 92 | } 93 | } 94 | ``` 95 | 如果需要修改背景色、字体大小等,可以在 `website.css` 定义 `pre[class*="language-"]` 类来修改,下面是一个示例: 96 | ```css 97 | pre[class*="language-"] { 98 | border: none; 99 | background-color: #f7f7f7; 100 | font-size: 1em; 101 | line-height: 1.2em; 102 | } 103 | ``` 104 | ## Advanced Emoji 105 | 支持emoji表情 106 | 107 | [emoij表情列表](http://www.emoji-cheat-sheet.com/) 108 | [插件地址](https://plugins.gitbook.com/plugin/advanced-emoji) 109 | 110 | ```json 111 | "plugins": [ 112 | "advanced-emoji" 113 | ] 114 | ``` 115 | 使用示例: 116 | 117 | :bowtie: :smile: :laughing: :blush: :smiley: :relaxed: 118 | 119 | ## Github 120 | 添加github图标 121 | 122 | [插件地址](https://plugins.gitbook.com/plugin/github) 123 | ```json 124 | "plugins": [ 125 | "github" 126 | ], 127 | "pluginsConfig": { 128 | "github": { 129 | "url": "https://github.com/zhangjikai" 130 | } 131 | } 132 | ``` 133 | ## Github Buttons 134 | 添加项目在 github 上的 star,watch,fork情况 135 | 136 | [插件地址](https://plugins.gitbook.com/plugin/github-buttons) 137 | 138 | ```json 139 | { 140 | "plugins": [ 141 | "github-buttons" 142 | ], 143 | "pluginsConfig": { 144 | "github-buttons": { 145 | "repo": "zhangjikai/gitbook-use", 146 | "types": [ 147 | "star", 148 | "watch", 149 | "fork" 150 | ], 151 | "size": "small" 152 | } 153 | } 154 | } 155 | ``` 156 | 157 | ## Ace Plugin 158 | 159 | [插件地址](https://plugins.gitbook.com/plugin/ace) 160 | 161 | 使 GitBook 支持ace 。默认情况下,line-height 为 1,会使代码显得比较挤,而作者好像没提供修改行高的选项,如果需要修改行高,可以到 `node_modules -> github-plugin-ace -> assets -> ace.js` 中加入下面两行代码 (30 行左右的位置): 162 | ```js 163 | editor.container.style.lineHeight = 1.25; 164 | editor.renderer.updateFontSize(); 165 | ``` 166 | 不过上面的做法有个问题就是,每次使用 `gitbook install` 安装新的插件之后,代码又会重置为原来的样子。另外可以在 `website.css` 中加入下面的 css 代码来指定 ace 字体的大小 167 | ```css 168 | .aceCode { 169 | font-size: 14px !important; 170 | } 171 | ``` 172 | 173 | 使用插件: 174 | ```json 175 | "plugins": [ 176 | "ace" 177 | ] 178 | ``` 179 | 使用示例: 180 | 181 | {%ace edit=true, lang='c_cpp'%} 182 | // This is a hello world program for C. 183 | #include 184 | 185 | int main(){ 186 | printf("Hello World!"); 187 | return 1; 188 | } 189 | {%endace%} 190 | 191 | ## Emphasize 192 | 为文字加上底色 193 | 194 | [插件地址](https://plugins.gitbook.com/plugin/emphasize) 195 | ```json 196 | "plugins": [ 197 | "emphasize" 198 | ] 199 | ``` 200 | 使用示例: 201 | 202 | This text is {% em %}highlighted !{% endem %} 203 | 204 | This text is {% em %}highlighted with **markdown**!{% endem %} 205 | 206 | This text is {% em type="green" %}highlighted in green!{% endem %} 207 | 208 | This text is {% em type="red" %}highlighted in red!{% endem %} 209 | 210 | This text is {% em color="#ff0000" %}highlighted with a custom color!{% endem %} 211 | 212 | ## KaTex 213 | 为了支持数学公式, 我们可以使用`KaTex`和`MathJax`插件, 官网上说`Katex`速度要快于`MathJax` 214 | 215 | [插件地址](https://plugins.gitbook.com/plugin/katex) 216 | [MathJax使用LaTeX语法编写数学公式教程](http://iori.sinaapp.com/17.html) 217 | ```json 218 | "plugins": [ 219 | "katex" 220 | ] 221 | ``` 222 | 使用示例: 223 | 224 | When {% math %}a \ne 0{% endmath %}, there are two solutions to {% math %}(ax^2 + bx + c = 0){% endmath %} and they are {% math %}x = {-b \pm \sqrt{b^2-4ac} \over 2a}.{% endmath %} 225 | 226 | $$ 227 | \int_{-\infty}^\infty g(x) dx 228 | $$ 229 | 230 | $$ 231 | 1 \over 3 232 | $$ 233 | 234 | ## Include Codeblock 235 | 使用代码块的格式显示所包含文件的内容. 该文件必须存在。插件提供了一些配置,可以区插件官网查看。如果同时使用 ace 和本插件,本插件要在 ace 插件前面加载。 236 | 237 | [插件地址](https://plugins.gitbook.com/plugin/include-codeblock) 238 | ```json 239 | { 240 | "plugins": [ 241 | "include-codeblock" 242 | ], 243 | "pluginsConfig": { 244 | "include-codeblock": { 245 | "template": "ace", 246 | "unindent": "true", 247 | "theme": "monokai" 248 | } 249 | } 250 | } 251 | ``` 252 | 使用示例: 253 | 254 | [import](styles/website.css) 255 | 256 | ## Splitter 257 | 使侧边栏的宽度可以自由调节 258 | 259 | ![](https://raw.githubusercontent.com/yoshidax/gitbook-plugin-splitter/master/gitbook-splitter-demo.gif) 260 | 261 | [插件地址](https://plugins.gitbook.com/plugin/splitter) 262 | ```json 263 | "plugins": [ 264 | "splitter" 265 | ] 266 | ``` 267 | ## Mermaid-gb3 268 | 支持渲染[Mermaid](https://github.com/knsv/mermaid)图表 269 | [插件地址](https://plugins.gitbook.com/plugin/mermaid-gb3) 270 | ```json 271 | "plugins": [ 272 | "mermaid-gb3" 273 | ] 274 | ``` 275 | 使用示例: 276 | ```mermaid 277 | graph TD; 278 | A-->B; 279 | A-->C; 280 | B-->D; 281 | C-->D; 282 | ``` 283 | 284 | ## Puml 285 | 使用 PlantUML 展示 uml 图。 286 | 287 | [插件地址](https://plugins.gitbook.com/plugin/puml) 288 | [PlantUML 地址](http://plantuml.com/) 289 | 290 | ``` 291 | { 292 | "plugins": ["puml"] 293 | } 294 | ``` 295 | 使用示例: 296 | ``` 297 | {% plantuml %} 298 | Class Stage 299 | Class Timeout { 300 | +constructor:function(cfg) 301 | +timeout:function(ctx) 302 | +overdue:function(ctx) 303 | +stage: Stage 304 | } 305 | Stage <|-- Timeout 306 | {% endplantuml %} 307 | ``` 308 | 效果如下所示: 309 | 310 | {% plantuml %} 311 | Class Stage 312 | Class Timeout { 313 | +constructor:function(cfg) 314 | +timeout:function(ctx) 315 | +overdue:function(ctx) 316 | +stage: Stage 317 | } 318 | Stage <|-- Timeout 319 | {% endplantuml %} 320 | 321 | 322 | ## Graph 323 | 324 | 使用 function-plot 绘制数学函数图。 325 | 326 | [插件地址](https://plugins.gitbook.com/plugin/graph) 327 | [function-plot](https://mauriciopoppe.github.io/function-plot/) 328 | 329 | ```json 330 | { 331 | "plugins": [ "graph" ], 332 | } 333 | ``` 334 | 335 | 下面是一个示例,需要注意的是 `{% graph %}` 块中的内容必须是合法的 JSON 格式。 336 | ``` 337 | {% graph %} 338 | { 339 | "title": "1/x * cos(1/x)", 340 | "grid": true, 341 | "xAxis": { 342 | "domain": [0.01, 1] 343 | }, 344 | "yAxis": { 345 | "domain": [-100, 100] 346 | }, 347 | "data": [{ 348 | "fn": "1/x * cos(1/x)", 349 | "closed": true 350 | }] 351 | } 352 | {% endgraph %} 353 | ``` 354 | 355 | 效果如下所示: 356 | {% graph %} 357 | { 358 | "title": "1/x * cos(1/x)", 359 | "grid": true, 360 | "xAxis": { 361 | "domain": [0.01, 1] 362 | }, 363 | "yAxis": { 364 | "domain": [-100, 100] 365 | }, 366 | "data": [{ 367 | "fn": "1/x * cos(1/x)", 368 | "closed": true 369 | }] 370 | } 371 | {% endgraph %} 372 | 373 | ## Chart 374 | 使用 C3.js 或者 Highcharts 绘制图形。 375 | 376 | [插件地址](https://plugins.gitbook.com/plugin/chart) 377 | [C3.js](https://github.com/c3js/c3) 378 | [highcharts](https://github.com/highcharts/highcharts) 379 | 380 | ```json 381 | { 382 | "plugins": [ "chart" ], 383 | "pluginsConfig": { 384 | "chart": { 385 | "type": "c3" 386 | } 387 | } 388 | } 389 | ``` 390 | type 可以是 `c3` 或者 `highcharts`, 默认是 `c3`. 391 | 392 | 下面是一个示例: 393 | ``` 394 | {% chart %} 395 | { 396 | "data": { 397 | "type": "bar", 398 | "columns": [ 399 | ["data1", 30, 200, 100, 400, 150, 250], 400 | ["data2", 50, 20, 10, 40, 15, 25] 401 | ], 402 | "axes": { 403 | "data2": "y2" 404 | } 405 | }, 406 | "axis": { 407 | "y2": { 408 | "show": true 409 | } 410 | } 411 | } 412 | {% endchart %} 413 | ``` 414 | 效果如下所示: 415 | {% chart %} 416 | { 417 | "data": { 418 | "type": "bar", 419 | "columns": [ 420 | ["data1", 30, 200, 100, 400, 150, 250], 421 | ["data2", 50, 20, 10, 40, 15, 25] 422 | ], 423 | "axes": { 424 | "data2": "y2" 425 | } 426 | }, 427 | "axis": { 428 | "y2": { 429 | "show": true 430 | } 431 | } 432 | } 433 | {% endchart %} 434 | 435 | ## Sharing-plus 436 | 分享当前页面,比默认的 sharing 插件多了一些分享方式。 437 | 438 | [插件地址](https://plugins.gitbook.com/plugin/sharing-plus) 439 | 440 | ```json 441 | plugins: ["-sharing", "sharing-plus"] 442 | ``` 443 | 配置: 444 | 445 | ```json 446 | "pluginsConfig": { 447 | "sharing": { 448 | "douban": false, 449 | "facebook": false, 450 | "google": true, 451 | "hatenaBookmark": false, 452 | "instapaper": false, 453 | "line": true, 454 | "linkedin": true, 455 | "messenger": false, 456 | "pocket": false, 457 | "qq": false, 458 | "qzone": true, 459 | "stumbleupon": false, 460 | "twitter": false, 461 | "viber": false, 462 | "vk": false, 463 | "weibo": true, 464 | "whatsapp": false, 465 | "all": [ 466 | "facebook", "google", "twitter", 467 | "weibo", "instapaper", "linkedin", 468 | "pocket", "stumbleupon" 469 | ] 470 | } 471 | } 472 | ``` 473 | ## Tbfed-pagefooter 474 | 为页面添加页脚 475 | 476 | [插件地址](https://plugins.gitbook.com/plugin/tbfed-pagefooter) 477 | ```json 478 | "plugins": [ 479 | "tbfed-pagefooter" 480 | ], 481 | "pluginsConfig": { 482 | "tbfed-pagefooter": { 483 | "copyright":"Copyright © zhangjikai.com 2017", 484 | "modify_label": "该文件修订时间:", 485 | "modify_format": "YYYY-MM-DD HH:mm:ss" 486 | } 487 | } 488 | ``` 489 | ## Expandable-chapters-small 490 | 使左侧的章节目录可以折叠 491 | 492 | [插件地址](https://plugins.gitbook.com/plugin/expandable-chapters-small) 493 | 494 | ```json 495 | plugins: ["expandable-chapters-small"] 496 | ``` 497 | 498 | ## Toggle-chapters 499 | 使左侧的章节目录可以折叠。相比expandable-chapters, 没有折叠箭头符号,并且当前只有一项可以展开。参考:https://blog.csdn.net/lintcgirl/article/details/54314113 500 | 501 | [插件地址](https://plugins.gitbook.com/plugin/toggle-chapters) 502 | 503 | ```json 504 | plugins: ["toggle-chapters"] 505 | ``` 506 | 507 | ## Sectionx 508 | 将页面分块显示,标签的 tag 最好是使用 b 标签,如果使用 h1-h6 可能会和其他插件冲突。 509 | [插件地址](https://plugins.gitbook.com/plugin/sectionx) 510 | ```json 511 | { 512 | "plugins": [ 513 | "sectionx" 514 | ], 515 | "pluginsConfig": { 516 | "sectionx": { 517 | "tag": "b" 518 | } 519 | } 520 | } 521 | ``` 522 | 使用示例 523 | 524 | 525 | 526 | Insert markdown content here (you should start with h3 if you use heading). 527 | 528 | 529 | 530 | ## GA 531 | Google 统计 532 | [插件地址](https://plugins.gitbook.com/plugin/ga) 533 | ```json 534 | "plugins": [ 535 | "ga" 536 | ], 537 | "pluginsConfig": { 538 | "ga": { 539 | "token": "UA-XXXX-Y" 540 | } 541 | } 542 | ``` 543 | ## 3-ba 544 | 百度统计 545 | [插件地址](https://plugins.gitbook.com/plugin/3-ba) 546 | ```json 547 | { 548 | "plugins": ["3-ba"], 549 | "pluginsConfig": { 550 | "3-ba": { 551 | "token": "xxxxxxxx" 552 | } 553 | } 554 | } 555 | ``` 556 | ## Donate 557 | 打赏插件 558 | [插件地址](https://plugins.gitbook.com/plugin/donate) 559 | ```json 560 | "plugins": [ 561 | "donate" 562 | ], 563 | "pluginsConfig": { 564 | "donate": { 565 | "wechat": "https://zhangjikai.com/resource/weixin.png", 566 | "alipay": "https://zhangjikai.com/resource/alipay.png", 567 | "title": "", 568 | "button": "赏", 569 | "alipayText": "支付宝打赏", 570 | "wechatText": "微信打赏" 571 | } 572 | } 573 | ``` 574 | 575 | ## Local Video 576 | 使用Video.js 播放本地视频 577 | [插件地址](https://plugins.gitbook.com/plugin/local-video) 578 | ```json 579 | "plugins": [ "local-video" ] 580 | ``` 581 | 使用示例:为了使视频可以自适应,我们指定视频的`width`为100%,并设置宽高比为`16:9`,如下面所示 582 | ``` 583 | {% raw %} 584 |

588 | To view this video please enable JavaScript, and consider upgrading to a web browser that 589 | supports HTML5 video 590 |

591 | 592 | {% endraw %} 593 | ``` 594 | 另外我们还要再配置下css,即在website.css中加入 595 | ```css 596 | .video-js { 597 | width:100%; 598 | height: 100%; 599 | } 600 | ``` 601 |
602 | {% raw %} 603 | 610 | {% endraw %} 611 | 612 | ## Simple-page-toc 613 | 自动生成本页的目录结构。另外 GitBook 在处理重复的标题时有些问题,所以尽量不适用重复的标题。 614 | [插件地址](https://plugins.gitbook.com/plugin/simple-page-toc) 615 | ```json 616 | { 617 | "plugins" : [ 618 | "simple-page-toc" 619 | ], 620 | "pluginsConfig": { 621 | "simple-page-toc": { 622 | "maxDepth": 3, 623 | "skipFirstH1": true 624 | } 625 | } 626 | } 627 | ``` 628 | 使用方法: 在需要生成目录的地方加上 <!-- toc --> 629 | 630 | ## Anchors 631 | 添加 Github 风格的锚点样式 632 | 633 | ![](https://cloud.githubusercontent.com/assets/2666107/3465465/9fc9a502-0266-11e4-80ca-09a1dad1473e.png) 634 | 635 | [插件地址](https://plugins.gitbook.com/plugin/anchors) 636 | ```json 637 | "plugins" : [ "anchors" ] 638 | ``` 639 | ## Anchor-navigation-ex 640 | 添加Toc到侧边悬浮导航以及回到顶部按钮。需要注意以下两点: 641 | * 本插件只会提取 h[1-3] 标签作为悬浮导航 642 | * 只有按照以下顺序嵌套才会被提取 643 | ``` 644 | # h1 645 | ## h2 646 | ### h3 647 | 必须要以 h1 开始,直接写 h2 不会被提取 648 | ## h2 649 | ``` 650 | 651 | [插件地址](https://plugins.gitbook.com/plugin/anchor-navigation-ex) 652 | ```json 653 | { 654 | "plugins": [ 655 | "anchor-navigation-ex" 656 | ], 657 | "pluginsConfig": { 658 | "anchor-navigation-ex": { 659 | "isRewritePageTitle": true, 660 | "isShowTocTitleIcon": true, 661 | "tocLevel1Icon": "fa fa-hand-o-right", 662 | "tocLevel2Icon": "fa fa-hand-o-right", 663 | "tocLevel3Icon": "fa fa-hand-o-right" 664 | } 665 | } 666 | } 667 | ``` 668 | 669 | 670 | 671 | ## Edit Link 672 | 如果将 GitBook 的源文件保存到github或者其他的仓库上,使用该插件可以链接到当前页的源文件上。 673 | [插件地址](https://plugins.gitbook.com/plugin/edit-link) 674 | ```json 675 | "plugins": ["edit-link"], 676 | "pluginsConfig": { 677 | "edit-link": { 678 | "base": "https://github.com/USER/REPO/edit/BRANCH", 679 | "label": "Edit This Page" 680 | } 681 | } 682 | ``` 683 | 684 | ## Sitemap-general 685 | 生成sitemap 686 | [插件地址](https://plugins.gitbook.com/plugin/sitemap-general) 687 | ```json 688 | { 689 | "plugins": ["sitemap-general"], 690 | "pluginsConfig": { 691 | "sitemap-general": { 692 | "prefix": "http://gitbook.zhangjikai.com" 693 | } 694 | } 695 | } 696 | ``` 697 | ## Favicon 698 | 更改网站的 favicon.ico 699 | [插件地址](https://plugins.gitbook.com/plugin/favicon) 700 | ```json 701 | { 702 | "plugins": [ 703 | "favicon" 704 | ], 705 | "pluginsConfig": { 706 | "favicon": { 707 | "shortcut": "assets/images/favicon.ico", 708 | "bookmark": "assets/images/favicon.ico", 709 | "appleTouch": "assets/images/apple-touch-icon.png", 710 | "appleTouchMore": { 711 | "120x120": "assets/images/apple-touch-icon-120x120.png", 712 | "180x180": "assets/images/apple-touch-icon-180x180.png" 713 | } 714 | } 715 | } 716 | } 717 | ``` 718 | ## Todo 719 | 添加 Todo 功能。默认的 checkbox 会向右偏移 2em,如果不希望偏移,可以在 `website.css` 里加上下面的代码: 720 | ```css 721 | input[type=checkbox]{ 722 | margin-left: -2em; 723 | } 724 | ``` 725 | [插件地址](https://plugins.gitbook.com/plugin/todo) 726 | 727 | ```json 728 | "plugins": ["todo"] 729 | ``` 730 | 使用示例: 731 | - [ ] write some articles 732 | - [x] drink a cup of tea 733 | 734 | ## Terminal 735 | 模拟终端显示,主要用于显示命令以及多行输出,不过写起来有些麻烦。 736 | 737 | [插件地址](https://plugins.gitbook.com/plugin/terminal) 738 | ```json 739 | { 740 | "plugins": [ 741 | "terminal" 742 | ], 743 | "pluginsConfig": { 744 | "terminal": { 745 | "copyButtons": true, 746 | "fade": false, 747 | "style": "flat" 748 | } 749 | } 750 | } 751 | ``` 752 | 753 | 现在支持 6 种标签: 754 | * command: Command "executed" in the terminal. 755 | * delimiter: Sequence of characters between the prompt and the command. 756 | * error: Error message. 757 | * path: Directory path shown in the prompt. 758 | * prompt: Prompt of the user. 759 | * warning: Warning message. 760 | 761 | 标签的使用格式如下所示: 762 | ``` 763 | **[ 内容] 764 | ``` 765 | 为了使标签正常工作,需要在代码块的第一行加入 `**[termial]` 标记,下面是一个完整的示例: 766 | 767 |
```
 768 | **[terminal]
 769 | **[prompt foo@joe]**[path ~]**[delimiter  $ ]**[command ./myscript]
 770 | Normal output line. Nothing special here...
 771 | But...
 772 | You can add some colors. What about a warning message?
 773 | **[warning [WARNING] The color depends on the theme. Could look normal too]
 774 | What about an error message?
 775 | **[error [ERROR] This is not the error you are looking for]
 776 | ```
777 | 778 | 效果如下所示: 779 | ``` 780 | **[terminal] 781 | **[prompt foo@joe]**[path ~]**[delimiter $ ]**[command ./myscript] 782 | Normal output line. Nothing special here... 783 | But... 784 | You can add some colors. What about a warning message? 785 | **[warning [WARNING] The color depends on the theme. Could look normal too] 786 | What about an error message? 787 | **[error [ERROR] This is not the error you are looking for] 788 | ``` 789 | 790 | terminal 支持下面 5 种样式,如果需要更换样式,在 pluginsConfig 里配置即可。 791 | * black: Just that good old black terminal everybody loves. 792 | * classic: Looking for green color font over a black background? This is for you. 793 | * flat: Oh, flat colors. I love flat colors. Everything looks modern with them. 794 | * ubuntu: Admit it or not, but Ubuntu have a good looking terminal. 795 | * white: Make your terminal to blend in with your GitBook. 796 | 797 | ## Copy-code-button 798 | 为代码块添加复制的按钮。 799 | 800 | [插件地址](https://plugins.gitbook.com/plugin/copy-code-button) 801 | 802 | ```json 803 | { 804 | "plugins": ["copy-code-button"] 805 | } 806 | ``` 807 | 效果如下图所示: 808 | 809 | ![](assets/images/copy-code-button.png) 810 | 811 | ## Alerts 812 | 添加不同 alerts 样式的 blockquotes,目前包含 info, warning, danger 和 success 四种样式。 813 | 814 | [插件地址](https://plugins.gitbook.com/plugin/alerts) 815 | 816 | ```json 817 | { 818 | "plugins": ["alerts"] 819 | } 820 | ``` 821 | 下面是使用示例: 822 | ``` 823 | Info styling 824 | > **[info] For info** 825 | > 826 | > Use this for infomation messages. 827 | 828 | Warning styling 829 | > **[warning] For warning** 830 | > 831 | > Use this for warning messages. 832 | 833 | Danger styling 834 | > **[danger] For danger** 835 | > 836 | > Use this for danger messages. 837 | 838 | Success styling 839 | > **[success] For info** 840 | > 841 | > Use this for success messages. 842 | ``` 843 | 效果如下所示: 844 | 845 | Info styling 846 | > **[info] For info** 847 | > 848 | > Use this for infomation messages. 849 | 850 | Warning styling 851 | > **[warning] For warning** 852 | > 853 | > Use this for warning messages. 854 | 855 | Danger styling 856 | > **[danger] For danger** 857 | > 858 | > Use this for danger messages. 859 | 860 | Success styling 861 | > **[success] For info** 862 | > 863 | > Use this for success messages. 864 | 865 | ## Include-csv 866 | 展示 csv 文件。 867 | 868 | [插件地址](https://plugins.gitbook.com/plugin/include-csv) 869 | 870 | ```json 871 | { 872 | "plugins": ["include-csv"] 873 | } 874 | ``` 875 | 使用示例: 876 | ``` 877 | {% includeCsv src="./assets/csv/test.csv", useHeader="true" %} {% endincludeCsv %} 878 | ``` 879 | 效果如下所示: 880 | 881 | {% includeCsv src="./assets/csv/test.csv", useHeader="true" %} {% endincludeCsv %} 882 | 883 | ## Musicxml 884 | 支持 musicxml 格式的乐谱渲染。 885 | 886 | [插件地址](https://plugins.gitbook.com/plugin/musicxml) 887 | [musicXML](http://www.musicxml.com/) 888 | 889 | ``` 890 | { 891 | "plugins": ["musicxml"] 892 | } 893 | ``` 894 | 895 | 下面是一个示例,需要注意的是 block 中的内容必须是一个合法的 musicxml 文件路径,并且不能有换行和空格。 896 | ``` 897 | {% musicxml %}assets/musicxml/mandoline - debussy.xml{% endmusicxml %} 898 | ``` 899 | 效果如下所示 900 | {% musicxml %}assets/musicxml/mandoline - debussy.xml{% endmusicxml %} 901 | 902 | ## Klipse 903 | 集成 Klipse (online code evaluator) 904 | 905 | [插件地址](https://plugins.gitbook.com/plugin/klipse) 906 | [Klipse](https://github.com/viebel/klipse) 907 | 908 | ``` 909 | { 910 | "plugins": ["klipse"] 911 | } 912 | ``` 913 | 914 | klipse 目前支持下面的语言: 915 | * javascript: evaluation is done with the javascript function eval and pretty printing of the result is done with pretty-format 916 | * clojure[script]: evaluation is done with Self-Hosted Clojurescript 917 | * ruby: evaluation is done with Opal 918 | * C++: evaluation is done with JSCPP 919 | * python: evaluation is done with Skulpt 920 | * scheme: evaluation is done with BiwasScheme 921 | * PHP: evaluation is done with Uniter 922 | * BrainFuck 923 | * JSX 924 | * EcmaScript2017 925 | * Google Charts: See Interactive Business Report with Google Charts. 926 | 927 | 下面是一个使用示例: 928 |
```eval-python
 929 | print [x + 1 for x in range(10)]
 930 | ```
931 | 932 | 效果如下所示: 933 | ```eval-python 934 | print [x + 1 for x in range(10)] 935 | ``` 936 | 937 | ## Versions-select 938 | 添加版本选择的下拉菜单,针对文档有多个版本的情况。 939 | 940 | [插件地址](https://plugins.gitbook.com/plugin/versions-select) 941 | 942 | ``` 943 | { 944 | "plugins": [ "versions-select" ], 945 | "pluginsConfig": { 946 | "versions": { 947 | "options": [ 948 | { 949 | "value": "http://gitbook.zhangjikai.com", 950 | "text": "v3.2.2" 951 | }, 952 | { 953 | "value": "http://gitbook.zhangjikai.com/v2/", 954 | "text": "v2.6.4" 955 | } 956 | ] 957 | } 958 | } 959 | } 960 | ``` 961 | 962 | 我们可以自定义 css 来修改 select 的显示样式: 963 | ```css 964 | .versions-select select { 965 | height: 2em; 966 | line-height: 2em; 967 | border-radius: 4px; 968 | background: #efefef; 969 | } 970 | ``` 971 | 972 | 效果见左上角。 973 | 974 | ## RSS 975 | 添加 rss 订阅功能。 976 | 977 | [插件地址](https://plugins.gitbook.com/plugin/rss) 978 | 979 | ```json 980 | { 981 | "plugins": [ "rss" ], 982 | "pluginsConfig": { 983 | "rss": { 984 | "title": "GitBook 使用教程", 985 | "description": "记录 GitBook 的配置和一些插件的使用", 986 | "author": "Jikai Zhang", 987 | "feed_url": "http://gitbook.zhangjikai.com/rss", 988 | "site_url": "http://gitbook.zhangjikai.com/", 989 | "managingEditor": "me@zhangjikai.com", 990 | "webMaster": "me@zhangjikai.com", 991 | "categories": [ 992 | "gitbook" 993 | ] 994 | } 995 | } 996 | } 997 | ``` 998 | 效果见右上角。 999 | 1000 | ## theme-comscore 1001 | 1002 | 主题插件, 修改标题和表格颜色。默认标题都是黑色的。 1003 | 1004 | [插件地址](https://plugins.gitbook.com/plugin/theme-comscore) 1005 | 1006 | ``` json 1007 | { 1008 | "plugins": [ 1009 | "theme-comscore" 1010 | ] 1011 | } 1012 | ``` 1013 | 1014 | ## summary 1015 | 1016 | 根据文件自动生成目录。 1017 | 1018 | [插件地址](https://plugins.gitbook.com/plugin/summary) 1019 | 1020 | ``` json 1021 | { 1022 | "plugins": [ 1023 | "summary" 1024 | ] 1025 | } 1026 | ``` 1027 | 规则: 1028 | 1029 | - 每个新增的目录中加入`README.md`,否则菜单为不可折叠 1030 | - 同个目录下的文件采用自然排序来决定菜单生成的前后顺序, 故在文件或目录前加入 "数字-" 如 "0-" 或 "1-" 来排序菜单的前后顺序。 1031 | - 菜单由目录自动生成,菜单名称依赖md文件中的标题, 故每个md文件中必须添加标题, 否则无法生成目录。 1032 | 1033 | 示例: 1034 | 1035 | 我们假设您的源代码树是这样完成的: 1036 | 1037 | ``` bash 1038 | $ tree . 1039 | . 1040 | ├── 1-Getting Started 1041 | │ ├── 0-README.md 1042 | │ └── 1-TEST.md 1043 | ├── 2-Reference 1044 | │ └── 0-README.md 1045 | ├── README.md 1046 | └── SUMMARY.md 1047 | ``` 1048 | 1049 | 生成的SUMMARY.md文件将如下所示: 1050 | ``` bash 1051 | - [Getting Started](1-Getting Started/0-README.md) 1052 | - [Test](1-Getting Started/1-TEST.md) 1053 | - [Reference](2-Reference/0-README.md) 1054 | ``` 1055 | -------------------------------------------------------------------------------- /settings.md: -------------------------------------------------------------------------------- 1 | # GitBook配置 2 | 记录Gitbook的一些配置信息 3 | 4 | * [title - 标题](#title) 5 | * [author - 作者信息](#author) 6 | * [description - 书本描述](#description) 7 | * [language - 使用的语言](#language) 8 | * [gitbook - 指定gitbook版本](#gitbook) 9 | * [root - 指定存放 GitBook 文件的根目录](#root) 10 | * [links - 在侧边栏添加链接](#links) 11 | * [styles - 自定义样式](#styles) 12 | * [plugins - 插件](#plugins) 13 | * [pluginsConfig - 插件配置](#pluginsconfig) 14 | * [structure - 设置 Readme, Summary, Glossary等对应的文件](#structure) 15 | 16 | ## title 17 | 设置书本的标题 18 | ```json 19 | "title" : "Gitbook Use" 20 | ``` 21 | 22 | ## author 23 | 作者的相关信息 24 | ```json 25 | "author" : "zhangjikai" 26 | ``` 27 | 28 | ## description 29 | 本书的简单描述 30 | ```json 31 | "description" : "记录Gitbook的配置和一些插件的使用" 32 | ``` 33 | 34 | ## language 35 | Gitbook使用的语言, 版本2.6.4中可选的语言如下: 36 | ``` 37 | en, ar, bn, cs, de, en, es, fa, fi, fr, he, it, ja, ko, no, pl, pt, ro, ru, sv, uk, vi, zh-hans, zh-tw 38 | ``` 39 | 配置使用简体中文 40 | ``` 41 | "language" : "zh-hans", 42 | ``` 43 | ## gitbook 44 | 指定使用的gitbook版本 45 | ```json 46 | "gitbook" : "3.2.2", 47 | "gitbook" : ">=3.0.0" 48 | ``` 49 | ## root 50 | 指定存放 GitBook 文件(除了 book.json)的根目录 51 | ```json 52 | "root": "." 53 | ``` 54 | ## links 55 | 在左侧导航栏添加链接信息 56 | ```json 57 | "links" : { 58 | "sidebar" : { 59 | "Home" : "http://zhangjikai.com" 60 | } 61 | } 62 | ``` 63 | 64 | ## styles 65 | 自定义页面样式, 默认情况下各generator对应的css文件 66 | ```json 67 | "styles": { 68 | "website": "styles/website.css", 69 | "ebook": "styles/ebook.css", 70 | "pdf": "styles/pdf.css", 71 | "mobi": "styles/mobi.css", 72 | "epub": "styles/epub.css" 73 | } 74 | ``` 75 | 例如使`

`标签有下边框, 可以在`website.css`中设置 76 | ```css 77 | h1 , h2{ 78 | border-bottom: 1px solid #EFEAEA; 79 | } 80 | 81 | ``` 82 | ## plugins 83 | 配置使用的插件 84 | ``` 85 | "plugins": [ 86 | "disqus" 87 | ] 88 | ``` 89 | 添加新插件之后需要运行`gitbook install`来安装新的插件 90 | 91 | Gitbook默认带有5个插件: 92 | * highlight 93 | * search 94 | * sharing 95 | * font-settings 96 | * livereload 97 | 98 | 如果要去除自带的插件, 可以在插件名称前面加`-` 99 | ```json 100 | "plugins": [ 101 | "-search" 102 | ] 103 | ``` 104 | ## pluginsConfig 105 | 配置插件的属性 106 | ```json 107 | "pluginsConfig": { 108 | "fontsettings": { 109 | "theme": "sepia", 110 | "family": "serif", 111 | "size": 1 112 | } 113 | } 114 | ``` 115 | ## structure 116 | 指定 Readme、Summary、Glossary 和 Languages 对应的文件名,下面是这几个文件对应变量以及默认值: 117 | 118 | | 变量 | 含义和默认值 | 119 | |:----|:----| 120 | |`structure.readme` | `Readme file name (defaults to README.md)` | 121 | |`structure.summary` | `Summary file name (defaults to SUMMARY.md)`| 122 | |`structure.glossary`| `Glossary file name (defaults to GLOSSARY.md)` | 123 | |`structure.languages`| `Languages file name (defaults to LANGS.md)`| 124 | -------------------------------------------------------------------------------- /structure.md: -------------------------------------------------------------------------------- 1 | # 目录结构 2 | GitBook 基本的目录结构如下所示 3 | ``` 4 | . 5 | ├── book.json 6 | ├── README.md 7 | ├── SUMMARY.md 8 | ├── chapter-1/ 9 | | ├── README.md 10 | | └── something.md 11 | └── chapter-2/ 12 | ├── README.md 13 | └── something.md 14 | ``` 15 | 这里主要讲下 GitBook 预定义的几个文件的作用 16 | ## book.json 17 | 存放配置信息,在下一章中所讲的配置信息都是在这个文件里定义的,关于该文件的配置可以看 [配置](settings.md) 这个章节。 18 | 19 | ## Summary 20 | 概要文件主要存放 GitBook 的文件目录信息,左侧的目录就是根据这个文件来生成的,默认对应的文件是 `SUMMARY.md`,可以在 `book.json` 重新定义该文件的对应值。它通过 Markdown 中的列表语法来表示文件的父子关系,下面是一个简单的示例: 21 | ``` 22 | # Summary 23 | * [Introduction](README.md) 24 | * [Part I](part1/README.md) 25 | * [Writing is nice](part1/writing.md) 26 | * [GitBook is nice](part1/gitbook.md) 27 | * [Part II](part2/README.md) 28 | * [We love feedback](part2/feedback_please.md) 29 | * [Better tools for authors](part2/better_tools.md) 30 | ``` 31 | 这个配置对应的目录结构如下所示: 32 | 33 | ![](assets/images/summary1.png) 34 | 35 | 我们通过使用 标题 或者 水平分割线 标志将 GitBook 分为几个不同的部分 36 | ``` 37 | # Summary 38 | 39 | ### Part I 40 | 41 | * [Introduction](README.md) 42 | * [Writing is nice](part1/writing.md) 43 | * [GitBook is nice](part1/gitbook.md) 44 | 45 | ### Part II 46 | 47 | * [We love feedback](part2/feedback_please.md) 48 | * [Better tools for authors](part2/better_tools.md) 49 | 50 | ---- 51 | 52 | * [Last part without title](part3/title.md) 53 | ``` 54 | 这个配置对应的目录结构如下所示: 55 | 56 | ![](assets/images/summary2.png) 57 | 58 | ## Glossary 59 | 词汇表文件,默认对应的文件是 `GLOSSARY.md`。该文件主要存储词汇信息,如果在其他页面中出现了该文件中的词汇,鼠标放到词汇上会给出词汇示意,可以将鼠标移到下面两个词汇上看下效果。 60 | 61 | Git    Markdown 62 | 63 | Glossary 文件的格式如下所示: 64 | ``` 65 | ## Git 66 | 分散式版本控制软件 67 | 68 | ## Markdown 69 | Aaron Swartz 跟John Gruber共同设计的排版语言 70 | ``` 71 | -------------------------------------------------------------------------------- /styles/website.css: -------------------------------------------------------------------------------- 1 | /* CSS for website */ 2 | h1 , h2{ 3 | border-bottom: 1px solid #EFEAEA; 4 | padding-bottom: 3px; 5 | } 6 | .markdown-section>:first-child { 7 | margin-top: 0!important; 8 | } 9 | .page-wrapper { 10 | margin-top: -1.275em; 11 | } 12 | .book .book-body .page-wrapper .page-inner section.normal { 13 | min-height:350px; 14 | margin-bottom: 30px; 15 | } 16 | 17 | .book .book-body .page-wrapper .page-inner section.normal hr { 18 | height: 0px; 19 | padding: 0; 20 | margin: 1.7em 0; 21 | overflow: hidden; 22 | background-color: #e7e7e7; 23 | border-bottom: 1px dotted #e7e7e7; 24 | } 25 | 26 | .video-js { 27 | width:100%; 28 | height: 100%; 29 | } 30 | 31 | pre[class*="language-"] { 32 | border: none; 33 | background-color: #f7f7f7; 34 | font-size: 1em; 35 | line-height: 1.2em; 36 | } 37 | 38 | .book .book-body .page-wrapper .page-inner section.normal { 39 | font-size: 16px; 40 | font-family: "ubuntu", "Tahoma", "Microsoft YaHei", arial, sans-serif; 41 | } 42 | 43 | .aceCode { 44 | font-size: 14px !important; 45 | } 46 | 47 | input[type=checkbox]{ 48 | margin-left: -2em; 49 | } 50 | 51 | .page-footer span{ 52 | font-size: 12px; 53 | } 54 | 55 | .page-footer .copyright { 56 | float: left; 57 | } 58 | 59 | .body, html { 60 | overflow-y: hidden; 61 | } 62 | 63 | .versions-select select { 64 | height: 2em; 65 | line-height: 2em; 66 | border-radius: 4px; 67 | background: #efefef; 68 | } 69 | -------------------------------------------------------------------------------- /themes.md: -------------------------------------------------------------------------------- 1 | # 主题 2 | 目前 GitBook 提供了三类文档: Book 文档、API文档、FAQ文档。我们常用的就是 Book 文档模式,如果我们需要使用 API 文档模式或者 FAQ 文档模式,只需引入文档对应的主题插件即可,下面我们介绍与这三类文档相关的主题插件。 3 | 4 | ## Book 5 | Book 是我们常用的模式,大部分插件也都是针对这个模式做的。下面介绍一下针对 Book 模式的两个主题。 6 | ### theme-default 7 | `theme-default` 是默认的 Book 主题。将 `showLevel` 设为 `true`, 就可以显示标题前面的数字索引,默认不显示。 8 | ```json 9 | { 10 | "theme-default": { 11 | "showLevel": true 12 | } 13 | } 14 | ``` 15 | 在使用该主题的过程中,发现经常会在控制台报下面的错误,没有找到是哪里的原因,官方也一直没有修复。 16 | ``` 17 | theme.js:4 Uncaught TypeError: Cannot read property 'split' of undefined 18 | ``` 19 | 后来在 [这里](https://github.com/maxkoryukov/theme-default/commit/811fcca17fcc84ad9ff3f940a4194dbffa62a31d) 看到一个解决方法,需要修改本地的 GitBook Theme 模板。下面是具体步骤: 20 | * 进入 GitBook 默认主题所在的文件夹 `用户主目录` -> `.gitbook` -> `versions` -> `3.2.2` -> `node_modules` -> `gitbook-plugin-theme-default` -> `src` -> `js` -> `theme`,打开 `navigation.js`,找到 `getChapterHash` 函数 21 | ```js 22 | function getChapterHash($chapter) { 23 | var $link = $chapter.children('a'), 24 | hash = $link.attr('href').split('#')[1]; 25 | 26 | if (hash) hash = '#'+hash; 27 | return (!!hash)? hash : ''; 28 | } 29 | ``` 30 | * 将该函数修改为下面的形式: 31 | ```js 32 | function getChapterHash($chapter) { 33 | var $link = $chapter.children('a'), 34 | hash, 35 | href, 36 | parts; 37 | 38 | if ($link.length) { 39 | href = $link.attr('href') 40 | if (href) { 41 | parts = href.split('#'); 42 | if (parts.length>1) { 43 | hash = parts[1]; 44 | } 45 | } 46 | } 47 | 48 | if (hash) hash = '#'+hash; 49 | return (!!hash)? hash : ''; 50 | } 51 | ``` 52 | * 回到 `gitbook-plugin-theme-default` 文件夹,运行 `npm install` 重新编译文件。 53 | 54 | 另外在 v3 版本中引入了 part 的概念 (通过标题或者水平分割线将 GitBook 分为几个 part),所以目录的索引格式为 `part-index + article-index`。但是很多时候我们可能只有一个 part,并且不希望添加 part-index,即 `1.1`, `1.2` -> `1`, `2`。官方说是会在 v4 版本中解决这个问题,如果 v3 版本中希望去掉前面的 part-index,需要我们手动修改 gitbook 的源文件,下面是修改方法: 55 | * 打开 `/.gitbook/versions/3.x.x/lib/models/summaryPart.js` 56 | * 修改第 51 行的内容: 57 | ```js 58 | // return SummaryArticle.create(article, [level, i + 1].join('.')); 59 | return SummaryArticle.create(article, (i + 1) + ''); 60 | ``` 61 | 62 | 这样修改之后会有个问题,即每个 part 都会从 1 开始计数,如下图所示: 63 | 64 | ![](assets/images/catalog.png) 65 | 66 | 对于这个问题,目前的解决方法就是使用不同版本的 GitBook,对 `3.2.2` 进行了修改, `3.2.3` 没有修改,当只有一个 part 的时候使用 `3.2.2` 的版本,多个 part 的时候使用 `3.2.3` 的版本。 67 | 68 | ### theme-comscore 69 | 为标题添加颜色,如下如所示 70 | 71 | ![](assets/images/comscore.png) 72 | 73 | [插件地址](https://plugins.gitbook.com/plugin/theme-comscore) 74 | ```json 75 | { 76 | "plugins": [ 77 | "theme-comscore" 78 | ] 79 | } 80 | ``` 81 | ## API 文档 82 | GitBook 同样可以编写 API 文档,只需要引入 [`theme-api` 插件](https://plugins.gitbook.com/plugin/theme-api) 83 | ```json 84 | { 85 | "plugins": ["theme-api"], 86 | "pluginsConfig": { 87 | "theme-api": { 88 | "theme": "dark" 89 | } 90 | } 91 | } 92 | ``` 93 | 引入之后会替换默认的样式。下面是 API 文档的样式截图和在线演示: 94 | 95 | ![](assets/images/api.png) 96 | 97 | [在线演示](http://gitbook.zhangjikai.com/api/)    [示例源码](https://github.com/zhangjikai/gitbook-use/tree/v3-api) 98 | 99 | 使用 GitBook 的 API 文档模式时也可以使用插件,但是因为大部分插件可能针对写书的模式,所以有可能会出现不兼容的现象。 100 | 101 | API文档的语法也很简单,因为主要是针对方法的,所以以方法为基本单位,通过下面的语法来定义一个方法 102 | ``` 103 | {% method %} 104 | 105 | 内容区 106 | 107 | {% endmethod %} 108 | ``` 109 | 在内容区里面,通过 `{% sample lang="lang" %} `来定义一个针对特定语言的演示,通过 `{% common %}` 标识所有语言共同的部分。可以在 [这里](https://plugins.gitbook.com/plugin/theme-api) 查看完整的示例。 110 | 111 | ## FAQ 文档 112 | [`theme-faq`](https://plugins.gitbook.com/plugin/theme-faq) 插件主要用来制作知识库或者帮助中心,GitBook 的 [帮助中心](https://plugins.gitbook.com/plugin/theme-faq) 就是使用的该主题。为了支持中文搜索我们需要引入 `search-pro` 包。 113 | ```json 114 | { 115 | "plugins": [ 116 | "theme-faq", 117 | "-lunr", 118 | "search-pro@^2.0.2" 119 | ] 120 | } 121 | ``` 122 | 下面是该主题的截图以及在线示例: 123 | 124 | ![](assets/images/faq.png) 125 | 126 | [在线演示](http://gitbook.zhangjikai.com/faq/)    [示例源码](https://github.com/zhangjikai/gitbook-use/tree/v3-faq) 127 | 128 | 编写帮助中心很简单,在 `Summary` 里配置问题以及答案所在的文件,在对应文件中写入问题的答案即可,下面是一个示例 129 | `SUMMARY.md` 130 | ``` 131 | # Summary 132 | 133 | * [什么 is Git](Git.md) 134 | * [什么 is Github](Github.md) 135 | ``` 136 | `Git.md` 137 | ``` 138 | Git 是一个分布式版本控制软件,最初由林纳斯·托瓦兹(Linus Torvalds)创作,于2005年以GPL发布。最初目的是为更好地管理Linux内核开发而设计。应注意的是,这与GNU Interactive Tools[6](一个类似Norton Commander界面的文件管理器)有所不同。 139 | ``` 140 | --------------------------------------------------------------------------------