Aristotle Metadata
11 | Aristotle Metadata
11 |
12 |
13 | In summary it allows you to do this:
14 |
15 | | 18 | models.py 19 | | 20 | You can do this! 21 | |
| 24 | By changing your models from this... 25 | 26 | ```python 27 | class Greeting(models.model): 28 | text = CharField(max_length=150) 29 | target = models.CharField() 30 | def __str__(self): 31 | return f"{self.greeting}, {self.target}" 32 | 33 | ``` 34 | 35 | to this... 36 | 37 | ```python 38 | # Import garnett 39 | from garnett.fields import Translated 40 | 41 | class Greeting(models.model): 42 | # Convert greeting to a translatable field 43 | text = Translated(CharField(max_length=150)) 44 | target = models.CharField() 45 | def __str__(self): 46 | return f"{self.greeting} {self.target}" 47 | ``` 48 | | 49 |50 | 51 | ```python 52 | from garnett.context import set_field_language 53 | greeting = Greeting(text="Hello", target="World") 54 | 55 | with set_field_language("en"): 56 | greeting.text = "Hello" 57 | with set_field_language("fr"): 58 | greeting.text = "Bonjour" 59 | 60 | greeting.save() 61 | greeting.refresh_from_db() 62 | 63 | with set_field_language("en"): 64 | print(greeting.text) 65 | print(greeting) 66 | # >>> "Hello" 67 | # >>> "Hello World" 68 | 69 | with set_field_language("fr"): 70 | print(greeting.text) 71 | print(greeting) 72 | # >>> "Bonjour" 73 | # >>> "Bonjour World!" 74 | 75 | with set_field_language("en"): 76 | print(greeting.text) 77 | print(greeting) 78 | # >>> "Hello" 79 | # >>> "Hello World" 80 | Greeting.objects.filter(title="Hello").exists() 81 | # >>> True 82 | Greeting.objects.filter(title="Bonjour").exists() 83 | # >>> False 84 | Greeting.objects.filter(title__fr="Bonjour").exists() 85 | # >>> True!! 86 | 87 | # Assuming that GARNETT_DEFAULT_TRANSLATABLE_LANGUAGE="en" 88 | # Or a middleware has set the language context 89 | print(greeting.text) 90 | # >>> Hello 91 | print(greeting) 92 | # >>> Hello World! 93 | 94 | ``` 95 | 96 | | 97 |
37 | Aristotle Metadata
38 |
39 | {% block content %}
40 | {% endblock %}
41 |
42 |
43 |
--------------------------------------------------------------------------------
/tests/library_app/templates/library_app/book_detail.html:
--------------------------------------------------------------------------------
1 | {% extends "library_app/base.html" %}
2 | {% load garnett %}
3 | {% block content %}
4 | book.title)By {{book.author}}
6 | (book.author)
7 |
| Description:
11 | ( book.description)
12 | |
13 | 14 | {{ book.description }} 15 | | 16 |||
| AKA:
19 | ( book.title.translations)
20 | |
21 |
22 |
|
28 | ||
| Pages:
31 | ( book.number_of_pages)
32 | |
33 | {{ book.number_of_pages }} 34 | | 35 |||
| Extra details: 38 | | 39 |
40 | Note: This is a plain json field to demonstrate how garnett
41 | overrides of certain json behaviours don't impact other non-garnett fields.
42 |
43 |
|
52 | ||
| This book available in:
55 | ( book.available_languages)
56 | |
57 |
58 | Note: This method returns a list of languages that have
59 | values for all fields on this model.
60 |
61 |
|
70 |
73 | Regardless of which language is selected the properties shown as code
74 | above show the properties used to populate this django template.
75 |
76 | Eg. book.title will return the
77 | name of the book in your selected langauge (if it is available).
78 |