Commit Graph

1849 Commits

Author SHA1 Message Date
Matthew Flatt
adc82b0c67 scribble: add nosearchform to HTML output without a search box
original commit: 3d637c047c51674ab061c61f618fb925aa22800b
2014-06-26 16:07:04 +01:00
Matthew Flatt
6b302dcfc6 fix doc typo
original commit: 377ba62207768f1b0a925769dff56dff05e3a8bd
2014-06-26 15:31:58 +01:00
Matthew Flatt
feed786915 scribble: 'border and '{left,right,top,bottom}-border properties for cells
original commit: 2134dbf95293189d6f11bf896a3ba43d9fb10aaf
2014-06-24 11:30:14 +01:00
Matthew Flatt
e5ebb45c06 Scribble: improve Unicode handling for Latex/PDF output
Normalize strings to composed form before splitting a
string into characters to handle individually.

original commit: d970d5aaead2bfbae0651b583f79e6ac719c7d39
2014-06-23 06:28:50 +01:00
Robby Findler
6ac2c7cfef add abbreviate-given-names
This changes the behavior of make-cite and authors, but it would
probably be better to change the behavior of generate-bibliography

original commit: 74831b41cc2589af94a4e7cc6ffefa1d8809226c
2014-06-20 19:23:14 -05:00
Matthew Flatt
818981a308 scribble/decode: document treatment of whitespace by decode-content
original commit: 02d53d29fb4ab074ebaa0036bf27f10a949069bb
2014-06-04 13:38:24 +01:00
Matthew Flatt
ed2aa7b04f scribble: fix history spacing
original commit: 94dbfba0f3f77c9603bcba4aee249823cc91eeed
2014-06-04 13:34:03 +01:00
Matthew Flatt
78d5223eba rackunit/docs-complete: move to the "racket-index" package
Modules are not supposed to move to different packages, anymore, so
I'm breaking a rule. The problem is that having `rackunit/docs-complete`
in "scribble-lib" made "scribble-lib" depend on "racket-index", and
that's an undesirable dependency. (Installing Scribble shouldn't
force you to have Racket documentation.) I should have noticed
the problem when I moved `setup/xref` to "racket-index", but I missed
it.

As far as I can tell, there's only one package on pkgs.racket-lang.org
that isn't in the main repository and uses `rackunit/docs-index`. The
package doesn't correctly declare its dependencies, anyway.

original commit: d33c2252e10dbeb22e49c85f03707345e2756ce5
2014-06-02 12:34:12 +01:00
Matthew Butterick
9c34fe33c8 reduce size of manual-fonts.css
original commit: c4ebd6058ebe4eab04d7c323d7a75668043d576a
2014-05-29 09:49:08 +01:00
Matthew Flatt
0909ced11b scriblib/figure: make figure hyperlinks show start of figure
... instead of putting the figure's caption at the top of the
browser window.

I can't decide whether I like the technique here, which is to use
JavaScript to move a figure caption's <a name=...> when the page is
loaded.  On the one hand, fixing up HTML via load-time JavaScript code
seems ugly compared to generating the right HTML in the first place.
On the other hand, it simplifies the generatation of a
backend-independent Scribble document (i.e., don't try to generate
different target locations for HTML and Latex), and HTML-specific
behavior seems properly handled at the HTML/JavaScript level.

original commit: 2b33b8d9668988b67f6b68b9eb012eb6d8f417d5
2014-05-28 13:14:39 +01:00
Matthew Flatt
7e8ff47b5b scribble docs: fix example for literal
original commit: 81d7d0df4a53590e19ccaad294290af512712230
2014-05-14 06:10:50 -06:00
Matthew Flatt
6b76b2df2a scribble/base: add #:style argument to image
original commit: c9f13248e33502b71d2ff95b8bc38e28ff680491
2014-05-14 06:10:50 -06:00
Matthew Flatt
b5e473c5d9 scribble: fix HTML scaling of GIFs
Even without scaling, declare the size of a PNG or GIF in HTML
output.

original commit: 3f3e6e4cb421e8004c4e0c5ee5944718bdd686a3
2014-05-12 20:13:20 -06:00
Matthew Flatt
96fc0407d0 Scribble search, etc.: fix URL decoding
Use Javascript's decodeURIComponent() instead of unescape().

This repair makes searching for Unicode characters work from DrRacket
(e.g., via F1).

original commit: d1525edf62a1db2ade3c64dd17eb81bff87a4112
2014-05-11 08:34:58 -06:00
Matthew Flatt
2a67912028 scribble: discard partial output on exception
This change avoids the problem of a bad "index.html" on a doucment
rendering error, where the presense of an "index.html" would count
as successes on a retry.

