Skip to content

Commit 896c005

Browse files
committed
docs: Refactor source card display to use custom badges and simplify grid layout.
1 parent c2bc6f3 commit 896c005

File tree

1 file changed

+41
-25
lines changed

1 file changed

+41
-25
lines changed

docs/source/sources.md

Lines changed: 41 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -4,86 +4,102 @@
44

55
**BibTeX Validator** integrates with a wide range of academic databases to ensure your references are accurate and complete.
66

7-
::::{grid} 1 1 2 2
7+
::::{grid} 1
88
:gutter: 3
99

10-
:::{grid-item-card} :gui-badge-crossref:`Crossref`
10+
:::{grid-item-card}
1111
:link: https://www.crossref.org/
12-
:columns: 12 6 6 4
1312

14-
**Primary Source for DOIs**
13+
<div style="display: flex; align-items: center; gap: 12px; margin-bottom: 8px;">
14+
<span class="badge badge-source-crossref">Crossref</span>
15+
<span style="font-size: 1.1rem; font-weight: 600;">Primary Source for DOIs</span>
16+
</div>
1517

1618
- **Validates**: DOIs
1719
- **Fetches**: Title, Author, Journal, Year, Volume, Issue, Pages
1820
- **Logic**: Queries directly using the DOI. If a DOI is missing, it attempts to find one via other sources.
1921
:::
2022

21-
:::{grid-item-card} :gui-badge-arxiv:`arXiv`
23+
:::{grid-item-card}
2224
:link: https://arxiv.org/
23-
:columns: 12 6 6 4
2425

25-
**Preprint Repository**
26+
<div style="display: flex; align-items: center; gap: 12px; margin-bottom: 8px;">
27+
<span class="badge badge-source-arxiv">arXiv</span>
28+
<span style="font-size: 1.1rem; font-weight: 600;">Preprint Repository</span>
29+
</div>
2630

2731
- **Validates**: arXiv IDs
2832
- **Fetches**: Title, Author, Year, Abstract, Primary Category
2933
- **Logic**: Detected via `eprint` field or DOI (e.g., `10.48550/arXiv...`). Handles versioning (v1, v2).
3034
:::
3135

32-
:::{grid-item-card} :gui-badge-scholar:`Google Scholar`
36+
:::{grid-item-card}
3337
:link: https://scholar.google.com/
34-
:columns: 12 6 6 4
3538

36-
**Citation & Search Backup**
39+
<div style="display: flex; align-items: center; gap: 12px; margin-bottom: 8px;">
40+
<span class="badge badge-source-semantic-scholar">Google Scholar</span>
41+
<span style="font-size: 1.1rem; font-weight: 600;">Citation & Search Backup</span>
42+
</div>
3743

3844
- **Fetches**: Citation counts, missing DOIs
3945
- **Logic**: Searches by title/author if other identifiers are missing. **Note**: Can be rate-limited.
4046
:::
4147

42-
:::{grid-item-card} :gui-badge-dblp:`DBLP`
48+
:::{grid-item-card}
4349
:link: https://dblp.org/
44-
:columns: 12 6 6 4
4550

46-
**Computer Science Bibliography**
51+
<div style="display: flex; align-items: center; gap: 12px; margin-bottom: 8px;">
52+
<span class="badge badge-source-dblp">DBLP</span>
53+
<span style="font-size: 1.1rem; font-weight: 600;">Computer Science Bibliography</span>
54+
</div>
4755

4856
- **Fetches**: Accurate conference/journal metadata
4957
- **Logic**: Prioritized for Computer Science papers. Excellent for resolving abbreviations.
5058
:::
5159

52-
:::{grid-item-card} :gui-badge-pubmed:`PubMed`
60+
:::{grid-item-card}
5361
:link: https://pubmed.ncbi.nlm.nih.gov/
54-
:columns: 12 6 6 4
5562

56-
**Biomedical Literature**
63+
<div style="display: flex; align-items: center; gap: 12px; margin-bottom: 8px;">
64+
<span class="badge badge-source-pubmed">PubMed</span>
65+
<span style="font-size: 1.1rem; font-weight: 600;">Biomedical Literature</span>
66+
</div>
5767

5868
- **Fetches**: Metadata via PMID
5969
- **Logic**: Triggered if a `pmid` field is present.
6070
:::
6171

62-
:::{grid-item-card} :gui-badge-openalex:`OpenAlex`
72+
:::{grid-item-card}
6373
:link: https://openalex.org/
64-
:columns: 12 6 6 4
6574

66-
**Comprehensive Metadata**
75+
<div style="display: flex; align-items: center; gap: 12px; margin-bottom: 8px;">
76+
<span class="badge badge-source-openalex">OpenAlex</span>
77+
<span style="font-size: 1.1rem; font-weight: 600;">Comprehensive Metadata</span>
78+
</div>
6779

6880
- **Fetches**: High-quality open metadata
6981
- **Logic**: Used as a robust backup for many fields using DOIs or Titles.
7082
:::
7183

72-
:::{grid-item-card} :gui-badge-zenodo:`Zenodo`
84+
:::{grid-item-card}
7385
:link: https://zenodo.org/
74-
:columns: 12 6 6 4
7586

76-
**General Purpose Repository**
87+
<div style="display: flex; align-items: center; gap: 12px; margin-bottom: 8px;">
88+
<span class="badge badge-source-zenodo">Zenodo</span>
89+
<span style="font-size: 1.1rem; font-weight: 600;">General Purpose Repository</span>
90+
</div>
7791

7892
- **Fetches**: Dataset and software citation metadata
7993
- **Logic**: Triggered for Zenodo DOIs.
8094
:::
8195

82-
:::{grid-item-card} :gui-badge-datacite:`DataCite`
96+
:::{grid-item-card}
8397
:link: https://datacite.org/
84-
:columns: 12 6 6 4
8598

86-
**DOI Registration Agency**
99+
<div style="display: flex; align-items: center; gap: 12px; margin-bottom: 8px;">
100+
<span class="badge badge-source-datacite">DataCite</span>
101+
<span style="font-size: 1.1rem; font-weight: 600;">DOI Registration Agency</span>
102+
</div>
87103

88104
- **Fetches**: General metadata for DOIs not in Crossref
89105
- **Logic**: Fallback for non-Crossref DOIs.

0 commit comments

Comments
 (0)