Metadata-Version: 2.1
Name: Flask-Githubcard
Version: 1.0.4
Summary: Generator a github card for flask web application
Home-page: https://2dogz.cn
Author: jiangwei
Author-email: qq804022023@gmail.com
License: Apache Software License
Description: # flask-githubcard
        A flask's extension to generate a github card for yourself.
        
        [中文文档](https://github.com/weijiang1994/flask-githubcard)
        
        ### Quick Start 
        ```shell
        pip install flask-githubcard
        ```
         Step 1: Initial the extension
         ```python
        from flask import Flask
        from flask_githubcard import GithubCard
        app = Flask(__name__)
        githubcard = GithubCard(app)
        ```
        Step 2: In your `<head>` section of your base template add the following code:
        ```html
        <head>
            {{githubcard.init_css()}}
            {{githubcard.init_js()}}
        </head>
        ```
        Step 3: Render the github card in your template.
        ```html
        <div>
            {{githubcard.generate_card()}}
        </div>
        ```
        Open your browser and visit your web page, github card like bellow here:
        
        ![1623293427414.png](https://7.dusays.com/2021/06/10/66d2716789d8d.png)
        
        ### Advanced
        #### Configure yourself github info
        ```python
        from flask import Flask
        from flask_githubcard import GithubCard
        app = Flask(__name__)
        
        githubcard = GithubCard(app)
        app.config['GITHUB_USERNAME'] = 'weijiang1994'
        app.config['GITHUB_REPO'] = 'Blogin'
        ```
        
        #### Choose theme
        ```html
        <head>
            {{githubcard.init_css(theme='darkly')}}
        </head>
        <div>
            {{githubcard.generate_card(theme='darkly')}}
        </div>
        ```
        
        Darkly Theme
        
        ![1623294104103.png](https://7.dusays.com/2021/06/10/736fed4674429.png)
        
        
        Use Ajax
        
        ```python
        from flask import Flask
        from flask_githubcard import GithubCard
        app = Flask(__name__)
        githubcard = GithubCard(app)
        
        @app.route('/ajax')
        def ajax():
            return jsonify(githubcard.create(theme='darkly').get_raw_data())
        ```
        ### Note
        
        - Due to the use of GitHub's API without authorization, the number of unique IP visits is limited to 60 times per hour, if more than 60 times, 403 will be reported. If the frequency of access is too high, please go to the authorized account on GitHub
        - In the case where the network state is not good, the access to Github will have timeout, which may cause the web page to not open!
Keywords: flask extension development
Platform: any
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
