Помогите понять: процесс после приготовления

spirobel · 29.Май.2020 09:51:25

Привет,
Я был бы очень рад, если бы кто-то мог помочь мне понять, как работает процесс постобработки. Особенно меня интересует эта часть:

github.com/discourse/discourse

lib/cooked_post_processor.rb

956d15d13

# frozen_string_literal: true

# Post processing that we can do after a post has already been cooked.
# For example, inserting the onebox content, or image sizes/thumbnails.

class CookedPostProcessor
  LIGHTBOX_WRAPPER_CSS_CLASS = "lightbox-wrapper"
  LOADING_SIZE = 10
  LOADING_COLORS = 32

  attr_reader :cooking_options, :doc

  def initialize(post, opts = {})
    @dirty = false
    @opts = opts
    @post = post
    @previous_cooked = (@post.cooked || "").dup
    # NOTE: we re-cook the post here in order to prevent timing issues with edits
    # cf. https://meta.discourse.org/t/edit-of-rebaked-post-doesnt-show-in-html-only-in-raw/33815/6
    @cooking_options = post.cooking_options || opts[:cooking_options] || {}

This file has been truncated. show original

Почему постобработка происходит уже после того, как пост был «приготовлен»?
Возможно, мы могли бы пройти по шагам того, что потребовалось бы сделать для добавления такой функции, как oneboxes или «цитаты конкретных пользователей», если бы их ещё не существовало. Я наткнулся на Prettytext discourse/app/assets/javascripts/pretty-text at f9608c0af5f7b1109117a5aba979acb00c28cf9a · discourse/discourse · GitHub
который обрабатывает преобразование в markdown и из markdown, а также рендеринг окна предпросмотра. Также я нашёл функцию rebake в модели поста на бэкенде:

github.com/discourse/discourse

app/models/post.rb

d9a02d133


      
                else
                  post.custom_fields["rebake_attempts"] = attempts + 1
                  post.save_custom_fields
                end
          
              end
            end
            problems
          end
          
          def rebake!(invalidate_broken_images: false, invalidate_oneboxes: false, priority: nil)
            new_cooked = cook(raw, topic_id: topic_id, invalidate_oneboxes: invalidate_oneboxes)
            old_cooked = cooked
          
            update_columns(
              cooked: new_cooked,
              baked_at: Time.zone.now,
              baked_version: BAKED_VERSION
            )
          
            if is_first_post?

которая вызывает метод cook класса PostAnalyzer:

github.com/discourse/discourse

app/models/post_analyzer.rb

9bff0882c


      
          end
          
          def has_oneboxes?
            return false unless @raw.present?
          
            cooked_stripped
            found_oneboxes?
          end
          
          # What we use to cook posts
          def cook(raw, opts = {})
            cook_method = opts[:cook_method]
            return raw if cook_method == Post.cook_methods[:raw_html]
          
            if cook_method == Post.cook_methods[:email]
              cooked = EmailCook.new(raw).cook(opts)
            else
              cooked = PrettyText.cook(raw, opts)
            end
          
            result = Oneboxer.apply(cooked) do |url|

эта функция выполняет преобразование markdown с помощью JavaScript на бэкенде:

github.com/discourse/discourse

lib/pretty_text.rb

9bff0882c


      
            @ctx
          end
          
          def self.reset_context
            @ctx_init.synchronize do
              @ctx&.dispose
              @ctx = nil
            end
          end
          
          def self.markdown(text, opts = {})
            # we use the exact same markdown converter as the client
            # TODO: use the same extensions on both client and server (in particular the template for mentions)
            baked = nil
            text = text || ""
          
            protect do
              context = v8
          
              custom_emoji = {}
              Emoji.custom.map { |e| custom_emoji[e.name] = e.url }

Моя мысль была в том, что так сделано для уменьшения дублирования кода, но затем я обнаружил

CookedPostProcessor

на который я ссылался в начале. Похоже, что часть обработки выполняется только в JavaScript, в то время как другая часть выполняется и в JavaScript, и в Ruby в рамках CookedPostProcessor. Подводя итог: 1. Вам нужны правила преобразования в markdown и из markdown (похоже, это только в JavaScript). 2. Вам нужен код для создания HTML (часть в JavaScript, но также и часть в Ruby). Меня интересует, почему пункт (2) выполняется частично в JavaScript, а частично в Ruby. Можете ли вы привести пример? Также я был бы очень рад, если бы вы могли исправить неверные предположения, которые я сделал в этом сообщении.
Огромное спасибо!
Spirobel

fzngagan · 02.Июль.2020 16:26:54

Для начала откройте вкладку Network в консоли JavaScript, чтобы увидеть, какие данные захватываются на фронтенде и передаются на сервер при создании поста. Это означает, что все данные, отправленные в Rails API, дополнительно обрабатываются Rails. Затем в таблице posts вы увидите столбцы raw и cooked, которые содержат необработанную и обработанную версии поста соответственно.

spirobel · 03.Июль.2020 15:18:12

Хорошо, спасибо за ответ. Я думаю, что буду изучать это постепенно. Мне кажется, что мой подход «рассуждать об этом, исходя из первых принципов» не сработал, потому что это сложилось исторически.

Тема		Ответов	Просм.
Post Cooking Process with Landing Pages Development	0	371	05.11.2021
Importing posts with Markdown Migration	11	984	19.10.2023
Edit of rebaked post doesn't show in HTML; only in raw Bug	8	1862	29.09.2015
How to decorate a post before it's cooked? Development	4	990	05.03.2021
Working with different needs in raw/cooked content Development	7	5273	15.05.2025

Помогите понять: процесс после приготовления

Связанные темы