vundle_kr.txt

*vundle.txt*              Vundle, Vim 플러그인 매니저.             *vundle*

                              VUNDLE MANUAL

1. Vundle이란                                      |vundle-about|
2. 빠른 시작                                         |vundle-quickstart|
3. 플러그인                                          |vundle-plugins|
  3.1. 플러그인 환경설정                               |vundle-plugins-configure|
  3.2. URI 지원                                     |vundle-plugins-uris|
  3.3. 플러그인 설치                                  |vundle-plugins-install|
  3.4. 플러그인 업데이트                               |vundle-plugins-update|
  3.5. 플러그인 검색                                  |vundle-plugins-search|
  3.6. 플러그인 리스트                                 |vundle-plugins-list|
  3.7. 플러그인 정리                                  |vundle-plugins-cleanup|
4. Interactive 모드                                 |vundle-interactive|
5. 단축키                                           |vundle-keymappings|
6. 옵션                                            |vundle-options|
7. 플러그인 인터페이스 수정                             |vundle-interface-change|

=============================================================================
1. VUNDLE이란 ~
                                                               *vundle-about*

Vundle은 Vim bundle 의 약자로 Vim 플러그인 매니저입니다.

Vundle은 다음 기능들을 제공합니다.

  - `.vimrc`에 직접 플러그인들의 기록을 남기고 환경설정하기
  - 플러그인들을 설치하기 (scripts/bundle 와 같음)
  - 플러그인들을 업데이트하기
  - 사용 가능한 Vim scripts를 이름으로 검색하기
  - 사용하지 않는 플러그인들을 정리하기
  - interactive 모드에서 위 기능들을 하나의 키 로 실행하기

Vundle은 자동으로 다음을 수행합니다.

  - 설치된 스크립트들의 runtime 경로를 관리합니다
  - 설치 및 업데이트 후 도움말 태그를 재생성합니다

Vundle의 검색 기능은 http://vim-scripts.org 을 참고해 사용 가능한 모든 Vim script들의
리스트를 제공합니다

Vundle은 현재 인터페이스 수정 중입니다. 자세한 내용은 |vundle-interface-change|를
확인하십시오.

=============================================================================
2. 빠른 시작 ~
                                                          *vundle-quickstart*

1. 시작하기:

  Vundle을 설치하기 위해선 Git이 필요합니다. 설치 과정에서 각각의 저장소를
  ~/.vim/bundle/ 경로에 기본값으로 git clone합니다. 검색 기능을 위해 Curl이 필요합니다.

                                                             *vundle-windows*
  Windows 사용자라면, 다음의 위키 문서를 참조하십시오.
  https://github.com/VundleVim/Vundle.vim/wiki/Vundle-for-Windows.

                                                                 *vundle-faq*
  만약 어떤 문제라도 발생한다면, 자주 묻는 질문에 도움을 요청하십시오.
  https://github.com/VundleVim/Vundle.vim/wiki

2. Vundle 설치하기:
>
  git clone https://github.com/VundleVim/Vundle.vim.git ~/.vim/bundle/Vundle.vim
<
3. 번들 설정하기:

  Vundle을 사용하기 위해 다음을 .vimrc 파일의 첫 줄에 붙여넣으십시오.
  필요 없는 플러그인들을 삭제하십시오. 다음은 예시입니다.
