summaryrefslogtreecommitdiff
Commit message (Collapse)AuthorAgeFilesLines
* docs: Use lumen theme for documentationwip/carlosg/testCarlos Garnacho2021-08-291-0/+1
| | | | | | Do as instructed in their readme and use the tarball URL directly. Not great since it requires network access, but seems failable (using the default theme otherwise), so let's go with that.
* ci: Change src/dest dirs for hotdoc documentationCarlos Garnacho2021-08-293-44/+10
| | | | | | This is now generated/installed in different paths, and we want to remove the "api-preview" bits of the target URL. Change these so the documentation is correctly picked up, and looks "official".
* ci: Add intermediate job to build the website before deployingCarlos Garnacho2021-08-292-15/+29
| | | | | | | | | This job allows us to check website output in merge requests, before having it deployed to the gitlab pages. The script that generates the website HTML has been changed to allow specifying the output directory, so it's not always the "public" special directory.
* ci: Exclude generated boilerplate in coverage checksCarlos Garnacho2021-08-291-1/+1
| | | | | | We don't care as much about the specific lines of glib-mkenums or gresource generated files that are being tested. Get these out of coverage output.
* ci: Isolate coverage job into its own build/test runCarlos Garnacho2021-08-291-2/+5
| | | | | | | | | | Right now we use the result from the build/test jobs on fedora/x86_64, we however do some other things on those trees (e.g. build docs) that triggers Tracker code being run, and confuses the results of gcovr wrt the lines being tested. Separate the coverage CI job to do its own build/test so the other jobs are orthogonal to coverage checks.
* ci: Add glib2-doc to fedora imageCarlos Garnacho2021-08-291-2/+2
| | | | | This will help generate docs with full links for the glib/gobject types in our API.
* build: Make hotdoc target depend on ontology docsCarlos Garnacho2021-08-291-1/+1
| | | | Otherwise it might be built in parallel, which we do not want.
* ci: Make Rawhide failableCarlos Garnacho2021-08-291-7/+10
| | | | | This is broken ATM, make it able to fail, and use F34 for all other misc stuff.
* docs: Install devhelp filesCarlos Garnacho2021-08-293-6/+16
| | | | | This is very clunky at the moment, since we need to shoehorn our own keywords on the devhelp2 file, and install manually.
* docs: Generate keywords helper file for markdown documentationCarlos Garnacho2021-08-292-1/+69
|
* ci: Update fedora image with documentation toolsCarlos Garnacho2021-08-291-5/+7
| | | | We now need hotdoc to build docs.
* doc: Tweak hotdoc themeCarlos Garnacho2021-08-296-0/+126
| | | | | | | We need to help it a bit, so it can put our ontology note icons side by side, and to include turtle/sparql prism components, since hotdoc ships an ancient version of prism for syntax highlighting that does not observe these formats yet.
* docs: Update references to code symbols for hotdocCarlos Garnacho2021-08-266-37/+37
| | | | These were done with gi-docgen in mind, but we're not going that way.
* docs: Move images so they are in a single folderCarlos Garnacho2021-08-266-9/+0
| | | | This is a restriction of Hotdoc.
* docs: Fix image locationsCarlos Garnacho2021-08-262-4/+4
|
* docs: Include Nepomuk documentation in hotdocCarlos Garnacho2021-08-2618-496/+159
| | | | Move away from it being in its on gtk-doc build.
* docs: Add missing migration docCarlos Garnacho2021-08-262-2/+8
|
* docs: Set primary section on all markdown docsCarlos Garnacho2021-08-2612-2/+26
|
* libtracker-sparql: Add missing doc piecesCarlos Garnacho2021-08-266-0/+62
| | | | Necessary to put things together nicely in hotdoc.
* src: Remove needless <para> in API doc blurbsCarlos Garnacho2021-08-265-23/+2
| | | | | Not even gtk-doc needs these nowadays, plus they'll mess up with anything we'll port to.
* Revert "meson: Add gi-docgen as a subproject"Carlos Garnacho2021-08-262-9/+0
| | | | This reverts commit 4446db1ba422b8f13cc96f75e49fbee7aa88d7d0.
* build: Use hotdoc to build documentationCarlos Garnacho2021-08-266-76/+50
|
* docs: Adapt markdown docs to hotdoc formatting specificsCarlos Garnacho2021-08-2613-407/+476
|
* tools: Adapt ontology docgen tool for hotdoc markdown specificsCarlos Garnacho2021-08-261-3/+7
|
* docs: Generate examples page with actual examplesCarlos Garnacho2021-08-263-2/+46
| | | | Do some string replacement here to include the examples.
* docs: Generate base ontology documentation for gi-docgen docsCarlos Garnacho2021-08-264-2/+30
|
* ontologies: Add separate documentation file for RDFSCarlos Garnacho2021-08-262-0/+13
| | | | | A little help for the new documentation tool, so this ontology is picked up.
* docs: Add documentation generation in markdown formatCarlos Garnacho2021-08-265-1/+636
| | | | | | This is implemented as separate code that does markdown formatting, there's probably some opportunities for subclassing and text templating, but it can be made prettier later on.
* docs: Generalize class hierarchy creation furtherCarlos Garnacho2021-08-263-33/+56
| | | | Let the caller produce the links in the format it likes.
* tools: Rename docgen executableCarlos Garnacho2021-08-263-4/+4
| | | | Give it a more generic name.
* docs: Rename code fileCarlos Garnacho2021-08-264-3/+3
| | | | | Make the code filename more consistent with the rest of the Tracker tree, and account for multiple writers in the future.
* docs: Move all XML generation into a single fileCarlos Garnacho2021-08-264-351/+278
| | | | | We'll want to have multiple writers, so put all XML together in a single file.
* docs: Refactor common utils to separate fileCarlos Garnacho2021-08-264-365/+435
| | | | | We'll want to generate different document formats, the printing of the hierarchy tree can be abstraced into a common helper.
* docs: Rewrite data model of documentation toolCarlos Garnacho2021-08-2613-996/+881
| | | | | | | | | | | | | Instead of parsing ontology TTL by itself, use 2 in-memory TrackerSparqlConnections for the task, one to load .description files, and another with an empty database. With these in place, the ontology is fully introspectable, we can then query these to fill in our information about the defined classes and properties. One advantage here is that we avoid purpose-specific Turtle file parsers and unify this on the sparql library.
* docs: Build again manpages and ontology docsCarlos Garnacho2021-08-263-3/+18
| | | | Manpages aren't going anywhere, and ontology docs not yet.
* docs: Delete gtk-doc remnantsCarlos Garnacho2021-08-264-429/+0
| | | | These files only served for gtk-doc purposes, drop them.
* docs: Finish porting of tutorial docs to MarkdownCarlos Garnacho2021-08-263-431/+66
|
* docs: Drop "migrating 1.x to 2.x" docsCarlos Garnacho2021-08-261-57/+0
| | | | | If there's anything left to be ported, perhaps it's time to admit some docs won't help it.
* docs: Port "migrating 2.x to 3.x" to markdownCarlos Garnacho2021-08-263-201/+162
|
* docs: Port "examples" to markdownCarlos Garnacho2021-08-263-138/+99
|
* docs: Port "defining ontologies" documentation to markdownCarlos Garnacho2021-08-2622-471/+392
|
* docs: Port "sparql and tracker" documentation to MarkdownCarlos Garnacho2021-08-263-300/+257
|
* docs: Port "sparql functions" doc to markdownCarlos Garnacho2021-08-263-467/+350
|
* docs: Port "performance" docs to markdownCarlos Garnacho2021-08-263-142/+104
|
* docs: Port "implementation limits" document to markdownCarlos Garnacho2021-08-263-132/+85
|
* docs: Move overview to markdownCarlos Garnacho2021-08-263-89/+60
|
* meson: Add gi-docgen as a subprojectDaniele Nicolodi2021-08-261-0/+6
| | | | Currently this is the preferred way to integrate it with the built system.
* docs: Generate reference manual with gi-docgenDaniele Nicolodi2021-08-266-93/+371
|
* meson: Adjust indentationDaniele Nicolodi2021-08-261-1/+1
|
* Merge branch 'wip/carlosg/uri-id-lookups' into 'master'Sam Thursfield2021-08-262-3/+62
|\ | | | | | | | | libtracker-data: Ensure tracker:id/uri can only look up allowed graphs See merge request GNOME/tracker!461