NYC DH Week

NYC DH Week

[John Muccigrosso]

[-- Attachment #1.1: Type: text/plain, Size: 962 bytes --]

pandockers,

(Thought I might have coined a phrase, but I see it's been used a couple of 
times. @jgm, you should ™ that.)

I just found out that I'm doing a workshop at the NYC DH week in a month 
(Feb 9, 1-3pm, to be precise). I've called it "Making the most of text: 
Using a text-only workflow with markdown and pandoc".

Any suggestions/tips gratefully appreciated.

-- 
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 email 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/f48ee0d0-45bb-4d1b-8632-5a9817a10e6b%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #1.2: Type: text/html, Size: 1459 bytes --]

Re: NYC DH Week

[Fernando Botelho]

Please share the Youtube link when it becomes available.


Fernando



On 01/05/2017 05:07 PM, John Muccigrosso wrote:
> pandockers,
>
> (Thought I might have coined a phrase, but I see it's been used a 
> couple of times. @jgm, you should ™ that.)
>
> I just found out that I'm doing a workshop at the NYC DH week in a 
> month (Feb 9, 1-3pm, to be precise). I've called it "Making the most 
> of text: Using a text-only workflow with markdown and pandoc".
>
> Any suggestions/tips gratefully appreciated.
> -- 
> 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 email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org 
> <mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>.
> To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org 
> <mailto:pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>.
> To view this discussion on the web visit 
> https://groups.google.com/d/msgid/pandoc-discuss/f48ee0d0-45bb-4d1b-8632-5a9817a10e6b%40googlegroups.com 
> <https://groups.google.com/d/msgid/pandoc-discuss/f48ee0d0-45bb-4d1b-8632-5a9817a10e6b%40googlegroups.com?utm_medium=email&utm_source=footer>.
> For more options, visit https://groups.google.com/d/optout.

-- 
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 email 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/b8152a1f-cc95-0121-2f4f-90dcd2ddb567%40F123.org.
For more options, visit https://groups.google.com/d/optout.

Re: NYC DH Week

[Albert Krewinkel]

John Muccigrosso <jmuccigr-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:

> pandockers,
>
> (Thought I might have coined a phrase, but I see it's been used a couple of
> times. @jgm, you should ™ that.)
>
> I just found out that I'm doing a workshop at the NYC DH week in a month (Feb 9,
> 1-3pm, to be precise). I've called it "Making the most of text: Using a
> text-only workflow with markdown and pandoc".
>
> Any suggestions/tips gratefully appreciated.

Maybe this paper (well, preprint) is of interest to you. It's written
with computer- and natural science in mind, but might still contain some
useful info: "Formatting Open Science: agile creation of multiple
document types by writing academic manuscripts in pandoc markdown"
https://peerj.com/preprints/2648/

The corresponding git repo is here:
https://github.com/robert-winkler/scientific-articles-markdown

I'm still working on the lua scripts to make metadata handling as simple
as possible.

Feedback is of course very welcome.

-- 
Albert Krewinkel
GPG: 8eed e3e2 e8c5 6f18 81fe  e836 388d c0b2 1f63 1124

-- 
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 email 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/878tqp8alh.fsf%40espresso.zeitkraut.de.
For more options, visit https://groups.google.com/d/optout.

Re: NYC DH Week

[John Muccigrosso]

