Authors list
  • Vote Up0Vote Down Tomi ToivioTomi Toivio
    Posts: 46Member
    Hi,

    I still haven't been able to figure out how the automatic authors list works.

    Is anybody able to help with this?

    Regards
    Tomi
  • 18 Comments sorted by
  • Vote Up0Vote Down Aleksandar ErkalovićAleksandar Erkalović
    Posts: 207Member
    There is a macro for this. You just write ##AUTHORS## somewhere in chapter (output can be customized a bit). List of authors will not be visible in editor but is visible if you go to draft or published version of a chapter.
  • Vote Up0Vote Down Tomi ToivioTomi Toivio
    Posts: 46Member
    Ah, thanks! I was thinking it should be something like {{ authors }}... ;)
  • Vote Up0Vote Down adamadam
    Posts: 88Member
    Actually Tomi if you felt like another commit then more config options on this macro would be good to control the formatting and types of data displayed
  • Vote Up0Vote Down Tomi ToivioTomi Toivio
    Posts: 46Member
    Probably should just do more content for a couple of months, but let us see... ;)
  • Vote Up0Vote Down adamadam
    Posts: 88Member
    ok!

    if you do get to it give me a ping i have some ideas on how it could be extended


    adam
  • Vote Up0Vote Down Sean ParsonsSean Parsons
    Posts: 4Member
    When I tried adding ##AUTHORS## to a document I ended up getting a lengthy changelog instead of a list of authors. Also, when I create an EPUB version of the book, various epub readers all determine the Author to be 'The Contributors'.

    What should I be doing differently?

    Thanks in advance for any reply.
  • Vote Up0Vote Down adamadam
    Posts: 88Member
    hi Sean,

    Authors macro needs a lot more sophistication. If you would like to document how you would like to see it work please make a ticket here:

    As for the epub - can you send a link to this epub and explain exactly where it says contributors?


    adam
  • Vote Up0Vote Down Tomi ToivioTomi Toivio
    Posts: 46Member
    What kind of changes were needed for the Authors list? 
  • Vote Up0Vote Down adamadam
    Posts: 88Member
    I would say there needs to be an option to list :
    1) attribution for the entire book per chapter (as it is now)
    2) attribution for the entire book as a single list of names
    3) attribution for a single chapter 

    Plus:
    a) attribution of only the copyright holders for each of the above
    b) possibility to add dates for each attribution for each of the above
    b) ability to format the output of each of the above (on single line, in list, use of brackets etc)

    that would be a good start

    adam

  • Vote Up0Vote Down Tomi ToivioTomi Toivio
    Posts: 46Member
    I immediately got sidetracked here.

    I was looking at microformats (especially Schema.org) and they cannot handle a book properly. Seemingly a book (http://schema.org/Book) is more like a product you can buy while an article is something that has content you can actually read online.

    Seemingly Schema.org can handle authorship, but it cannot understand the concept of online books.
  • Vote Up0Vote Down Sean ParsonsSean Parsons
    Posts: 4Member
    Adam,

    I find that when I unzip the epub the content.opf file lists the author(s) in the following line:
        <dc:creator>The Contributors</dc:creator>

    Maybe my problem is related to using booki.cc as I don't have sufficient access to my shared hosting provider to add install booktype on my own server, but I would have expected an individual user account to have been sufficient to be listed as author on a book created by that account.

    Here is a link to an epub for what I have done so far with this book:

    Thanks,
    Sean
  • Vote Up0Vote Down Aleksandar ErkalovićAleksandar Erkalović
    Posts: 207Member
    "The Contributors" is hard coded author at the moment. Problem is that all of the books on the Flossmanuals site (where it all started) were written by multiple authors and there was no interface to change specific author. Until now! :) I am working at the moment on this interface for one of the customers and i think it will be integrated at one point into vanilla Booktype.
  • Vote Up0Vote Down Tomi ToivioTomi Toivio
    Posts: 46Member
    I love this stuff.

    Apparently Google can recognize the authors IF you add a link to the author's Google Plus profile: http://support.google.com/webmasters/bin/answer.py?hl=en&answer=1408986

    Wanna add a form for everybody to add their Google Plus profile for the authors list? Maybe not? :)


  • Vote Up0Vote Down adamadam
    Posts: 88Member
    i would go with the not ;)
  • Vote Up0Vote Down Tomi ToivioTomi Toivio
    Posts: 46Member
    Yeah, it might be a privacy problem. And I don't know if so many people do actually have Google Plus profiles.
  • Vote Up0Vote Down adamadam
    Posts: 88Member
    also we dont want bootkype to rely on external services if possible. We could end up maintaining too many external API stuff when we dont need it
  • Vote Up0Vote Down Tomi ToivioTomi Toivio
    Posts: 46Member
    Actually it would be hard to do something like that so that it would work in every Booktype installation. Or which external services different installations would like to use.

    I don't even know yet if the Finnish FLOSS Manuals Booktype needs some external communication channel or not.
  • Vote Up0Vote Down Tomi ToivioTomi Toivio
    Posts: 46Member
    Not much progress with this.

    I have only been testing Schema.org semantic markup in the authors list and various other parts of Booktype. It just takes forever since you have to wait for Google to crawl and index the site to see if it has any effect. Google.fi doesn't actually support it yet, so it is quite useless on a Finnish site. And it wants dates in a non-localized format, which pretty much makes it unusable on non-English sites.

    Apparently many semantic markup formats (like FOAF, which is still offered by Identi.ca) have been abandoned, since you need major search engines to support them for them to be widely adapted. At least Schema.org is supposed to have long-term support by Google, Bing and Yandex, so it would make some sense to use that for things like author information.

    (Talking about search engines I really like the open source P2P search engine YaCy, but currently it always crashes on my Linux after a few hours, probably has something to do with Java.)

    I don't know about that Dublin Core markup used by the ePub files, never even noticed that the metadata you can edit in the Booktype admin interface is actually used somewhere. Apparently Google doesn't support DC it any more? Which format of metadata would be supported by both search engines and ePub readers?
Add a Comment