Commit Graph

1869 Commits

Author SHA1 Message Date
Danny Yoo
b1048aa2fa Amend comment.
original commit: db0234fb6f59ea8c8741ea68f630548d8e1e6cc1
2013-02-12 20:18:54 -07:00
Danny Yoo
f8b07bcc26 Replace <wbr> and <span class='mywbr'> </span> with zero-width-space.
The zero width space is a more robust way to add place to line-wrap,
according to: http://www.quirksmode.org/oddsandends/wbr.html

Closes PR 13305.

original commit: 29031f0972ead0d3cd26d61f163b5e5b59e9ffce
2013-02-12 19:50:13 -07:00
Robby Findler
161d49ca39 make #:keywords have different color prefs in DrRacket
closes PR 13492

original commit: 12ebfa2cf4f3bc187fb6d3c1eea80d56a29e64ed
2013-02-05 12:32:48 -06:00
Matthew Flatt
e8da6bd325 Scribble: fix docs on Latex commands for parts and part references
original commit: 318c45a772b18d97dbf17c2c5d5940ee81511c46
2013-02-01 11:00:14 -08:00
Matthew Flatt
8f81da3aa9 Scribble: add scribble/book' and scribble/report' languages
These languages set the default class for Latex rendering, and also
adjust Latex commands so that top-level sections are chapters, etc.

original commit: 09d4aa3d79066e73e93727fd18a5805873e63acf
2013-02-01 10:15:53 -08:00
Matthew Flatt
1c5b304b1b Scribble: add 'grouper and 'hidden-number part style properties
Also, clean up documentation and implementation of 'unnumbered and
'hidden.

original commit: c0c2eda628c5786c18d29a3071087e268bd76109
2013-02-01 10:15:53 -08:00
Danny Yoo
262f816a65 Fix typo.
original commit: 74a0252b245a30c27522e91f6fe18637321c34e9
2013-01-31 14:27:22 -07:00
Michael Filonenko
505e981046 extflonums
An extflonum is like a flonum, but with 80-bit precision and
not a number in the sense of `number?': only operations such as
`extfl+' work on extflonums, and only on platforms where extflonums
can be implemented by hardware without interefering with flonums
(i.e., on platforms where SSE instructions are used for
double-precision floats).

[Patch provided by Michael Filonenko and revised by Matthew.]

The compiler tracks information about bindings that are known to
hold extflonums, but the JIT does not yet exploit this information
to unbox them (except as intermediate results).

original commit: 17b8092641b245caf77bfb6ac29b525995a7bfea
2013-01-28 18:17:06 -07:00
Matthew Flatt
f5fb6bf60e scriblib/figure: overhaul
Clean up the use of styles for alignment and the generated instances
of style names. In the process, remove some padding for HTML output,
and make the rendering more configurable (especially for Latex, based
on suggestions by Keven Tew).

The way that nested flows are generated can be different than before,
so these changes risk breaking some existing uses of `scriblib/figure'.
The changes especially likely break uses of `scriblib/figure' with
output configured through overiding .css/.tex definitions. But
the old pile of styles/macros was inconsistent and broken in various
ways, so hopefully the changes are an improvement overall.

original commit: 8862a44f149e9a8fb975f63147730cb19a4a7931
2013-01-24 06:43:11 -05:00
Matthew Flatt
d96626896d scribble/latex-properties: add `command-extras'
This style property is a way to add to the Latex output that is
ignored for HTML and other output.

original commit: 17865bfa841e7c6fd235717bde6b03f16c77e124
2013-01-24 06:43:10 -05:00
Matthew Flatt
24b3905faa scribble doc corrections
Merge to v5.3.2

original commit: 5134bc0888c26c70bda83c607d73e530314cbbd8
2013-01-09 18:52:16 -07:00
Matthew Flatt
cce0a1c62c scribble/decode: fix contract on `decode-compound-paragraph'
Add a test suite that at least tries each export of `scribble/decode'.

Merge to v5.3.2

original commit: 5ab048bb5cd05fa109b990bb73bc7033b09230ee
2013-01-09 18:52:16 -07:00
Greg Hendershott
c7f0f37159 Use Racket lexer for code blocks.
Had been specifying Scheme lexer for code blocks, while waiting for
new Racket lexer to wend its way from Pygments to Pygments.rb to
Linguist to GitHub.

That day is almost here: Linguist will soon update and deploy to
GitHub.  And Racket 5.3.2 is about to release.  As a result, I think
this is the correct time to switch to the Racket lexer: It should be
live on GitHub by the time people are using Racket 5.3.2.

/cc @rmculpepper -- I think this commit should go into the 5.3.2
release.

original commit: 4d3a5bad04d0958c71c70aaed0ab2c2055c5f272
2013-01-09 18:52:16 -07:00
Matthew Flatt
d0f9ed697b scribble: add +m' / ++main-xref-in' flag
The `+m' flag is a long-overdue shorthand for `++xref-in setup/xref
load-collections-xref', which links to installed documentation in
the same way as DrRacket's "Scribble HTML" button.