original commit: e4e8a69e06863b423f4b7b716b369b002c2deea1
2014-05-09 09:37:24 -06:00
Matthew Flatt
4291016987 docs search: avoid accumulating "q" queries
original commit: 53e3d104f7adda1d94598ed498dec3b5f205e308
2014-05-05 10:37:10 -06:00
Matthew Flatt
d2ccd73741 config: add doc-open-url configuration
This configuration option is a better way to redirect documentation
access (at a place like NEU) than patching "search.rkt".

original commit: a8105dc0e34e5571ec9ecdb47635e409e29882c5
2014-05-04 09:31:59 -06:00
Matthew Flatt
b76831a2cf scribble/manual: clicking on a section title shows linking information
Thanks to Matthew Butterick for help and advice.

original commit: b8cc111e92e1c704a0f3462102c86dc24f8f5615
2014-05-03 21:05:26 -06:00
Matthew Flatt
d7a02588da scribble test: update expected result for struct indentation
original commit: a03c396691302f7163c5b5a9f855dfcdb76645d8
2014-04-20 20:20:34 -06:00
Matthew Flatt
7dd9a13ad6 fix references to subdirectories of a rendered manual
For example, fix the resolution of a link to a binding in the R5RS
or R6RS spec.

original commit: 4216f3b66615ed5f63ff2f8350e9e1f778cd141b
2014-04-19 11:14:37 -06:00
Matthew Butterick
3e8ac59cfb missing semicolon in Scribble CSS
original commit: 481d19fbdd18510b3d3274d2ee4d4d061a5d2317
2014-04-05 19:25:06 -06:00
Matthew Butterick
cc68354488 further dehackify .toptoclink style in Scribble CSS
original commit: 7a1fe139a587800d2af76ce7eb09250247e9feea
2014-04-05 16:30:35 -06:00
Matthew Flatt
1bca3ea18c scribble manual style: remove toc hack
At mbutterick's recommendation:

 it's causing a strange display problem in TOC listings when the
 cursor is hovering over the link (namely, the underlined space
 dangling from the right edge)

