index

La Novitade

OC_OCDM

arcangelo7Apr 14, 2026 · opencitations/oc_ocdm

refactor!: replace rdflib Graph/URIRef with lightweight LightGraph/str

BREAKING CHANGE: entity.res is now str (was URIRef), entity.g is now LightGraph (was rdflib.Graph), all factory methods accept str instead of URIRef, all getters return str instead of URIRef

+1179-1019355f76a

Rilascio un’autorizzazione a buongiorno principessarmi: ho capito solo ora a cosa serva il context nei file json-ld e mi piace molto.

arcangelo7Apr 16, 2026 · opencitations/metadata

feat: extend context with new types, identifiers, and restructured properties

Add type mappings for document parts (abstract, introduction, discussion, methods, results, conclusion, related_work, materials), document types (archival_document, audio_document, computer_program, editorial, journal_editorial, newspaper, newspaper_article, newspaper_editorial, newspaper_issue, presentation, data_management_plan, retraction_notice), and has_annotation property.

Add identifier schemes: intrepid, jid, openalex, ror, wikidata, wikipedia.

+29-2708e132

arcangelo7Apr 16, 2026 · opencitations/oc_ocdm

refactor(context): add meta namespace prefixes and prune redundant aliases

Introduce short prefixes (br, ar, ra, id, re, pa) for the https://w3id.org/oc/meta/ namespace.

Since id now points to the identifier namespace, the former id term for literal:hasLiteralValue is renamed to literal_value.

Drop three redundant aliases: proceedings_series duplicated series (both fabio:Series), and xpath / xmlid duplicated localresource (all three datacite:local-resource-identifier-scheme).

+9-56683869

JaLC

Trovato questo in JaLC

"journal_title_name_list":[
    {"journal_title_name":"金大考古\nen: The Archaeological Journal of Kanazawa University"}
]

arcangelo7Apr 17, 2026 · opencitations/oc_ds_converter

fix(jalc): split packed multilang entries to keep CSV cells single-line

JaLC records occasionally collapse multiple languages into a single untagged title/journal entry separated by '\n' with an inline "en:" prefix (observed on 10.24517/0002000619). The extractor previously passed the raw string through, producing CSV rows with embedded newlines. Detect the packed-lang pattern, split it into per-language entries, and collapse residual whitespace on the chosen value so single-line cells are preserved.

+111-60c8e357

arcangelo7Apr 17, 2026 · opencitations/oc_ds_converter

fix(jalc): decode html entities before flattening whitespace

JaLC records occasionally encode control characters as numeric HTML entities (
) inside author, title, venue and publisher fields. The previous collapse step ran before entity resolution, so the decoded CR/LF survived into the CSV and broke downstream parsers.

+81-1724faa3c

Ingestione fatta.

OUTCITE

2,306,758 righe, 650,682 fanno capo a br esistenti, 1,656,076 (il 71.8%) sono nuove.

Facciamo che le processo tutte come nuove, sia perché ora si può fare velocemente sia per ricompensare il philippahsannico sforzo.

arcangelo7Apr 25, 2026 · opencitations/oc_meta

fix(check_results): verify output CSVs instead of input CSVs

Input CSVs may contain only temporary identifiers with no OMID

The new logic distinguishes three identifier categories per entity group: the OMID token (used as ground truth for file and provenance checks), recognized external identifiers (doi, orcid, etc.) looked up in the triplestore to detect mismatches with the expected OMID, and unverifiable schemas that are simply counted and skipped.

+392-2804a30a3d

In fase di verifica ho trovato un bug nel creator, il quale non era allineato alla logica del curator per quanto riguarda il collegare un editor al contenitore e non al contenuto per specifici tipi di entità come ad esempio i capitoli dei libri. Di conseguenza, nonostante il curator creasse le nuove entità da collegare al contenitore, il creator le marcava come già esistenti per entità per le quali l’editor era già stato collegato al contenuto e l’OMID, per quanto tracciato all’interno del CSV di output, non compariva nei dati finali.

arcangelo7Apr 25, 2026 · opencitations/oc_meta

fix(creator): query editor roles on the correct BR entity

When a row's editors belong to a container (venue/book) rather than the row's own BR, skip_editor was evaluated against the row's BR roles. Now resolves the actual edited BR via get_edited_br_metaid and queries its existing roles separately when they differ.