That is, use `+m' to link to installed documentation,

  scribble +m mine.scrbl

instead of the previously recommended

  scribble ++xref-in setup/xref load-collections-xref mine.scrbl

Merge to 5.3.2

original commit: 3e8b6b98663386ea01a93f917ed328e8052c38d8
2013-01-08 16:25:28 -07:00
Robby Findler
488232313a adjust scribble/lp language so drracket syntax colors it properly
Also fix a spelling mistake (now that spell checking works) and Rackety

original commit: 87d25ba02ae8d400c8bc07ba4f9b8470a9f9092b
2013-01-04 21:39:11 -06:00
Robby Findler
46e70e3c2a tweak the latex rendering of ╔ and company
original commit: 9b6272674ea3161ff72a66f00cc795f613185f93
2012-12-30 21:11:38 -06:00
Robby Findler
763ddfcf74 add support for ╔ ═ ╗ ║ ╚ and ╝ to the latex renderer
Also, Rackety

original commit: 022e252f4501af89dc820f778ec426c67cc083d8
2012-12-29 11:31:17 -06:00
Matthias Felleisen
900a0d10ec space management for figures
original commit: 6243a928fbabb50700231975e82c42f51b6fa27e
2012-12-27 19:01:34 -05:00
Matthew Flatt
d8b44df63f scibble: repair related to recent `scribble/tag' contracts
original commit: 3f6b30a569ad4fbb63d4dadaabc992326c710017
2012-12-27 12:49:30 -06:00
Robby Findler
e36ebc9823 added make-module-language-tag and use it and make-section-tag
in a few places

original commit: 353da62843a2b976e300fdd37abdd9b6d6c4894a
2012-12-27 11:10:40 -06:00
Matthew Flatt
dce9a0e92a move and fixup docs for the "help" collection
original commit: 2d12431c0da134e04ff62c5f4baa3ab86660f124
2012-12-27 09:24:15 -06:00
Matthew Flatt
95e432a818 add `scribble/tag' and clean up some tag-related documentation and functions
Includes the addition of `make-section-tag' and `taglet?' to
`scribble/base'.

original commit: f29230f8f2710b58eae8646edd6eab9f6760deee
2012-12-27 09:24:14 -06:00
Greg Hendershott
77b1b267b5 Fix bug with pound signs used to mark sections.
Also update tests/scribble/markdown-docs files accordingly.

original commit: faeba879e292414dd6d5d9e38d4a08b26e63cceb
2012-12-19 19:32:00 -07:00
Greg Hendershott
624b8ef7e4 Render Scribble margin-note as Markdown block-quote.
More precisely, do this for nested flows with the "refcontent" style.

For instance this Scribble:

    @margin-note{Note: This is a note. Let's make it long enough that the
    markdown output will have to line-wrap, to make sure the > mark starts
    each line properly.}

Will render as this Markdown:

    > Note: This is a note. Let's make it long enough that the markdown output
    > will have to line-wrap, to make sure the > mark starts each line
    > properly.

A site like GitHub.com will render this in a block-quote style
suitable for notes:

> Note: This is a note. Let's make it long enough that the markdown output
> will have to line-wrap, to make sure the > mark starts each line
> properly.

original commit: a3800cdc94d5f0c1b361d6e3ead6c1ebceb66288
2012-12-19 19:31:15 -07:00
Matthew Flatt
042f013e13 scribble: encode URLs in 'unreserved mode
original commit: 130c989888e3ac596fc5c5ac73c3493fd3bb924c
2012-12-17 07:09:27 -07:00
Matthew Flatt
4f1eae99b6 raco setup: fix problem with doc index database
When a tag is serializable but not `write'--`read' invariant,
then it needs to be serialized and deserialized.

