Skip to content

Conversation

@SnO2WMaN
Copy link
Contributor

related #436

let authors ← andList <$> p.authors.mapM go
return {{
{{authors}} s!", {p.year}. " {{ link {{"“" {{← go p.title}} "”"}} }} ". "
{{ p.series.map (λ (s, v) => {{ "Volume " <strong>s!"{v}"</strong> " of " /- TODO: insert series -/ ", "}}) |>.getD .empty }}
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I assume it's rare for a book reference to include only series or volume without the other, so I’ve treated them as a pair. However, I’m unsure how to represent this pairing properly in the citation formatting (manupulating Html or etc. is too complex).

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See comment on datatype

isbn : Option String := none -- TODO: make concrete type `ISBN10` or `ISBN13`
publisher : Doc.Inline Manual
edition : Option (Doc.Inline Manual) := none
series : Option ((Doc.Inline Manual) × Int) := none
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this misunderstands "volume" in citations.

I would use volume for a single work that's published in multiple physical books, e.g. The Art of Computer Programming by Knuth. A series is usually a collection of disparate books by multiple authors created over a period of time, and it's IMHO less important here.

That is, if I'm citing TAoCP, it matters a lot whether it's vol. 1 or 3. But knowing that a book is part of LNCS is less important.

What about:

Suggested change
series : Option ((Doc.Inline Manual) × Int) := none
/-- Volume in a multi-volume work -/
volume : Option Nat
/-- Series name and position within it, e.g. "Great Lectures in Mathematics 47"
series : Option ((Doc.Inline Manual) × Int) := none

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't have great opinion, so if it is more suitable (like bibtex), I'll change.

| thesis : Thesis → Citable
| arXiv : ArXiv → Citable
| article : Article → Citable
| book : Book → Citable
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is fine, but I do feel like this datatype is getting out of hand and it will soon be time to find an open representation here rather than the current one. A type class, perhaps.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(this is not something for you to do, unless you're inspired)

@david-christiansen
Copy link
Collaborator

Thanks!

@SnO2WMaN
Copy link
Contributor Author

SnO2WMaN commented Jul 6, 2025

Sorry for lating to reply for reviewing. I'll fix

@SnO2WMaN
Copy link
Contributor Author

SnO2WMaN commented Oct 8, 2025

I can't spare time to fix this issue so I closed this PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants