HTML Docs

16 views
Skip to first unread message

Álvaro Mira del Amo

unread,
Apr 15, 2025, 5:11:52 AMApr 15
to okapi-users
HTML Filter documentation

Hi all,

I hope this finds you well. A couple of weeks ago I was involved in a customisation of the HTML filter to cater for the needs of a given customer, who needed to force the extraction of the class of a given DIV (because the region specific details that needed to be updated). Whether this should be done at the translation extraction level or not is a different topic and I would like to avoid that discussion.

I ended up creating a rule like this one:

  div:
    ruleTypes: [INCLUDE]
    translatableAttributes:
      class:
      - class
      - MATCHES
      - [^wistia_embed.*]
    writableLocalizableAttributes: [style]

However, when checking the documentation for the HTML filter, I kind of found that regarding the conditional rules and syntax, there were not many examples (so I ended up checking the actual source code to understand what was supported, etc.). Are there any plans to update the HTML filter docs (last updated in Sept 2022) and include more examples of on top of the pure definitions?

Thanks in advance!
Best,

A. 

Chase Tingley

unread,
Apr 16, 2025, 6:32:49 PMApr 16
to Álvaro Mira del Amo, okapi-users
Hi Álvaro,

I'd be happy to add more docs for some of these features. Although, if you've been working with it recently, you probably have a better understanding of it than I do (it's been a while since I looked at the conditional support).  Could you send me some draft content that I could add?  (Either directly or on the list.)

Alternately, I can give you access to the wiki if you'd like the ability to make the updates yourself.

ct

--
You received this message because you are subscribed to the Google Groups "okapi-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to okapi-users...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/okapi-users/217abedd-b00d-4aa0-a4ee-9f703f9c5fafn%40googlegroups.com.

Alvaro MIra del Amo

unread,
Apr 18, 2025, 5:40:20 AMApr 18
to Chase Tingley, okapi-users

Thanks, Chase. I will try to put together some examples that will make the docs easier to consume when it comes to conditions, etc. I can´t promise I will do it soon, but I promise I will do it. :)

Best regards,

A.

Reply all
Reply to author
Forward
0 new messages