/
NEWS
1569 lines (1034 loc) · 52 KB
/
NEWS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
Emacs Muse NEWS --- History of user-visible changes -*- outline -*-
* Changes in Muse 3.12
** New interactive function `muse-update-values': Call this after
changing muse-project-alist, in order to update various autogenerated
values.
** Tag attributes may now span multiple lines.
** Don't keep track of undo data when publishing.
This should yield a speed-up.
** Build system
*** Add support for the DESTDIR variable, which allows the destination
directory to be easily set.
** Muse Mode highlighting (lisp/muse-colors.el)
*** Display message when muse-colors-toggle-inline-images is called.
** ConTeXt publishing (lisp/muse-context.el)
*** Fix publishing bug in Windows.
** HTML publishing (lisp/muse-html.el)
*** Fix bug where nested class tags were not working.
*** Fix error that occurred when a class tag had no name element.
In this case, we do not publish the tag at all.
** LaTeX publishing (lisp/muse-latex.el)
*** Escape specials in image filenames properly
Previously, it was not possible to escape "/", "#", or "|" in image
filenames. In order to make this work, be certain that you have the
following LaTeX code in your header.
\def\museincludegraphics{%
\begingroup
\catcode`\|=0
\catcode`\\=12
\catcode`\#=12
\includegraphics[width=0.75\textwidth]
}
*** Escape specials in the title string in headers
In order to achieve this effect in custom headers, replace
\title{<lisp>(muse-publishing-directive "title")</lisp>}
with
\title{<lisp>(muse-publish-escape-specials-in-string
(muse-publishing-directive "title") 'document)</lisp>}
in your headers.
*** Default to using UTF-8 rather than latin1 in headers.
*** Fix publishing bug in Windows.
*** Escape backslash as \textbackslash{} in monospace regions.
** Publish embedded LaTeX content to a PNG file (lisp/muse-latex2png.el)
*** Detect whether the tag ends at the end of a line.
If not, do not use "$$" to publish it.
** Muse Mode (lisp/muse-mode.el)
*** New option: `muse-insert-url-initial-input' specifies the initial text
to use when reading a URL.
*** Fix bug with browsing anchors that come after a link to them.
*** Fix bug involving filling and paragraphs next to headings.
*** Fill definition lists with two initial spaces in lines after the
definition list term.
** Project support (lisp/muse-project.el)
*** Fix issue that occurred when saving several files at once, where only
one of them would make it into the project file-alist.
*** If the PAGE argument to `muse-project-page-file' is nil, then return
the first directory of the project.
*** Fix bug where directory names without slashes in projects were not
being recognized.
** Publishing (lisp/muse-publish.el)
*** New tag <br> represents a line break when publishing.
This is supported in all publishing styles except for DocBook, which
has no notion of line breaks without stylesheet hacks.
*** Treat "---" as an mdash.
Before, it would publish as an mdash followed by a single dash.
*** Escape specials properly in footnotes in several styles.
*** Fix bug with publishing plain URLs.
*** Fix bad escaping of image links.
*** Save match adta in `muse-publish-classify-url'.
** Wiki-like behavior (lisp/muse-wiki.el)
*** Display <nop> tags correctly.
*** Publish <nop> tags correctly.
* Changes in Muse 3.11
** Update my example settings in examples/mwolson.
** Fix several bugs with setting muse-file-extension to something else.
If you have both muse-file-extension set to some string, and
muse-mode-auto-p set to non-nil, please set muse-mode-auto-p to nil
from now on. This was a workaround that some people used to deal with
a bug that has now been fixed.
** Support for serving published Muse files with Blosxom.
See the end of the Blosxom Requirements section of the Muse manual for
details.
** The metadate plugin for PyBlosxom is now included with Muse
in contrib/pyblosxom/metadate.py.
** Compatibility fixes for Emacs21 and XEmacs
*** Use copy-tree instead of copy-alist.
*** Correctly require derived.el.
*** Deal with the lack of a `delete-and-extract-region' function in XEmacs
by making `muse-delete-and-extract-region'.
*** Fix XEmacs and Texinfo publishing bug.
*** Deal with lack of autoloads for the `man' function in some Emacs variants.
*** Fix XEmacs compilation error in muse-import-xml.el.
** Muse Mode highlighting (lisp/muse-colors.el)
*** Fix display bug where emphasis becomes unhighlighted when moving
around the buffer.
** ConTeXt publishing (lisp/muse-context.el)
*** Add support for #module directive.
Consult the ConTeXt section of the Muse manual for details.
** DocBook publishing (lisp/muse-docbook.el)
*** Fix bug with paragraphs after <verse> tags.
** HTML publishing (lisp/muse-html.el)
*** Fix bug with links not being interpreted in titles.
This fix also takes care of some additional escaping issues that were
addressed in the previous release by a different means.
** Journal (lisp/muse-journal.el)
*** Fix bug with title anchors and CJK.
*** Fix bug with summarized entries.
** LaTeX publishing (lisp/muse-latex.el)
*** Remove footnote references from headings.
The reason for this is that LaTeX will throw errors during the publishing
process if they exist.
** Publishing (lisp/muse-publish.el)
*** Fix serious bug in definition list publishing.
We were skipping past the initial indented line, and that was causing
an erroneous blockquote to be inserted.
*** Revert fix for escaping bug involving headings and the <contents> tag,
because it was buggy. This is instead handled by muse-html.el now.
** Texinfo publishing (lisp/muse-texinfo.el)
*** Make url, link, and link-and-anchor output look better in texi2html
output, for people who want to run that command on texi output
produced by Muse.
** XML publishing (lisp/muse-xml.el)
*** Add support for <cite> tag.
*** Bump the version of etc/muse.rnc to 1.1 to reflect support for <cite>.
** Muse Manual (texi/muse.texi)
*** Document support for citations in new Citations section.
*** Document how to use the Pyblosxom metadate plugin in the
Blosxom Requirements section.
* Changes in Muse 3.10
** Relicense to GPLv3.
** Muse's source code development is now being managed with git.
Instructions for participating in Muse development using git are
available in the "Development" section of the Muse manual.
This yields not only speed improvements, but also space efficiency
improvements. One person has found that Arch took 300MB to store one
of Muse's branches, but git takes only 4MB. The information to store
the entire Muse development history only takes up 8.6MB.
If you are a Muse developer, please consult
http://emacswiki.org/cgi-bin/wiki/MuseDevelopment for instructions on
using git, and how to gain access to the shared Muse repository.
** Remove unused markers when we are done with them.
This can speed up the publishing process.
** Build system
*** Rename Makefile.defs to Makefile.defs.default.
Now, there is a Makefile.defs.default file included with Muse, rather
than Makefile.defs. If you want to make changes to this file, first
copy it to Makefile.defs, and then make your changes there. If you do
not need to make any changes, there is no need to copy the file.
*** Indicate dependencies between Emacs Lisp files, so that Muse can be
recompiled without running "make clean" after an update.
*** Don't activate VC when publishing files.
This avoids some annoying messages when building QuickStart in the
examples directory.
*** Make installing info files easier for XEmacs users.
There is now a commented-out install-info definition in
Makefile.defs.default, along with commented instructions.
** Quickstart guide (examples/QuickStart.muse)
*** Fix some typos.
** Core functionality (lisp/muse.el)
*** Work around a bad bug in color-theme.el involving its
overwriting of the `replace-in-string' function.
*** Fix a bug where Muse would lock up if muse-project-alist is nil.
*** New option: muse-completing-read-function.
Function to call when prompting user to choose between a list of options.
This should take the same arguments as `completing-read'.
One possible value for this is 'ido-completing-read. The default
value is 'completing-read.
*** Make inserting file contents and writing files to be faster.
This involves defining the functions `muse-insert-file-contents' and
`muse-write-file'. Consult their documentation for details.
** Muse Mode highlighting (lisp/muse-colors.el)
*** Comments are now colored.
*** Fix bug with using <lisp> tags in #title directives.
Now any <lisp> tags in #title directives are guaranteed to be
evaluated after any other <lisp> tags that are nearby.
** ConTeXt publishing (lisp/muse-context.el)
*** New file courtesy of Jean Magnan de Bornier that publishes files in
the ConTeXt format. See the ConTeXt section of the Muse manual for
details on its use.
** Journal (lisp/muse-journal.el)
*** Fix bug causing RDF output to have invalid syntax.
*** Make RSS output look nicer by adding some newlines.
*** Allow <lisp> and <markup> tags to be used in entry templates.
*** Fix escaping bugs in entry template text, quote-of-the-day, and title.
*** Mark up the <qotd> tag as if it <quote> were used.
*** New style journal-rss-entry indicates how we are to mark up
individual RSS and RDF entries.
*** Set `muse-journal-rdf-summarize-entries' to nil by default.
** HTML publishing (lisp/muse-html.el)
*** Add xhtml1.0 style, which is an alias for the xhtml style.
*** Add xhtml1.1 style for those who want XHTML 1.1 compliant output.
*** When publishing <contents>, only strip links from titles, rather
than every tag.
** Muse Mode (lisp/muse-mode.el)
*** Add new minor mode called muse-list-edit-minor-mode.
See the "Muse List Edit Minor Mode" section of the manual for details.
*** Don't try to indent line before inserting a comment.
** Publish embedded LaTeX content to a PNG file (lisp/muse-latex2png.el)
*** Support ConTeXt.
** Project settings (lisp/muse-project.el)
*** Handle nested projects correctly.
Now it is possible to have the directories of a project be the
subdirectories of another project. Previously, it depended on the
order that the projects were defined.
*** Set project-specific variables at publish time as well as display time.
Previously, the variable settings specified by the :set attribute in
muse-project-alist projects were being ignored at publish time, but
applied in Muse mode. Now they are applied at both times.
*** Fix bug when publishing a file that has multiple styles.
*** Fix bug when trying to publish a file in a project with multiple
directories.
*** Fix bug where links between files did not work if muse-file-extension
is nil.
*** Ignore .git metadata directories when looking for project files.
** Publishing (lisp/muse-publish.el)
*** Add <cite> tag. See "Tag Summary" in the manual for details on its use.
*** Fix bug where Muse locks up when trying to publish a malformed table.
*** Fix bug where tags other than <markup> and <lisp> were being acted on
in headers and footers.
*** Fix bug involving use of <lisp> inside of an <include> file.
*** Fix bug with nested list items that have an extra blank in front.
This was causing Muse to lock up when publishing some files.
*** Fix bug with definition list publishing when there are empty terms.
*** Fix bug where output from <verse> did not match output from verse
syntax.
*** Fix bug where directives were leaking out of <include> regions.
*** Fix escaping bug involving headings and the <contents> tag.
*** [Developers] Automatically widen before evaluating <lisp> contents.
** Wiki (lisp/muse-wiki.el)
*** Fix a bug with three-part links that have descriptions.
*** (muse-wiki-resolve-project-page): If the project argument is nil,
default to the current project instead of the first project entry in
muse-project-alist.
** Common functionality used by XML-based styles (lisp/muse-xml-common.el)
*** Don't escape parentheses in URLs.
* Changes in Muse 3.03
** An emacs-wiki migration guide is available in
etc/emacs-wiki-migration.txt.
** Ideas for the future and planned time of implementation can be
found in etc/IDEAS.muse.
** Core functionality (lisp/muse.el)
*** Fix an XEmacs beta byte-compiler issue.
*** Fix failure to recognize the .muse file extension.
Handle the case where the user customizes the file extension.
*** It is now easier to indicate that Muse should not use a file
extension. Just do the following.
(setq muse-file-extension nil
muse-mode-auto-p t)
If you visit a Muse file in your .emacs, however, and do not want a
file extension, then you must still do the following beforehand.
(add-hook 'find-file-hooks 'muse-mode-maybe)
*** Allow tab characters in explicit links.
*** Escape brackets in links, and then un-escape them when displaying
the link in a buffer of publishing it. This allows brackets to be
safely used in link descriptions and links, as long as you use `C-c
TAB l', `C-c TAB u', `C-c C-e', or automatic Planner annotations.
*** Ensure that no recursive load situation can take place.
** Blosxom publishing (lisp/muse-blosxom.el)
*** New option: muse-blosxom-use-tags.
This specifies whether or not we are using tags. Tags allow a page to
belong to multiple categories, but they do not rely on the directory
structure for categorization.
*** Use `find-file' as the browsing function.
*** New example script: contrib/pyblosxom/make-blog.
This shows how to invoke contrib/pyblosxom/getstamps.py.
** Book publishing (lisp/muse-book.el)
*** It is now possible to publish a book using a muse-project-alist entry.
See the "Book" section of the manual for details and an example.
** DocBook publishing (lisp/muse-docbook.el)
*** A bug with multiple-stanza verses has been fixed.
** HTML publishing (lisp/muse-html.el)
*** Make sure spaces in URLs get escaped properly.
*** Make the Table of Contents CSS easier to customize.
For an example, see examples/mwolson/stylesheets/screen.css.
*** Make Table of Contents publishing work with Planner.
*** Fix a paragraph detection bug for paragraphs that occur after
verses.
*** New tag: <src>
This tag is used to colorize (using HTML) source code of any language
for which Emacs has a mode available. The "lang" attribute determines
the mode to call on the region. Muse will look for the LANG-mode
function, call it, and then call htmlize. You will need htmlize 1.34
or later for this to work.
If a non-HTML publishing style is used, this will be published the
same as an <example> region.
** Importing LaTeX documents (lisp/muse-import-latex.el)
*** Rename from muse-convert.el, since Muse can now import
other formats as well.
** Journal (lisp/muse-journal.el)
*** New option: muse-journal-rss-heading-regexp.
Determine the regexp to use when searching for an RSS heading.
*** Make sure that the date is in a format that RSS readers
can handle.
** LaTeX publishing (lisp/muse-latex.el)
*** New publishing styles: slides and slides-pdf.
This allows you to use Beamer to publish slides.
*** New publishing styles: lecture-notes and lecture-notes-pdf.
These are similar to the slides styles, but are suitable for
publishing lecture notes.
*** New option: muse-latex-pdf-program.
The program to call in order to generate PDF content from LaTeX
content.
*** New option: muse-latex-pdf-cruft.
The extensions of files to remove after generating PDF output
successfully.
*** Improve escaping of specials.
*** Use \label{} and \ref{} for anchors and anchor references.
*** Emphasize table elements.
*** Improve table generation.
*** Use \url{} to publish bare URLs.
*** Handle case where a Muse page begins with a quote character.
*** Handle case where the path to the Muse source contains a tilde
character in one of the parent directories. It is still possible to
run into this problem if you publish outside of a directory that has a
tilde, but with a source file that does have one -- this was deemed to
be a very unlikely case.
*** Display footnotes when we have both a URL and description.
This makes the URLs show up on printed documents in a sensible
fashion.
*** Escape the "@" character in the entire document.
*** Make images take up 75% of the width of the page.
*** New option: muse-latex-permit-contents-tag.
This specifies whether we should take action on the <contents> tag.
*** Allow for definitions to be separated from their terms,
much like the way HTML does it by default, if the user puts a blank
line or a line break between the term and the definition.
If the term and definition are on the same line, they will be that way
in the output as well.
*** Publish comments using the "%" character, rather than a custom
Latex command.
** Publish embedded LaTeX content to a PNG file (lisp/muse-latex2png.el)
*** The <latex> tag has been modified to work with styles
other than just HTML. It will even leave the region alone if you are
publishing a Latex-based publishing style.
*** New tag: <math>
The <math> tag acts similarly to the <latex> tag, except that it
surrounds the region with "$" characters first, and makes the
resulting image inline.
If the first line of the <math> tag begins with 6 spaces, then
surround the region with "$$" (or an equivalent markup) instead. This
has the effect of "centering" the output on its own line.
** Muse Manual (muse.texi)
*** Re-license under the GFDL instead of the GPL.
The rationale for this is that Muse may one day be included with
Emacs, so it should use the same manual license that Emacs itself
uses. At this point, the matter is not open to debate, unless the FSF
brings it up.
*** Use better style for subsections.
*** Make sure the PDF file for the manual is properly generated.
*** Implicit Links
**** Mention how to customize the WikiName recognition.
*** Extending Muse
**** Move "Common Elements" and "Deriving Styles" chapters here.
*** Tag Summary
**** Mention new tags and updated syntax for some tags.
** Muse Mode (lisp/muse-mode.el)
*** `C-c TAB' now inserts an object, prompting the user for which type.
`C-c TAB l' inserts a relative link.
`C-c TAB t' inserts a Muse tag.
`C-c TAB u' inserts a URL.
These keybindings may be modified by editing `muse-insert-map'. Note
that the prompt you get when you hit `C-c TAB' will not change.
*** New list-oriented keybindings:
`M-RET' inserts a list item.
`C->' increases list item indentation.
`C-<' decreases list item indentation.
*** Slightly improved speed of flyspell integration
*** Implement searching through Muse files.
**** `C-c C-s' performs a search through Muse files.
**** New option: muse-grep-command.
Customize this to specify the command used for searching. In
particular, "glimpse" is handy. Check the documentation for this
command for details.
*** Changed keybindings:
`C-c C-b' is now `muse-find-backlinks'
`C-c C-v' is now `muse-browse-result'
*** The `C-c C-M-t' keybinding can be used in place of `C-c C-S-t',
since the latter is not available on some terminals.
*** Remove the C-c C-c keybinding, since it conflicts with other
modes like Planner.
*** Don't require muse-publish.el, since publishing and viewing Muse
files are supposed to be completely separable.
*** Speed up searching for next and previous references.
*** Make filling definition lists work better.
*** Make editing existing links with `C-c C-e' work better.
*** Make browsing the resulting page with `C-c C-v' work better.
*** Don't throw an error if doing flyspell or following link at
beginning of buffer.
*** When publishing a file with `C-c C-t', consult muse-project-alist
and use its publishing styles to intelligently prompt the user as to
the publishing style and output directory.
The old behavior of allowing the file to be published anywhere and
with any style has been moved to `C-c C-T'.
*** Clicking `mouse-2' now does the right thing when
mouse-yank-at-point is non-nil.
** Muse Mode highlighting (lisp/muse-colors.el)
*** New option: muse-colors-inline-images.
This determines whether or not to inline an image when viewing Muse
source. The default is to enable this behavior. This feature is
currently considered to be in a beta state, because finding the real
paths of images consistently has not been worked out.
**** New option: muse-colors-inline-image-method.
This determines how to find an image that we want to inline. The
default is to look in the current directory. If set to
'muse-colors-use-publishing-directory, it will look in the directory
where the current page will be published.
**** New function: muse-colors-toggle-inline-images.
This toggles whether images are inlined.
*** Make links blue by default, like most other Emacs modes do.
*** Don't cause a long delay when highlighting remote (Tramp,
ange-ftp) links.
*** Make faces conform the namespace better.
`muse-link-face' is renamed to `muse-link'.
`muse-bad-link-face' is renamed to `muse-bad-link'.
`muse-verbatim-face' is renamed to `muse-verbatim'.
*** Handle muse-emphasis faces better.
*** Source-level change: The regexps in `muse-colors-markup' are now
permitted to have non-shy groupings.
** New modules
*** lisp/muse-backlink.el -- Provide backlink support for Muse.
*** lisp/muse-groff.el -- This introduces the publishing styles
"groff" and "groff-pdf".
*** lisp/muse-import-docbook.el -- Convert Docbook XML into Muse format.
*** lisp/muse-import-xml.el -- Helper file for muse-import-docbook.el.
*** lisp/muse-latex2png.el -- Publish embedded LaTeX content to a PNG file.
This introduces the <latex> tag.
*** lisp/muse-xml-common.el -- Common functionality used by XML-based
publishing styles, such as HTML, XML, and DocBook.
*** experimental/muse-mathml.el -- This introduces the "mathml"
publishing style and the <mathml> tag.
*** experimental/muse-protocol-iw.el: Implements a simpler URL-like
interwiki protocol that handles subdirectories.
*** experimental/muse-split.el -- Splits published Muse files into several
smaller files.
** Project settings (lisp/muse-project.el)
*** Introduce the `with-muse-project' macro, which makes it easier
to switch to a given Muse project and execute some code.
*** Fix an error with `custom-quote'.
*** Ignore buffers that have no associated filename.
This fixes an annoyance where Muse prompts to save BBDB and ERC
buffers before publishing.
*** If we cannot find a project to publish, indicate this in an
error message. This fixes an infinite loop.
*** Update the file-alist whenever a Muse file is saved.
*** Prevent infinite recursion when updating the file alist.
*** In addition to Arch and CVS metadata directories, also ignore
these for Darcs, SVN, Mercurial, and Bazaar. Also, don't erroneously
ignore files with "#" in them.
*** Make links to subdirectories work.
The idea is to include as much of the path that is needed in order to
disambiguate the link. For example: "web/TestPage".
*** New variable: muse-current-output-style.
This holds the output style that is currently being used to publish a
file.
*** Permit non-Muse files in projects to be linked to.
*** Handle relative links to other Muse pages.
Relative links are prefixed with "./" or "../".
*** New option: muse-project-publish-private-files
If this is non-nil (the default), files will be published even if they
have "o-r" permissions set (that is, if no one except the owner and
possibly group are allowed to read them). To get back the old
behavior, set this to nil.
*** Publishing functions can now be customized on per-project basis
You can now use :publish-project and :publish to specify what function
to call for publishing entire projects or just a single file.
:publish-project is meant to be specified in the first part of a
project entry, along with the directories. :publish is meant to be
used in a (optionally derived) publishing style: after specifying such
a style, use its name in the latter part of a project entry.
** Publishing (lisp/muse-publish.el)
*** Implement escaping of specials throughout the entire document.
This makes it much easier to publish documents to multiple kinds of
formats, since you no longer have to worry about putting <verbatim>
around specials.
*** Make escaping of specials context-sensitive.
Muse now realizes that URLs, normal document text, <example> regions,
and the like have different special characters to escape.
*** Support nested lists.
Muse now determines the nested level of a list by its initial
whitespace. Ordered lists, unordered lists, and definition lists can
all be nested. It is even possible to force a line break in a list
item by inserting a blank line on the same level between the lines.
Blockquotes may also be nested inside of a list.
*** It is now possible to force images to not be inlined.
To accomplish this, place the text "URL:" immediately in front of the
link text.
Example: [[URL:http://example.org/image.png]]
*** New interactive function: muse-publish-region.
This command publishes the current region, prompting for the title of
the page (if any) and the style to use.
This is handy for firing off quick blog entries and pasting the result
into a web browser -- for this use case, it is recommended to use the
blosxom-html or blosxom-xhtml styles, as they omit the large header
and footer.
*** Additional arguments for <literal> tag.
The optional "style" and "exact" attributes may now be specified,
which cause text to only be included if the current publishing style
matches some criteria -- the text will be removed otherwise.
Omitting these attributes causes <literal> to behave the same as
usual.
*** Table improvements
**** Support orgtbl-mode style tables.
Here is a quick example of what they look like. For additional
information, consult the Org Mode manual.
| Name | Phone | Age |
|------+-------+-----|
| Pete | 1234 | 25 |
| Sara | 4321 | 22 |
If you are used to the way that Org Mode publishes these tables, then
customize `muse-html-table-attributes' to:
border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides"
in order to get a similar kind of output.
**** Support table.el-style tables.
If you have table.el somewhere in your load-path, Muse will publish
tables that are in the format used by table.el.
Currently, table.el tables can only be published for publishing styles
based on HTML, LaTeX, or DocBook.
**** Allow empty elements in tables.
**** Allow initial and trailing whitespace in tables, but strip it
out of the published result.
**** If the #disable-tables publishing directive exists on the current
Muse page, do not generate a table.
*** Require at least once space after "::" in definition lists, so
we avoid an ambiguity with interwiki link syntax.
*** Handle nested emphasis types better.
It should now publish exactly the way it looks in Muse Mode.
*** Preserve whitespace around emdash.
This allows for more flexibility, since some people seem to prefer to
have the emdash directly against the surrounding text, while others
like it to be spaced.
*** Fix paragraph detection when block-level markup comes immediately
after a paragraph. Examples of block-level markup are: <example>,
verses, lists.
*** Allow the <lisp> tag to take the "markup" attribute.
see the Tag Summary section in the manual for details.
*** Publish image links with descriptions as captioned images.
This has been implemented for all Muse publishing styles.
The major change is that image links with descriptions will be
centered and the description will be displayed just below the image as
a "caption". Thus, it is meant to only be used as its own paragraph,
not surrounded by other text. Images without descriptions may still
have surrounding text.
*** Make comments higher priority than tags when publishing,
so that Muse comments within tags get stripped out.
*** Handle properly comments that have no text.
*** Distinguish links and footnotes better.
*** Do the right thing when a footnote reference exists but has no
corresponding footnote.
*** Simplify markup string for anchors.
*** Allow text like "%N%" in markup strings.
This makes it much easier to re-use the same text or put strings in
a different order.
*** Create parent directories when publishing for the first time.
*** Handle case where we are trying to publish a file that has not
been saved.
*** Fix XEmacs issue where text at beginning of buffer is read-only.
*** Allow publishing styles to specify a function to use for
escaping specials in a particular context. This is especially handy
for HTML URLs, since they have a larger subset of special characters
than normal characters.
See `muse-xml-decide-specials' in muse-xml-common.el for details.
This functionality already exists for escaping specials in strings.
*** Don't give an error when trying to define or derive an existing
style. Just replace it.
*** Get rid of a warning that occurs when batch publishing.
*** Ignore list items that are part of higher-priority constructs
like emphasis.
*** Don't markup emdash in a link, since otherwise it will be
incorrectly escaped.
*** Improve the published descriptions for implicit links and explicit
links with no provided description.
*** For headers and footers, use a better algorithm to detect whether
we have been given a filename or the real contents.
*** New option: muse-publish-date-format.
Format string of the date used when publishing files.
*** New option: muse-publish-markup-header-footer-tags.
This specifies which tags may be used when publishing headers and
footers.
*** New option: muse-publish-contents-depth.
This specifies the maximum depth of headings to include with
<contents> tags.
*** Allow `muse-publish-markup-buffer' to work even if the buffer
is not associated with a file.
*** Fix a compilation bug with XEmacs beta.
*** Source-level change: Use 'image instead of 'image-link to indicate
images without descriptions. Use 'image-link instead of
'url-with-image to indicate URLs that have an image as their
description.
*** Self-nested tags are now supported.
Tags with the same name can now be nested inside one another. This
only applies to the new <quote> tag and the <class> tag currently, but
it may be useful for custom tags as well.
To activate this, set the 4th element in a `muse-publish-markup-tag'
to non-nil. Note that this involved a change to the structure of
`muse-publish-markup-tag', so be sure to change any custom tags
appropriately.
*** Fix bug with WikiName link descriptions and PDF output.
*** New convenience function: muse-style-derived-p
The new muse-style-derived-p function allows you to make custom tags
or inline <lisp> code that acts differently depending on whether the
current style is derived from (or equal to) another style.
For an example of its use, see `muse-publish-latex-tag' in
lisp/muse-latex2png.el.
*** New tags, see the Tag Summary section in the manual for details
**** <comment> -- Designate entire regions as comments.
**** <include> -- Insert the given file at publish time.
**** <markup> -- Mark up the text between the initial and ending tags.
**** <perl> -- Evaluate perl code.
**** <python> -- Evaluate python code.
**** <quote> -- Publish the region as a blockquote.
**** <ruby> -- Evaluate ruby code.
** Texinfo publishing (lisp/muse-texinfo.el)
*** Escape commas in URLs.
*** Make it so that links to other info or PDF documents use the proper
suffix.
*** Publish table headings properly.
*** Handle case where the path to the Muse source contains a tilde
character in one of the parent directories. It is still possible to
run into this problem if you publish outside of a directory that has a
tilde, but with a source file that does have one -- this was deemed to
be a very unlikely case.
** URL protocols (lisp/muse-protocols.el)
*** Add support for DOI's.
DOI's (digitial object identifiers) are a standard identifier used in
the publishing industry.
*** Add support for "dict:" URLs.
This is used to look up terms on the Wikipedia website.
**** New option: muse-wikipedia-country.
This specified the country code to use for Wikipedia.
*** Add support for "woman:" URLs.
"woman" links are opened with Emacs' internal manpage viewer.
** Wiki (lisp/muse-wiki.el)
*** Three-part links (example: Project::File#anchor) now work.
*** New option: muse-wiki-wikiword-match-project-files.
Whether to extend WikiName functionality to also match
existing filenames, regardless of whether they are named in
WikiWord format.
If non-nil, Muse will color and publish implicit links to any
file in your project. The default is nil.
*** New option: muse-wiki-ignore-implicit-links-to-current-page.
Whether to ignore implicit links to the current page.
If non-nil, Muse will not recognize implicit links to the current
page, both when formatting and publishing.
*** For interwiki links, prefer files that have the same file extension
as the current file.
*** Check the entire explicit link for a project name or complete
interwiki link, not just part of it. This allows page names with
invalid WikiName characters to be referred to by using an explicit
link.
*** If the document does not have a valid title string, use the
empty string.
*** Take the value of `muse-wiki-hide-nop-tag' into account.