| Message ID | 4jhiBWvAzsdTXmZFj_GgZTPWkIZncoQeId2pbbzXXMRNFk0FPGJXxIrp8ysGXNwuZk54pS5l5Ba2jkRcqE8omsfVgItw1gMcDJW1tqMPn-M=@protonmail.com |
|---|---|
| State | Accepted |
| Headers | show |
| Series | [bug#48637] website: Add publications page | expand |
The patch looks good, but how would people out of science understand what's a conference paper, or the difference between an article and a journal article? Are there better terms? Le 2 juin 2021 15:31:50 GMT-04:00, Luis Felipe via Guix-patches via <guix-patches@gnu.org> a écrit : >Hey, > >On Friday, May 28, 2021 11:06 AM, Ludovic Courtès <ludo@gnu.org> wrote: > >> I see that you want to keep it open to non-academic publications, >which >> is a good idea. I wonder if there should be a visual distinction >> between peer-reviewed scientific articles, journal articles, and >other >> types of publications? >> >> I started adding historical LWN articles (patch below; the titles >look >> funny in hindsight :-)), and wondered whether this was a good idea >since >> they would come first in the list. >> >> Thoughts? > > >Here is a patch that adds publication types.
On Wednesday, June 2, 2021 8:28 PM, Julien Lepiller <julien@lepiller.eu> wrote:
> The patch looks good, but how would people out of science understand what's a conference paper, or the difference between an article and a journal article? Are there better terms?
I don't know. As an outsider those terms sound alright to me :) And maybe when people click on the links the difference becomes clearer. But yeah, I don't know :)
Ah, it's fine, I don't mean to delay applying the patch if the terms are good enough :) Le 2 juin 2021 17:52:13 GMT-04:00, Luis Felipe <luis.felipe.la@protonmail.com> a écrit : >On Wednesday, June 2, 2021 8:28 PM, Julien Lepiller ><julien@lepiller.eu> wrote: > >> The patch looks good, but how would people out of science understand >what's a conference paper, or the difference between an article and a >journal article? Are there better terms? > >I don't know. As an outsider those terms sound alright to me :) And >maybe when people click on the links the difference becomes clearer. >But yeah, I don't know :)
Hello! Luis Felipe <luis.felipe.la@protonmail.com> skribis: > On Friday, May 28, 2021 11:06 AM, Ludovic Courtès <ludo@gnu.org> wrote: > >> I see that you want to keep it open to non-academic publications, which >> is a good idea. I wonder if there should be a visual distinction >> between peer-reviewed scientific articles, journal articles, and other >> types of publications? [...] > From ef4e97ec9a49e65d70c9ba8d4c1926b2eeec2cba Mon Sep 17 00:00:00 2001 > From: Luis Felipe <luis.felipe.la@protonmail.com> > Date: Wed, 2 Jun 2021 14:17:03 -0500 > Subject: [PATCH] website: publications: Add publication type. > > * website/apps/media/types.scm (<publication>): Add "type" field. > * website/apps/media/data.scm (publications): Specify publication types. > * website/apps/media/templates/components.scm (publication->shtml): Show > publication type. Pushed, thanks! Julien Lepiller <julien@lepiller.eu> skribis: > The patch looks good, but how would people out of science understand what's a conference paper, or the difference between an article and a journal article? Are there better terms? I was wondering whether we should just distinguish between “scientific papers” (peer-reviewed, be it conference papers, journals, or book chapters) and other publications. Perhaps a visual cue for scientific publications, such as an English graduate cap, would be enough? Ludo’.
Yeah, good idea, though we need to make it accessible (alt="scientific" or something). Le 3 juin 2021 05:40:49 GMT-04:00, "Ludovic Courtès" <ludo@gnu.org> a écrit : >Hello! > >Luis Felipe <luis.felipe.la@protonmail.com> skribis: > >> On Friday, May 28, 2021 11:06 AM, Ludovic Courtès <ludo@gnu.org> >wrote: >> >>> I see that you want to keep it open to non-academic publications, >which >>> is a good idea. I wonder if there should be a visual distinction >>> between peer-reviewed scientific articles, journal articles, and >other >>> types of publications? > >[...] > >> From ef4e97ec9a49e65d70c9ba8d4c1926b2eeec2cba Mon Sep 17 00:00:00 >2001 >> From: Luis Felipe <luis.felipe.la@protonmail.com> >> Date: Wed, 2 Jun 2021 14:17:03 -0500 >> Subject: [PATCH] website: publications: Add publication type. >> >> * website/apps/media/types.scm (<publication>): Add "type" field. >> * website/apps/media/data.scm (publications): Specify publication >types. >> * website/apps/media/templates/components.scm (publication->shtml): >Show >> publication type. > >Pushed, thanks! > >Julien Lepiller <julien@lepiller.eu> skribis: > >> The patch looks good, but how would people out of science understand >what's a conference paper, or the difference between an article and a >journal article? Are there better terms? > >I was wondering whether we should just distinguish between “scientific >papers” (peer-reviewed, be it conference papers, journals, or book >chapters) and other publications. > >Perhaps a visual cue for scientific publications, such as an English >graduate cap, would be enough? > >Ludo’.
On Thursday, June 3, 2021 10:37 AM, Julien Lepiller <julien@lepiller.eu> wrote:
> Yeah, good idea, though we need to make it accessible (alt="scientific" or something).
So, a publication is either scientific or not, right? So just add "publication-scientific?", right?
Luis Felipe <luis.felipe.la@protonmail.com> skribis: > On Thursday, June 3, 2021 10:37 AM, Julien Lepiller <julien@lepiller.eu> wrote: > >> Yeah, good idea, though we need to make it accessible (alt="scientific" or something). > > So, a publication is either scientific or not, right? So just add "publication-scientific?", right? We can keep the categories you added, but I suppose only scientists care about the difference between “conference article” and “journal article”. :-) For the rest of us, “academic” vs. “non-academic” is probably what matters, and this is where a visual cue could help. WDYT? Ludo’.
On Thursday, June 3, 2021 8:37 PM, Ludovic Courtès <ludo@gnu.org> wrote: > Luis Felipe luis.felipe.la@protonmail.com skribis: > > > On Thursday, June 3, 2021 10:37 AM, Julien Lepiller julien@lepiller.eu wrote: > > > > > Yeah, good idea, though we need to make it accessible (alt="scientific" or something). > > > > So, a publication is either scientific or not, right? So just add "publication-scientific?", right? > > We can keep the categories you added, but I suppose only scientists care > about the difference between “conference article” and “journal article”. > :-) For the rest of us, “academic” vs. “non-academic” is probably what > matters, and this is where a visual cue could help. > > WDYT? So, you mean something like the following would suffice? https://luis-felipe.gitlab.io/media/2021/06/guix-academic-publications-2021-06-03%2016-39-11.png Personally, I'm fine with or without any of these distinctions because once you click on an article you can see how formal the article is. But I can provide a patch to make things look like in the image.
Hi, Luis Felipe <luis.felipe.la@protonmail.com> skribis: > So, you mean something like the following would suffice? > > https://luis-felipe.gitlab.io/media/2021/06/guix-academic-publications-2021-06-03%2016-39-11.png Yes. > I went ahead and added that "publication-scientific?" field and the suggested cap to scientific publications (patch attached). Let me know what you think. Awesome, pushed! Thanks for the quick reply and pleasant result! Ludo’.
From ef4e97ec9a49e65d70c9ba8d4c1926b2eeec2cba Mon Sep 17 00:00:00 2001 From: Luis Felipe <luis.felipe.la@protonmail.com> Date: Wed, 2 Jun 2021 14:17:03 -0500 Subject: [PATCH] website: publications: Add publication type. * website/apps/media/types.scm (<publication>): Add "type" field. * website/apps/media/data.scm (publications): Specify publication types. * website/apps/media/templates/components.scm (publication->shtml): Show publication type. --- website/apps/media/data.scm | 21 ++++++++++++++------- website/apps/media/templates/components.scm | 8 +++++--- website/apps/media/types.scm | 15 +++++++++++---- 3 files changed, 30 insertions(+), 14 deletions(-) diff --git a/website/apps/media/data.scm b/website/apps/media/data.scm index fc7854e..812f9e3 100644 --- a/website/apps/media/data.scm +++ b/website/apps/media/data.scm @@ -105,40 +105,47 @@ distribution.")) #:title "Functional Package Management with Guix" #:url "https://arxiv.org/abs/1305.4584" #:authors "Ludovic Courtès" - #:date (string->date "2013-05-20" "~Y-~m-~d")) + #:date (string->date "2013-05-20" "~Y-~m-~d") + #:type (C_ "publication type" "Conference paper")) (publication #:title "Reproducible and User-Controlled Software Environments in HPC with Guix" #:url "https://hal.inria.fr/hal-01161771/en" #:authors (G_ "Ludovic Courtès, Ricardo Wurmus") - #:date (string->date "2015-07-25" "~Y-~m-~d")) + #:date (string->date "2015-07-25" "~Y-~m-~d") + #:type (C_ "publication type" "Conference paper")) (publication #:title "Code Staging in GNU Guix" #:url "https://arxiv.org/abs/1709.00833" #:authors "Ludovic Courtès" - #:date (string->date "2017-09-04" "~Y-~m-~d")) + #:date (string->date "2017-09-04" "~Y-~m-~d") + #:type (C_ "publication type" "Conference paper")) (publication #:title "Scientific Data Analysis Pipelines and Reproducibility" #:authors "Altuna Akalin" #:url "https://towardsdatascience.com/scientific-data-analysis-pipelines-and-reproducibility-75ff9df5b4c5" - #:date (string->date "2018-10-01" "~Y-~m-~d")) + #:date (string->date "2018-10-01" "~Y-~m-~d") + #:type (C_ "publication type" "Article")) (publication #:title "Reproducible Genomics Analysis Pipelines with GNU Guix" #:url "http://dx.doi.org/10.1093/gigascience/giy123" #:authors "Ricardo Wurmus, Bora Uyar, Brendan Osberg, Vedran Franke, \ Alexander Gosdschan, Katarzyna Wreczycka, Jonathan Ronen, Altuna Akalin" - #:date (string->date "2018-10-02" "~Y-~m-~d")) + #:date (string->date "2018-10-02" "~Y-~m-~d") + #:type (C_ "publication type" "Journal article")) (publication #:title "Guix: A most advanced operating system" #:url "https://ambrevar.xyz/guix-advance/index.html" #:authors "Pierre Neidhardt" - #:date (string->date "2019-01-14" "~Y-~m-~d")) + #:date (string->date "2019-01-14" "~Y-~m-~d") + #:type (C_ "publication type" "Article")) (publication #:title "Scalable Workflows and Reproducible Data Analysis for Genomics" #:url "https://link.springer.com/protocol/10.1007%2F978-1-4939-9074-0_24" #:authors "Francesco Strozzi, Roel Janssen, Ricardo Wurmus, \ Michael R. Crusoe, George Githinji, Paolo Di Tommaso, Dominique Belhachemi, \ Steffen Möller, Geert Smant, Joep de Ligt, Pjotr Prins" - #:date (string->date "2019-07-06" "~Y-~m-~d")))) + #:date (string->date "2019-07-06" "~Y-~m-~d") + #:type (C_ "publication type" "Book chapter")))) (define screenshots diff --git a/website/apps/media/templates/components.scm b/website/apps/media/templates/components.scm index ce9d944..20fa3a9 100644 --- a/website/apps/media/templates/components.scm +++ b/website/apps/media/templates/components.scm @@ -46,9 +46,11 @@ (p (@ (class "publication-info")) - ;; TRANSLATORS: <1/> is a date, and <2/> a list of authors. - ,(G_ `("Published " ,date " by " - ,(publication-authors publication) "")))))) + ;; TRANSLATORS: <1/> is a publication type, <2/> is a date, and + ;; <3/> is a list of authors. + ,(G_ + `("" ,(publication-type publication) ". Published " ,date + " by " ,(publication-authors publication) ". ")))))) (define (screenshot->shtml shot) diff --git a/website/apps/media/types.scm b/website/apps/media/types.scm index 579e642..2c219e5 100644 --- a/website/apps/media/types.scm +++ b/website/apps/media/types.scm @@ -11,6 +11,7 @@ publication-date publication-language publication-title + publication-type publication-url screenshot screenshot? @@ -66,20 +67,26 @@ ;;; IETF language tag corresponding to the language in which the ;;; publication is written. ;;; +;;; type (string) +;;; The kind of publication. See the list of publications in the +;;; (apps media data) module for examples. +;;; +;;; (define-record-type <publication> - (make-publication title url authors date language) + (make-publication title url authors date language type) publication? (title publication-title) (url publication-url) (authors publication-authors) (date publication-date) - (language publication-language)) + (language publication-language) + (type publication-type)) ;;; Helper procedures. -(define* (publication #:key title url authors date (language "en")) +(define* (publication #:key title url authors date (language "en") type) "Return a <publication> object with the given attributes." - (make-publication title url authors date language)) + (make-publication title url authors date language type)) ;;; Screenshot (record type) base-commit: aa3ec5059f92ac5a0a47367cb886c87bb26d44fa -- 2.31.1