From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.text.pandoc/16182 Path: news.gmane.org!.POSTED!not-for-mail From: Kolen Cheung Newsgroups: gmane.text.pandoc Subject: Re: Building pandoc "ecosystems": package manger, "central gallery", "wikibook", etc.? Date: Fri, 25 Nov 2016 18:09:09 -0800 (PST) Message-ID: References: <01d303b0-f034-4065-98ca-f27314a9e308@googlegroups.com> Reply-To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="----=_Part_9273_2047575199.1480126149704" X-Trace: blaine.gmane.org 1480126159 23878 195.159.176.226 (26 Nov 2016 02:09:19 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 26 Nov 2016 02:09:19 +0000 (UTC) To: pandoc-discuss Original-X-From: pandoc-discuss+bncBCS252WXTEIBBRW54PAQKGQERTX33DQ-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Sat Nov 26 03:09:10 2016 Return-path: Envelope-to: gtp-pandoc-discuss@m.gmane.org Original-Received: from mail-yb0-f192.google.com ([209.85.213.192]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cASQN-0004LD-6g for gtp-pandoc-discuss@m.gmane.org; Sat, 26 Nov 2016 03:09:07 +0100 Original-Received: by mail-yb0-f192.google.com with SMTP id v78sf14943129ybe.0 for ; Fri, 25 Nov 2016 18:09:11 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20120806; h=sender:date:from:to:message-id:in-reply-to:references:subject :mime-version:x-original-sender:reply-to:precedence:mailing-list :list-id:x-spam-checked-in-group:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=VIq+Xbg8A6nzTHlAnAhAzj5TW9hHkJi0gj2qHQITLEA=; b=sLD6O1jmWZ7gS6EBbTn62WSA947sn2ceQOR9hcTrwnIaYfUy+CCMbxvfJSOODTX3Gc L+KAlTuqEQfbnjNYpEeVtedQ+Fx0NuafW15WtJeXa2GfY/1Dxx4BX7G+eOSSdAYuPxB4 yvuX0LmqrR3hP2i4QtJ569JPV/wN8BewUGIF/ZsXCCYBM8X5ssmuWn7BtXwgqu5RyM7j EdeD2j4BimVjKmU77RCmNwssfE2t1An0Vy8MujEWiC1nXfjdmVxX+k+rf5Mjh+l2BMUq 9QXITlYh6OF3w1HUAytkZ7uqb9ScdVKnTyAuT4QjfHPRfFpEmu/RE5oEi678qG3z5L2p N80A== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=date:from:to:message-id:in-reply-to:references:subject:mime-version :x-original-sender:reply-to:precedence:mailing-list:list-id :x-spam-checked-in-group:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=VIq+Xbg8A6nzTHlAnAhAzj5TW9hHkJi0gj2qHQITLEA=; b=gVtGlf7Yyh4GIzy77ZAavmBImCiE1e760t1eb4FLfPq2eSyMnBOuWgp5h7wexVH40e LbdPxA/hV0GEAbOia8sUBK7uW2XQHvyMycGY0mFOkluSIFbO7T1MyINCDuHj4UD0Z7Js l2l0QcvofSeIRNeAAoYzs3Yqwyb+vbMOmq1o/hbJqFI9xLlKUfFxFR7+TyV1/dCgBdMJ kxR/mAtNYraOnuCE/QeuMcgXsQRi+TktnaUeEk1iC0MZIAbpaGJA2FP8y0oaXALyPr4/ sxDKSkSsnIvFaon/SaWkKw/nl1VbAynCN/a6wP+jYcfm2WF10JeCKuZGuItl6yhcz/Jh AzSg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=sender:x-gm-message-state:date:from:to:message-id:in-reply-to :references:subject:mime-version:x-original-sender:reply-to :precedence:mailing-list:list-id:x-spam-checked-in-group:list-post :list-help:list-archive:list-subscribe:list-unsubscribe; bh=VIq+Xbg8A6nzTHlAnAhAzj5TW9hHkJi0gj2qHQITLEA=; b=Szovpv0F5f/uUp5pAxbKUhHNOqYxajvSVZYm02Ls2OT98nru520KiTavYSK8LufWT/ +DEuglEW7k5YqqF16k3kuKFKmez5Mzhh3/TjeUg9IybGoCQFpSoSnGQFnsPBYhnS5OPj K9koEns0RAvHseyu1nFTD5VaVglTeYlclU7sgbSwDxWnEQygNKXqaEg5KqgVAYU3+dwo wii135vJZKbHxCUdLnE0cpM15MJRLMYGhSnauRVqscJAHE5p9ZVU3U3/bibY70kIm1va C7BVmrOH4901IlyATRoThIlFpw9WjevooRfl/Sn1S6c7Uk8CnojyOYzCEUcmPy5YVIdk 30Jg== Original-Sender: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org X-Gm-Message-State: AKaTC00GHf5VWjVLh/LEP8BuIj1CYY1AZxaoipf+jbTrTOmaHxgSWPHOvB5kRJtpAJ8NXg== X-Received: by 10.157.15.143 with SMTP id d15mr283005otd.2.1480126150823; Fri, 25 Nov 2016 18:09:10 -0800 (PST) X-BeenThere: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Original-Received: by 10.157.54.10 with SMTP id w10ls6099741otb.1.gmail; Fri, 25 Nov 2016 18:09:10 -0800 (PST) X-Received: by 10.157.48.39 with SMTP id d36mr280643otc.1.1480126150239; Fri, 25 Nov 2016 18:09:10 -0800 (PST) In-Reply-To: <01d303b0-f034-4065-98ca-f27314a9e308-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org> X-Original-Sender: christian.kolen-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org Precedence: list Mailing-list: list pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org; contact pandoc-discuss+owners-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org List-ID: X-Google-Group-Id: 1007024079513 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , Xref: news.gmane.org gmane.text.pandoc:16182 Archived-At: ------=_Part_9273_2047575199.1480126149704 Content-Type: multipart/alternative; boundary="----=_Part_9274_2064020430.1480126149704" ------=_Part_9274_2064020430.1480126149704 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Concerning the =E2=80=9Cwikibook=E2=80=9D part: Since the idea of using gitit doesn=E2=80=99t work, I=E2=80=99m now thinkin= g about using=20 ghpages for this task. The main points are: -=20 =20 blog:=20 -=20 =20 rather than wiki, it will be more like a blog -=20 =20 the blog posts will be =E2=80=9Cheavily=E2=80=9D tagged and categoriz= ed, for easier=20 discoveries and better organization. e.g. each filter currently docum= ented=20 in pandoc=E2=80=99s wiki might turned into a blog post will a bunch o= f tags, and=20 the category =E2=80=9Cfilters=E2=80=9D. Note that this is independent= with the =E2=80=9Cgallery=E2=80=9D=20 idea since that would probably be auto-generated. -=20 =20 ghpages is chosen so it is easier for pull request, the only thing a= =20 guest post needed is the content in GFM (no pandoc markdown, however)= , and=20 a pull request (inspired by DesignOpen/designopen.github.io=20 ) -=20 =20 hosting: GitHub. Also see if @jgm is interested to link from=20 pandoc.org=E2=80=99s current =E2=80=9CExtras=E2=80=9D on the left, or ev= en use the pandoc.org=20 domain (e.g. users seeing pandoc.org/extras/index.html, which is actuall= y=20 from pandoc-extras.github.io/index.html). This might be controversial, b= ut=20 note that currently pandoc.org=E2=80=99s =E2=80=9CExtras=E2=80=9D linkin= g to GitHub=E2=80=99s wiki is=20 opened to =E2=80=9Cattack=E2=80=9D for any GitHub users. -=20 =20 info from pandoc-extras & pandoc-filters in pandoc=E2=80=99s current wik= i can=20 either be ported/mirrored, depending on the last point. -=20 =20 license: open for discussion. CC? (seems good for collaboration and=20 guest posts. Alternatively, each guest can just hold their own copyright= . I=20 don=E2=80=99t know which one gives more incentives for guest posts.) Ano= ther point=20 to note: I probably will put on a tip jar. -=20 =20 search: Google search is much easier to setup, especially for static=20 site. But for sites that has low traffics (which probably is going to be= =20 true for this site), Google=E2=80=99s search might take a long time to u= pdate. An=20 alternative will be lunr.js. It won=E2=80=99t be complied on pull reques= t however.=20 (In principle Travis can be used, but pure ghpages might be easier for t= his=20 small site.) =20 =E2=80=8B --=20 You received this message because you are subscribed to the Google Groups "= pandoc-discuss" group. To unsubscribe from this group and stop receiving emails from it, send an e= mail to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org To view this discussion on the web visit https://groups.google.com/d/msgid/= pandoc-discuss/d09ff929-8807-44ac-91db-35f1d9b70491%40googlegroups.com. For more options, visit https://groups.google.com/d/optout. ------=_Part_9274_2064020430.1480126149704 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable

Concerning the =E2=80=9Cwikibook=E2=80=9D part:

Since the idea of using giti= t doesn=E2=80=99t work, I=E2=80=99m now thinking about using ghpages for th= is task. The main points are:

  • blog:

    • rather than wiki, it will be more like a = blog

    • the blog posts will be =E2=80=9Cheavily= =E2=80=9D tagged and categorized, for easier discoveries and better organiz= ation. e.g. each filter currently documented in pandoc=E2=80=99s wiki might= turned into a blog post will a bunch of tags, and the category =E2=80=9Cfi= lters=E2=80=9D. Note that this is independent with the =E2=80=9Cgallery=E2= =80=9D idea since that would probably be auto-generated.

    • ghpages is chosen so it is easier for pul= l request, the only thing a guest post needed is the content in GFM (no pan= doc markdown, however), and a pull request (inspired by DesignOpen/designopen.github.io= )

  • hosting: GitHub. Also see if @jgm is inte= rested to link from pandoc.org=E2=80=99s current =E2=80=9CExtras=E2=80=9D o= n the left, or even use the pandoc.org domain (e.g. users seeing pandoc.org= /extras/index.html, which is actually from pandoc-extras.github.io/index.ht= ml). This might be controversial, but note that currently pandoc.org=E2=80= =99s =E2=80=9CExtras=E2=80=9D linking to GitHub=E2=80=99s wiki is opened to= =E2=80=9Cattack=E2=80=9D for any GitHub users.

  • info from pandoc-extras & pandoc-filt= ers in pandoc=E2=80=99s current wiki can either be ported/mirrored, dependi= ng on the last point.

  • license: open for discussion. CC? (seems = good for collaboration and guest posts. Alternatively, each guest can just = hold their own copyright. I don=E2=80=99t know which one gives more incenti= ves for guest posts.) Another point to note: I probably will put on a tip j= ar.

  • search: Google search is much easier to s= etup, especially for static site. But for sites that has low traffics (whic= h probably is going to be true for this site), Google=E2=80=99s search migh= t take a long time to update. An alternative will be lunr.js. It won=E2=80= =99t be complied on pull request however. (In principle Travis can be used,= but pure ghpages might be easier for this small site.)

=E2=80=8B

--
You received this message because you are subscribed to the Google Groups &= quot;pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an e= mail to pand= oc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org.
To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org.
To view this discussion on the web visit https://groups.google.com/d/= msgid/pandoc-discuss/d09ff929-8807-44ac-91db-35f1d9b70491%40googlegroups.co= m.
For more options, visit http= s://groups.google.com/d/optout.
------=_Part_9274_2064020430.1480126149704-- ------=_Part_9273_2047575199.1480126149704--