コメントを追加

Author: chvmvd

src/components/OpenInColab/OpenInColab.tsx

@@ -2,6 +2,12 @@ import React from "react";
 import usePathname from "../usePathname";
 import styles from "./styles.module.css";
 
+/**
+ * OpenInColabへのリンクをつくるコンポーネント
+ * @param param0 現在ファイルからのipynbへの相対パス
+ * @returns OpenInColabへのリンク
+ */
+
 export default function OpenInColab({ path }) {
   const pathname = usePathname();
   return (

src/components/ViewSource/ViewSource.tsx

@@ -3,20 +3,30 @@ import CodeBlock from "@theme/CodeBlock";
 import usePathname from "../usePathname";
 import OpenInColab from "../OpenInColab/OpenInColab";
 
+/**
+ * ipynbファイルからソースコードと出力、OpenInColabへのリンクを生成
+ * @param param0 現在ファイルからのipynbへの相対パス
+ * @param param1 Pythonの出力を表示するか
+ * @returns ソースコードと出力、OpenInColabへのリンク
+ */
+
 export default function ViewSource({ path, nooutput = false }) {
   const pathname = usePathname();
   const [sources, setSources] = useState<string[]>([]);
   const [outputs, setOutputs] = useState<string[]>([]);
   useEffect(() => {
     async function tmp() {
+      // 該当のipynbファイルをjson形式でとってくる
       const content = await import(
         `/docs/${pathname.slice(6)}${path.slice(0, -6)}.json`
       );
+      // ソースコードを取り出す
       setSources(
         content.cells
           .filter((cell) => cell.cell_type === "code")
           .map((cell) => cell.source.join(""))
       );
+      // outputを取り出す
       setOutputs(
         content.cells
           .filter((cell) => cell.cell_type === "code")
@@ -39,7 +49,9 @@ export default function ViewSource({ path, nooutput = false }) {
     <>
       {sources.map((source, i) => (
         <React.Fragment key={i}>
+          {/* ソースコード */}
           <CodeBlock language="python">{source}</CodeBlock>
+          {/* output */}
           {!nooutput && (
             <CodeBlock language="plaintext">{outputs[i]}</CodeBlock>
           )}

src/components/usePathname.tsx

@@ -1,6 +1,11 @@
 import { useLocation } from "@docusaurus/router";
 import config from "@generated/docusaurus.config";
 
+/**
+ * ファイルの絶対パスを表示
+ * @returns ファイルの絶対パス
+ */
+
 export default function usePathname() {
   const pathname = useLocation().pathname.slice(config.baseUrl.length - 1);
   return pathname;