markdown

markdown


转义字符 \

可转义字符

\   backslash
`   backtick
*   asterisk
_   underscore
{}  curly braces
[]  square brackets
()  parentheses
#   hash mark
+   plus sign
-   minus sign (hyphen)
.   dot
!   exclamation mark

水平分割线

  • 要生成水平分割线 可以在单独一行里输入3个或以上的短横线 星号或者下划线实现

  • 短横线和星号之间可以输入任意空格





---
*** (******)
- - -
* * *

引用

ref to xxx

> ref to xxx

多级引用

这是一级引用

这是二级引用

这是三级引用

> 这是一级引用
>> 这是二级引用
>>> 这是三级引用

plaintext / 代码

使用 ` or ```

代码
```
代码
```

行首 tab

代码
    代码

或者四个空格 行开头

代码
    代码

title

# h1

## h2

...

###### h6

or

a first level header
====================
a second level header
---------------------

# this is an h1 #

## this is an h2 ##

### this is an h3 ###

强调

  • markdown 使用星号和下滑线来标记强调

斜体

*斜* _体_

加粗

**加** __粗__

列表

  • 无序列表使用星号 * 加号 + 和减号 - 来做为列表的项目标记

减号

  • Candy.
  • Gum.
  • Booze.
- Candy.
- Gum.
- Booze.

星号

  • Candy.
  • Gum.
  • Booze.
* Candy.
* Gum.
* Booze.

加号

  • Candy.
  • Gum.
  • Booze.
+ Candy.
+ Gum.
+ Booze.

链接

  • Markdown 支援两种形式的链接语法: 行内 和 参考 两种形式

  • 两种都是使用角括号来把文字转成链接

行内形式是直接在后面用括号直接接上链接

Let’s go

Let's [go](https://example.com)

可以选择性的加上 title 停留在上面时的 hint

Let’s go.

Let's [go](https://example.com "Example").

直接引用

https://example.com

<https://example.com>

图片

  • 图片的语法和链接很像

行内形式 无 title

awesome

![awesome](https://yuiwong.org/gitlab/uploads/project/avatar/71/awesome-badge.png)

行内形式

awesome

![awesome](https://yuiwong.org/gitlab/uploads/project/avatar/71/awesome-badge.png "awesome")

参考链接

[go][home]
![awesome][awesome]
[home]: https://yuiwong.org
[awesome]: https://yuiwong.org/gitlab/uploads/project/avatar/71/awesome-badge.png
[goto references](#references)

see also https://yuiwong.org/gitlab/awesome/markdown

references

Install and config gitlab-ce

Install and config gitlab-ce

(2017-04-02 +0800)

  • Host: ubuntu 16.04.2 or … LTS
  • Gitlab: gitlab-ce

https://yuiwong.org/gitlab/server/serverbuilding/blob/master/gitlab/gitlab-ce.md

Steps

Requirements

Check whether your server meets the hardware requirements.
GitLab packages are built for 64bit systems.
For 32bit OS, consider alternative installation methods.

Install and configure the necessary dependencies

If you install postfix to send email please select ‘internet site’ during setup.
instead of using Postfix you can also use Sendmail
or configure a custom SMTP server
and configure it as an SMTP server.

Here use Postfix: config is DOMAIN of the administrator email!!

sudo apt-get install curl openssh-server ca-certificates postfix

# Simple reconfigure postfix by reinstall
sudo apt-get purge postfix
sudo apt-get install postfix

Add the gitlab package server and install the package

# NOT by this mirror
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

# BUT
curl https://packages.gitlab.com/gpg.key 2> /dev/null | sudo apt-key add - &>/dev/null
add:
deb https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/ubuntu xenial main
to: /etc/apt/sources.list.d/gitlab-ce.list

# then
sudo apt-get update
sudo apt-get install gitlab-ce

CONFIGURE AND START GITLAB

Fixed !!
!!!!
sudo dpkg-divert --local --rename --add /sbin/initctl
sudo ln -s /bin/true /sbin/initctl
NO login git account!!
sudo useradd -r git -s /usr/sbin/nologin
Postgresql
sudo apt-get install -y postgresql postgresql-client libpq-dev postgresql-contrib
sudo -u postgres psql -d template1 -c "CREATE USER git CREATEDB;"
sudo -u postgres psql -d template1 -c "CREATE EXTENSION IF NOT EXISTS pg_trgm;"
sudo -u postgres psql -d template1 -c "CREATE DATABASE gitlabhq_production OWNER git;"
sudo -u git -H psql -d gitlabhq_production
sudo -u postgres psql -d template1 -c "ALTER ROLE git WITH PASSWORD 'YOUR_PASSWD';"
With external HTTP server

Apache or ngnix …: configure rewrite, redirect!

Apache2 and “redirect http requests to https”
and “Using a non-bundled web-server”…
https://docs.gitlab.com/omnibus/settings/nginx.html#using-a-non-bundled-web-server
https://gitlab.com/gitlab-org/gitlab-recipes/blob/master/web-server/apache/gitlab-omnibus-ssl-apache24.conf

TODO: ngnix

Examples

  • NO SSL + with prefix apache configuration:
  • SSL + with prefix apache configuration TODO
  • SSL + NO prefix apache configuration TODO
Or without external HTTP server

Just use workhorse, e.g. ...:8181

Reconfigure gitlab

Configuring the external URL for GitLab

Configuring a relative url for gitlab

# Set the external_url in /etc/gitlab/gitlab.rb:
external_url "https://example.com/gitlab"
# My
external_url "https://yuiwong.org/gitlab"

# Reconfigure GitLab for the changes to take effect:
sudo gitlab-ctl reconfigure

# Restart gitlab in case you shut down unicorn and sidekiq in the first step:
sudo gitlab-ctl restart

Example /etc/gitlab/gitlab.rb
conf/gitlab.1.rb
TODO more

Reconfigure

sudo gitlab-ctl reconfigure

Restart

sudo gitlab-ctl restart

Browse to the hostname and login

On your first visit,
you’ll be redirected to a password reset screen to provide the password
for the initial administrator account.
Enter your desired password and you’ll be redirected back to the login screen.

The default account’s username is root.
Provide the password you created earlier and login.
After login you can change the username if you wish.


For configuration and troubleshooting options please see the
Omnibus GitLab documentation
If you are located in China, try using
https://mirror.tuna.tsinghua.edu.cn/help/gitlab-ce/


References