Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Develop ebdb-print or similar replacement for bbdb-print #68

Open
swflint opened this issue May 23, 2018 · 5 comments
Open

Develop ebdb-print or similar replacement for bbdb-print #68

swflint opened this issue May 23, 2018 · 5 comments

Comments

@swflint
Copy link
Contributor

swflint commented May 23, 2018

Feature request. Let me know how I can help -- I'm more than willing.

@girzel
Copy link
Owner

girzel commented May 23, 2018

That would make a tex/latex version of the records for conversion to PDF, right?

The framework for that is already in place, though in EBDB it's referred to as "formatting" -- you "format" records as text, csv, HTML, LaTeX, etc.

I haven't gone and written formatters for HTML or LaTeX because 1) there are still some complications with the formatting process that I'd like to simplify, namely I want to drop the distinction between formatting a record "header" and record "body", and just have one function for the whole record; and 2) I don't know how to hit the right level of customizability. You could write a LaTeX formatter for EBDB right now, using the existing tools, and it would be wonderful and cleanly abstracted and non-hacky, but it would be an enormous amount of code, and you'd basically have to design the entire process yourself: what person records would look like, what organization records would look like, how each field type would be formatted, etc. Each of these aspects would require you to write a generic function to output the text.

That's an awful lot of work, and not something I would expect users to go through. On the other hand, if I provide a default output, users are obviously going to want to tweak that output, and how do we design something that can be easily tweaked rather than requiring users to throw away the default and start all over again?

So I guess my question to you is, what kind of template would you like to see, and how customizable should it be? How would you like to be able to tweak the output?

Once I've fixed the header/body separation, I would be ready to start writing some default formatters for HTML and LaTeX, but the question of tweaking still remains...

@girzel
Copy link
Owner

girzel commented May 23, 2018

I guess my main question is, should I try to use the customize route to give users ways of altering the output, or is it reasonable to ask them to to write generic functions (given sufficient documentation, of course)?

@swflint
Copy link
Contributor Author

swflint commented May 23, 2018

Honestly, I'd say use the template that bbdb-print uses. It's fairly compact, and it includes a fair amount of information.

@girzel
Copy link
Owner

girzel commented May 24, 2018

Okay, I'll take a look at the output of that, and do something similar for EBDB, and then we can go from there.

@girzel
Copy link
Owner

girzel commented Dec 30, 2018

Some work done on this in eec63c8...

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

No branches or pull requests

2 participants