Metadata-Version: 1.2
Name: mkdocs-gitsnippet-plugin
Version: 1.0.1
Summary: Mkdocs plugin that allow to inject snippet or all markdown content from a given remote git repository.
Home-page: https://github.com/SamazoOo/mkdocs-gitsnippet-plugin
Author: Samuel Comino
Author-email: samuel.covi@gmail.com
License: MIT
Description: # About
        
        MkDocs plugin that allow to inject snippet or all markdown content from a given remote git repository.
        The goal is to show different markdowns from different projects inside a MkDocs, you put together all info across some projects.
        
        ## Installation
        
        Install the package with pip:
        
        ```bash
        pip install mkdocs-gitsnippet-plugin
        ```
        
        ## Configuration
        
        Enable the plugin in your `mkdocs.yml` if **you didn't change the folder name that contain your documentation source files.** By default `docs`.
        
        ```yaml
        plugins:
        - gitsnippet
        ```
        
        Enable the plugin in your `mkdocs.yml` if **you changed the folder name that contain your documentation source files**. By default `docs`.
        
        ```yaml
        plugins:
        - gitsnippet:
        base_path: docs
        ```
        
        > This package requires MkDocs version 0.17 or higher.
        
        ## Usage
        
        mkdocs-gitsnippet-plugin will download the file you specify from a remote git repository, extract the section or all content and inject that into you MkDocs file at render time.
        
        ### Snippet a section
        
        If you want to extract a section from a remote git repository, you can add the following to your markdown in MkDocs:
        
        ```markdown
        {{ gitsnippet('git@github.com:SamazoOo/mkdocs-gitsnippet-plugin.git', 'README.md', '## Installation') }}
        ```
        ### All markdown content
        
        If you want to get all context from a markdown in a remote git repository, you can add the following to your markdown in MkDocs:
        
        ```markdown
        {{ gitsnippet('git@github.com:SamazoOo/mkdocs-gitsnippet-plugin.git', 'README.md', '') }}
        ```
        
        ### Images references
        
        If the remote file has references to images, those will also be downloaded and placed in a `_gen` folder in the mkdocs hierarchy. You will probably want to include `**/gen_` in your `.gitignore` file so you don't put those into your git repository unless you want them there.
        
Keywords: mkdocs python markdown snippet git
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=2.7.9,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*
