Pillar question: PRCitationTransformer

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

Pillar question: PRCitationTransformer

stepharo
Hi

I'm trying to extend Pillar to get new $publications:...$ structure and
it looks like Pillar is getting more and more complex. And the comments
do not really help because they are short and written for someone
already understanding it. :(

To try to understand I tried to

! Youpi

${cite:ref=Duca18rmod}$

!! Others

but I get

{"content":"!Youpi\n\n\n\n!!Others"}

./pillar export --to=pillar Example.pillar


May be I cannot export to pillar a citation. I have no idea.


I tried to add

PRPillarWriter >> visitCitationAnnotation: aCitation
     "We invoke visitAnnotation: to make sure that the rest of the
document is visited."

     self halt.
     super visitCitationAnnotation: aCitation

Did not stop!

So I put an halt into

PRVisitor >> visitCitationAnnotation: aCitationAnnotation

     self halt.
     self createNewCitationWith: aCitationAnnotation.
     self replace: (OrderedCollection with: tmpCitation) .
     super visitCitationAnnotation: aCitationAnnotation

and it stopped.


I tried to understand who is calling

     PRCitationTransformer

No luck. I'm sure that there is a magic registration mechanism but I
failed to find it.

Looking at tests (BTW Tests are not documentation or class comments,
there are tests).

It looks like I need a configuration.

  (self actualClass
         executeOn:
             (PRCompilationContext withDocument: anInput
withConfiguration: aConfig))
         input

And then I fall on executeOn: implementors..... LLPhase and
PRNodeTransformer.

and I have no idea how a Phase relates to a visitor.

To bad, after all the efforts on Pillar it looks like getting too complex.

So do not think that we can decently ask students to work on improving
Pillar anymore

because they will just get lost and disgusted from Pharo. :(

Sad news isn't.

I hope that I will not have to switch back to LaTeX or markdown (shit).

Stef