Adds fix_misplaced_editor_ars patch script with tests to migrate existing RDF data where editor ARs were misplaced on content entities instead of their containers.

+431-14a05520

Mentre lanciavo la dry run per individuare l’entità del problema, mi sono accorto che c’è un problema preliminare, ovvero entità che hanno più di un part of. Fortunatamente nessuna di queste entità ha anche un problema di editor mal collocato.

arcangelo7Apr 26, 2026 · opencitations/oc_meta

fix(patch): detect duplicate editors during AR migration and fix duplicate partOf

The editor AR patch now resolves duplicate responsible agents by RA URI, shared identifier, or name match before moving ARs to containers. Skipped duplicates are removed from the content entity without being re-added.

New fix_duplicate_part_of script scans for BRs with multiple frbr:partOf values, follows container chains to top-level venues, and auto-fixes when chains converge to the same or equivalent venues. Divergent venues are flagged for manual review with enriched identifier and candidate info.

+2181-112b8c5b8a

Found 82,794 misplaced editor ARs across 39,569 content entities. 61,931 to move, 62 skip (same RA), 3 skip (same identifier), 20,798 skip (same name)

arcangelo7Apr 26, 2026 · opencitations/oc_meta

fix(patch): handle content entities with multiple frbr:partOf containers

When a content entity belongs to multiple containers, the original AR is moved to the first and a new AR (same RA) is created for each additional one.

+100-456d8ae9e

Ho deciso di non applicare la patch per ora. L’applicherò quando avrò un dataset di partenza più pulito con problemi preliminari risolti, a cominciare dalla rimozione dei duplicati, degli orfani, delle entità vuote, dei predicari doppi.

RAMOSE

arcangelo7Apr 14, 2026 · opencitations/ramose

refactor(openapi): remove x-ramose vendor extensions from spec output

Implementation details like endpoint, addon, sparql method, preprocess, and postprocess are not meaningful to API consumers.

+3-507b07d63

arcangelo7Apr 14, 2026 · opencitations/ramose

fix: use GET as default SPARQL HTTP method

+2-2c0a101d

raise ValueError(f"Expected key=value option, got {token!r}")

Quel !r chiama repr sul valore. Produce la rappresentazione con le virgolette.

token = "left"

f"{token}" # left
f"{token!r}" # 'left'

Rende visibili anche caratteri che altrimenti sarebbero invisibili (spazi iniziali/finali, tab, newline).

Ho capito a cosa serviva l’alias in @@foreach, per evitare questo

@@foreach ?br wait=0.1
PREFIX cito: <http://purl.org/spar/cito/>

SELECT ?br (COUNT(?citing) AS ?oc_citation_count) WHERE {
  BIND(<[[?br]]> AS ?br)
  ?cit a cito:Citation ;
       cito:hasCitedEntity  ?br ;
       cito:hasCitingEntity ?citing .
}
GROUP BY ?br

Si può aggiungere un parametro obbligatorio posizionale, quindi non chiave-valore, così

@@foreach ?br item wait=0.1
PREFIX cito: <http://purl.org/spar/cito/>

SELECT ?br (COUNT(?citing) AS ?oc_citation_count) WHERE {
  BIND(<[[item]]> AS ?br)
  ?cit a cito:Citation ;
       cito:hasCitedEntity  ?br ;
       cito:hasCitingEntity ?citing .
}
GROUP BY ?br

arcangelo7Apr 14, 2026 · opencitations/ramose

refactor: standardize directive syntax with key=value options and merged @@foreach

Directive optional parameters now use unambiguous key=value syntax (e.g. type=left, wait=0.5) while required arguments stay positional. This resolves parsing ambiguity when extending directives with new options.

@@foreach absorbs the old @@values ?var:alias setup into a single directive: @@foreach ?variable placeholder [wait=N].

+87-917ad324b

Però così @@foreach ?br item wait=0.1 è poco leggibile, non si capisce cosa sia item. Inoltre non si capisce perché i parametri obbligatori debbano essere solo posizionali e non anche per keyword. Si potrebbe fare come in Python

@@name <arg>... [param=value]...

@@foreach ?br item wait=0.5
@@foreach ?br placeholder=item wait=0.5
@@foreach variable=?br placeholder=item wait=0.5
@@foreach wait=0.5 variable=?br placeholder=item

