style/help cleanups
This commit is contained in:
28
README.md
28
README.md
@@ -1,8 +1,9 @@
|
|||||||
# The plaintextaccounting.org website
|
# The plaintextaccounting.org website
|
||||||
|
|
||||||
This is the source for [plaintextaccounting.org](https://plaintextaccounting.org),
|
This is the source for [plaintextaccounting.org](https://plaintextaccounting.org),
|
||||||
an information portal and community hub for Plain Text Accounting and
|
an information portal and community hub for Plain Text Accounting.
|
||||||
related tools: Ledger, hledger, beancount, etc.
|
It is maintained by Simon Michael and fellow PTA fans like you.
|
||||||
|
All help welcome!
|
||||||
|
|
||||||
The site's repo is https://github.com/plaintextaccounting/plaintextaccounting.
|
The site's repo is https://github.com/plaintextaccounting/plaintextaccounting.
|
||||||
The site is markdown pages with double-bracket wiki links, rendered by [Pandoc].
|
The site is markdown pages with double-bracket wiki links, rendered by [Pandoc].
|
||||||
@@ -19,14 +20,33 @@ Changes merged in the master branch should appear at plaintextaccounting.org wit
|
|||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
Maintenance is led by Simon Michael; all help is welcome! You can:
|
|
||||||
|
|
||||||
- drop in to the [#plaintextaccounting chat room](https://plaintextaccounting.org/#newsdiscussion) on Matrix.org and suggest changes
|
- drop in to the [#plaintextaccounting chat room](https://plaintextaccounting.org/#newsdiscussion) on Matrix.org and suggest changes
|
||||||
(there is also an older `#plaintextaccounting` IRC channel on Libera.chat)
|
(there is also an older `#plaintextaccounting` IRC channel on Libera.chat)
|
||||||
- or log in with a Github account, then use the Edit / New Page buttons at top right
|
- or log in with a Github account, then use the Edit / New Page buttons at top right
|
||||||
- or `git clone https://github.com/plaintextaccounting/plaintextaccounting.wiki.git`, make changes, and send a PR or push
|
- or `git clone https://github.com/plaintextaccounting/plaintextaccounting.wiki.git`, make changes, and send a PR or push
|
||||||
- or discuss issues in the [Github issue tracker](https://github.com/plaintextaccounting/plaintextaccounting/issues).
|
- or discuss issues in the [Github issue tracker](https://github.com/plaintextaccounting/plaintextaccounting/issues).
|
||||||
|
|
||||||
|
### Editing tips
|
||||||
|
|
||||||
|
The markup is Pandoc markdown
|
||||||
|
(specifically `markdown-smart-tex_math_dollars+autolink_bare_uris+wikilinks_title_after_pipe`,
|
||||||
|
or whatever is in Makefile),
|
||||||
|
plus [[double-bracket wiki links]] similar to Obsidian's.
|
||||||
|
|
||||||
|
To see an accurate preview while editing, clone locally and run `make watch`
|
||||||
|
(requires pandoc and livereloadx).
|
||||||
|
Or, here are some ways to see an approximate preview:
|
||||||
|
|
||||||
|
- Use Obsidian's editing or reading modes
|
||||||
|
- Use VS Code's Markdown Preview Enhanced extension
|
||||||
|
- Use Github's Preview tab (at github.com)
|
||||||
|
|
||||||
|
If you edit with Emacs markdown-mode:
|
||||||
|
|
||||||
|
- S-TAB cycles heading/content visibility
|
||||||
|
- TAB on a heading cycles visibility of that section
|
||||||
|
- C-x n s/C-x n w on a heading narrows to/widens from that section
|
||||||
|
|
||||||
### How to make a change through the web
|
### How to make a change through the web
|
||||||
|
|
||||||
1. Log in to Github and click the pencil at
|
1. Log in to Github and click the pencil at
|
||||||
|
|||||||
@@ -4,24 +4,12 @@ body {
|
|||||||
font-size:large;
|
font-size:large;
|
||||||
}
|
}
|
||||||
|
|
||||||
h1, h2, h3 {
|
h1, h2, h3, h4, h5, h6 {
|
||||||
font-weight:bold;
|
font-weight:bold;
|
||||||
white-space:nowrap;
|
white-space:nowrap;
|
||||||
|
text-shadow: 1px 1px 2px white;
|
||||||
}
|
}
|
||||||
|
|
||||||
/*
|
|
||||||
p > strong > a, p > strong > a:hover {
|
|
||||||
text-decoration:none;
|
|
||||||
color:black;
|
|
||||||
}
|
|
||||||
*/
|
|
||||||
|
|
||||||
.tight p {
|
.tight p {
|
||||||
margin:0;
|
margin:0;
|
||||||
}
|
}
|
||||||
|
|
||||||
/*
|
|
||||||
li {
|
|
||||||
margin-bottom:0;
|
|
||||||
}
|
|
||||||
*/
|
|
||||||
|
|||||||
70
src/index.md
70
src/index.md
@@ -1,70 +1,12 @@
|
|||||||
% Plain Text Accounting (PTA)
|
% Plain Text Accounting (PTA)
|
||||||
|
|
||||||
<!--
|
<!-- For editing tips, see ../README.md -->
|
||||||
Editing tips:
|
|
||||||
|
|
||||||
This is pandoc markdown with [[double-bracket wiki links]] added.
|
<div style="float:right; width:30%; margin:0 1em; position:relative; top:-4em; z-index:-1;">
|
||||||
See Makefile and README for more details.
|
|
||||||
|
|
||||||
If editing via github web UI:
|
|
||||||
- you can see an approximate preview with the Preview tab
|
|
||||||
|
|
||||||
If editing in a local clone:
|
|
||||||
- you can use make watch to see an accurate preview
|
|
||||||
|
|
||||||
If editing with emacs markdown-mode:
|
|
||||||
- S-TAB cycles heading/content visibility
|
|
||||||
- TAB on a heading cycles visibility of that section
|
|
||||||
- C-x n s/C-x n w on a heading narrows to/widens from that section
|
|
||||||
|
|
||||||
-->
|
|
||||||
|
|
||||||
<style>
|
|
||||||
body {
|
|
||||||
}
|
|
||||||
.columns {
|
|
||||||
margin-left:0 !important;
|
|
||||||
margin-right:4%;
|
|
||||||
}
|
|
||||||
h1 {
|
|
||||||
text-align:center;
|
|
||||||
margin-top:10%;
|
|
||||||
margin-bottom:5%;
|
|
||||||
text-shadow: 2px 2px 2px white;
|
|
||||||
}
|
|
||||||
h2 {
|
|
||||||
}
|
|
||||||
h3 {
|
|
||||||
font-weight:normal;
|
|
||||||
}
|
|
||||||
h4 {
|
|
||||||
}
|
|
||||||
h5 {
|
|
||||||
font-size:1.2em;
|
|
||||||
}
|
|
||||||
li {
|
|
||||||
margin:revert;
|
|
||||||
}
|
|
||||||
.faq h5 { /* questions */
|
|
||||||
font-weight:bold;
|
|
||||||
margin-bottom:0;
|
|
||||||
}
|
|
||||||
#intro {
|
|
||||||
font-size:larger;
|
|
||||||
}
|
|
||||||
#sitemapheading {
|
|
||||||
font-size:2rem;
|
|
||||||
font-weight:bold;
|
|
||||||
}
|
|
||||||
|
|
||||||
th, td { border:none; padding-top:0; padding-bottom:0; border-bottom:thin solid #ddd; white-space:nowrap; }
|
|
||||||
</style>
|
|
||||||
|
|
||||||
<div style="float:right; width:30%; margin:0 0 4em 3em;">
|
|
||||||
<img src="images/pta-avatar.jpg" width=250 style="border-radius:50%;">
|
<img src="images/pta-avatar.jpg" width=250 style="border-radius:50%;">
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="intro">
|
<div id="intro" style="font-size:larger;">
|
||||||
|
|
||||||
***Plain text accounting*** is a way of doing bookkeeping and accounting
|
***Plain text accounting*** is a way of doing bookkeeping and accounting
|
||||||
with plain text files and scriptable, command-line-friendly software, such as
|
with plain text files and scriptable, command-line-friendly software, such as
|
||||||
@@ -383,9 +325,9 @@ Elsewhere:\
|
|||||||
|
|
||||||
### Cheatsheets
|
### Cheatsheets
|
||||||
|
|
||||||
|
- [Syntax Quick Reference](quickref/)
|
||||||
- [Ledger CLI cheatsheet](https://devhints.io/ledger)
|
- [Ledger CLI cheatsheet](https://devhints.io/ledger)
|
||||||
- [Beancount Syntax Cheat Sheet](https://beancount.github.io/docs/beancount_cheat_sheet.html)
|
- [Beancount Syntax Cheat Sheet](https://beancount.github.io/docs/beancount_cheat_sheet.html)
|
||||||
- [Syntax Quick Reference for the Ledger-Likes](quickref/)
|
|
||||||
|
|
||||||
### Introductory docs
|
### Introductory docs
|
||||||
|
|
||||||
@@ -425,6 +367,10 @@ Generally it's relatively easy to migrate data from one to another.
|
|||||||
<!-- Active projects are sorted by committers+other community size/activity signals; inactives are sorted by start date. -->
|
<!-- Active projects are sorted by committers+other community size/activity signals; inactives are sorted by start date. -->
|
||||||
<!-- Committers count can be eg the "Contributors" count on github. -->
|
<!-- Committers count can be eg the "Contributors" count on github. -->
|
||||||
|
|
||||||
|
<style>
|
||||||
|
th, td { border:none; padding-top:0; padding-bottom:0; border-bottom:thin solid #ddd; white-space:nowrap; }
|
||||||
|
</style>
|
||||||
|
|
||||||
| Project | Start | Last release | Code | Committers | Stars | Mail list, size | Chat, size |
|
| Project | Start | Last release | Code | Committers | Stars | Mail list, size | Chat, size |
|
||||||
|----------------------|--------|:------------:|------------------------------------|-----------:|------:|----------------------------------|------------------------------------------------------------------------------------------------------|
|
|----------------------|--------|:------------:|------------------------------------|-----------:|------:|----------------------------------|------------------------------------------------------------------------------------------------------|
|
||||||
| | | | | | | | |
|
| | | | | | | | |
|
||||||
|
|||||||
Reference in New Issue
Block a user