{"id":13910571,"url":"https://github.com/marekjm/docs-formatter","last_synced_at":"2025-07-04T15:33:53.910Z","repository":{"id":142429489,"uuid":"163810538","full_name":"marekjm/docs-formatter","owner":"marekjm","description":"Docs formatter","archived":false,"fork":false,"pushed_at":"2022-05-20T19:09:05.000Z","size":68,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-02T02:46:07.281Z","etag":null,"topics":["docs-generator","documentation","documentation-tool","text-formatting"],"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-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marekjm.png","metadata":{"files":{"readme":"README.txt","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2019-01-02T07:47:54.000Z","updated_at":"2023-03-27T17:50:36.000Z","dependencies_parsed_at":null,"dependency_job_id":"01c7c006-1e61-46ac-a8a1-316af9903fe7","html_url":"https://github.com/marekjm/docs-formatter","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/marekjm%2Fdocs-formatter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marekjm%2Fdocs-formatter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marekjm%2Fdocs-formatter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marekjm%2Fdocs-formatter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marekjm","download_url":"https://codeload.github.com/marekjm/docs-formatter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245949652,"owners_count":20698925,"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":["docs-generator","documentation","documentation-tool","text-formatting"],"created_at":"2024-08-07T00:01:34.945Z","updated_at":"2025-03-28T01:16:01.422Z","avatar_url":"https://github.com/marekjm.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"                                 Docs formatter                                 \n                                ----------------                                \n\n\n                              OVERVIEW OF CONTENTS                              \n\n1 _______________________________________________________________________ README\n2 _____________________________________________________________________ Features\n3 ______________________________________________________________________ License\n\n--------------------------------------------------------------------------------\n\n\n                               TABLE OF CONTENTS                                \n\n1 _______________________________________________________________________ README\n1.1 ..................................................................... Output\n1.2 ...................................................................... Input\n2 _____________________________________________________________________ Features\n2.1 ......................................................... Lists vs \"listeds\"\n2.2 ................................................. Function call tree example\n2.3 ....................................................... Features not present\n3 ______________________________________________________________________ License\n\n--------------------------------------------------------------------------------\n\n\n\n  [1] README {readme}\n\n  Docs formatter - a text formatter for documentation.\n\n\n  [1.1] Output {readme.output}\n\n  It  produces  a  preformatted  text output suitable for viewing on the command\n  line and HTML output suitable for the Web. The HTML output is preformatted and\n  looks  exactly  like  the  plain  text  output  for the command line; the only\n  difference is the presence of hyperlinks and basic colourisation.\n\n\n  [1.2] Input {readme.input}\n\n  It takes source in LaTeX-like notation as input.\n\n\n  [2] Features {features}\n\n  Features of the formatter include:\n\n  - automatic generation of Table of Contents\n  - arbitrarily nested sections to express the necessary hierarchy\n  - automatic text reflow\n  - lists of items\n  - \"listeds\"  displaying all possible values of certain kind (e.g. instructions\n    of an architecture, packet types in a protocol)\n  - automatic formatting of function call trees\n  - references (forward and backward)\n  - file inclusion\n\n\n  [2.1] Lists vs \"listeds\"\n\n  Here is an example of a list:\n\n  - hello\n  - world\n  - lorem\n  - ipsum\n\n  Lists  may  not be nested. Descriptions of a list item may be arbitrarily long\n  and include line breaks.\n\n  Here is an example of a \"listed\":\n\n    hello      world      foo        bar        baz        lorem      \n    ipsum      alpha      beta       gamma      delta      epsilon    \n\n  [2.2] Function call tree example\n\n  An example of a formatted function call tree:\n\n  main()\n  ↳ open(\"/etc/example.conf\")\n  ↳ do_stuff(fd)\n    Descriptions  may  be  present  at  each  level  of  the  call stack and are\n    automatically  indented  to  be  just below and slightly to the right of the\n    function call they describe.\n\n    ↳ some_function_with_long_name(\n                                     and_a = \"pretty long\"\n                                   , list_of = \"arguments\"\n                                   , that_it_needs_to = receive\n      )\n\n      Calls  whose  list  of arguments would exceed column limit if printed on a\n      single line are automatically broken and reformatted.\n    ↳ exit(1)\n\n  This  feature  is  quite primitive and limited, and is only able to describe a\n  single  call  tree  with  no  conditional calls. Any conditional calls must be\n  marked as such in description.\n\n\n  [2.3] Features not present\n\n  Some  features  are  omitted  from the code to keep the formatter simple. Most\n  notable  omissions  include lack of support for arbitrary levels of nesting of\n  different  constructs  (e.g.  lists),  and lack of support for custom layouts.\n\n\n  [3] License\n\n  The code is published under GNU GPL v3.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarekjm%2Fdocs-formatter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarekjm%2Fdocs-formatter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarekjm%2Fdocs-formatter/lists"}