original commit: cc26a86cb1975bdbb1ed3f816b6a50decfdec510
2014-04-05 08:07:48 -06:00
Matthew Flatt
0fd78b8ca8 scribble/base: add #:{column,row,cell}-properties arguments to tabular
The new arguments greatly simplify adding properties such as alignment
and (HTML) background colors to table cells. For example, to make a
table with 'right alignment for the left-hand column, 'center alignment
for the second column, and 'left alignment for all remaining columns:

 (tabular cells
          #:sep (hspace 1)
          #:column-properties '(right center left))

Also, make `color-property` and `background-color-property` recognized
as table-cell style properties.

Finally, implement horizontal alignment for text rendering.

original commit: 316fc0dbf5e26061245d815c992cc54d9738aa79
2014-03-25 14:23:22 -06:00
Sam Tobin-Hochstadt
87201fe4e0 Fix description of citet requirements.
original commit: b961b55bb2dd13f46d84c300f6536e49c1d0494a
2014-03-18 16:28:41 -04:00
Matthew Flatt
b36443dc6a scribble: #:doc-id argument to load-xref and associated plumbing
Keep track of the target document name (i.e., the name of the
directory that will contain the target document) for a cross
reference, when known. This identification enables a simpler dynamic
resolution of a hyperlink in almost all cases, istead of requiring
a search for an arbitrary corss-reference key.

Indirect links still need a mapping of cross-reference keys
to document locations, but the mapping can be pruned to just
section and module-name keys.

This change cuts a generated "local-redirect.js" for the main
distribution to 1/8 of its size.

original commit: a956918adb1ffe69b7cefea00f3c9d594f58734a
2014-03-16 12:40:52 -06:00
Matthew Flatt
1666108800 scribble/manual docs: corrections on #:link-target? and #:indirect
original commit: c429032d7e4631742a04076962cfa1ca2439f80e
2014-03-16 09:18:40 -06:00
Matthew Flatt
fdb4bb99d0 scribble docs: tweak language related to collections and packages
original commit: f94dc32329e7b303e92feba736f33b3484b281b3
2014-03-16 09:18:40 -06:00
Asumu Takikawa
7c81ef7f75 Revise Scribble docs for the new package system
Replaced mentions of PLaneT with the new package system
in sec 4.1 of the Scribble docs.

original commit: 01ed4fa480cdf5f32e20459091778b75414389eb
2014-03-14 10:22:12 -04:00
Matthew Flatt
1ef30a5715 scribble/html docs: clarify the effect of 'abs un url-roots
original commit: d168e5953d8001d981458e5ebb0ed0b3fc2669b8
2014-03-07 14:32:55 -07:00
Stephen Chang
b2d05d8a2f add tests for scribble/eval
original commit: cd50d0077675adf2d73f064326cf28f461866ebc
2014-03-05 16:41:56 -05:00
Stephen Chang
b11717253d fix scribble make-base-eval racket/pretty namespace error
closes pr 14066

original commit: b7360c76d7bdda4d6973bc09f0266b4dc0c9dc84
2014-03-05 16:41:56 -05:00
Matthew Flatt
3d40e770ef scribble/render: fix contract on render to include #:warn-undefined?
original commit: fb20706213dc5ece7894afff46763428bee346f0
2014-03-05 10:33:35 -07:00
Matthew Flatt
09cfb6ce12 LGPL by reference
original commit: 981701d2378179d4ada54b7fd2608df3b89748fd
2014-02-27 15:56:11 -07:00
Matthew Flatt
0bbee2d93e typos and notes
Thanks to Eli.

original commit: c64142ce24c3773eb4c3d4603588de286f1032d3
2014-02-12 18:47:04 -07:00
Matthew Flatt
e34cf22278 scribble/manual: delay expressions that require collection-based files
This changed make `(require scribble/manual)` work in an executable,
although actually rendering documents requires the "scribble"
collection.

original commit: 9ca0aa52250c18dd05c2a19bea654ca770aecf0c
2014-02-11 10:07:03 -07:00
Matthew Flatt
1bac8f0057 scribble/html: add 'index flag in url-roots
This flag can be used to make "file://..."-rendered pages easier
to inspect.

original commit: 2f469a06cd56c5be1ddab2a169428cd2099a2cbb
2014-02-11 05:50:04 -07:00
Matthew Flatt
b669a390ff scribble/text: fix contract and docs on with-writer
original commit: 964e9d128fd44da01ff1eea3efe9b02566f28530
2014-02-11 05:50:04 -07:00
Matthew Flatt
460c6323e0 scribble/text: add outputable/c and contract checks
The `outputable/c` contract is currently just an alias for
`any/c`, however, because checking the contract seems to be
too expensive.

original commit: 416b680d742afafe7f5632ca94cb36bac25534b8
2014-02-09 06:39:39 -07:00
Asumu Takikawa
ec6eb40ce8 Adjust prose in how-to-doc section of Scribble docs
original commit: 50711f7a6e570300cbdcb2b8979c93878bacac68
2014-02-08 09:49:11 -05:00
Matthew Flatt
2064749fa2 scribblings/html/resource: allow #f renderer for URL conversion
original commit: f1521de96b52a0f52ec23a02c5016622524086e5
2014-02-07 22:36:01 -07:00
Matthew Flatt
19ea3a7194 split "scribble-html-lib" package out of "scribble-lib" package
original commit: 0ad3a6a7f6c897b4fe7d3d2dfdceb3a8831e293a
2014-02-07 22:36:01 -07:00
Matthew Flatt
e7adecfd59 Scribble docs: split preprocessor variants into a separate manual
original commit: ce31b5965c4680ca53cb85d6ec6731e2f949878f
2014-02-07 22:36:01 -07:00
Matthew Flatt
b23fb873f5 scribble-{doc,lib}: fix package dependencies
original commit: 01ca4933895cadb3e0d6cdf8c170fdf06624dcff
2014-02-06 05:47:56 -07:00
Matthew Flatt
f7db2c37c2 scribble/html: first cut at documentation
original commit: f943d37d7d30507c8b76fd358d568f361bc0f2ec
2014-02-05 21:58:48 -07:00
Matthew Flatt
702b3e6702 scribble/text: finish documentation
original commit: cdb5c9dfdb50f6cb4dab09be11f3f46b81c32d59
2014-02-05 21:54:14 -07:00
Matthew Flatt
7889e768c8 scribble/sigplan: fix problem that makes doi required
Closes PR 14311

original commit: af28d4175d07113b3ba788fd03a6c5df9f384508
2014-02-04 17:59:26 -07:00
Matthew Flatt
eb4e22904a scribble: ++args for passing command-line arguments to documents
original commit: 392ea2e91d6c51157daa35dd1aa72cca951b6ac9
2014-01-22 20:04:13 -07:00
Eli Barzilay
78728a728e 2013 -> 2014
original commit: c61a549840ee0ba5f2e5da56523fd3b26efeb895
2014-01-21 15:02:21 -05:00
Asumu Takikawa
40e12781cd Fix doc typos
original commit: 54e24e42c61e265158dc1be883b27f09fe95231d
2014-01-17 10:22:33 -05:00