[-- Attachment #1.1: Type: text/plain, Size: 660 bytes --]

Thanks. I should add that this will be aimed at beginners, but we'll see 
who shows up.

-- 
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 email 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/70b111ff-2afd-4d57-a0bf-954381198e5b%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #1.2: Type: text/html, Size: 1075 bytes --]

Re: NYC DH Week

[BPJ]

[-- Attachment #1: Type: text/plain, Size: 1698 bytes --]

I suppose you already have looked at the tutorials/introd listed on the
wiki?

https://github.com/jgm/pandoc/wiki/Documentation-and-Tutorials

fre 6 jan. 2017 kl. 03:11 skrev John Muccigrosso <jmuccigr-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>:

> Thanks. I should add that this will be aimed at beginners, but we'll see
> who shows up.
>
>
>
>
>
>
>
>
> --
>
>
> 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
> email 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/70b111ff-2afd-4d57-a0bf-954381198e5b%40googlegroups.com
> <https://groups.google.com/d/msgid/pandoc-discuss/70b111ff-2afd-4d57-a0bf-954381198e5b%40googlegroups.com?utm_medium=email&utm_source=footer>
> .
>
>
> For more options, visit https://groups.google.com/d/optout.
>
>
>

-- 
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 email 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/CADAJKhAWtOiRzYa_gb8zkQbF4T4DRQvYw4XM8Hh536Kgxg6c_Q%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #2: Type: text/html, Size: 3019 bytes --]

Re: NYC DH Week

[Scot Mcphee]

[-- Attachment #1: Type: text/plain, Size: 2060 bytes --]



> On 06 Jan 2017, at 05:07 , John Muccigrosso <jmuccigr-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:
> 
> pandockers,
> 
> (Thought I might have coined a phrase, but I see it's been used a couple of times. @jgm, you should ™ that.)
> 
> I just found out that I'm doing a workshop at the NYC DH week in a month (Feb 9, 1-3pm, to be precise). I've called it "Making the most of text: Using a text-only workflow with markdown and pandoc".
> 
> Any suggestions/tips gratefully appreciated.

Hi John

What sort of suggestions were you after. I do quite a lot of DH in Classics on the programming side, but my thesis (which is not DH-based, but straight classics/ancient history) is fully written in pandoc style markdown. Classics has been using digital tools a lot longer than most other humanities disciplines (witness Perseus), because of its long relationship with philology, linguistics, and use of tools like concordances.

Whenever I strike my fellow postgrads struggling with Word issues, I keep telling people to use markdown to write their thesis in markdown. They freak out. They think it’s difficult, when a thesis document nearly all text and simple to write in markdown. Our systems pretty much train them in undergraduate courses to use Word and never let up from that point.

Scot.

--
Scot Mcphee
Computer Programmer, Classics PhD.
p +61 412 957414
e scot.mcphee-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org
w http://autonomous.org/
t @scotartt

-- 
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 email 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/890F613E-F940-4468-A73C-326CA07C479E%40gmail.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #2: Type: text/html, Size: 3750 bytes --]

Re: NYC DH Week

[John Muccigrosso]

[-- Attachment #1.1: Type: text/plain, Size: 2793 bytes --]

On Saturday, January 7, 2017 at 7:45:39 AM UTC-5, Scot Mcphee wrote:
>
>
> On 06 Jan 2017, at 05:07 , John Muccigrosso <jmuc...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org 
> <javascript:>> wrote:
>
> pandockers,
>
> (Thought I might have coined a phrase, but I see it's been used a couple 
> of times. @jgm, you should ™ that.)
>
> I just found out that I'm doing a workshop at the NYC DH week in a month 
> (Feb 9, 1-3pm, to be precise). I've called it "Making the most of text: 
> Using a text-only workflow with markdown and pandoc".
>
> Any suggestions/tips gratefully appreciated.
>
>
> Hi John
>
> What sort of suggestions were you after. I do quite a lot of DH in 
> Classics on the programming side, but my thesis (which is not DH-based, but 
> straight classics/ancient history) is fully written in pandoc style 
> markdown. Classics has been using digital tools a lot longer than most 
> other humanities disciplines (witness Perseus), because of its long 
> relationship with philology, linguistics, and use of tools like 
> concordances.
>
> Whenever I strike my fellow postgrads struggling with Word issues, I keep 
> telling people to use markdown to write their thesis in markdown. They 
> freak out. They think it’s difficult, when a thesis document nearly all 
> text and simple to write in markdown. Our systems pretty much train them in 
> undergraduate courses to use Word and never let up from that point.
>
> Scot.
>
> --
> Scot Mcphee
> Computer Programmer, Classics PhD.
> p +61 412 957414
> e scot....-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org <javascript:>
> w http://autonomous.org/ 
> <http://www.google.com/url?q=http%3A%2F%2Fautonomous.org%2F&sa=D&sntz=1&usg=AFQjCNEzdj0qs9dNerErHk6s2pPFXLNSAQ>
> t @scotartt
>

Scott,

I'm looking for whatever people have found useful when introducing the 
concept of a text-only workflow to academics, and then adding the pandoc 
icing on the cake.

So it's wide open. :-)

I expect most people to be beginners or even completely new to the idea, 
though they will sign up for the workshop and so be self-selected, which 
should mean that they are at least open to the idea.

So fire away.

-- 
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 email 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/0f45a959-6d8b-4fa6-bc9e-541cd62976b0%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #1.2: Type: text/html, Size: 4649 bytes --]

Re: NYC DH Week

[Scot Mcphee]

[-- Attachment #1: Type: text/plain, Size: 4870 bytes --]



On 10 January 2017 at 04:12, John Muccigrosso <jmuccigr-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org <mailto:jmuccigr-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>> wrote:
On Saturday, January 7, 2017 at 7:45:39 AM UTC-5, Scot Mcphee wrote:

> On 06 Jan 2017, at 05:07 , John Muccigrosso <jmuc...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org <>> wrote:
> 
> pandockers,
> 
> (Thought I might have coined a phrase, but I see it's been used a couple of times. @jgm, you should ™ that.)
> 
> I just found out that I'm doing a workshop at the NYC DH week in a month (Feb 9, 1-3pm, to be precise). I've called it "Making the most of text: Using a text-only workflow with markdown and pandoc".
> 
> Any suggestions/tips gratefully appreciated.

Hi John

What sort of suggestions were you after. I do quite a lot of DH in Classics on the programming side, but my thesis (which is not DH-based, but straight classics/ancient history) is fully written in pandoc style markdown. Classics has been using digital tools a lot longer than most other humanities disciplines (witness Perseus), because of its long relationship with philology, linguistics, and use of tools like concordances.

Whenever I strike my fellow postgrads struggling with Word issues, I keep telling people to use markdown to write their thesis in markdown. They freak out. They think it’s difficult, when a thesis document nearly all text and simple to write in markdown. Our systems pretty much train them in undergraduate courses to use Word and never let up from that point.

Scot.


Scott,

I'm looking for whatever people have found useful when introducing the concept of a text-only workflow to academics, and then adding the pandoc icing on the cake.

So it's wide open. :-)

I expect most people to be beginners or even completely new to the idea, though they will sign up for the workshop and so be self-selected, which should mean that they are at least open to the idea.

So fire away.

John

In the main, I find the following arguments have worked to more or less some degree:

In the Humanities you don't need a lot of formatting: titles, headers, italics, quotes, citations and footnotes only, typically. Argue against Word - I’ve had to rescue at least a couple of theses from impending doom because Word had somehow got into its head to corrupt the file. Also, I used pandoc to help fix my wife’s academic book formatting problems, just before she submitted the manuscript. It had way too many ad-hoc text formats: margins that weren’t consistent, text sizing and paragraph spacing all over the place (especially in block quotes and footnotes) - all actually pretty typical formatting fails that I find even in many business documents (let alone long format text docs). It was a simple matter to export each chapter doc out from Word, into pandoc markdown, where most of the problems could be solved with simple regular expression driven search and replace, then run pandoc to regenerate clean, sensible, consistent Word docs.

Also, you’re talking to a DH audience: pandoc is an easy way to publish in multiple formats, e.g. Word, PDF and HTML, from the one source document. Separation of content and format is a vital part of most computing disciplines. Format for the particular device on-the-fly, usually at the device (e.g. “responsive” websites). Pandoc is the best tool for doing this with long-form writing. Convert them to the simplicity of a text editor; the ease of search and replace in such tools (plus the choice of multiple tools: I use mainly Sublime Text but I do fall back sometimes to BBEdit). 

Give them a demo of how easy it is to user and get readable documents.  Finally, show them the PDFs you get from Pandoc. They look fantastic! I know that’s mainly LaTeX, but I would not try to sell most humanities people on LaTeX, it’s too complex for most of their needs. Pandora’s markdown is a simple and readable format, and you still get the lovely typesetting of LaTeX.


Scot
 

Scot Mcphee. 
Computer programmer. Classics PhD.
p +61 412 957414 <tel:+61%20412%20957%20414>
e scot.mcphee-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org <mailto:scot.mcphee-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
w http://autonomous.org/ <http://autonomous.org/>

-- 
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 email 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/CA9D6C81-50B3-4476-864C-3F23EF3BA89E%40gmail.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #2: Type: text/html, Size: 8069 bytes --]