mirror of
https://github.com/stashapp/Stash-Docs.git
synced 2025-12-10 17:32:43 -06:00
Update copyright year to 2025 and adjust navigation links in mkdocs configuration
This commit is contained in:
DogmaDragon
parent
e342280a3f
commit
a5ad913ff7
@ -1,124 +0,0 @@
|
||||
---
|
||||
title: Bulk importing via CSV using gql-iterate
|
||||
---
|
||||
|
||||
If you want to add a collection of performers, tags, studios, etc, and you have a text/spreadsheet list of them, here's the walkthrough of how to do it via a simple CLI method.
|
||||
|
||||
## Step 1: Install gql-iterate
|
||||
|
||||
[gql-iterate repository](https://github.com/efstajas/gql-iterate){:target="_blank"}
|
||||
|
||||
`npm install @efstajas/gql-iterate -g` or `yarn add @efstajas/gql-iterate -g`
|
||||
|
||||
For latest versions of NodeJS (14>) you need to go where you globally install your npm modules (AppData/Roaming/npm/node_modules/@efstajas/gql-iterate/bin) and add the following to the first line of the cli.js file.
|
||||
|
||||
`import { createRequire } from 'module'; const require = createRequire(import.meta.url);`
|
||||
|
||||
## Step 2: Prepare your gql.file if needed
|
||||
|
||||
See below for example versions of performers.gql and tags.gql samples that should work for you.
|
||||
Others can be figured out (with minor changes needeed) from stash/graphql/documents/mutations
|
||||
|
||||
These are NOT identical to the original files found above. Compare you'll see how they differ. This is very specific to be used for gql-iterate.
|
||||
|
||||
=== "tags.gql"
|
||||
|
||||
```graphql
|
||||
mutation TagCreate(
|
||||
$name: String!,
|
||||
$image: String) {
|
||||
tagCreate(input: {
|
||||
name: $name,
|
||||
image: $image
|
||||
}) {
|
||||
id
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
=== "performers.gql"
|
||||
|
||||
```graphql
|
||||
mutation PerformerCreate(
|
||||
$name: String!,
|
||||
$url: String,
|
||||
$gender: GenderEnum,
|
||||
$birthdate: String,
|
||||
$ethnicity: String,
|
||||
$country: String,
|
||||
$eye_color: String,
|
||||
$height: String,
|
||||
$measurements: String,
|
||||
$fake_tits: String,
|
||||
$career_length: String,
|
||||
$tattoos: String,
|
||||
$piercings: String,
|
||||
$aliases: String,
|
||||
$twitter: String,
|
||||
$instagram: String,
|
||||
$favorite: Boolean,
|
||||
$image: String) {
|
||||
performerCreate(input: {
|
||||
name: $name,
|
||||
url: $url,
|
||||
gender: $gender,
|
||||
birthdate: $birthdate,
|
||||
ethnicity: $ethnicity,
|
||||
country: $country,
|
||||
eye_color: $eye_color,
|
||||
height: $height,
|
||||
measurements: $measurements,
|
||||
fake_tits: $fake_tits,
|
||||
career_length: $career_length,
|
||||
tattoos: $tattoos,
|
||||
piercings: $piercings,
|
||||
aliases: $aliases,
|
||||
twitter: $twitter,
|
||||
instagram: $instagram,
|
||||
favorite: $favorite,
|
||||
image: $image }
|
||||
)
|
||||
{ id }
|
||||
}
|
||||
```
|
||||
|
||||
If you have a suggested change, please add it below.
|
||||
|
||||
## Step 3: Prepare your textfile or spreadsheet into a CSV
|
||||
|
||||
let's say you have a textfile with these performers (just names and eyecolors for a simple example)
|
||||
If you have a spreadsheet, add a first line with the column headers, you HAVE to provide all fields listed above in the first line, but you don't have to actually have data in them.
|
||||
|
||||
`name,url,gender,birthdate,ethnicity,country,eye_color,height,measurements,fake_tits,career_length,tattoos,piercings,aliases,twitter,instagram,favorite,image`
|
||||
|
||||
then add your data if text, or export as CSV if it's a spreadsheet
|
||||
(gender is not a string, see documentation in code, and favorite is a boolean, if you want to add those)
|
||||
|
||||
Alice,,,,,,blue
|
||||
Betty,,,,,,green
|
||||
Carter,,,,,,brown
|
||||
|
||||
the above lines all go into a file, like performerdata.csv
|
||||
|
||||
|
||||
Gender is complicated due to Stash using GenderEnum.
|
||||
|
||||
|
||||
For tags, you only need the tag title, and if desired, a url to a image
|
||||
|
||||
If you're unable to get this to work, then **omit** the **favorite** and **image** property from your CSV header, and from the **performers.gql** file.
|
||||
|
||||
## Step 4
|
||||
|
||||
!!! note
|
||||
Must use numerical IP instead of localhost.
|
||||
|
||||
Run this CLI command (assumes your files are in current directory and location for gql-interate is in your path)
|
||||
|
||||
`gql-iterate --host http://_yourserverIP:portgoeshere_/graphql --input ./performerdata.csv --query ./performers.gql`
|
||||
|
||||
It will run and add performers, it won't duplicate existing names, so you can run it multiple times if you want to add more names. Or delete something and readd it, if need be.
|
||||
|
||||
|
||||
|
||||
|
||||
16
mkdocs.yml
16
mkdocs.yml
@ -7,7 +7,7 @@ repo_name: stashapp/Stash-Docs
|
||||
repo_url: https://github.com/stashapp/Stash-Docs
|
||||
edit_uri: edit/main/docs/
|
||||
|
||||
copyright: Copyright © 2017 - 2024 stashapp contributors
|
||||
copyright: Copyright © 2017 - 2025 stashapp contributors
|
||||
|
||||
theme:
|
||||
name: material
|
||||
@ -22,7 +22,6 @@ theme:
|
||||
- search.share
|
||||
- navigation.instant
|
||||
- navigation.instant.progress
|
||||
# - content.code.copy
|
||||
# - content.code.annotate
|
||||
# - navigation.tracking
|
||||
- navigation.tabs
|
||||
@ -35,6 +34,9 @@ theme:
|
||||
- content.tooltips
|
||||
# - content.tabs.link
|
||||
- content.code.copy
|
||||
- navigation.path
|
||||
- content.code.select
|
||||
- content.footnote.tooltips
|
||||
palette:
|
||||
# Palette toggle for light mode
|
||||
- media: "(prefers-color-scheme: light)"
|
||||
@ -59,6 +61,12 @@ plugins:
|
||||
- search
|
||||
- git-revision-date-localized:
|
||||
enable_creation_date: true
|
||||
- git-committers:
|
||||
enabled: !ENV [CI, false]
|
||||
repository: stashapp/Stash-Docs
|
||||
branch: main
|
||||
exclude_committers:
|
||||
- github-actions[bot]
|
||||
- glightbox
|
||||
- social:
|
||||
enabled: !ENV [CI, false]
|
||||
@ -70,6 +78,7 @@ plugins:
|
||||
'faq/setup.md': 'https://discourse.stashapp.cc/t/-/1658'
|
||||
'guides/community-wiki/index.md': 'https://discourse.stashapp.cc/tags/c/community-wiki/22/stash'
|
||||
|
||||
|
||||
watch:
|
||||
- includes
|
||||
|
||||
@ -152,8 +161,7 @@ nav:
|
||||
- Backup and restore database: guides/backup-and-restore-database.md
|
||||
- Reverse proxy: guides/reverse-proxy.md
|
||||
- Troubleshooting video playback: guides/troubleshooting-video-playback.md
|
||||
- Advanced configuration options: guides/advanced-configuration-options.md
|
||||
- Bulk importing via CSV using gql-iterate: guides/importing-via-csv-using-gql-iterate.md
|
||||
- Advanced configuration options: guides/advanced-configuration-options.mdd
|
||||
- Manually editing the Stash sqlite3 database: guides/manually-editing-the-stash-sqlite3-database.md
|
||||
- Scraping metadata behind login: guides/scraping-metadata-behind-login.md
|
||||
- Community wiki:
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user