Goal: Generate man pages and web docs from one source. Current plan: The master docs for each package are now the pandoc-style manpage-markdown files in the package directories - hledger/hledger.1.md, hledger-lib/hledger_journal.5.md, etc. Parts of these will be marked as web-only, and parts as man-only, using divs recognisable by custom pandoc filters. When generating man pages we strip the web-only parts, and all html blocks, inline html and hyperlinks. When generating web docs we strip the man-only parts and apply any other tweaks needed for easy presentation, perhaps combining them into a single web page similar to the old user manual. Shake: This was hard to do with GNU Make, and so I've introduced Shake, which is working very well. Both coexist for now but it's probably time to switch.
		
			
				
	
	
		
			43 lines
		
	
	
		
			690 B
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			43 lines
		
	
	
		
			690 B
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
| $if(has-tables)$
 | |
| .\"t
 | |
| $endif$
 | |
| 
 | |
| .TH "$title$" "$section$" "$date$" "$footer$" "hledger User Manuals"
 | |
| 
 | |
| $for(header-includes)$
 | |
| $header-includes$
 | |
| $endfor$
 | |
| 
 | |
| $for(include-before)$
 | |
| $include-before$
 | |
| $endfor$
 | |
| 
 | |
| $body$
 | |
| 
 | |
| $for(include-after)$
 | |
| $include-after$
 | |
| $endfor$
 | |
| 
 | |
| .SH "REPORTING BUGS"
 | |
| Report bugs at http://bugs.hledger.org.
 | |
| 
 | |
| .SH AUTHORS
 | |
| $if(author)$
 | |
| $for(author)$$author$$sep$; $endfor$.
 | |
| $else$
 | |
| Simon Michael <simon@joyful.com>
 | |
| $endif$
 | |
| 
 | |
| .SH COPYRIGHT
 | |
| 
 | |
| Copyright (C) 2007-2015 Simon Michael.
 | |
| .br
 | |
| Released under GNU GPLv3+.
 | |
| 
 | |
| .SH SEE ALSO
 | |
| hledger(1), hledger\-ui(1), hledger\-web(1), ledger(1)
 | |
| .br
 | |
| hledger_csv(5), hledger_journal(5), hledger_timelog(5)
 | |
| 
 | |
| For more information, see http://hledger.org.
 |