2 |
--------------------------------------------------------------------------------
/src/test/resources/gfm/alerts/caution.html:
--------------------------------------------------------------------------------
1 | Tip
3 |Helpful advice for doing things better or more easily.
4 |
2 |
--------------------------------------------------------------------------------
/src/test/resources/gfm/alerts/note.html:
--------------------------------------------------------------------------------
1 | Caution
3 |Advises about risks or negative outcomes of certain actions.
4 |
2 |
--------------------------------------------------------------------------------
/src/test/resources/gfm/alerts/testWithParagraphBeforeAndAfter.md:
--------------------------------------------------------------------------------
1 | A simple paragraph before.
2 |
3 | > [!NOTE]
4 | > Useful information that users should know,
5 | > even when skimming content.
6 |
7 | Another paragraph after.
--------------------------------------------------------------------------------
/src/test/resources/gfm/alerts/important.html:
--------------------------------------------------------------------------------
1 | Note
3 |Useful information that users should know, even when skimming content.
4 |
2 |
--------------------------------------------------------------------------------
/src/test/resources/gfm/alerts/warning.html:
--------------------------------------------------------------------------------
1 | Important
3 |Key information users need to know to achieve their goal.
4 |
2 |
--------------------------------------------------------------------------------
/src/test/resources/gfm/alerts/warning_custom_title.html:
--------------------------------------------------------------------------------
1 | Warning
3 |Urgent info that needs immediate user attention to avoid problems.
4 |
2 |
--------------------------------------------------------------------------------
/src/main/java/io/github/gitbucket/markedj/token/HrToken.java:
--------------------------------------------------------------------------------
1 | package io.github.gitbucket.markedj.token;
2 |
3 | public class HrToken implements Token {
4 | @Override
5 | public String getType() {
6 | return "HrToken";
7 | }
8 | }
9 |
--------------------------------------------------------------------------------
/src/main/java/io/github/gitbucket/markedj/token/SpaceToken.java:
--------------------------------------------------------------------------------
1 | package io.github.gitbucket.markedj.token;
2 |
3 | public class SpaceToken implements Token {
4 | @Override
5 | public String getType() {
6 | return "SpaceToken";
7 | }
8 | }
--------------------------------------------------------------------------------
/src/main/java/io/github/gitbucket/markedj/token/ListEndToken.java:
--------------------------------------------------------------------------------
1 | package io.github.gitbucket.markedj.token;
2 |
3 | public class ListEndToken implements Token {
4 | @Override
5 | public String getType() {
6 | return "ListEndToken";
7 | }
8 | }
9 |
--------------------------------------------------------------------------------
/.github/dependabot.yml:
--------------------------------------------------------------------------------
1 | version: 2
2 | updates:
3 | - package-ecosystem: "github-actions"
4 | directory: "/"
5 | schedule:
6 | interval: "weekly"
7 | - package-ecosystem: "maven"
8 | directory: "/"
9 | schedule:
10 | interval: "weekly"
11 |
--------------------------------------------------------------------------------
/src/main/java/io/github/gitbucket/markedj/token/ListItemEndToken.java:
--------------------------------------------------------------------------------
1 | package io.github.gitbucket.markedj.token;
2 |
3 | public class ListItemEndToken implements Token {
4 | @Override
5 | public String getType() {
6 | return "ListItemEndToken";
7 | }
8 | }
9 |
--------------------------------------------------------------------------------
/src/main/java/io/github/gitbucket/markedj/token/BlockquoteEndToken.java:
--------------------------------------------------------------------------------
1 | package io.github.gitbucket.markedj.token;
2 |
3 | public class BlockquoteEndToken implements Token {
4 | @Override
5 | public String getType() {
6 | return "BlockquoteEndToken";
7 | }
8 | }
9 |
--------------------------------------------------------------------------------
/src/main/java/io/github/gitbucket/markedj/token/ListItemStartToken.java:
--------------------------------------------------------------------------------
1 | package io.github.gitbucket.markedj.token;
2 |
3 | public class ListItemStartToken implements Token {
4 | @Override
5 | public String getType() {
6 | return "ListItemStartToken";
7 | }
8 | }
9 |
--------------------------------------------------------------------------------
/src/main/java/io/github/gitbucket/markedj/token/BlockquoteStartToken.java:
--------------------------------------------------------------------------------
1 | package io.github.gitbucket.markedj.token;
2 |
3 | public class BlockquoteStartToken implements Token {
4 | @Override
5 | public String getType() {
6 | return "BlockquoteStartToken";
7 | }
8 | }
9 |
--------------------------------------------------------------------------------
/src/main/java/io/github/gitbucket/markedj/token/LooseItemStartToken.java:
--------------------------------------------------------------------------------
1 | package io.github.gitbucket.markedj.token;
2 |
3 | public class LooseItemStartToken implements Token {
4 | @Override
5 | public String getType() {
6 | return "LooseItemStartToken";
7 | }
8 | }
9 |
--------------------------------------------------------------------------------
/src/test/resources/gfm/alerts/testWithParagraphBeforeAndAfter.html:
--------------------------------------------------------------------------------
1 | Attention!!!
3 |Urgent info that needs immediate user attention to avoid problems.
4 |A simple paragraph before.
2 |
3 |
6 | Note
4 |Useful information that users should know, even when skimming content.
5 |Another paragraph after.
-------------------------------------------------------------------------------- /src/main/java/io/github/gitbucket/markedj/rule/NoopRule.java: -------------------------------------------------------------------------------- 1 | package io.github.gitbucket.markedj.rule; 2 | 3 | import java.util.Collections; 4 | import java.util.List; 5 | 6 | public class NoopRule implements Rule { 7 | public List
2 |
5 | Note
3 |Useful information that users should know, even when skimming content.
4 |
6 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | target/
2 | *.class
3 |
4 | # Mobile Tools for Java (J2ME)
5 | .mtj.tmp/
6 |
7 | # Package Files #
8 | *.jar
9 | *.war
10 | *.ear
11 |
12 | # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
13 | hs_err_pid*
14 | .idea/
15 | *.iml
16 |
17 | # Visual Studio Code
18 | .vscode
19 |
20 | # Eclipse
21 | .settings
22 | .classpath
23 | .project
--------------------------------------------------------------------------------
/src/main/java/io/github/gitbucket/markedj/token/TextToken.java:
--------------------------------------------------------------------------------
1 | package io.github.gitbucket.markedj.token;
2 |
3 | public class TextToken implements Token {
4 |
5 | private String text;
6 |
7 | public TextToken(String text){
8 | this.text = text;
9 | }
10 |
11 | public String getText() {
12 | return text;
13 | }
14 |
15 | @Override
16 | public String getType() {
17 | return "TextToken";
18 | }
19 | }
20 |
--------------------------------------------------------------------------------
/src/main/java/io/github/gitbucket/markedj/token/HtmlToken.java:
--------------------------------------------------------------------------------
1 | package io.github.gitbucket.markedj.token;
2 |
3 | public class HtmlToken implements Token {
4 |
5 | private String text;
6 |
7 | public HtmlToken(String text){
8 | this.text = text;
9 | }
10 |
11 | public String getText() {
12 | return text;
13 | }
14 |
15 | @Override
16 | public String getType() {
17 | return "HtmlToken";
18 | }
19 |
20 | }
21 |
--------------------------------------------------------------------------------
/src/main/java/io/github/gitbucket/markedj/token/ParagraphToken.java:
--------------------------------------------------------------------------------
1 | package io.github.gitbucket.markedj.token;
2 |
3 | public class ParagraphToken implements Token {
4 |
5 | private String text;
6 |
7 | public ParagraphToken(String text){
8 | this.text = text;
9 | }
10 |
11 | public String getText() {
12 | return text;
13 | }
14 |
15 | @Override
16 | public String getType() {
17 | return "ParagraphToken";
18 | }
19 | }
20 |
--------------------------------------------------------------------------------
/src/main/java/io/github/gitbucket/markedj/token/ListStartToken.java:
--------------------------------------------------------------------------------
1 | package io.github.gitbucket.markedj.token;
2 |
3 | public class ListStartToken implements Token {
4 |
5 | private boolean orderd;
6 |
7 | public ListStartToken(boolean orderd){
8 | this.orderd = orderd;
9 | }
10 |
11 | public boolean isOrderd() {
12 | return orderd;
13 | }
14 |
15 | @Override
16 | public String getType() {
17 | return "ListStartToken";
18 | }
19 |
20 | }
21 |
--------------------------------------------------------------------------------
/src/test/resources/nptable.md:
--------------------------------------------------------------------------------
1 | 6.x | 3.3.5
2 | :------------: | :------------:
3 | [](https://travis-ci.org/TrinityCore/TrinityCore) | [](https://travis-ci.org/TrinityCore/TrinityCore)
4 | [](https://scan.coverity.com/projects/435) | [](https://scan.coverity.com/projects/4656)
5 |
--------------------------------------------------------------------------------
/src/main/java/io/github/gitbucket/markedj/token/HeadingToken.java:
--------------------------------------------------------------------------------
1 | package io.github.gitbucket.markedj.token;
2 |
3 | public class HeadingToken implements Token {
4 |
5 | private int depth;
6 | private String text;
7 |
8 | public HeadingToken(int depth, String text){
9 | this.depth = depth;
10 | this.text = text;
11 | }
12 |
13 | public int getDepth() {
14 | return depth;
15 | }
16 |
17 | public String getText() {
18 | return text;
19 | }
20 |
21 | @Override
22 | public String getType() {
23 | return "HeadingToken";
24 | }
25 |
26 | }
27 |
--------------------------------------------------------------------------------
/src/test/resources/wikilink.md:
--------------------------------------------------------------------------------
1 | Welcome to the GitBucket wiki!
2 | ====
3 | * [[ SSH access to repository]]
4 | * [[LDAP Authentication Settings]]
5 | * [[Installation on IIS and Helicontech Zoo]]
6 | * [[Reverse proxy with Nginx]]
7 | * [[Reverse proxy with Apache]]
8 | * [[Setup Jenkins GitHub pull request builder plugin]]
9 | * [[Connect to H2 database]]
10 | * [[How to Close/Reference issues & pull request]]
11 | * [[Backup]]
12 | * [[API/WebHook]]
13 |
14 | If you are interested in GitBucket development, you can find documents for GitBucket development at: https://github.com/takezoe/gitbucket/blob/master/doc/readme.md
--------------------------------------------------------------------------------
/src/test/resources/nested_content_of_list.md:
--------------------------------------------------------------------------------
1 | - [3.4](#es6-computed-properties) Use computed property names when creating objects with dynamic property names.
2 |
3 | > Why? They allow you to define all the properties of an object in one place.
4 |
5 | ```javascript
6 |
7 | function getKey(k) {
8 | return `a key named ${k}`;
9 | }
10 |
11 | // bad
12 | const obj = {
13 | id: 5,
14 | name: 'San Francisco',
15 | };
16 | obj[getKey('enabled')] = true;
17 |
18 | // good
19 | const obj = {
20 | id: 5,
21 | name: 'San Francisco',
22 | [getKey('enabled')]: true,
23 | };
24 | ```
--------------------------------------------------------------------------------
/src/test/resources/nested_content_of_list.html:
--------------------------------------------------------------------------------
1 | Tip
7 |A tip!
8 |-
2 |
- 3.4 Use computed property names when creating objects with dynamic property names.
3 |
4 |
6 |Why? They allow you to define all the properties of an object in one place.
5 |7 | function getKey(k) { 8 | return `a key named ${k}`; 9 | } 10 | 11 | // bad 12 | const obj = { 13 | id: 5, 14 | name: 'San Francisco', 15 | }; 16 | obj[getKey('enabled')] = true; 17 | 18 | // good 19 | const obj = { 20 | id: 5, 21 | name: 'San Francisco', 22 | [getKey('enabled')]: true, 23 | }; 24 |
25 |
Welcome to the GitBucket wiki!
2 |-
3 |
- [[<script>Enabling</script> SSH access to repository]] 4 |
- [[LDAP Authentication Settings]] 5 |
- [[Installation on IIS and Helicontech Zoo]] 6 |
- [[Reverse proxy with Nginx]] 7 |
- [[Reverse proxy with Apache]] 8 |
- [[Setup Jenkins GitHub pull request builder plugin]] 9 |
- [[Connect to H2 database]] 10 |
- [[How to Close/Reference issues & pull request]] 11 |
- [[Backup]] 12 |
- [[API/WebHook]] 13 |
If you are interested in GitBucket development, you can find documents for GitBucket development at: https://github.com/takezoe/gitbucket/blob/master/doc/readme.md
-------------------------------------------------------------------------------- /src/main/java/io/github/gitbucket/markedj/token/TableToken.java: -------------------------------------------------------------------------------- 1 | package io.github.gitbucket.markedj.token; 2 | 3 | import java.util.List; 4 | 5 | public class TableToken implements Token { 6 | 7 | private List| aa | 5 |aa | 6 |7 | |
|---|---|---|
| bb | 12 |bb | 13 |cc | 14 |
| Tables | 21 |Are | 22 |Cool | 23 |
|---|---|---|
| col 1 is | 28 |left-aligned | 29 |$1600 | 30 |
| col 2 is | 33 |centered | 34 |$12 | 35 |
| col 3 is | 38 |right-aligned | 39 |$1 | 40 |
| 6.x | 5 |3.3.5 | 6 |
|---|---|
 |
11 |  |
12 |
 |
15 |  |
16 |
")) { 29 | message = String.format("
%s
", message); 30 | } 31 | 32 | return String.format("%s
\n%s");
17 | if(escaped){
18 | sb.append(code);
19 | } else {
20 | sb.append(escape(code, true));
21 | }
22 | sb.append("\n");
27 | if(escaped){
28 | sb.append(code);
29 | } else {
30 | sb.append(escape(code, true));
31 | }
32 | sb.append("\n\n" + quote + "\n"; 39 | } 40 | 41 | public String html(String html){ 42 | return html; 43 | } 44 | 45 | public String heading(String text, int level, String raw){ 46 | return "
\n"; 52 | } 53 | 54 | public String list(String body, boolean ordered){ 55 | String listType; 56 | if(ordered){ 57 | listType = "ol"; 58 | } else { 59 | listType = "ul"; 60 | } 61 | return "<" + listType + ">\n" + body + "\n"; 62 | } 63 | 64 | public String listitem(String text){ 65 | return "
" + text + "
\n"; 70 | } 71 | 72 | public String table(String header, String body){ 73 | return "" + text + "";
106 | }
107 |
108 | public String br(){
109 | return ""; 110 | } 111 | 112 | public String del(String text){ 113 | return "
102 |
105 | ```
106 |
107 | Generated HTML can be customized by implementing your own renderer. [DefaultGFMAlertRenderer](https://github.com/gitbucket/markedj/blob/master/src/main/java/io/github/gitbucket/markedj/extension/gfm/alert/DefaultGFMAlertRenderer.java) is used by default.
108 |
109 | ## for Developers
110 |
111 | ### Release
112 |
113 | Run the following command to upload artifacts to sonatype:
114 |
115 | ```
116 | mvn clean deploy -DperformRelease=true
117 | ```
118 |
119 | Then, go to https://oss.sonatype.org/, close and release the staging repository.
120 |
121 |
--------------------------------------------------------------------------------
/pom.xml:
--------------------------------------------------------------------------------
1 | Note
103 |Useful information that users should know, even when skimming content.
104 |GitBucket added support for LDAP Authentication in the version 1.5. This Wiki page describes how to configure and troubleshoot it.
2 |Configuration
3 |-
4 |
- Login as Admin 5 |
- Go to Administration and click System Settings 6 |
- Check LDAP and enter the LDAP configuration: 7 |
| Name | 12 |Description | 13 |Example Value | 14 |
|---|---|---|
| LDAP Host | 19 |LDAP host name | 20 |192.168.32.1 | 21 |
| LDAP Port | 24 |LDAP port | 25 |389 (default 389) | 26 |
| Bind DN | 29 |Username that has read access to the LDAP | 30 |uid=binduser,cn=bindclients,dc=example,dc=com | 31 |
| Bind Password | 34 |Password for Bind DN account | 35 |password | 36 |
| Base DN | 39 |Top level DN of your LDAP directory tree (used for user search) | 40 |dc=example,dc=com | 41 |
| User name attribute | 44 |Name of the LDAP attribute. This is used as the GitBucket username | 45 |uid | 46 |
| Mail address attribute | 49 |Email address of LDAP attribute | 50 ||
| Enable TLS | 54 |Whether to use encrypted connection | 55 |checked | 56 |
| Keystore | 59 |Path to the Java keystore | 60 |/etc/pki/java/cacerts | 61 |
Keystore
65 |Default system keystore is in:
66 |${JAVA_HOME}/lib/security/jssecacerts
67 | or in:
69 |${JAVA_HOME}/lib/security/cacerts
70 | Custom keystore can be set either in /etc/sysconfig/gitbucket by specifying the following option:
GITBUCKET_JVM_OPTS="-Djavax.net.ssl.trustStore=/path/to/your/keystore"
73 | or in Gitbucket's System Settings as described above.
75 |You can use the following command to add your CA certificate to the keystore:
76 |$ keytool -import \
77 | -file /path/to/your/cacert.pem \
78 | -alias <your_cert_alias> \
79 | -keystore /path/to/your/keystore
80 | Older versions of Java don't know how to import certificate if it contains anything else than the certificate itself. Then it's necessary to strip everything else out like this:
82 |$ cat /path/to/your/cacert.pem | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > /tmp/cacert.pem
83 | $ keytool -import -trustcacerts -alias <your_cert_alias> -file /tmp/cacert.pem -keystore /path/to/your/keystore
84 | You can list all keys from the keystore like this:
86 |$ keytool -list -keystore /path/to/your/keystore
87 | Troubleshooting
89 |LDAP debugging was enabled in the version 1.7. So if something goes wrong, you should see the error in the log file:
90 |15:43:56.529 [qtp1820788751-15] INFO service.AccountService - LDAP Authentication Failed: System LDAP authentication failed.
91 | 15:43:37.386 [qtp1820788751-15] INFO service.AccountService - LDAP Authentication Failed: User does not exist
92 | 15:49:34.565 [qtp1820788751-18] INFO service.AccountService - LDAP Authentication Failed: User LDAP Authentication Failed.
93 | 15:41:09.370 [qtp1820788751-16] INFO service.AccountService - LDAP Authentication Failed: Can't find mail address.
94 | The following is the explanation for the above error messages:
96 |-
97 |
- System LDAP authentication failed
98 |
-
99 |
- Failed to access LDAP server by using Bind DN and Bind Password 100 |
- Wrong LDAP Host, LDAP Port, Bind DN or Bind Password 101 |
102 | - User does not exists
103 |
-
104 |
- LDAP searched the user account from Base DN but did not find it 105 |
106 | - User LDAP Authentication Failed
107 |
-
108 |
- Found user but failed to login (maybe wrong Bind Password) 109 |
110 | - Can't find mail address
111 |
-
112 |
- Found user and user authentication succeed but did not find email address (wrong Mail address attribute) 113 |
114 |
%s
\n%s\n 123
123
", result); 71 | } 72 | 73 | @Test 74 | public void testEm() throws Exception { 75 | { 76 | String result = Marked.marked("_aa__a__aa_", new Options()); 77 | assertEquals("aaaaa
", result); 78 | } 79 | { 80 | String result = Marked.marked("*aa*o*aa*", new Options()); 81 | assertEquals("aaoaa
", result); 82 | } 83 | { 84 | String result = Marked.marked("_aa__aa_", new Options()); 85 | assertEquals("aa__aa
", result); 86 | } 87 | } 88 | 89 | @Test 90 | public void testStackoverFlow() throws Exception { 91 | Marked.marked(loadResourceAsString("stackoverflow.txt"), new Options()); 92 | } 93 | 94 | @Test 95 | public void testStackoverFlow2() throws Exception { 96 | Marked.marked(loadResourceAsString("stackoverflow2.txt"), new Options()); 97 | } 98 | 99 | @Test 100 | public void testNptable() throws Exception { 101 | String result = Marked.marked(loadResourceAsString("nptable.md"), new Options()); 102 | String expect = loadResourceAsString("nptable.html"); 103 | assertEquals(expect, result); 104 | } 105 | 106 | @Test 107 | public void testBreaks() throws Exception { 108 | { 109 | String md = "first line\nsecond line"; 110 | Options options = new Options(); 111 | //options.setBreaks(false); // default is false 112 | //options.setGfm(true); // default is true 113 | String result = Marked.marked(md, options); 114 | 115 | assertEquals("first line second line
", result); 116 | } 117 | { 118 | String md = "first line\nsecond line"; 119 | Options options = new Options(); 120 | options.setBreaks(true); 121 | //options.setGfm(true); // default is true 122 | String result = Marked.marked(md, options); 123 | 124 | assertEquals("first line
\n second line
public class HelloWorld {\n" +
143 | "}\n" +
144 | "test\nMessage A
\n" + 170 | "- \n" +
171 | "
- List A \n" + 172 | "
- List B \n" + 173 | "
| ID | \n" + 196 | "name | \n" + 197 | "note | \n" + 198 | "
|---|---|---|
| 1 | \n" + 203 | "foo | \n" + 204 | "This is foo | \n" + 205 | "
| 2 | \n" + 208 | "bar | \n" + 209 | "\n" + 210 | " |
<b>bold</b><script>alert('test!');</script>
", result); 222 | } 223 | { 224 | Options options = new Options(); 225 | options.setSanitize(false); 226 | String result = Marked.marked("bold", options); 227 | assertEquals("bold
", result); 228 | } 229 | { 230 | Options options = new Options(); 231 | options.setSanitize(false); 232 | String result = Marked.marked("- test", options); 233 | // It's not clean but tag is closed at least. 234 | assertEquals("- \n" +
235 | "
- test \n" + 236 | "
This is a paragraph
\n" + 249 | "\n" + 250 | "
This is a paragraph after a horizontal rule
", result); 251 | } 252 | 253 | private String loadResourceAsString(String path) throws IOException { 254 | InputStream in = Thread.currentThread().getContextClassLoader().getResourceAsStream(path); 255 | try { 256 | ByteArrayOutputStream out = new ByteArrayOutputStream(); 257 | byte[] buf = new byte[1024 * 8]; 258 | int length = 0; 259 | while((length = in.read(buf)) != -1){ 260 | out.write(buf, 0, length); 261 | } 262 | return new String(out.toByteArray(), "UTF-8"); 263 | } finally { 264 | in.close(); 265 | } 266 | } 267 | 268 | @Test 269 | public void testHardLineBreakWithSpaces() { 270 | String result = Marked.marked("Line 1 \n" + 271 | "Line 2"); 272 | assertEquals("Line 1
\n" +
273 | " Line 2
Line 1
\n" +
281 | " Line 2
GitBucket 
2 | GitBucket is the easily installable GitHub clone powered by Scala.
3 |Features
4 |The current version of GitBucket provides a basic features below:
5 |-
6 |
- Public / Private Git repository (http and ssh access) 7 |
- Repository viewer and online file editing 8 |
- Repository search (Code and Issues) 9 |
- Wiki 10 |
- Issues 11 |
- Fork / Pull request 12 |
- Email notification 13 |
- Activity timeline 14 |
- Simple user and group management with LDAP integration 15 |
- Gravatar support 16 |
- Plug-in system 17 |
Following features are not implemented, but we will make them in the future release!
19 |-
20 |
- Network graph 21 |
- Statistics 22 |
- Watch / Star 23 |
If you want to try the development version of GitBucket, see the documentation for developers at Wiki.
25 |Installation
26 |-
27 |
- Download latest gitbucket.war from the release page. 28 |
- Deploy it to the Servlet 3.0 container such as Tomcat 7.x, Jetty 8.x, GlassFish 3.x or higher. 29 |
- Access http://[hostname]:[port]/gitbucket/ using your web browser. 30 |
If you are using Gitbucket behind a webserver please make sure you have increased the client_max_body_size (on nginx)
32 |The default administrator account is root and password is root.
33 |or you can start GitBucket by java -jar gitbucket.war without servlet container. In this case, GitBucket URL is http://[hostname]:8080/. You can specify following options.
-
35 |
- --port=[NUMBER] 36 |
- --prefix=[CONTEXTPATH] 37 |
- --host=[HOSTNAME] 38 |
- --gitbucket.home=[DATA_DIR] 39 |
To upgrade GitBucket, only replace gitbucket.war. All GitBucket data is stored in HOME/.gitbucket. So if you want to back up GitBucket data, copy this directory to the other disk.
41 |For Installation on Windows Server with IIS see this wiki page
42 |Mac OS X
43 |Installing Via Homebrew
44 |$ brew install gitbucket
45 | ==> Downloading https://github.com/takezoe/gitbucket/releases/download/1.10/gitbucket.war
46 | ######################################################################## 100.0%
47 | ==> Caveats
48 | Note: When using launchctl the port will be 8080.
49 |
50 | To have launchd start gitbucket at login:
51 | ln -sfv /usr/local/opt/gitbucket/*.plist ~/Library/LaunchAgents
52 | Then to load gitbucket now:
53 | launchctl load ~/Library/LaunchAgents/homebrew.mxcl.gitbucket.plist
54 | Or, if you don't want/need launchctl, you can just run:
55 | java -jar /usr/local/opt/gitbucket/libexec/gitbucket.war
56 | ==> Summary
57 | /usr/local/Cellar/gitbucket/1.10: 3 files, 42M, built in 11 seconds
58 | Manual Installation
60 |On OS X, copy the gitbucket.plist file to ~/Library/LaunchAgents/
Run the following commands in Terminal to
-
63 |
- start gitbucket:
launchctl load ~/Library/LaunchAgents/gitbucket.plist
64 | - stop gitbucket:
launchctl unload ~/Library/LaunchAgents/gitbucket.plist
65 |
Plug-ins
67 |GitBucket has the plug-in system to extend GitBucket from outside of GitBucket. Some plug-ins are available now:
68 |-
69 |
- gitbucket-gist-plugin 70 |
- gitbucket-announce-plugin 71 |
- gitbucket-h2-backup-plugin 72 |
- gitbucket-desktopnotify-plugin 73 |
You can find community plugins other than them at gitbucket community plugins.
75 |Release Notes
76 |3.6 - 30 Aug 2015
77 |-
78 |
- User interface Improvements: Especially, commit list, issues and pull request have been updated largely. 79 |
- Installed plugins list has been available at the system administration console. 80 |
- Pages and repository list in the sidebar have been limited and more pages and repositories link is available. 81 |
- More reference link notation in Markdown has been supported. 82 |
3.5 - 1 Aug 2015
84 |-
85 |
- Octicons has been applied 86 |
- Global header has been enhanced. Now it's further similar to GitHub. 87 |
- Default compare / pull request target has been changed to the parent repository 88 |
- A lot of updates for gitbucket-gist-plugin 89 |
3.4 - 27 Jun 2015
91 |-
92 |
- Declarative style plug-in definition 93 |
- New extension point to add markup render 94 |
- go-import support 95 |
3.3 - 31 May 2015
97 |-
98 |
- Rich graphical diff for images 99 |
- File finder is available in the repository viewer 100 |
- Blame is displayed at the source viewer 101 |
- Remain user data and repositories even if user is disabled 102 |
- Mobile view improvement 103 |
3.2 - 3 May 2015
105 |-
106 |
- Directory history button 107 |
- Compare / pull request button 108 |
- Limit of activity log 109 |
3.1.1 - 4 Apr 2015
111 |-
112 |
- Rolled back H2 version to avoid version compatibility issue 113 |
- Plug-ins became possible to access ServletContext 114 |
3.1 - 28 Mar 2015
116 |-
117 |
- Web APIs for Jenkins github pull-request builder 118 |
- Improved diff view 119 |
- Bump Scalatra to 2.3.1, sbt to 0.13.8 120 |
3.0 - 3 Mar 2015
122 |-
123 |
- New plug-in system is available 124 |
- Connection pooling by c3p0 125 |
- New branch UI 126 |
- Compare between specified commit ids 127 |
2.8 - 1 Feb 2015
129 |-
130 |
- New logo and icons 131 |
- New system setting options to control visibility 132 |
- Comment on side-by-side diff 133 |
- Information message on sign-in page 134 |
- Fork repository by group account 135 |
2.7 - 29 Dec 2014
137 |-
138 |
- Comment for commit and diff 139 |
- Fix security issue in markdown rendering 140 |
- Some bug fix and improvements 141 |
2.6 - 24 Nov 2014
143 |-
144 |
- Search box at issues and pull requests 145 |
- Information from administrator 146 |
- Pull request UI has been updated 147 |
- Move to TravisCI from Buildhive 148 |
- Some bug fix and improvements 149 |
2.5 - 4 Nov 2014
151 |-
152 |
- New Dashboard 153 |
- Change datetime format 154 |
- Create branch from Web UI 155 |
- Task list in Markdown 156 |
- Some bug fix and improvements 157 |
2.4.1 - 6 Oct 2014
159 |-
160 |
- Bug fix 161 |
2.4 - 6 Oct 2014
163 |-
164 |
- New UI is applied to Issues and Pull requests 165 |
- Side-by-side diff is available 166 |
- Fix relative path problem in Markdown links and images 167 |
- Plugin System is disabled in default 168 |
- Some bug fix and improvements 169 |
2.3 - 1 Sep 2014
171 |-
172 |
- Scala based plugin system 173 |
- Embedded Jetty war extraction directory moved to
GITBUCKET_HOME/tmp
174 | - Some bug fix and improvements 175 |
2.2.1 - 5 Aug 2014
177 |-
178 |
- Bug fix 179 |
2.2 - 4 Aug 2014
181 |-
182 |
- Plug-in system is available 183 |
- Move to Scala 2.11, Scalatra 2.3 and Slick 2.1 184 |
- tar.gz export for repository contents 185 |
- LDAP authentication improvement (mail address became optional) 186 |
- Show news feed of a private repository to members 187 |
- Some bug fix and improvements 188 |
2.1 - 6 Jul 2014
190 |-
191 |
- Upgrade to Slick 2.0 from 1.9 192 |
- Base part of the plug-in system is merged 193 |
- Many bug fix and improvements 194 |
2.0 - 31 May 2014
196 |-
197 |
- Modern Github UI 198 |
- Preview in AceEditor 199 |
- Select lines by clicking line number in blob view 200 |
1.13 - 29 Apr 2014
202 |-
203 |
- Direct file editing in the repository viewer using AceEditor 204 |
- File attachment for issues 205 |
- Atom feed of user activity 206 |
- Fix some bugs 207 |
1.12 - 29 Mar 2014
209 |-
210 |
- SSH repository access is available 211 |
- Allow users can create and management their groups 212 |
- Git submodule support 213 |
- Close issues via commit messages 214 |
- Show repository description below the name on repository page 215 |
- Fix presentation of the source viewer 216 |
- Upgrade to sbt 0.13 217 |
- Fix some bugs 218 |
1.11.1 - 06 Mar 2014
220 |-
221 |
- Bug fix 222 |
1.11 - 01 Mar 2014
224 |-
225 |
- Base URL for redirection, notification and repository URL box is configurable 226 |
- Remove
--httpsoption because it's possible to substitute in the base url
227 | - Headline anchor is available for Markdown contents such as Wiki page 228 |
- Improve H2 connectivity 229 |
- Label is available for pull requests not only issues 230 |
- Delete branch button is added 231 |
- Repository icons are updated 232 |
- Select lines of source code by URL hash like
#L10or#L10-L15in repository viewer
233 | - Display reference to issue from others in comment list 234 |
- Fix some bugs 235 |
1.10 - 01 Feb 2014
237 |-
238 |
- Rename repository 239 |
- Transfer repository owner 240 |
- Change default data directory to
HOME/.gitbucketfromHOME/gitbucketto avoid problem like #243, but if data directory already exist at HOME/gitbucket, it continues being used.
241 | - Add LDAP display name attribute 242 |
- Response performance improvement 243 |
- Fix some bugs 244 |
1.9 - 28 Dec 2013
246 |-
247 |
- Display GITBUCKET_HOME on the system settings page 248 |
- Fix some bugs 249 |
1.8 - 30 Nov 2013
251 |-
252 |
- Add user and group deletion 253 |
- Improve pull request performance 254 |
- Pull request synchronization (when source repository is updated after pull request, it's applied to the pull request) 255 |
- LDAP StartTLS support 256 |
- Enable hard wrapping in Markdown 257 |
- Add new some options to specify the data directory. See details in Wiki. 258 |
- Fix some bugs 259 |
1.7 - 26 Oct 2013
261 |-
262 |
- Support working on Java6 in embedded Jetty mode 263 |
- Add
--hostoption to bind specified host name in embedded Jetty mode
264 | - Add
--https=trueoption to force https scheme when using embedded Jetty mode at the back of https proxy
265 | - Add full name as user property 266 |
- Change link color for absent Wiki pages 267 |
- Add ZIP download button to the repository viewer tab 268 |
- Improve ZIP exporting performance 269 |
- Expand issue and comment textarea for long text automatically 270 |
- Add conflict detection in Wiki 271 |
- Add reverting wiki page from history 272 |
- Match committer to user name by email address 273 |
- Mail notification sender is customizable 274 |
- Add link to changeset in refs comment for issues 275 |
- Fix some bugs 276 |
1.6 - 1 Oct 2013
278 |-
279 |
- Web hook 280 |
- Performance improvement for pull request 281 |
- Executable war file 282 |
- Specify suitable Content-Type for downloaded files in the repository viewer 283 |
- Fix some bugs 284 |
1.5 - 4 Sep 2013
286 |-
287 |
- Fork and pull request 288 |
- LDAP authentication 289 |
- Mail notification 290 |
- Add an option to turn off the gravatar support 291 |
- Add the branch tab in the repository viewer 292 |
- Encoding auto detection for the file content in the repository viewer 293 |
- Add favicon, header logo and icons for the timeline 294 |
- Specify data directory via environment variable GITBUCKET_HOME 295 |
- Fix some bugs 296 |
1.4 - 31 Jul 2013
298 |-
299 |
- Group management 300 |
- Repository search for code and issues 301 |
- Display user related issues on the dashboard 302 |
- Display participants avatar of issues on the issue page 303 |
- Performance improvement for repository viewer 304 |
- Alert by milestone due date 305 |
- H2 database administration console 306 |
- Fix some bugs 307 |
1.3 - 18 Jul 2013
309 |-
310 |
- Batch updating for issues 311 |
- Display assigned user on issue list 312 |
- User icon and Gravatar support 313 |
- Convert @xxxx to link to the account page 314 |
- Add copy to clipboard button for git clone URL 315 |
- Allow multi-byte characters as wiki page name 316 |
- Allow to create the empty repository 317 |
- Fix some bugs 318 |
1.2 - 09 Jul 2013
320 |-
321 |
- Add activity timeline 322 |
- Bugfix for Git 1.8.1.5 or later 323 |
- Allow multi-byte characters as label 324 |
- Fix some bugs 325 |
1.1 - 05 Jul 2013
327 |-
328 |
- Fix some bugs 329 |
- Upgrade to JGit 3.0 330 |
1.0 - 04 Jul 2013
332 |-
333 |
- This is a first public release 334 |
Sponsors
336 |