Re: [calsify] Getting started with the calendar persistence format

[Ujjwal Sharma <[e-mail]>]

Hey Ronald!

I managed to get it running. The document I was using was the same that
you linked to, and it seems that while the file works quite well with
just `metanorma`, the command on the docs website (`metanorma --type
{rfc2 or rfc3} -x xmlrfc {my-document-filename.adoc}`) needs to be
fixed. `--type` is `ietf` and `--extensions` is... well, not `xmlrfc`. I
would try to make a PR to the website later if this all sounds good.

One last thing I need to get started for real: where can I find the
source for RFC 3339 (since I was supposed to use that as a starting
point)? Is there a source at all? If that source is not in asciidoc
format (I'd imagine not), is copying manually from the text file the
best I can do?

Cheers,
Ujjwal

On 10/20/20 5:00 AM, Ronald Tse wrote:
> Hi Ujjwal,
> 
> Would you be able to point me to the draft to see what the problem is?
> 
> Here’s a sample document that works:
> https://raw.githubusercontent.com/metanorma/mn-samples-ietf/master/sources/antioch/document.adoc
> 
> (https://github.com/metanorma/mn-samples-ietf provides working examples)
> 
> If you have these two lines in your adoc file header (under the title
> but before the content, which is separated with a blank line):
> 
> "
> :mn-document-class: ietf
> :mn-output-extensions: rfc,xml,txt,html,rxl
> “
> 
> Then you should be able to just run this:
> metanorma draft-ryzokuken-timestamp-information.adoc
> 
> Ron
> 
> _____________________________________
> 
> Ronald Tse
> Ribose Inc.
> 
>> On Oct 20, 2020, at 6:09 AM, Ujjwal Sharma <[e-mail]
>> <mailto:[e-mail]>> wrote:
>>
>> Hi Ronald!
>>
>> Thanks for the suggestion. Write once, publish anywhere (although
>> perhaps with minimal changes) is indeed a priority, especially given our
>> time constraints. I tried setting up metanorma today, but for some
>> reason, it fails for me locally.
>>
>> My input:
>>
>> metanorma --type rfc3 draft-ryzokuken-timestamp-information.adoc
>>
>> Error:
>>
>> Error: loading gem `metanorma-rfc3` failed. Exiting.
>>
>> This works with or without `-x xmlrfc`. What seems to be wrong here? Am
>> I missing a gem? A simple web search doesn't return anything useful, and
>> no gem named `metanorma-rfc3` can be found.
>>
>> I thought there was something wrong with my setup, but I tried multiple
>> times, ran `metanorma setup` properly, tried the docker version, but no
>> luck. The same error each time. Could you help me figure out what I
>> missed?
>>
>> Best,
>> Ujjwal
>>
>> On 10/16/20 9:45 AM, Ronald Tse wrote:
>>> Hi Ujjwal,
>>>
>>> (Thanks Bron for the plug!)
>>>
>>> Metanorma is one of the officially listed processors for IETF documents
>>> (alongside mmark and kramdown-rfc2629).
>>>
>>> CalConnect uses Metanorma to publish standards, and a number of SDOs do
>>> so as well (ITU, OGC, BIPM, who also work with date/time).
>>>
>>> If there is any intention to cross-publish into CalConnect or ISO, the
>>> ability to "write once, publish anywhere” becomes important.
>>>
>>> Given that we’re the folks behind it, I’m happy to serve as your
>>> personal support if you run into any Metanorma problems :-)
>>>
>>> Kind regards,
>>> Ron
>>> _____________________________________
>>>
>>> Ronald Tse
>>> Ribose Inc.
>>>
>>>> On Oct 16, 2020, at 8:27 AM, Bron Gondwana <[e-mail]
>>>> <mailto:[e-mail]>
>>>> <mailto:[e-mail]>> wrote:
>>>>
>>>> 
>>>> Hi Ujjwal,
>>>>
>>>> There's a variety of options for writing drafts.  I personally use a
>>>> workflow based on mmark, for example:
>>>>
>>>> https://github.com/brong/draft-gondwana-effective-terminology
>>>>
>>>> There's also metanorma, which allows you to create a variety of
>>>> outputs.  There's documentation here:
>>>>
>>>> https://www.metanorma.com/author/ietf/
>>>>
>>>> Or you can use tools like:
>>>>
>>>> https://github.com/cabo/kramdown-rfc2629
>>>>
>>>> Basically, they're all toolchains that generate RFC XML format
>>>> documents.
>>>>
>>>> In order to publish to the IETF, you need a datatracker account, and
>>>> you'll need to upload there:
>>>>
>>>> https://datatracker.ietf.org/submit/tool-instructions/
>>>>
>>>> Cheers,
>>>>
>>>> Bron.
>>>>
>>>> On Fri, Oct 16, 2020, at 09:21, Ujjwal Sharma wrote:
>>>>> Hello everyone!
>>>>>
>>>>> Thanks for the amazing discussions and help yesterday. Given our
>>>>> constrained timeline, I suppose I should start working on the drafts
>>>>> immediately.
>>>>>
>>>>> On the IETF side of things, I suppose I'd need to start by creating an
>>>>> I-D? Is there a set of resources you could point me to in order to get
>>>>> up and running quickly?
>>>>>
>>>>> Also, what should I do to get the ball rolling on the CalConnect/ISO
>>>>> side of things?
>>>>>
>>>>> Best,
>>>>> Ujjwal
>>>>>
>>>>> -- 
>>>>> Ujjwal "Ryzokuken" Sharma (he/him)
>>>>>
>>>>> Compilers Hacker, Node.js Core Collaborator and Speaker
>>>>>
>>>>>
>>>>> _______________________________________________
>>>>> calsify mailing list
>>>>> [e-mail] <mailto:[e-mail]> <mailto:[e-mail]>
>>>>> https://www.ietf.org/mailman/listinfo/calsify
>>>>>
>>>>>
>>>>> *Attachments:*
>>>>>
>>>>>  * signature.asc
>>>>>
>>>>
>>>> --
>>>>   Bron Gondwana, CEO, Fastmail Pty Ltd
>>>>   [e-mail]
>>>> <mailto:[e-mail]> <mailto:[e-mail]>
>>>>
>>>>
>>>> _______________________________________________
>>>> calsify mailing list
>>>> [e-mail] <mailto:[e-mail]> <mailto:[e-mail]>
>>>> https://www.ietf.org/mailman/listinfo/calsify
>>
>> -- 
>> Ujjwal "Ryzokuken" Sharma (he/him)
>>
>> Compilers Hacker, Node.js Core Collaborator and Speaker
> 

-- 
Ujjwal "Ryzokuken" Sharma (he/him)

Compilers Hacker, Node.js Core Collaborator and Speaker