>
    set nocompatible              " Vi와 호환 불가 설정, 필수
    filetype off                  " 필수

    " Vundle을 포함시키기 위해 runtime 경로를 설정하고 초기화
    set rtp+=~/.vim/bundle/Vundle.vim
    call vundle#begin()
    " 기존 경로 대신 Vundle이 플러그인을 설치할 경로를 입력하십시오.
    "call vundle#begin('~/some/path/here')

    " Vundle이 스스로를 관리하도록 설정, 필수
    Plugin 'VundleVim/Vundle.vim'

    " 아래는 지원되는 여러 형식들의 예시입니다
    " 플러그인 명령어를 vundle#begin/end 사이에 추가하십시오
    " GitHub 저장소에 있는 플러그인
    Plugin 'tpope/vim-fugitive'
    " http://vim-scripts.org/vim/scripts.html 에 있는 플러그인
    " 'L9' 플러그인
    " GitHub에 호스트 되어있지 않는 Git 플러그인
    Plugin 'git://git.wincent.com/command-t.git'
    " 사용하는 기기의 git 저장소 ( 당신만의 플러그인을 사용할 때 )
    Plugin 'file:///home/gmarik/path/to/plugin'
    " sparkup vim script는 vim 이란 이름의 저장소 하위 디렉토리 내부에 있습니다.
    " 정확한 runtime 경로를 입력하십시오.
    Plugin 'rstacruz/sparkup', {'rtp': 'vim/'}
    " L9를 설치하고, 만약 당신이 다른 버전을 어딘가 설치했을 경우 발생하는 이름 충돌 문제를 방지합니다
    " Plugin 'ascenator/L9', {'name': 'newL9'}

    " 당신의 모든 플러그인은 다음 명령어 이전에 추가되어야 합니다
    call vundle#end()            " 필수
    filetype plugin indent on    " 필수
    " 플러그인의 들여쓰기 변화를 무시하려면, 대신 이 명령어를 사용하십시오:
    "filetype plugin on
    "
    " 간단한 도움말
    " :PluginList       - 설정된 플러그인의 리스트
    " :PluginInstall    - 플러그인 설치; 업데이트를 하려면 `!`를 덧붙이거나 :PluginUpdate 명령을 사용하십시오
    " :PluginSearch foo - foo에 대해 검색; `!`를 덧붙여 로컬 캐시를 새로고침하십시오
    " :PluginClean      - 사용하지 않는 플러그인의 삭제를 확인; `!`를 붙여 자동 삭제를 승인하십시오
    "
    " 더 자세한 내용은 :h vundle 문서나 wiki의 FAQ를 확인하십시오
    " 다음 줄부터 플러그인이 아닌 내용을 넣으십시오

4. 설정된 번들 설치하기:

  vim을 켠 후 다음을 실행하십시오
>
    :PluginInstall
<
  명령줄에서 설치:
>
    vim +PluginInstall +qall

=============================================================================
3. 플러그인 ~
                                                             *vundle-plugins*

3.1 플러그인 설정하기 ~
                                         *vundle-plugins-configure* *:Plugin*

Vundle은 `.vimrc`에서 `Plugin` 명령을 통해 설정하고 싶은 플러그인을 기록합니다.
각 `Plugin` 명령은 Vundle이 스크립트를 |runtimepath|에 추가하고 시작 시 활성화하도록 알려줍니다.
주석 처리나 명령줄 삭제를 통해 `Plugin`을 비활성화할 수 있습니다.

각 `Plugin` 명령은 스크립트를 가리키는 URI를 가집니다.
어떤 주석도 명령과 같은 줄에 작성 될 수 없습니다. 다음은 예시입니다:
>
  Plugin 'git_URI'

`Plugin` 명령어는 선택적으로 URI 뒤에 두 번째 인자를 가질 수 있습니다.
딕셔너리 형태여야 하고, URI와 쉼표로 구분되어야 합니다. 딕셔너리의 각 키-값 쌍은 환경설정 옵션입니다.

다음의 스크립트 전에 작성되는 환경설정 옵션들은 사용 가능합니다.

'rtp' 옵션
----------------

저장소 내 vim 플러그인이 존재하는 경로를 명시합니다. (저장소의 root 디렉토리부터 상대 경로)
이 옵션은 |runtimepath|에 추가될 경로를 결정합니다.

예시:
>
  Plugin 'git_URI', {'rtp': 'some/subdir/'}

이 옵션은 하위 디렉토리에 vim 플러그인을 넣은 git 저장소에서 사용 가능합니다.

'name' 옵션
-----------------

설정된 스크립트의 로컬 복제본이 가질 경로의 이름을 명시합니다.

예시:
>
  Plugin 'git_URI', {'name': 'newPluginName'}

이 옵션은 Vundle이 같은 경로에 복제하려 할 때 발생하는 플러그인 간의 이름 충돌을 방지할 수 있습니다.
또한 추가적인 단계의 커스터마이징을 제공합니다.

