1Emacs Muse NEWS --- History of user-visible changes -*- outline -*- 2 3* Changes in Muse 3.20 4 5** Fix bug with duplicates in completing-read of wiki page names. 6 7** Mark some tags as dangerous for text by untrusted contributors. 8 9** Implement <div> tag. 10 11** When viewing a page, publish it first. 12 13** Include non-working alpha of Ikiwiki publishing. 14 15** Make it easier to browse published PDF files. 16 17** Fix bug with C-c C-v on a file not part of any project. 18 19** Add workaround for Emacs 23 and htmlize issue. 20 21** muse-latex2png: Fix handling of filenames with spaces in them. 22 23** muse-colors: Separate highlighting rules according to major mode. 24 25** muse-latex: Make lecture notes and slides work with images, 26title page, and table of contents. 27 28** Publishing 29 30*** Fix end-of-line conversion bug when using Windows. 31 32*** Fix bug where dates in journal entries could be published incorrectly. 33 34*** Preserve the value of muse-current-project. 35 36*** Conditionally interpret local variables. 37 38*** Values set by file-local variables trump project variables. 39 40*** muse-latex: Fix publishing of tags inside of <slide> tags. 41 42*** Render <example> correctly in slides. 43 44*** Fix bug in publishing of table.el style tables. 45 46*** Fix bug where the first paragraph would not be published properly 47if it started with a link. 48 49** Build system 50 51*** Makefile.defs.default (INFODIR): Place files in .../share/info. 52 53** Manual 54 55*** Miscellaneous updates. 56 57* Changes in Muse 3.12 58 59** New interactive function `muse-update-values': Call this after 60changing muse-project-alist, in order to update various autogenerated 61values. 62 63** Tag attributes may now span multiple lines. 64 65** Don't keep track of undo data when publishing. 66This should yield a speed-up. 67 68** Build system 69 70*** Add support for the DESTDIR variable, which allows the destination 71directory to be easily set. 72 73** Muse Mode highlighting (lisp/muse-colors.el) 74 75*** Display message when muse-colors-toggle-inline-images is called. 76 77** ConTeXt publishing (lisp/muse-context.el) 78 79*** Fix publishing bug in Windows. 80 81** HTML publishing (lisp/muse-html.el) 82 83*** Fix bug where nested class tags were not working. 84 85*** Fix error that occurred when a class tag had no name element. 86In this case, we do not publish the tag at all. 87 88** LaTeX publishing (lisp/muse-latex.el) 89 90*** Escape specials in image filenames properly 91Previously, it was not possible to escape "/", "#", or "|" in image 92filenames. In order to make this work, be certain that you have the 93following LaTeX code in your header. 94 95\def\museincludegraphics{% 96 \begingroup 97 \catcode`\|=0 98 \catcode`\\=12 99 \catcode`\#=12 100 \includegraphics[width=0.75\textwidth] 101} 102 103*** Escape specials in the title string in headers 104In order to achieve this effect in custom headers, replace 105 106 \title{<lisp>(muse-publishing-directive "title")</lisp>} 107 108with 109 110 \title{<lisp>(muse-publish-escape-specials-in-string 111 (muse-publishing-directive "title") 'document)</lisp>} 112 113in your headers. 114 115*** Default to using UTF-8 rather than latin1 in headers. 116 117*** Fix publishing bug in Windows. 118 119*** Escape backslash as \textbackslash{} in monospace regions. 120 121** Publish embedded LaTeX content to a PNG file (lisp/muse-latex2png.el) 122 123*** Detect whether the tag ends at the end of a line. 124If not, do not use "$$" to publish it. 125 126** Muse Mode (lisp/muse-mode.el) 127 128*** New option: `muse-insert-url-initial-input' specifies the initial text 129to use when reading a URL. 130 131*** Fix bug with browsing anchors that come after a link to them. 132 133*** Fix bug involving filling and paragraphs next to headings. 134 135*** Fill definition lists with two initial spaces in lines after the 136definition list term. 137 138** Project support (lisp/muse-project.el) 139 140*** Fix issue that occurred when saving several files at once, where only 141one of them would make it into the project file-alist. 142 143*** If the PAGE argument to `muse-project-page-file' is nil, then return 144the first directory of the project. 145 146*** Fix bug where directory names without slashes in projects were not 147being recognized. 148 149** Publishing (lisp/muse-publish.el) 150 151*** New tag <br> represents a line break when publishing. 152This is supported in all publishing styles except for DocBook, which 153has no notion of line breaks without stylesheet hacks. 154 155*** Treat "---" as an mdash. 156Before, it would publish as an mdash followed by a single dash. 157 158*** Escape specials properly in footnotes in several styles. 159 160*** Fix bug with publishing plain URLs. 161 162*** Fix bad escaping of image links. 163 164*** Save match adta in `muse-publish-classify-url'. 165 166** Wiki-like behavior (lisp/muse-wiki.el) 167 168*** Display <nop> tags correctly. 169 170*** Publish <nop> tags correctly. 171 172* Changes in Muse 3.11 173 174** Update my example settings in examples/mwolson. 175 176** Fix several bugs with setting muse-file-extension to something else. 177If you have both muse-file-extension set to some string, and 178muse-mode-auto-p set to non-nil, please set muse-mode-auto-p to nil 179from now on. This was a workaround that some people used to deal with 180a bug that has now been fixed. 181 182** Support for serving published Muse files with Blosxom. 183See the end of the Blosxom Requirements section of the Muse manual for 184details. 185 186** The metadate plugin for PyBlosxom is now included with Muse 187in contrib/pyblosxom/metadate.py. 188 189** Compatibility fixes for Emacs21 and XEmacs 190 191*** Use copy-tree instead of copy-alist. 192 193*** Correctly require derived.el. 194 195*** Deal with the lack of a `delete-and-extract-region' function in XEmacs 196by making `muse-delete-and-extract-region'. 197 198*** Fix XEmacs and Texinfo publishing bug. 199 200*** Deal with lack of autoloads for the `man' function in some Emacs variants. 201 202*** Fix XEmacs compilation error in muse-import-xml.el. 203 204** Muse Mode highlighting (lisp/muse-colors.el) 205 206*** Fix display bug where emphasis becomes unhighlighted when moving 207around the buffer. 208 209** ConTeXt publishing (lisp/muse-context.el) 210 211*** Add support for #module directive. 212Consult the ConTeXt section of the Muse manual for details. 213 214** DocBook publishing (lisp/muse-docbook.el) 215 216*** Fix bug with paragraphs after <verse> tags. 217 218** HTML publishing (lisp/muse-html.el) 219 220*** Fix bug with links not being interpreted in titles. 221This fix also takes care of some additional escaping issues that were 222addressed in the previous release by a different means. 223 224** Journal (lisp/muse-journal.el) 225 226*** Fix bug with title anchors and CJK. 227 228*** Fix bug with summarized entries. 229 230** LaTeX publishing (lisp/muse-latex.el) 231 232*** Remove footnote references from headings. 233The reason for this is that LaTeX will throw errors during the publishing 234process if they exist. 235 236** Publishing (lisp/muse-publish.el) 237 238*** Fix serious bug in definition list publishing. 239We were skipping past the initial indented line, and that was causing 240an erroneous blockquote to be inserted. 241 242*** Revert fix for escaping bug involving headings and the <contents> tag, 243because it was buggy. This is instead handled by muse-html.el now. 244 245** Texinfo publishing (lisp/muse-texinfo.el) 246 247*** Make url, link, and link-and-anchor output look better in texi2html 248output, for people who want to run that command on texi output 249produced by Muse. 250 251** XML publishing (lisp/muse-xml.el) 252 253*** Add support for <cite> tag. 254 255*** Bump the version of etc/muse.rnc to 1.1 to reflect support for <cite>. 256 257** Muse Manual (texi/muse.texi) 258 259*** Document support for citations in new Citations section. 260 261*** Document how to use the Pyblosxom metadate plugin in the 262Blosxom Requirements section. 263 264* Changes in Muse 3.10 265 266** Relicense to GPLv3. 267 268** Muse's source code development is now being managed with git. 269Instructions for participating in Muse development using git are 270available in the "Development" section of the Muse manual. 271 272This yields not only speed improvements, but also space efficiency 273improvements. One person has found that Arch took 300MB to store one 274of Muse's branches, but git takes only 4MB. The information to store 275the entire Muse development history only takes up 8.6MB. 276 277If you are a Muse developer, please consult 278http://emacswiki.org/cgi-bin/wiki/MuseDevelopment for instructions on 279using git, and how to gain access to the shared Muse repository. 280 281** Remove unused markers when we are done with them. 282This can speed up the publishing process. 283 284** Build system 285 286*** Rename Makefile.defs to Makefile.defs.default. 287Now, there is a Makefile.defs.default file included with Muse, rather 288than Makefile.defs. If you want to make changes to this file, first 289copy it to Makefile.defs, and then make your changes there. If you do 290not need to make any changes, there is no need to copy the file. 291 292*** Indicate dependencies between Emacs Lisp files, so that Muse can be 293recompiled without running "make clean" after an update. 294 295*** Don't activate VC when publishing files. 296This avoids some annoying messages when building QuickStart in the 297examples directory. 298 299*** Make installing info files easier for XEmacs users. 300There is now a commented-out install-info definition in 301Makefile.defs.default, along with commented instructions. 302 303** Quickstart guide (examples/QuickStart.muse) 304 305*** Fix some typos. 306 307** Core functionality (lisp/muse.el) 308 309*** Work around a bad bug in color-theme.el involving its 310overwriting of the `replace-in-string' function. 311 312*** Fix a bug where Muse would lock up if muse-project-alist is nil. 313 314*** New option: muse-completing-read-function. 315Function to call when prompting user to choose between a list of options. 316This should take the same arguments as `completing-read'. 317 318One possible value for this is 'ido-completing-read. The default 319value is 'completing-read. 320 321*** Make inserting file contents and writing files to be faster. 322This involves defining the functions `muse-insert-file-contents' and 323`muse-write-file'. Consult their documentation for details. 324 325** Muse Mode highlighting (lisp/muse-colors.el) 326 327*** Comments are now colored. 328 329*** Fix bug with using <lisp> tags in #title directives. 330Now any <lisp> tags in #title directives are guaranteed to be 331evaluated after any other <lisp> tags that are nearby. 332 333** ConTeXt publishing (lisp/muse-context.el) 334 335*** New file courtesy of Jean Magnan de Bornier that publishes files in 336the ConTeXt format. See the ConTeXt section of the Muse manual for 337details on its use. 338 339** Journal (lisp/muse-journal.el) 340 341*** Fix bug causing RDF output to have invalid syntax. 342 343*** Make RSS output look nicer by adding some newlines. 344 345*** Allow <lisp> and <markup> tags to be used in entry templates. 346 347*** Fix escaping bugs in entry template text, quote-of-the-day, and title. 348 349*** Mark up the <qotd> tag as if it <quote> were used. 350 351*** New style journal-rss-entry indicates how we are to mark up 352individual RSS and RDF entries. 353 354*** Set `muse-journal-rdf-summarize-entries' to nil by default. 355 356** HTML publishing (lisp/muse-html.el) 357 358*** Add xhtml1.0 style, which is an alias for the xhtml style. 359 360*** Add xhtml1.1 style for those who want XHTML 1.1 compliant output. 361 362*** When publishing <contents>, only strip links from titles, rather 363than every tag. 364 365** Muse Mode (lisp/muse-mode.el) 366 367*** Add new minor mode called muse-list-edit-minor-mode. 368See the "Muse List Edit Minor Mode" section of the manual for details. 369 370*** Don't try to indent line before inserting a comment. 371 372** Publish embedded LaTeX content to a PNG file (lisp/muse-latex2png.el) 373 374*** Support ConTeXt. 375 376** Project settings (lisp/muse-project.el) 377 378*** Handle nested projects correctly. 379Now it is possible to have the directories of a project be the 380subdirectories of another project. Previously, it depended on the 381order that the projects were defined. 382 383*** Set project-specific variables at publish time as well as display time. 384Previously, the variable settings specified by the :set attribute in 385muse-project-alist projects were being ignored at publish time, but 386applied in Muse mode. Now they are applied at both times. 387 388*** Fix bug when publishing a file that has multiple styles. 389 390*** Fix bug when trying to publish a file in a project with multiple 391directories. 392 393*** Fix bug where links between files did not work if muse-file-extension 394is nil. 395 396*** Ignore .git metadata directories when looking for project files. 397 398** Publishing (lisp/muse-publish.el) 399 400*** Add <cite> tag. See "Tag Summary" in the manual for details on its use. 401 402*** Fix bug where Muse locks up when trying to publish a malformed table. 403 404*** Fix bug where tags other than <markup> and <lisp> were being acted on 405in headers and footers. 406 407*** Fix bug involving use of <lisp> inside of an <include> file. 408 409*** Fix bug with nested list items that have an extra blank in front. 410This was causing Muse to lock up when publishing some files. 411 412*** Fix bug with definition list publishing when there are empty terms. 413 414*** Fix bug where output from <verse> did not match output from verse 415syntax. 416 417*** Fix bug where directives were leaking out of <include> regions. 418 419*** Fix escaping bug involving headings and the <contents> tag. 420 421*** [Developers] Automatically widen before evaluating <lisp> contents. 422 423** Wiki (lisp/muse-wiki.el) 424 425*** Fix a bug with three-part links that have descriptions. 426 427*** (muse-wiki-resolve-project-page): If the project argument is nil, 428default to the current project instead of the first project entry in 429muse-project-alist. 430 431** Common functionality used by XML-based styles (lisp/muse-xml-common.el) 432 433*** Don't escape parentheses in URLs. 434 435* Changes in Muse 3.03 436 437** An emacs-wiki migration guide is available in 438etc/emacs-wiki-migration.txt. 439 440** Ideas for the future and planned time of implementation can be 441found in etc/IDEAS.muse. 442 443** Core functionality (lisp/muse.el) 444 445*** Fix an XEmacs beta byte-compiler issue. 446 447*** Fix failure to recognize the .muse file extension. 448Handle the case where the user customizes the file extension. 449 450*** It is now easier to indicate that Muse should not use a file 451extension. Just do the following. 452 453(setq muse-file-extension nil 454 muse-mode-auto-p t) 455 456If you visit a Muse file in your .emacs, however, and do not want a 457file extension, then you must still do the following beforehand. 458 459(add-hook 'find-file-hooks 'muse-mode-maybe) 460 461*** Allow tab characters in explicit links. 462 463*** Escape brackets in links, and then un-escape them when displaying 464the link in a buffer of publishing it. This allows brackets to be 465safely used in link descriptions and links, as long as you use `C-c 466TAB l', `C-c TAB u', `C-c C-e', or automatic Planner annotations. 467 468*** Ensure that no recursive load situation can take place. 469 470** Blosxom publishing (lisp/muse-blosxom.el) 471 472*** New option: muse-blosxom-use-tags. 473This specifies whether or not we are using tags. Tags allow a page to 474belong to multiple categories, but they do not rely on the directory 475structure for categorization. 476 477*** Use `find-file' as the browsing function. 478 479*** New example script: contrib/pyblosxom/make-blog. 480This shows how to invoke contrib/pyblosxom/getstamps.py. 481 482** Book publishing (lisp/muse-book.el) 483 484*** It is now possible to publish a book using a muse-project-alist entry. 485See the "Book" section of the manual for details and an example. 486 487** DocBook publishing (lisp/muse-docbook.el) 488 489*** A bug with multiple-stanza verses has been fixed. 490 491** HTML publishing (lisp/muse-html.el) 492 493*** Make sure spaces in URLs get escaped properly. 494 495*** Make the Table of Contents CSS easier to customize. 496For an example, see examples/mwolson/stylesheets/screen.css. 497 498*** Make Table of Contents publishing work with Planner. 499 500*** Fix a paragraph detection bug for paragraphs that occur after 501verses. 502 503*** New tag: <src> 504This tag is used to colorize (using HTML) source code of any language 505for which Emacs has a mode available. The "lang" attribute determines 506the mode to call on the region. Muse will look for the LANG-mode 507function, call it, and then call htmlize. You will need htmlize 1.34 508or later for this to work. 509 510If a non-HTML publishing style is used, this will be published the 511same as an <example> region. 512 513** Importing LaTeX documents (lisp/muse-import-latex.el) 514 515*** Rename from muse-convert.el, since Muse can now import 516other formats as well. 517 518** Journal (lisp/muse-journal.el) 519 520*** New option: muse-journal-rss-heading-regexp. 521Determine the regexp to use when searching for an RSS heading. 522 523*** Make sure that the date is in a format that RSS readers 524can handle. 525 526** LaTeX publishing (lisp/muse-latex.el) 527 528*** New publishing styles: slides and slides-pdf. 529This allows you to use Beamer to publish slides. 530 531*** New publishing styles: lecture-notes and lecture-notes-pdf. 532These are similar to the slides styles, but are suitable for 533publishing lecture notes. 534 535*** New option: muse-latex-pdf-program. 536The program to call in order to generate PDF content from LaTeX 537content. 538 539*** New option: muse-latex-pdf-cruft. 540The extensions of files to remove after generating PDF output 541successfully. 542 543*** Improve escaping of specials. 544 545*** Use \label{} and \ref{} for anchors and anchor references. 546 547*** Emphasize table elements. 548 549*** Improve table generation. 550 551*** Use \url{} to publish bare URLs. 552 553*** Handle case where a Muse page begins with a quote character. 554 555*** Handle case where the path to the Muse source contains a tilde 556character in one of the parent directories. It is still possible to 557run into this problem if you publish outside of a directory that has a 558tilde, but with a source file that does have one -- this was deemed to 559be a very unlikely case. 560 561*** Display footnotes when we have both a URL and description. 562This makes the URLs show up on printed documents in a sensible 563fashion. 564 565*** Escape the "@" character in the entire document. 566 567*** Make images take up 75% of the width of the page. 568 569*** New option: muse-latex-permit-contents-tag. 570This specifies whether we should take action on the <contents> tag. 571 572*** Allow for definitions to be separated from their terms, 573much like the way HTML does it by default, if the user puts a blank 574line or a line break between the term and the definition. 575 576If the term and definition are on the same line, they will be that way 577in the output as well. 578 579*** Publish comments using the "%" character, rather than a custom 580Latex command. 581 582** Publish embedded LaTeX content to a PNG file (lisp/muse-latex2png.el) 583 584*** The <latex> tag has been modified to work with styles 585other than just HTML. It will even leave the region alone if you are 586publishing a Latex-based publishing style. 587 588*** New tag: <math> 589The <math> tag acts similarly to the <latex> tag, except that it 590surrounds the region with "$" characters first, and makes the 591resulting image inline. 592 593If the first line of the <math> tag begins with 6 spaces, then 594surround the region with "$$" (or an equivalent markup) instead. This 595has the effect of "centering" the output on its own line. 596 597** Muse Manual (muse.texi) 598 599*** Re-license under the GFDL instead of the GPL. 600The rationale for this is that Muse may one day be included with 601Emacs, so it should use the same manual license that Emacs itself 602uses. At this point, the matter is not open to debate, unless the FSF 603brings it up. 604 605*** Use better style for subsections. 606 607*** Make sure the PDF file for the manual is properly generated. 608 609*** Implicit Links 610 611**** Mention how to customize the WikiName recognition. 612 613*** Extending Muse 614 615**** Move "Common Elements" and "Deriving Styles" chapters here. 616 617*** Tag Summary 618 619**** Mention new tags and updated syntax for some tags. 620 621** Muse Mode (lisp/muse-mode.el) 622 623*** `C-c TAB' now inserts an object, prompting the user for which type. 624`C-c TAB l' inserts a relative link. 625`C-c TAB t' inserts a Muse tag. 626`C-c TAB u' inserts a URL. 627 628These keybindings may be modified by editing `muse-insert-map'. Note 629that the prompt you get when you hit `C-c TAB' will not change. 630 631*** New list-oriented keybindings: 632`M-RET' inserts a list item. 633`C->' increases list item indentation. 634`C-<' decreases list item indentation. 635 636*** Slightly improved speed of flyspell integration 637 638*** Implement searching through Muse files. 639 640**** `C-c C-s' performs a search through Muse files. 641 642**** New option: muse-grep-command. 643Customize this to specify the command used for searching. In 644particular, "glimpse" is handy. Check the documentation for this 645command for details. 646 647*** Changed keybindings: 648`C-c C-b' is now `muse-find-backlinks' 649`C-c C-v' is now `muse-browse-result' 650 651*** The `C-c C-M-t' keybinding can be used in place of `C-c C-S-t', 652since the latter is not available on some terminals. 653 654*** Remove the C-c C-c keybinding, since it conflicts with other 655modes like Planner. 656 657*** Don't require muse-publish.el, since publishing and viewing Muse 658files are supposed to be completely separable. 659 660*** Speed up searching for next and previous references. 661 662*** Make filling definition lists work better. 663 664*** Make editing existing links with `C-c C-e' work better. 665 666*** Make browsing the resulting page with `C-c C-v' work better. 667 668*** Don't throw an error if doing flyspell or following link at 669beginning of buffer. 670 671*** When publishing a file with `C-c C-t', consult muse-project-alist 672and use its publishing styles to intelligently prompt the user as to 673the publishing style and output directory. 674 675The old behavior of allowing the file to be published anywhere and 676with any style has been moved to `C-c C-T'. 677 678*** Clicking `mouse-2' now does the right thing when 679mouse-yank-at-point is non-nil. 680 681** Muse Mode highlighting (lisp/muse-colors.el) 682 683*** New option: muse-colors-inline-images. 684This determines whether or not to inline an image when viewing Muse 685source. The default is to enable this behavior. This feature is 686currently considered to be in a beta state, because finding the real 687paths of images consistently has not been worked out. 688 689**** New option: muse-colors-inline-image-method. 690This determines how to find an image that we want to inline. The 691default is to look in the current directory. If set to 692'muse-colors-use-publishing-directory, it will look in the directory 693where the current page will be published. 694 695**** New function: muse-colors-toggle-inline-images. 696This toggles whether images are inlined. 697 698*** Make links blue by default, like most other Emacs modes do. 699 700*** Don't cause a long delay when highlighting remote (Tramp, 701ange-ftp) links. 702 703*** Make faces conform the namespace better. 704`muse-link-face' is renamed to `muse-link'. 705`muse-bad-link-face' is renamed to `muse-bad-link'. 706`muse-verbatim-face' is renamed to `muse-verbatim'. 707 708*** Handle muse-emphasis faces better. 709 710*** Source-level change: The regexps in `muse-colors-markup' are now 711permitted to have non-shy groupings. 712 713** New modules 714 715*** lisp/muse-backlink.el -- Provide backlink support for Muse. 716 717*** lisp/muse-groff.el -- This introduces the publishing styles 718"groff" and "groff-pdf". 719 720*** lisp/muse-import-docbook.el -- Convert Docbook XML into Muse format. 721 722*** lisp/muse-import-xml.el -- Helper file for muse-import-docbook.el. 723 724*** lisp/muse-latex2png.el -- Publish embedded LaTeX content to a PNG file. 725This introduces the <latex> tag. 726 727*** lisp/muse-xml-common.el -- Common functionality used by XML-based 728publishing styles, such as HTML, XML, and DocBook. 729 730*** experimental/muse-mathml.el -- This introduces the "mathml" 731publishing style and the <mathml> tag. 732 733*** experimental/muse-protocol-iw.el: Implements a simpler URL-like 734interwiki protocol that handles subdirectories. 735 736*** experimental/muse-split.el -- Splits published Muse files into several 737smaller files. 738 739** Project settings (lisp/muse-project.el) 740 741*** Introduce the `with-muse-project' macro, which makes it easier 742to switch to a given Muse project and execute some code. 743 744*** Fix an error with `custom-quote'. 745 746*** Ignore buffers that have no associated filename. 747This fixes an annoyance where Muse prompts to save BBDB and ERC 748buffers before publishing. 749 750*** If we cannot find a project to publish, indicate this in an 751error message. This fixes an infinite loop. 752 753*** Update the file-alist whenever a Muse file is saved. 754 755*** Prevent infinite recursion when updating the file alist. 756 757*** In addition to Arch and CVS metadata directories, also ignore 758these for Darcs, SVN, Mercurial, and Bazaar. Also, don't erroneously 759ignore files with "#" in them. 760 761*** Make links to subdirectories work. 762The idea is to include as much of the path that is needed in order to 763disambiguate the link. For example: "web/TestPage". 764 765*** New variable: muse-current-output-style. 766This holds the output style that is currently being used to publish a 767file. 768 769*** Permit non-Muse files in projects to be linked to. 770 771*** Handle relative links to other Muse pages. 772Relative links are prefixed with "./" or "../". 773 774*** New option: muse-project-publish-private-files 775If this is non-nil (the default), files will be published even if they 776have "o-r" permissions set (that is, if no one except the owner and 777possibly group are allowed to read them). To get back the old 778behavior, set this to nil. 779 780*** Publishing functions can now be customized on per-project basis 781You can now use :publish-project and :publish to specify what function 782to call for publishing entire projects or just a single file. 783:publish-project is meant to be specified in the first part of a 784project entry, along with the directories. :publish is meant to be 785used in a (optionally derived) publishing style: after specifying such 786a style, use its name in the latter part of a project entry. 787 788** Publishing (lisp/muse-publish.el) 789 790*** Implement escaping of specials throughout the entire document. 791This makes it much easier to publish documents to multiple kinds of 792formats, since you no longer have to worry about putting <verbatim> 793around specials. 794 795*** Make escaping of specials context-sensitive. 796Muse now realizes that URLs, normal document text, <example> regions, 797and the like have different special characters to escape. 798 799*** Support nested lists. 800Muse now determines the nested level of a list by its initial 801whitespace. Ordered lists, unordered lists, and definition lists can 802all be nested. It is even possible to force a line break in a list 803item by inserting a blank line on the same level between the lines. 804Blockquotes may also be nested inside of a list. 805 806*** It is now possible to force images to not be inlined. 807To accomplish this, place the text "URL:" immediately in front of the 808link text. 809 810Example: [[URL:http://example.org/image.png]] 811 812*** New interactive function: muse-publish-region. 813This command publishes the current region, prompting for the title of 814the page (if any) and the style to use. 815 816This is handy for firing off quick blog entries and pasting the result 817into a web browser -- for this use case, it is recommended to use the 818blosxom-html or blosxom-xhtml styles, as they omit the large header 819and footer. 820 821*** Additional arguments for <literal> tag. 822The optional "style" and "exact" attributes may now be specified, 823which cause text to only be included if the current publishing style 824matches some criteria -- the text will be removed otherwise. 825 826Omitting these attributes causes <literal> to behave the same as 827usual. 828 829*** Table improvements 830 831**** Support orgtbl-mode style tables. 832Here is a quick example of what they look like. For additional 833information, consult the Org Mode manual. 834 835 | Name | Phone | Age | 836 |------+-------+-----| 837 | Pete | 1234 | 25 | 838 | Sara | 4321 | 22 | 839 840If you are used to the way that Org Mode publishes these tables, then 841customize `muse-html-table-attributes' to: 842 843 border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides" 844 845in order to get a similar kind of output. 846 847**** Support table.el-style tables. 848If you have table.el somewhere in your load-path, Muse will publish 849tables that are in the format used by table.el. 850 851Currently, table.el tables can only be published for publishing styles 852based on HTML, LaTeX, or DocBook. 853 854**** Allow empty elements in tables. 855 856**** Allow initial and trailing whitespace in tables, but strip it 857out of the published result. 858 859**** If the #disable-tables publishing directive exists on the current 860Muse page, do not generate a table. 861 862*** Require at least once space after "::" in definition lists, so 863we avoid an ambiguity with interwiki link syntax. 864 865*** Handle nested emphasis types better. 866It should now publish exactly the way it looks in Muse Mode. 867 868*** Preserve whitespace around emdash. 869This allows for more flexibility, since some people seem to prefer to 870have the emdash directly against the surrounding text, while others 871like it to be spaced. 872 873*** Fix paragraph detection when block-level markup comes immediately 874after a paragraph. Examples of block-level markup are: <example>, 875verses, lists. 876 877*** Allow the <lisp> tag to take the "markup" attribute. 878see the Tag Summary section in the manual for details. 879 880*** Publish image links with descriptions as captioned images. 881This has been implemented for all Muse publishing styles. 882 883The major change is that image links with descriptions will be 884centered and the description will be displayed just below the image as 885a "caption". Thus, it is meant to only be used as its own paragraph, 886not surrounded by other text. Images without descriptions may still 887have surrounding text. 888 889*** Make comments higher priority than tags when publishing, 890so that Muse comments within tags get stripped out. 891 892*** Handle properly comments that have no text. 893 894*** Distinguish links and footnotes better. 895 896*** Do the right thing when a footnote reference exists but has no 897corresponding footnote. 898 899*** Simplify markup string for anchors. 900 901*** Allow text like "%N%" in markup strings. 902This makes it much easier to re-use the same text or put strings in 903a different order. 904 905*** Create parent directories when publishing for the first time. 906 907*** Handle case where we are trying to publish a file that has not 908been saved. 909 910*** Fix XEmacs issue where text at beginning of buffer is read-only. 911 912*** Allow publishing styles to specify a function to use for 913escaping specials in a particular context. This is especially handy 914for HTML URLs, since they have a larger subset of special characters 915than normal characters. 916 917See `muse-xml-decide-specials' in muse-xml-common.el for details. 918This functionality already exists for escaping specials in strings. 919 920*** Don't give an error when trying to define or derive an existing 921style. Just replace it. 922 923*** Get rid of a warning that occurs when batch publishing. 924 925*** Ignore list items that are part of higher-priority constructs 926like emphasis. 927 928*** Don't markup emdash in a link, since otherwise it will be 929incorrectly escaped. 930 931*** Improve the published descriptions for implicit links and explicit 932links with no provided description. 933 934*** For headers and footers, use a better algorithm to detect whether 935we have been given a filename or the real contents. 936 937*** New option: muse-publish-date-format. 938Format string of the date used when publishing files. 939 940*** New option: muse-publish-markup-header-footer-tags. 941This specifies which tags may be used when publishing headers and 942footers. 943 944*** New option: muse-publish-contents-depth. 945This specifies the maximum depth of headings to include with 946<contents> tags. 947 948*** Allow `muse-publish-markup-buffer' to work even if the buffer 949is not associated with a file. 950 951*** Fix a compilation bug with XEmacs beta. 952 953*** Source-level change: Use 'image instead of 'image-link to indicate 954images without descriptions. Use 'image-link instead of 955'url-with-image to indicate URLs that have an image as their 956description. 957 958*** Self-nested tags are now supported. 959Tags with the same name can now be nested inside one another. This 960only applies to the new <quote> tag and the <class> tag currently, but 961it may be useful for custom tags as well. 962 963To activate this, set the 4th element in a `muse-publish-markup-tag' 964to non-nil. Note that this involved a change to the structure of 965`muse-publish-markup-tag', so be sure to change any custom tags 966appropriately. 967 968*** Fix bug with WikiName link descriptions and PDF output. 969 970*** New convenience function: muse-style-derived-p 971The new muse-style-derived-p function allows you to make custom tags 972or inline <lisp> code that acts differently depending on whether the 973current style is derived from (or equal to) another style. 974 975For an example of its use, see `muse-publish-latex-tag' in 976lisp/muse-latex2png.el. 977 978*** New tags, see the Tag Summary section in the manual for details 979 980**** <comment> -- Designate entire regions as comments. 981 982**** <include> -- Insert the given file at publish time. 983 984**** <markup> -- Mark up the text between the initial and ending tags. 985 986**** <perl> -- Evaluate perl code. 987 988**** <python> -- Evaluate python code. 989 990**** <quote> -- Publish the region as a blockquote. 991 992**** <ruby> -- Evaluate ruby code. 993 994** Texinfo publishing (lisp/muse-texinfo.el) 995 996*** Escape commas in URLs. 997 998*** Make it so that links to other info or PDF documents use the proper 999suffix. 1000 1001*** Publish table headings properly. 1002 1003*** Handle case where the path to the Muse source contains a tilde 1004character in one of the parent directories. It is still possible to 1005run into this problem if you publish outside of a directory that has a 1006tilde, but with a source file that does have one -- this was deemed to 1007be a very unlikely case. 1008 1009** URL protocols (lisp/muse-protocols.el) 1010 1011*** Add support for DOI's. 1012DOI's (digitial object identifiers) are a standard identifier used in 1013the publishing industry. 1014 1015*** Add support for "dict:" URLs. 1016This is used to look up terms on the Wikipedia website. 1017 1018**** New option: muse-wikipedia-country. 1019This specified the country code to use for Wikipedia. 1020 1021*** Add support for "woman:" URLs. 1022"woman" links are opened with Emacs' internal manpage viewer. 1023 1024** Wiki (lisp/muse-wiki.el) 1025 1026*** Three-part links (example: Project::File#anchor) now work. 1027 1028*** New option: muse-wiki-wikiword-match-project-files. 1029Whether to extend WikiName functionality to also match 1030existing filenames, regardless of whether they are named in 1031WikiWord format. 1032 1033If non-nil, Muse will color and publish implicit links to any 1034file in your project. The default is nil. 1035 1036*** New option: muse-wiki-ignore-implicit-links-to-current-page. 1037Whether to ignore implicit links to the current page. 1038 1039If non-nil, Muse will not recognize implicit links to the current 1040page, both when formatting and publishing. 1041 1042*** For interwiki links, prefer files that have the same file extension 1043as the current file. 1044 1045*** Check the entire explicit link for a project name or complete 1046interwiki link, not just part of it. This allows page names with 1047invalid WikiName characters to be referred to by using an explicit 1048link. 1049 1050*** If the document does not have a valid title string, use the 1051empty string. 1052 1053*** Take the value of `muse-wiki-hide-nop-tag' into account. 1054 1055*** Match filenames in the project before the general WikiWord 1056regexp. 1057 1058*** Fix some bugs. 1059 1060** XML publishing (lisp/muse-xml.el) 1061 1062*** The Muse XML schema has been moved from examples/muse.rnc 1063to etc/muse.rnc. 1064 1065*** Update muse.rnc to handle nested list items. 1066 1067*** Fix table generation when some attributes are not given. 1068 1069* Changes in Muse 3.02.8 1070 1071** Building Muse 1072 1073*** Compile the contents of the contrib directory. 1074 1075*** The debian/ directory has been moved into its own branch. 1076It is now available at mwolson@gnu.org--2006/muse--debian--0. 1077 1078*** Further parametrize the build system, so that it can be easily 1079used by other Emacs Lisp projects. 1080 1081*** Include autoloads file (lisp/muse-autoloads.el) with releases. 1082 1083** CGI library (contrib/cgi.el) 1084 1085*** Make this not depend on cl.el at runtime. 1086 1087*** Re-add the example calendar application. 1088 1089** HTTP daemon (contrib/httpd.el) 1090 1091*** Update this to work with newer versions of Emacs. 1092 1093* Changes in Muse 3.02.7 1094 1095** Muse Mode highlighting (lisp/muse-colors.el) 1096 1097*** Fix bug that caused Muse not to work with recent builds of Emacs 22. 1098 1099* Changes in Muse 3.02.6 1100 1101** Building Muse 1102 1103*** Autoloads for Muse are now generated in the muse-autoloads.el 1104file at build time. 1105 1106** HTML publishing (lisp/muse-html.el) 1107 1108*** Don't escape "%" and "+" in URLs. 1109 1110** Muse Mode (lisp/muse-mode.el) 1111 1112*** <lisp> tags are now evaluated at display time. 1113The actual contents of the buffer will not change, just the displayed 1114text. To toggle this behavior, set `muse-colors-evaluate-lisp-tags'. 1115 1116** Publishing (lisp/muse-publish.el) 1117 1118*** When errors happen during publishing, a more explanatory message 1119is displayed. 1120 1121*** It is now possible to specify non-breaking-space with "~~" 1122(two tildes). This helps prevent proper names from being split up in 1123the output. 1124 1125*** Escape specials in all forms of emphasis. 1126 1127*** Escape "[" and "]" in links that are entered using muse-make-link. 1128 1129*** Errors from invalid lisp code in a <lisp> tag will be published 1130as a comment. If you have `muse-publish-comments-p' set to nil, the 1131effect is to remove the error message. 1132 1133*** Fix several publishing issues involving comments and numbered lists. 1134 1135** Wiki (lisp/muse-wiki.el) 1136 1137*** Interwiki links in extended links that have special characters are 1138now handled properly. 1139 1140** XML publishing (lisp/muse-xml.el) 1141 1142*** The XML publishing style is now considered stable. 1143Its schema is available in `examples/muse.rnc'. 1144 1145* Changes in Muse 3.02.5 1146 1147** LaTeX publishing (lisp/muse-latex.el) 1148 1149*** Use a better algorithm for determining how many times we need to 1150call pdflatex for publishing. Anything with a Table of Contents needs 11512 passes. 1152 1153** Muse Mode (lisp/muse-mode.el) 1154 1155*** The 3 levels of emphasis now have corresponding muse-emphasis-N faces. 1156This permits the user to customize them, which may be useful if a font 1157does not have italic and/or bold versions. 1158 1159*** Visiting pages with anchors works better. 1160 1161*** Fix fill bug with semicolons in the middle of paragraphs. 1162 1163*** Fix a bug with editing the link at point. 1164 1165*** Fix a display bug with text like =<verbatim><example></verbatim>=. 1166 1167** Project settings (lisp/muse-project.el) 1168 1169*** Fix an edge case that yielded a stringp: nil error. 1170 1171*** Prevent auto-save files from being recognized as Muse files. 1172 1173** Wiki (lisp/muse-wiki.el) 1174 1175*** By default, WikiWords can have consecutive capital letters. 1176 1177*** Fix an error that occurs when muse-colors is not loaded. 1178 1179*** It is now possible to specify a suffix for WikiWord links. 1180For example: WikiName''''s. The WikiName part will be displayed and 1181colored as a link, but the "s" will be left alone. 1182 1183* Changes in Muse 3.02.02 1184 1185** Configuration 1186 1187*** A bug with customizing `muse-project-alist' has been fixed. 1188 1189*** We use a file extension for Muse files by default. 1190To obtain the old behavior, set `muse-file-extension' to nil and 1191`muse-mode-auto-p' to t. 1192 1193To go along with the new behavior, be sure to rename all of your Muse 1194files to have a ".muse" extension. 1195 1196*** New option: `muse-wiki-ignore-bare-project-names'. 1197This causes Muse to ignore bare project names if specified. The 1198default is to turn bare project names into links. 1199 1200*** New option: `muse-publish-comments-p'. 1201This causes Muse to publish comments as markup. The default is to 1202remove comments before publishing rather than trying to mark them up. 1203 1204*** New option: `muse-wiki-allow-nonexistent-wikiword'. 1205Enabling this will cause WikiWords with no corresponding file to be 1206colored as bad links. The default is not to color them and turn them 1207into links. 1208 1209** Muse Mode (lisp/muse-mode.el) 1210 1211*** An error with intangible links has been fixed. 1212 1213*** Visiting a page with an anchor works better than before. 1214 1215*** Flyspell behaves better with Emacs21 than before. 1216 1217*** Links to nonexistent files will be colored red by default. 1218This happened previously, but the algorithm was buggy and didn't cover 1219implicit links. 1220 1221** Project handling (lisp/muse-project.el) 1222 1223*** A convenience macro called `with-muse-project' has been added. 1224This allows a code block to be executed after changing the current 1225Muse project. It is analogous to emacs-wiki's 1226`with-emacs-wiki-project' function. 1227 1228** Publishing (lisp/muse-publish.el) 1229 1230*** An issue involving anchors at the end of a line has been 1231addressed. 1232 1233*** Non-word characters are now allowed before an anchor. 1234 1235*** Comments may now be published, if desired. 1236This behavior may be controlled with the `muse-publish-comments-p' 1237option. The default is to remove comments before publishing rather 1238than trying to mark them up. 1239 1240*** Publishing directives may now include a dash character. 1241 1242** LaTeX publishing (lisp/muse-latex.el) 1243 1244*** A bug with footnotes has been addressed. 1245An attempt has been made to make generated footnote markup look more 1246"natural" to experienced LaTeX users. 1247 1248*** Table headers are underlined and table footers are overlined. 1249 1250*** PDF publishing will cause pdflatex to be called as needed. 1251The previous behavior was to always call pdflatex twice. Currently, 1252if pdflatex succeeds, it will not be called again. Otherwise, call it 1253up to three times. 1254 1255*** Escaping of special characters should be drastically improved. 1256An attempt has been made to get escaping done right in most contexts. 1257The only quirk is that you must surround dollar signs with equal signs 1258to ensure escaping. This makes publishing PDF documents much more 1259useful. 1260 1261** Texinfo publishing (lisp/muse-texinfo.el.el) 1262 1263*** An attempt was made to hone some of the markup. 1264 1265* Changes in Muse 3.02.01 1266 1267** Muse Mode (lisp/muse-mode.el) 1268 1269*** Links should no longer prevent moving the point, and help text for 1270links should no longer cause errors to occur. 1271 1272** Project handling (lisp/muse-project.el) 1273 1274*** `muse-project-alist' -- This variable should now save customizations 1275to the correct form in the .emacs file. Before, it was saving an 1276intermediate form of the variable. 1277 1278If you have used the customize interface in the previous release of 1279Muse to set `muse-project-alist', please do the following to import 1280your settings. 1281 1282 - Open your .emacs file. 1283 - Move the point to where `muse-project-alist' is set. 1284 - Type `M-: (setq muse-project-alist-using-customize t) RET'. 1285 - Type `C-M-x'. 1286 - Type `M-x customize-save-variable RET muse-project-alist RET'. 1287 1288*** `muse-project-alist' -- A bug involving the deleting of items 1289using Emacs21 and XEmacs21 has been fixed. 1290 1291** Publishing (lisp/muse-publish.el) 1292 1293*** If 2 or more blank lines separate list or table items, each item 1294will be published in a separate list or table. 1295 1296*** The #date directive is now populated by default with the last 1297modified time of each file, rather than the current time of day. To 1298use this value, add '<lisp>(muse-publishing-directive "date")<lisp>' 1299to your header or footer. 1300 1301** HTML publishing (lisp/muse-html.el) 1302 1303*** `muse-xhtml-style-sheet' -- New option that indicates the style 1304settings to use for XHTML documents. This may be either a filename or 1305a string of stylesheet settings. 1306 1307* Changes in Muse 3.02 1308 1309** New modules 1310 1311*** lisp/muse-wiki.el --- Provide automatic linking for WikiWords and 1312InterWiki links. These words are clickable and publish as links. 1313Project names from `muse-project-alist' are available for InterWiki 1314linking by default. The list of InterWiki names and handlers may be 1315customized through `muse-wiki-interwiki-alist'. 1316 1317WikiWords that do not correspond with real files will not be displayed 1318as links nor published as links. It is expected that this behavior 1319will be made optional in future versions of Muse. 1320 1321**** This module includes a few helper functions that may be added to 1322`muse-publish-desc-transforms' in order to modify link descriptions at 1323publish time. 1324 1325**** The concept of "implicit links" and "explicit links" has been 1326introduced. Explicit links are surrounded by brackets, i.e. 1327[[http://blah.org][this is a explicit link]]. Implicit links are URLs 1328and email addresses that are not surrounded by brackets: they will not 1329be colorized or published if surrounded by double-quotes. 1330 1331***** `muse-wiki-publish-pretty-title' causes words to be Title-cased, 1332ignoring words like `the' and `at' which should not be changed. 1333 1334***** `muse-wiki-publish-pretty-interwiki' changes the delimiter of 1335interwiki links according to the text of the 1336`muse-wiki-interwiki-replacement' option. 1337 1338*** lisp/muse-protocols.el --- URL protocols that Muse recognizes. 1339This automatically-included module provides an easily customizable 1340list of URL protocols, how to browse them, and how to resolve them for 1341publishing. Customize `muse-url-protocols' to add and remove 1342protocols. 1343 1344** Compatibility fixes 1345 1346*** Muse has been tested with XEmacs 21.4, both Mule and non-Mule versions. 1347There are no known problems remaining. To make things work by 1348default, the iso-8859-1 charset is used as a default option in some 1349places. 1350 1351** Configuration 1352 1353*** `muse-file-extension' -- New option that allows the file extension 1354for Muse files to be specified. For example, setting this to "muse" 1355assumes that you have renamed your Muse files with a ".muse" 1356extension. Using this (and setting `muse-mode-auto-p' to nil) will 1357prevent miscellaneous non-Muse files from being accidentally opened in 1358Muse Mode. 1359 1360*** `muse-ignored-extensions' -- New option that determines which file 1361extensions to omit from the ending of a Muse page name. 1362 1363*** `muse-ignored-extensions-regexp' -- This is no longer customizable. 1364It will be automatically generated from `muse-file-extension' and 1365`muse-ignored-extensions'. 1366 1367*** `muse-project-alist' -- The customize interface for this option has 1368been greatly improved, and much effort has been spent in order to make 1369this user-friendly. 1370 1371*** The `:force-publish' tag may be specified in `muse-project-alist'. 1372This causes a particular list of files to be re-created every time the 1373publishing process is invoked, even if they haven't been changed 1374according to their timestamps. One use for this is to keep an index 1375of available pages by adding the following to a file in this list. 1376 1377<lisp>(muse-index-as-string t t t)</lisp> 1378 1379*** `muse-project-ignore-regexp' -- By default, version control directories 1380are now included in this regexp so that they don't appear when you hit 1381C-c C-f to browse files in a project. 1382 1383*** The `muse-project-alist-styles' and `muse-project-alist-dirs' functions 1384may be used in `muse-project-alist' to recursively add styles and 1385directory listings for a given directory. The following is an 1386example. We use a backtick instead of a single quote to begin the 1387list. 1388 1389(setq muse-project-alist 1390 `(("Blog" 1391 (,@(muse-project-alist-dirs "~/proj/wiki/blog") ;; base dir 1392 :default "guestbook") 1393 1394 ,@(muse-project-alist-styles "~/proj/wiki/blog" ;; base dir 1395 ;; output dir 1396 "~/personal-site/site/blog" 1397 ;; style 1398 "my-blosxom")))) 1399 1400Note that if you use the customize interface for `muse-project-alist', 1401you will still have to manually add information for any new 1402sub-directories. 1403 1404** Debian packaging 1405 1406*** Debian packages for Muse have entered Debian unstable, thanks 1407to Romain Francoise, my sponsor. 1408 1409It is possible to roll your own Muse packages if you want to do so. 1410Packages may be built by using `make debrelease', once the proper 1411options in Makefile.defs are set. Revisions may be built using `make 1412debrevision'. 1413 1414The manual and relevant documentation files have been included with 1415the Debian package for Muse. 1416 1417** Muse Mode (lisp/muse-mode.el) 1418 1419*** Allow use of Muse with outline-minor-mode. 1420 1421*** Filling text does the right thing with list items and footnotes. 1422List items and footnotes will no longer be concatenated when hitting 1423M-q in the midst of consecutive items. 1424 1425*** Links will never be split in the middle when using Fill. 1426 1427*** Some flyspell crash issues were addressed. 1428Using intangible text can cause strange problems with flyspell mode. 1429Hence, by default, the intangible property will be ignored. A new 1430option called `muse-mode-intangible-links' indicates whether this 1431should be the case. 1432 1433*** Links will no longer be highlighted by flyspell. 1434If you're using XEmacs or Emacs 22, flyspell will ignore links, 1435including link text. This keeps flyspell from making the links 1436unclickable. If you're using Emacs 21, flyspell will continue to 1437interfere with links. If you know how to fix this, please send a 1438patch! 1439 1440*** A few edge cases for emphasis and underlining have been addressed. 1441 1442*** <example>, <verbatim>, and =surrounded text= are now colored using 1443the new face `muse-verbatim-face'. 1444 1445*** All marked up text properties, like emphasis and underlining, 1446will be removed for the text between <example>, <verbatim>, <code>, 1447<literal>, and <lisp> tags. 1448 1449*** Links to temporary files may be visited. 1450A "temporary file" in this case is a buffer that is not associated 1451with any file. For some dynamic content import scripts with Planner, 1452this is helpful. 1453 1454*** Typing "#title" should never crash Emacs anymore. 1455 1456** Muse manual (muse.texi) 1457 1458*** Fix problem with producing a PDF version of the manual. 1459 1460*** Document WikiNames. 1461 1462*** Bring up-to-date with latest features. 1463 1464*** Massively update Common Elements section. 1465 1466*** New Directives section. 1467This describes the use of #title and #author, as well as other 1468directives that may be used. 1469 1470*** New Comments section. 1471Describes the use of "; comment text". 1472 1473** Publishing (lisp/muse-publish.el) 1474 1475*** The order of rules should be much improved. 1476This means that emphasis characters like `*' and `_' will never be 1477interpreted as such if they are within links. 1478 1479*** The user will be notified when `muse-publish-this-file' fails to 1480publish the current file. This happens when the timestamp of the 1481current file indicates that it is up-to-date. 1482 1483*** Special characters are escaped in link descriptions and links on a 1484more consistent basis. What defines a "special character" varies 1485according to the publishing style. 1486 1487*** Errors that occur during publish time will cause a warning to be 1488displayed prominently, rather than being ignored. It should no longer 1489be possible to mess up a Muse source file by tweaking the Muse 1490publishing process. 1491 1492*** Errors in <lisp> tags cause a warning to be displayed and 1493return "<!--INVALID LISP CODE-->". Muse will try to continue 1494publishing the page. 1495 1496*** An emdash ("--") can now be used after a list, as long as there is 1497a blank line between the end of the list and the emdash. 1498 1499*** The <code> tag has been introduced. 1500It does the same thing that =equal signs= do: escape specials and 1501publish as teletype text. Use it for short command snippets and the 1502like. <example> is a better choice for large blocks of code, since it 1503preserves whitespace. 1504 1505*** An edge case involving links at the beginning of a paragraph 1506has been addressed. 1507 1508*** An edge case involving consecutive directives of the same size 1509has been addressed. 1510 1511*** Every publishing style is now capable of specifying strings to use 1512for sections beyond the third level. 1513 1514*** Every publishing style may specify an end-of-section string. 1515This is used, for example, by the experimental XML style and the 1516DocBook style. 1517 1518*** Every publishing style may specify a method of handling "internal 1519link" markup. An internal link is a link that refers to an anchor on 1520the current page. 1521 1522*** Every publishing style may specify a link suffix to use. 1523This allows the file extensions in links to other Muse files to be 1524different from their actual extension. Blosxom makes use of this 1525(since its published files are .txt and the dynamically-generated 1526output is .html), and it could come in handy for PHP stuff. 1527 1528If a link suffix is not specified via :link-suffix, the value of 1529:suffix will be used. 1530 1531** Blosxom publishing (lisp/muse-blosxom.el) 1532 1533*** muse-blosxom-new-entry: A #category directive is added by default. 1534Nothing is done with this yet, but it could be handy for tag-based 1535(multiple category) blogging, once we figure out a good way to do that 1536in both Muse and Pyblosxom. Ideas are welcome, and patches even more 1537so. 1538 1539** DocBook publishing (lisp/muse-docbook.el) 1540 1541*** The markup has been comprehensively improved. 1542Published documents will now pass validation tests and look better in 1543general. 1544 1545*** It is now possible to specify the encoding of DocBook documents. 1546The default encoding is utf-8. 1547 1548*** Footnotes will be embedded into paragraphs, since this is 1549The DocBook Way. 1550 1551*** Tables will be sorted by section. 1552Headers first, then footers, then the rest of the table. 1553 1554*** Anchors are now handled correctly and publish to the best available 1555form. Links to anchors are published with the <link> tag. 1556 1557** HTML publishing (lisp/muse-html.el) 1558 1559*** Fix minor issue with anchors. 1560 1561*** Paragraph publishing will no longer insert <div> tags before images. 1562This was causing too much hassle for some programs that were trying to 1563extend Muse, like the Muse port of Planner. 1564 1565*** The `&', `<', and '>' characters will be escaped using their specific 1566HTML escape codes, rather than with "&#NNN;". This makes the 1567published output display correctly in more web browsers. 1568 1569*** Use HTML 4.0 Transitional by default for `muse-html-header'. 1570 1571*** Include empty alt element in markup string for images that lack a 1572description. 1573 1574*** Tables will be sorted by section. 1575Headers first, then footers, then the rest of the table. 1576 1577*** `muse-xhtml-extension' -- The default extension for XHTML publishing. 1578This is a new option. 1579 1580** Journal publishing (lisp/muse-journal.el) 1581 1582*** Use "div class=..." rather than "div id=..." for sections. 1583 1584** LaTeX publishing (lisp/muse-latex.el) 1585 1586*** A newline will be appended to the default footer for the latex and 1587latexpdf publishing styles. This keeps the PDF-building process from 1588failing due to lack of a newline at end of file. 1589 1590*** Anchors and links to them now work properly. 1591 1592*** When generating PDF files, call pdflatex twice. 1593This should ensure that the table of contents gets generated, if one 1594is due to be published. 1595 1596*** PDF files with spaces may be published. 1597A bug preventing this has been fixed. 1598 1599*** Teletype text is now published using \\texttt{...}. 1600 1601*** An attempt has been made to escape special characters more 1602consistently. 1603 1604** Texinfo publishing (lisp/muse-texinfo.el) 1605 1606*** Fix a fatal error that occurs when publishing tables. 1607 1608*** Generate the contents in the header by default rather than the footer. 1609This is the way that most Texinfo manuals do it. 1610 1611*** The info-pdf publishing style currently produces the best PDF output 1612on the maintainer's machine, so it is now used to publish the PDF 1613version of the Muse Manual. 1614 1615*** The characters `{' and `}' will be treated as special characters that 1616need to be escaped at publish-time. 1617 1618*** Improve dots and enddots markup strings. 1619 1620*** Surround underlined text with "_" since Texinfo doesn't seem to have 1621any better options for producing underlined text. 1622 1623*** Anchors and links to them now work properly. 1624