Also, clarify and check in `tag?' that a tag should be
serializable.

original commit: 6eef00a31287fd88e1c93139dc5b6c1ab97f6da8
2012-12-13 15:45:48 -07:00
Danny Yoo
8d8e2ea112 Add separate section to avoid conflict at scribble time.
original commit: f374cb184d67bb9073ccfbca408aeadc8f2a96ba
2012-12-13 13:00:06 -07:00
Danny Yoo
5b72f34f76 Add scribble/doclang2 with keyword support for customization, and documentation.
original commit: db280d0941d25904d01b5d49ab880218fc759cfa
2012-12-13 12:50:27 -07:00
Greg Hendershott
98e3fa52d8 Render italic and bold in Markdown.
Scribble => Markdown
  @bold{text}    **text**
@italic{text}     _text_

original commit: 00a5bf63b1819f324ea41b91ce8ee288e1dc7ff5
2012-12-12 20:58:44 -07:00
Greg Hendershott
cdc89f9685 Render @hyperlink in Markdown.
Render Scribble like

    @hyperlink["url" "content"]

as Markdown like

    [content](url)

Note that this only works for `@hyperlink`. The motivation is to
preserve content the author has explicitly written. (Previously,
`markdown-render.rkt` was discarding this; `text-render.rkt` still
does so.)

This does _not_ attempt to handle everything that `html-render.rkt`
would automatically generate and render as `<a>`. It simply can't --
things like hotlinked Racket keywords in code blocks simply won't work
in Markdown.

original commit: dbffc840a93ceb142c59df4a533ced0b41b8e4fa
2012-12-11 12:40:54 -07:00
Matthew Flatt
3af3acb27f fix comments
I had it all backwards: DrRacket went from "increment" to Greek
capital delta (which makes a lot more sense).

original commit: 490a474e0e4b92af8956cab13d885349053a3973
2012-12-10 10:27:44 -07:00
Matthew Flatt
4fadca633f scribble: render "incremement" and some other chars for Latex/PDF
This change was prompted by the change to DrRacket's "\Delta"
to produce the Unicode "increment" character.

original commit: fc112ccd4627f0b7413ba17a81d050bb840a79b3
2012-12-10 10:20:32 -07:00
Greg Hendershott
51d487bc1b Add a Markdown rendering mode to Scribble.
Uses "Github flavored markdown". Specifically, code blocks are opened
using ```scheme so that Github will lex and format them as Scheme code
rather than generic monospace.

Note: I would have used ```racket, but we are still waiting for the
pygments.rb project to pull again from pygments-main -- to which I
contributed a Racket lexer back in August. After pygments.rb pulls,
can update this to use ```racket instead.

original commit: 6aa6dc0400f4fed688e6f5b5278da2e34d82ad88
2012-12-09 15:17:36 -07:00
David Van Horn
cd18c13bf9 Change latex render units from px (pdflatex specific) to bp (tex).
The px unit is a pdflatex specific adjustable unit that is 1 bp (big
point = 1/72in) by default.  This commit changes the latex renderer to
use bp which is a standard TeX unit equivalent to the default px
value.  This change allows .tex files generated by scribble to work
with other latex engines such as xelatex.

http://nwalsh.com/tex/texhelp/Plain.html#dimensions
http://tex.stackexchange.com/questions/41370/what-are-the-possible-dimensions-sizes-units-latex-understands

Here is a small test of using scribble and xelatex:

$ cat try.scrbl
@(require scriblib/figure redex/reduction-semantics redex/pict)
@(define-language L)
@(render-term L (term 1))

$ scribble --latex try.scrbl ; xelatex try

original commit: 0dfcf634ed29a9d6e9d99ea7bcd02121abd24a7b
2012-12-07 06:53:45 -06:00
Matthew Flatt
0836269713 scribble HTML: no extra breaking at the end of an identifier
original commit: bd16f1e302ad3d3fa7a47a8739a33c1eef56969e
2012-11-29 07:18:30 -07:00
Sam Tobin-Hochstadt
a0619711b3 Switch to use almost-standard DOCTYPE for Scribble.
Also switches scribble search trampoline to standard DOCTYPE.

Scribble's HTML output currently relies on the quirks-mode
box model for layout of the many tables used in rendering.
However, Scribble doesn't need the rest of the changes in
browser quirks modes, so we choose a DOCTYPE that just
changes the box model.

