{"id":14235476,"url":"https://github.com/myint/rst2beamer","last_synced_at":"2025-08-11T00:31:36.633Z","repository":{"id":8799328,"uuid":"10493087","full_name":"myint/rst2beamer","owner":"myint","description":"reStructuredText to Beamer (LaTeX) converter (with Python 3 support)","archived":false,"fork":true,"pushed_at":"2019-07-25T02:00:07.000Z","size":1941,"stargazers_count":9,"open_issues_count":3,"forks_count":4,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-07-23T08:10:59.948Z","etag":null,"topics":["beamer","python","restructuredtext"],"latest_commit_sha":null,"homepage":"https://pypi.python.org/pypi/rst2beamer3k","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"rst2beamer/rst2beamer","license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/myint.png","metadata":{"files":{"readme":"README.rst","changelog":"HISTORY.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-06-05T02:07:51.000Z","updated_at":"2022-06-10T09:07:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/myint/rst2beamer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/myint/rst2beamer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/myint%2Frst2beamer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/myint%2Frst2beamer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/myint%2Frst2beamer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/myint%2Frst2beamer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/myint","download_url":"https://codeload.github.com/myint/rst2beamer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/myint%2Frst2beamer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269813541,"owners_count":24479340,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-10T02:00:08.965Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["beamer","python","restructuredtext"],"created_at":"2024-08-20T21:01:58.851Z","updated_at":"2025-08-11T00:31:36.225Z","avatar_url":"https://github.com/myint.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"==========\nrst2beamer\n==========\n\n.. image:: https://travis-ci.org/myint/rst2beamer.svg?branch=master\n    :target: https://travis-ci.org/myint/rst2beamer\n    :alt: Build status\n\n\nIntroduction\n============\n\nA docutils script converting reStructuredText into Beamer-flavoured LaTeX.\n\nBeamer is a LaTeX document class for presentations. rst2beamer\nprovides a docutils writer that transforms reStructuredText\ninto Beamer-flavoured LaTeX and provides a command-line script for the\nsame. Via this script, reStructuredText can therefore be used to prepare slides\nand presentations.\n\nThis is an unofficial fork (of https://pypi.python.org/pypi/rst2beamer) that\nruns on both Python 2 and 3.\n\n\nInstallation\n============\n\nUsing ``pip``::\n\n    $ pip install --upgrade rst2beamer3k\n\nBeamer dependency\n-----------------\n\nOn MacPorts::\n\n    $ sudo port install texlive-latex -x11 texlive-fonts-recommended -x11\n\n\nUsage\n=====\n\nrst2beamer should interpret a reasonable subset of reStructuredText and\nproduce reasonable LaTeX. Not all features of Beamer have been implemented,\njust a (large) subset that allows the quick production of good looking slides.\nThese include:\n\n* Overlay lists (i.e. list items that appear point-by-point).\n* Beamer themes.\n* Automatic centering and resizing of figures.\n* Embedded notes and the output of note slides.\n* Arranging slide contents into columns.\n\nSome examples can be found in the ``docs/examples`` directory of the\ndistribution. In practice, rst2beamer can be used with ``pdflatex`` to get PDF\nversions of a presentation.\n\nrst2beamer is called::\n\n    $ rst2beamer [options] [\u003csource\u003e [\u003cdestination\u003e]]\n\nFor example::\n\n    $ rst2beamer infile.txt outfile.tex\n\n``infile.txt`` contains the reStructuredText and ``outfile.tex`` contains the\nproduced Beamer LaTeX.\n\nIt supports the usual docutils and LaTeX writer (``rst2latex``) options, save\nthe ``documentclass`` option (which is fixed to ``beamer``) and ``hyperref``\noptions (which are already set in Beamer). It also supports::\n\n    --theme=THEME           Specify Beamer theme.\n    --overlaybullets=OVERLAYBULLETS\n                            Overlay bulleted items. Put [\u003c+-| alert@+\u003e] at the\n                            end of \\begin{itemize} so that Beamer creats an\n                            overlay for each bulleted item and the presentation\n                            reveals one bullet at a time\n    --centerfigs=CENTERFIGS\n                            Center figures.  All includegraphics statements will\n                            be put inside center environments.\n    --documentoptions=DOCUMENTOPTIONS\n                            Specify document options. Multiple options can be\n                            given, separated by commas.  Default is\n                            \"10pt,a4paper\".\n    --shownotes=SHOWNOTES   Print embedded notes along with the slides. Possible\n                            arguments include 'false' (don't show), 'only' (show\n                            only notes), 'left', 'right', 'top', 'bottom' (show\n                            in relation to the annotated slide).\n\n\nLimitations\n===========\n\nEarlier versions of rst2beamer did not work with docutils 0.4, seemingly due\nto changes in the LaTeX writer. While this has been fixed, most work has been\ndone with docutils snapshots from version 0.5 and up. In balance, users are\nrecommended to update docutils.\n\nMore recently, changes in the LaTeX writer in docutils 0.6 broke rst2beamer\nagain. We think all those bugs have been caught.\n\nNot all features of Beamer are supported, and some - that deal with with page\nlayout or presentation - may never be. Introducing complex syntax to achieve\ncomplex and specific page effects defeats the point of reStructuredText's\nsimple and easy-to-write format. If you need a complex presentation, use\nPowerPoint or Keynote.\n\nIf the content for an individual slide is too large, it will simply overflow\nthe edges of the slide and disappear. Arguably, this is a sign you should put\nless on each slide.\n\n\nCredits\n=======\n\nrst2beamer is developed by `Ryan Krauss \u003cryanwkrauss@gmail.com\u003e`__ and\n`Paul-Michael Agapow \u003cagapow@bbsrc.ac.uk\u003e`__. Thanks to those who reported and\nhelped us track down bugs: Perttu Laurinen, Mike Pennington, James Haggerty\nand Dale Hathaway.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmyint%2Frst2beamer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmyint%2Frst2beamer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmyint%2Frst2beamer/lists"}