mbutterick / pollen-tfl Goto Github PK

View Code? Open in Web Editor NEW

65.0 65.0 9.0 20.36 MB

Commented Pollen sample project [mirror of https://git.matthewbutterick.com/mbutterick/pollen-tfl]

Home Page: https://git.matthewbutterick.com/mbutterick/pollen-tfl

Perl 66.74% OpenEdge ABL 3.36% CSS 0.36% Racket 23.13% Pascal 6.14% Makefile 0.09% Raku 0.16%

pollen-tfl's People

Contributors

Stargazers

Watchers

Forkers

racket-dep-fixer sturgman h-a-z andresduarte zachmandeville racket-pirates ehamiter rebcabin danielhaden

pollen-tfl's Issues

servlet error when http://localhost:8080/toc.html

Install pollen and depended pkgs
(racket 6.4 @osx 10.11.3)
git clone https://github.com/mbutterick/pollen-tfl.git
cd pollen-tcl
taco pollen start
https://github.com/mbutterick/pollen-tfl.git

Error information
request: /toc.html
rendering: /toc.html.pm as /toc.html
Servlet (@ /toc.html) exception:
decode-elements: contract violation
expected: txexpr-elements?
given: '((div ((class "hanging-topic") (hyphens "none")) (h3 ((class "topic")) "small caps") (p ((hyphens "none")) "Use real small caps; avoid fakes")) "\n" "\n" (em "Small caps") " are short capital letters designed to blend with lowercase text. They’re usually slightly taller than lowercase letters. (Small caps are used in this book to denote " (a ((hyphens "none") (class "xref") (href)) "cross-references") ".)" "\n" "\n" "I’m a big fan of small caps. They look great and they’re very useful as an alternative to " (a ((hyphens "none") (class "xref") (href "bold-or-italic.html")) "bold or italic") " or " (a ((hyphens "none") (class "xref") (href "all-caps.html")) "all caps") "." "\n" "\n" "But most people have never seen real small caps. They’ve only seen the ersatz small caps that word processors generate when small-cap formatting is used." "\n" "\n" (div ((class "omission"))) "\n" "\n" "Small-cap formatting works by scaling down regular caps. But compared to the other characters ...
in: the 1st argument of
(->*
(txexpr-elements?)
(#:block-txexpr-proc
(->
block-txexpr?
(or/c txexpr-element? txexpr-elements?))
#:cdata-proc
(->
cdata?
(or/c txexpr-element? txexpr-elements?))
#:entity-proc
(->
(or/c symbol? valid-char?)
(or/c txexpr-element? txexpr-elements?))
#:exclude-attrs
txexpr-attrs?
#:exclude-tags
txexpr-tags?
#:inline-txexpr-proc
(->
txexpr?
(or/c txexpr-element? txexpr-elements?))
#:string-proc
(->
string?
(or/c txexpr-element? txexpr-elements?))
#:txexpr-attrs-proc
(-> txexpr-attrs? txexpr-attrs?)
#:txexpr-elements-proc
(-> txexpr-elements? txexpr-elements?)
#:txexpr-proc
(->
txexpr?
(or/c txexpr-element? txexpr-elements?))
#:txexpr-tag-proc
(-> txexpr-tag? txexpr-tag?))
(or/c txexpr-element? txexpr-elements?))
contract from:
/pollen/pollen/decode.rkt
blaming: /Users/rshen/tmp/pollen-tfl/scribblings/pollen-rkt.scrbl
(assuming the contract is correct)
at: /pollen/pollen/decode.rkt:98.25

context...:
/Applications/Racket v6.4/collects/racket/contract/private/blame.rkt:156:0: raise-blame-error16
/Applications/Racket v6.4/collects/racket/contract/private/arrow-val-first.rkt:338:5: mk-call
/Applications/Racket v6.4/collects/racket/contract/private/arrow-val-first.rkt:335:3
/Users/rshen/tmp/pollen-tfl/scribblings/pollen-rkt.scrbl:781:7: root
(submod /Users/rshen/tmp/pollen-tfl/small-caps.html.pm g49930): [running body]
/Users/rshen/tmp/pollen-tfl/small-caps.html.pm: [traversing imports]
/Users/rshen/Library/Racket/6.4/pkgs/pollen/pollen/private/cache-utils.rkt:33:0: path->hash
/Users/rshen/Library/Racket/6.4/pkgs/pollen/pollen/private/cache-utils.rkt:76:14: temp16
/Applications/Racket v6.4/collects/file/cache.rkt:63:2: fetch-and-continue
/Applications/Racket v6.4/collects/racket/contract/private/arrow-val-first.rkt:335:3
/Users/rshen/Library/Racket/6.4/pkgs/pollen/pollen/private/cache-utils.rkt:67:0: cache-ref!
/Applications/Racket v6.4/collects/racket/private/more-scheme.rkt:373:13: hash-ref!
/Users/rshen/Library/Racket/6.4/pkgs/pollen/pollen/cache.rkt:24:4: cached-require-base
select-from-metas
/Applications/Racket v6.4/collects/racket/contract/private/arrow-val-first.rkt:312:18
/Applications/Racket v6.4/collects/racket/private/norm-define.rkt:53:83: node->link
...

found broken reference in paragraph-and-section-marks.html.pm

correct with following changes
diff --git a/paragraph-and-section-marks.html.pm b/paragraph-and-section-marks.html.pm
index 07d116e..2f58a97 100644
--- a/paragraph-and-section-marks.html.pm
+++ b/paragraph-and-section-marks.html.pm
@@ -8,7 +8,7 @@ The ◊em{paragraph mark} ◊glyph{¶} is used when citing documents with sequen

The ◊em{section mark} ◊glyph{§} is used when citing documents with numbered or lettered sections (e.g., statutes).

-A paragraph mark or section mark should always be followed by a nonbreaking space. The ◊xref{nonbreaking space} acts like glue that keeps the mark joined with the numeric reference that follows.
+A paragraph mark or section mark should always be followed by a nonbreaking space. The ◊xref{nonbreaking spaces} acts like glue that keeps the mark joined with the numeric reference that follows.

Without the nonbreaking space, the mark and the reference can end up on separate lines or pages. This can confuse readers.

Is this meant to run as is?

Hello! I am trying to learn pollen and I was using this repository to explore things. I tried two methods: installing it via raco and by just cloning the repository. In both instances, I had trouble rendering any of the files due to an error related to Equity URL not being found.

So my question is: am I supposed to be able to render this repository in my computer? My guess is yes since the readme mentions it is an aid for learning pollen.

Perhaps it would be wise to remove the Equity (and any other MB) font dependence?

This is the exact error message:

Exception

The application raised an exception with the message:

no URL found for "Equity"

Stack trace:

I have since tried to remove Equity from the project, but I failed at this. Let me know if there is something I can do to help.

lambda-less make-list-function sample has incorrectly placed parens

https://github.com/mbutterick/pollen-tfl/blob/master/scribblings/pollen-rkt.scrbl#L443

This has no expression after the initial nested define.

(define (make-list-function tag [attrs empty])
  (define (listifier . args)
    (list* tag attrs (detect-list-items args))
    listifier))

This is the currect version.

(define (make-list-function tag [attrs empty])
  (define (listifier . args)
    (list* tag attrs (detect-list-items args)))
  listifier)

Fails to build on Windows

Hello. I was curious about pollen and I wanted to see how a real project like pollen-tfl looks like. I was following the docs on my Windows 10 system. It seems there is something wrong with path-names, around tilde expansion: expand-user-path: bad username in path.

I'm attaching a complete login case that helps.

PS C:\Users\me\projects\pollen-tfl> raco pkg install pollen-tfl
Resolving "pollen-tfl" via https://download.racket-lang.org/releases/8.5/catalog/
Resolving "pollen-tfl" via https://pkgs.racket-lang.org
Using cached16537545631653754563634 for https://github.com/mbutterick/pollen-tfl.git
Resolving "hyphenate" via https://download.racket-lang.org/releases/8.5/catalog/
Resolving "hyphenate" via https://pkgs.racket-lang.org
Resolving "txexpr" via https://download.racket-lang.org/releases/8.5/catalog/
Resolving "txexpr" via https://pkgs.racket-lang.org
Resolving "sugar" via https://download.racket-lang.org/releases/8.5/catalog/
Resolving "sugar" via https://pkgs.racket-lang.org
raco setup: version: 8.5
raco setup: platform: win32\x86_64 [cs]
raco setup: target machine: ta6nt
raco setup: installation name: 8.5
raco setup: variants: cs
raco setup: main collects: C:\Program Files\Racket\collects\
raco setup: collects paths:
raco setup:   C:\Users\me\AppData\Roaming\Racket\8.5\collects
raco setup:   C:\Program Files\Racket\collects\
raco setup: main pkgs: C:\Program Files\Racket\share\pkgs
raco setup: pkgs paths:
raco setup:   C:\Program Files\Racket\share\pkgs
raco setup:   C:\Users\me\AppData\Roaming\Racket\8.5\pkgs
raco setup: links files:
raco setup:   C:\Program Files\Racket\share\links.rktd
raco setup:   C:\Users\me\AppData\Roaming\Racket\8.5\links.rktd
raco setup: main docs: C:\Program Files\Racket\doc
raco setup: --- updating info-domain tables ---                    [22:58:41]
raco setup: updating: C:\Users\me\AppData\Roaming\Racket\8.5\share\info-cache.rktd
raco setup: --- pre-installing collections ---                     [22:58:41]
raco setup: --- installing foreign libraries ---                   [22:58:41]
raco setup: --- installing shared files ---                        [22:58:41]
raco setup: --- compiling collections ---                          [22:58:41]
raco setup: --- parallel build using 4 jobs ---                    [22:58:41]
raco setup: 3 making: <pkgs>/pollen-tfl
raco setup: 3 making: <pkgs>/pollen-tfl/fontrec
raco setup: 3 making: <pkgs>/pollen-tfl/fonts
expand-user-path: bad username in path
  path: ~/git/font-releases/woffs/advocate_slab_c43_regular.woff
  system error: unsupported; rkt_err=1
  context...:
   body of (submod 'runtime-wrapper pollen-module)
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:685:0: compile-zo*
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:451:15
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:440:12: build
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:411:0: maybe-compile-zo
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:209:0: compile-root
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:105:4
   C:\Program Files\Racket\collects\setup\parallel-build.rkt:332:9
   C:\Program Files\Racket\collects\setup\parallel-do.rkt:455:25
   C:\Program Files\Racket\collects\setup\parallel-do.rkt:441:20: loop
raco setup: 3 making: <pkgs>/pollen-tfl/images
expand-user-path: bad username in path
  path: ~/git/font-releases/woffs/equity_text_a_regular.woff
  system error: unsupported; rkt_err=1
  context...:
   body of (submod 'runtime-wrapper pollen-module)
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:685:0: compile-zo*
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:451:15
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:440:12: build
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:411:0: maybe-compile-zo
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:209:0: compile-root
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:105:4
   C:\Program Files\Racket\collects\setup\parallel-build.rkt:332:9
   C:\Program Files\Racket\collects\setup\parallel-do.rkt:455:25
   C:\Program Files\Racket\collects\setup\parallel-do.rkt:441:20: loop
expand-user-path: bad username in path
  path: ~/git/font-releases/woffs/equity_text_b_regular.woff
  system error: unsupported; rkt_err=1
  context...:
   body of (submod 'runtime-wrapper pollen-module)
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:685:0: compile-zo*
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:451:15
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:440:12: build
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:411:0: maybe-compile-zo
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:209:0: compile-root
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:105:4
   C:\Program Files\Racket\collects\setup\parallel-build.rkt:332:9
   C:\Program Files\Racket\collects\setup\parallel-do.rkt:455:25
   C:\Program Files\Racket\collects\setup\parallel-do.rkt:441:20: loop
expand-user-path: bad username in path
  path: ~/git/font-releases/woffs/concourse_c6_regular.woff
  system error: unsupported; rkt_err=1
  context...:
   body of (submod 'runtime-wrapper pollen-module)
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:685:0: compile-zo*
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:451:15
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:440:12: build
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:411:0: maybe-compile-zo
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:209:0: compile-root
   C:\Program Files\Racket\collects\compiler\private\cm-minimal.rkt:105:4
   C:\Program Files\Racket\collects\setup\parallel-build.rkt:332:9
   C:\Program Files\Racket\collects\setup\parallel-do.rkt:455:25
   C:\Program Files\Racket\collects\setup\parallel-do.rkt:441:20: loop
raco setup: --- creating launchers ---                             [22:59:44]
raco setup: --- building documentation ---                         [22:59:44]
raco setup: 2 running: <pkgs>/pollen-tfl/scribblings/pollen-tfl.scrbl
raco setup: 3 rendering: <pkgs>/racket-index/scribblings/main/user/local-redirect.scrbl
raco setup: 2 rendering: <pkgs>/pollen-tfl/scribblings/pollen-tfl.scrbl
raco setup: 1 rendering: <pkgs>/racket-index/scribblings/main/user/release.scrbl
raco setup: 0 rendering: <pkgs>/racket-index/scribblings/main/user/search.scrbl
raco setup: 3 rendering: <pkgs>/racket-index/scribblings/main/user/start.scrbl
raco setup: --- installing collections ---                         [23:00:04]
raco setup: --- post-installing collections ---                    [23:00:04]
raco setup: --- summary of errors ---                              [23:00:04]
raco setup: error: during making for <pkgs>/pollen-tfl/fonts
raco setup:   expand-user-path: bad username in path
raco setup:     path: ~/git/font-releases/woffs/advocate_slab_c43_regular.woff
raco setup:     system error: unsupported; rkt_err=1
raco setup: error: during making for <pkgs>/pollen-tfl/fonts
raco setup:   expand-user-path: bad username in path
raco setup:     path: ~/git/font-releases/woffs/equity_text_a_regular.woff
raco setup:     system error: unsupported; rkt_err=1
raco setup: error: during making for <pkgs>/pollen-tfl/fonts
raco setup:   expand-user-path: bad username in path
raco setup:     path: ~/git/font-releases/woffs/equity_text_b_regular.woff
raco setup:     system error: unsupported; rkt_err=1
raco setup: error: during making for <pkgs>/pollen-tfl/fonts
raco setup:   expand-user-path: bad username in path
raco setup:     path: ~/git/font-releases/woffs/concourse_c6_regular.woff
raco setup:     system error: unsupported; rkt_err=1
raco pkg install: packages installed, although setup reported errors

Recommend Projects

React

A declarative, efficient, and flexible JavaScript library for building user interfaces.
Vue.js

🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript

TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
TensorFlow

An Open Source Machine Learning Framework for Everyone
Django

The Web framework for perfectionists with deadlines.
Laravel

A PHP framework for web artisans
D3

Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

javascript

JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
web

Some thing interesting about web. New door for the world.
server

A server is a program made to process requests and deliver data to clients.
Machine learning

Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Visualization

Some thing interesting about visualization, use data art
Game

Some thing interesting about game, make everyone happy.

Recommend Org

Facebook

We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft

Open source projects and samples from Microsoft.
Google

Google ❤️ Open Source for everyone.
Alibaba

Alibaba Open Source for everyone
D3

Data-Driven Documents codes.
Tencent

China tencent open source team.