'pinned' 옵션
-------------------

만약 옵션 플래그가 1로 설정되어 있다면, 이미 `bundles` 디렉토리 내에 존재하는 플러그인을
|runtimepath|에 추가하는 동안 Vundle이 플러그인에서 어떤 명령도 수행하지 못하도록 합니다.

For example:
>
  Plugin 'mylocalplugin', {'pinned': 1}

이 기능은 사용자가 Git 이외의 버전 관리 시스템을 Vundle과 함께 포함시킬 수 있도록 해주지만,
사용자는 저장소를 복제하고 최신 상태를 유지해야 합니다.
또한 사용자가 Vundle이 예전에 업데이트한 플러그인의 버전에 남아있을 수 있도록 합니다.

URI는 다른 플러그인에도 같은 것으로 취급되고,그 마지막 단계는 |runtimepath|에 추가되는 것임을
주의해주십시오. 혼동을 방지하기 위해 이 옵션 플래그를 single word URI에만 사용하는 것이 바람직합니다.

3.2 SUPPORTED URIS ~
                                                        *vundle-plugins-uris*

`Vundle` integrates very well with both GitHub and vim-scripts.org
(http://vim-scripts.org/vim/scripts.html) allowing short URIs. It also allows
the use of any URI `git` recognizes. In all of the following cases (except
local) the 'https' protocol is used, see Vundle's options to override this.

More information on `git`'s protocols can be found at:
http://git-scm.com/book/ch4-1.html

GitHub
------
GitHub is used when a user/repo is passed to `Plugin`.
>
  Plugin 'VundleVim/Vundle.vim' => https://github.com/VundleVim/Vundle.vim

Vim Scripts
-----------
Any single word without a slash '/' is assumed to be from Vim Scripts.
>
  Plugin 'ctrlp.vim' => https://github.com/vim-scripts/ctrlp.vim

Other Git URIs
--------------
No modification is performed on valid URIs that point outside the above
URLs.
>
  Plugin 'git://git.wincent.com/command-t.git'

Local Plugins
-------------
The git protocol supports local installation using the 'file://' protocol.
This is handy when developing plugins locally. Follow the protocol with an
absolute path to the script directory.
>
  Plugin 'file:///path/from/root/to/plugin'

3.3 INSTALLING PLUGINS ~
                                    *vundle-plugins-install* *:PluginInstall*
>
  :PluginInstall

Will install all plugins configured in your `.vimrc`. Newly installed
plugins will be automatically enabled. Some plugins may require extra steps
such as compilation or external programs, refer to their documentation.

PluginInstall allows installation of plugins by name:
>
  :PluginInstall unite.vim

Installs and activates unite.vim.

PluginInstall also allows installation of several plugins separated by space.
>
  :PluginInstall tpope/vim-surround tpope/vim-fugitive

Installs both tpope/vim-surround and tpope/vim-fugitive from GitHub.

You can use Tab to auto-complete known script names.
Note that the installation just described isn't permanent. To
finish, you must put `Plugin 'unite.vim'` at the appropriate place in your
`.vimrc` to tell Vundle to load the plugin at startup.

After installing plugins press 'l' (lowercase 'L') to see the log of commands
if any errors occurred.

3.4 UPDATING PLUGINS ~
                    *vundle-plugins-update* *:PluginUpdate* *:PluginInstall!*
>
  :PluginInstall!   " NOTE: bang(!)
or >
  :PluginUpdate

Installs or updates the configured plugins. Press 'u' after updates complete
to see the change log of all updated bundles. Press 'l' (lowercase 'L') to
see the log of commands if any errors occurred.

To update specific plugins, write their names separated by space:
>
  :PluginInstall! vim-surround vim-fugitive
or >
  :PluginUpdate vim-surround vim-fugitive

3.5 SEARCHING PLUGINS ~
                                      *vundle-plugins-search* *:PluginSearch*
>
  :PluginSearch

Search requires that `curl` be available on the system. The command searches
Vim Scripts (http://vim-scripts.org/vim/scripts.html) for matching
plugins. Results display in a new split window. For example:
>
  PluginSearch foo

displays:
>
  "Search results for: foo
  Plugin 'MarkdownFootnotes'
  Plugin 'VimFootnotes'
  Plugin 'foo.vim'
<
                                                             *:PluginSearch!*
Alternatively, you can refresh the script list before searching by adding a
bang to the command.
>
  :PluginSearch! foo

If the command is run without argument:
>
  :PluginSearch!

it will display all known plugins in the new split.

3.6 LISTING BUNDLES ~
                                          *vundle-plugins-list* *:PluginList*
>
  :PluginList

Displays a list of installed bundles.

3.7 CLEANING UP ~
                                      *vundle-plugins-cleanup* *:PluginClean*
>
  :PluginClean

Requests confirmation for the removal of all plugins no longered configured
in your `.vimrc` but present in your bundle installation directory
(default: `.vim/bundle/`).

                                                              *:PluginClean!*
>
  :PluginClean!

Automatically confirm removal of unused bundles.

=============================================================================
4. INTERACTIVE MODE ~
                                                         *vundle-interactive*

Vundle provides a simple interactive mode to help you explore new plugins
easily.  Interactive mode is available after any command that lists `Plugins`
such as PluginSearch, PluginList or Plugins. For instance:
>
  :PluginSearch! unite

Searches for plugins matching 'unite' and yields a split window with:
>
  "Keymap: i - Install bundle; c - Cleanup; s - Search; R - Reload list
  "Search results for: unite
  Plugin 'unite-scriptenames'
  Plugin 'unite.vim'
  Plugin 'unite-yarm'
  Plugin 'unite-gem'
  Plugin 'unite-locate'
  Plugin 'unite-font'
  Plugin 'unite-colorscheme'

To install a bundle, move your cursor to the Plugin of interest and then
select a command. To install 'unite.vim' put your cursor on the line and
then push `i`. For a more complete list see |vundle-keymappings|. After
unite.vim is installed the `:Unite file` command should be available.

Note: Interactive installation doesn't update your `.vimrc`.

=============================================================================
5. KEY MAPPINGS ~
                                                         *vundle-keymappings*

KEY | DESCRIPTION
----|-------------------------- >
 i  |  run :PluginInstall with name taken from line cursor is positioned on
 I  |  same as i, but runs :PluginInstall! to update bundle
 D  |  delete selected bundle (be careful not to remove local modifications)
 c  |  run :PluginClean
 s  |  run :PluginSearch
 R  |  fetch fresh script list from server

=============================================================================
6. OPTIONS ~
                                                             *vundle-options*
>
  let g:vundle_default_git_proto = 'git'
<
  This option makes Vundle use `git` instead of `https` when building
  absolute URIs. For example:
>
    Plugin 'sjl/gundo.vim' -> git@github.com:sjl/gundo.git

=============================================================================
7. VUNDLE INTERFACE CHANGE ~
                        *vundle-interface-change* *:Bundle* *:BundleInstall!*
                *:BundleUpdate* *:BundleSearch* *:BundleList* *:BundleClean!*
                            *:VundleInstall!* *:VundleUpdate* *:VundleSearch*
                                                *:VundleList* *:VundleClean!*

  In order to bring in new changes, Vundle is adopting a new interface.
  Going forward we will support primarily the Plugin namespace, additionally
  for convenience we will also alias some commands to the Vundle namespace.
  The following table summarizes the interface changes.

  Deprecated Names  | New Names
  -----------------------------
  Bundle            | Plugin
  BundleInstall(!)  | PluginInstall(!), VundleInstall(!)
  BundleUpdate      | PluginUpdate, VundleUpdate
  BundleSearch(!)   | PluginSearch(!), VundleSearch(!)
  BundleClean       | PluginClean(!), VundleClean(!)
  BundleList        | PluginList

  Note: The Bundle commands will be deprecated. You may continue using them,
  but they may not get all future updates. For instance, we have enabled
  comments on Plugin lines but not Bundle, since it requires a change in
  command declaration.

" vim: set expandtab sts=2 ts=2 sw=2 tw=78 ft=help norl: