feature : 기본 폴더 디렉토리에 필요한 파일 추가 및 README 일부 수정

.gitignore

@@ -1 +1,2 @@
 /.idea/
+/_site/

README.md

@@ -12,11 +12,12 @@
 > 본 리포지토리는 소나큐브의 [Rules](https://docs.sonarqube.org/latest/user-guide/rules/overview/) 를 한글로 번역하는 프로젝트입니다.
 > 
 
-## 소나큐브 룰
-- Java
-  - tests
-  - java8
-  - spring
+## 로컬 환경 구축
+운영체제에 맞는 ruby 환경을 구축하고, jekyll 까지 설치가 완료되었다면 아래의 명령어로 빌드하고, 배포할 수 있습니다.
+```ruby
+jekyll build # 사이트를 빌드하여 _site 디렉토리 하위에 static 페이지를 생성합니다. 
+jekyll serve # _site 하위의 정적 디렉토리를 localhost:4000 으로 서빙합니다.
+```
 
 ## 참여하기
 해당 프로젝트에는 누구나 참여 가능하며 참여하는 방법은 [CONTRIBUTING.md](./CONTRIBUTING.md)를 참고해 주세요.

_includes/analytics-providers/custom.html

@@ -0,0 +1,3 @@
+<!-- start custom analytics snippet -->
+
+<!-- end custom analytics snippet -->

_includes/analytics-providers/google.html

@@ -0,0 +1,14 @@
+{%- if site.analytics.google.tracking_id -%}
+	<!-- Global site tag (gtag.js) - Google Analytics -->
+	<script async src="https://www.googletagmanager.com/gtag/js?id={{ site.analytics.google.tracking_id }}"></script>
+	<script>
+		window.dataLayer = window.dataLayer || [];
+		function gtag(){dataLayer.push(arguments);}
+		gtag('js', new Date());
+
+		gtag('config', '{{ site.analytics.google.tracking_id }}');
+		{% if site.analytics.google.anonymize_ip == true %}
+			gtag('config', '{{ site.analytics.google.tracking_id }}', { 'anonymize_ip': true });
+		{% endif %}
+	</script>
+{%- endif -%}

_includes/analytics.html

@@ -0,0 +1,7 @@
+{%- if jekyll.environment != 'development' -%}
+  {%- if site.analytics.provider == 'google' -%}
+    {%- include analytics-providers/google.html -%}
+  {%- elsif site.analytics.provider == 'custom' -%}
+    {%- include analytics-providers/custom.html -%}
+  {%- endif -%}
+{%- endif -%}

_includes/article-footer.html

@@ -0,0 +1,55 @@
+{%- include snippets/assign.html
+  target=site.data.variables.default.page.show_author_profile
+  source0=layout.show_author_profile source1=page.show_author_profile -%}
+{%- assign _show_author_profile = __return -%}
+
+{%- include snippets/assign.html
+  target=site.data.variables.default.page.show_subscribe
+  source0=layout.show_subscribe source1=page.show_subscribe -%}
+{%- assign _show_subscribe = __return -%}
+
+{%- include snippets/assign.html
+  target=site.data.variables.default.page.license
+  source0=layout.license source1=page.license -%}
+{%- assign _license = __return -%}
+
+<footer class="article__footer">
+  {%- if page.modify_date -%}
+    {%- include snippets/get-locale-string.html key='ARTICLE_DATE_FORMAT' -%}
+    {%- assign _locale_date_format = __return -%}
+
+    {%- include snippets/get-locale-string.html key='LAST_UPDATED' -%}
+    {%- assign _locale_last_update = __return -%}
+    <span>{{ _locale_last_update }}
+      <time itemprop="dateModified" datetime="{{ page.modify_date | date_to_xmlschema }}">{{ page.modify_date | date: _locale_date_format }}</time>
+    </span>
+  {%- elsif page.date -%}
+    <meta itemprop="dateModified" content="{{ page.date | date_to_xmlschema }}">
+  {%- endif -%}
+
+  {%- include article/footer/custom.html -%}
+
+  {%- if _show_author_profile -%}
+    {%- if page.author -%}
+      {%- assign _author = site.data.authors[page.author] -%}
+    {%- else -%}
+      {%- assign _author = site.author -%}
+    {%- endif -%}
+    {%- include article/footer/author-profile.html author=_author -%}
+  {%- endif -%}
+
+  {%- if _show_subscribe -%}
+    <div class="article__subscribe">{%- include article/footer/subscribe.html -%}</div>
+  {%- endif -%}
+
+  {%- if _license != false -%}
+    {%- assign _data_license = site.data.licenses-%}
+    {%- if site.license -%}
+      {%- assign _license_data = _data_license[site.license] -%}
+    {%- endif -%}
+    {%- if _license != true -%}
+      {%- assign _license_data = _data_license[_license] -%}
+    {%- endif -%}
+    <div class="article__license">{%- include article/footer/license.html license=_license_data -%}</div>
+  {%- endif -%}
+</footer>

_includes/article-header.html

@@ -0,0 +1,49 @@
+{%- include snippets/get-article-title.html article=include.article-%}
+{%- assign _article_title = __return -%}
+
+{%- if include.html != false -%}
+
+  {%- include snippets/assign.html
+    target=site.data.variables.default.page.show_title
+    source0=layout.show_title source1=include.article.show_title -%}
+  {%- assign _show_title = __return -%}
+
+  {%- include snippets/assign.html
+    target=site.data.variables.default.page.show_edit_on_github
+    source0=layout.show_edit_on_github source1=include.article.show_edit_on_github -%}
+  {%- assign _show_edit_on_github = __return -%}
+
+  {%- if _show_title or _show_edit_on_github -%}
+    <div class="article__header">
+      {%- if _show_title -%}
+        <header><h1>{{ _article_title }}</h1></header>
+      {%- endif -%}
+      {%- if _show_edit_on_github -%}
+        {%- if site.repository and site.repository_tree -%}
+          {%- include snippets/is_collection.html page=include.article -%}
+          {%- assign _is_article_collection = __return -%}
+          {%- include snippets/get-locale-string.html key='POST_ON_GITHUB' -%}
+          {%- assign _locale_post_on_github = __return -%}
+          {%- if _is_article_collection -%}
+            {%- include snippets/prepend-path.html path=include.article.path prepend_path=site.collections_dir -%}
+            {%- assign _article_path = __return -%}
+          {%- else -%}
+            {%- assign _article_path = include.article.path -%}
+          {%- endif -%}
+          {%- assign _github_path = site.repository | append: '/tree/' | append: site.repository_tree | append: '/' | append: _article_path | replace:'//','/' -%}
+          <span class="split-space">&nbsp;</span>
+          <a class="edit-on-github"
+            title="{{ _locale_post_on_github }}"
+            href="https://github.com/{{ _github_path }}">
+            <i class="far fa-edit"></i></a>
+        {%- endif -%}
+      {%- endif -%}
+    </div>
+  {%- else -%}
+    <header style="display:none;"><h1>{{ _article_title }}</h1></header>
+  {%- endif -%}
+{%- endif -%}
+
+{%- if include.semantic != false -%}
+  <meta itemprop="headline" content="{{ _article_title }}">
+{%- endif -%}

_includes/article-info.html

@@ -0,0 +1,96 @@
+{%- assign _author = site.data.authors[include.article.author] | default: site.author -%}
+
+{%- if include.html != false -%}
+
+  {%- include snippets/assign.html
+    target=site.data.variables.default.page.show_date
+    source0=layout.show_date source1=include.article.show_date -%}
+  {%- assign _show_date = __return -%}
+  {%- if _show_date and include.article.date -%}
+    {%- assign _show_date = true -%}
+  {%- else -%}
+    {%- assign _show_date = false -%}
+  {%- endif -%}
+
+  {%- include snippets/assign.html
+    target=site.data.variables.default.page.show_tags
+    source0=layout.show_tags source1=include.article.show_tags -%}
+  {%- assign _show_tags = __return -%}
+  {%- if _show_tags and include.article.tags[0] -%}
+    {%- assign _show_tags = true -%}
+  {%- else -%}
+    {%- assign _show_tags = false -%}
+  {%- endif -%}
+
+  {%- assign _show_author = include.article.author -%}
+
+  {%- include snippets/assign.html target=site.data.variables.default.page.pageview
+    source0=layout.pageview source1=page.pageview -%}
+  {%- assign _pageview = __return -%}
+  {%- if _pageview or include.show_pageview -%}
+    {%- assign _pageview = true -%}
+  {%- else -%}
+    {%- assign _pageview = false -%}
+  {%- endif -%}
+
+  {%- assign _paths_archive = site.paths.archive | default: site.data.variables.default.paths.archive -%}
+
+  {%- if _show_tags or _show_author or _show_date or _pageview -%}
+    <div class="article__info clearfix">
+      {%- if _show_tags -%}
+
+        <ul class="left-col menu">
+          {%- assign _tag_path = _paths_archive | append: '?tag=' -%}
+          {%- include snippets/prepend-baseurl.html path=_tag_path -%}
+
+          {%- for _tag in include.article.tags -%}
+            {%- assign _tag_path = __return -%}
+            {%- assign _tag_encode = _tag | strip | url_encode } -%}
+            <li>
+              <a class="button button--secondary button--pill button--sm"
+                href="{{ _tag_path | append: _tag_encode | replace: '//', '/' }}">{{ _tag }}</a>
+            </li>
+          {%- endfor -%}
+        </ul>
+      {%- endif -%}
+
+      {%- if _show_author or _show_date or _pageview -%}
+        <ul class="right-col menu">
+          {%- if _show_author  -%}
+            <li><i class="fas fa-user"></i> <span>{{ _author.name }}</span></li>
+          {%- endif -%}
+
+          {%- if _show_date -%}
+            <li>
+              {%- include snippets/get-locale-string.html key='ARTICLE_DATE_FORMAT' -%}
+              <i class="far fa-calendar-alt"></i> <span>{{ include.article.date | date: __return }}</span>
+            </li>
+          {%- endif -%}
+
+          {%- if _pageview -%}
+            {%- if site.pageview.provider -%}
+              {%- include snippets/get-locale-string.html key='VIEWS' -%}
+              {%- assign _locale_views = __return -%}
+              <li><i class="far fa-eye"></i> <span class="js-pageview" data-page-key="{{ include.article.key }}">0</span> {{ _locale_views }}</li>
+            {%- endif -%}
+          {%- endif -%}
+        </ul>
+      {%- endif -%}
+
+    </div>
+  {%- endif -%}
+{%- endif -%}
+
+
+{%- if include.semantic != false -%}
+  {%- if _author -%}
+    <meta itemprop="author" content="{{ _author.name }}"/>
+  {%- endif -%}
+  {%- if include.article.date -%}
+    <meta itemprop="datePublished" content="{{ include.article.date | date_to_xmlschema }}">
+  {%- endif -%}
+  {%- if include.article.tags[0] -%}
+    {%- assign _keywords = include.article.tags | join: ',' %}
+    <meta itemprop="keywords" content="{{ _keywords }}">
+  {%- endif -%}
+{%- endif -%}

_includes/article-list.html

@@ -0,0 +1,144 @@
+{%- assign _excerpt_truncate = include.excerpt_truncate | default: 350 -%}
+
+{%- assign _excerpt_type = include.excerpt_type -%}
+
+{%- include snippets/get-locale-string.html key='READMORE' -%}
+{%- assign _locale_readmore = __return -%}
+
+{%- assign _sorted_list = include.articles -%}
+{%- if include.group_by == 'year' -%}
+  {%- assign _sorted_list = _sorted_list | sort: 'date' -%}
+{%- endif -%}
+{%- if include.reverse -%}
+  {%- assign _sorted_list = _sorted_list | reverse -%}
+{%- endif -%}
+
+{%- if include.type == 'item' -%}
+<div class="article-list items items--divided">
+{%- elsif include.type == 'brief' -%}
+<div class="article-list items">
+{%- elsif include.type == 'grid' -%}
+  {%- if include.size == 'sm' -%}
+  <div class="article-list grid grid--sm grid--p-3">
+  {%- else -%}
+  <div class="article-list grid grid--p-3">
+  {%- endif -%}
+{%- endif -%}
+
+  {%- for _article in _sorted_list -%}
+
+    {%- include snippets/prepend-baseurl.html path=_article.url -%}
+    {%- assign _article_url = __return -%}
+
+    {%- if _article.cover -%}
+      {%- include snippets/get-nav-url.html path=_article.cover -%}
+      {%- assign _article_cover = __return -%}
+    {%- endif -%}
+
+    {%- if include.type == 'item' -%}
+      {%- if include.article_type == 'BlogPosting' -%}
+        <article class="item" itemscope itemtype="http://schema.org/BlogPosting">
+      {%- else -%}
+        <article class="item">
+      {%- endif -%}
+        {%- if _article.cover and include.show_cover-%}
+          {%- include snippets/get-nav-url.html path=_article.cover -%}
+          {%- assign _article_cover = __return -%}
+          <div class="item__image">
+          {%- if include.cover_size == 'lg' -%}
+            <img class="image image--lg" src="{{ _article_cover }}" />
+          {%- elsif include.cover_size == 'sm' -%}
+            <img class="image image--sm" src="{{ _article_cover }}" />
+          {%- else -%}
+            <img class="image" src="{{ _article_cover }}" />
+          {%- endif -%}
+          </div>
+        {%- endif -%}
+        <div class="item__content">
+          <header><a href="{{ _article_url }}"><h2 itemprop="headline" class="item__header">{{ _article.title }}</h2></a></header>
+          <div class="item__description">
+            {%- if _article.excerpt and include.show_excerpt -%}
+              <div class="article__content" itemprop="description articleBody">
+                {%- if _excerpt_type == 'html' -%}
+                  {{ _article.excerpt }}
+                {%- else -%}
+                  {{ _article.excerpt | strip_html | strip | truncate: _excerpt_truncate }}
+                {%- endif -%}
+              </div>
+            {%- endif -%}
+            {%- if include.show_readmore -%}
+              <p><a href="{{ _article_url }}">{{ _locale_readmore }}</a></p>
+            {%- endif -%}
+          </div>
+          {%- if include.show_info -%}
+            {%- include snippets/assign.html target=site.data.variables.default.page.pageview
+              source0=_article.pageview -%}
+            {%- assign _show_pageview = __return -%}
+            {%- include article-info.html article=_article show_pageview=_show_pageview -%}
+          {%- endif -%}
+        </div>
+      </article>
+
+
+    {%- elsif include.type == 'brief' -%}
+      {%- assign _tags = '' -%}
+      {%- for _tag in _article.tags -%}
+        {%- assign _tag_encode = _tag | strip | url_encode -%}
+        {%- if forloop.last -%}
+          {%- assign _tags = _tags | append: _tag_encode -%}
+        {%- else -%}
+          {%- assign _tags = _tags | append: _tag_encode | append: ',' -%}
+        {%- endif -%}
+      {%- endfor -%}
+      {%- if include.group_by == 'year' -%}
+        {%- assign _currentdate = _article.date | date: '%Y' -%}
+        {%- if _currentdate != _date -%}
+          {%- unless forloop.first -%}</ul></section>{%- endunless -%}
+          <section><h2 class="article-list__group-header">{{ _currentdate }}</h2><ul class="items">
+          {%- assign _date = _currentdate -%}
+        {%- endif -%}
+      {%- endif -%}
+      {%- include snippets/get-locale-string.html key='ARTICLE_LIST_DATE_FORMAT' -%}
+      <li class="item" itemscope itemtype="http://schema.org/BlogPosting" data-tags="{{ _tags }}">
+        <div class="item__content">
+          {%- if include.show_info -%}
+            <span class="item__meta">{{ _article.date | date: __return }}</span>
+          {%- endif -%}
+          <a itemprop="headline" class="item__header" href="{{ _article_url }}">{{ _article.title }}</a></div>
+      </li>
+
+    {%- elsif include.type == 'grid' -%}
+      {%- if include.size == 'sm' -%}
+        <div class="cell cell--12 cell--md-4 cell--lg-3">
+          <div class="card card--flat">
+            {%- if _article.cover -%}
+              <div class="card__image">
+                <img class="image" src="{{ _article_cover }}" />
+                <div class="overlay overlay--bottom">
+                  <header>
+                    <a href="{{ _article_url }}"><h2 class="card__header">{{ _article.title }}</h2></a>
+                  </header>
+                </div>
+              </div>
+            {%- endif -%}
+            </div>
+        </div>
+      {%- else -%}
+
+        <div class="cell cell--12 cell--md-6 cell--lg-4">
+          <div class="card card--flat">
+            {%- if _article.cover -%}
+              <div class="card__image"><img src="{{ _article_cover }}" /></div>
+            {%- endif -%}
+              <div class="card__content">
+                <header>
+                  <a href="{{ _article_url }}"><h2 class="card__header">{{ _article.title }}</h2></a>
+                </header>
+              </div>
+          </div>
+        </div>
+      {%- endif -%}
+    {%- endif -%}
+  {%- endfor -%}
+
+</div>