Re: [dev] Which Version and API to Use

hello Malte,

On 26.08.21 10:01, Malte Stien wrote:
> Hi there,
>
> I am new here, so please be nice to me. I am trying to get my feet wet with the programmatic 
> creation of ODT text documents (after having used Open/LibreOffice in the past). So, first of all, 
> which version should I be using? I am intending to use the for production level code. There seems 
> to be:
>
>   - 0.8.8 (this one still has the Simple API it seems...
>   - 0.9.0-RC1 (...which has the aforementioned deprecated)
>   - 1.0.0-beta

apparently we have listed a odftoolkit-0.9.0-RC2 on 
https://github.com/tdf/odftoolkit/releases

> I guess, I should avoid using the Simple API, right? I should be using the ODFDOM API directly? So, 
> is 0.9.0-RC1 stable enough?

indeed it doesn't make sense to start using SimpleAPI today, since it 
has been removed from the master branch.

the current plan is to release 0.9.0 and 0.10.0 (renamed from 1.0.0) 
this year, and we are working to fix the outstanding TODO-items.

> I started using the publicly hosted java docs here: https://odftoolkit.org/api/odfdom/index.html. What 
> version are they for? They are telling me the OdfTextDocument has been deprecated in favour of 
> "org.odftoolkit.simple.TextDocument in Simple API", but then again that has been deprecated, right?

yes, that was bug https://github.com/tdf/odftoolkit/issues/56

i don't actually know what's on odftoolkit.org, that server is manually 
maintained by TDF infra and likely outdated.

the most up to date is here, deployed automatically from the master branch:

https://tdf.github.io/odftoolkit/

... although the JavaDoc in there is also outdated, last updated in 2019 :(

uh... well... if you build the source via maven the current JavaDoc is 
generated...

> Assuming 0.9.0 is the way to go, are there any good tutorials out there for creation of 
> TextDocuments with the ODFDOM API.

dunno, hope Svante can answer this question.

> Sorry for my newbie questions. I hope to be productive and more useful soon.
>
> Thank you,
> Malte.


--
To unsubscribe e-mail to: dev+unsubscribe@odftoolkit.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.odftoolkit.org/dev/
Privacy Policy: https://www.documentfoundation.org/privacy