arcangelo7Apr 14, 2026 · opencitations/ramose

refactor: replace key-value-only parser with Python-style argument parser

_parse_kv_options only handled key=value tokens after positional args were manually extracted by each handler. The new _parse_directive_args supports positional, keyword, and mixed styles in the same call, with free ordering when all arguments are keyword. A token containing = is only treated as keyword if the key part matches a known parameter name, so URLs with query strings work as positional values.

All directive handlers now delegate to _parse_directive_args with their parameter schema.

Documentation now includes parameter tables for each directive.

+166-41baeb15d

arcangelo7Apr 22, 2026 · opencitations/ramose

feat(skgif): add products/{local_identifier} endpoint with JSON-LD output

Implement the SKG-IF converter that transforms SPARQL results from OpenCitations Meta and Index into JSON-LD conforming to the Scholarly Knowledge Graph Interoperability Framework specification (v1.1.0).

The endpoint uses multi-source SPARQL with left joins across Meta (bibliographic metadata, contributors, venue) and Index (citations), producing a complete product representation including identifiers, ordered contributions with linked-list rank preservation, manifestation details, and citation references.

+513-086491f7

arcangelo7Apr 22, 2026 · opencitations/ramose

test(skgif): validate converter output against upstream OpenAPI schema

Fetch the SKG-IF OpenAPI spec from skg-if/api at test time, resolve $ref pointers, and validate JSON-LD responses against the extracted Product response schema using jsonschema.

+220-01acce0d

CEC

arcangelo7Apr 16, 2026 · opencitations/cec

docs(extractor): add /cex prefix to api endpoint examples

The Flask app mounts the API blueprint at /cex/api (main.py sets PREFIX="/cex"), but the README endpoint and curl examples referenced the bare /api path. Align the examples with the actual routing and include the per-request UUID segment in the download URL example.

+4-49b0852c

arcangelo7Apr 18, 2026 · opencitations/cec

feat(grobid): release 1.1.0 with configurable crossref mailto

Add oc_cec_grobid wrapper image over opencitations/grobid-cec:1.0.0 that injects the crossref consolidation mailto at container startup via the CROSSREF_MAILTO env var.

Drop pull_request triggers and remove the master branch so builds only fire on merges to main.

+135-18a0f0de8

https://github.com/opencitations/cec/issues/13

arcangelo7Apr 18, 2026 · opencitations/cec

feat: add bulk extraction script with configurable grobid concurrency

+254-22d07db8

arcangelo7Apr 18, 2026 · opencitations/cec

docs(extractor): document the consolidate form field

Add the new opt-in consolidate toggle to the API form-field table and to the curl upload example.

+50-8666e245b

This is your daily dose of rdflib antidote

Ultimo commit di due mesi fa, vorrei segnalare, e il repository è pieno zeppo di errori di tipizzazione e warning di deprecazione interni al repository stesso, oltre a 299 issue aperte e 61 PR: https://github.com/rdflib/rdflib. Secondo me possiamo considerarlo archiviato, per il momento

Duplicati nei CSV

arcangelo7Apr 21, 2026 · opencitations/oc_meta

fix(generate_csv): always rebuild Redis OMID set at startup

The previous logic skipped reloading processed OMIDs from output CSVs if Redis already had entries. This caused incomplete deduplication on restart: OMIDs written to output files during a prior run were absent from Redis (workers never write to it), so a restarted run would re-process already-output entities and produce duplicates.

Replace the early-return short-circuit with an unconditional delete + reload to guarantee Redis always reflects all existing output CSVs at startup.

+5-707bbc74

In pratica il sistema era fatto per permettere un solo riavvio, perché la lettura del Redis per caricare gli OMID già processati veniva fatta soltanto se il Redis era vuoto e il Redis non veniva aggiornato file per file, ma soltanto all’avvio. Il senso era evitare che degli OMID venissero marcati come già processati quando in realtà erano assenti dai CSV perché i CSV vengono scritti in batch. La soluzione è caricare gli OMID in Redis a ogni riavvio a partire dai CSV già processati.

Produzione

Indicizzare Qlever per i dati di Meta (no provenance) ha impiegato su produzione 7.3 h vs 5.8 h su ServerGrosso. Io dico che è usabilissimo.

Domande

