Markdown renderer for trame
===========================================================================
.. image:: https://github.com/Kitware/trame-markdown/actions/workflows/test_and_release.yml/badge.svg
:target: https://github.com/Kitware/trame-markdown/actions/workflows/test_and_release.yml
:alt: Test and Release
trame-markdown extend trame **widgets** with a component that is capable of rendering Markdown syntax.
Markdown integration into trame allow user to display markdown content easily. If you want are wondering what Markdown is, you can look at `some online guides <https://www.markdownguide.org/basic-syntax/>`_.
Installing
-----------------------------------------------------------
trame-markdown can be installed with `pip <https://pypi.org/project/trame-markdown/>`_:
.. code-block:: bash
pip install --upgrade trame-markdown
Usage
-----------------------------------------------------------
The `Trame Tutorial <https://kitware.github.io/trame/docs/tutorial.html>`_ is the place to go to learn how to use the library and start building your own application.
The `API Reference <https://trame.readthedocs.io/en/latest/index.html>`_ documentation provides API-level documentation.
License
-----------------------------------------------------------
trame-markdown is made available under the MIT License. For more details, see `LICENSE <https://github.com/Kitware/trame-markdown/blob/master/LICENSE>`_
This license has been chosen to match the one use by `Markdown It Vue <https://github.com/ravenq/markdown-it-vue/blob/master/LICENSE>`_ which is used under the cover.
Community
-----------------------------------------------------------
`Trame <https://kitware.github.io/trame/>`_ | `Discussions <https://github.com/Kitware/trame/discussions>`_ | `Issues <https://github.com/Kitware/trame/issues>`_ | `RoadMap <https://github.com/Kitware/trame/projects/1>`_ | `Contact Us <https://www.kitware.com/contact-us/>`_
.. image:: https://zenodo.org/badge/410108340.svg
:target: https://zenodo.org/badge/latestdoi/410108340
Enjoying trame?
-----------------------------------------------------------
Share your experience `with a testimonial <https://github.com/Kitware/trame/issues/18>`_ or `with a brand approval <https://github.com/Kitware/trame/issues/19>`_.
Code sample
-----------------------------------------------------------
.. code-block:: python
from trame.widgets import markdown
widget = markdown.Markdown("""
> #### The quarterly results look great!
>
> - Revenue was off the chart.
> - Profits were higher than ever.
>
> *Everything* is going according to **plan**.
""")
widget.update(md_file.read())
But if you rather be in control of your variable, you can use the property `content`.
.. code-block:: python
from trame.widgets import markdown
widget = markdown.Markdown(content=("var_name", "**hello**"))
Development
-----------------------------------------------------------
To update client side, just update the version and run the following commands.
.. code-block:: bash
mkdir -p trame_markdown/module/serve
cd trame_markdown/module/serve
curl -L https://registry.npmjs.org/markdown-it-vue/-/markdown-it-vue-1.1.7.tgz | tar --strip-components=1 -xzv
Raw data
{
"_id": null,
"home_page": null,
"name": "trame-markdown",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "Python, Interactive, Web, Application, Framework",
"author": "Kitware Inc.",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/13/b0/3f629d630e3b663c8b64b8466adf31a3cef3a51b7ed981b4a8acf76e5229/trame-markdown-3.0.2.tar.gz",
"platform": null,
"description": "Markdown renderer for trame\n===========================================================================\n\n.. image:: https://github.com/Kitware/trame-markdown/actions/workflows/test_and_release.yml/badge.svg\n :target: https://github.com/Kitware/trame-markdown/actions/workflows/test_and_release.yml\n :alt: Test and Release\n\ntrame-markdown extend trame **widgets** with a component that is capable of rendering Markdown syntax.\nMarkdown integration into trame allow user to display markdown content easily. If you want are wondering what Markdown is, you can look at `some online guides <https://www.markdownguide.org/basic-syntax/>`_.\n\n\nInstalling\n-----------------------------------------------------------\n\ntrame-markdown can be installed with `pip <https://pypi.org/project/trame-markdown/>`_:\n\n.. code-block:: bash\n\n pip install --upgrade trame-markdown\n\n\nUsage\n-----------------------------------------------------------\n\nThe `Trame Tutorial <https://kitware.github.io/trame/docs/tutorial.html>`_ is the place to go to learn how to use the library and start building your own application.\n\nThe `API Reference <https://trame.readthedocs.io/en/latest/index.html>`_ documentation provides API-level documentation.\n\n\nLicense\n-----------------------------------------------------------\n\ntrame-markdown is made available under the MIT License. For more details, see `LICENSE <https://github.com/Kitware/trame-markdown/blob/master/LICENSE>`_\nThis license has been chosen to match the one use by `Markdown It Vue <https://github.com/ravenq/markdown-it-vue/blob/master/LICENSE>`_ which is used under the cover.\n\n\nCommunity\n-----------------------------------------------------------\n\n`Trame <https://kitware.github.io/trame/>`_ | `Discussions <https://github.com/Kitware/trame/discussions>`_ | `Issues <https://github.com/Kitware/trame/issues>`_ | `RoadMap <https://github.com/Kitware/trame/projects/1>`_ | `Contact Us <https://www.kitware.com/contact-us/>`_\n\n.. image:: https://zenodo.org/badge/410108340.svg\n :target: https://zenodo.org/badge/latestdoi/410108340\n\n\nEnjoying trame?\n-----------------------------------------------------------\n\nShare your experience `with a testimonial <https://github.com/Kitware/trame/issues/18>`_ or `with a brand approval <https://github.com/Kitware/trame/issues/19>`_.\n\n\nCode sample\n-----------------------------------------------------------\n\n.. code-block:: python\n\n from trame.widgets import markdown\n\n widget = markdown.Markdown(\"\"\"\n > #### The quarterly results look great!\n >\n > - Revenue was off the chart.\n > - Profits were higher than ever.\n >\n > *Everything* is going according to **plan**.\n \"\"\")\n widget.update(md_file.read())\n\nBut if you rather be in control of your variable, you can use the property `content`.\n\n.. code-block:: python\n\n from trame.widgets import markdown\n\n widget = markdown.Markdown(content=(\"var_name\", \"**hello**\"))\n\n\nDevelopment\n-----------------------------------------------------------\n\nTo update client side, just update the version and run the following commands.\n\n.. code-block:: bash\n\n mkdir -p trame_markdown/module/serve\n cd trame_markdown/module/serve\n curl -L https://registry.npmjs.org/markdown-it-vue/-/markdown-it-vue-1.1.7.tgz | tar --strip-components=1 -xzv\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Markdown widget for trame",
"version": "3.0.2",
"project_urls": null,
"split_keywords": [
"python",
" interactive",
" web",
" application",
" framework"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ad378b98ca08242e08708de5c55e5c79cc618b73351b04bf3f4a290d7d20ddb7",
"md5": "153268e056122ff7d0f26d6ab6bb9661",
"sha256": "c2ef553029f058f1f959d0330ecce584a4681ae0b05fd188748262b1ab68851c"
},
"downloads": -1,
"filename": "trame_markdown-3.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "153268e056122ff7d0f26d6ab6bb9661",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 2594820,
"upload_time": "2024-09-23T23:00:32",
"upload_time_iso_8601": "2024-09-23T23:00:32.796811Z",
"url": "https://files.pythonhosted.org/packages/ad/37/8b98ca08242e08708de5c55e5c79cc618b73351b04bf3f4a290d7d20ddb7/trame_markdown-3.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "13b03f629d630e3b663c8b64b8466adf31a3cef3a51b7ed981b4a8acf76e5229",
"md5": "21b624beaba0bba1a2ceed7a8f71c0bf",
"sha256": "8de1b8c4a92a583f12601f28ddeb9b6ad0a7b3d8d43316285f86c64d6035640d"
},
"downloads": -1,
"filename": "trame-markdown-3.0.2.tar.gz",
"has_sig": false,
"md5_digest": "21b624beaba0bba1a2ceed7a8f71c0bf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 2462929,
"upload_time": "2024-09-23T23:00:35",
"upload_time_iso_8601": "2024-09-23T23:00:35.201858Z",
"url": "https://files.pythonhosted.org/packages/13/b0/3f629d630e3b663c8b64b8466adf31a3cef3a51b7ed981b4a8acf76e5229/trame-markdown-3.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-23 23:00:35",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "trame-markdown"
}