CentreForDigitalHumanities · lukavdplas · Dec 18, 2025 · Dec 18, 2025 · Dec 18, 2025 · Dec 18, 2025
diff --git a/README.md b/README.md
@@ -16,7 +16,7 @@ Textcavator is primarily intended for academic research and higher education. We
 
 ## Contents
 
-This repository contains the source code for the Textcavator web application, which consists of a Django backend and Angular frontend.
+This repository contains the source code for the Textcavator web application, which consists of a [Django backend](/backend/) and [Angular frontend](/frontend/). It also contains [developer documentation](/documentation/), [functional tests](/functional-tests/), and a [test app for embedding Textcavator](/iframe-test-app/).
 
 For corpora included in Textcavator, the backend includes a definition file that specifies how to read the source files, and how this data should be structured and presented in Textcavator. This repository does _not_ include the source data itself, beyond a few sample files for testing.
 

diff --git a/backend/ianalyzer/settings.py b/backend/ianalyzer/settings.py
@@ -25,6 +25,8 @@
 
 ALLOWED_HOSTS = []
 
+X_FRAME_OPTIONS = 'ALLOW'
+
 
 # Database
 # https://docs.djangoproject.com/en/3.0/ref/settings/#databases

diff --git a/iframe-test-app/README.md b/iframe-test-app/README.md
@@ -0,0 +1,17 @@
+# iframe test app
+
+This is a minimal setup to test embedding Textcavator in another site using an iframe. It serves a web page that embeds your Textcavator development server. You can use it to test the layout, or try out the workflow in an embedded frame.
+
+## Usage
+
+The test app is run using `server.py`. It requires Python to use, no dependencies.
+
+To run, start your Texcavator development server. Then run the container app by running:
+
+```sh
+python server.py
+```
+
+The container app will run at http://localhost:9000/ . Use ctrl + C to quit.
+
+To direct the iframe to a specific corpus, you can include a query parameter `corpus` in the URL with the corpus name, e.g. http://localhost:9000/?corpus=troonredes .
diff --git a/iframe-test-app/index.html b/iframe-test-app/index.html
@@ -0,0 +1,62 @@
+<!doctype html>
+<html lang="en" data-theme="light">
+
+<head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="./solis.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Container app</title>
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bulma@1.0.4/css/bulma.min.css">
+    <link rel="stylesheet" href="./style.css">
+</head>
+
+<body>
+    <header class="container">
+        <div class="hero is-small">
+            <div class="hero-body">
+                <div class="is-flex is-flex-direction-row is-align-items-center">
+                    <div class="image is-32x32 mx-2">
+                        <img src="./solis.png" class="">
+                    </div>
+                    <span>
+                        Utrecht University
+                    </span>
+                </div>
+            </div>
+        </div>
+        <div class="hero is-light">
+            <div class="hero-body">
+                <h1 class="title">Textcavator container</h1>
+            </div>
+        </div>
+        <div class="navbar is-dark" role="presentation">
+            <div class="navbar-start">
+                <a class="navbar-item">Home</a>
+                <a class="navbar-item">Research</a>
+                <a class="navbar-item">News</a>
+                <a class="navbar-item">About</a>
+            </div>
+            </nav>
+    </header>
+    <main>
+        <section class="section">
+            <div class="container">
+                <div class="frame-container">
+                    <iframe id="textcavator-iframe"
+                        width="100%" height="100%">
+                    </iframe>
+                </div>
+            </div>
+        </section>
+    </main>
+    <footer class="container">
+        <div class="footer">
+            <div class="content has-text-centered">
+                Some text here.
+            </div>
+        </div>
+    </footer>
+    <script src="./main.js"></script>
+</body>
+
+</html>
diff --git a/iframe-test-app/main.js b/iframe-test-app/main.js
@@ -0,0 +1,10 @@
+var url = new URL(window.location);
+var corpus = url.searchParams.get('corpus');
+
+var appUrl = new URL('http://localhost:4200');
+if (corpus) {
+    appUrl.pathname = `/search/${corpus}/`;
+}
+
+var iframe = document.getElementById('textcavator-iframe');
+iframe.setAttribute('src', appUrl.toString());
diff --git a/iframe-test-app/server.py b/iframe-test-app/server.py
@@ -0,0 +1,9 @@
+from http.server import HTTPServer, SimpleHTTPRequestHandler
+
+ADDRESS = ('', 9000)
+
+server = HTTPServer(ADDRESS, SimpleHTTPRequestHandler)
+
+if __name__ == '__main__':
+    print(f'Starting server at http://localhost:{server.server_port}')
+    server.serve_forever()
diff --git a/iframe-test-app/solis.png b/iframe-test-app/solis.png
diff --git a/iframe-test-app/style.css b/iframe-test-app/style.css
@@ -0,0 +1,3 @@
+.frame-container {
+    height: 90vh;
+}