GRAPHIA

Documento di domande aperte per la stesura del rulebook della federazione GRAPHIA, organizzato per WP. Bisogna farne la review, commentandolo.

https://docs.google.com/document/d/1g1N2W4ks59yTnSUG2oSKZyd_bVdVxyJRsec8EwbEuLQ/edit?tab=t.0#heading=h.tag7a4psw9w

RAMOSE

Scapolottina numero 1

GET /skgif/v1/products/omid:br/0612058700

{
  "local_identifier": "products/omid:br/0612058700",
  "contributions": [{"by": {"local_identifier": "persons/omid:ra/069012996"}}],
  "manifestations": [{"biblio": {"in": {"local_identifier": "venues/omid:br/0626055628"}}}],
  "related_products": {"cites": ["products/omid:br/0612058701"]}
}

Scapolottina numero 2

GET /skgif/v1/products/br/0612058700

{
  "local_identifier": "products/br/0612058700",
  "contributions": [{"by": {"local_identifier": "persons/ra/069012996"}}],
  "manifestations": [{"biblio": {"in": {"local_identifier": "venues/br/0626055628"}}}],
  "related_products": {"cites": ["products/br/0612058701"]}
}

Al momento la conversione al formato di skg-if si può triggerare con la query format /skgif/v1/products/{omid}?format=skgif Dovrebbe funzionare così? Al momento non c’è un modo per definire un formato di default, il formato di default è sempre CSV
Per la lingua metto none, giusto?
Per il publisher lo metto il rank?
Al momento l’operazione products è nei test del repo di ramose. Devo metto gli hf di skg-if? Quale sarà l’endpoint in produzione?
Abbiamo un jsonschema per validare gli output di SKG-IF? La validazione fatta su skg-id/api è overkill https://github.com/skg-if/api/blob/main/.github/scripts/validate_files.py

Pubblicazioni

Se io cito un software utilizzando software Heritage, in teoria dovrei utilizzare l’SHA preciso della versione da cui è dipendente il mio software nel momento in cui scrivo l’articolo. Giusto? Inoltre, mi chiedo, che anno devo specificare? L’anno di creazione del software o l’anno in cui è stata rilasciata quella versione?

Email

Email Francesca
Email licenza speciale

Altro

https://w3id.org/oc/ontology/context.jsonld questo è rotto. Come si aggiusta?
Per evitare confusione a noi stessi e anche agli altri, io comincerei a marcare come archiviati/deprecati i repository che non stiamo più mantenendo. Tra questi c’è il corpus e aggiungerei anche le virtuoso_utilities che non servono più. https://github.com/opencitations/corpus. Che ne pensate?

Memo

Aldrovandi

Ai related works c’è da aggiungere l’articolo su chad kg
Mail con marcatura istituto
Articolo del Twin

Vizioso

HERITRACE

C’è un bug che si verifica quando uno seleziona un’entità preesistente, poi clicca sulla X e inserisce i metadati a mano. Alcuni metadati vengono duplicati.
Se uno ripristina una sotto entità a seguito di un merge, l’entità principale potrebbe rompersi.
Per risolvere le performance del time-vault non usare la time-agnostic-library, ma guarda solo la query di update dello snapshot di cancellazione.
Ordine dato all’indice dell’elemento
date: formato
anni: essere meno stretto sugli anni. Problema ISO per 999. 0999?
Opzione per evitare counting
Opzione per non aggiungere la lista delle risorse, che posso comunque essere cercate
Configurabilità troppa fatica
Timer massimo. Timer configurabile. Messaggio in caso si stia per toccare il timer massimo.
Riflettere su @lang. SKOS come use case. skos:prefLabel, skos:altLabel
Possibilità di specificare l’URI a mano in fase di creazione
la base è non specificare la sorgente, perché non sarà mai quella iniziale.
desvription con l’entità e stata modificata. Tipo commit
display name è References Cited by VA bene
Avvertire l’utente del disastro imminente nel caso in cui provi a cancellare un volume

index

La Novitade

Meta

TripleLite

JaLC

OUTCITE

OC_OCDM

JaLC

OUTCITE

RAMOSE

CEC

This is your daily dose of rdflib antidote

Duplicati nei CSV

Produzione

Domande

GRAPHIA

RAMOSE

Pubblicazioni

Email

Altro

Memo