Skip to content

Commit

Permalink
try remark42
Browse files Browse the repository at this point in the history
  • Loading branch information
adueck committed Aug 1, 2024
1 parent d4aee25 commit 6c4e1b4
Show file tree
Hide file tree
Showing 3 changed files with 103 additions and 0 deletions.
1 change: 1 addition & 0 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@
<meta name="twitter:card" content="summary_large_image">

<meta name="robots" content="index, follow" />
<!-- <script defer src="https://remark42.lingdocs.com/web/embed.js"></script> -->
<title>LingDocs Pashto Grammar</title>
</head>
<body>
Expand Down
2 changes: 2 additions & 0 deletions src/components/Chapter.jsx
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ import TableOfContents from "./TableOfContents";
import Footer from "./Footer";
import ChapterFeedback from "./ChapterFeedback";
import { Helmet } from "react-helmet";
import { Comments } from "./Remark42";

const Chapter = ({ children: chapter }) => {
const title = `${chapter.frontMatter.title} | LingDocs Pashto Grammar`;
Expand Down Expand Up @@ -41,6 +42,7 @@ const Chapter = ({ children: chapter }) => {
<Content />
</div>
<ChapterFeedback chapter={chapter.path} />
<Comments id={chapter.path} />
<Footer chapter={chapter} />
</main>
{!chapter.frontMatter.fullWidth && <TableOfContents tableOfContents={chapter.tableOfContents} />}
Expand Down
100 changes: 100 additions & 0 deletions src/components/Remark42.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,100 @@
import { Fragment, useEffect } from "react";

declare global {
interface Window {
REMARK42: any;
remark_config: any;
}
}

// This function will insert the usual <script> tag of
// Remark42 into the specified DOM location (parentElement)
const insertScript = (id: string, parentElement: HTMLElement) => {
const script = window.document.createElement("script");
script.type = "text/javascript";
script.async = true;
script.id = id;
/* For Gatsby it's important to manually provide the URL
and make sure it does not contain a trailing slash ("/").
Because otherwise the comments for paths with/without
the trailing slash are stored separately in the BoltDB database.
When following a Gatsby Link a page is loaded without the trailing slash,
but when refreshing the page (F5) it is loaded with the trailing slash.
So essentially every URL can become duplicated in the DB and you may not see
your comments from the inverse URL at your present URL.
Making sure url is provided without the trailing slash
in the remark42 config solves this. */
let url = window.location.origin + window.location.pathname;
if (url.endsWith("/")) {
url = url.slice(0, -1);
}
// Now the actual config and script-fetching function:
script.innerHTML = `
var remark_config = {
host: "https://remark42.lingdocs.com",
site_id: "pashto-grammar",
url: "${url}",
theme: "light",
components: ["embed"],
};
!function(e,n){for(var o=0;o<e.length;o++){var r=n.createElement("script"),c=".js",d=n.head||n.body;"noModule"in r?(r.type="module",c=".mjs"):r.async=!0,r.defer=!0,r.src=remark_config.host+"/web/"+e[o]+c,d.appendChild(r)}}(remark_config.components||["embed"],document);`;
parentElement.appendChild(script);
};

/* This function removes the previously added script from the DOM.
Might be necessary when page transitions happen, to make sure a new instance
is created, pointing to the current URL. Although this might actually
not be necessary, please do your own testing. */
const removeScript = (id: string, parentElement: HTMLElement) => {
const script = window.document.getElementById(id);
if (script) {
parentElement.removeChild(script);
}
};

// This function will be provided to useEffect and will insert the script
// when the component is mounted and remove it when it unmounts
const manageScript = () => {
if (!window) {
return () => {};
}
const { document } = window;
if (document.getElementById("remark42")) {
insertScript("comments-script", document.body);
}
return () => removeScript("comments-script", document.body);
};

/* Another function for another useEffect - this is the most crucial part for
Gatsby compatibility. It will ensure that each page loads its own appropriate
comments, and that comments will be properly loaded */
const recreateRemark42Instance = () => {
if (!window) {
return;
}
const remark42 = window.REMARK42;
if (remark42) {
remark42.destroy();
remark42.createInstance(window.remark_config);
}
};

type CommentsProps = {
location: string;
};

// The location prop is {props.location.pathname} from the parent component.
// I.e. invoke the component like this in the parent: <Comments location={props.location.pathname} />
export function Comments({ location }: CommentsProps) {
// Insert the two useEffect hooks. Maybe you can combine them into one? Feel free if you want to.
useEffect(manageScript, [location]);
useEffect(recreateRemark42Instance, [location]);

return (
<Fragment>
<h4>Questions and Comments</h4>
{/* This div is the target for actual comments insertion */}
<div id="remark42" />
</Fragment>
);
}

0 comments on commit 6c4e1b4

Please sign in to comment.