Haystack 通过检查每个模型实例的文本“文档”来构建其文本索引。通常,您需要从多个模型字段聚合该文档;如果是这样,您可以使用模板。
每个 SearchIndex 都要求有一个(且只有一个)字段为 document=True。这会向 Haystack 和搜索引擎指示哪个字段是在其中进行搜索的主要字段。
请注意,它不是指那里的模型字段! SearchIndex 的字段为document=True。按照惯例,该字段被命名为text。
如您所知,SearchIndex 不仅仅指向模型。您定义一个模式来描述哪些字段将被索引。这与模型上的字段不同!
如果你有这个模型:
from django.db import models
from django.contrib.auth.models import User
class Note(models.Model):
user = models.ForeignKey(User)
pub_date = models.DateTimeField()
title = models.CharField(max_length=200)
body = models.TextField()
def __str__(self):
return self.title
您可以设计这个 SearchIndex,它指定要索引的字段的架构:
import datetime
from haystack import indexes
from myapp.models import Note
class NoteIndex(indexes.SearchIndex, indexes.Indexable):
text = indexes.CharField(document=True, use_template=True)
author = indexes.CharField(model_attr='user')
pub_date = indexes.DateTimeField(model_attr='pub_date')
def get_model(self):
return Note
def index_queryset(self, using=None):
"""Used when the entire index for model is updated."""
return self.get_model().objects.filter(pub_date__lte=datetime.datetime.now())
我应该在“document=True”字段中添加什么内容?它应该是模型上所有相关字段的串联,还是除了“标题”字段之外的所有字段,因为我已经单独声明了它?
是的。
use_template=True 参数告诉 Haystack 该字段内容应该使用专门针对该 SearchIndex 字段的模板呈现。 Haystack 查找的模板名称是search/indexes/{app_label}/{model_name}_{field_name}.txt。
在这种情况下,字段为NoteIndex.text,对应的模型为myapp.Note,Haystack 查找模板search/indexes/myapp/note_text.txt。定义该模板,以便将所有相关文本收集到模型实例的一个文档中:
{{ object.title }}
{{ object.user.get_full_name }}
{{ object.body }}
所有这些例子都来自Haystack getting started tutorial。