@@ -49,3 +49,86 @@ In addition to React, we utilized the following packages to enhance functionalit
4949- React Icons
5050
5151Feel free to explore and contribute to make SMS Without Borders even better!
52+
53+
54+
55+ ---------------------------------------------------------------------------------------------------------------------------------------------
56+
57+ # Research & Publications Section – Integration Guide
58+
59+ ## Overview
60+
61+ This adds a fully-featured ** Research & Publications** page to the SMSWithoutBorders website that:
62+
63+ - Displays all papers, white papers, and threads in a searchable, filterable grid
64+ - Lets non-developers ** add new papers by only editing one JSON file** — no React code needed
65+ - Supports search by title, topic, author, or keyword
66+ - Supports filtering by type (whitepaper / research / thread), year, and topic tags
67+ - Links directly to PDFs (Google Drive, arXiv, etc.)
68+
69+ ---
70+
71+ ## Files Delivered
72+
73+ ```
74+ src/
75+ data/
76+ papers.json
77+ pages/
78+ ResearchPage.jsx
79+ ```
80+
81+
82+ ## How to add new papers (NO code needed)
83+
84+ All papers live in ** ` src/data/papers.json ` ** . To add a new paper:
85+
86+ 1 . Open ` src/data/papers.json ` in any text editor or directly on GitHub (click the file → pencil icon to edit)
87+ 2 . Copy this template and paste it before the last ` ] ` :
88+
89+ ``` json
90+ {
91+ "id" : " 7" ,
92+ "title" : " Your Paper Title Here" ,
93+ "authors" : [" First Author" , " Second Author" ],
94+ "abstract" : " A short summary of the paper (2-4 sentences)." ,
95+ "topics" : [" Topic1" , " Topic2" , " Topic3" ],
96+ "type" : " whitepaper" ,
97+ "year" : 2025 ,
98+ "pdfUrl" : " https://link-to-pdf-or-google-drive.com/..." ,
99+ "thumbnail" : null
100+ }
101+ ```
102+
103+ 3 . Save / commit the file
104+ 4 . The website will automatically show the new paper
105+
106+ ### Field reference
107+
108+ | Field | Required | Options / Notes |
109+ | -------------| ----------| ----------------------------------------------------------------------|
110+ | ` id ` | Yes | Unique string number (increment from last entry) |
111+ | ` title ` | Yes | Full paper title |
112+ | ` authors ` | Yes | Array of author name strings |
113+ | ` abstract ` | Yes | 1–4 sentence summary shown on the card |
114+ | ` topics ` | Yes | Array of topic tags (used for filtering); use existing ones or new |
115+ | ` type ` | Yes | ` "whitepaper" ` , ` "research" ` , or ` "thread" ` |
116+ | ` year ` | Yes | Publication year as a number, e.g. ` 2024 ` |
117+ | ` pdfUrl ` | Yes | Full URL to PDF, Google Drive view link, or arXiv. ` "" ` = Coming Soon|
118+ | ` thumbnail ` | No | Path to a cover image (optional, leave ` null ` if not used) |
119+
120+ ---
121+
122+ ## Google Drive PDF links
123+
124+ For Google Drive, use the ** viewer link** format:
125+ ```
126+ https://drive.google.com/file/d/FILE_ID/view
127+ ```
128+ This opens an in-browser reader, which works perfectly with the "Read Paper" button.
129+
130+ ---
131+
132+ ## Want inline PDF reading (no leaving the site)?
133+
134+ If you want papers to open in an embedded reader within the website instead of a new tab, we can add a modal with ` react-pdf ` . Let us know!
0 commit comments