Create templates.md

in between commit
2023-06-13 11:02:34 +02:00
parent ea316a7f42
commit f3966f408d
1 changed files with 64 additions and 0 deletions
@@ -0,0 +1,64 @@
+![template examples 1](https://github.com/AIrjen/OneButtonPrompt/assets/130234949/f5b96087-81fb-4a06-83a0-f209d085b5e3)
+
+
+# Templates and "only templates" mode
+
+There is a small chance, that One Button Prompt generates a prompt based on a template instead of a fully randomized generated prompt. You can also force it to use "only templates". But what does this mean exactly? I hope to answer these questions here.
+
+This feature was build for beginners. Instead of copy/pasting existing interesting prompts from the web, I've already done so for you. There are currently over 500+ prompt templates available.
+
+Hopefully, this will inspire you as well.
+
+### What is a prompt __template__?
+A __prompt template__ is a preconfigured prompt which uses One Button Prompt wildcards to be randomized.
+
+These __prompt templates__ are based on various popular existing prompts, from example civitai, prompthero, promptbook, replicable, openart sources. They try to add randomizition while keeping in line with the original prompt.
+
+Here is a good example from the [deliberate model](https://civitai.com/images/154634?modelVersionId=15236). This is the original image posted:
+
+<img src="https://github.com/AIrjen/OneButtonPrompt/assets/130234949/a69d544f-ee25-41a5-b833-537f4dfea0e4.png"  alt="original image" width="30%" height="30%">
+
+> a girl, wearing a tie, cupcake in her hands, school, indoors, (soothing tones:1.25), (hdr:1.25), (artstation:1.2), dramatic, (intricate details:1.14), (hyperrealistic 3d render:1.16), (filmic:0.55), (rutkowski:1.1), (faded:1.3)
+
+This is the wildcarded prompt that is added to the __prompt templates__:
+
+> a -subject-, wearing a -accessory-, -food- in her hands, school, -minilocation-, (soothing tones:1.25), (hdr:1.25), (artstation:1.2), dramatic, (intricate details:1.14), (hyperrealistic 3d render:1.16), (filmic:0.55), (rutkowski:1.1), (faded:1.3)
+
+This means that most of the base prompt remains the same, however, some of the parts of the prompt have been replaced by wildcards. These are then replaced by a randomized value during prompt generation.
+
+Here are some examples of this specific prompt template:
+
+## Running with "only templates"
+The prompt templates with show up once in a while during normal use of One Button Prompt. This can be set under __"type of image"__ . Set this to __"only templates"__. This will force One Button Prompt to only work bsaed of prompt templates instead of its normal randomized generation.
+
+![only templates option](https://github.com/AIrjen/OneButtonPrompt/assets/130234949/c60e4b5b-d4d4-4939-a1c4-ba8a575b2a7b)
+
+All prompt templates are classified with a subject type. This means you can use the __"Subject Types"__ field normally. So you can set it to any value such as __"animal"__ or __"humanoid"__, and it will take the prompt templates that match that type.
+
+I do have to say, that "humanoids" are overrepresented in the dataset, and "concept" are underrepresented. I did try to have as much diversity as possible in the set.
+
+## Subject Override and prompt templates
+You can use __"Overwrite subject"__ as normal with the prompt templates. Meaning that your subject will be inserted in the prompt templates.
+
+Refer to [guide to override subject](https://github.com/AIrjen/OneButtonPrompt/blob/main/user_guides/override_subject_and_infinite_variations.md) for more information surrounding the override subject.
+
+__"Smart subject"__ has no effect when using prompt templates.
+
+Example:
+![templates example with custom subject](https://github.com/AIrjen/OneButtonPrompt/assets/130234949/2fdc8835-62d0-4650-90d4-f966bf2de286)
+
+## Adding new prompt templates
+You can add your own prompt templates as well, or even override the entire set with your own templates. This is done through the __custom files__ logic that works for every file in One Button Prompt.
+
+Refer to the basics here: [guide to custom files](https://github.com/AIrjen/OneButtonPrompt/blob/main/user_guides/custom_files.md)
+
+Refer to the wildcards here: [guide to using wildcards and Dynamic Prompts](https://github.com/AIrjen/OneButtonPrompt/blob/main/user_guides/wildcards_and_dynamic_prompts_extension.md)
+
+You can place a __"templates_addon.csv"__ or a __"templates_replace.csv"__ file in the __userfiles__ folder of One Button Prompt.
+
+Refer to __\csvfiles\templates\templates.csv__ for how the prompt templates are build up.
+
+The structure is as following:
+
+_prompt;source;sourcecategory;subjecttype;subjectwildcard_
+