{"id":13440862,"url":"https://github.com/plaintextaccounting/plaintextaccounting","last_synced_at":"2025-03-20T10:32:59.533Z","repository":{"id":39586226,"uuid":"51411118","full_name":"plaintextaccounting/plaintextaccounting","owner":"plaintextaccounting","description":"The plaintextaccounting.org website, a portal to Ledger, hledger, beancount and co. Also the PTA wiki.","archived":false,"fork":false,"pushed_at":"2024-05-10T00:43:26.000Z","size":1751,"stargazers_count":522,"open_issues_count":0,"forks_count":67,"subscribers_count":19,"default_branch":"master","last_synced_at":"2024-05-10T01:38:46.294Z","etag":null,"topics":["accounting","beancount","hledger","ledger","plaintext-accounting"],"latest_commit_sha":null,"homepage":"https://plaintextaccounting.org","language":"HTML","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/plaintextaccounting.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":["plaintextaccounting","simonmichael"],"custom":["https://www.paypal.com/donate/?hosted_button_id=JDD3EZEA8JV6S","https://www.paypal.com/donate/?hosted_button_id=YPRN7KXV8LAQJ"]}},"created_at":"2016-02-10T00:16:36.000Z","updated_at":"2024-05-10T01:38:47.875Z","dependencies_parsed_at":"2023-02-14T14:31:14.154Z","dependency_job_id":"4bd0998f-0e8d-47ea-9ee9-254a21037dda","html_url":"https://github.com/plaintextaccounting/plaintextaccounting","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plaintextaccounting%2Fplaintextaccounting","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plaintextaccounting%2Fplaintextaccounting/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plaintextaccounting%2Fplaintextaccounting/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plaintextaccounting%2Fplaintextaccounting/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/plaintextaccounting","download_url":"https://codeload.github.com/plaintextaccounting/plaintextaccounting/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244595585,"owners_count":20478499,"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":["accounting","beancount","hledger","ledger","plaintext-accounting"],"created_at":"2024-07-31T03:01:27.153Z","updated_at":"2025-03-20T10:32:59.527Z","avatar_url":"https://github.com/plaintextaccounting.png","language":"HTML","funding_links":["https://github.com/sponsors/plaintextaccounting","https://github.com/sponsors/simonmichael","https://www.paypal.com/donate/?hosted_button_id=JDD3EZEA8JV6S","https://www.paypal.com/donate/?hosted_button_id=YPRN7KXV8LAQJ"],"categories":["HarmonyOS","HTML","Makefile","others"],"sub_categories":["Windows Manager"],"readme":"% README\n# The plaintextaccounting.org website\n\nThis is the source for [plaintextaccounting.org](https://plaintextaccounting.org),\nan information portal and community hub for Plain Text Accounting.\nIt is maintained by Simon Michael and fellow PTA fans like you.\nAll help welcome!\n\nThe site's repo is https://github.com/plaintextaccounting/plaintextaccounting.\nThe site is markdown pages with double-bracket wiki links, rendered by [Pandoc].\nSource files are in the src/ folder, output files and assets are the out/ folder.\nThe source files are intended to be somewhat compatible with Obsidian,\nfor efficient local editing and viewing.\n\n`page.tmpl` defines the page layout, using normalize,\n[skeleton](http://getskeleton.com) and our `site.css`.\n\nThe site is rendered by Cloudflare Pages.\nChanges merged in the master branch should appear at plaintextaccounting.org within a minute or so.\n(If not, check \u003chttps://www.cloudflarestatus.com\u003e and \u003chttps://www.githubstatus.com\u003e)\n\n## Contributing\n\n- drop in to the [#plaintextaccounting chat room](https://plaintextaccounting.org/#newsdiscussion) on Matrix.org and suggest changes\n  (there is also an older `#plaintextaccounting` IRC channel on Libera.chat)\n- or log in with a Github account, then use the Edit / New Page buttons at top right\n- or `git clone https://github.com/plaintextaccounting/plaintextaccounting.wiki.git`, make changes, and send a PR or push\n- or discuss issues in the [Github issue tracker](https://github.com/plaintextaccounting/plaintextaccounting/issues).\n\n### Editing tips\n\nThe markup is Pandoc markdown\n(specifically `markdown-smart-tex_math_dollars+autolink_bare_uris+wikilinks_title_after_pipe`,\nor whatever is in Makefile),\nplus [[double-bracket wiki links]] similar to Obsidian's.\n\nTo see an accurate preview while editing, clone locally and run `make watch` \n(requires pandoc and livereloadx).\nOr, here are some ways to see an approximate preview:\n\n- Use Obsidian's editing or reading modes\n- Use VS Code's Markdown Preview Enhanced extension\n- Use Github's Preview tab (at github.com)\n\nIf you edit with Emacs markdown-mode:\n\n- S-TAB cycles heading/content visibility\n- TAB on a heading cycles visibility of that section\n- C-x n s/C-x n w on a heading narrows to/widens from that section\n\n### How to make a change through the web\n\n1. Log in to Github and click the pencil at\n   [index.md](https://github.com/plaintextaccounting/plaintextaccounting/blob/master/src/index.md).\n2. Make your changes to the markdown source.\n3. Use the Preview tab to check the result.\n4. When everything looks right, commit with a descriptive message.\n\nThis will be applied immediately if you have commit access, otherwise a fork and pull request will be created, which we will review soon.\n\n### How to make a change on your local machine\n\n1. Log in to Github, fork this repo, and clone the fork to your machine.\n    \u003c!-- git clone https://github.com/plaintextaccounting/plaintextaccounting.wiki.git --\u003e\n2. Make your changes to `index.md` (and/or `README.md`, `css/*`, `images/*`).\n3. To preview, run `make` (requires [GNU Make] and [pandoc] 2.5+) and view `index.html` in your web browser.\n4. When everything looks right, commit with a descriptive message.\n5. `git push` to your fork.\n6. Submit a pull request.\n\n[pandoc]: https://pandoc.org/installing.html\n[GNU Make]: https://www.gnu.org/software/make/\n[open an issue]: https://github.com/plaintextaccounting/plaintextaccounting/issues/new\n\u003c!-- ?title=Contributor+requesting+commit+bit\u0026body=Request+for+commit+access --\u003e\n\n### How to see a live preview on your local machine\n\nHere are two quick and dirty ways:\n\n- Use VS Code's preview pane (eg on mac: Cmd k Cmd v while editing index.md)\n- Use Obsidian's preview mode (edit index.md, `|` to split the window, switch one into preview mode)\n\nFor the most accurate rendering, use Pandoc:\n\n- Install `pandoc`, run `make`, and browse `out/index.html`.\n\nFor live-updating Pandoc rendering:\n\n- Install `watchexec` and [livereloadx], run `make watch`, browse http://localhost:8100\n\n[livereloadx]: https://nitoyon.github.io/livereloadx\n\n### How to get commit access\n\nIf you're a recurring contributor and haven't yet been granted commit access, \nplease request it in the #plaintextaccounting chat.\n\n\n\u003c!--\nThe wiki was announced in 2022-02 at\n[ledger](https://groups.google.com/g/ledger-cli/c/-ylWBNTUC9Q), \n[beancount](https://groups.google.com/g/beancount/c/_xtg1XVbbCk),\n[hledger](https://groups.google.com/g/hledger/c/bLxVpYEklk4)\n--\u003e\n\n### How to write hyperlinks\n\nIn addition to HTML `\u003ca href=\"hyper.html\"\u003eLinks\u003c/a\u003e` and `[Markdown](links.html)`,\ndouble-bracketed `[[Wiki Links]]` (or `[[Wiki#section]]` or `[[Wiki|Links]]` or `[[Wiki#section|Links]]`) are supported\n(note that `|alternate link text` comes last).\nIf you are working in Obsidian, note that it expects words in file names and wiki links to be space-separated,\nbut the currently the site requires file names to be hyphen-separated, \nand it will translate spaced wiki links to the hyphenated link targets automatically.\n\n### How to manage examples\n\nSome old notes from 2022:\n\nGoals:\n- a page for each common transaction or situation\n- showing example journal entries, variations and alternative techniques\n- ready to use with one or more of the [PTA tools](https://plaintextaccounting.org/#plain-text-accounting-apps). Showing multiple tool-specific versions is welcome but not required. Translation/porting tips are also welcome.\n- automatically tested against tools' current release (some day)\n- crowd-sourced, human-organised, kept clean\n- relatively stable urls/ids, easily referenceable from chat rooms, docs and software\n- where helpful, consolidate work from/sync with [tool](https://github.com/ledger/ledger/wiki)-[specific](https://hledger.org/cookbook.html#accounting-tasks) [sites](https://beancount.github.io/docs/command_line_accounting_cookbook.html) to reduce duplicated effort and increase traction\n\nOne goal for this site is to collect concise useful example journal entries for all common accounting situations.\nThese are organized into topic pages which get linked on [[Cookbook]].\nTry to make examples reasonably reproducible.\n\nIn literal blocks, consider writing a file type after the opening triple backticks. \nAlthough PTA file types are not yet well supported by Github, they might be in future,\nand it can also help with automation. \nSome suggested types:\n\n- `journal` - a generic journal file (likely compatible with ledger, hledger, and compatibles)\n- `ledger` - a ledger-specific journal file (optional)\n- `hledger` - a hledger-specific journal file (optional)\n- `beancount` - a beancount journal file\n- `timeclock` - a timeclock file\n- `timedot` - a timedot file\n- `csv`, `ssv`, `tsv` - comma, semicolon, or tab-separated values\n- `rules` - a hledger CSV rules file, ...\n- `abandon`, `tackler`, `nledger`, ... - files specific to other PTA apps\n\nIn example files, consider writing the filename as a comment on the first line, \nand using each filename only once within a page. \nThis gives example commands something to reference,\nand can help users trying out the variations,\nor automated tests.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplaintextaccounting%2Fplaintextaccounting","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplaintextaccounting%2Fplaintextaccounting","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplaintextaccounting%2Fplaintextaccounting/lists"}