It's non-obvious how to replicated this formatting with CSS
in standard-mode rendering.  Probably a better long term
solution is to move away from table-based layout.

See further discussion on GitHub pull request 158 here:
  https://github.com/plt/racket/pull/158

original commit: d6b0dfcd0451d3816bfe1e331a275ef2792fbb88
2012-11-29 07:06:52 -07:00
Robby Findler
4f8f97c58f improve the 'method' syntax error so it gives a hint which argument is which
original commit: e7c622214254aa111361de11f22ff77f24f8e7f8
2012-11-28 13:12:28 -06:00
Asumu Takikawa
7a4767a341 Fix nav separator for Opera
Commit 8653bc6792b614c69b7d0aab7e329591735a0dad caused
the doc navigation to render oddly on Opera due to how
it handles &nbsp;. This commit retains the spacing
for text browsers, but fixes the navigation on Opera.

original commit: 3e81924f848731abda7415d89b4db0ada6ecb308
2012-11-27 18:03:40 -05:00
Matthew Flatt
84cef2a69a adjust some comments to further clarify
original commit: 36bfae9497a4e86aa1264726b66a43afdda0948c
2012-11-27 08:07:27 -07:00
Samuel Bronson
5a45287255 scribble/html-render: clarify mangling of entities: &mdash; &lang; &rang;
original commit: 3ee6248daa13ac4293480778ff7726e962e58e41
2012-11-27 08:04:42 -07:00
Samuel Bronson
fa69afbe71 scribble: Rename attribute pltdoc -> data-pltdoc, which is valid in HTML5.
(pltdoc isn't valid in any version of HTML.)

original commit: 5a216cc4ce2b789f4f6cd6c7f1dd4d44099fb325
2012-11-27 07:55:43 -07:00
Samuel Bronson
b647bf3ad8 Typo fix in content-type: text-html -> text/html
original commit: a66fa77e2e4e3d45aa65404a642b4d3a1fc7683a
2012-11-27 07:55:36 -07:00
Samuel Bronson
61454baac0 scribble/html-render: comment nits
original commit: e157041497046471cbd4bcb3e65259380d997fea
2012-11-27 07:55:23 -07:00
Samuel Bronson
066db6a0b4 scribble/html-render: Add missing sep-element for non-CSS browsers
original commit: 8653bc6792b614c69b7d0aab7e329591735a0dad
2012-11-27 07:55:16 -07:00
Samuel Bronson
b033e80e4e scribble/html-render: Fix typo in error message
original commit: 11df3f9b2022ddeabf376735b345c8bff0bdfebe
2012-11-27 07:55:08 -07:00
Samuel Bronson
99f66dda80 scribble/racket.css: Avoid excessive line-height in some cases
(In particular, when the default line-height for "monospace" is smaller than for the main font.)

original commit: 45bdaa131d61e722fe99d4551e7a97fab2586911
2012-11-27 07:54:05 -07:00
Asumu Takikawa
446dc48686 Index raco scribble command
Relevant to PR 12956

original commit: 8c91decc8a22d371ac472ce956cc407490f8f116
2012-11-26 17:52:43 -05:00
Matthew Flatt
e6d3862627 scribble latex: work around `\href{...#...}{...}' as a macro argument
The `math' document build was failing because `\marginpar' does not
like `\href{...#...}{...}' as an argument.

original commit: 24f358a5d7afca40fcf734af94c2c94a80a817dc
2012-11-25 06:24:51 -07:00
Matthew Flatt
f2c9297253 raco setup: move doc dependency and duplicate checking to database
This change makes document building --- and specially incremental
document building --- more scalable. The global duplicate-definition
check is handled by a database query, for example.

original commit: 9888fac99e32131a6e848f30c40024abb893a9b9
2012-11-23 20:07:49 -07:00
Matthew Flatt
b5865f2f79 break cross-reference info for document into pieces
For example, the cross-reference information for the
Reference is now broken into about 16 pieces, so that
resolving a cross-reference into the Reference doesn't
require loading all cross-reference information for
the Reference.

Every document is split into two pieces, so that the title
of a document is roughly in its own piece. That way,
re-building the page of all installed documentation can be more
scalable (after some further changes).

original commit: a73dc502242d5a61efe526ebb19fc2588f30372a
2012-11-23 18:44:51 -07:00