{"id":16156357,"url":"https://github.com/flowdalic/rubber","last_synced_at":"2025-04-07T01:17:27.716Z","repository":{"id":140516341,"uuid":"232824702","full_name":"Flowdalic/rubber","owner":"Flowdalic","description":null,"archived":false,"fork":false,"pushed_at":"2020-08-24T11:13:43.000Z","size":4617,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-13T06:43:05.117Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Flowdalic.png","metadata":{"files":{"readme":"README","changelog":"NEWS","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-01-09T14:13:23.000Z","updated_at":"2020-01-09T14:14:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"52759ca8-7856-4d96-ad74-e907249c6646","html_url":"https://github.com/Flowdalic/rubber","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Flowdalic%2Frubber","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Flowdalic%2Frubber/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Flowdalic%2Frubber/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Flowdalic%2Frubber/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Flowdalic","download_url":"https://codeload.github.com/Flowdalic/rubber/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247574092,"owners_count":20960497,"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","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":[],"created_at":"2024-10-10T01:44:44.143Z","updated_at":"2025-04-07T01:17:27.691Z","avatar_url":"https://github.com/Flowdalic.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"This is Rubber.\n\nRubber is a building system for LaTeX documents. It is based on a routine that\nruns just as many compilations as necessary and runs companion programs like\nBibTeX and Makeindex when needed. The module system provides a great\nflexibility that virtually allows support for any package with no user\nintervention, as well as pre- and post-processing of the document. A good\nnumber of standard packages are supported, including graphics/graphicx with\nautomatic conversion between various graphics formats and Metapost\ncompilation. The associated tool \"rubber-info\" extracts information, such as\ndependency relations or post-compilation diagnostics.\n\n\n* Installation\n\nRunning Rubber just requires Python 3.5.  Of course it won't\nbe of much use without a working LaTeX environment (Rubber is known to work on\nTeXLive and VTeX on various flavors of Unix including Darwin and Cygwin, any\nfeedback is welcome about other systems).\n\nFor compilation, you will need the Python Distutils, which are usually included\nin development packages (in Debian, this is the python3-dev package).  To build\nthe documentation, you need texinfo (Debian package: texinfo).\n\nTo compile and install Rubber, just follow the usual procedure:\n\n# python3 setup.py --help\n# python3 setup.py install\n# python3 setup.py clean --all\n\n\nSome useful options to setup.py include:\n\nDisabling info docs:\n\n# python3 setup.py build --info=False install\n\nand similar for --html, --man, --pdf.\n\nChanging the installation path for manpages:\n\n# python3 setup.py install --mandir=/path/to/man/pages\n\nInstalling to a staging directory instead of the root/prefix:\n\n# python3 setup.py install --root=/staging/directory\n\nNote that if you need build and install to be two different steps\n(for example when building packages for distribution purposes),\nPython's distutils will forget about any 'build' options, and re-build\nwith default options during the 'install' stage.  This is worrysome if\nyou'd like not to build some of the documentation.  It is then best\nto make options permanent by putting them info a setup.cfg file.  For\nexample:\n\n[build]\nman = 1\nhtml = 0\npdf = 0\ninfo = 0\ntxt = 0\n[install]\nprefix  = /usr\n\nFinally, invoke\n\n# python3 setup.py build\n# python3 setup.py install --root=/staging/directory\n\n\n* Usage\n\nAs civility requires, saying `rubber --help' and `rubber-info --help' provides\na short description of the command line's syntax. The included manual pages\n(available in English and French) and Texinfo documentation contain more\nprecise usage information.\n\n\n* Known Bugs\n\nRubber is generally working fine, though there are some known issues.\n\n1) Rubber tries to do too much.  Rubber attempts to provide a one-stop solution\nto compiling a TeX document, and run a lot of related software as needed.\n\nThis approach is fragile for three reasons: a) It does so by parsing the .tex\nfile itself, and all included files, and discovering any related input files.\nTeX is a hard language to parse correctly without embedding a full TeX\ninterpreter, which rubber does not do.  b) To do its work, Rubber needs to be\ntaught about every version of every package in the TeX ecosystem in order to\ngauge its impact on the compilation of a TeX document.  It needs to know the\npreferences of any TeX compiler with regards to image formats, search paths\netc.  All this information is hard to keep up to date.  c) In some cases (like\nimage conversion), it needs to outright guess what the user intends to do, and\nmay in fact guess incorrectly.\n\nIn a future release, some of these features may be taken out in favor of more\nmodern ways to accomplish the same thing, with to goal to render Rubber simpler\nand more robust.  One might want to make use of the -recorder feature (.fls)\nfor example instead of attempting to read the same information from the\nhuman-readable log file.\n\n2) The codebase has been cleaned up considerably, has been converted to Python3\nand is generally in a sane state.  Nevertheless, it has been written over a\nnumber of years, and some features would be implemented differently or skipped\naltogether if a rewrite were attempted (e.g. the onchange mechanism, modules,\n...).\n\n3) In some cases, Rubber will trigger a recompile that is arguably unnecessary.\nRubber tries to err on the side of caution here.\n\n\n* Author\n\nRubber was originally written by Emmanuel Beffara \u003cemmanuel@beffara.org\u003e.\nIt is currently maintained by Sebastian Kapfer \u003csebastian.kapfer@fau.de\u003e\nand Nicolas Boulenguez \u003cnicolas@debian.org\u003e.\n\nIts homepage can be found at https://launchpad.net/rubber.\n\nThanks to all those who provided testing, comments and suggestions, and\nre-thanks to those who wrote patches and bugfixes.\n\nAny kind of feedback is appreciated, in order to make this program as useful\nand robust as possible.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflowdalic%2Frubber","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflowdalic%2Frubber","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflowdalic%2Frubber/lists"}