git.iko.soy/typeable/pandoc
on da645eb help sign in
history ofREADME
all commits
532dd43Changed title in README to "Pandoc User's Guide."fiddlosopher 7f5a554Added note in README about how you might want to link to an external ASCIIMathML.js script instead of including it in the generated HTML file using -m.fiddlosopher 34d875aSlightly larger table of header identifiers, so stuff doesn't wrap on LaTeX output.fiddlosopher 62227feREADME: Documented scheme for header identifiers in HTML.fiddlosopher 389c762Documented --toc/--table-of-contents option in pandoc man page and README.fiddlosopher b106e51README: Documented man page writer, special title-line conventions for man pages.fiddlosopher f8ce411README: Documented the fact that if pandoc is called as 'hsmarkdown', it runs in strict markdown compatibility mode. This can be achieved using a symbolic link.fiddlosopher 242ee99Minor wording changes in README.fiddlosopher cf08143Changed definition list syntax in markdown reader and simplified the parsing code. A colon is now required before every block in a definition. This fixes a problem with the old syntax, in which the last block in the following was ambiguous between a regular paragraph in the definition and a code block following the definition list:fiddlosopher 23df0edExtensive changes stemming from a rethinking of the Pandoc data structure. Key and Note blocks have been removed. Link and image URLs are now stored directly in Link and Image inlines, and note blocks are stored in Note inlines. This requires changes in both parsers and writers. Markdown and RST parsers need to extract data from key and note blocks and insert them into the relevant inline elements. Other parsers can be simplified, since there is no longer any need to construct separate key and note blocks. Markdown, RST, and HTML writers need to construct lists of notes; Markdown and RST writers need to construct lists of link references (when the --reference-links option is specified); and the RST writer needs to construct a list of image substitution references. All writers have been rewritten to use the State monad when state is required. This rewrite yields a small speed boost and considerably cleaner code.fiddlosopher 44cec96New syntax documentation for definition lists. Now we require a ':' at the beginning of the definition; otherwise, too many false positives for definition lists.fiddlosopher d277baeAdded documentation for definition lists.fiddlosopher d5f9b1dChange in ordered lists in Markdown reader: + Lists may begin with lowercase letters only, and only 'a' through 'n'. Otherwise first initials and page references (e.g., p. 400) are too easily parsed as lists. + Numbers beginning list items must end with '.' (not ')', which is now allowed only after letters). NOTE: This change may cause documents to be parsed differently. Users should take care in upgrading.fiddlosopher 31c030eAdded --inline-links option to force links in HTML to be parsed as inline links, rather than reference links. (Addresses Issue #4.)fiddlosopher 60989d0Added support for tables in markdown reader and in LaTeX, DocBook, and HTML writers. The syntax is documented in README. Tests have been added to the test suite.fiddlosopher d83b70f+ Changed 'escapedChar' in Markdown reader so that only the characters Markdown escapes are escaped in strict mode. When not in strict mode, Pandoc allows all non-alphanumeric characters to be escaped. + Added documentation of backslash escapes to README.fiddlosopher 9a37ee4Documentation changes corresponding to r456.fiddlosopher 5dda65bChanges to Pandoc's options to facilitate wrapper scripts: + removed -d/--debug option + added --dump-args option, which prints the name of the output file (or '-' for STDOUT) and all the command-line arguments (excluding Pandoc options and their arguments), one per line, then exits. Note that special wrapper options will be treated as arguments if they follow '--' at the end of the command line. Thus, pandoc --dump-args -o foo.html foo.txt -- -e latin1 will print the following to STDOUT: foo.html foo.txt -e latin1 + added --ignore-args option, which causes Pandoc to ignore all (non-option) arguments, including any special options that occur after '--' at the end of the command line. + '-' now means STDIN as the name of an input file, STDOUT as the name of an output file. So, pandoc -o - - will take input from STDIN and print output to STDOUT. Note that if multiple '-o' options are specified on the same line, the last one takes precedence. So, in a script, pandoc "$@" -o - will guarantee output to STDOUT, even if the '-o' option was used. + documented these changes in man pages, README, and changelog.fiddlosopher bb8478eMerged changes from 'quotes' branch since r431. Smart typography is now handled in the Markdown and LaTeX readers, rather than in the writers. The HTML writer has been rewritten to use the prettyprinting library.fiddlosopher 9e199dcSmall README changes documenting differences from standard markdown.fiddlosopher 5387ebdAdded 'hsmarkdown' wrapper, designed to be used as a drop-in replacement for Markdown.pl. It calls pandoc with the options '--from markdown --to html --strict' and disallows other options. (Any command-line options will be interpreted as arguments.)fiddlosopher a9e3250Merged changes from docbook branch since r363.fiddlosopher cf53a18Documented the "blank line before header and block quote" discrepancy between standard markdown and pandoc.fiddlosopher 4ea1b2bMerged 'strict' branch from r324. This adds a '--strict' option to pandoc, which forces it to stay as close as possible to official Markdown syntax.fiddlosopher 08fa385Changed date on README.fiddlosopher 3491420+ Changed 'web2markdown' to 'html2markdown'.fiddlosopher eea3592Reversed changes from r246: + Removed invisible anchors in front of header tags in HTML output. Reason: no way to prevent duplicate ID attributes (which is invalid HTML), since there might be duplicate header titles. See http://six.pairlist.net/pipermail/markdown-discuss/2005-January/000975.html.fiddlosopher 17837b3Added two more demo cases to website. Put a footnote in README for demonstration purposes.fiddlosopher a1a30d6+ Removed the convenience symlinks (which don't work on Windows under Cygwin, due to Windows' lack of true symbolic links). + Modified the wrappers to use 'pandoc' instead of the symlinks. + Modified the Makefile to remove all references to the symlinks. + Removed code from Main.hs that made pandoc's behavior depend on the name of the calling program. + Added code to Main.hs that sets default reader and writer based on extensions of input and output filenames (if provided). (Thanks to roktas for the idea.) + Modified README and man pages accordingly. + Removed WINDOWS-README target from Makefile. It is no longer needed now that we don't have the symlinks.fiddlosopher d829c48Merged changes from branches/wrappers since r177. Summary of main changes: + Added -o/--output and -d/--debug options to pandoc. + Modified pandoc to behave differently depending on the name of the program. For example, if the program name is 'html2latex', the default reader will be html and the default writer latex. + Removed most of the old wrappers, replacing them with symlinks to pandoc. + Rewrote markdown2pdf and created a new wrapper web2markdown, with the functionality of the old html2markdown script. These new scripts exploit pandoc's -d option to avoid having to do complex command-line parsing. + Revised man pages and documentation appropriately.fiddlosopher 42d2983Obscured email addresses in documents that will be web-accessible.fiddlosopher cda0a6dRemoved LICENSE, replacing it with COPYING (text of GPL) and COPYRIGHT (including copyright information and licenses for other packages used). Modified Pandoc.cabal.in and README accordingly.fiddlosopher 5cf769bModified the HTML writer to add invisible anchors to each section heading. The anchors are derived form the text of the section heading as described in README. This makes it easy to insert links that jump from one part of a document to another: for example, '[back to the Introduction](#Introduction)'.fiddlosopher 661c7e7Merged changes to footnotes branch r219-r240.fiddlosopher 3a6296aChanged footnote syntax to conform to the de facto standard for markdown footnotes. References are now like this[^1] rather than like this^(1). There are corresponding changes in the footnotes themselves. See the updated README for more details.fiddlosopher a8bbd95Changed '--smartypants' to '--smart' and adjusted documentation and symbols accordingly.fiddlosopher 7c319e5Modified markdown reader to allow ordered list items to begin with (single) letters, as well as numbers. The list item marker may now be terminated either by '.' or by ')'. These extensions to standard markdown are documented in README.fiddlosopher 426cbadMerge changes in branches/wrappers into trunk.roktas ae2a1c2Minor documentation changes (README).fiddlosopher 5a66fa0README changes: + Added documentation for '-- ' in shell scripts. + Added section on ucs.sty and LaTeX.fiddlosopher 69e23afMade wrapper scripts sensitive to PANDOC_OPTS environment variable, which may contain command-line options to be passed to pandoc. + Changed the scripts themselves, including $PANDOC_OPTS after 'pandoc' + Added ENVIRONMENT to man pages for wrappers + Formatting changes to man files + Added description of PANDOC_OPTS to READMEfiddlosopher 76bd231+ Improved man page for pandoc and markdown2pdf. + Changed README to recommend iconv on both input and output. + Added TODO items.fiddlosopher 362eec5* Extracted installation instructions from README into a separate file, INSTALL. Reason: Only those who install from source will need the information in INSTALL, so it does not need to be included in user documentation. Indeed, it might confuse people who install Pandoc by some other method. * Minor changes in README (using "Pandoc" as a generic name for the system, "'pandoc'" as a name for the executable).fiddlosopher 6bb5548Changed date on README.fiddlosopher 4972cd5Added a comma in README.fiddlosopher 40a8480Remove 'install-lib', it causes too much trouble which needs to be dealed in ugly ways. + Now, we have 'install-program' and 'install-all' targets. The former installs only program and user documents, while the latter installs everything: program, user documents, library files and library documents. + Behaviour of 'install' target hasn't changed, it calls 'install-program'. + Update README accordingly. + Implement missing uninstall-* targets (including 'uninstall-all' and 'uninstall-program' for the new targets). + Call 'install-program' in debian/rules explicitly to prevent confusions.roktas f0a25e4Acknowledge roktas's contributions in README.fiddlosopher efac753Minor wording change in README.fiddlosopher 3a9d4b2Minor corrections and improvements to README.fiddlosopher df7b682initial importfiddlosopher